skills.rest
openshift-eng
openshift-engCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

Prow Job Analyze Install Failure

Diagnose OpenShift installation failures in Prow CI jobs by analyzing installer logs from Google Cloud Storage.

112|305|Updated Oct 10, 2025
Search Tags:#debugging#ci-cd#installation#openshift#ci-failures#prow#log-analysis
One-click install
npx skills add https://github.com/openshift-eng/ai-helpers --skill prow-job-analyze-install-failure
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: Prow Job Analyze Install Failure
Source: https://github.com/openshift-eng/ai-helpers/tree/main/plugins/prow-job/skills/prow-job-analyze-install-failure
Command: npx skills add https://github.com/openshift-eng/ai-helpers --skill prow-job-analyze-install-failure

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires gcloud.

What problem does it solve?

This Skill automates the complex process of diagnosing OpenShift installation failures in Prow CI jobs by systematically downloading and analyzing installer logs, log bundles, and sosreports from Google Cloud Storage.

Core Features & Use Cases

  • Automated Log Analysis: Downloads and parses installer logs, log bundles, and junit files to identify failure root causes.
  • Job Type Intelligence: Automatically detects and handles specialized job types including upgrade, FIPS, IPv6, metal, and single-node installations.
  • Use Case: When a CI job fails with "install should succeed" test failure, use this Skill to automatically download all relevant artifacts and provide targeted analysis based on the specific failure stage.

Quick Start

Use the Prow Job Analyze Install Failure skill to analyze the installation failure from this Prow job URL: https://prow.ci.openshift.org/view/gs/test-platform-results/logs/periodic-ci-openshift-release-master-ci-4.21-e2e-aws-ovn-techpreview/1983307151598161920

Frequently Asked Questions about Prow Job Analyze Install Failure

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I debug OpenShift installation failures in Prow CI jobs?▼

Debug OpenShift installation failures by automatically downloading installer logs, log bundles, and sosreports from Google Cloud Storage, then analyzing them to identify root causes at specific failure stages like bootstrap or install-complete.

Can I analyze installation failures for specialized OpenShift deployments like FIPS or IPv6?▼

Yes, this skill detects and handles specialized job types including upgrade, FIPS, IPv6, dual-stack, single-node, and platform-specific installations, applying targeted analysis based on the detected deployment scenario.

What do I need to analyze Prow job installation failures?▼

You need gcloud installed and the Prow job URL. The skill parses prowjob.json to extract the target value and constructs GCS paths, with optional read access to test-platform-results for enhanced analysis.

How does log analysis identify the cause of an 'install should succeed' test failure?▼

Log analysis parses installer logs and junit files to pinpoint failure root causes, then correlates them with the specific installation stage (bootstrap, install-complete, upgrade) where the failure occurred.

What artifacts does this skill download from Google Cloud Storage?▼

The skill downloads installer logs, log bundles, and sosreports from GCS paths constructed from the Prow job metadata, enabling comprehensive diagnosis of installation failures across all deployment stages.

Related Skills

Explore More Software Engineering Skills→
openshift-engopenshift-eng

Prow Job Artifact Search

Search and retrieve Prow CI job artifacts from the test-platform-results GCS bucket.

Official
Intermediate
Emz1998Emz1998
1

reporting-issues

Generate structured troubleshooting reports with findings, root causes, and remediation actions.

Community
Basic
openshift-onlineopenshift-online

analyze-prow-failure

Analyze Prow CI job failures from JSON reports and GCS artifacts.

Official
Intermediate
kagentikagenti
292

openshift:debug

Diagnose OpenShift cluster operator, authentication, route, and build failures.

Official
Intermediate