Hands ON: Ansible x PostgreSQL

コンテナを立ち上げる

ansible コンテナ
- ansible コマンドをインストールし，実行するコンテナ
- target コンテナに対して ansible コマンドを実行しDBをセットアップする
target コンテナ
- sshd を立ち上げ，ssh 接続可能にされたコンテナ
- このコンテナに ansible コマンドを用いて postgreSQL を起動し DBを作成する

docker-compose -up d

コンテナ間の接続を確認する

# ansible docker に入る
docker exec -it ansible /bin/bash

# ansible docker から target01 コンテナに ssh できることを確認
ssh target01

ansible を用いて target01, 02 コンテナに posrgreSQL の DBをセットアップする

# ansible docker に入る
docker exec -it ansible /bin/bash

# target01,02 コンテナに対して ansible を実行する
ansible-playbook -i inventory.ini playbook.yml

# posrgresql がインストールされ，サービスとして起動されていることを確認
ssh target01
systemctl list-unit-files | grep postgresql

# posrgresql にログインするため postges ユーザーに切り替え
su postgres

# posrgresql にログイン (ユーザーは現在のシステムユーザーになる）
psql

# exampledb が作成されていることを確認 (ansible で作成した）
\l

ansible コンテナから， target01 コンテナに立ち上げた db に接続する

ansible でセットアップした db 接続情報
- db: exampledb
- user: jdoe
- password: test


psql -h target01 -d exampledb -U jdoe

Docker 設定詳細

ansible コンテナ
- centos x python イメージを使用
- ansible をインストール
target コンテナ
- amazonlinux を使用
- sshd 起動し，外部からssh接続を可能にする
  - openssh-server をインストール
  - root ユーザーにパスワード無しで接続できるようにする
  - ssh 接続のために 22 番port を開ける
- systemd を実行可能にする
  - /sbin/init コマンドを実行する ( + docker-compose での privledge 設定も必要）
docker-compose
- ansible コンテナに, このレポジトリのディレクトリをマウント
  - ansible 関連の設定ファイルを配置するため
- target コンテナに priviledged: true を設定
  - target コンテナ内で，systemd を用いた postgres の起動を可能にするため

Ansible 詳細

posrgresql セットアップのテンプレートとしてgeerlingguy/ansible-role-postgresql を使用
- Ansible-Galaxy に登録されている ansible テンプレート
- posrgresql のテンプレートの中で利用数が多いものを選択した

Ansible関連のファイル説明（必要なファイルのみ記述）


❯ tree ./ -l 3
./
├── README.md
├── ansible.cfg     # ansible コマンドの設定ファイル，roles の配置場所等を指定
├── ansible_log     # ansible コマンドのログファイル
│   └── log
├── inventory.ini   # ansible コマンドを実行する対象の host, ip 等の設定ファイル
├── group_vars      # ansible コマンド実行対象毎に ansible で設定する変数ファイルの置き場
│   └── target          # target コンテナに対して ansible コマンドを実行するときの変数
│       └── dbuser_password_postgres.yml
├── playbook.yml     # ansible-playbook コマンドで用いる，ansible の実行内容を設定するファイル
├── requirements.yml # ansible-galaxy コマンドで用いる，role をansible-galaxy から取得する際に用いる設定ファイル
└── roles            # playbook.yml で指定する role の内容を配置するディレクトリ
    └── geerlingguy.postgresql      # ansible-galaxy で提供されている postgresql をセットアップする role のテンプレート
        ├── LICENSE
        ├── README.md
        ├── defaults             # main.yml で読み込まれる変数を定義するディレクトリ
        │   └── main.yml
        ├─── vars                # main.yml で読み込まれる変数を定義するディレクトリ, defaults を上書きできる
        │   └── RedHat-2.yml        # amazonlinux でこのテンプレートを利用する際に使う定義ファイル，元々のこのファイルは定義されていなく amazonlinux で動かすために作成
        ├── handlers
        │   └── main.yml
        ├── meta
        │   └── main.yml
        ├── molecule
        │   └── default
        │       ├── converge.yml
        │       └── molecule.yml
        ├── tasks               # この role で実行する処理を定義するディレクトリ
        │   ├── configure.yml
        │   ├── databases.yml
        │   ├── initialize.yml
        │   ├── main.yml            # この role が playbook.yml で呼ばれたときに参照され，他の ymlの内容が読み込まれる
        │   ├── setup-Debian.yml
        │   ├── setup-RedHat.yml
        │   ├── users.yml
        │   └── variables.yml
        └── templates           # templateモジュールでセットアップされるJinja2形式のテキストファイルを配置するディレクトリ
            ├── pg_hba.conf.j2      # postgresql 設定ファイルのテンプレート，このテンプレートに変数を代入したファイルが taget に配置される
            └── postgres.sh.j2      # postgresql 設定ファイルのテンプレート，このテンプレートに変数を代入したファイルが taget に配置される

Ansible を用いた postgresql 設定詳細

行っていることは主に２つ
- Ansible の postgresql モジュールに必要な設定値を渡して postgresql を設定（ユーザー作成，DB作成 etc)
  - postgresql_db: postgresql の db セットアップモジュール
  - postgresql_user: postgresql の user セットアップモジュール
- Ansible と jinja テンプレートを用いて posrgresql 設定ファイルを生成し，target に配置（外部ホストからの接続設定等）
外部からのアクセス設定
- /var/lib/pgsql/data/postgresql.conf
  - DB へとアクセスを許可する ip を記述する設定ファイル
  - ansible の lineinfile モジュールを用いて，デフォルトで生成される posrgresql.conf ファイルの記述を書き換える
- /var/lib/pgsql/data/pg_hba.conf
  - DB への各ユーザー毎の接続設定を記述する設定ファイル
  - ansible の template モジュールを用いて，生成したファイルを target に配置することで設定

pg_hba.conf の設定項目

type
- local: ローカルからの接続についての設定項目であることを示す
- host: 外部からの接続についての設定項目であることを示す
database
- どの db に対する設定か, all もしくは db 名を記載
user
- どの user に対する設定か，all もしくは db 名を記載
address
- どの ip アドレスからの接続についての設定か (CIDR で指定）
auth_method
- 認証方式, 色々存在
- basic: ベーシック認証，パスワードを平文で要求 (通信内容にそのまま記載される)
- md5: クライアントに対して認証時にMD5暗号化パスワードを要求
  - md5形式ではパスワード無しは無効なので，必ず何らかのパスワードを設定する必要がある