-title:Deployments

icon:images/home-icons/deployment.svg

url:''

links:

-title:Deployment options for Kubernetes

localurl:/docs/deployments/kubernetes/deployment-options-to-kubernetes/

-title:Managing Kubernetes clusters

localurl:/docs/deployments/kubernetes/manage-kubernetes/

-title:Using Helm in Codefresh pipelines

localurl:/docs/deployments/helm/using-helm-in-codefresh-pipeline/

-title:Managing Helm releases

localurl:/docs/deployments/helm/helm-releases-management/

-title:Promoting Helm environments

localurl:/docs/deployments/helm/helm-environment-promotion/

-title:Creating GitOps applications

localurl:/docs/deployment/gitops/create-application/

-title:Monitoring applications

localurl:/docs/deployment/gitops/applications-dashboard/

-title:Managing applications

localurl:/docs/deployment/gitops/manage-application/

-title:Pipelines

icon:images/home-icons/pipeline.svg

-title:Deployments

url:"/deployments"

pages:

-title:Kubernetes

url:"/kubernetes"

sub-pages:

-title:Deployment options for Kubernetes

url:"/deployment-options-to-kubernetes"

-title:Managing Kubernetes clusters

url:"/manage-kubernetes"

-title:Custom kubectl commands

url:"/custom-kubectl-commands"

-title:Helm

url:"/helm"

sub-pages:

-title:Using Helm in a Codefresh pipeline

url:"/using-helm-in-codefresh-pipeline"

-title:Managing Helm Releases

url:"/helm-releases-management"

-title:Using managed Helm repos

url:"/managed-helm-repository"

-title:Helm Charts and repositories

url:"/helm-charts-and-repositories"

-title:Custom Helm uploads

url:"/custom-helm-uploads"

-title:Promoting Helm environments

url:"/helm-environment-promotion"

-title:GitOps

url:"/gitops"

sub-pages:

-title:Creating GitOps applications

url:"/create-application"

-title:Monitoring GitOps applications

url:"/applications-dashboard"

-title:Managing GitOps applications

url:"/manage-application"

-title:Progressive delivery with GitOps

url:"/install-argo-rollouts"

-title:Images for GitOps

url:"/images"

-title:CI pipelines

url:"/pipelines"

pages:

| Item| Description|

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

|Application filters | Filter by a range of attributes to customize the information in the dashboard to bring you what you need. {::nomarkdown} <ul><li>Application state<br>A snapshot that displays a breakdown of the deployed applications by their health status.<br>Click a status to filter by applications that match it.<br>Codefresh tracks Argo CD's set of health statuses. See the official documentation on <a href="https://argo-cd.readthedocs.io/en/stable/operator-manual/health" target=”_blank”>Health sets. </a>.</li><li>Application attributes<br>Attribute filters support multi-selection, and results are based on an OR relationship within the same filter with multiple options, and an AND relationship between filters.<br>Clicking <b>More Filters</b> gives you options to filter by Health status, Cluster names, Namespace, and Type. <br><ul><li>Application Type: Can be any of the following<ul><li>Applications: Standalone applications. See the official documentation on <a href="https://argo-cd.readthedocs.io/en/stable/operator-manual/declarative-setup/#applications" target=”_blank”>Applications</a>.</li><li>ApplicationSet: Applications created using the ApplicationSet Custom Resource (CR) template. An ApplicationSet can generate single or multiple applications. See the official documentation on <a href="https://argo-cd.readthedocs.io/en/stable/user-guide/application-set" target=”_blank”>Generating Applications with ApplicationSet</a>.</li><li>Git Source: Applications created by Codefresh that includes other applications and CI resources. See <a href="https://codefresh.io/csdp-docs/docs/runtime/git-sources">Git Sources</a>.</li></ul></li></li><li>Labels:The K8s labels defined for the applications. The list displays labels of <i>all</i> the applications, even if you have applied filters.<br>To see the available labels, select <b>Add</b>, and then select the required label and one or more values. <br>To filter by the labels, select <b>Add</b> and then <b>Apply</b>.<br> See the official documentation on <a href="https://kubernetes.io/docs/concepts/overview/working-with-objects/labels" target=”_blank”>Labels and selectors</a>.</li></ul></ul>{:/}|

