Linux安装配置Ansible-AWX运维平台

本文详解了在当前环境下正确部署Ansible-AWX运维平台的唯一可靠路径：彻底摒弃早已被官方弃用的Linux裸机安装方式，转而采用基于Kubernetes的awx-operator方案；强调必须关闭SELinux和防火墙以避免权限与网络拦截问题，严格使用helm install配合-n awx --create-namespace参数确保Operator正确运行于独立命名空间，并精准配置PV/PVC实现PostgreSQL持久化存储——任何环节的疏忽（如命名空间遗漏、StorageClass不匹配或SELinux未禁用）都将导致Pod崩溃、服务不可用或UI无法访问，堪称一套对Kubernetes基础能力要求极高的“原生云原生”实践指南。

AWX 不再支持直接在 Linux 裸机上安装

官方早在 2021 年就正式弃用 awx-setup.sh 这类基于裸机（bare-metal）的安装方式。你现在看到的任何“Linux 下一键安装 AWX”的教程，基本都已过时或不可靠——它要么依赖早已停止维护的旧版依赖（如 Python 2.7、Django 2.x），要么绕过 Operator 强行 patch 配置，最终大概率卡在 awx-manage migrate 失败、PostgreSQL 连接拒绝、或 Web UI 502 错误上。

当前唯一被官方文档明确支持、持续更新、且具备生产可用性的部署路径是：基于 Kubernetes 的 awx-operator。哪怕你只是在单机上跑，也应使用 minikube 或 k3s，而不是试图在 CentOS 7 或 Ubuntu 22.04 上用 systemd 管理 AWX 容器。

必须提前关闭 SELinux 和防火墙

AWX 的 Operator 和 Pod 依赖大量动态挂载、端口映射和跨命名空间通信。SELinux 的默认策略会拦截 PostgreSQL 的 socket 访问、阻止 Nginx 向 awx-task 容器发起健康检查、甚至让 awx-web 无法读取加密密钥文件。不关 SELinux，kubectl get pods -n awx 里大概率出现 CrashLoopBackOff 或 Init:Error。

操作步骤如下：

• 临时禁用：sudo setenforce 0
• 永久禁用：编辑 /etc/selinux/config，把 SELINUX=enforcing 改为 SELINUX=disabled
• 防火墙同样要停：sudo systemctl stop firewalld && sudo systemctl disable firewalld（Ubuntu 用户对应 ufw disable）

别信“配置 SELinux 策略就能解决”的说法——AWX 的容器间调用链太深，手动打补丁成本远高于直接关掉。

用 Helm 部署 awx-operator 时必须指定 namespace

helm install 命令漏掉 -n awx --create-namespace 是最常导致后续失败的操作。Operator 默认不会自动创建命名空间，而 AWX 自定义资源（Awx CR）又强制要求运行在特定命名空间下。如果你只执行：

helm install ansible-awx-operator awx-operator/awx-operator

那 Operator 会被装进 default 命名空间，但当你 apply awx.yaml 时，Operator 根本收不到事件，awx-web 和 awx-task Pod 一个都不会起。

正确命令是：

helm install ansible-awx-operator awx-operator/awx-operator -n awx --create-namespace

验证是否生效：kubectl get deployment -n awx 应该看到 ansible-awx-operator；kubectl get crd | grep awx 应返回 awxs.awx.ansible.com。

PV/PVC 必须匹配 storageClassName 且绑定成功

AWX 的 PostgreSQL Pod 强依赖持久卷（PV）存储数据库。如果你跳过 PV 创建，或用了动态 Provisioner（如 rook-ceph）但没配 StorageClass，PostgreSQL 容器会卡在 Pending 状态，日志里反复报 no persistent volumes available for this claim。

对于测试环境，推荐用本地路径 + hostPath 方式快速验证：

• 先创建 local-storage StorageClass（注意 volumeBindingMode: WaitForFirstConsumer）
• 再写一个 awx-postgres-pv.yaml，spec.hostPath.path 指向一个真实存在的目录（如 /opt/awx-pgdata），权限设为 700
• 最后创建 PVC，spec.storageClassName 必须和 PV 中定义的一致，且 status.phase 显示为 Bound

检查绑定状态：kubectl get pvc -n awx。如果显示 Pending，别急着 deploy AWX CR，先查 kubectl describe pvc -n awx 看 Events 里的具体原因。

AWX 的核心复杂点不在 YAML 写法，而在于它是一套“Kubernetes 原生应用”——所有组件（Web、Task、Redis、PostgreSQL）都是独立 Pod，彼此通过 Service 和 Secret 协同。任何一个环节的网络、存储或 RBAC 配置偏差，都会导致整个 UI 打不开或登录后空白。动手前务必确认 Operator 已就位、Namespace 已隔离、PV 已绑定，三者缺一不可。

以上就是本文的全部内容了，是否有顺利帮助你解决问题？若是能给你带来学习上的帮助，请大家多多支持golang学习网！更多关于文章的相关知识，也可关注golang学习网公众号。