Cloud Design&Solution

Technical Blog

ホーム / 自動化 / IaC

【IaC 入門】⑧ Ansible で Web サーバーを作る:インターネットからページを見るまで

公開

前回は、Terraform で Compute を作り、cloud-init で SSH の準備を済ませました。今回は、その Compute に Ansible で Web サーバーに必要なものを入れ、インターネットからページが見えるところまで進めます。

今回すること

Terraform で作ったのは、OCI のリソース(ネットワークと Compute)までです。Compute の中は、まだ何も入っていない Oracle Linux 9 です。今回は、Compute の中を Ansible で設定し、Web サーバーにします。

Cloud Shell の ansible フォルダから ansible-playbook を実行し、インターネットとインターネットゲートウェイを通って SSH でユーザー ansible として Compute iac-intro-web に入り、httpd・トップページ・firewalld の許可を入れること、ブラウザからは HTTP の80番でページが届くことを示した OCI の構成図
図1 本検証で作成するWebサービス構成

すること 使う Ansible のモジュール 理由
Web サーバーのソフト(Apache HTTP Server、パッケージ名 httpd)を入れる dnf Oracle Linux 9 のパッケージは dnf で入れる
トップページ index.html を置く copy ページが見えたことを、自分で書いた文字で確かめる
httpd を起動し、再起動の後も立ち上がるようにする service 入れただけでは、Web サーバーは動かない
OS のファイアウォールで HTTP を許す firewalld OCI のイメージは、OS のファイアウォールで SSH 以外を止めている

モジュールは、Ansible が「パッケージを入れる」「ファイルを置く」などの作業をするための部品です。Ansible は、モジュールを SSH で Compute に送り、Compute の中で動かします。

2つの関所

Web サーバーにインターネットから届くには、次の2つの関所を通る必要があります。

関所 場所 今の状態
セキュリティ・リスト OCI のサブネット 6回目で、HTTP(80番)をどこからでも許してある
OS のファイアウォール(firewalld) Compute の中の Oracle Linux SSH だけを許している。今回、Ansible で HTTP を許す

OCI の公式ドキュメントでは、OCI が用意するイメージから作った Compute は、OS のファイアウォールで SSH だけを許す設定になっています。セキュリティ・リストで80番を開けていても、OS のファイアウォールで止まると、ページは見えません。

Ansible の考え方

Ansible は、設定したいことを「Playbook」という YAML のファイルに書きます。Playbook には、どのサーバーに、どの順に、何をするかを書きます。

1回目で、Ansible は「命令型の例として紹介されることが多いが、宣言型の考え方も取り入れている」と書きました。Playbook は上から順に実行されます。一方で、1つ1つの作業は「httpd が入っている」「httpd が動いている」のように、あるべき状態で書きます。すでにその状態なら、Ansible は何も変えません。今回の最後に、このことを確かめます。

Ansible は、設定する側(今回は Cloud Shell)にだけ入っていれば動きます。設定される Compute には、SSH で入れることと、Python があることだけが要ります。Compute に専用のソフトを入れる必要はありません。Cloud Shell には、Ansible がはじめから入っています(2回目で確かめた版は 2.9.27)。この検証では、この版で進めます。

設定ファイルを書く

Cloud Shell で、Ansible 用のフォルダを作り、その中に移ります。フォルダは、6回目で作った vcn、前回作った compute と並べます。

mkdir -p ~/iac-intro/ansible
cd ~/iac-intro/ansible
~/iac-intro/
├── vcn/
├── compute/
└── ansible/
    ├── inventory.ini
    └── site.yml

inventory.ini を書きます。

インベントリは、Ansible が設定するサーバーの一覧です。どのサーバーに、どのユーザーと鍵で入るかを書きます。

vi inventory.ini
[web]
iac-intro-web ansible_host=<公開 IP>

[web:vars]
ansible_user=ansible
ansible_ssh_private_key_file=~/.ssh/iac-intro
ansible_python_interpreter=/usr/bin/python3

<公開 IP> には、前回の apply で表示された public_ip を入れます。前回の値を見失ったときは、compute のフォルダで terraform output public_ip を実行すると、もう一度表示されます。

書いたこと 意味
[web] グループの名前。Playbook では、このグループを相手に指定する
iac-intro-web Ansible の中での呼び名。Compute の表示名と合わせた
ansible_host 実際に接続する先(公開 IP)
ansible_user SSH で入るユーザー。前回、cloud-init で作った ansible
ansible_ssh_private_key_file SSH の秘密鍵。前回作った ~/.ssh/iac-intro
ansible_python_interpreter Compute の中で使う Python の場所。Oracle Linux 9 では /usr/bin/python3

[web:vars] は、web のグループのサーバーすべてに使う値をまとめて書く書き方です。

site.yml を書きます。

vi site.yml
- name: Web サーバーを用意する
  hosts: web
  become: yes
  tasks:
    - name: httpd を入れる
      dnf:
        name: httpd
        state: present

    - name: トップページを置く
      copy:
        dest: /var/www/html/index.html
        content: |
          <!DOCTYPE html>
          <html lang="ja">
          <head><meta charset="utf-8"><title>iac-intro</title></head>
          <body><h1>Hello from iac-intro-web</h1><p>Ansible で設定した Web サーバーです。</p></body>
          </html>
        owner: root
        group: root
        mode: "0644"

    - name: httpd を起動し、再起動の後も立ち上がるようにする
      service:
        name: httpd
        state: started
        enabled: yes

    - name: OS のファイアウォールで HTTP を許す
      firewalld:
        service: http
        permanent: yes
        immediate: yes
        state: enabled
