Ubuntu 18.04でMoleculeを使用してAnsibleロールをテストする方法

著者は、Write for DOnationsプログラムの一部として寄付を受け取るためにMozilla Foundationを選択しました。

前書き

Ansibleでの単体テストは、役割が意図したとおりに機能することを確認するための鍵です。 Moleculeを使用すると、さまざまな環境に対して役割をテストするシナリオを指定できるため、このプロセスが簡単になります。 Moleculeは、内部でAnsibleを使用して、構成された環境に役割をデプロイするプロビジョナーに役割をオフロードし、検証者（Testinfraなど）を呼び出して構成のドリフトをチェックします。これにより、ロールがその特定のシナリオで環境に対して予想されるすべての変更を行ったことを確認できます。

このガイドでは、Apacheをホストにデプロイし、CentOS 7でfirewalldを構成するAnsibleロールを作成します。この役割が意図したとおりに機能することをテストするには、Dockerをドライバーとして使用し、サーバーの状態をテストするためのPythonライブラリであるTestinfraを使用してMoleculeでテストを作成します。 MoleculeはDockerコンテナーをプロビジョニングしてロールをテストし、Testinfraはサーバーが意図したとおりに構成されていることを確認します。完了したら、環境全体のビルド用に複数のテストケースを作成し、Moleculeを使用してこれらのテストを実行できます。

前提条件

このガイドを始める前に、次のものが必要です。

Ubuntu 18.04サーバー1台。 Initial Server Setup with Ubuntu 18.04ガイドの手順に従って、root以外のsudoユーザーを作成し、パスワードなしでサーバーに接続できることを確認します。
サーバーにインストールされたDocker。 root以外のユーザーをdockerグループに追加するなど、How To Install and Use Docker on Ubuntu 18.04の手順1と2に従います。
Python 3とvenvがサーバーにインストールされ、構成されています。ガイダンスについては、How To Install Python 3 and Set Up a Programming Environment on an Ubuntu 18.04 Serverに従ってください。
Ansibleプレイブックに精通している。レビューについては、Configuration Management 101: Writing Ansible Playbooksを参照してください。

[[step-1 -—- preparing-the-environment]] ==ステップ1-環境の準備

前提条件を満たしている場合は、Python 3、venv、Dockerがインストールされ、正しく構成されている必要があります。 AnsibleをMoleculeでテストするための仮想環境を作成することから始めましょう。

非rootユーザーとしてログインし、新しい仮想環境を作成することから始めます。

python3 -m venv my_env

それをアクティブにして、アクションがその環境に制限されるようにします。

source my_env/bin/activate

次に、アクティブ化された環境で、wheelパッケージをインストールします。これは、pipがAnsibleのインストールに使用するbdist_wheelsetuptools拡張機能を提供します。

python3 -m pip install wheel

これで、moleculeおよびdockerをpipとともにインストールできます。 AnsibleはMoleculeの依存関係として自動的にインストールされます。

python3 -m pip install molecule docker

これらの各パッケージの機能は次のとおりです。

molecule：これは、ロールのテストに使用するメインのMoleculeパッケージです。 moleculeをインストールすると、Ansibleが他の依存関係とともに自動的にインストールされ、Ansibleプレイブックを使用して役割とテストを実行できるようになります。
docker：このPythonライブラリは、MoleculeがDockerとインターフェイスするために使用します。 Dockerをドライバーとして使用しているため、これが必要になります。

次に、Moleculeでロールを作成しましょう。

[[step-2 -—- creating-a-role-in-molecule]] ==ステップ2—分子での役割の作成

環境をセットアップしたら、Moleculeを使用して、Apacheのインストールのテストに使用する基本的な役割を作成できます。このロールは、ディレクトリ構造といくつかの初期テストを作成し、ドライバーとしてDockerを指定して、Moleculeがテストを実行するためにDockerを使用するようにします。

ansible-apacheという新しい役割を作成します。

molecule init role -r ansible-apache -d docker

-rフラグはロールの名前を指定し、-dはドライバーを指定します。ドライバーは、テストで使用するMoleculeのホストをプロビジョニングします。

新しく作成されたロールのディレクトリに移動します。

cd ansible-apache

デフォルトのロールをテストして、Moleculeが適切にセットアップされているかどうかを確認します。

molecule test

デフォルトの各テストアクションをリストする出力が表示されます。テストを開始する前に、Moleculeは構成ファイルmolecule.ymlを検証して、すべてが正常であることを確認します。また、テストアクションの順序を指定するこのテストマトリックスを出力します。

Output--> Validating schema /home/sammy/ansible-apache/molecule/default/molecule.yml.
Validation completed successfully.
--> Test matrix

└── default
    ├── lint
    ├── destroy
    ├── dependency
    ├── syntax
    ├── create
    ├── prepare
    ├── converge
    ├── idempotence
    ├── side_effect
    ├── verify
    └── destroy
...

ロールを作成してテストをカスタマイズしたら、各テストアクションについて詳しく説明します。今のところ、各テストのPLAY_RECAPに注意し、デフォルトのアクションのいずれもfailedステータスを返さないことを確認してください。たとえば、デフォルトの'create'アクションのPLAY_RECAPは、次のようになります。

Output...
PLAY RECAP *********************************************************************
localhost                  : ok=5    changed=4    unreachable=0    failed=0

次に、ロールを変更してApacheとfirewalldを構成します。

[[step-3 -—- configuring-apache-and-firewalld]] ==ステップ3—ApacheとFirewalldの設定

Apacheとfirewalldを構成するには、インストールするパッケージと有効にするサービスを指定して、ロールのタスクファイルを作成します。これらの詳細は、デフォルトのApacheインデックスページを置き換えるために使用する変数ファイルとテンプレートから抽出されます。

