bitnamicharts/argo-cd

Bitnami Argo CD 软件包

Argo CD是基于GitOps的Kubernetes持续交付工具。

https://argoproj.github.io/cd

商标声明：本软件列表由Bitnami打包。产品中提及的相关商标归各自公司所有，使用这些商标并不意味着任何关联或认可。

快速入门

console
helm install my-release oci://registry-1.docker.io/bitnamicharts/argo-cd

提示：您知道此应用也可作为Azure Marketplace上的Kubernetes应用使用吗？Kubernetes应用是在AKS上部署Bitnami的最简单方式。点击此处查看Azure Marketplace上的列表。

希望在生产环境中使用Argo CD？试试VMware Tanzu Application Catalog，这是Bitnami目录的商业版。

⚠️ 重要通知：Bitnami目录即将变更

自2025年8月28日起，Bitnami将升级其公共目录，在新的Bitnami安全镜像计划下提供精选的强化、安全聚焦镜像。作为此次转型的一部分：

• 首次向社区用户提供流行容器镜像的安全优化版本访问权限。
• Bitnami将开始在免费层中停止支持非强化的基于Debian的软件镜像，并将逐步从公共目录中移除非最新标签。因此，社区用户将只能访问数量减少的强化镜像。这些镜像仅以“latest”标签发布，仅供开发用途。
• 从8月28日开始，在两周内，所有现有容器镜像（包括旧版本或特定版本标签，如2.50.0、10.6）将从公共目录（docker.io/bitnami）迁移到“Bitnami Legacy”仓库（docker.io/bitnamilegacy），迁移后将不再接收更新。
• 对于生产工作负载和长期支持，建议用户采用Bitnami安全镜像，包括强化容器、更小的***面、CVE透明度（通过VEX/KEV）、SBOM以及企业支持。

这些变更旨在通过推广软件供应链完整性和最新部署的最佳实践，提高所有Bitnami用户的安全态势。更多详情，请访问https://github.com/bitnami/containers/issues/83267%E3%80%82

介绍

此图表使用Helm包管理器在Kubernetes集群上引导Argo CD部署。

前提条件

• Kubernetes 1.23+
• Helm 3.8.0+
• 底层基础设施支持PV供应器
• 用于部署扩展的ReadWriteMany卷

安装图表

要使用发布名称my-release安装图表：

console
helm install my-release oci://REGISTRY_NAME/REPOSITORY_NAME/argo-cd

注意：您需要将占位符REGISTRY_NAME和REPOSITORY_NAME替换为Helm图表仓库和存储库的引用。例如，对于Bitnami，需使用REGISTRY_NAME=registry-1.docker.io和REPOSITORY_NAME=bitnamicharts。

该命令使用默认配置在Kubernetes集群上部署argo-cd。参数部分列出了可在安装过程中配置的参数。

提示：使用helm list列出所有发布

配置和安装详情

资源请求和限制

Bitnami图表允许为图表部署内的所有容器设置资源请求和限制。这些设置位于resources值中（参见参数表）。设置请求对于生产工作负载至关重要，应根据您的具体用例进行调整。

为简化此过程，图表包含resourcesPreset值，可根据不同预设自动设置resources部分。在https://github.com/bitnami/charts/blob/main/bitnami/common/templates/_resources.tpl#L15%E4%B8%AD%E6%9F%A5%E7%9C%8B%E8%BF%99%E4%BA%9B%E9%A2%84%E8%AE%BE%E3%80%82%E4%BD%86%E5%9C%A8%E7%94%9F%E4%BA%A7%E5%B7%A5%E4%BD%9C%E8%B4%9F%E8%BD%BD%E4%B8%AD%EF%BC%8C%E4%B8%8D%E5%BB%BA%E8%AE%AE%E4%BD%BF%E7%94%A8%60resourcesPreset%60%EF%BC%8C%E5%9B%A0%E4%B8%BA%E5%AE%83%E5%8F%AF%E8%83%BD%E6%97%A0%E6%B3%95%E5%AE%8C%E5%85%A8%E9%80%82%E5%BA%94%E6%82%A8%E7%9A%84%E7%89%B9%E5%AE%9A%E9%9C%80%E6%B1%82%E3%80%82%E6%9C%89%E5%85%B3%E5%AE%B9%E5%99%A8%E8%B5%84%E6%BA%90%E7%AE%A1%E7%90%86%E7%9A%84%E6%9B%B4%E5%A4%9A%E4%BF%A1%E6%81%AF%EF%BC%8C%E8%AF%B7%E5%8F%82%E9%98%85%E5%AE%98%E6%96%B9Kubernetes%E6%96%87%E6%A1%A3%E3%80%82

