Ansibleで始める構成管理ツール_Part2

Ansibleで公開しているBest Pricticeの構成を前回、記載しましたが具体的にどのファイルに何を記述していくべきなのか深堀して調査、検証してみました。

1.1. Ansibleディレクトリ構成

/etc/ansible/
  ├inventories/
  │  ├production/
  │  │  ├hosts                    # 本番環境サーバ用のインベントリファイル
  │  │  ├group_vars/
  │  │  │  ├all.yml
  │  │  │  ├webservers.yml        # 特定のグループに変数を割り当て
  │  │  │  ├dbservers.yml 
  │  │  │  └apservers.yml
  │  │  └host_vars/
  │  │      ├webservers.yml       # 特定のシステムに変数を割り当てます
  │  │      ├dbservers.yml
  │  │      └apservers.yml
  │  ├local/
  │  │  ├hosts                    # ansibleサーバ用のインベントリファイル
  │  │  ├group_vars/
  │  │  │ └local.yml 
  │  │  └host_vars/
  │  │      └local.yml 
  │  └staging/
  │      ├hosts                   # 開発環境サーバ用のインベントリファイル
  │      ├group_vars/
  │      │  ├all.yml
  │      │  ├webservers.yml       # グループに変数を割り当て
  │      │  ├dbservers.yml 
  │      │  └apservers.yml
  │      └host_vars/
  │          ├webservers.yml      # システムに変数を割り当てます
  │          ├dbservers.yml 
  │          └apservers.yml
  ├library/                       # カスタムモジュールを置きます。
  ├module_utils/                  # module_utilsを置きます。
  ├filter_plugins/                # カスタムフィルタプラグインを配置します。
  │
  ├site.yml                       # master playbook
  ├webservers.yml                 # playbook for webserver tier
  ├dbservers.yml                  # playbook for dbserver tier
  ├apservers.yml                  # playbook for apserver tier
  │
  └roles/
      ├common/                 # この階層は「役割」を表します
      │  ├tasks/
      │  │  └main.yml
      │  ├handlers/
      │  │  └main.yml
      │  ├templates/
      │  │  └ntp.conf.j2
      │  ├files/
      │  │  └source files     # コピーリソースで使用するファイル
      │  │  └script files     # スクリプトリソースで使用するスクリプトファイル
      │  ├vars/
      │  │  └main.yml         # このロールに関連する変数
      │  ├defaults/
      │  │  └main.yml         # このロールのデフォルトの優先順位の低い変数
      │  ├meta/
      │  │  └main.yml         # ロール依存関係
      │  ├library/            # カスタムモジュールも含めることができます
      │  ├module_utils/       # カスタムmodule_utilsも含めることができます
      │  └lookup_plugins/     # 検索のように、または他の種類のプラグイン
      ├webtier/               # 「common」と同じ構造
      ├dbtier/                # 「common」と同じ構造
      ├aptier/                # 「common」と同じ構造
      └monitoring/            # 「common」と同じ構造

まずは、ディレクトリを作成します。以下のURLのようにディレクトリ構成をplaybookで作成する方法もありますので参考にして下さい。『Ansibleのベストプラクティスなディレクトリ構成の雛形を一撃で作りたい』

