Vagrant で作成した Windows ゲストに Ansible でプロビジョニングする最小設定 #Vagrant

Vagrant で作成した Windows ゲストに Ansible でプロビジョニングする際の 最小設定 についてです。
ググって出てきた直近の記事の写経で上手くいかなかったため色々試行錯誤した結果を残しておきます。

各種ツールのバージョン

Python: 2.7.11
Ansible: 2.1.0.0
Vagrant: 1.8.4
Virtual Box: 5.0.24 r108355

Vagrantfile

# -*- mode: ruby -*-
# vi: set ft=ruby :

Vagrant.configure("2") do |config|
  config.vm.box = "chusiang/win10-x64-ansible"
  config.vm.guest = "windows"
  config.vm.communicator = "winrm"

  config.winrm.username = "IEUser"
  config.winrm.password = "Passw0rd!"

  # 状況に合わせて
  # config.vm.provider "virtualbox" do |vb|
  #   vb.memory = "2048"
  #   vb.customize ["modifyvm", :id, "--vram", "128"]
  #   vb.customize ["modifyvm", :id, "--clipboard", "bidirectional"]
  # end

  # 必要であれば
  config.vm.network "forwarded_port", guest: 3389, host: 3389, id: "rdp", auto_correct: true

  config.vm.provision "ansible" do |ansible|
    ansible.playbook = "playbook.yml"
    # ansible.inventory_path = 指定しない
    ansible.host_vars = {
      "default" => {
        "ansible_ssh_port" => 55986,
        "ansible_winrm_server_cert_validation" => "ignore"
      }
    }
    # ansible.verbose = "v"
  end
end

config.vm.box

既存の記事では modernIE を利用しているようなのですが、
このグループが実はMicrosoft公式ではなく個人の開発者が作成していたものであり、
Microsoftが公式を作成したため2016年7月をもって開発終了、取得が不可能になってしまいました。 ¹

また、公式の方は Microsoft にあるのですが、WinRM のセットアップがなされていません。

今回は Atlas を検索して WinRM セットアップ済みとなっているものを利用しています。

config.vm.guest

ググった記事ではどれもが記述するように書いてあるのですが、消してもいけました。

ただし、 Vagrant のドキュメントには必要とあるので、
より複雑なことをするためには必要になるかもしれないので念のために記述しておきます。

config.vm.communicator

Windows との接続に SSH ではなく、 WinRM を使うために記述します。

config.winrm.username / config.winrm.password

WinRM での接続の際に利用するユーザー・パスワードです。

Windows の Vagrant Box には、 Vagrant Box お約束 ² の vagrant/vagrant が用意されていないため、 Windows VM でお約束の IEUser/Passw0rd! を記述します。

config.vm.provider

ここの中身は都合に合わせて設定します。必須ではありません。

config.vm.network

config.vm.communicator に winrm を記述しておくと WinRM で利用する 5985 と 5986 のポートフォーワーディングが自動で行われます。

しかし、 vagrant rdp で利用する rdp ポートは自動で行われないため記述しておきます。必須ではありません。

config.vm.provision

ansible.playbook

実行する Playbook のパスです。
Playbook の内容としては今回は接続を確認するだけのもののため以下のようにしています。

---
  - hosts: default
    tasks:
      - action: win_ping

hosts には Vagrant がデフォルトで指定する default を設定しています。

ansible.inventory_path

Ansible のインベントリファイルのパスを指定できますが、今回は指定せずに Vagrant が自動生成するものを利用します。

自前のインベントリファイルを利用すると Ansible 実行時に --extra-vars='ansible_ssh_user=vagrant' などと指定されて若干面倒なことになります。

ansible.host_vars

これを指定しないで実行すると自動生成されたインベントリファイルは以下のようになります。

default ansible_connection=winrm ansible_ssh_host=127.0.0.1 ansible_ssh_port=55985 ansible_ssh_user='IEUser' ansible_ssh_pass='Passw0rd!'

これの実行結果は

fatal: [default]: UNREACHABLE! => {"changed": false, "msg": "ssl: [SSL: UNKNOWN_PROTOCOL] unknown protocol (_ssl.c:590)", "unreachable": true}

となるように、 SSL に対応していないポートに SSL 接続してしまっているので、

"ansible_ssh_port" => 55986

と SSL 接続対応しているポートに差し替えます。

さらに上記だけだと

fatal: [default]: UNREACHABLE! => {"changed": false, "msg": "ssl: [SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed (_ssl.c:590)", "unreachable": true}

という証明書エラーが出てしまうので、

"ansible_winrm_server_cert_validation" => "ignore"

とすることで、証明書エラーを回避します。

ansible.verbose

Ansible のログレベルの設定です。必要に応じて v を増やしてください。

Vagrant で作成した Windows ゲストに Ansible でプロビジョニングする最小設定