滚动标签与不可变标签

强烈建议在生产环境中使用不可变标签。这可确保如果同一标签使用不同镜像更新，您的部署不会自动更改。

如果主容器有新版本、重大变更或严重漏洞，Bitnami将发布新图表更新其容器。

Prometheus指标

通过将*.metrics.enabled（在repoServer、controller、applicationSet、server、notification和dex部分下）设置为true，可将此图表与Prometheus集成。这将公开Argo CD原生Prometheus端口，并创建可在metrics.service部分下配置的特殊指标服务。此metrics服务将具有必要的注解，可被Prometheus自动抓取。

Prometheus要求

要使集成工作，必须安装Prometheus或Prometheus Operator。安装https://github.com/bitnami/charts/tree/main/bitnami/prometheus%E6%88%96https://github.com/bitnami/charts/tree/main/bitnami/kube-prometheus%EF%BC%8C%E5%8F%AF%E5%9C%A8%E9%9B%86%E7%BE%A4%E4%B8%AD%E8%BD%BB%E6%9D%BE%E8%8E%B7%E5%BE%97%E5%8F%AF%E7%94%A8%E7%9A%84Prometheus%E3%80%82

与Prometheus Operator集成

该图表可部署ServiceMonitor对象，用于与Prometheus Operator安装集成。为此，将*.metrics.serviceMonitor.enabled=true（在repoServer、controller、applicationSet、server、notifications和dex部分下）设置为true。确保集群中已安装Prometheus OperatorCustomResourceDefinitions，否则将失败并显示以下错误：

text
no matches for kind "ServiceMonitor" in version "monitoring.coreos.com/v1"

安装https://github.com/bitnami/charts/tree/main/bitnami/kube-prometheus%E4%BB%A5%E8%8E%B7%E5%8F%96%E5%BF%85%E8%A6%81%E7%9A%84CRD%E5%92%8CPrometheus Operator。

备份和恢复

要在Kubernetes上备份和恢复Helm图表部署，需要使用Velero（Kubernetes备份/恢复工具）备份源部署的持久卷，并将其附加到新部署。在本指南中查找使用Velero的说明。

Ingress

此图表支持Ingress资源。如果集群上安装了Ingress控制器（如https://github.com/bitnami/charts/tree/main/bitnami/nginx-ingress-controller%E6%88%96https://github.com/bitnami/charts/tree/main/bitnami/contour%EF%BC%89%EF%BC%8C%E5%8F%AF%E5%88%A9%E7%94%A8Ingress%E6%8E%A7%E5%88%B6%E5%99%A8%E4%B8%BA%E5%BA%94%E7%94%A8%E6%8F%90%E4%BE%9B%E6%9C%8D%E5%8A%A1%E3%80%82%E8%A6%81%E5%90%AF%E7%94%A8Ingress%E9%9B%86%E6%88%90%EF%BC%8C%E5%B0%86%60server.ingress.enabled%60%E8%AE%BE%E7%BD%AE%E4%B8%BA%60true%60%E4%BB%A5%E5%90%AF%E7%94%A8HTTP Ingress，或server.grpcIngress.enabled设置为true以启用gRPC Ingress。

最常见的场景是将一个主机名映射到部署。在这种情况下，xxx.ingress.hostname属性可用于设置主机名。xxx.ingress.tls参数可用于为此主机添加TLS配置。

但也可以有多个主机。为此，可设置xxx.ingress.extraHosts参数（如果可用），将主机名指定为数组。xxx.ingress.extraTLS参数（如果可用）也可用于为额外主机添加TLS配置。

