Activepieces 如何用 Helm Chart 在 Kubernetes 上部署并接入外部 PostgreSQL 与 Redis【免费下载链接】activepiecesAI Agents MCPs AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows AI Agents • MCPs for AI Agents项目地址: https://gitcode.com/GitHub_Trending/ac/activepieces在把 Activepieces 部署到 Kubernetes 时官方 Helm chart 默认可以不带任何数据库也可以启用内置的 Bitnami PostgreSQL / Redis 子 chart生产场景下更常见的需求是改用你自己已有的外部 PostgreSQL 与 Redis 实例。本文基于仓库内 Helm 安装文档 和 chart 的 values.yaml给出部署 chart 接入外部数据库这条完整路径并指出文档示例与 chart 实际模板之间的一处需要留意的差异。前提条件docs/install/options/helm.mdx 列出的前提Kubernetes 集群v1.19已安装 Helm 3.xkubectl 已配置好对目标集群的访问chart 位于仓库的 deploy/activepieces-helm版本信息见 Chart.yamlchart 版本0.3.0appVersion: 0.71.2。外部 PostgreSQL 和 Redis 实例需由你自行提供chart 只负责把连接信息注入到 Activepieces 容器。接入外部 PostgreSQL 与 Redis1. 关闭内置的 Bitnami 子 chart在 values.yaml 中postgresql和redis两个段落的含义是是否部署内置 Bitnami 子 chart默认都是enabled: false。Chart.yaml 中这两个依赖都带condition只有enabled: true时才会部署对应子 chartpostgresql: enabled: false # 关闭 Bitnami PostgreSQL 子 chart redis: enabled: false # 关闭 Bitnami Redis 子 chart如果你的 values 中把这两项保持false默认值集群里就不会多出一套数据库。2. 文档给出的外部库配置写法docs/install/options/helm.mdx 的 Using External PostgreSQL and Redis 一节给出的示例是直接写在 values 里的postgresql: enabled: false # Disable Bitnami PostgreSQL subchart host: your-postgres-host.example.com port: 5432 useSSL: true # Enable SSL if required auth: database: activepieces username: postgres password: your-password # Or use external secret reference: # externalSecret: # name: postgresql-credentials # key: password外部 Redis 写法类似redis: enabled: false # Disable Bitnami Redis subchart host: your-redis-host.example.com port: 6379 useSSL: false # Enable SSL if required auth: enabled: true password: your-password # Or use external secret reference: # externalSecret: # name: redis-credentials # key: password文档同时提供了 connection URL 的替代写法postgresql: enabled: false url: postgresql://user:passwordhost:5432/database?sslmoderequireredis: enabled: false url: redis://:passwordhost:6379/0以上代码块中的 host、端口、库名、用户名和密码都是文档示例占位值替换为你自己的实例信息即可。3. 需要留意的差异chart 模板并不引用这些外部值按文档上述写法配置前建议先确认 chart 的渲染行为仓库中 chart 的模板文件deployment.yaml、secret.yaml 等没有引用.Values.postgresql/.Values.redis的host、url、auth等字段——它们只通过condition决定是否部署 Bitnami 子 chart。也就是说enabled: false生效但示例里的host/url等值不会被模板消费。chart 实际把数据库连接注入容器的方式是 values.yaml 注释中说明的环境变量 Kubernetes Secret路线activepiecesEnvVariables是一张 secret 名 → 要注入的环境变量名列表 的映射模板会把它渲染成valueFrom.secretKeyRef注入容器见 deployment.yaml外部 PostgreSQL 对应activepieces-db-secrets默认注入以下变量名AP_POSTGRES_DATABASE、AP_POSTGRES_HOST、AP_POSTGRES_PORT、AP_POSTGRES_PASSWORD、AP_POSTGRES_USERNAME、AP_POSTGRES_USE_SSL、AP_POSTGRES_POOL_SIZE、AP_POSTGRES_SSL_CA外部 Redis 对应activepieces-redis-secrets默认注入AP_REDIS_TYPE、AP_REDIS_HOST、AP_REDIS_PORT、AP_REDIS_PASSWORD、AP_REDIS_USE_SSL、AP_REDIS_USER。values.yaml 的注释原文要求Each var name must exist as a key in the corresponding secret.即你需要在集群中自己创建名为activepieces-db-secrets和activepieces-redis-secrets的 Secret且 Secret 的 key 必须与上表变量名一致例如 key 为AP_POSTGRES_HOST的值指向你的外部 PostgreSQL 地址。values.yaml 注释中另提到可以用deploy/scripts/apply-secrets.sh --secret-name name来填充这些 Secret但该脚本在当前仓库中不存在请以手动创建 Secret 的方式理解这一步。因此接入外部 PostgreSQL 与 Redis 的可执行主路径是保持postgresql.enabled: false、redis.enabled: false创建 Secretactivepieces-db-secretskey 覆盖你实际需要的AP_POSTGRES_*至少AP_POSTGRES_HOST、AP_POSTGRES_PORT、AP_POSTGRES_DATABASE、AP_POSTGRES_USERNAME、AP_POSTGRES_PASSWORD创建 Secretactivepieces-redis-secretskey 覆盖你实际需要的AP_REDIS_*至少AP_REDIS_HOST、AP_REDIS_PORT、AP_REDIS_PASSWORD确认activepiecesEnvVariables中这两个映射保留默认列表不做删改。文档示例第 2 步的host/url/externalSecret写法与本节机制属于同一文档集内给出的两种表述按文档示例与仓库模板现状对待先按主路径验证再判断你所使用的 chart 版本是否支持示例写法。编写 my-values.yaml文档 Quick Start 第 3 步创建你自己的my-values.yaml可以以仓库里的 values.yaml 作为参考。chart 对必需值有合理默认值、可选项留空但生产环境应自定义核心值。如果你后续要激活 license key文档要求写入activepiecesConfig: AP_EDITION: ee AP_EXECUTION_MODE: SANDBOX_CODE_ONLY文档对此给出明确警告activepiecesConfig把明文值直接写进 pod而activepiecesEnvVariables渲染在它之后、从你创建的 Secret 取值同名变量以 Secret 为准。chart 默认把AP_EDITION和AP_EXECUTION_MODE列在activepieces-config-secrets的注入名单下所以这两个变量只能在一处设置要么从activepiecesConfig移除并改放进那个 Secret要么反之不要两边都写。另外AP_EDITIONee搭配默认执行模式会在启动时被拒绝应用无法启动——这就是文档示例把两者成对写出的原因。安装按文档 Quick Start进入 chart 所在目录后执行# 更新 chart 依赖Bitnami 子 chart 与 secret generator 的 Chart.lock 依赖 helm dependency update # 安装 helm install activepieces deploy/activepieces-helm -f my-values.yaml安装成功后升级与卸载也有对应命令# 升级 helm upgrade activepieces deploy/activepieces-helm -f my-values.yaml kubectl rollout status deployment/activepieces # 卸载 helm uninstall activepieces # 清理持久卷可选 kubectl delete pvc -l app.kubernetes.io/instanceactivepieces验证部署文档给出的验证命令# 检查 deployment 状态 kubectl get pods kubectl get services辅助命令来自文档 Troubleshooting 一节# 查看日志 kubectl logs deployment/activepieces -f # 本地端口转发测试 kubectl port-forward svc/activepieces 4200:80 --namespace default # 查看全部资源 kubectl get all --namespace defaultPod 的探针配置在 values.yaml 中liveness 探测/api/v1/healthreadiness 探测/v1/healthPod Ready 与否可以结合kubectl get pods的状态直接判断。常见问题与边界文档 Troubleshooting 列出的排查项Pod wont start用kubectl logs deployment/activepieces查日志Database connection核对 PostgreSQL 凭证与连通性——对应本文场景先确认activepieces-db-secrets中各AP_POSTGRES_*key 的取值与外部实例一致、网络可达Frontend URL确保frontendUrl可被外部访问Webhooks not working检查 ingress 配置与 DNS 解析。文档 Production Checklist 中与本场景直接相关的两项frontendUrl设置成实际域名、PostgreSQL 与 Redis 使用强密码或使用自动生成。最后重申本文开头的差异点外部库连接信息以Secret key 与环境变量名一一对应这一机制为准如果kubectl logs显示容器未收到预期的AP_POSTGRES_*变量优先检查对应 Secret 的 key 是否拼写正确、是否恰好与activepiecesEnvVariables列表中的名字一致。【免费下载链接】activepiecesAI Agents MCPs AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows AI Agents • MCPs for AI Agents项目地址: https://gitcode.com/GitHub_Trending/ac/activepieces创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考