Ansible_Dir=/etc/ansible
mkdir -m 755 $Ansible_Dir/inventories
mkdir -m 755 $Ansible_Dir/inventories/production/
mkdir -m 755 $Ansible_Dir/inventories/production/group_vars/
mkdir -m 755 $Ansible_Dir/inventories/production/host_vars/
mkdir -m 755 $Ansible_Dir/inventories/staging/
mkdir -m 755 $Ansible_Dir/inventories/staging/group_vars/
mkdir -m 755 $Ansible_Dir/inventories/staging/host_vars/
mkdir -m 755 $Ansible_Dir/library
mkdir -m 755 $Ansible_Dir/module_utils
mkdir -m 755 $Ansible_Dir/filter_plugins
mkdir -m 755 $Ansible_Dir/roles
mkdir -m 755 $Ansible_Dir/roles/common
mkdir -m 755 $Ansible_Dir/roles/common/tasks
mkdir -m 755 $Ansible_Dir/roles/common/handlers
mkdir -m 755 $Ansible_Dir/roles/common/templates
mkdir -m 755 $Ansible_Dir/roles/common/files
mkdir -m 755 $Ansible_Dir/roles/common/vars
mkdir -m 755 $Ansible_Dir/roles/common/defaults
mkdir -m 755 $Ansible_Dir/roles/common/meta
mkdir -m 755 $Ansible_Dir/roles/common/library
mkdir -m 755 $Ansible_Dir/roles/common/module_utils
mkdir -m 755 $Ansible_Dir/roles/common/lookup_plugins
mkdir -m 755 $Ansible_Dir/roles/webtier
mkdir -m 755 $Ansible_Dir/roles/webtier/tasks
mkdir -m 755 $Ansible_Dir/roles/webtier/handlers
mkdir -m 755 $Ansible_Dir/roles/webtier/templates
mkdir -m 755 $Ansible_Dir/roles/webtier/files
mkdir -m 755 $Ansible_Dir/roles/webtier/vars
mkdir -m 755 $Ansible_Dir/roles/webtier/defaults
mkdir -m 755 $Ansible_Dir/roles/webtier/meta
mkdir -m 755 $Ansible_Dir/roles/webtier/library
mkdir -m 755 $Ansible_Dir/roles/webtier/module_utils
mkdir -m 755 $Ansible_Dir/roles/webtier/lookup_plugins
mkdir -m 755 $Ansible_Dir/roles/dbtier/
mkdir -m 755 $Ansible_Dir/roles/dbtier/tasks
mkdir -m 755 $Ansible_Dir/roles/dbtier/handlers
mkdir -m 755 $Ansible_Dir/roles/dbtier/templates
mkdir -m 755 $Ansible_Dir/roles/dbtier/files
mkdir -m 755 $Ansible_Dir/roles/dbtier/vars
mkdir -m 755 $Ansible_Dir/roles/dbtier/defaults
mkdir -m 755 $Ansible_Dir/roles/dbtier/meta
mkdir -m 755 $Ansible_Dir/roles/dbtier/library
mkdir -m 755 $Ansible_Dir/roles/dbtier/module_utils
mkdir -m 755 $Ansible_Dir/roles/dbtier/lookup_plugins
mkdir -m 755 $Ansible_Dir/roles/aptier/
mkdir -m 755 $Ansible_Dir/roles/aptier/tasks
mkdir -m 755 $Ansible_Dir/roles/aptier/handlers
mkdir -m 755 $Ansible_Dir/roles/aptier/templates
mkdir -m 755 $Ansible_Dir/roles/aptier/files
mkdir -m 755 $Ansible_Dir/roles/aptier/vars
mkdir -m 755 $Ansible_Dir/roles/aptier/defaults
mkdir -m 755 $Ansible_Dir/roles/aptier/meta
mkdir -m 755 $Ansible_Dir/roles/aptier/library
mkdir -m 755 $Ansible_Dir/roles/aptier/module_utils
mkdir -m 755 $Ansible_Dir/roles/aptier/lookup_plugins

1.2. Ansible設定【/etc/ansible/ansible.cfg】

Ansibleの設定値に関しては、先人がまとめてくれているので以下を参照。

【ansible.cfgの項目をリスト化してみた】

公式マニュアル(ansible.cfg)

とりあえず、必要最低限として以下の行をコメントを外さないと動作しませんでした。

retry_files_enabled = False
retry_files_save_path = ~/.ansible-retry

1.3. Inventory設定

本番環境用のInventoryとステージング環境とでInventoryを分けて記載するのは、ansible-playbookコマンドにて-iでInventory file指定して実行するため、playbookを実行する対象を環境毎に分けることが可能です。

また、各Inventoryは、サーバの役割毎にグループを分けて記載することで、各役割毎のplaybookを実行するように構成しています。

【$Ansible_Dir/inventories/production/hosts】

