Skip to content

Commit dd433bd

Browse files
committed
feat: add Claude Code infrastructure and documentation
1 parent c4038a9 commit dd433bd

1 file changed

Lines changed: 41 additions & 41 deletions

File tree

.claude/skills/prow-ci/SKILL.md

Lines changed: 41 additions & 41 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: Fetch and analyze OpenShift Prow CI job failures with automated art
44
trigger: prow, prow-ci, /prow-ci, ci results, check ci, analyze ci failure
55
---
66

7-
# Prow CI Analysis for Rbac Permissions Operator
7+
# Prow CI Analysis
88

99
This skill fetches Prow CI job artifacts from Google Cloud Storage and provides automated failure analysis.
1010

@@ -29,7 +29,7 @@ gh pr checks <PR_NUMBER>
2929
/prow-ci <prow-job-url>
3030

3131
# Or ask naturally:
32-
"Analyze the lint failure in PR 328"
32+
"Analyze the lint failure in PR <NUMBER>"
3333
"Check why the validate job failed"
3434
"Show me what broke in the coverage job"
3535
```
@@ -70,14 +70,14 @@ gh pr view <PR_NUMBER> --json statusCheckRollup --jq '.statusCheckRollup[] | sel
7070

7171
Example Prow job URL:
7272
```
73-
https://prow.ci.openshift.org/view/gs/test-platform-results/pr-logs/pull/openshift_rbac-permissions-operator/328/pull-ci-openshift-rbac-permissions-operator-master-lint/2059308810190721024
73+
https://prow.ci.openshift.org/view/gs/test-platform-results/pr-logs/pull/openshift_splunk_forwarder_operator/<PR_NUMBER>/pull-ci-openshift-splunk-forwarder-operator-master-lint/<BUILD_ID>
7474
```
7575

7676
### Step 2: Fetch and Analyze
7777

7878
Run the fetch script first:
7979
```bash
80-
cd /Users/ppanda/rh-projects/ROSA-730/rbac-permissions-operator/.claude/skills/prow-ci
80+
cd $PWD/.claude/skills/prow-ci
8181

8282
python3 fetch_prow_artifacts.py "<prow-job-url>" -o .work/prow-artifacts
8383
```
@@ -109,18 +109,18 @@ Create a clear summary for the user with:
109109
### Example Workflow
110110

111111
```bash
112-
# User provides: "Analyze the lint failure in PR 328"
112+
# User provides: "Analyze the lint failure in PR <NUMBER>"
113113

114114
# 1. Get Prow job URL
115-
gh pr checks 328 | grep lint
115+
gh pr checks <PR_NUMBER> | grep lint
116116

117117
# 2. Fetch artifacts
118118
python3 .claude/skills/prow-ci/fetch_prow_artifacts.py \
119-
"https://prow.ci.openshift.org/view/gs/test-platform-results/pr-logs/pull/openshift_rbac-permissions-operator/328/pull-ci-openshift-rbac-permissions-operator-master-lint/2059308810190721024"
119+
"https://prow.ci.openshift.org/view/gs/test-platform-results/pr-logs/pull/openshift_splunk_forwarder_operator/<PR_NUMBER>/pull-ci-openshift-splunk-forwarder-operator-master-lint/<BUILD_ID>"
120120

121121
# 3. Analyze
122122
python3 .claude/skills/prow-ci/analyze_failure.py \
123-
.work/prow-artifacts/2059308810190721024 \
123+
.work/prow-artifacts/<BUILD_ID> \
124124
-f markdown
125125

126126
# 4. Review the output and provide actionable summary
@@ -130,15 +130,15 @@ python3 .claude/skills/prow-ci/analyze_failure.py \
130130

131131
**Main Dashboard**: https://prow.ci.openshift.org/
132132
**CI Search**: https://github.com/openshift/ci-search
133-
**Job History**: https://prow.ci.openshift.org/?repo=openshift%2Frbac-permissions-operator
133+
**Job History**: https://prow.ci.openshift.org/?repo=openshift%2Fsplunk-forwarder-operator
134134

