# Project Hummingbird

> A collection of minimal, hardened, and secure container images with a significantly reduced attack surface.

## Site index

- [Home page](https://hummingbird-project.io/index.md)
- [Full content (llms-full.txt)](/llms-full.txt)
- [Documentation](https://hummingbird-project.io/docs/index.md)
- [Container images](https://quay.io/organization/hummingbird/)
- [Code](https://gitlab.com/redhat/hummingbird)

## Documentation index

- [Using a Project Hummingbird container image](https://hummingbird-project.io/docs/using/index.md)
  - [Using a Project Hummingbird container image](https://hummingbird-project.io/docs/using/overview/index.md)
  - [Custom CA Certificates (OpenSSL)](https://hummingbird-project.io/docs/using/custom-ca-openssl/index.md)
  - [Custom CA Certificates (Java)](https://hummingbird-project.io/docs/using/custom-ca-java/index.md)
  - [Custom CA Certificates (Python)](https://hummingbird-project.io/docs/using/custom-ca-python/index.md)
- [Contributing to a Project Hummingbird container image](https://hummingbird-project.io/docs/contributing/index.md)
  - [Quickstart Guide](https://hummingbird-project.io/docs/contributing/quickstart/index.md): Get your first contribution done in 5 minutes
  - [Development Workflow](https://hummingbird-project.io/docs/contributing/development-workflow/index.md): Detailed development environment setup and contribution workflow
  - [Resolving Merge Conflicts in Generated Files](https://hummingbird-project.io/docs/contributing/resolve-merge-conflicts-generated/index.md): How to resolve merge conflicts in generated files during rebases
  - [Adding New Images](https://hummingbird-project.io/docs/contributing/adding-images/index.md): Step-by-step guide for adding new container images to the project
  - [Adding FIPS Variants](https://hummingbird-project.io/docs/contributing/fips-variant-guide/index.md): How FIPS variants work and step-by-step guide for adding them
  - [Testing Guide](https://hummingbird-project.io/docs/contributing/testing-images/index.md): How to run and write integration tests locally and work with CI
  - [Adding Kubernetes Tests](https://hummingbird-project.io/docs/contributing/adding-k8s-tests/index.md): How to add Kubernetes and OpenShift integration tests to container images
  - [Image Configuration Reference](https://hummingbird-project.io/docs/contributing/image-configuration-reference/index.md): Complete reference for properties.yml configuration and image settings
  - [Test Configuration Reference](https://hummingbird-project.io/docs/contributing/test-configuration-reference/index.md): Complete reference for test definition format and configuration options
- [Operating Hummingbird infrastructure](https://hummingbird-project.io/docs/operating/index.md)
  - [Excluding Packages from Images](https://hummingbird-project.io/docs/operating/excluding-packages-from-images/index.md)
  - [Managing Konflux Comments](https://hummingbird-project.io/docs/operating/managing-konflux-comments/index.md): Clean up and manage excessive Konflux comments on merge requests using the comment deletion tool.
  - [Running Conforma Checks Locally](https://hummingbird-project.io/docs/operating/running-conforma-checks-locally/index.md)
  - [Upgrading Docsy](https://hummingbird-project.io/docs/operating/docsy-upgrades/index.md): How to upgrade the Docsy theme and forward-port our layout overrides.
  - [Version Constraints for Multi-Version Images](https://hummingbird-project.io/docs/operating/version-constraints/index.md)
  - [Retrying Konflux Checks](https://hummingbird-project.io/docs/operating/retrying-konflux-checks/index.md): Automatically retrigger failed Konflux CI checks on merge requests using the retrigger script.
  - [Switching Fedora Streams](https://hummingbird-project.io/docs/operating/switching-fedora-streams/index.md)
  - [Disabling Rawhide for Images](https://hummingbird-project.io/docs/operating/disabling-rawhide-for-images/index.md)
  - [Setting Up a Konflux Cluster](https://hummingbird-project.io/docs/operating/setting-up-konflux-cluster/index.md): How to set up a new Konflux cluster
  - [Deleting RPMs from Hummingbird Repos](https://hummingbird-project.io/docs/operating/deleting-rpms-from-hummingbird-repos/index.md): How to delete RPM packages from Hummingbird repositories
  - [Updating Dist-git Packages](https://hummingbird-project.io/docs/operating/updating-dist-git-packages/index.md): How packages are automatically updated from Fedora dist-git
  - [Writing Documentation](https://hummingbird-project.io/docs/operating/documentation/index.md): How to contribute to the Project Hummingbird documentation.
  - [Adding Independent Packages](https://hummingbird-project.io/docs/operating/adding-independent-packages/index.md): How to add packages that originate in the Hummingbird repository
  - [Pulp Access](https://hummingbird-project.io/docs/operating/pulp-access/index.md)
  - [Rebuilding Packages](https://hummingbird-project.io/docs/operating/rebuilding-packages/index.md)
  - [Setting Up Pulp Repositories](https://hummingbird-project.io/docs/operating/setting-up-pulp-repositories/index.md): How to create and set up Pulp domain and repositories
  - [Package Metadata Fields](https://hummingbird-project.io/docs/operating/package-metadata-fields/index.md)
  - [Debugging Build Failures](https://hummingbird-project.io/docs/operating/debugging-build-failures/index.md)
  - [Package Modification Tracking](https://hummingbird-project.io/docs/operating/package-modification-tracking/index.md)
  - [Private RPM Repositories](https://hummingbird-project.io/docs/operating/private-rpm-repositories/index.md)
  - [Reporting CVE Data Issues](https://hummingbird-project.io/docs/operating/reporting-cve-data-issues/index.md)
  - [Lookaside Cache Access](https://hummingbird-project.io/docs/operating/lookaside-cache-access/index.md): How to access the S3-based lookaside cache for RPM source tarballs
  - [Upstream Diff Analysis](https://hummingbird-project.io/docs/operating/upstream-diff-analysis/index.md)
  - [GPG Source Verification](https://hummingbird-project.io/docs/operating/gpg-source-verification/index.md): How upstream signing keys are stored, and how to add, rotate, or revoke them
  - [Rebasing the Buildroot to a New Fedora Release](https://hummingbird-project.io/docs/operating/rebasing-buildroot-to-new-fedora/index.md): Step-by-step runbook for moving mock.cfg, the core toolchain, and the rest of the package set to a new Fedora release
- [Lot's of background information](https://hummingbird-project.io/docs/background/index.md)
  - [RPMs repository](https://hummingbird-project.io/docs/background/rpms/index.md): Background documentation and contributing guide for Project Hummingbird RPM packages.
    - [RPM Pipeline](https://hummingbird-project.io/docs/background/rpms/rpm-pipeline/index.md): How an RPM spec change flows through the build pipeline to the package repository
    - [Konflux Resource Deployment](https://hummingbird-project.io/docs/background/rpms/konflux-resource-deployment/index.md): How Konflux resources are defined and deployed across repositories
    - [Source Pipeline Tool](https://hummingbird-project.io/docs/background/rpms/source-pipeline-tool/index.md)
  - [Agent-Friendly Documentation](https://hummingbird-project.io/docs/background/doc-agent-support/index.md): How AI agents and LLMs can discover and consume the Project Hummingbird documentation site.
  - [Containers repository](https://hummingbird-project.io/docs/background/containers/index.md)
    - [Image Pipeline](https://hummingbird-project.io/docs/background/containers/image-pipeline/index.md): How the container image pipeline works from source to release
    - [Global Variables Reference](https://hummingbird-project.io/docs/background/containers/global-variables-reference/index.md): Complete reference for global configuration in images/variables.yml
    - [Konflux Resource Deployment](https://hummingbird-project.io/docs/background/containers/konflux-resource-deployment/index.md): How Konflux resources are defined and deployed across repositories
    - [Security Labels and Metadata](https://hummingbird-project.io/docs/background/containers/security-labels-and-metadata/index.md): Container labels, embedded metadata, and SBOMs for vulnerability scanning
    - [Container Image Labels](https://hummingbird-project.io/docs/background/containers/container-image-labels/index.md): Complete reference for all container image labels
    - [CI Scripts](https://hummingbird-project.io/docs/background/containers/ci-scripts/index.md)
      - [build_images.sh](https://hummingbird-project.io/docs/background/containers/ci-scripts/build_images/index.md): Build container images using buildah with support for multiple architectures and container engines
      - [run_tests_container.sh](https://hummingbird-project.io/docs/background/containers/ci-scripts/run_tests_container/index.md): Run tests for image groups using containerized test environment with support for both Docker and Podman engines
      - [run_tests_k8s.sh](https://hummingbird-project.io/docs/background/containers/ci-scripts/run_tests_k8s/index.md): Run K8s tests for image groups using kubectl with support for local development and CI environments
      - [retrigger_failed_checks.py](https://hummingbird-project.io/docs/background/containers/ci-scripts/retrigger_failed_checks/index.md): Retrigger failed Konflux CI checks for a given GitLab merge request
      - [gitlab_sync.py](https://hummingbird-project.io/docs/background/containers/ci-scripts/gitlab_sync/index.md): Sync a generated file to an external GitLab repository via merge request, with automatic merge wait, pipeline retry, and preemption support
  - [K8s Test Pipeline](https://hummingbird-project.io/docs/background/k8s-test-pipeline/index.md)
    - [Pipeline Design](https://hummingbird-project.io/docs/background/k8s-test-pipeline/pipeline-design/index.md): Design guidelines and architecture of the K8s test pipeline.
    - [Test Format](https://hummingbird-project.io/docs/background/k8s-test-pipeline/test-format/index.md): Pipeline-level test discovery, environment variables, parameters, and group snapshot handling.
    - [EaaS and Debugging](https://hummingbird-project.io/docs/background/k8s-test-pipeline/eaas/index.md): How the pipeline uses Konflux Environment as a Service, and how to debug test failures.
  - [Tools repository](https://hummingbird-project.io/docs/background/tools/index.md)
    - [Message Bus Architecture](https://hummingbird-project.io/docs/background/tools/message-bus/index.md)
    - [Alloy CloudWatch](https://hummingbird-project.io/docs/background/tools/alloy-cloudwatch/index.md)
    - [Deployment Bot](https://hummingbird-project.io/docs/background/tools/deployment-bot/index.md)
    - [Grafana CloudWatch](https://hummingbird-project.io/docs/background/tools/grafana-cloudwatch/index.md)
    - [Hummingbird Events Topic](https://hummingbird-project.io/docs/background/tools/hummingbird-events-topic/index.md)
    - [Vertex AI Cost Metrics](https://hummingbird-project.io/docs/background/tools/vertex-metrics/index.md)
    - [SNS S3 Archiver](https://hummingbird-project.io/docs/background/tools/sns-s3-archiver/index.md)
    - [Hummingbird Tools](https://hummingbird-project.io/docs/background/tools/hummingbird-tools/index.md)
    - [ProdSec RPM Catalog](https://hummingbird-project.io/docs/background/tools/hummingbird-tools-prodsec-catalog/index.md)
    - [CVE Analysis](https://hummingbird-project.io/docs/background/tools/hummingbird-cve-analysis/index.md)
    - [Dashboard MR Linker](https://hummingbird-project.io/docs/background/tools/dashboard-mr-linker/index.md)
    - [GitLab Event Forwarder](https://hummingbird-project.io/docs/background/tools/gitlab-event-forwarder/index.md)
    - [Hummingbird MR Human Tracker](https://hummingbird-project.io/docs/background/tools/hummingbird-mr-human-tracker/index.md)
    - [MR Auto-Approver](https://hummingbird-project.io/docs/background/tools/mr-auto-approver/index.md)
    - [Container Catalog](https://hummingbird-project.io/docs/background/tools/container-catalog/index.md)
    - [Hummingbird Agent](https://hummingbird-project.io/docs/background/tools/hummingbird-agent/index.md)
    - [Hummingbird Agent Model Loop](https://hummingbird-project.io/docs/background/tools/hummingbird-agent-model-loop/index.md)
    - [Red Hat Catalog](https://hummingbird-project.io/docs/background/tools/redhat-catalog/index.md)
    - [Hummingbird Agent Design](https://hummingbird-project.io/docs/background/tools/hummingbird-agent-design/index.md)
    - [Hummingbird Data Flow](https://hummingbird-project.io/docs/background/tools/data-flow/index.md)
    - [Kubernetes Event Forwarder](https://hummingbird-project.io/docs/background/tools/kubernetes-event-forwarder/index.md)
    - [Jira Image Requests](https://hummingbird-project.io/docs/background/tools/jira-image-requests/index.md)
    - [PAC Trigger](https://hummingbird-project.io/docs/background/tools/pac-trigger/index.md)
    - [Hummingbird Status](https://hummingbird-project.io/docs/background/tools/hummingbird-status/index.md)
    - [Lambda S3 Cache](https://hummingbird-project.io/docs/background/tools/lambda-s3-cache/index.md)
    - [RPM CVE Count](https://hummingbird-project.io/docs/background/tools/rpm-cve-count/index.md)
    - [Hummingbird Dashboard](https://hummingbird-project.io/docs/background/tools/hummingbird-dashboard/index.md)
    - [Service metrics](https://hummingbird-project.io/docs/background/tools/service-metrics/index.md)
    - [VEX Checker](https://hummingbird-project.io/docs/background/tools/vex-checker/index.md)
    - [Red Hat Catalog Environment Promotion](https://hummingbird-project.io/docs/background/tools/redhat-catalog-environments/index.md)
    - [S3 Lookaside Cache](https://hummingbird-project.io/docs/background/tools/s3-lookaside-cache/index.md)
    - [Red Hat Catalog UAT Program](https://hummingbird-project.io/docs/background/tools/redhat-catalog-uat/index.md)
    - [Hummingbird MR Collaboration](https://hummingbird-project.io/docs/background/tools/hummingbird-mr-collaboration/index.md)
    - [K8s Integration Tests](https://hummingbird-project.io/docs/background/tools/k8s-integration-tests/index.md)
- [Agentic SDLC](https://hummingbird-project.io/docs/agentic-sdlc/index.md): How Project Hummingbird uses agentic AI to drive velocity across the software development lifecycle.
- [Architecture Decision Records](https://hummingbird-project.io/docs/adrs/index.md)
  - [ADR-0001: Unified Observability Stack](https://hummingbird-project.io/docs/adrs/0001-unified-observability-stack/index.md)
  - [ADR-0002: AI-Assisted SDLC Workqueue](https://hummingbird-project.io/docs/adrs/0002-ai-assisted-sdlc-workqueue/index.md)

## Site locales

- [](https://hummingbird-project.io/index.md)