|{::nomarkdown}<imgsrc="../../../images/icons/icon-mark-favorite.png?display=inline-block">{:/}| Star applications as favorites and view only the starred applications.{::nomarkdown}<br>Select the <imgsrc="../../../images/icons/icon-mark-favorite.png?display=inline-block"> to star the application as a favorite.<br><br>To filter by favorite applications, on the filters bar, select <imgsrc="../../../images/icons/icon-fav-starred.png?display=inline-block">.<br>{:/} TIP: If you star applications as favorites in the Applications dashboard, you can filter by the same applications in the[DORA metrics dashboard]({{site.baseurl}}/docs/reporting/dora-metrics/#metrics-for-favorite-applications).|

|{::nomarkdown}<imgsrc="../../../../images/icons/icon-mark-favorite.png?display=inline-block">{:/}| Star applications as favorites and view only the starred applications.{::nomarkdown}<br>Select the <imgsrc="../../../../images/icons/icon-mark-favorite.png?display=inline-block"> to star the application as a favorite.<br><br>To filter by favorite applications, on the filters bar, select <imgsrc="../../../../images/icons/icon-fav-starred.png?display=inline-block">.<br>{:/} TIP: If you star applications as favorites in the Applications dashboard, you can filter by the same applications in the[DORA metrics dashboard]({{site.baseurl}}/docs/reporting/dora-metrics/#metrics-for-favorite-applications).|

|Application actions| Options to monitor/manage applications through the application's context menu. {::nomarkdown}<ul><li>Quick view<br>A comprehensive read-only view of the deployment and definition information for the application.</li>{:/}See [Application Quick View](#view-deployment-and-configuration-info-for-selected-application) in this article.{::nomarkdown}<li>Synchronize/Sync<br>Manually synchronize the application.</li>{:/}See [Manually sync applications]({{site.baseurl}}/docs/deployments/gitops/manage-application/#manually-synchronize-an-application).{::nomarkdown}<li>Edit<br>Modify application definitions.</li>{:/}See [Edit application definitions]({{site.baseurl}}/docs/deployments/gitops/manage-application/#edit-application-definitions).{::nomarkdown}<li>Refresh and Hard Refresh: Available in Card view only. In List view, you must first select the application. <ul><li>Refresh: Retrieve desired (Git) state, compare with the live (cluster) state, and refresh the application to sync with the desired state.</li><li>Hard Refresh: Refresh the application to sync with the Git state, while removing the cache.</li></ul>{:/} |

Displays health, sync status, and source and destination definitions.

{% include

max-width="30%"

%}

Displays labels and annotations for the application.

{% include

max-width="30%"

%}

Displays parameters configured for the application, based on the tool used to create the application's manifests.

The parameters displayed differ according to the tool:`directory` (as in the screenshot below),`Helm` charts, or`Kustomize` manifests, or the specific plugin.

max-width="30%"

%}

Displays sync options enabled for the application.

{% include

max-width="30%"

%}

Displays the YAML version of the application manifest.

{% include

max-width="30%"

%}

Displays status and sync events for the application.

{% include

The Current State tab supports Tree and List view formats.

* Tree view (default): A hierarchical, interactive visualization of the application and its resources. Useful for complex deployments with multiple clusters and large numbers of resources. See also[Working with resources in Tree view](#working-with-resources-in-tree-view).

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

| Health status| Description| Display in Tree view|

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

|**Healthy**| Resource is functioning as required.| {::nomarkdown}<img src="../../../images/icons/current-state-healthy.png" display=inline-block">{:/}|

|**Progressing**| Resource is not healthy but can become healthy before the timeout occurs.| {::nomarkdown}<img src="../../../images/icons/current-state-progressing.png" display=inline-block">{:/}|

|**Suspended**| Resource is not functioning, and is either suspended or paused. For example, Cron job or a canary rollout.| {::nomarkdown}<img src="../../../images/icons/current-state-suspended.png" display=inline-block">{:/}|

|**Healthy**| Resource is functioning as required.| {::nomarkdown}<img src="../../../../images/icons/current-state-healthy.png" display=inline-block">{:/}|

|**Progressing**| Resource is not healthy but can become healthy before the timeout occurs.| {::nomarkdown}<img src="../../../../images/icons/current-state-progressing.png" display=inline-block">{:/}|

|**Suspended**| Resource is not functioning, and is either suspended or paused. For example, Cron job or a canary rollout.| {::nomarkdown}<img src="../../../../images/icons/current-state-suspended.png" display=inline-block">{:/}|

|**Missing**| Resource is not present on the cluster.|{::nomarkdown}<img src="../../../images/icons/current-state-missing.png" display=inline-block">{:/}|

|**Degraded**| Resource is not healthy, or a timeout occurred before it could reach a healthy status.| {::nomarkdown}<imgsrc="../../../images/icons/current-state-degraded.png"display=inline-block/>{:/}|

|**Unknown**| Resource does not have a health status, or the health status is not tracked in Argo CD. For example,`ConfigMaps` resource types.| {::nomarkdown}<img src="../../../images/icons/current-state-unknown.png" display=inline-block">{:/}|

|**Degraded**| Resource is not healthy, or a timeout occurred before it could reach a healthy status.| {::nomarkdown}<imgsrc="../../../../images/icons/current-state-degraded.png"display=inline-block/>{:/}|

|**Unknown**| Resource does not have a health status, or the health status is not tracked in Argo CD. For example,`ConfigMaps` resource types.| {::nomarkdown}<img src="../../../../images/icons/current-state-unknown.png" display=inline-block">{:/}|

See also[Argo CD's set of health checks](https://argo-cd.readthedocs.io/en/stable/operator-manual/health/){:target="\_blank"}.

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

| Sync state| Description|Display in Tree view|

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

|**Synced**| The live state of the resource on the cluster is identical to the desired state in Git.| {::nomarkdown}<img src="../../../images/icons/current-state-synced.png" display=inline-block">{:/}|

|**Syncing**| The live state of the resource was not identical to the desired state, and is currently being synced.| {::nomarkdown}<imgsrc="../../../images/icons/current-state-syncing.png"display=inline-block/>{:/}|

|**Out-of-Sync**| {::nomarkdown}The live state is not identical to the desired state.<br>To sync a resource, select the <b>Sync</b> option from the resource's context menu in Tree view. {:/}| {::nomarkdown}<img src="../../../images/icons/current-state-out-of-sync.png" display=inline-block">{:/}|

|**Unknown**| The sync status could not be determined.| {::nomarkdown}<img src="../../../images/icons/current-state-sync-unknown.png" display=inline-block">{:/}|

|**Synced**| The live state of the resource on the cluster is identical to the desired state in Git.| {::nomarkdown}<img src="../../../../images/icons/current-state-synced.png" display=inline-block">{:/}|

|**Syncing**| The live state of the resource was not identical to the desired state, and is currently being synced.| {::nomarkdown}<imgsrc="../../../../images/icons/current-state-syncing.png"display=inline-block/>{:/}|

|**Out-of-Sync**| {::nomarkdown}The live state is not identical to the desired state.<br>To sync a resource, select the <b>Sync</b> option from the resource's context menu in Tree view. {:/}| {::nomarkdown}<img src="../../../../images/icons/current-state-out-of-sync.png" display=inline-block">{:/}|

|**Unknown**| The sync status could not be determined.| {::nomarkdown}<img src="../../../../images/icons/current-state-sync-unknown.png" display=inline-block">{:/}|

The Application Warnings/Errors panel surfaces sync errors on exceeding the maximum number of retries and when a sync operation extends beyond 30 minutes.

%}

[Creating GitOps applications]({{site.baseurl}})/docs/deployments/gitops/create-application)

[Managing GitOps applications]({{site.baseurl}})/docs/deployments/gitops/manage-applications)

[Creating GitOps applications]({{site.baseurl}}/docs/deployments/gitops/create-application)

[Managing GitOps applications]({{site.baseurl}}/docs/deployments/gitops/manage-applications)

[Home dashboard]({{site.baseurl}}/docs/reporting/home-dashboard)

[DORA metrics]({{site.baseurl}}/docs/reporting/dora-metrics/)

|**5**| The log information for the build image step in the relevant workflow. Select to view Logs panel.|

[Creating GitOps applications]({{site.baseurl}})/docs/deployments/gitops/create-application)