まだansible-apacheディレクトリに、nanoまたはお気に入りのテキストエディタを使用して、ロールのタスクファイルを作成します。

nano tasks/main.yml

ファイルが既に存在することがわかります。そこにあるものを削除し、次のコードに置き換えて必要なパッケージをインストールし、正しいサービス、HTMLデフォルト、ファイアウォール設定を有効にします。

~/ansible-apache/tasks/main.yml

---
- name: "Ensure required packages are present"
  yum:
    name: "{{ pkg_list }}"
    state: present

- name: "Ensure latest index.html is present"
  template:
    src: index.html.j2
    dest: /var/www/html/index.html

- name: "Ensure httpd service is started and enabled"
  service:
    name: "{{ item }}"
    state: started
    enabled: true
  with_items: "{{ svc_list }}"

- name: "Whitelist http in firewalld"
  firewalld:
    service: http
    state: enabled
    permanent: true
    immediate: true

このプレイブックには4つのタスクが含まれています。

"Ensure required packages are present"：このタスクは、pkg_listの下の変数ファイルにリストされているパッケージをインストールします。変数ファイルは~/ansible-apache/vars/main.ymlにあり、このステップの最後に作成します。
"Ensure latest index.html is present"：このタスクは、テンプレートページindex.html.j2をコピーし、Apacheによって生成されたデフォルトのインデックスファイル/var/www/html/index.htmlに貼り付けます。この手順では、新しいテンプレートも作成します。
"Ensure httpd service is started and enabled"：このタスクは、変数ファイルのsvc_listにリストされているサービスを開始して有効にします。
"Whitelist http in firewalld"：このタスクは、firewalldのhttpサービスをホワイトリストに登録します。 Firewalldは、CentOSサーバーにデフォルトで存在する完全なファイアウォールソリューションです。 httpサービスを機能させるには、必要なポートを公開する必要があります。 firewalldにサービスをホワイトリストに登録するように指示すると、サービスに必要なすべてのポートがホワイトリストに登録されます。

完了したら、ファイルを保存して閉じます。

次に、index.html.j2テンプレートページ用のtemplatesディレクトリを作成しましょう。

mkdir templates

ページ自体を作成します。

nano templates/index.html.j2

次の定型コードを貼り付けます。

~/ansible-apache/templates/index.html.j2


    Managed by Ansible

ファイルを保存して閉じます。

ロールを完了するための最後のステップは、変数ファイルを作成することです。このファイルは、パッケージとサービスの名前をメインのロールプレイブックに提供します。

nano vars/main.yml

pkg_listとsvc_listを指定する次のコードを使用して、デフォルトのコンテンツを貼り付けます。

~/ansible-apache/vars/main.yml

---
pkg_list:
  - httpd
  - firewalld
svc_list:
  - httpd
  - firewalld

これらのリストには、次の情報が含まれています。

pkg_list：これには、ロールがインストールするパッケージの名前（httpdおよびfirewalld）が含まれます。
svc_list：これには、ロールが開始して有効にするサービスの名前が含まれます：httpdおよびfirewalld。

[.note]＃Note:変数ファイルに空白行がないことを確認してください。空白行がない場合、リンティング中にテストが失敗します。
＃

役割の作成が完了したので、Moleculeが意図したとおりに機能するかどうかをテストするように設定します。

[[step-4 -—- formifying-the-role-for-running-tests]] ==ステップ4—テストを実行するためのロールの変更

この場合、Moleculeの構成には、Molecule構成ファイルmolecule.ymlを変更してプラットフォーム仕様を追加することが含まれます。 httpd systemdサービスを構成して開始する役割をテストしているため、systemdが構成され、特権モードが有効になっているイメージを使用する必要があります。このチュートリアルでは、milcom/centos7-systemdイメージavailable on Docker Hubを使用します。特権モードでは、コンテナをホストマシンのほぼすべての機能で実行できます。

これらの変更を反映するようにmolecule.ymlを編集してみましょう。

nano molecule/default/molecule.yml

強調表示されたプラットフォーム情報を追加します。

~/ansible-apache/molecule/default/molecule.yml

---
dependency:
  name: galaxy
driver:
  name: docker
lint:
  name: yamllint
platforms:
  - name: centos7
    image: milcom/centos7-systemd
    privileged: true
provisioner:
  name: ansible
  lint:
    name: ansible-lint
scenario:
  name: default
verifier:
  name: testinfra
  lint:
    name: flake8

完了したら、ファイルを保存して閉じます。

テスト環境の構成が正常に完了したので、ロールの実行後にMoleculeがコンテナーに対して実行するテストケースの作成に移りましょう。

[[step-5 --- writing-test-cases]] ==ステップ5—テストケースの作成

この役割のテストでは、次の条件を確認します。

httpdおよびfirewalldパッケージがインストールされていること。
httpdおよびfirewalldサービスが実行され、有効になっていること。
ファイアウォール設定でhttpサービスが有効になっていること。
そのindex.htmlには、テンプレートファイルで指定されたものと同じデータが含まれています。

これらすべてのテストに合格すると、ロールは意図したとおりに機能します。

これらの条件のテストケースを作成するために、~/ansible-apache/molecule/default/tests/test_default.pyでデフォルトのテストを編集しましょう。 Testinfraを使用して、Moleculeクラスを使用するPython関数としてテストケースを記述します。

test_default.pyを開きます：

nano molecule/default/tests/test_default.py

ファイルの内容を削除して、テストを最初から作成できるようにします。

[.note]＃Note:テストを作成するときは、2つの新しい行で区切られていることを確認してください。そうしないと、失敗します。
＃

必要なPythonモジュールをインポートすることから始めます。