[webservers]
168.100.101
168.100.102
168.100.103
168.100.104
[dbservers]
168.101.101
168.101.102
[apservers]
168.102.101
168.102.102

【$Ansible_Dir/inventories/staging/hosts】

[webservers]
168.200.101
168.200.102
168.200.103
168.200.104
[dbservers]
168.201.101
168.201.102
[apservers]
168.202.101
168.202.102

1.4. マスターplaybook

ansible-playbookコマンドで実行する時に指定する、playbookとなります。

なるべく、シンプルにするためサーバ役割毎のYAMLファイルをインクルードのみとしています。

$Ansible_Dir/site.yml

---
- import_playbook: webservers.yml
- import_playbook: dbservers.yml
- import_playbook: apservers.yml

1.5. サーバの役割毎のplaybook

サーバ役割毎にplaybookを作成し、このファイルで実行するサーバのグループを指定し実行するroleを指定します。 rolesで指定しているcommonは、共通の設定である【common】とwebサーバ固有の【webtier】を指定してます。 Ansibleのroleは、roleディレクトリの指定ディレクトリ配下(commonの場合[$Ansible_Dir/roles/common])配下に配置されたmain.ymlをインクルードします)

$Ansible_Dir/webservers.yml

---
- hosts: webservers
  roles:
    - common
    - webtier

$Ansible_Dir/dbservers.yml

---
- hosts: dbservers
  roles:
    - common
    - dbtier

$Ansible_Dir/apservers.yml

---
- hosts: apservers
  roles:
    - common
    - aptier

1.6. role配下の各役割

tasks

roleで実行されるtaskを定義する。 roleからmain.ymlが自動で読み込まれますので、他のファイルに分けたい時はmain.ymlからincludeすること。

また、task実行する対象が複数の場合は、変数を使用しループ実行するように定義してます。

変数に関しては、後述の【vars】を参照。

$Ansible_Dir/roles/common/tasks/main.yml

---
- name: install yum packages
  yum: name= state=latest
  notify: Start handler common
  with_items:
   - ""
 
 - name: users exist
   user: name= state=present password= group= uid= generate_ssh_key= home= shell= create_home=
  with_items: 
   - ""

- name: ~/.ssh for users exsit
  file: path="/home//.ssh" state=directory owner= group= mode=0700
  with_items:
   - ""

- name: authorized keys is deployed
  copy: src="authorized_keys_for_" dest="/home//.ssh/authorized_keys" owner= group= mode=0600
  with_items:
   - ""

- name: sudo configured
  copy: src="sudoers" dest="/etc/sudoers" owner=root group=root mode=0440

- name: Start the ntp service
  service: name=ntpd state=started enabled=yes
  tags: ntp

- template: src=templates/ntp.conf.j2 dest=/etc/ntp.conf owner=root group=root mode=0644
  notify: restart ntp

$Ansible_Dir/roles/webtier/tasks/main.yml

---
- name: install yum packages
  yum: name= state=latest
  notify: Start handler webtier
  with_items:
   - ""
- name: httpd.conf configured
  copy: src="httpd.conf" dest="/etc/httpd/conf/httpd.conf" owner=root group=root mode=0644

$Ansible_Dir/roles/dbtier/tasks/main.yml

---
- name: install yum packages
  yum: name= state=latest
  notify: Start handler dbtier
  with_items:
 - ""

$Ansible_Dir/roles/aptier/tasks/main.yml

---
- name: install yum packages
  yum: name= state=latest
  notify: Start handler aptier
  with_items:
 - ""
- name: tomcat configured
  copy: src="tomcat" dest="/etc/sysconfig/tomcat" owner=root group=root mode=0644

defaults

roleで利用される変数のデフォルト値をmain.ymlに定義する。

varsで、group_varsなどで変数を上書きできます。

vars

main.ymlにroleで利用される変数を定義します。基本的に環境毎に変わる固定値などを記述します。group_varsなどで変数を上書きできないので注意が必要です。

$Ansible_Dir/roles/common/vars/main.yml

---
common_packages:
  - ntpd
  - ntpdate
  - ncompress