135135
## Common Use Cases
136136

137137
### 1. Check Recent CI Results
138138

139139
```bash
140140
# View recent PR jobs
141-
curl -s "https://prow.ci.openshift.org/?repo=openshift%2Frbac-permissions-operator&type=presubmit" | grep -E "pull-ci-openshift-rbac-permissions-operator"
141+
curl -s "https://prow.ci.openshift.org/?repo=openshift%2Fsplunk-forwarder-operator&type=presubmit" | grep -E "pull-ci-openshift-splunk-forwarder-operator"
142142

143143
# Check latest job status for specific PR
144144
# Replace PR_NUMBER with actual PR number
@@ -148,12 +148,12 @@ gh pr view PR_NUMBER --json statusCheckRollup --jq '.statusCheckRollup[] | selec
148148
### 2. Access Build Logs
149149

150150
Prow logs are stored at:
151-
- **Pull request jobs**: `gs://test-platform-results/pr-logs/pull/openshift_rbac-permissions-operator/[PR_NUMBER]/[JOB_NAME]/[JOB_ID]`
151+
- **Pull request jobs**: `gs://test-platform-results/pr-logs/pull/openshift_splunk_forwarder_operator/[PR_NUMBER]/[JOB_NAME]/[JOB_ID]`
152152
- **Periodic jobs**: `gs://test-platform-results/logs/[JOB_NAME]/[JOB_ID]`
153153

154154
**Viewing logs via web**:
155155
```text
156-
https://prow.ci.openshift.org/view/gs/test-platform-results/pr-logs/pull/openshift_rbac-permissions-operator/[PR_NUMBER]/[JOB_NAME]/[JOB_ID]
156+
https://prow.ci.openshift.org/view/gs/test-platform-results/pr-logs/pull/openshift_splunk_forwarder_operator/[PR_NUMBER]/[JOB_NAME]/[JOB_ID]
157157
```
158158

159159
### 3. Analyze Test Failures
@@ -175,16 +175,16 @@ gh pr checks PR_NUMBER | grep -i "fail"
175175
### 4. Common Job Names
176176

177177
**Prow CI Jobs** (configured in openshift/release):
178-
- `pull-ci-openshift-rbac-permissions-operator-master-e2e-binary-build-success` - E2E binary build verification
179-
- `pull-ci-openshift-rbac-permissions-operator-master-coverage` - Code coverage analysis (with Codecov)
180-
- `pull-ci-openshift-rbac-permissions-operator-master-lint` - Linting checks
181-
- `pull-ci-openshift-rbac-permissions-operator-master-test` - Unit tests
182-
- `pull-ci-openshift-rbac-permissions-operator-master-validate` - Validation checks
178+
- `pull-ci-openshift-splunk-forwarder-operator-master-e2e-binary-build-success` - E2E binary build verification
179+
- `pull-ci-openshift-splunk-forwarder-operator-master-coverage` - Code coverage analysis (with Codecov)
180+
- `pull-ci-openshift-splunk-forwarder-operator-master-lint` - Linting checks
181+
- `pull-ci-openshift-splunk-forwarder-operator-master-test` - Unit tests
182+
- `pull-ci-openshift-splunk-forwarder-operator-master-validate` - Validation checks
183183

184184
**Tekton Pipelines** (configured in `.tekton/`):
185-
- `rbac-permissions-operator-pull-request` - Main PR pipeline (docker build with OCI-TA)
186-
- `rbac-permissions-operator-e2e-pull-request` - E2E testing pipeline
187-
- `rbac-permissions-operator-pko-pull-request` - PKO (Package Operator) pipeline
185+
- `splunk-forwarder-operator-pull-request` - Main PR pipeline (docker build with OCI-TA)
186+
- `splunk-forwarder-operator-e2e-pull-request` - E2E testing pipeline
187+
- `splunk-forwarder-operator-pko-pull-request` - PKO (Package Operator) pipeline
188188
- Corresponding `-push` pipelines for merged commits
189189

