Linux系统下安装和配置Ansible-AWX 图形化运维管理平台-LINUX-PHP中文网

awx官方已弃用裸机安装，唯一支持的生产部署方式是基于kubernetes的awx-operator；必须禁用selinux和防火墙，使用helm install时需指定-n awx --create-namespace，并确保pv/pvc正确绑定。

linux系统下安装和配置ansible-awx 图形化运维管理平台

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 一个都不会起。

Obsidian (Linux)

操作 Obsidian 库（纯 Markdown 笔记），并通过 notesmd-cli 实现自动化。

下载

正确命令是：

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 <pvc-name> -n awx</pvc-name> 看 Events 里的具体原因。

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