-title:GitOps CI integrations

url:"/ci-integrations"

sub-pages:

-title:CodefreshClassic

-title:Codefreshpipelines

url:"/codefresh-classic"

-title:GitHub Actions

url:"/github-actions"

toc:true

Get up to speed with navigation enhancements.

Get up to speed with navigation enhancements and changes with the New Codefresh Experience.

We added a new**Settings** icon to the toolbar to simplify account-level management for Codefresh administrators.

TheSettings iconisalways available, so you have_single-click access_ whenever you need to account-level options and settings.

With theSettings icon always available, you have_single-click access_ whenever you need to account-level options and settings.

max-width="70%"

%}

We divided the navigation into Avatar, account-level, and features and functionality. The→ indicates a changebetween versions.

We divided the navigation into Avatar, account-level, and features and functionality. The→ indicates a changein navigation.

{: .table .table-bordered .table-hover}

| CLASSIC||→|NEW||

| Bucket| Menu item|| Bucket| Menu item|

| -------------------| -------------------|| ----------------| ---------|

|**AVATAR**|||||

| CLASSIC|||NEWCODEFRESH EXPERIENCE||

| Bucket| Menu item|| Bucket| Menu item|

| -------------------| -------------------|---| ----------------| ---------|

|**AVATAR**|||No change||

||Account Settings|→|| Moved to Settings|

||User Management|→|| Moved to Settings|

||Billing|→|| Moved to Settings|

{: .table .table-bordered .table-hover}

| CLASSIC||→|NEW||

| CLASSIC|||NEWCODEFRESH EXPERIENCE||

| Bucket| Menu item|| Bucket| Menu item|

| -------------------| -------------------|| ----------------| ---------|

|**GENERAL**||| No change||

| -------------------| -------------------|| ----------------| ---------|

|**GENERAL**||| No change||

||**Account Information**|→|| (Renamed) Organization Information|

||**Users & Teams**|→|| Now in Access & Collaboration|

||**Users & Teams**|→|(Moved to) ACCESS & COLLABORATION||

||**Subscription & Billing**||| No change|

||**Usage**||| No change|

|**CONFIGURATION**||| No change||

||**Integrations**|→||(Renamed) Pipeline Integrations|

|||→||(New) GitOps Integrations|

||**Pipeline Settings**||| No change|

||**Pipeline Settings**||| No change|

||**Codefresh Runner**|→|| (Moved to) Runtimes bucket|

||**Runtime Environments**|→|| (Moved to) Runtimes bucket|

||**GitOps Controller**||| ??|

||**Shared Configuration**||| No change|

||**Nodes**||| ??|

||**GitOps Controller**||| ??|

||**Shared Configuration**||| No change|

||**Nodes**||| ??|

|**SECURITY**||→| (Renamed) ACCESS & COLLABORATION||

||**Single Sign-On**|||(Now in) Access & Collaboration|

||**Permissions**||| Now in Access & Collaboration|

||**Audit**||| Now in Access & Collaboration|

|||→| RUNTIMES||

||**Single Sign-On**|||(Now in) Access & Collaboration|

||**Permissions**||| Now in Access & Collaboration|

||**Audit**||| Now in Access & Collaboration|

|||→| RUNTIMES||

|||→|| (Renamed) Build Runtimes|

|||→||(New) GitOps Runtimes|

|||→|| (New) GitOps Runtimes|

We renamed menu groups and moved items for more intuitive access.

{: .table .table-bordered .table-hover}

| CLASSIC||→||NEW|

| Bucket| Menu item||||

| -------------------| -------------------|| ----------------| ---------|

||||| Home|

| CLASSIC||→|NEW CODEFRESH EXPERIENCE||

| Bucket| Menu item||||

| -------------------| -------------------|| ----------------| ---------|

||||| Home|

|||→| INSIGHTS||

||||| DORA Metrics|

|**BUILD > TEST > DEPLOY**||→|PIPELINES||

||||| DORA Metrics|

|**BUILD > TEST > DEPLOY**||→|(Renamed)PIPELINES||

||**Projects**||| No change|

||**Pipelines**||| No change|

||**Builds**||| No change|

||**Steps**||| No change|

|**DEVOPS INSIGHTS**||→|OPS||

|**DEVOPS INSIGHTS**||→|(Renamed)OPS||

|||→|| GitOps Apps|

||**Kubernetes > Services**|→|| Kubernetes Services|

| |**Kubernetes > Monitor** | | | ???

||**Account Settings**|→||(Moved) Settings in toolbar|

||**User Settings**|→|| Avatar|

1. Place the final action in the pipeline as the "report image" action provided by Codefresh.

See:

[GitHub Action Codefresh report image](https://github.com/marketplace/actions/codefresh-report-image){:target="\_blank"}

[CodefreshClassic Codefresh report image](https://codefresh.io/steps/step/codefresh-report-image){:target="\_blank"}

[Codefreshpipeline Codefresh report image](https://codefresh.io/steps/step/codefresh-report-image){:target="\_blank"}

1. 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).

1. View the image in Codefresh's[Images dashboard]({{site.baseurl}}/docs/deployments/gitops/images/), and in any[application]({{site.baseurl}}/docs/deployments/gitops/applications-dashboard/) in which it is used.

1. In the Codefresh UI, on the toolbar, click the**Settings** icon, and then from the sidebar, select[**GitOps Integrations**](https://g.codefresh.io/2.0/account-settings/integrations){:target="\_blank"}.

1. Filter by**CI tools**, then select the CI tool and click**Add**.

1. Define the arguments for the CI tool:

[CodefreshClassic]({{site.baseurl}}/docs/gitops-integrations/ci-integrations/codefresh-classic/)

[Codefreshpipelines]({{site.baseurl}}/docs/gitops-integrations/ci-integrations/codefresh-classic/)

[GitHub Actions]({{site.baseurl}}/docs/gitops-integrations/ci-integrations/github-actions/)

[Jenkins]({{site.baseurl}}/docs/gitops-integrations/ci-integrations/jenkins/)

lightbox="true"

file="/images/integrations/generated-manifest-with-error.png"

url="/images/integrations/generated-manifest-with-error.png"

alt="Example of manifest generated for CodefreshClassic with validation errors"

caption="Example of manifest generated for CodefreshClassic with validation errors"

alt="Example of manifest generated for Codefreshpipeline with validation errors"

caption="Example of manifest generated for Codefreshpipeline with validation errors"

max-width="50%"

%}

lightbox="true"

file="/images/integrations/classic/classic-manifest.png"

url="/images/integrationsclassic/classic-manifest.png"

alt="Example of manifest generated for CodefreshClassic"

caption="Example of manifest generated for CodefreshClassic"

alt="Example of manifest generated for Codefreshpipeline"

caption="Example of manifest generated for Codefreshpipeline"

max-width="50%"

%}

|`CF_IMAGE`| The image to be enriched and reported in Codefresh. Pass the`[account-name]/[image-name]:[tag]` built in your CI.| Required|

|`CF_WORKFLOW_NAME`| The name assigned to the workflow that builds the image. When defined, the name is displayed in the Codefresh platform. Example,`Staging step`| Optional|

|`CF_GIT_BRANCH`| The Git branch with the commit and PR (pull request) data to add to the image. Pass the Branch from the event payload used to trigger your action.| Required|

|`CF_GIT_REPO`| The Git repository with the configuration and code used to build the image. {::nomarkdown} <ul><li>Optional for GitHub Actions. <li>Required forClassic and Jenkins.</li><ul>{:/}| Required|

|`CF_GIT_REPO`| The Git repository with the configuration and code used to build the image. {::nomarkdown} <ul><li>Optional for GitHub Actions. <li>Required forCodefresh pipelines and Jenkins.</li><ul>{:/}| Required|

| `CF_GIT_PROVIDER` | The Git provider for the integration, and can be either `github`, `gitlab`, or `bitbucket`. {::nomarkdown} <ul><li>Optional when you don't define other related Git provider arguments. When not defined, Codefresh retrieves the required information from the runtime selected for the integration. <li>Required when you define at least one of the Git provider arguments. For example, when you define <span style="font-family: var(--font-family-monospace); font-size: 87.5%; color: #ad6800; background-color: #fffbe6">CF_GITLAB_TOKEN</span>, then you <i>must</i> define all Git provider arguments, in this case, <span style="font-family: var(--font-family-monospace); font-size: 87.5%; color: #ad6800; background-color: #fffbe6">CF_GIT_PROVIDER</span> as <span style="font-family: var(--font-family-monospace); font-size: 87.5%; color: #ad6800; background-color: #fffbe6">gitlab</span>, and <span style="font-family: var(--font-family-monospace); font-size: 87.5%; color: #ad6800; background-color: #fffbe6">CF_GITLAB_HOST_URL</span>.</li><ul>{:/}| Optional |

|`CF_GITLAB_TOKEN`| The token to authenticate the GitLab account. {::nomarkdown} <ul><li>Optional when you don't define any GitLab-specific arguments. When not defined, Codefresh retrieves the required information from the runtime selected for the integration. <li>Required when you define at least one of the GitLab-specific arguments, such as <spanstyle="font-family:var(--font-family-monospace);font-size:87.5%;color:#ad6800;background-color:#fffbe6">CF_GIT_PROVIDER</span> as <spanstyle="font-family:var(--font-family-monospace);font-size:87.5%;color:#ad6800;background-color:#fffbe6">gitlab</span>, or <spanstyle="font-family:var(--font-family-monospace);font-size:87.5%;color:#ad6800;background-color:#fffbe6">CF_GITLAB_HOST_URL</span>.</li><ul>{:/}| Optional|

|`CF_GITLAB_HOST_URL`| The URL address of your GitLab Cloud/Server instance. {::nomarkdown} <ul><li>Optional when you don't define other related GitLab-specific arguments. When not defined, Codefresh retrieves the required information from the runtime selected for the integration. <li>Required when you define at least one of the GitLab-specific arguments, such as <spanstyle="font-family:var(--font-family-monospace);font-size:87.5%;color:#ad6800;background-color:#fffbe6">CF_GIT_PROVIDER</span> as <spanstyle="font-family:var(--font-family-monospace);font-size:87.5%;color:#ad6800;background-color:#fffbe6">gitlab</span>, or <spanstyle="font-family:var(--font-family-monospace);font-size:87.5%;color:#ad6800;background-color:#fffbe6">CF_GITLAB_TOKEN</span>.</li><ul>{:/}| Optional|