190190
## Debugging CI Failures
@@ -197,7 +197,7 @@ gh pr checks PR_NUMBER
197197
### Step 2: Access Prow UI
198198
Open the Prow link from PR checks or construct manually:
199199
```text
200-
https://prow.ci.openshift.org/?repo=openshift%2Frbac-permissions-operator&type=presubmit
200+
https://prow.ci.openshift.org/?repo=openshift%2Fsplunk-forwarder-operator&type=presubmit
201201
```
202202

203203
### Step 3: Review Logs
@@ -238,15 +238,15 @@ make docker-build
238238
This repo uses **both Prow and Tekton** for comprehensive CI:
239239

240240
**Prow CI** (openshift/release):
241-
- Configuration: `ci-operator/config/openshift/rbac-permissions-operator/openshift-rbac-permissions-operator-master.yaml`
241+
- Configuration: `ci-operator/config/openshift/splunk-forwarder-operator/openshift-splunk-forwarder-operator-master.yaml`
242242
- Runs: lint, test, validate, coverage, e2e-binary-build
243-
- Uses Codecov for coverage reporting (secret: `rbac-permissions-operator-codecov-token`)
243+
- Uses Codecov for coverage reporting (secret: `splunk-forwarder-operator-codecov-token`)
244244
- Skip rules: Changes to `.tekton/`, `.github/`, `.md` files, `OWNERS`, `LICENSE` don't trigger most jobs
245245

246246
**Tekton Pipelines** (`.tekton/`):
247247
- Primary build pipeline using Pipelines as Code
248248
- Three pipeline types: main, e2e, pko
249-
- Builds container images to Quay (rbac-permissions-operator-tenant)
249+
- Builds container images to Quay (splunk-forwarder-operator-tenant)
250250
- Pull request images expire after 5 days
251251
- Uses boilerplate framework from `openshift/boilerplate` (docker-build-oci-ta pipeline)
252252

@@ -260,31 +260,31 @@ gh pr checks <PR_NUMBER>
260260
gh pr view <PR_NUMBER> --json statusCheckRollup
261261

262262
# Filter only Prow jobs
263-
gh pr checks <PR_NUMBER> | grep "pull-ci-openshift-rbac-permissions-operator"
263+
gh pr checks <PR_NUMBER> | grep "pull-ci-openshift-splunk-forwarder-operator"
264264

265265
# Check Tekton pipeline status
266266
gh pr view <PR_NUMBER> --json statusCheckRollup --jq '.statusCheckRollup[] | select(.context | contains("Tekton"))'
267267

268268
# Open Prow dashboard in browser (cross-platform)
269269
# Copy and paste this URL into your browser:
270-
# https://prow.ci.openshift.org/?repo=openshift%2Frbac-permissions-operator
270+
# https://prow.ci.openshift.org/?repo=openshift%2Fsplunk-forwarder-operator
271271

272272
# Or use platform-specific command:
273-
# macOS: open "https://prow.ci.openshift.org/?repo=openshift%2Frbac-permissions-operator"
274-
# Linux: xdg-open "https://prow.ci.openshift.org/?repo=openshift%2Frbac-permissions-operator"
275-
# Windows: start "https://prow.ci.openshift.org/?repo=openshift%2Frbac-permissions-operator"
273+
# macOS: open "https://prow.ci.openshift.org/?repo=openshift%2Fsplunk-forwarder-operator"
274+
# Linux: xdg-open "https://prow.ci.openshift.org/?repo=openshift%2Fsplunk-forwarder-operator"
275+
# Windows: start "https://prow.ci.openshift.org/?repo=openshift%2Fsplunk-forwarder-operator"
276276

