bitnamicharts/concourse

Bitnami Concourse 软件包

Concourse 是一个用 Go 编写的自动化系统。它最常用于 CI/CD，并且被设计为可扩展到任何类型的自动化流水线，从简单到复杂。

Concourse 概述

快速使用

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

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

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

自 2025 年 8 月 28 日起，Bitnami 将改进其公共目录，在新的 Bitnami Secure Images 计划下提供精选的强化、安全聚焦镜像集。作为此过渡的一部分：

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

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

介绍

此 chart 使用 Helm 包管理器在 Kubernetes 集群上引导部署 Concourse。

它还包含了 https://github.com/bitnami/charts/tree/main/bitnami/postgresql%E3%80%82

前提条件

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

安装 Chart

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

console
helm install my-release oci://REGISTRY_NAME/REPOSITORY_NAME/concourse

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

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

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

配置和安装详情

资源请求和限制

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

为简化此过程，chart 包含 resourcesPreset 值，可根据不同预设自动设置 resources 部分。查看 https://github.com/bitnami/charts/blob/main/bitnami/common/templates/_resources.tpl#L15 中的这些预设。然而，在生产工作负载中不建议使用 resourcesPreset，因为它可能无法完全适应您的特定需求。有关容器资源管理的更多信息，请参阅 Kubernetes 官方文档。

滚动标签 vs 不可变标签

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

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

使用外部数据库

有时，您可能希望让 Concourse 连接到集群外的外部数据库，例如使用托管数据库服务或为所有应用程序运行单个数据库服务器时。要实现此目的，将 postgresql.enabled 参数设置为 false，并使用 externalDatabase.* 参数指定外部数据库的凭据。示例如下：

text
postgresql.enabled=false
externalDatabase.host=myexternalhost
externalDatabase.user=myuser
externalDatabase.password=mypassword
externalDatabase.database=mydatabase
externalDatabase.port=5432

更新凭证

Bitnami Concourse chart 在升级时，会重用之前由 chart 渲染的密钥或 web.existingSecret 中指定的密钥。要更新凭证，请使用以下方法之一：

• 运行 helm upgrade 并在 secrets.localUsers 中指定新的 "user:password"
• 运行 helm upgrade 并在 web.existingSecret 中指定新的密钥

配置 Ingress

此 chart 支持 Ingress 资源。如果集群上安装了 Ingress 控制器（如 https://github.com/bitnami/charts/tree/main/bitnami/nginx-ingress-controller 或 https://github.com/bitnami/charts/tree/main/bitnami/contour%EF%BC%89%EF%BC%8C%E6%82%A8%E5%8F%AF%E4%BB%A5%E5%88%A9%E7%94%A8 Ingress 控制器来提供应用服务。要启用 Ingress 集成，将 ingress.enabled 设置为 true。

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

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

注意：对于 ingress.extraHosts 参数中指定的每个主机，需要设置名称、路径以及 Ingress 控制器应了解的任何注解。并非所有注解都受所有 Ingress 控制器支持，但 https://github.com/kubernetes/ingress-nginx/blob/master/docs/user-guide/nginx-configuration/annotations.md 列出了许多流行 Ingress 控制器支持的注解。

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

了解更多关于 Ingress 控制器的信息。

配置用于 Ingress 的 TLS Secrets

此 chart 便于创建用于 Ingress 控制器的 TLS 密钥（尽管这不是必需的）。有几种常见用例：

• 基于 chart 参数生成证书密钥。
• 启用外部生成的证书。
• 通过外部服务（如 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
• 在 chart 内创建自签名证书（如果支持）。

在前两种情况下，需要证书和密钥。文件应为 .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 插件来自动管理和颁发 TLS 证书，在 *.ingress.annotations 中添加 相应的注解。
• 如果使用 Helm 创建自签名证书，将 *.ingress.tls 和 *.ingress.selfSigned 都设置为 true。

配置额外环境变量

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

yaml
extraEnvVars:
  - name: LOG_LEVEL
    value: DEBUG

或者，使用 ConfigMap 或 Secret 存储环境变量。为此，使用 extraEnvVarsCM 或 extraEnvVarsSecret 值。

配置 Sidecar 和 Init 容器

如果在 Concourse 所在的同一 Pod 中需要额外的容器（如额外的指标或日志导出器），可使用 sidecars 参数定义它们。

yaml
sidecars:
- name: your-image-name
  image: your-image
  imagePullPolicy: Always
  ports:
  - name: portname
    containerPort: 1234

如果这些 sidecar 导出额外端口，可使用 service.extraPorts 参数（如果可用）添加额外的端口定义，如下例所示：

yaml
service:
  extraPorts:
  - name: extraPort
    port: 11311
    targetPort: 11311

注意：此 Helm chart 已包含用于 Prometheus 导出器的 sidecar 容器（如适用）。这些可通过在部署时添加 --enable-metrics=true 参数激活。因此，sidecars 参数应仅用于任何额外的 sidecar 容器。

如果在同一 Pod 中需要额外的 init 容器，可使用 initContainers 参数定义它们。示例如下：

yaml
initContainers:
  - name: your-image-name
    image: your-image
    imagePullPolicy: Always
    ports:
      - name: portname
        containerPort: 1234

了解更多关于 sidecar 容器 和 init 容器 的信息。

设置 Pod 亲和性

此 chart 允许使用 affinity 参数设置自定义亲和性。有关 Pod 亲和性的更多信息，请参阅 Kubernetes 文档。

作为替代方案，可使用 https://github.com/bitnami/charts/tree/main/bitnami/common#affinities chart 中提供的 Pod 亲和性、Pod 反亲和性和节点亲和性的预设配置之一。为此，设置 podAffinityPreset、podAntiAffinityPreset 或 nodeAffinityPreset 参数。

备份和恢复

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

持久化

https://github.com/bitnami/containers/tree/main/bitnami/concourse 镜像将 concourse 数据和配置存储在容器的 /bitnami 路径下。持久卷声明（Persistent Volume Claims）用于跨部署保留数据。

参数

全局参数

通用参数

Concourse 通用参数