Improve this page on GitHub

GitOps container registry integrations

Seamlessly integrate container registries with GitOps for image enrichment

Codefresh supports integration with popular container registries, including Docker Hub, JFrog Artifactory, and others, enabling seamless management of container images in GitOps workflows.

By adding a container registry integration in Codefresh, you can reference it by name in third-party CI tools like GitHub Actions or Codefresh Pipelines, rather than using explicit credentials. This simplifies your workflow and enhances security.
See Image enrichment with integrations and CI integrations.

You add a container registry integration in Codefresh by:

  • Defining the integration name
  • Selecting the runtime or runtimes it is shared with
  • Defining the arguments
  • Testing the connection
  • Committing the changes

You can add multiple integrations for the same registry, providing flexibility for your environment. Codefresh displays a list of existing integrations along with their sync status. You can easily edit or delete any registry integration as needed.

Configure container registry integrations for GitOps in Codefresh

Configure the settings for a container registry integration with GitOps in Codefresh.

  1. In the Codefresh UI, on the toolbar, click the Settings icon, and then from the sidebar, select GitOps Integrations.
  2. Filter by Container Registry, select the container registry, and then click Configure.
  3. If you already have integrations, click Add.
  4. Define the arguments for the container registry:
  5. To test the connection to the container registry before committing the changes, click Test Connection.
  6. To confirm, click Commit. It may take a few moments for the new integration to be synced to the cluster before it appears in the list.

Integration resource in shared configuration repo

The integration resource for the container registry 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/<runtime-name>/

View container registry integrations for GitOps

Selecting a container registry integration displays the existing integrations for that registry in Codefresh.
The example below shows integrations for JFrog Artifactory.

JFrog integrations in Codefresh

JFrog integrations in Codefresh

Every container registry integration displays the following information:

  • Name of the integration
  • Runtime or runtimes it is shared with
  • Sync status

Edit/delete container registry integrations for GitOps

If you have existing integrations, you can change the connection details, or delete an integration.

IMPORTANT
Deleting an integration deletes the integration resource from the Shared Configuration Repository, its secrets, and the CI workflows that use it.

  1. In the Codefresh UI, on the toolbar, click the Settings icon, and then from the sidebar, select GitOps Integrations.
  2. Filter by Container Registry, and select the specific container registry integration.
  3. In the row with the integration to edit or delete, click the three dots and select Edit or Delete.
  4. To edit, update the Username and Password fields, and click Test Connection to verify the account credentials.
  5. To delete, type DELETE in the text box as instructed.

Delete container registry integration

Delete container registry integration

CI GitOps integrations
Issue-tracking GitOps integrations
Shared Configuration Repository