書いたこと 意味
hosts: web インベントリの web のグループを相手にする
become: yes 管理者(root)の権限で作業する。前回、ansible にパスワードなしの sudo を許したので、ここで止まらない
tasks 上から順に行う作業。name は、実行中の表示に使われる説明
state: present httpd が入っている状態にする。すでに入っていれば何もしない
/var/www/html/index.html httpd が、はじめにページを探す場所に置く
state: started、enabled: yes 今動いている状態にし、Compute を再起動しても立ち上がるようにする
permanent: yes、immediate: yes 再起動の後も残る設定にし、今すぐにも効かせる

Playbook を実行する

つながることを確かめる

Playbook を流す前に、Ansible が Compute に入れることを確かめます。

ansible -i inventory.ini web -m ping

-i で使うインベントリを、web で相手のグループを、-m ping で使うモジュールを指定します。ping のモジュールは、SSH で入り、Python が動くかを確かめます。ネットワークの ping(ICMP)とは別のものです。

iac-intro-web | SUCCESS => {
    "changed": false,
    "ping": "pong"
}

SUCCESS と "ping": "pong" が表示されれば、Ansible は Compute に入れています。前回、Cloud Shell から SSH で入ったときに接続先を信用したので、ここでは接続先の確認を聞かれません。

UNREACHABLE! と Connection timed out が表示されたときは、Cloud Shell の画面上部の「ネットワーク」が「パブリック」になっているかを確かめます。Cloud Shell を開き直すと、既定の「OCIサービス・ネットワーク」に戻っていることがあります(6回目の図2)。パブリックにしても失敗するときは、Cloud Shell の IP が変わっていないかを前回の手順で確かめます。

実行する

ansible-playbook -i inventory.ini site.yml

Ansible は、tasks を上から順に実行し、1つずつ結果を表示します。

最初の httpd を入れる は、パッケージの一覧を取ってくるため、数分かかることがあります。その間、表示は止まったように見えます。

PLAY [Web サーバーを用意する] **************************************************

TASK [Gathering Facts] *********************************************************
ok: [iac-intro-web]

TASK [httpd を入れる] **********************************************************
changed: [iac-intro-web]

TASK [トップページを置く] ******************************************************
changed: [iac-intro-web]

TASK [httpd を起動し、再起動の後も立ち上がるようにする] ************************
changed: [iac-intro-web]

TASK [OS のファイアウォールで HTTP を許す] *************************************
changed: [iac-intro-web]

PLAY RECAP *********************************************************************
iac-intro-web              : ok=5    changed=4    unreachable=0    failed=0    skipped=0    rescued=0    ignored=0

結果の表示には、次の3つがあります。

表示 意味
ok すでにあるべき状態だったので、何も変えなかった
changed あるべき状態にするために、変えた
failed 失敗した。その後の作業は行われない

1回目は、4つの作業がどれも changed になります。最後の PLAY RECAP の行に、作業ごとの数がまとめて表示されます。

この例では ok=5、changed=4 です。ok の5には、Ansible が最初に Compute の情報を集める作業(Gathering Facts)も入っています。この作業は何も変えないため、ok に数えられます。

ページを見る

まず Cloud Shell から、ページが返るかを確かめます。

curl http://<公開 IP>/
<!DOCTYPE html>
<html lang="ja">
<head><meta charset="utf-8"><title>iac-intro</title></head>
<body><h1>Hello from iac-intro-web</h1><p>Ansible で設定した Web サーバーです。</p></body>
</html>

site.yml に書いた HTML が返れば、Web サーバーは動いています。

次に、手元の PC のブラウザで http://<公開 IP>/ を開きます。

ブラウザで Compute の公開 IP を開き、見出し「Hello from iac-intro-web」と「Ansible で設定した Web サーバーです。」の一文が表示されたところ
図2 ブラウザで開いたトップページ

ページが見えなければ、2つの関所を順に確かめます。セキュリティ・リストに80番の許可があるか(6回目の図7)と、Playbook の最後の作業が failed になっていないかです。

もう一度実行する

同じ Playbook を、もう一度実行します。

ansible-playbook -i inventory.ini site.yml
PLAY [Web サーバーを用意する] **************************************************

TASK [Gathering Facts] *********************************************************
ok: [iac-intro-web]

TASK [httpd を入れる] **********************************************************
ok: [iac-intro-web]

TASK [トップページを置く] ******************************************************
ok: [iac-intro-web]

TASK [httpd を起動し、再起動の後も立ち上がるようにする] ************************
ok: [iac-intro-web]

TASK [OS のファイアウォールで HTTP を許す] *************************************
ok: [iac-intro-web]

PLAY RECAP *********************************************************************
iac-intro-web              : ok=5    changed=0    unreachable=0    failed=0    skipped=0    rescued=0    ignored=0

2回目は、どの作業も ok になり、changed は0になります。Compute はすでにあるべき状態なので、Ansible は何も変えません。何度実行しても同じ状態になる性質を「冪等性(べきとうせい)」と呼びます。Terraform で、変えていないリソースが plan に出てこなかったのと同じ考え方です。

最後に

今回の構成は、検証のために、できるだけ簡単な形にしています。そのため、安全なアクセスを行う対策を行っていません。
昨今の状況を鑑み、検証が終わったら速やかに環境を停止してください。

次回

次回は、この検証で作った Compute とネットワークを、terraform destroy で片付けます。

この記事の手順は、Ansible の公式ドキュメント(2.9)と、OCI・Oracle Linux の公式ドキュメントを基にしています。

あわせて読む