Marmot は リリース 0.38から、Linux だけでなく、Windows Server 2022/2025 も仮想サーバーとして起動して、Ansibleで設定できるようになりました。
(この記事は プライベートクラウド「Marmot」で Windows Server 2025 を YAML 一枚でデプロイする の続編に当たります。前編を読んでいない方は、前編を読むと解りやすくなります。)
今回りリースした 0.38 で Windows Server 2025 を YAML で起動し、Ansible で IIS をインストールして、HTTP/HTTPS で応答する Web サーバーにするまでを紹介します。
Linux の VM に Ansible を流す例は、マニフェスト集にいくつかあります。Windows でも、同じ流れで構築できます。
今回の構成
| 項目 | 内容 |
|---|---|
| 仮想サーバー | Windows Server 2025 (web3) |
| ネットワーク | host-bridge |
| Ansibleの接続方式 | Windows標準の OpenSSH サーバー (WinRM は使わない) |
| シェル | PowerShell |
| 構築内容 | IISのインストール、index.html 配置、HTTPS(443) バインド、ファイアウォール開放 |
| 運用 | TLS証明書の有効期限チェック、証明書の更新 |
手順とファイルは、マニフェスト集の 67-http-server-iis にあります。
67-http-server-iis/
├── README.md
├── web3-ip-free.yaml # Windows Server 2025 のマニフェスト
└── playbook/
├── hosts.yaml # インベントリ
├── requirements.yaml # 必要な Ansible コレクション
├── install.yaml # IIS のセットアップ
├── check-cert.yaml # 証明書の有効期限チェック
├── renew-cert.yaml # 証明書の更新
├── secrets.yaml # ansible-vault で暗号化したパスワード
└── roles/
├── webserver-iis/
├── check-cert/
└── renew-cert/
1. Windows Server 2025 を起動する
マニフェストは次のとおりです。
apiVersion: v1
kind: Server
metadata:
name: web3
spec:
cpu: 2
memory: 4096
mmImage: win2k25
bootVolume:
spec:
size: 64
auth:
url: https://github.com/takara9.keys
networkInterface:
- networkname: "host-bridge"
Windows 向けのポイントは、次の3点です。
-
mmImage: win2k25で Windows Server 2025 を指定 -
bootVolumeは 64GB - ansible の yaml を指定しないで、Windows Server の起動後に、マニュアルで ansible を適用
auth.url には GitHub の公開鍵を指定しています。この鍵は、後で Ansible が SSH ログインするときに使われます。(筆者の公開鍵のURLを記しているので、実際に試したい読者は、変更をお願いします。)
次のコマンドで、起動します。
$ mactl create -f web3-ip-free.yaml
ステータスが RUNNING になったら、次の流れで初期設定をします。
-
mactl console -g web3で SPICE クライアントのコマンドとURL、そして、認証情報を取得して、接続 - 管理者のパスワードをインプット
- Windowsの自動設定によって、IP アドレスが付与され、リモートアクセスできるようになったら、Windows のリモートデスクトップで接続 (所用時間は Marmot ホストのスペックに依存しますが、筆者の自宅サーバー 10分程度必要でした。)
2. Ansible から SSH で接続する
Windows の OpenSSH サーバー
Ansible で Windows を操作する方法には WinRM と SSH があります。Marmot では、Windows 標準の OpenSSH サーバーを使います。
Windows Server 2022/2025 のサポート追加と合わせて、Marmot リリース 0.38から、次の仕組みが入りました(marmot PR #757)。
| タイミング | 内容 |
|---|---|
| ベースイメージ作成時 | OpenSSH Server の導入、sshd の自動起動設定、既定シェルを PowerShell に設定 |
| Server 作成時 (cloudbase-init) |
spec.auth の公開鍵を C:\ProgramData\ssh\administrators_authorized_keys に配置、ACL設定、TCP 22 の開放、sshd の起動 |
つまり、auth.url に書いた公開鍵で、Administrator として SSH ログインできる状態で VM が上がってきます。
インベントリ
playbook/hosts.yaml です。
all:
hosts:
web3:
ansible_host: web3
ansible_user: administrator
ansible_connection: ssh
ansible_shell_type: powershell
ansible_ssh_executable: /usr/local/bin/mactl-ssh
ポイントは次の3つです。
-
ansible_connection: sshとansible_shell_type: powershellで、SSH + PowerShell の組み合わせにします。 -
ansible_hostにはサーバー名web3を指定します。 -
ansible_ssh_executableには/usr/local/bin/mactl-sshを指定します。マニフェスト集の他の Ansible サンプルでも、同じ指定を使っています。
疎通確認
Windows 向けの ping モジュール win_ping で確認します。
$ ansible -i playbook/hosts.yaml all -m ansible.windows.win_ping
pong が返れば、準備完了です。
3. IIS をセットアップする
コレクションのインストール
Windows 向けのモジュールは、Ansible コレクションで提供されています。
# playbook/requirements.yaml
collections:
- name: ansible.windows
- name: community.windows
$ cd playbook
$ ansible-galaxy collection install -r requirements.yaml
Playbook
エントリーポイントの install.yaml は、ロールを呼ぶだけです。
- name: setup IIS web server on Windows Server
hosts: all
gather_facts: false # SSH接続のWindowsでは setup モジュールを使わない
roles:
- webserver-iis
gather_facts: false にしているのは、SSH 接続の Windows では、Linux 向けの setup モジュールによる情報収集を使わないためです。
ロール webserver-iis の中身
実際の処理は roles/webserver-iis/tasks/main.yaml にあります。順に見ていきます。
(1) IIS のインストール
- name: Install IIS
ansible.windows.win_feature:
name: Web-Server
state: present
include_management_tools: true
register: webserver_iis_feature
- name: Reboot if required by IIS installation
ansible.windows.win_reboot:
when: webserver_iis_feature.reboot_required
win_feature で IIS の機能 Web-Server を入れます。再起動が必要な場合だけ、win_reboot で再起動します。
(2) index.html の配置
- name: Deploy index.html
ansible.windows.win_copy:
dest: "{{ webserver_iis_web_root }}\\index.html"
content: "{{ webserver_iis_index_html }}"
既定値は roles/webserver-iis/defaults/main.yaml にあります。
webserver_iis_site_name: Default Web Site
webserver_iis_cert_file: web3.labo.local.pfx
webserver_iis_cert_password: ""
webserver_iis_web_root: C:\inetpub\wwwroot
webserver_iis_open_firewall: true
webserver_iis_index_html: |
<html><body><h1>{{ inventory_hostname }}.host-bridge.hv0.labo.local</h1></body></html>
表示内容は、ホスト名を埋め込んだ簡単な HTML です。
(3) TLS 証明書のインポート
HTTPS 用に、PKCS#12 (.pfx) の証明書をインポートします。ここが、この Playbook で一番のポイントです。
- name: Import PKCS#12 into LocalMachine\My
ansible.windows.win_certificate_store:
path: "{{ webserver_iis_cert_tmp.path }}"
password: "{{ webserver_iis_cert_password }}"
store_location: LocalMachine
store_name: My
state: present
key_exportable: false
# SSH接続(ネットワークログオン)のままだと秘密鍵が正しく保存されず、HTTPSバインドに失敗するためSYSTEMで実行する
become: true
become_method: ansible.builtin.runas
become_user: SYSTEM
register: webserver_iis_cert
SSH 接続は「ネットワークログオン」になるため、そのままインポートすると秘密鍵が正しく保存されず、後の HTTPS バインドに失敗します。そこで、become (runas) で SYSTEM アカウントとして実行しています。
処理の流れは次のとおりです。
- 一時ファイルを
win_tempfileで作る -
.pfxを Windows ホストにコピーする -
LocalMachine\Myにインポートする(key_exportable: falseで秘密鍵はエクスポート不可) - 一時ファイルを
alwaysブロックで必ず削除する
(4) HTTPS バインドの追加
- name: Find imported certificate with private key
ansible.windows.win_powershell:
parameters:
Thumbprints: "{{ webserver_iis_cert.thumbprints }}"
script: |
param([string[]]$Thumbprints)
$Ansible.Changed = $false
# PFXにはCA証明書も含まれるため、秘密鍵を持つ証明書を選ぶ
$cert = Get-ChildItem Cert:\LocalMachine\My |
Where-Object { $Thumbprints -contains $_.Thumbprint -and $_.HasPrivateKey } |
Select-Object -First 1
if (-not $cert) { throw "秘密鍵を持つ証明書が見つかりません" }
$Ansible.Result = $cert.Thumbprint
register: webserver_iis_server_cert
- name: Add HTTPS binding
community.windows.win_iis_webbinding:
name: "{{ webserver_iis_site_name }}"
protocol: https
port: 443
ip: "*"
certificate_hash: "{{ webserver_iis_server_cert.result }}"
certificate_store_name: My
state: present
become: true
become_method: ansible.builtin.runas
become_user: SYSTEM
PFX ファイルには、サーバー証明書のほかに CA 証明書が含まれることがあります。そのため、PowerShell で秘密鍵を持つ証明書だけを選んでサムプリントを取得し、そのサムプリントで HTTPS(443) のバインドを作ります。
(5) ファイアウォールとサービス
- name: Allow HTTP/HTTPS via Windows Firewall
community.windows.win_firewall_rule:
name: "IIS {{ item.name }}"
localport: "{{ item.port }}"
protocol: tcp
direction: in
action: allow
state: present
enabled: true
loop:
- { name: HTTP, port: 80 }
- { name: HTTPS, port: 443 }
when: webserver_iis_open_firewall | bool
- name: Ensure W3SVC is started and enabled
ansible.windows.win_service:
name: W3SVC
state: started
start_mode: auto
80/443 を Windows ファイアウォールで開放し、IIS のサービス W3SVC を起動・自動起動に設定します。ファイアウォールの開放は、webserver_iis_open_firewall: false で止められます。
(6) 応答の確認
- name: Verify HTTP responds
ansible.windows.win_uri:
url: http://localhost/
return_content: true
register: webserver_iis_http_check
retries: 3
delay: 2
until: webserver_iis_http_check.status_code == 200
HTTPS も同様に確認します。localhost では証明書の CN/SAN と一致しないため、HTTPS の確認では validate_certs: false にして、応答だけを見ています。
最後に Playbook 自身が HTTP/HTTPS の 200 応答を確認するので、構築の成否がその場で分かります。
4. 証明書のパスワードを ansible-vault で守る
PFX のパスワードを Playbook に平文で書くわけにはいきません。webserver_iis_cert_password は、ansible-vault で暗号化した secrets.yaml に保存して、-e @secrets.yaml で渡します。
初回だけ、次のように作成します。
$ cd playbook
$ ansible-vault create secrets.yaml
Vault のパスワードを設定するとエディタが開くので、次の内容を保存します。
webserver_iis_cert_password: <pfxのパスワード>
内容の確認と変更は、次のコマンドで行います。
$ ansible-vault view secrets.yaml
$ ansible-vault edit secrets.yaml
Vault のパスワードを毎回入力したくない場合は、パスワードをファイルに保存して --vault-password-file <ファイル> を指定します。このファイルはリポジトリに含めないでください。
また、パスワードを渡し忘れても、証明書のインポートに進む前に assert タスクが止めてくれます(IIS のインストールと index.html の配置は、この時点までに済んでいます)。
- name: Assert TLS certificate password is provided
ansible.builtin.assert:
that: webserver_iis_cert_password | length > 0
5. 実行する
ここまでの準備ができたら、Playbook を実行します。
$ cd playbook
$ ansible-playbook -i hosts.yaml install.yaml -e @secrets.yaml --ask-vault-pass
実施内容は次の順です。
- IIS のインストール(必要なら再起動)
-
index.htmlの配置 - PKCS#12 証明書のインポートと HTTPS(443) バインド
- Windows ファイアウォールの開放
- W3SVC の起動
- HTTP/HTTPS の応答確認
6. 動作確認
Ansible を実行したマシンから、curl で確認します。
$ curl http://web3.host-bridge/
$ curl -k https://web3.host-bridge/
-k は、証明書の検証をスキップするオプションです。
7. 証明書の運用 ― 有効期限の確認と更新
Web サーバーは、構築した後の運用が大切です。TLS 証明書の期限切れは、典型的な障害要因です。同じディレクトリに、運用向けの Playbook も用意しています。
有効期限の確認
$ ansible-playbook -i hosts.yaml check-cert.yaml
Windows の証明書ストア(LocalMachine\My)にある、秘密鍵付きの証明書について、次の情報を収集して表示します。
- サブジェクト
- サムプリント
- 有効期限
- 残り日数
- IIS の HTTPS バインドで使われているかどうか
残り日数が check_cert_warn_days(既定30日)以下の証明書は、警告として表示します。収集結果は fact check_cert_certificates に入るので、他の Playbook から再利用することもできます。
証明書の更新
新しい PKCS#12 ファイルを playbook/roles/renew-cert/files/ に置き、そのパスワードを secrets.yaml の renew_cert_password に追加します。
$ ansible-vault edit secrets.yaml
$ ansible-playbook -i hosts.yaml renew-cert.yaml -e @secrets.yaml --ask-vault-pass
この Playbook は、次の処理をします。
- 新しい証明書を
LocalMachine\Myにインポートする - IIS の HTTPS(443) バインドの証明書を、新しいものに置き換える
- HTTPS の応答を確認する
オプションは次のとおりです。
| オプション | 内容 |
|---|---|
-e renew_cert_file=<ファイル名> |
既定の web3.labo.local.pfx と異なるファイル名のとき |
-e renew_cert_remove_old=true |
置き換え前の証明書をストアから削除する |
バインドがまだ無い状態で実行すると、「先に install.yaml を実行してください」というエラーで止まります。
8. 削除
検証が終わったら、マニフェストを指定して削除します。
$ mactl del -f web3-ip-free.yaml
ハマりどころ
最後に、今回の構築で押さえておきたい点をまとめます。
| ポイント | 内容 |
|---|---|
| 接続方式 | WinRM ではなく、Windows 標準の OpenSSH + PowerShell。ansible_shell_type: powershell が必要 |
| 情報収集 | SSH 接続の Windows では gather_facts: false にする |
| 証明書のインポート | ネットワークログオンのままだと秘密鍵が保存されないため、become で SYSTEM として実行する |
| PFX の中身 | CA 証明書も入っていることがあるため、HasPrivateKey で選別する |
| パスワード |
ansible-vault で暗号化し、-e @secrets.yaml で渡す |
おわりに
Marmot で Windows Server を起動し、Linux と同じように Ansible で構築できることを確認しました。YAML でサーバーを定義し、Playbook でミドルウェアと証明書まで構成できるので、Windows の検証環境も何度でも作り直せます。
マニフェスト集には、nginx や Apache を構築する例もあります。IIS と見比べてみると面白いと思います。