こんにちは、AI_LABの川口あいです。
前回の記事「Azure OpenAI × OpenTofuでIaCインフラ構築自動化をしてみた」では、要件定義書をインプットに、AIがOpenTofu (Terraform)用の変数ファイルを自動生成し、LocalStackへデプロイ検証できる仕組みを構築しました。
今回はその取り組みを発展させ、Azure OpenAIとAnsibleを組み合わせることで、要件定義書からAnsibleで使用する変数ファイルや、インストールすべきミドルウェアを定義したPlaybook(構成手順書)を自動生成する仕組みを構築しました。
目次
開発環境
Ansible
サーバー構築やソフトウェアのインストールなど、ITインフラの設定・管理を自動化できるオープンソースのツールです。 コード(Playbook)で構成を定義することで、環境構築や更新作業を効率的かつ再現性高く実行できます。
今回は、シンプルな構文で扱いやすく、エージェントレスで動作する点を評価してAnsibleを採用しました。
Docker
Dockerは、アプリケーションをコンテナと呼ばれる軽量な仮想環境で実行・管理できるプラットフォームです。
今回は、ミドルウェアをインストールする対象サーバーとしてDockerコンテナを用意し、そのコンテナに対してAnsibleを使ってミドルウェアのインストールを自動化しました。
Azure OpenAI
「要件定義書(CSV)」を「動的な変数ファイル(変数ファイルやplaybook.yml)」に変換する、プロジェクトの核心部分を担います。
メイン処理と開発フロー
ディレクトリ構造
project_root/ ├── client files/ │ └── requirement.csv (要件定義書) ├── ansible │ ├── playbooks │ │ ├── playbook.yml (playbookの雛形、AIによって修正あり) │ ├── roles(playbookで読み込むモジュールで処理を役割ごとに分けて管理する) | │ ├── httpd(Apache HTTP Serverのインストールや設定を行うタスク) | │ ├── mariadb | │ ├── perl | │ ├── php | │ ├── ... │ ├── vars | │ ├── main.yml(変数ファイルの雛形) | │ ├── anken1.yml(案件ごとの動的変数ファイル) │ ├── inventory.ini(管理対象のサーバー(ホスト)を定義) │ └── ... ├── main.py (AI呼び出しスクリプト) └── ...
前提条件
Dockerコンテナ上に、Ansibleでミドルウェアをインストールするためのサーバー環境を構築済みであること。
動作例
1. client files/ ディレクトリに、決まったフォーマットの「要件定義書(CSV)」を配置します。
2. main.py (Pythonスクリプト)を実行します。
3. 変数ファイルに関しては、スクリプトがCSVを読み込み、AI(LLM)に対して以下の内容のプロンプトを元に出力します。
## 指示 あなたは、与えられた「要件定義書」と「出力テンプレート」に基づいて、Ansibleの変数ファイル(YAML形式)の内容を生成する専門AIです。 あなたの仕事は、「出力テンプレート」の空欄部分を「要件定義書」から読み取った情報で正確に埋めることです。 ## 実行ルール 1. 「出力テンプレート」内の変数名(例: `mariadb_db_name`)とコメントをヒントに、「要件定義書」から対応する値を探してください。 2. 要件定義書に記載がない項目は、無理に推測せず `null` と置いてください。 3. 数値や真偽値(boolean)が入るべき項目で要件定義書に記載がない場合は、**適切なデフォルト値(例:DBメモリ制限なら'256M')**を設定してください。 4. テンプレートの構造、コメント、**YAMLのインデント**は完全に維持してください。 5. パスワードや秘密の情報は、必ずAnsibleの`lookup`構文に置き換えてください。 ## 厳守事項 - **出力はテンプレートを埋めたYAMLコードのみ**です。 - Markdownのコードブロック(```yamlなど)や、その他の説明、コメント、補足は一切含めないでください。 - 出力はテンプレートの最初の行から始まり、最後の行で終わる必要があります。 - **YAML構文を厳守してください。**
4. AIが雛形の変数ファイル(vars/main.yml)と要件定義書を受け取り、vars/ディレクトリ内にファイル(anken1.yml)として保存します。
Azure OpenAIにymlファイルの生成を依頼しています...
----------generated.auto.yml----------
# ミドルウェアごとの全変数を定義するファイル
# mariadbの設定変数
mariadb_vars:
database: "tester DB"
port: 3306
host: 127.0.0.1
superuser_id: root
superuser_pass: "{{ lookup('env', 'TF_VAR_ROOT_PASSWORD') }}"
user: testkun
user_host: '%'
encoding: utf8mb4
collation: utf8mb4_general_ci
mariadb_dnf_packages:
- mariadb-server
- python3-PyMySQL
# phpの設定変数
php_dnf_packages:
- php
- php-cli
- php-common
- php-mbstring
- php-json
# perlの設定変数
perl_dnf_packages:
- perl
- perl-CPAN
- perl-App-cpanminus
5. playbook.ymlに関しては要件定義書から必要なミドルウェアを読み取り、rolesセクションの変更を行います。また、作成した変数ファイルを参照するようにvars_filesセクションも変更します。
Detected roles: ['mariadb', 'php', 'perl', 'httpd'] playbook.yml の roles を上書きしました: ['mariadb', 'php', 'perl', 'httpd'] playbook.yml の vars_files を上書きしました: ansible/vars/anken1.yml playbook.yml を更新しました。
- 要件定義書から必要なミドルウェア情報を抽出した変数ファイル(例:ansible/vars/anken1.yml)をもとに、playbook.yml の roles セクションを更新します
- 具体的には、変数ファイルで検出されたミドルウェア(例:mariadb, php, perl, httpd)を roles として登録します
- 作成した変数ファイルを参照するように vars_files セクションも上書きします
今回はAIによる生成はせず、あらかじめ作成された変数ファイルをもとに、rolesとして扱うミドルウェアを選定して更新する形にしています。
6. 生成された変数ファイル(anken1.yml)とplaybook.ymlを確認し、Ansibleを実行します。
root@646015347d65:/workspace/ansible# ansible-playbook -i inventory.ini playbooks/playbook.yml PLAY [Setup example server] ************************************************************ TASK [Gathering Facts] ***************************************************************** [WARNING]: Host 'target_host' is using the discovered Python interpreter at '/usr/bin/python3.9', but future installation of another Python interpreter could cause a different interpreter to be discovered. See https://docs.ansible.com/ansible-core/2.19/reference_appendices/interpreter_discovery.html for more information. ok: [target_host] TASK [../roles/perl : Install Perl] **************************************************** ok: [target_host] TASK [../roles/httpd : Set OS-dependent variables] ************************************* ok: [target_host] TASK [../roles/httpd : Install httpd on Red Hat systems] ******************************* ok: [target_host] TASK [../roles/httpd : Install httpd on Debian systems] ******************************** skipping: [target_host] TASK [../roles/httpd : Place httpd configuration] ************************************** ok: [target_host] TASK [../roles/httpd : Place apache2 configuration] ************************************ skipping: [target_host] TASK [../roles/httpd : Create index.html with hostname] ******************************** ok: [target_host] TASK [../roles/httpd : Start httpd Service] ******************************************** ok: [target_host] TASK [../roles/httpd : Enable httpd Service] ******************************************* ok: [target_host] TASK [../roles/php : Install PHP] ****************************************************** ok: [target_host] TASK [../roles/php : Configure php.ini settings] *************************************** ok: [target_host] TASK [../roles/php : Configure PHP-FPM] ************************************************ ok: [target_host] TASK [../roles/php : Ensure PHP-FPM run directory exists and has correct permissions] *** ok: [target_host] TASK [../roles/php : Check if PHP-FPM is already running] ****************************** ok: [target_host] TASK [../roles/mariadb : Install MariaDB on Red Hat systems] *************************** ok: [target_host] TASK [../roles/mariadb : Install MariaDB on Debian systems] **************************** skipping: [target_host] TASK [../roles/mariadb : Set mariadb socket path] ************************************** ok: [target_host] TASK [../roles/mariadb : Initialize MariaDB data directory] **************************** ok: [target_host] TASK [../roles/mariadb : Start mariadb manually (no systemd)] ************************** changed: [target_host] TASK [../roles/mariadb : Wait for mariadb to start (socket)] *************************** ok: [target_host] TASK [../roles/mariadb : Secure the root account] ************************************** [WARNING]: Option column_case_sensitive is not provided. The default is now false, so the column's name will be uppercased. The default will be changed to true in community.mysql 4.0.0. ok: [target_host] TASK [../roles/mariadb : Create user for myapp db] ************************************* changed: [target_host] TASK [../roles/mariadb : Create myapp database] **************************************** changed: [target_host] PLAY RECAP ***************************************************************************** target_host : ok=21 changed=3 unreachable=0 failed=0 skipped=3 rescued=0 ignored=0
7. インストールしたコンテナに接続し、インストールや起動確認をします(一部抜粋)。
[root@container /]# httpd -v Server version: Apache/x.x.x (Linux) Server built: [ビルド日時非公開] [root@container /]# ps aux | grep httpd USER1 816 0.0 0.0 20888 6828 ? Ss 05:01 0:00 /usr/sbin/httpd -k start USER2 817 0.0 0.0 22568 7248 ? S 05:01 0:00 /usr/sbin/httpd -k start USER2 818 0.0 0.1 2358436 8964 ? Sl 05:01 0:00 /usr/sbin/httpd -k start USER2 819 0.0 0.1 2227300 8688 ? Sl 05:01 0:00 /usr/sbin/httpd -k start USER2 820 0.0 0.1 2227300 8688 ? Sl 05:01 0:00 /usr/sbin/httpd -k start USER1 8892 0.0 0.0 3744 1948 pts/0 S+ 05:39 0:00 grep --color=auto httpd [root@container /]# rpm -qa | grep mariadb-server mariadb-server-utils-x.x.x mariadb-server-x.x.x [root@container /]# mariadb -u root -p Enter password: Welcome to the MariaDB monitor. Commands end with ; or \g. Your MariaDB connection id is [接続ID] Server version: x.x.x-MariaDB MariaDB Server Copyright (c) 2000, 2018, Oracle, MariaDB Corporation Ab and others. Type 'help;' or '\h' for help. Type '\c' to clear the current input statement. MariaDB [(none)]> SELECT User, Host FROM mysql.user; +-------------+--------------+ | User | Host | +-------------+--------------+ | USER1 | % | | USER2 | % | | USER3 | container | | USER4 | localhost | | USER5 | localhost | | USER6 | localhost | | root | localhost | +-------------+--------------+ 7 rows in set (0.001 sec)
roles内のミドルウェアディレクトリの構成(一部抜粋)
ディレクトリ構造
roles/
└── httpd/
├── tasks/ # 実際の処理を記述するPlaybookのタスク
│ └── main.yml
├── handlers/ # 再起動などの通知処理
│ └── main.yml
├── templates/ # 設定ファイルなどのテンプレート
├── files/ # 静的なファイル
│ └── httpd.conf.j2 # 設定ファイルの内容
└── defaults/ # デフォルト変数(vars/anken1.ymlに上書きされる)
└── main.yml
└── ...
tasks/main.yml(一例)
---
# tasks file for httpd
- name: Set OS-dependent variables
set_fact:
httpd_config_path: "{{ '/etc/apache2/apache2.conf' if ansible_os_family == 'Debian' else '/etc/httpd/conf/httpd.conf' }}"
- name: Install httpd on Red Hat systems
dnf:
name: "{{ httpd_dnf_packages }}"
state: present
when: ansible_os_family == "RedHat"
- name: Install httpd on Debian systems
apt:
name: "{{ httpd_apt_packages }}"
state: present
when: ansible_os_family == "Debian"
- name: Place httpd configuration
template:
src: files/httpd.conf.j2
dest: "{{ httpd_config_path }}"
when: ansible_os_family == "RedHat"
notify: Restart httpd
- name: Place apache2 configuration
template:
src: files/apache2.conf.j2
dest: "{{ httpd_config_path }}"
when: ansible_os_family == "Debian"
notify: Restart httpd
- name: Create index.html with hostname
copy:
dest: "/var/www/html/index.html"
content: "{{ ansible_hostname }}"
- name: Start httpd Service
ansible.builtin.command: "/usr/sbin/httpd -k start"
args:
creates: /var/run/httpd/httpd.pid
- name: Enable httpd Service
ansible.builtin.lineinfile:
path: /etc/rc.d/rc.local
regexp: '^(.*httpd.*)$'
line: 'exec /usr/sbin/httpd -DFOREGROUND'
create: true
mode: '0755'
- 各ミドルウェアごとの役割や設定をまとめたファイルはあらかじめ用意しておき、要件定義書の内容をもとに、どのミドルウェアを使用するかの取捨選択や、必要な変数の設定を行う方法を採用しています
結論と今後の展望
今回のプロトタイプ開発では、要件定義書から必要なミドルウェアや変数を抽出し、AnsibleのPlaybookと変数ファイルを自動で作成・変更する仕組みを構築しました。その結果、複数のミドルウェアを効率的にインストール・設定できることが分かり、従来手作業で行っていたサーバー構築作業を、より再現性高く自動化できる可能性が示されました。
今後は、今回の仕組みをさらに拡張し、冗長構成やロードバランサーを含む複雑なサーバー構成への対応、実運用環境への適用に向けた安全性・セキュリティの強化を進めていく予定です。



