Cloudformationで構築したEC2にAnsibleでApacheを設定、実行するまで！ #AWS

はじめに

前回Cloudformationで構築した環境にServerspecでテストの実施を行うために、Ansibleで環境を構築する。
記事はこちら↓
AWS CloudFormationのテンプレートをLayer別に作成してクロススタック参照を作ってみた。

目指すゴール

EC2(1a)にテスト実行サーバーとしてAnsibleを実装
EC2(1c)にテスト対象サーバーとしてApacheを構築

構成図

Ansibleのインストール

Ansibleサーバにssh接続したところからスタート！
まずはサーバーにAnsibleをインストールさせる。

Bash

$ sudo amazon-linux-extras install ansible2 -y

バージョンの確認コマンドで以下のような表示されればインストール完了。

バージョン確認

$ ansible --version
ansible 2.9.23
  config file = /etc/ansible/ansible.cfg
  configured module search path = [u'/home/ec2-user/.ansible/plugins/modules', u'/usr/share/ansible/plugins/modules']
  ansible python module location = /usr/lib/python2.7/site-packages/ansible
  executable location = /usr/bin/ansible
  python version = 2.7.18 (default, Jun 10 2021, 00:11:02) [GCC 7.3.1 20180712 (Red Hat 7.3.1-13)]

秘密鍵のコピー

この作業はexitでサーバーから抜けてからローカル端末（今回はターミナル）で実施する。
Ansibleは対象にssh接続をして操作を実行するため秘密鍵が必要になるため、以下のコマンドで
EC2作成時に指定した秘密鍵（もしくは既存の秘密鍵）をAnsibleサーバに配置する。
※scpコマンドでコピーしないとansibleサーバーにデフォルトでは~/.ssh配下に秘密鍵がないため

秘密鍵をAnsibleサーバーに登録

$ scp -i [ansibleサーバに接続するための秘密鍵] [ansibleサーバが構築対象に接続するための秘密鍵]  ec2-user@[ansibleサーバーのグローバルIPアドレス]:~/.ssh
# e.g.)
$ scp -i ~/.ssh/samplekey.pem ~/.ssh/samplekey.pem ec2-user@1.2.3.4:~/.ssh

インベントリファイル(hosts)の作成

/var/www/ansible 配下にインベトリファイルを作成する。

/var/www/ansible

$ vi hosts

最小限の構成で以下ファイル内に追記

/var/www/ansible/hosts に以下を追記

# hosts
[server]
11.22.333.44

[server:vars]
ansible_ssh_port=22
ansible_ssh_user=ec2-user
ansible_ssh_private_key_file=~/.ssh/秘密鍵.pem
__working_user=ec2-user

PLAYBOOKの作成

作成するプレイブック(site.yaml )ではインベントリファイル(hosts)で定義したAnsibleサーバーの機器に対して実行する内容が記述されている。

/var/www/ansible/site.yaml

# 対象の指定(インベントリファイルで指定した名前)
- hosts: server

  # 管理者権限で実行
  become: true

  # 以下に実際の操作を記述していく
  tasks:

    # パッケージの更新
    - name: updated yum
      yum:
        name: "*"
        state: latest
    
    # 言語設定の変更
    - name: set LANG=ja_JP.UTF-8 in /etc/locale.conf
      lineinfile:
        dest: /etc/locale.conf
        regexp: "^LANG="
        line: "LANG=ja_JP.UTF-8"
        backup: yes

    # httpdのインストール
    - name: installed httpd
      yum:
        name: httpd
        state: installed
      become: yes

    # httpdの起動・自動起動設定
    - name: httpd booted and auto boot conf
      service:
        name: httpd
        state: started
        enabled: yes
      become: yes

    # あらかじめ作っておいたindex.htmlファイルを対象に配置
    - name: deployed index.html
      template:
        src: ./index.html
        dest: /var/www/html/index.html
        mode: 0644

hosts
実行対象のグループやホスト名を指定。
tasks
セクションでは実行するタスクを実行順に記述。
name
実行するタスク名を指定する箇所、何を指定してもOK。
state
どのような状態にするかの指示。
enabled
運用稼働状態にするかの指示。

構文のチェック

syntax-check

$ ansible-playbook -i hosts site.yml --syntax-check

playbook: site.yaml
#　問題なければこのように表示される

ansible-playbookの実行

$ ansible-playbook -i hosts site.yaml

エラー

[WARNING]: Platform linux on host 11.22.333.44 is using the discovered Python interpreter at /usr/bin/python, but future
installation of another Python interpreter could change this. See
https://docs.ansible.com/ansible/2.9/reference_appendices/interpreter_discovery.html for more information.

[解決策]
Ansibleの設定ファイル（ansible.cfg）に次の設定を追加すれば解決する。

/etc/ansible/ansible.cfg

[defaults]
interpreter_python=/usr/bin/python3

[参考にした記事]
Pythonのバージョンを指定してAnsible実行時に表示される警告を消す

エラー

fatal: [example.com]: FAILED! => {"changed": false, "msg": "The Python 2 bindings for rpm are needed for this module. 
If you require Python 3 support use the `dnf` Ansible module instead.. 
The Python 2 yum module is needed for this module. 
If you require Python 3 support use the `dnf` Ansible module instead."}

[解決策]
hostsに以下のようにPythonの絶対パスを追記。

# ansible_python_interpreter=/usr/bin/python3
ansible_python_interpreter=/usr/bin/python

[参考にした記事]
[Ansible] yumモジュールをdnfがインストールされていない環境で使う

無事に完了！！

$ ansible-playbook -i hosts site.yaml

# 無事に全ての構築が完了！

PLAY [server] ********************************************************************************************************************

TASK [Gathering Facts] ***********************************************************************************************************
ok: [11.22.333.44]

TASK [updated yum] ***************************************************************************************************************
ok: [11.22.333.44]

TASK [set LANG=ja_JP.UTF-8 in /etc/locale.conf] **********************************************************************************
ok: [11.22.333.44]

TASK [installed httpd] ***********************************************************************************************************
ok: [11.22.333.44]

TASK [httpd booted and auto boot conf] *******************************************************************************************
ok: [11.22.333.44]

TASK [deployed index.html] *******************************************************************************************************
ok: [11.22.333.44]

PLAY RECAP ***********************************************************************************************************************
11.22.333.44           : ok=6    changed=0    unreachable=0    failed=0    skipped=0    rescued=0    ignored=0

Cloudformationで構築したEC2にAnsibleでApacheを設定、実行するまで！