1
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

第18回 Marmotで Windows Server 2025 を起動して、AnsibleでIISをセットアップする

1
Last updated at Posted at 2026-11-06

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 になったら、次の流れで初期設定をします。

  1. mactl console -g web3 で SPICE クライアントのコマンドとURL、そして、認証情報を取得して、接続
  2. 管理者のパスワードをインプット
  3. 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 アカウントとして実行しています。

処理の流れは次のとおりです。

  1. 一時ファイルを win_tempfile で作る
  2. .pfx を Windows ホストにコピーする
  3. LocalMachine\My にインポートする(key_exportable: false で秘密鍵はエクスポート不可)
  4. 一時ファイルを 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

実施内容は次の順です。

  1. IIS のインストール(必要なら再起動)
  2. index.html の配置
  3. PKCS#12 証明書のインポートと HTTPS(443) バインド
  4. Windows ファイアウォールの開放
  5. W3SVC の起動
  6. 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 は、次の処理をします。

  1. 新しい証明書を LocalMachine\My にインポートする
  2. IIS の HTTPS(443) バインドの証明書を、新しいものに置き換える
  3. 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 と見比べてみると面白いと思います。

1
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
1
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?