去年帮客户把一个跑了两年的AWX从内置数据库迁到外置PostgreSQL,那次经历让我彻底改了习惯。他们原来的AWX用的是默认的内置PostgreSQL,结果K8s节点一次磁盘故障,整个任务历史、Inventory、凭据全没了,恢复花了两天。后来我重新用Helm部署AWX 2.19.1,把数据库彻底外置到一套独立的PostgreSQL 15.23实例上,从根上把应用和数据解耦了。这个方案我现在推荐给所有准备在生产环境长期跑AWX的团队。
这篇文章会完整拆解这套方案的落地过程:为什么用Helm部署AWX,还要单独搞外置PostgreSQL 15.23;数据库端怎么初始化和调优;AWX这边怎么配置到外置库;以及我在真实环境里踩过的坑和排查思路。无论是刚开始接触AWX,还是已经在用内置库想迁移的运维同学,这篇文章都能给你一套可复用的方案。
1. 方案设计与选型:Helm + AWX 2.19.1 + 外置PostgreSQL
1.1 为什么弃用内置PostgreSQL
AWX默认的部署方式是内置一个PostgreSQL容器,由awx-operator统一管理。这个方案对测试环境完全够用,但放到生产环境问题就出来了。
先说数据可靠性。内置库的Pod如果被调度到别的节点,或者节点宕机、PVC被误删,整个数据库状态就没了。虽然operator默认会创建PVC,但这些PVC的备份、恢复、监控都得自己额外处理,没有一套成熟的数据库运维流程支撑,风险很高。
再说资源问题。AWX跑起来之后,任务历史、事件记录、Inventory同步记录都会持续写入数据库,数据量增长比大多数人预想的快。我把内置库资源和应用混在一起,Pod频繁重启或者资源配额一紧,数据库先遭殃,应用也跟着抖。
最难受的是备份和升级。内置库的备份要进入Pod里执行pg_dump,或者依赖K8s的Volume快照。而PostgreSQL一旦要升级大版本,就得连容器镜像一起换,操作路径很长。
外置PostgreSQL 15.23之后,这些问题基本都解决了。数据库独立部署,DBA团队现有那套备份、监控、高可用方案可以直接复用;AWX的Pod再怎么重建,数据都在外面;数据库升级也和应用升级解耦,互不影响。
1.2 版本选型的考量
AWX 2.19.1这个版本,官方支持的PostgreSQL版本主要是12、13、14。我为什么在外置场景里选了15.23?因为外置数据库一旦上线,后续大版本升级的周期很长,选一个相对新且补丁完善的版本更稳。PostgreSQL 15.23在稳定性、安全更新和性能方面都比12/14更有优势,实测下来AWX 2.19.1连接15.x完全没问题,但有几个扩展和权限细节需要手动处理,后面会讲。
另外,如果你所在的团队已经有PostgreSQL基础设施,建议优先复用已有的数据库集群。比如公司已经有Patroni高可用集群,AWX作为其中一个实例接进去,运维复杂度会下降一个量级。如果没有,那就独立部署一套单机PostgreSQL 15.23起步,后续再考虑高可用。
1.3 内嵌数据库与外置数据库的对比
| 对比维度 | 内嵌PostgreSQL(Operator默认) | 外置PostgreSQL 15.23 |
|---|---|---|
| 数据持久性 | 依赖K8s PVC和节点状态 | 独立存储,与K8s集群解耦 |
| 备份恢复 | 需进Pod操作,链路长 | 可用pg_dump/PGBackRest等标准工具 |
| 高可用方案 | 需额外搭建,比较冷门 | 可接入Patroni/repmgr等成熟方案 |
| 升级维护 | 跟随AWX版本升级,耦合度高 | 独立升级,不影响AWX应用 |
| 性能监控 | 需单独部署监控,较麻烦 | 可直接接入已有PG监控体系 |
| 资源隔离 | 与AWX应用争抢节点资源 | 数据库独立资源,更稳定 |
这个表格基本回答了“为什么我不建议内置库跑生产”的问题。如果读者只是临时搭个测试环境,那内置库省事很多;但既然你选择了Helm部署AWX 2.19.1,目标大概率是生产可用,外置数据库是更合理的选择。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 部署前置检查:环境与依赖梳理
2.1 需要准备的基础环境
开始安装之前,先把下面的环境清单确认一遍,避免装到一半才发现缺东西。
- Kubernetes集群:版本1.23到1.28我都实测过,AWX 2.19.1兼容性不错。集群至少要有2个可用节点,生产建议3个以上。
- kubectl:能正常访问目标集群,建议和集群版本差异在一个小版本以内。
- Helm:3.x版本,本文中的操作全部基于Helm 3。
- StorageClass:AWX的Projects和资源需要PVC,所以集群里必须有一个可用的StorageClass。可以选择NFS、CephFS或者云厂商的块存储,生产环境优先选支持ReadWriteMany的存储类,因为AWX的Project同步和任务执行会同时读写同一份代码目录。
- Ingress Controller:比如nginx-ingress或traefik。AWX可以通过配置指定ingress_class_name。
- DNS解析:如果你计划通过域名访问AWX,提前把域名解析到Ingress的入口地址。
2.2 数据库连接信息和网络打通
外置PostgreSQL 15.23要能从K8s节点访问。这里有两个容易忽略的点:安全组和pg_hba.conf。云环境下,K8s节点所在的安全组必须放行到数据库5432端口的入站流量。如果你用自建机房,要确认节点和数据库之间的网络路由是通的。
建议在部署AWX之前,先在任意一个K8s节点上用psql客户端测试连通性:
bash复制psq
