octopusdeploy/octopusdeploy-helm

Octopus Deploy Helm Chart

概述

此Helm Chart使用Helm包管理器将https://octopus.com安装到Kubernetes集群中。Octopus Deploy是一个用于自动化部署和发布管理的平台，支持复杂应用的持续交付流程。

使用方法

快速开始

bash
helm install octopus-deploy oci://registry-1.docker.io/octopusdeploy/octopusdeploy-helm --values values.yaml

前提条件

数据库

https://octopus.com/docs/installation/sql-server-database。

可通过Helm将SQL Server安装到Kubernetes集群，也可选择其他安装方式或云提供商托管的SQL服务。

需准备数据库连接字符串，格式示例：

Server=tcp:octopus-deploy.database.windows.net,1433;Initial Catalog=OctopusDeploy;Persist Security Info=False;User ID=octopus-deploy;Password={your_password};Encrypt=True;Connection Timeout=30;

主密钥

https://octopus.com/docs/security/data-encryption。

必须生成主密钥并安全存储。生成命令：

bash
openssl rand -base64 16

配置值（Values）

安装此Chart的最小配置示例（values.yaml）：

yaml
octopus:
  acceptEula: "Y" # 必须接受Octopus最终用户许可协议 https://octopus.com/legal/customer-agreement
  masterKey: <生成的主密钥 - base64格式> 
  databaseConnectionString: <SQL Server数据库连接字符串> 
  licenseKeyBase64: <base64编码的许可证密钥>   
  username: <管理员用户名>
  password: <管理员密码> 
  packageRepositoryVolume:
    size: 1Gi 
    storageClassName: "azure-file"
    storageAccessMode: ReadWriteOnce
  # 用于持久化部署制品的卷：https://octopus.com/docs/projects/deployment-process/artifacts
  artifactVolume:
    size: 1Gi 
    storageClassName: "azure-file"
    storageAccessMode: ReadWriteOnce
 # 用于任务日志的卷：https://octopus.com/docs/support/get-the-raw-output-from-a-task
  taskLogVolume: 
    size: 1Gi 
    storageClassName: "azure-file"
    storageAccessMode: ReadWriteOnce

Ingress配置

通常需要允许集群外部的两种流量：

• Octopus Web门户的HTTP请求
• Polling Tentacle通信

Web门户

常见方案是使用https://kubernetes.io/docs/concepts/services-networking/ingress/，需确保集群中运行有https://kubernetes.io/docs/concepts/services-networking/ingress-controllers/。

使用https://kubernetes.github.io/ingress-nginx/配置Web门户Ingress的示例：

yaml
octopus:
  ingress:
    enabled: true
    annotations: 
      kubernetes.io/ingress.class: nginx
    path: /
    hosts:
      - octopus.example.com 

Polling Tentacles

Polling Tentacles比Web流量复杂，因为https://octopus.com/docs/administration/high-availability/maintain/polling-tentacles-with-ha。

因此，此Helm Chart不为Polling Tentacles创建Ingress资源。

若Chart配置为单节点（replicaCount: 1），Polling Tentacle端口与Octopus服务器共享同一服务；若副本数大于1，将为每个节点创建Kubernetes服务。注册Polling Tentacles时，需配置其轮询每个节点。

持久卷

此Chart需要持久卷存储以下内容：

• https://octopus.com/docs/packaging-applications/package-repositories/built-in-repository
• https://octopus.com/docs/projects/deployment-process/artifacts
• https://octopus.com/docs/support/get-the-raw-output-from-a-task

这些卷在Octopus节点间共享。

可为每个卷指定可选的持久卷声明类名。当Chart配置为多节点（replicaCount > 0）时，存储类必须支持ReadWriteMany访问模式；单节点集群可使用ReadWriteOnce或ReadWriteMany。

• 短横线（-）表示使用空字符串作为storageClass属性，意味着不会自动配置持久卷，需在Chart外部手动创建
• https://helm.sh/docs/chart_template_guide/control_structures/#ifelse表示不定义storageClass属性，将使用默认值（大多数云提供商支持ReadWriteOnce卷的自动配置）

持久卷配置示例：

yaml
octopus:
  packageRepositoryVolume:
    size: 20Gi 
    storageClassName: "azure-file"
    storageAccessMode: ReadWriteOnce
  artifactVolume:
    size: 1Gi 
    storageClassName: "azure-file"
    storageAccessMode: ReadWriteOnce
  taskLogVolume: 
    size: 1Gi 
    storageClassName: "azure-file"
    storageAccessMode: ReadWriteOnce