3.1.0: awx 安装

0. 什么是awx？

AWX是redhat，在ansible的基础上提供的一个开源web工程。 它提供了web界面、REST API和任务引擎。 同时，redhat还有一个收费项目（awx的上游项目）ANSIBLE TOWER，是awx的商业版本。

1. 安装awx

step 0. 系统环境和准备工作

• centos7 64位
  
• python 2.7.5

yum install wget vim -y

step 1. 准备工作

安装 Ansible（Version 2.4+）

yum install ansible -y

centos7 里面的ansible版本是大于2.4的，此处安装的是2.5.5

安装 Docker
可以参照这个安装教程：docker installation

安装 docker-py Python module

wget https://bootstrap.pypa.io/get-pip.py
python get-pip.py
pip install docker

# 若需要使用docker-compose则需要安装
pip install docker-compose

安装 GNU Make

yum install make -y

安装 Git Requires Version 1.8.4+ 参照这个安装教程: git installation from source

# 安装docker之后，安装docker-compose
wget https://github.com/docker/compose/releases/download/1.17.1/docker-compose-Linux-x86_64
mv docker-compose-Linux-x86_64 /usr/bin/docker-compose
chmod 755 /usr/bin/docker-compose

安装 Node 6.x LTS version and NPM 3.x LTS

wget https://nodejs.org/dist/v8.11.3/node-v8.11.3-linux-x64.tar.xz
tar Jxvf node-v8.11.3-linux-x64.tar.xz
mv node-v8.11.3-linux-x64/ /usr/local/node

echo "export PATH=$PATH:/usr/local/node/bin" /etc/profile.d/node.sh
source /etc/profile

npm -v
5.6.0

node -v
v8.11.3

step 2. clone repo

git clone https://github.com/ansible/awx.git

step 3. install awx base on docker-compose

默认情况下 installer/inventory 文件会把awx安装在本地，如果需要安装到其他机器，可以修改 installer/inventory
里面还有其他变量可以修改

• 常规配置
  • host_port, 默认访问端口80
  • host_port_ssl，ssl端口，默认是端口443，只有在ssl_certificate配置的时候才生效
  • ssl_certificate，指定包含crt和key的文件
  • docker_compose_dir, 设置docker-compose.yml储存的目录，默认是/tmp/awxcompose
• PostgreSQL
  • postgres_data_dir，pg数据库容器的数据挂载目录，默认是/tmp/pgdocker
  • pg_hostname，如果想用外部的pg，设定外部pg的hostname，这样安装awx的时候，awx不会创建pg镜像
• docker-registry
  • docker_registry，镜像仓库地址，例如127.0.0.1:5000
  • docker_registry_repository，镜像仓库命名空间，例如awx
  • docker_registry_username，镜像仓库用户名，在运行install的时候，传入docker_registry_password来认证

cd awx/installer

# 安装awx
ansible-playbook -i inventory install.yml
# 如果配置了docker_registry_user
# ansible-playbook -i inventory -e docker_registry_password=password install.yml

docker ps
CONTAINER ID        IMAGE                        COMMAND                  CREATED             STATUS              PORTS                                                 NAMES
83b789355ce9        ansible/awx_task:latest      "/tini -- /bin/sh -c…"   2 minutes ago       Up 2 minutes        8052/tcp                                              awx_task
04d8601b2180        ansible/awx_web:latest       "/tini -- /bin/sh -c…"   16 minutes ago      Up 16 minutes       0.0.0.0:80->8052/tcp                                  awx_web
11ca113fbb06        memcached:alpine             "docker-entrypoint.s…"   24 minutes ago      Up 24 minutes       11211/tcp                                             memcached
f8550eeff8c2        ansible/awx_rabbitmq:3.7.4   "docker-entrypoint.s…"   25 minutes ago      Up 25 minutes       4369/tcp, 5671-5672/tcp, 15671-15672/tcp, 25672/tcp   rabbitmq
0874fb6e43e5        postgres:9.6                 "docker-entrypoint.s…"   About an hour ago   Up About an hour    5432/tcp                                              postgres

如果install的时候卡住就手动下载一下postgres、rabbitmq、memcached、awx_task、awx_web这些镜像就不会卡住了

默认情况，inventory中是安装awx到localhost中，如果需要修改，可以参照awx 官方安装教程
inventory中还有其他的变量可以修改，例如，是否更换默认的postgres为其他的数据库，以及搭建awx在什么平台上（k8s、openshift、docker原生、docker compose）

☆☆重点关注☆☆

• 如果inventory中的dockerhub_base有配置（默认是有配置），则会执行image_build，编译镜像awx_web
• 如果inventory中的docker_registry有配置，但dockerhub_base没配置，则会执行image_push，push镜像到自己的镜像仓库中
• 如果inventory中的openshift_host有配置，或者kubernetes_context有配置，则会执行kubernetes
• 如果inventory中的openshift_host和kubernetes_context都没有配置，则会执行local_docker

step 4. 访问awx

可以通过http://localhost访问，默认账号和密码是awx/password

step 5. maintenance

inventory中默认的docker-compose配置docker_compose_dir=/tmp/awxcompose

cd /tmp/awxcompose

# 停止awx
docker-compose stop

# 更新awx
docker-compose pull && docker-compose up --force-recreate