debug-build

Diagnose OpenShift build failures by validating BuildConfig, logs, and registry access.

48|31|Updated Feb 2, 2026
One-click install
npx skills add https://github.com/RHEcosystemAppEng/agentic-plugins --skill debug-build-rhecosystemappeng
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debug-build
Source: https://github.com/RHEcosystemAppEng/agentic-plugins/tree/main/rh-developer/skills/debug-build
Command: npx skills add https://github.com/RHEcosystemAppEng/agentic-plugins --skill debug-build-rhecosystemappeng

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires oc, python, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the diagnosis of OpenShift build failures, including S2I builds, Docker/Podman builds, and BuildConfig issues, providing detailed insights into the root cause.

Core Features & Use Cases

  • Automated Build Diagnosis: Automatically gather BuildConfig, Build status, build pod logs, and related resources to diagnose failures.
  • Use Case: Ideal for SREs and developers when a build fails, hangs, or produces unexpected results.

Quick Start

To debug a build, use the command /debug-build [build-name].

Frequently Asked Questions about debug-build

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

FAQPage Schema
How do I diagnose OpenShift build failures automatically?

Automate OpenShift build failure diagnosis by validating BuildConfig, fetching build pod logs, and checking registry authentication and source repository access to reveal the root cause.

What is the best way to troubleshoot a failed S2I build in OpenShift?

Troubleshooting a failed S2I build involves gathering the BuildConfig, checking the build status, and analyzing build pod logs to identify the exact failure point. Automating this multi-step diagnosis helps pinpoint issues with source repository access or registry authentication.

Why does my Docker build on OpenShift fail to push to the registry?

Docker build failures on OpenShift often stem from registry authentication issues or invalid BuildConfig settings. Diagnosing the failure requires checking your build pod logs and validating your registry access credentials to resolve the push error.

Do I need the oc CLI to debug OpenShift buildconfig issues?

Yes, you need the oc CLI and Python installed in your environment to run the automated diagnosis scripts. These dependencies are required to interact with the OpenShift cluster and validate your BuildConfig scenarios.

Can I diagnose a hanging OpenShift build pod using this automated approach?

Yes, you can diagnose a hanging OpenShift build pod by automating the collection of build status and pod logs. This approach identifies whether the hang is caused by source repository access issues, registry authentication, or BuildConfig validation errors.