common_users:
  - { name: opeuser,  password: "*****", group: "opegroup", uid: "1001", home: "/home/opeuser", create_home: "yes", shell: "/bin/bash", generate_ssh_key: "yes" }

※パスワードは、opensslコマンドでハッシュ化したパスワードを入力して下さい。ハッシュ化は、openssl passwd -l <平文のパスワード>

$Ansible_Dir/roles/webtier/vars/main.yml

---
webtier_packages:
  - httpd
  - httpd-tools
  - apr
  - apr-util

$Ansible_Dir/roles/dbtier/vars/main.yml

---
dbtier_packages:
  - postgresql-server
  - postgresql-contrib

$Ansible_Dir/roles/aptier/vars/main.yml

---
aptier_packages:
  - tomcat
  - tomcat-el
  - tomcat-jsp
  - tomcat-lib
  - tomcat-servlet

files

copyモジュールでセットアップされるファイルを配置します。 ASCII、バイナリのどちらでもOK。

上記のtaskを設定した場合は以下のファイルを用意する必要があります。

httpd.conf
tomcat
authorized_keys_for_***

templates

templateモジュールでセットアップされるJinja2形式のテキストファイルを配置する。 Jinja2形式のテキストファイルは、変数を埋め込むことができる点がfilesの下のファイルとの違いです。変数は、【default】【group_vars】【vars】のどこかに設定する必要があります。

$Ansible_Dir/roles/common/templates/ntp.conf.j2

driftfile /var/lib/ntp/drift

restrict 127.0.0.1 
restrict -6 ::1

server 

includefile /etc/ntp/crypto/pw

keys /etc/ntp/keys

handlers

handlersには、主にサービスの再起動といった特定の条件で発火するイベントtaskを定義します。別のRoleにて、Apacheの設定ファイルを変更した後、Apacheを再起動したいといったケースで利用します。この場合、別のRoleからhandlerの「restart apache2 service」をnotifyすれば、期待する挙動となるのです。

$Ansible_Dir/roles/common/handlers/main.yml

---
- name: restart ntp
  service: name=ntpd state=restarted
  listen:restart ntp

$Ansible_Dir/roles/webtier/handlers/main.yml

---
- name: restart httpd
  service: name=httpd state=restarted
  listen:Start handler webtier

$Ansible_Dir/roles/dbtier/handlers/main.yml

---
- name: restart postgrad
  service: name=postgrad state=restarted
  listen:Start handler dbtier

$Ansible_Dir/roles/aptier/handlers/main.yml

---
- name: restart tomcat
  service: name=tomcat state=restarted
  listen:Start handler aptier

group_vars

共通にセットする変数を格納。 $Ansible_Dir/inventories/production/group_vars/all.yml

---
ntpserver: 192.168.1.2

$Ansible_Dir/inventories/staging/group_vars/all.yml

---
ntpserver: 192.168.1.2

最後に

理想的にはGitで構築用のリポジトリにpushしたら、jenkinsでAnsibleサーバにビルドして、jenkinsからainsibleのplaybookを実行し、各サーバの設定を実施していくイメージだろう。

ここまで、できれば仮想マシン設定、OSインストール、単体試験まで自動化したいですが、それは後日・・・。

@legitwhiz

legit whiz 技術レポート

Ansibleで始める構成管理ツール_Part2

1.1. Ansibleディレクトリ構成

1.2. Ansible設定【/etc/ansible/ansible.cfg】

1.3. Inventory設定

1.4. マスターplaybook

1.5. サーバの役割毎のplaybook

1.6. role配下の各役割

tasks

defaults

vars

files

templates

meta

handlers

group_vars

最後に

Ansibleで始める構成管理ツール_Part2

1.1. Ansibleディレクトリ構成

1.2. Ansible設定 【/etc/ansible/ansible.cfg】

1.3. Inventory設定

1.4. マスターplaybook

1.5. サーバの役割毎のplaybook

1.6. role配下の各役割

tasks

defaults

vars

files

templates

meta

handlers

group_vars

最後に

1.2. Ansible設定【/etc/ansible/ansible.cfg】