Improve this page on GitHub

GitOps CI integrations

Seamlessly integrate existing CI tools with GitOps for image enrichment

Codefresh GitOps with CI solutions

With Codefresh GitOps, you can integrate not only with Codefresh CI but also with other popular Continuous Integration (CI) solutions.

For example, you can connect a third-party CI tool like GitHub Actions to handle common CI tasks, such as building, testing, and scanning source code. Codefresh GitOps can then take care of deployment, image enrichment, and reporting. This integration ensures that all CI-related information is included in the images, which you can view in the Images dashboard.

For more details on how it works, see Image enrichment with GitOps integrations.

Codefresh image reporting and enrichment action

To support the integration with third-party CI platforms and tools, we offer dedicated actions in the Codefresh Marketplace. These actions combine image enrichment and reporting through integrations with issue tracking and container registry tools.

NOTE
You can also configure these integration directly in the Codefresh UI, as described in Connect a third-party CI platform/tool to Codefresh.

Use the action as follows:

  1. Create your pipeline with your CI platform/tool as you usually do.
  2. Use existing CI actions for compiling code, running unit tests, security scanning etc.
  3. Place the final action in the pipeline as the “report image” action provided by Codefresh.
    See:
  4. When the pipeline completes execution, Codefresh retrieves the information on the image that was built and its metadata through the integration names specified (essentially the same data that Codefresh CI would send automatically).
  5. View the image in the Images dashboard, and in any application in which it is used.

Connect a third-party CI platform/tool to GitOps

Connecting the CI platform/tool to GitOps from the UI includes configuring the required arguments, and then generating and copying the YAML manifest for the report image to your pipeline.

  1. In the Codefresh UI, on the toolbar, click the Settings icon, and then from the sidebar, select GitOps Integrations.
  2. Filter by CI tools, select the CI tool, and then click Add.
  3. Define the arguments for the CI tool:

NOTE
For the complete list of arguments you can use, see GitOps integrations argument reference.

  1. To generate a YAML snippet with the arguments, on the top-right, click Generate Manifest.
    Codefresh validates the generated manifest, and alerts you to undefined arguments that are required, and other errors.

Example of manifest generated for Codefresh pipeline with validation errors

Example of manifest generated for Codefresh pipeline with validation errors
  1. If required, click Close, update as needed and generate the manifest again.
  2. If there are no validation errors, click Copy.
  3. Paste the copied manifest as the last step in your CI pipeline.

CI integration argument reference

See here.

Container registry GitOps integrations
Issue tracking GitOps integrations
CI integrations argument reference