GitOps GitHub Container Registry (GHCR) integration

Integrate GHCR with GitOps for image enrichment

Codefresh offers native support for interacting with GitHub Container Registry, allowing you to host and manage Docker container images within your personal or organization account on GitHub, to push, pull, and deploy images seamlessly.

A key benefit of the GitHub Container Registry is the ability to define permissions for Docker images independently of the repository. This means you can keep your repository private while making the Docker image public, offering more flexibility in managing access.

For general information on container registry integrations for GitOps, see Container registry GitOps integrations.

Prerequisites

Before you configure settings in Codefresh to integrate GitHub container registry:

  • Make sure you have a personal access token with the correct scopes or create one.
    You need at least the following scopes:
    • write:packages
    • read:packages
    • delete:packages
    • repo (if your repository is private; do not select if it is public)

    For detailed information, see the Authenticating to the Container registry.

GitHub Container registry (GHCR)-GitOps integration settings in Codefresh

Setting Description
Integration name A friendly name for the integration. This is the name you will reference in the third-party CI platform/tool.
All Runtimes/Selected Runtimes The runtimes in the account with which to share the integration resource.
The integration resource is created in the Git repository with the shared configuration, within resources. The exact location depends on whether the integration is shared with all or specific runtimes:
  • All runtimes: Created in resources/all-runtimes-all-clusters/
  • Selected runtimes: Created in resources/runtimes/
Domain The GitHub registry domain and is set to ghcr.io.
Username Your GitHub username.
GitHub Token Your GitHub PAT (personal access token).
Test Connection Click to verify that you can connect to the specified instance before you commit changes.

GitHub Container registry integration

GitHub Container registry integration

For how-to instructions, see Configure container registry integrations for GitOps in Codefresh and Edit/delete container registry integrations for GitOps in Codefresh.

Shared Configuration Repository
Image enrichment with GitOps integrations
CI GitOps integrations
Issue-tracking GitOps integrations