Ansible AWXとは?

エンタプライズ向けの位置付けであるAnsible Towerのアップストリーム版という位置付け。
Web上でプレイブックを管理・実行したり、APIでアクセスしたりを提供してくれる。

調べてみたモチベーション

管理するサーバが増えてきて何かと作業が面倒なので、Ansibleで一気にやりたいのですがチームで使うに当たってはクリアしたおきたい問題があります。

  • 個人環境のセットアップは面倒なので(特に手順化とか)実行環境を共有したい
  • いつ誰が何を実行したか分かるようにしたい(可視化)
  • 実行されては困るものは権限で制御したい

ここらへんをJenkinsを使う場合よりスマートに解決できるのではと思い試してみました。

試した環境

  • Ansible AWX 2.1.0
  • Ansible 2.7.2
  • CentOS 7.5
  • Docker 1.13.1
  • docker-compose 1.23.1

インストール

CentOS7.5にdockerでインストールしてみました。

まずAnsibleをインストールします。

$ sudo yum install -y epel-release
$ sudo yum install -y ansible

AWSのリポジトリをcloneします。執筆時点で最新の2.1.0のタグをチェックアウトしました。

$ git clone https://github.com/ansible/awx.git
$ cd awx
$ git branch
* devel
$ git checkout -b 2.1.0 tags/2.1.0

installer/inventoryファイルに設定が書かれているのですが、PostgreSQLのDATAフォルダが何故か/tmp下なので場所を変更しました。あと、docker composeを使用するため、use_docker_compose=trueを設定します。

$ cd installer
$ sed -i s@postgres_data_dir=/tmp/pgdocker@postgres_data_dir=/var/lib/pgsql/data@ inventory
$ sed -i 's/# use_docker_compose=false/use_docker_compose=true/' inventory

さすがAnsbileのプロダクトなので、インストールはansible-playbookで実行して行います。

$ ansible-playbook -i inventory --become --become-pass install.yml

セットアップが終わるまでしばらく待ちましょう。

セットアップが完了するとログイン画面が表示されます。デフォルト設定のままならadminユーザはパスワード=passwordでログインできます。

ログインするとダッシュボード画面に遷移します。

Organizationの登録

まずOrganizationを登録します。こだわりなければDefaultというのが登録されているのでそれを使っても良い。
ちなみに、全体的にこんな感じで上下に分割されている独自なUIなんですが私は馴染めずに使いにくいと感じました。

Teamの登録

Organizationの下にTeamを登録可能。

Projectの登録

Projectを登録します。SCMにはAnsible Towerのサンプルのプロジェクトを登録しました。 https://github.com/ansible/ansible-tower-samples

Inventryの登録

Inventryを作成します。テストとしてホストを1つ登録しました。またインスタンスグループはデフォルトで入っているtowerを選択。

Credentialの登録

認証情報を登録します。認証情報タイプ=マシンを選択してSSHの鍵を登録しました。

Templateの登録

現在のバージョンは日本語処理にバグがあって、Credentialの選択でエラーになります。
将来的に直るでしょうが、ブラウザの言語設定で英語に変更して英語表示に切り替えることで回避できます。

https://github.com/ansible/awx/issues/2231

登録したInventry、Project、Playbook、Credentialを指定して登録します。

Template画面のロケットアイコンで実行できます

まとめ

今後、Dynamic Inventory、複数のPlaybookでワークフローを組む機能など応用的な機能も触ってみたい。 ただ、日本語の処理にバグがあったり発展途上な印象なので引き続き評価していきたい。