‘搭建真实AWX服务器’含义、操作方法及相关疑问解析

先厘清关键概念 #

注意：这里的AWX（曾用名Tower）是Ansible官方的开源自动化管理平台，和亚马逊AWS的任何服务完全无关——这是搜索引擎混淆的核心，搜索时一定要加「Ansible」前缀，避免跳错结果。

“搭建AWX服务器”到底要做什么？ #

这个指令就是让你部署一套能正常运行的Ansible AWX实例，不是仅安装单个组件就行。常见的部署方式分几种：

• 测试/开发场景：用官方Docker Compose脚本一键部署
• 生产场景：通过Kubernetes Operator进行部署
• 旧版本可选：基于RPM包的传统服务器部署

部署完成后需要确保AWX服务正常启动，API接口可访问，这是后续生成CLI文档的基础。

为啥它是安装Sphinx的前置条件？ #

在生成AWX CLI文档的流程中，Sphinx需要连接到运行中的AWX服务器获取动态数据：

• CLI命令的实时元数据（比如可用子命令、参数说明）
• CLI与AWX API的映射逻辑
• 版本兼容性信息

没有运行中的AWX实例，Sphinx无法获取这些内容，也就生成不了完整、准确的CLI文档。

针对文档生成的轻量部署步骤 #

如果只是为了生成文档，无需搭建生产级环境，用快速方式即可：

1. 提前装好Docker和Docker Compose
2. 拉取AWX官方开发部署代码后，运行命令：make docker-compose
3. 等待部署完成，确认http://localhost:80能正常访问AWX界面就算完成

内容的提问来源于stack exchange，提问作者Jeff Silverman