277277
# View specific PR on Prow (replace <PR_NUMBER>)
278-
# https://prow.ci.openshift.org/?repo=openshift%2Frbac-permissions-operator&type=presubmit&pull=<PR_NUMBER>
278+
# https://prow.ci.openshift.org/?repo=openshift%2Fsplunk-forwarder-operator&type=presubmit&pull=<PR_NUMBER>
279279
```
280280

281281
## Troubleshooting
282282

283283
### Can't find job results?
284284
- Check both Prow AND Tekton - this repo uses both systems
285-
- Prow jobs: `pull-ci-openshift-rbac-permissions-operator-master-*`
285+
- Prow jobs: `pull-ci-openshift-splunk-forwarder-operator-master-*`
286286
- Tekton jobs: Usually show as "Tekton" or pipeline names in PR checks
287-
- Verify repo name format in Prow: `openshift_rbac-permissions-operator` (underscore, not dash)
287+
- Verify repo name format in Prow: `openshift_splunk_forwarder_operator` (underscore, not dash)
288288
- Ensure PR has been opened and CI has run
289289

290290
### Logs show permission denied?
@@ -303,7 +303,7 @@ gh pr view <PR_NUMBER> --json statusCheckRollup --jq '.statusCheckRollup[] | sel
303303
- Common issues:
304304
- Image build failures → Check Dockerfile syntax and build context
305305
- Pipeline timeout → Check for slow steps or network issues
306-
- Auth failures → Secret configuration in `rbac-permissions-operator-tenant` namespace
306+
- Auth failures → Secret configuration in `splunk-forwarder-operator-tenant` namespace
307307
- Local validation:
308308
```bash
309309
# Validate Tekton YAML syntax
@@ -333,27 +333,27 @@ git clone https://github.com/openshift/ci-search.git
333333
## CI Configuration Files
334334

335335
**Prow Configuration** (in openshift/release repo):
336-
- Location: `ci-operator/config/openshift/rbac-permissions-operator/openshift-rbac-permissions-operator-master.yaml`
336+
- Location: `ci-operator/config/openshift/splunk-forwarder-operator/openshift-splunk-forwarder-operator-master.yaml`
337337
- Update process: Submit PR to openshift/release repository
338-
- Auto-generated jobs in: `ci-operator/jobs/openshift/rbac-permissions-operator/`
338+
- Auto-generated jobs in: `ci-operator/jobs/openshift/splunk-forwarder-operator/`
339339

340340
**Tekton Pipelines** (in this repo):
341341
- Location: `.tekton/` directory
342342
- Files:
343-
- `rbac-permissions-operator-pull-request.yaml` - Main PR pipeline
344-
- `rbac-permissions-operator-push.yaml` - Post-merge pipeline
345-
- `rbac-permissions-operator-e2e-pull-request.yaml` - E2E testing
346-
- `rbac-permissions-operator-pko-pull-request.yaml` - PKO validation
343+
- `splunk-forwarder-operator-pull-request.yaml` - Main PR pipeline
344+
- `splunk-forwarder-operator-push.yaml` - Post-merge pipeline
345+
- `splunk-forwarder-operator-e2e-pull-request.yaml` - E2E testing
346+
- `splunk-forwarder-operator-pko-pull-request.yaml` - PKO validation
347347
- Triggered by: Pipelines as Code (via Tekton)
348348
- Uses: Boilerplate docker-build-oci-ta pipeline from openshift/boilerplate
349349

350350
## Coverage Reporting
351351

352352
This repository uses Codecov for coverage tracking:
353-
- Secret: `rbac-permissions-operator-codecov-token` (stored in Prow)
353+
- Secret: `splunk-forwarder-operator-codecov-token` (stored in Prow)
354354
- Generate coverage locally: `make coverage`
355355
- Coverage runs on PRs and post-merge (`publish-coverage`)
356-
- Dashboard: Check Codecov for rbac-permissions-operator
356+
- Dashboard: Check Codecov for splunk-forwarder-operator
357357

358358
## Integration with Other Skills
359359

0 commit comments

Comments
 (0)