Ubuntu18.04でMoleculeを使用してAnsibleの役割をテストする方法

投稿日: 2022-07-14 2022-10-16
タグ: Ansible, ubuntu, Ubuntu 18.04

序章

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

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

前提条件

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

1つのUbuntu18.04サーバー。 Ubuntu 18.04を使用したサーバーの初期設定ガイドの手順に従って、root以外のsudoユーザーを作成し、パスワードなしでサーバーに接続できることを確認します。
サーバーにDockerがインストールされています。 Ubuntu 18.04にDockerをインストールして使用する方法の手順1と2に従います。これには、root以外のユーザーを docker グループ。
Python3と venv サーバーにインストールおよび構成されています。ガイダンスについては、Python3をインストールしてUbuntu18.04サーバーにプログラミング環境をセットアップする方法に従ってください。
Ansibleプレイブックに精通していること。レビューについては、 Configuration Management 101：Writing AnsiblePlaybooksを参照してください。

ステップ1—環境の準備

前提条件を満たしている場合は、Python3が必要です。 venv、およびDockerがインストールされ、正しく構成されている。まず、AnsiblewithMoleculeをテストするための仮想環境を作成しましょう。

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

python3 -m venv my_env

これをアクティブにして、アクションがその環境に制限されていることを確認します。

source my_env/bin/activate

次に、アクティブ化された環境で、 wheel パッケージは、 bdist_wheel setuptools その拡張 pip Ansibleのインストールに使用します：

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でロールを作成しましょう。

ステップ2—分子での役割の作成

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

と呼ばれる新しい役割を作成します ansible-apache:

molecule init role -r ansible-apache -d docker

The -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 状態。たとえば、 PLAY_RECAP デフォルトの場合 'create' アクションは次のようになります。

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

次に、Apacheと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、デフォルトのインデックスファイルに貼り付けます。 /var/www/html/index.html、Apacheによって生成されます。このステップでは、新しいテンプレートも作成します。
"Ensure httpd service is started and enabled"：このタスクは、にリストされているサービスを開始して有効にします svc_list 変数ファイル内。
"Whitelist http in firewalld"：このタスクはホワイトリストに登録されます http でのサービス firewalld. Firewalldは、CentOSサーバーにデフォルトで存在する完全なファイアウォールソリューションです。のために http サービスを機能させるには、必要なポートを公開する必要があります。指示する firewalld サービスをホワイトリストに登録すると、サービスに必要なすべてのポートがホワイトリストに登録されます。

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

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

mkdir templates

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

nano templates/index.html.j2

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

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

<div style="text-align: center">
    <h2>Managed by Ansible</h2>
</div>

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

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

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.

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

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

ステップ4—テストを実行するための役割を変更する

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

編集しましょう 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がコンテナーに対して実行するテストケースの作成に移りましょう。

ステップ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

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

注：テストを作成するときは、テストが2行で区切られていることを確認してください。そうしないと、失敗します。

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