toc:true

Building Docker images is one of the most basic requirementsfor creating Codefresh pipelines and Argo Workflows.

Building Docker images is one of the most basic requirementsof Codefresh pipelines and Argo Workflows.

Once you create an image, push the image to a registry, and report it to Codefresh, image information is continually updated in the Images page.

If you

Images are pulled to the dashboard

Complete the mandatory steps to see your Images in the Codefresh UI. Each step has links to examples in the Codefresh Hub for Argo.

1. (Mandatory) Build the Docker image, and push the image to any registry.

See[Create a Docker image using Kaniko](https://codefresh.io/argohub/workflow-template/kaniko){:target="\_blank"}.

1. (Optional) Enrich image information with annotations and metadata.

For Git and Jira image enrichment examples, see[Codefresh-metadata image enrichment](https://codefresh.io/argohub/workflow-template/CSDP-metadata){:target="\_blank"}.

1. (Mandatory) Report image information to Codefresh.

See the[report-image-info](https://github.com/codefresh-io/argo-hub/blob/main/workflows/codefresh-csdp/versions/0.0.6/docs/report-image-info.md){:target="\_blank"} example.

1. (Mandatory) Build and push the Docker image

* Codefresh pipelines

Use the`build` step to build a Docker image declaratively in simple or multi-stage Dockerfiles. See[Build step in pipelines]({{site.baseurl}}/docs/pipelines/steps/build/).

The pipeline pushes the image to the default Docker registry.

You can also push the image to any external Docker registry that you integrate with Codefresh. See[Docker Registries for pipeline integrations]({{site.baseurl}}/docs/integrations/docker-registries/).

Review different scenarios for building and pushing Docker images in our[Build/push examples]({{site.baseurl}}/docs/example-catalog/examples/#buildpush-examples).

* GitOps

Create the Docker image.

[Create a Docker image using Kaniko](https://codefresh.io/argohub/workflow-template/kaniko){:target="\_blank"}.

1. (Mandatory) GitOps: Connect to Docker registries

Connect Docker registries to Codefresh to store Docker images.

See[GitOps container registry integrations]({{site.baseurl}}/docs/gitops-integrations/container-registries).

1. (Mandatory) GitOps: Report image information to Codefresh.

This is the equivalent to pushing the image in Codefresh pipelines.

Use the[report-image-info] (https://github.com/codefresh-io/argo-hub/blob/main/workflows/codefresh-csdp/versions/0.0.6/docs/report-image-info.md){:target="\_blank"} DAG template to report image information to Codefresh.

1. (Optional) Enrich image with annotations and metadata

Image enrichment exposes metadata such as feature requests, pull requests, and logs as part of the application’s deployment, for visibility into all aspects of the deployment, making it easier to track actions and identify root cause of failures.

* Codefresh pipelines

See[Docker image metadata]({{site.baseurl}}/docs/pipelines/docker-image-metadata/)

* GitOps

See[GitOps issue tracking integrations]({{site.baseurl}}/docs/gitops-integrations/issue-tracking) and[Jira]({{site.baseurl}}/docs/gitops-integrations/issue-tracking/jira) integration.

* In the Codefresh UI, from Artifacts in the sidebar, select[Images](https://g.codefresh.io/2.0/images){:target="\_blank"}.

Image views are layered to show three levels of data:

* Summary with metadata and binary information

As with any resource in Codefresh,image views support filters that allow you focus on the data that's important to you.

As with any resource in Codefresh,the Image dashboard support filters that allow you focus on the data that's important to you.

Most image filters support multi-selection. Unless otherwise indicated, the filters are common to all view levels.

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

Helm packages are just TAR files. Helm repositories are simple file hierarchies with an extra[index.yaml](https://helm.sh/docs/developing_charts/#the-chart-repository-structure){:target="\_blank"}.

You can run custom commands and manually upload indexes and packages to a Helm repo.

For the basic use cases, or if you are just getting started with Helm, see our[Helm quick start guide]({{site.baseurl}}/docs/quick-start/ci-quickstart/deploy-with-helm/) and[Using Helm in pipelines]({{site.baseurl}}/docs/deployments/helm/using-helm-in-codefresh-pipeline/).

{% endhighlight %}

The`helm package` command expects a path to an unpacked chart. Replace`<mychart>` in the example with the directory that holds your chart files. Note that this directory must have the same name as the chart name, as per Helm requirements.<br>

See[Helm package docs](https://github.com/kubernetes/helm/blob/master/docs/helm/helm_package.md){:target="_blank"} and[Helm charts overview](https://github.com/kubernetes/helm/blob/master/docs/charts.md){:target="_blank"} for more information.

See[Helm package docs](https://helm.sh/docs/helm/helm_package/){:target="_blank"} and[Helm charts overview](https://helm.sh/docs/topics/charts/){:target="_blank"} for more information.

{{site.data.callout.callout_info}}

To use`cf_export`and make the variable available to other steps in the pipeline, see [Variables in pipelines]({{site.baseurl}}/docs/pipelines/variables).

From the main release screen, you have some additional actions.

You can issue a Helm test<!--- [Helm test](https://github.com/kubernetes/helm/blob/master/docs/chart_tests.md)--> by clicking onthe'Run Test' button onthe desired chart row.

You can deletea release by clicking on the 'Delete' button on the desired chart row.

Selecttherow withthe desired chart, and:

* Deletea release by clicking on the 'Delete' button.

For deletion options, see the[Helm delete documentation](https://helm.sh/docs/helm/helm_uninstall/){:target="\_blank"}. For example,*purge*removesthe revision from the release history.

The following instructions describe how to create a new service in your Kubernetes cluster in order to deploy to it.

1.Go tothe**`Kubernetes`&#8594;`Services page`**.

1. Click the button**“Add Service”**.

1.In the Codefresh UI, from Ops inthesidebar, select[**KubernetesServices**](https://g.codefresh.io/kubernetes/services/){:target="\_blank"}.

1. Click the button**Add Service**.

1. Select the**cluster**.

1. Select the**namespace**.

1. Type an arbitrary**service name**.

**Jira notifications**

Codefresh integrates with Jira in several ways:

The standard integration provides the highest visibility into your GitOps deployments. Referencing the integration in your pipeline pulls in all the Jira information and enriches the image with the issue-tracking information.

Our versatile[Jira Issue Manager](https://codefresh.io/steps/step/jira-issue-manager?__hstc=13221992.d6be31528e6c55e9c8e25cbf4f7ec143.1637822320970.1673765905554.1673785426249.294&__hssc=13221992.18.1673785426249&__hsfp=1203046529{:target="\_blank"} step can be used to create Jira issues, comment on existing Jira issues, change the status of an issue, and even add a description to your issue.

Our versatile[Jira Issue Manager](https://codefresh.io/steps/step/jira-issue-manager){:target="\_blank"} step can be used to create Jira issues, comment on existing Jira issues, change the status of an issue, and even add a description to your issue.

See[Jira notifications in Codefresh]({{site.baseurl}}/docs/integrations/notifications/jira-integration/) and[examples for Jira notification]({{site.baseurl}}/docs/example-catalog/ci-examples/sending-the-notification-to-jira/).

Codefresh has partnered with[Google Cloud](https://cloud.google.com/){:target="\_blank"} and allows you to install a Codefresh pipeline builder within your own Kubernetes cluster.

The integration is available in the Google Marketplace for Kubernetes apps at[https://console.cloud.google.com/marketplace/details/codefresh-gke/codefresh](https://console.cloud.google.com/marketplace/details/codefresh-gke/codefresh){:target="\_blank"}.

The integration is available in the Google Marketplace for Kubernetes apps at[https://console.cloud.google.com/marketplace/product/codefresh-gke/codefresh-saas](https://console.cloud.google.com/marketplace/product/codefresh-gke/codefresh-saas){:target="\_blank"}.

Once you configure Codefresh to use your own Kubernetes cluster for builds, you can enjoy all benefits of a**hybrid** installation as the Codefresh UI and management dashboards will still run in a SAAS manner, while the actual builds and pipelines will execute in your own cluster.

1. A[GKE cluster](https://cloud.google.com/kubernetes-engine/docs/quickstart){:target="\_blank"} that will run all builds and pipelines

1. A[Codefresh account]({{site.baseurl}}/docs/administration/account-user-management/create-a-codefresh-account/) (creating an account is free, you pay only for builds)

Then visit the Codefresh GKE page at[https://console.cloud.google.com/marketplace/details/codefresh-gke/codefresh](https://console.cloud.google.com/marketplace/details/codefresh-gke/codefresh){:target="\_blank"}.

Then visit the Codefresh GKE page at[https://console.cloud.google.com/marketplace/product/codefresh-gke/codefresh-saas](https://console.cloud.google.com/marketplace/product/codefresh-gke/codefresh-saas){:target="\_blank"}.

You will pay for the cluster resources to Google, plus the Codefresh builds. Codefresh does not collect any payment from you directly. Google Cloud will invoice you for both the cluster infrastructure and the cluster usage.

Current pricing for Codefresh builds is always shown in the[marketplace page](https://console.cloud.google.com/marketplace/details/codefresh-gke/codefresh){:target="\_blank"}.

Current pricing for Codefresh builds is always shown in the[marketplace page](https://console.cloud.google.com/marketplace/product/codefresh-gke/codefresh-saas){:target="\_blank"}.

1. Navigate to[https://console.cloud.google.com/marketplace/details/codefresh-gke/codefresh](https://console.cloud.google.com/marketplace/details/codefresh-gke/codefresh){:target="\_blank"}.

1. Navigate to[https://console.cloud.google.com/marketplace/product/codefresh-gke/codefresh-saas](https://console.cloud.google.com/marketplace/details/codefresh-gke/codefresh){:target="\_blank"}.

1. From the dropdown menu at the top of the page, select a Google project that has billing enabled.

1. Click**Configure**.

alt="Removing the Codefresh application"

%}

You can install the Codefresh builder again from the[marketplace](https://console.cloud.google.com/marketplace/details/codefresh-gke/codefresh){:target="\_blank"}.

You can install the Codefresh builder again from the[marketplace](https://console.cloud.google.com/marketplace/product/codefresh-gke/codefresh-saas){:target="\_blank"}.

[Manage your cluster]({{site.baseurl}}/docs/deployments/kubernetes/manage-kubernetes/)