AWXインストール手順
昨日の結果をもとに無事AWXのインストールが出来たのその手順を記載します。
実装環境
Ubuntu20LTS上に構築したKVM仮想環境になります。
マシンスペック
２コア
４Gメモリ
OS：CentOS Stream release 8
カーネルバージョン：4.18.0-338.el8.x86_64
Dockerバージョン： Server Version: 20.10.8
docker-compose version 1.27.3, build 4092ae5d
Ansible バージョン：core 2.11.5
Ansible AWXバージョン：19.3.0
以上の環境でOSインストールは最小インストールにグループパッケージのdevelopmentをKVMインストール時にキックスタータで事前にインストールしてあります。
以降の作業は、sudo実行権限を持ったユーザーで実施しています。
コンテナ環境の準備
まず初めにDockerをインストールします。
インストール方法は公式リポジトリを使ってインストールします。
手順は公式ドキュメントの通りです。
https://docs.docker.com/engine/install/centos/
sudo yum install -y yum-utils
sudo yum-config-manager --disable docker-ce-nightly \
--add-repo \
https://download.docker.com/linux/centos/docker-ce.repoリポジトリ登録ができたらdockerをインストール
sudo yum install docker-ce docker-ce-cli containerd.ioインストールが完了したらDockerソケットを起動します。
sudo systemctl enable --now docker.socket
sudo systemctl status docker.socketdockerの作動確認
sudo docker info最初に書いたば＾ジョンが確認できます。
Client:
Context: default
Debug Mode: false
Plugins:
app: Docker App (Docker Inc., v0.9.1-beta3)
buildx: Build with BuildKit (Docker Inc., v0.6.1-docker)
scan: Docker Scan (Docker Inc., v0.8.0)
Server:
Containers: 0
Running: 0
Paused: 0
Stopped: 0
Images: 0
Server Version: 20.10.8次にDocker-composeをインストールします。
こちらも公式手順の通りです。
sudo curl -L "https://github.com/docker/compose/releases/download/1.27.3/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-composeインストールしたファイルにシンボリックリンクを張ります。
sudo chmod +x /usr/local/bin/docker-compose
sudo ln -s /usr/local/bin/docker-compose /usr/bin/docker-composeバージョン確認
docker-compose versionバージョンが確認できます。
docker-compose version 1.29.2, build unknown
docker-py version: 5.0.2
CPython version: 3.9.6
OpenSSL version: OpenSSL 1.1.1k FIPS 25 Mar 2021sudo実行権限を持つAWXインストールユーザーをdockerグループに追加する。
sudo gpasswd -a daath docker
PIP Ansibleインストール
次にAnsibleをインストールします。RHEL8系では専用のリポジトリをインストールしてAnsibleインストールする方法もありますが、今回は、PIPでのインストールにします。
CentOS Stream8ではデフォルトでPythonが入っていませんので今回は3.9をインストールします。
sudo dnf module install python39 インストールできたらバージョン確認コマンドを実行して使えるかを確認します。
python3 -V
### 3.9がインストールされています。
Python 3.9.6PIPの方も確認んします。
pip3 -V
### 以下のようになります。
pip 20.2.4 from /usr/lib/python3.9/site-packages/pip (python 3.9)PIP3でAnsibleインストール、このとき合わせてSElinuxの制御パッケージもインストールしておきます。これがないとAWXビルド途中でエラーとなります。
sudo pip3 install -U pip
sudo pip3 install ansible selinuxこのPIPインストールは、sudoで実行してください。AWXビルド時にAnsible実行とdockerが連携するためroot権限実行になるためsudo（rootユーザー）でインストールしておかないとエラーになります。
ではなぜrootで作業しないのかというとPIPインストールのansibleは、venv環境を作らない場合、rootでの実行が不可能な設計になっているようです。
これはOS自体のパッケージ管理とPIPのパッケージ管理が別でそれらが機能衝突しないようPIP側のパッケージインストールがrootで出来なくなっているものと考えられます。
それではインストールします。
sudo pip3 install ansible selinux インストールしたAnsibleのバージョンを確認
ansible --versionansible [core 2.11.5]
config file = None
configured module search path = ['/home/daath/.ansible/plugins/modules', '/usr/share/ansible/plugins/modules']
ansible python module location = /usr/local/lib/python3.9/site-packages/ansible
ansible collection location = /home/daath/.ansible/collections:/usr/share/ansible/collections
executable location = /usr/local/bin/ansible
python version = 3.9.6 (default, Aug 25 2021, 16:22:38) [GCC 8.5.0 20210514 (Red Hat 8.5.0-3)]
jinja version = 3.0.1
libyaml = TrueAWXインストール
下準備が完了したのでAWXをインストールします。
AWXリポジトリをクローンで取得
git clone -b 19.3.0 https://github.com/ansible/awx.git2021/09/19時点の最新バージョンになります。
ブランチバージョンは、Gitサイトを確認してください
https://github.com/ansible/awx/releases?
クローンしたディレクトリ内へ移動
ls -l
cd ~/awx/補足：AWX各種設定を変更する場合は以下のファイルを使用します。
主にデータベースのパスワード設定など
vi ~/awx/tools/docker-compose/inventoryAWXをビルド
make docker-compose-build同一の環境であれば５〜１０分くらいでビルドが完了します。
ビルドが完了するとansible/awx_devel、ローカルイメージキャッシュにイメージが作成されます。
docker imagesコマンドを使用して確認します。
docker images以下のようにイメージが作成されている
REPOSITORY TAG IMAGE ID CREATED SIZE
quay.io/awx/awx_devel HEAD 03eaa84b348f About a minute ago 2.11 GBAWXを実行する
コンテナを起動します
make docker-compose COMPOSE_UP_OPTS=-d以下公式の説明（google先生の翻訳）
awx、postgres、redisコンテナを実行します。これは、前のステップで作成されたイメージを利用し、必要なすべてのサービスと依存コンテナーを自動的に開始します。コンテナが起動すると、セッションがawxコンテナにアタッチされ、ログメッセージとイベントをリアルタイムで監視できるようになります。Djangoとフロントエンドビルドプロセスからのメッセージが表示されます。
makeターゲットは、作成したイメージが現在のブランチでタグ付けされていることを前提としています。これにより、さまざまなコンテキストまたはブランチのイメージを構築できます。コンテナーを開始するときCOMPOSE_TAG=<branch name> に、環境で設定することにより、特定のブランチを選択できます。たとえば、機能ブランチで作業しているが、以前に作成したdevelイメージを使用してコンテナーを実行したい場合があります。これを行うには、次のコマンドを使用してコンテナを起動します。$ COMPOSE_TAG=devel make docker-compose
docker-compose detachedモードを実行するには、次のコマンドを使用してコンテナーを起動します。 $ make docker-compose COMPOSE_UP_OPTS=-d
Web接続
ビルドしてコンテナを起動させただけではWeb接続できません。
まずはUIをクリーンアップしてビルドします。
docker exec tools_awx_1 make clean-ui ui-develビルド開始（以下のように出力されます。
rm -rf node_modules
rm -rf awx/ui/node_modules
rm -rf awx/ui/build
rm -rf awx/ui/src/locales/_build
rm -rf awx/ui/.ui-built
NODE_OPTIONS=--max-old-space-size=4096 npm --prefix awx/ui --loglevel warn ci
added 2321 packages, and audited 2322 packages in 52s
### 中略
Find out more about deployment here:
https://cra.link/deployment
mkdir -p awx/public/static/css
mkdir -p awx/public/static/js
mkdir -p awx/public/static/media
cp -r awx/ui/build/static/css/* awx/public/static/css
cp -r awx/ui/build/static/js/* awx/public/static/js
cp -r awx/ui/build/static/media/* awx/public/static/media
touch awx/ui/.ui-built
make[1]: Leaving directory '/awx_devel'次に管理ユーザーの作成
AWXにログインする前に、管理者ユーザーを作成する必要があります。
docker exec -ti tools_awx_1 awx-manage createsuperuser実行すると以下のようにユーザー名、メールアドレスパスワードを入力していきます。
Username (leave blank to use 'awx'): masahiro
Email address: masahiro@example.jp
Password:
Password (again):
Superuser created successfully.ファイヤーウォールを解放、WebUIは8043TCPポートに接続されているようです。
sudo firewall-cmd --add-port=8043/tcp
ブラウザで接続を確認する。
https://<AWXサーバIPもしくはFQDN>:8043
こんな感じです。Ansibleユーザー会でよくお目にかかるジャガイモくん（正式名おしえてくださいｗ）
ここのインターフェースは、cockpitと同じですねｗ
ダッシュボードになります。
AWXのバージョン確認
接続が確認できたらファイヤーウォールを永久設定へ
sudo firewall-cmd --runtime-to-permanent以上でAWX構築が完了となります。
使い方についてAWXのエンタープライズバージョンのAnsible towerのドキュメントをご確認ください。
https://docs.ansible.com/ansible-tower/
ついにできました！
最近学び始めたコンテナでの作成だったのでジャガイモくんが見れた時は、感動しました。
ドキュメントを読み込んでいじり倒して行こうかと思います。
以上です。ありがございました。
この記事が気に入ったらサポートをしてみませんか？