Improve this page on GitHub

GitOps container registry integrations

Codefresh can integrate with popular container registries such as Docker Hub, JFrog Artifactory, and more.

Adding a container registry integration in Codefresh allows you to reference the integration in third-party CI platforms/tools such as GitHub Actions and Codefresh pipelines by the name of the registry integration, instead of explicit credentials. 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 more than one integration for the same registry. Once added, Codefresh displays the list of existing integrations with their sync status. You can edit or delete any registry integration.

Configure container registry integrations for GitOps in Codefresh

Configure the settings for a GitOps container registry integration 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 click Configure.
  3. If you already have integrations, click Add.
  4. Define the arguments for the container registry:
    Amazon ECR
    Docker Hub
    GitHub Container Registry
    JFrog Artifactory
    Quay
  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
Images
Monitoring applications