[Managing GitOps applications]({{site.baseurl}})/docs/deployments/gitops/manage-applications)

[Creating GitOps applications]({{site.baseurl}}/docs/deployments/gitops/create-application)

[Managing GitOps applications]({{site.baseurl}}/docs/deployments/gitops/manage-applications)

[Image enrichment with integrations]({{site.baseurl}}/integrations/image-enrichment-overview)

[Home dashboard]({{site.baseurl}}/docs/reporting/home-dashboard)

description:"Use external Helm Charts and repositories in Codefresh pipelines"

group:deployments

sub_group:helm

permalink:/:collection/deployments/helm/add-helm-repository/

redirect_from:

-/docs/deployments/helm/

-/docs/add-helm-repository/

toc:true

Codefresh allows you to integrate with external Helm repositories and Helm charts in the Helm Charts page.

{% include image.html

lightbox="true"

file="/images/kubernetes-helm/quick-helm-integration.png"

url="/images/kubernetes-helm/quick-helm-integration.png"

file="/images/deployments/helm/quick-helm-integration.png"

url="/images/deployments/helm/quick-helm-integration.png"

alt="Adding a Helm repository"

caption="Adding a Helm repository"

max-width="70%"

{% include image.html

lightbox="true"

file="/images/kubernetes-helm/connect-helm-repo.png"

url="/images/kubernetes-helm/connect-helm-repo.png"

file="/images/deployments/helm/connect-helm-repo.png"

url="/images/deployments/helm/connect-helm-repo.png"

alt="Connecting a Helm repository in the pipeline"

caption="Connecting a Helm repository in the pipeline"

max-width="70%"