注意：对于xxx.ingress.extraHosts参数中指定的每个主机，需要设置名称、路径以及Ingress控制器应了解的任何注解。并非所有注解都受所有Ingress控制器支持，但https://github.com/kubernetes/ingress-nginx/blob/master/docs/user-guide/nginx-configuration/annotations.md%E5%88%97%E5%87%BA%E4%BA%86%E8%AE%B8%E5%A4%9A%E6%B5%81%E8%A1%8CIngress%E6%8E%A7%E5%88%B6%E5%99%A8%E6%94%AF%E6%8C%81%E7%9A%84%E6%B3%A8%E8%A7%A3%E3%80%82

添加TLS参数（如果可用）将导致图表生成HTTPS URL，应用将在端口443上可用。TLS密钥不必由此图表生成。但如果启用TLS，Ingress记录在TLS密钥存在之前将无法工作。

了解更多关于Ingress控制器。

使用TLS保护流量

此图表便于创建用于Ingress控制器的TLS密钥（尽管这不是必需的）。除Ingress TLS证书外，Argo CD repo服务器将自动生成名为argocd-repo-server-tls的密钥。此密钥包含Argo CD组件的TLS配置。仅当密钥不存在时才会创建，因此如果要添加自定义TLS配置，可在安装图表前创建具有该名称的密钥。TLS密钥生成有几个常见用例：

• 基于图表参数生成证书密钥。
• 启用外部生成的证书。
• 通过外部服务（如https://github.com/jetstack/cert-manager/%EF%BC%89%E7%AE%A1%E7%90%86%E5%BA%94%E7%94%A8%E8%AF%81%E4%B9%A6%E3%80%82
• 在图表内创建自签名证书（如果支持）。

在前两种情况下，需要证书和密钥。文件应为.pem格式。

证书文件示例：

注意：如果存在证书链，可能有多个证书。

text
-----BEGIN CERTIFICATE-----
MIID6TCCAtGgAwIBAgIJAIaCwivkeB5EMA0GCSqGSIb3DQEBCwUAMFYxCzAJBgNV
...
jScrvkiBO65F46KioCL9h5tDvomdU1aqpI/CBzhvZn1c0ZTf87tGQR8NK7v7
-----END CERTIFICATE-----

证书密钥示例：

text
-----BEGIN RSA PRIVATE KEY-----
MIIEogIBAAKCAQEAvLYcyu8f3skuRyUgeeNpeDvYBCDcgq+LsWap6zbX5f8oLqp4
...
wrj2wDbCDCFmfqnSJ+dKI3vFLlEz44sAV8jX/kd4Y6ZTQhlLbYc=
-----END RSA PRIVATE KEY-----

• 如果使用Helm基于参数管理证书，将这些值复制到给定*.ingress.secrets条目的certificate和key值中。
• 如果单独管理TLS密钥，需要创建名称为INGRESS_HOSTNAME-tls的TLS密钥（其中INGRESS_HOSTNAME是占位符，需替换为使用*.ingress.hostname参数设置的主机名）。
• 如果集群有https://github.com/jetstack/cert-manager%E6%8F%92%E4%BB%B6%E7%94%A8%E4%BA%8E%E8%87%AA%E5%8A%A8%E7%AE%A1%E7%90%86%E5%92%8C%E9%A2%81%E5%8F%91TLS%E8%AF%81%E4%B9%A6%EF%BC%8C%E5%8F%AF%E5%9C%A8%60*.ingress.annotations%60%E4%B8%AD%E6%B7%BB%E5%8A%A0%E7%9B%B8%E5%BA%94%E6%B3%A8%E8%A7%A3%E3%80%82
• 如果使用Helm创建的自签名证书，将*.ingress.tls和*.ingress.selfSigned都设置为true。

默认配置映射和密钥

图表对某些ConfigMap和Secret有硬编码名称，如argocd-ssh-known-hosts-cm、argocd-repo-server-tls或argocd-ssh-known-hosts-cm。安装图表时，Argo CD将搜索这些特定名称，因此由于此限制，无法在同一命名空间中两次安装图表。有关每个配置映射或密钥的更多信息，请查看相应YAML文件中的引用。

使用SSO

要使用SSO，需要通过设置dex.enabled=true启用Dex。可按照本指南将Argo CD部署配置到身份提供商中。之后，需要按照此处所述配置Argo CD。可在server.config.dex\.config中设置Dex配置，这将填充argocd-cm配置映射。

注意：dex.config是对象的键。如果使用Helm CLI设置参数，需要转义.，如--set server.config.dex\.config。 重要：如果启用Dex但未配置，将出现类似msg="dex is not configured"的错误，且Dex pod将无法达到运行状态。

安装配置管理插件

要按照官方文档所述安装配置管理插件，建议运行边车容器并从ConfigMap挂载插件配置。可使用repoServer.extraVolumes、repoServer.sidecars和extraDeploy参数实现，如下例所示：

yaml
repoServer:
  extraVolumes:
    - name: plugin-config
      configMap:
        name: my-plugin-config
    - name: plugins
      emptyDir: {}
    - name: plugin-tmp
      emptyDir: {}
    - name: var-files
      emptyDir: {}
  sidecars:
    - name: plugin-sidecar
      command: [argocd-cmp-server, --config-dir-path, /app/config]
      image: "{{ include \"argocd.image\" . }}"
      env:
        - name: ARGOCD_PLUGINSOCKFILEPATH
          value: /app/plugins
      securityContext:
        runAsNonRoot: true
        runAsUser: 1001
      volumeMounts:
        - mountPath: /app/plugins
          name: plugins
        - mountPath: /tmp
          name: plugin-tmp
        - mountPath: /var/run/argocd
          name: var-files
        # 插入插件配置
        - mountPath: /app/config/plugin.yaml
          subPath: plugin.yaml
          name: plugin-config
extraDeploy:
- apiVersion: v1
  kind: ConfigMap
  metadata:
    name: my-plugin-config
  data:
    plugin.yaml: |
      apiVersion: argoproj.io/v1alpha1
      kind: ConfigManagementPlugin
      metadata:
        name: my-plugin
      spec:
        version: v1.0
        (...)

允许多命名空间部署

如果希望允许在多个命名空间中部署应用/应用集，可使用以下配置Argo-CD。

上游文档：

• 重新配置Argo CD以允许应用使用特定命名空间
• 重新配置Argo CD以允许应用集使用特定命名空间

yaml
controller:
  # 默认值为true
  clusterAdminAccess: true
  extraArgs:
  # 参考文档以允许特定命名空间：
  # https://argo-cd.readthedocs.io/en/stable/operator-manual/app-any-namespace/#change-workload-startup-parameters
  - --application-namespaces=*
  # 如果启用通知，请参考文档
  # https://argo-cd.readthedocs.io/en/stable/operator-manual/notifications/#namespace-based-configuration
  - --self-service-notification-enabled

server:
  # 默认值为true
  clusterAdminAccess: true
  # 参考推荐文档进行配置：
  # https://argo-cd.readthedocs.io/en/stable/operator-manual/app-any-namespace/#switch-resource-tracking-method
  config:
    application.resourceTrackingMethod: annotation

repoServer:
  # 默认值为false
  clusterAdminAccess: true

notifications:
  # 如果希望使用通知，启用此项，默认值为false
  enabled: true
  # 默认值为false
  clusterAdminAccess: true

applicationSet:
  # 如果希望使用应用集，启用此项，默认值为false
  enabled: true
  # 默认值为false
  clusterAdminAccess: true

  # 参考SCM提供程序文档：
  # https://argo-cd.readthedocs.io/en/stable/operator-manual/applicationset/Appset-Any-Namespace/#scm-providers-secrets-consideration
  extraEnv:
  - name: ARGOCD_APPLICATIONSET_CONTROLLER_ENABLE_SCM_PROVIDERS
    value: true
  - name: ARGOCD_APPLICATIONSET_CONTROLLER_ALLOWED_SCM_PROVIDERS
    value: https://git.mydomain.com/,https://gitlab.mydomain.com/

额外环境变量

如果要添加额外环境变量（用于高级操作，如自定义初始化脚本），可使用extraEnvVars属性。

yaml
argo-cd:
  extraEnvVars:
    - name: LOG_LEVEL
      value: error

或者，可使用带有环境变量的ConfigMap或Secret。为此，使用extraEnvVarsCM或extraEnvVarsSecret值。

边车容器

如果在与Argo-CD相同的pod中需要额外容器（如额外指标或日志导出器），