Exibir código-fonte para Criando VM´s com Vagrant

=== Versões de softwares utilizados para criação do manual ===

{| class="wikitable"
|- style="text-align:center;"
| style="border: 2px solid #6495ED;" width="180"| '''Versão'''
| style="border: 2px solid #6495ED;" width="360"| '''Aplicação'''
|-
| style="border: 2px solid #6495ED;"| 6.3.9600.16384
| style="border: 2px solid #6495ED;"| Hyper-V
|-
| style="border: 2px solid #6495ED;"| 2012 R2 Standard
| style="border: 2px solid #6495ED;"| Windows Server
|-
| style="border: 2px solid #6495ED;"| 1.7.2
| style="border: 2px solid #6495ED;"| Vagrant
|-
| style="border: 2px solid #6495ED;"| 3.0
| style="border: 2px solid #6495ED;"| Windows PowerShell
|}

=== Introdução ===
<blockquote>Este documento visa apresentar o procedimento para preparação de máquinas virtuais usando a ferramenta Vagrant.<br \>O Vagrant é uma ferramenta que permite que criemos rapidamente máquinas virtuais para fazermos testes, desenvolvimento ou provisionamento de ambientes utilizando as soluções de virtualização mais comuns como o Virtualbox e o Hyper-V.<br \>Para a execução desta ferramenta, a interface é somente via prompt de comando.</blockquote>

=== Objetivo ===
<blockquote>Este manual tem como objetivo, se tornar uma espécie de consulta para os analistas de DevOps, assim como capacitar analistas que iniciarem na atividade de ''virtualização'' em quaisquer ambiente.</blockquote>

=== Execução ===
==== Criando uma VM zerada, com Windows 2012 R2 Standard ====

:'''Checklist (padronização)'''
::- Máquina Virtual (.vhdx) ter no máximo 45Gb para instalação do SO;<br \>- Windows Server com as atualizações baixadas e instaladas;<br \>- Instalar a feature ''.NET Framwork'' versões 3.5 e 4.5, pelo '''''Add Roles e Features''''' no '''''Server Manager'''''. Como da imagem abaixo.<br \><div align="left">[[Arquivo:Vagrant1.png|none|300px|caption]]</div><br \>- Instalar a feature ''Windows PowerShell'' versões 3.0 e 2.0, pelo '''''Add Roles e Features''''' no ''Server Manager''. Como da imagem abaixo.<br \><div align="left">[[Arquivo:Vagrant2.png|none|300px|caption]]</div><br \>- Fazer um procedimento para desativar senha complexa. Para isso, vá pela VM e pressione as teclas [[File:Logo Windows2012.png|25px|caption]] + R e digite '''''gpedit.msc'''''. Em seguida, navegue em ''Computer Configuration'' -> ''Windows Settings'' -> ''Security Settings'' -> ''Account Policies'' -> ''Password Policy'' e clique 2x na regra '''''Password must meet complexity requirements'''''. Selecione para desabilitar essa regra e clique em OK.<br \>- Configurar '''''WinRM''''', que é uma ferramenta de linha de comando projetado para criar e controlar as conexões remotas. Para isso, abre uma console do PowerShell na VM (clicando com o botão direito sobre este aplicativo e selecionar '''''Run as Administrator''''') e digite as três linhas de comando citada abaixo.<syntaxhighlight lang="doscon">winrm set winrm/config/client/auth '@{Basic="true"}'
winrm set winrm/config/service/auth '@{Basic="true"}'
winrm set winrm/config/service '@{AllowUnencrypted="true"}'
</syntaxhighlight>- Habilitar conexões ''Remote Desktop''. Para isso, abre uma console do PowerShell na VM (clicando com o botão direito sobre este aplicativo e selecionar '''''Run as Administrator''''') e digite as duas linhas de comando citada abaixo.<syntaxhighlight lang="doscon">$obj = Get-WmiObject -Class "Win32_TerminalServiceSetting" -Namespace root\cimv2\terminalservices
$obj.SetAllowTsConnections(1,1)</syntaxhighlight>- Habilitar ''CredSSP'' (Credential SSP), que permite o uso do ''SSP'' (Suporte de Provedor de Segurança) do lado cliente para delegar as credenciais do usuário da máquina cliente ao servidor de destino. Para isso, abre uma console do PowerShell na VM (clicando com o botão direito sobre este aplicativo e selecionar '''''Run as Administrator''''') e digite a linha de comando citada abaixo.<syntaxhighlight lang="doscon">Enable-WSManCredSSP -Force -Role Server</syntaxhighlight>- Habilitar regras ''RDP'' (protocolo de conexão remota) e ''WinRM'' no firewall. Para isso, abre uma console do PowerShell na VM (clicando com o botão direito sobre este aplicativo e selecionar '''''Run as Administrator''''') e digite as duas linhas de comando citada abaixo.<syntaxhighlight lang="doscon">Set-NetFirewallRule -Name WINRM-HTTP-In-TCP-PUBLIC -RemoteAddress Any
Set-NetFirewallRule -Name RemoteDesktop-UserMode-In-TCP -Enabled True</syntaxhighlight>- Alterar as políticas de execução do PowerShell. Para isso, abre uma console do PowerShell na VM (clicando com o botão direito sobre este aplicativo e selecionar '''''Run as Administrator''''') e digite a linha de comando citada abaixo.<syntaxhighlight lang="doscon">Set-ExecutionPolicy -ExecutionPolicy Unrestricted</syntaxhighlight>

==== Exportando a VM ====
:Nesta etapa, mostraremos como proceder para exportar a VM já criada, configurada e atualizada.
::- A primeira coisa, é necessário compactar no máximo a máquina virtual, usando o PowerShell como mostra a imagem abaixo.<syntaxhighlight lang="ps1con">PS C:\Windows\system32> Optimize-VHD -Path C:\<caminho do arquivo .vhdx> -Mode Full
</syntaxhighlight>'''Onde:''' ''<caminho do arquivo .vhdx>'' -> caminho onde está salvo o arquivo que corresponde a máquina virtual criada.<br \>- Próximo passo, será exportar a VM para a caminho desejado, conforme mostra a imagem abaixo.<syntaxhighlight lang="ps1con">PS C:\Windows\system32> Export-VM -Name <nome_da_VM> -Path C:\<nome da pasta onde salvará a VM exportada>
</syntaxhighlight>'''Onde:''' ''<nome_da_VM>'' -> nome da VM, que consta na console do gerenciador de Hyper-V.<br \>''<nome da pasta onde salvará a VM exportada>'' -> caminho onde salvará a VM a ser exportada<br \>- Após exportar a VM, próximo passo será remover a pasta ''Snapshots'', que não será muito útil. Esta pasta foi gerada durante o processo de exportação e está dentro da pasta onde foi exportada a VM. Segue o comando abaixo em que remove a pasta.<syntaxhighlight lang="ps1con">PS C:\Windows\system32> Remove-Item D:\<nome da pasta onde foi salva a VM exportada>\Snapshots -Recurse -Force
</syntaxhighlight>Dentro da pasta onde foi exportada a VM, iremos criar 2 arquivos (''metadata.json'' e ''Vagrantfile''), faremos primeiro a criação do arquivo ''metadata.json'' pelo notepad e inserir a informação necessária dentro do arquivo conforme mostra a imagem abaixo.<syntaxhighlight lang="doscon">{
 "provider": "hyperv"
}
</syntaxhighlight>- Na sequência, iremos criar o arquivo ''Vagrantfile'' e inserir a informação necessária dentro do arquivo conforme mostra a imagem abaixo.<syntaxhighlight lang="doscon"># -*- mode: ruby -*-
# vi: set ft=ruby :

VAGRANTFILE_API_VERSION = "2"

Vagrant.configure(VAGRANTFILE_API_VERSION) do |config|
  config.vm.guest = :windows
  config.vm.communicator = "winrm"
end
</syntaxhighlight>- A estrutura dentro da pasta ficará conforme a imagem abaixo, com 2 pasta e 2 arquivos.<br \><br \><div align="left">[[Arquivo:Vagrant13.png|none|400px|caption]]</div><br \>
==== Compactando a VM ====
:Para compactar toda a estrutura referente a imagem anterior, utilizaremos um aplicativo chamado '''''bsdtar''''' o arquivo zipado se encontra disponível em '''''\\mstech.com.br\docs\Areas\Dir. Sistemas de Gestão\Ger. Desenvolvimento de Software\Coord. DevOps\Restrito - Equipe\Programas\bsdtar'''''.<br \>Pegue uma cópia do arquivo zipado e armazene em um local de sua preferencia no servidor destino. Descompacte-o na sequência, após descompactado, note que há 4 arquivos e um desses arquivos está o executável '''''bsdtar'''''.<br \>Abra o prompt de comando com o botão direito do mouse e selecione '''''Run as Administrator'''''. Vá até o caminho onde está a pasta contendo a VM exportada e aplique a seguinte linha de comando.<syntaxhighlight lang="doscon">D:\vm_exportada> C:\<caminho da pasta descompactada>\bsdtar.exe –lzma –cvf <define um nome para o box>.box  *
</syntaxhighlight>'''Obs.:''' o diretório e os caminhos citados na linha de comando acima é apenas um exemplo.<br \>Segue a figura abaixo de como o processo de compactação é gerado.<br \><br \><div align="left">[[Arquivo:Vagrant14.png|none|300px|caption]]</div><br \>'''Nota:''' a criação o arquivo ''*.box'' leva tempo para ser concluído, de 2 a 3 horas, dependendo do tamanho total a ser compactado e da performance do host. Este arquivo fica salvo dentro ou fora da pasta contendo a VM exportada.<br \>Após o processo de compactação, segue a figura em que exibe o arquivo ''*.box'' criado.<br \><br \><div align="left">[[Arquivo:Vagrant15.png|none|300px|caption]]</div><br \>

==== Instalando o Vagrant ====
:A instalação se encontra dentro de '''''\\mstech.com.br\docs\Areas\Dir. Sistemas de Gestão\Ger. Desenvolvimento de Software\Coord. DevOps\Restrito - Equipe\Programas\Vagrant''''', o processo de instalação em um host é mostrado na sequência de imagens abaixo.<br \><br \><div align="center">[[Arquivo:Vagrant16.png|none|300px|caption]]</div><center>Clique em '''''Next'''''</center><br \><div align="center">[[Arquivo:Vagrant17.png|none|300px|caption]]</div><center>Habilite a opção '''''I accept terms in the License Agreement''''' e clique em '''''Next'''''</center><br \><div align="center">[[Arquivo:Vagrant18.png|none|300px|caption]]</div><center>Mantenha o caminho de instalação padrão e clique em '''''Next'''''</center><br \><div align="center">[[Arquivo:Vagrant19.png|none|300px|caption]]</div><center>Clique em '''''Install'''''</center><br \><div align="center">[[Arquivo:Vagrant20.png|none|300px|caption]]</div><center>Clique em '''''Finish''''' para finalizar a instalação</center><br \><div align="center">[[Arquivo:Vagrant21.png|none|300px|caption]]</div><center>Clique em Clique em '''''Yes''''' para reiniciar o host.</center>

==== Iniciando o uso do Vagrant ====
:Após reiniciar o host, o vagrant está disponível para uso. Lembrando que para usar esta ferramenta, necessário entrar via '''''prompt de comando''''' clicando com o botão direito do mouse e selecionar '''''Run as Administrator'''''.<br \>Como exemplo, foi criado uma pasta no diretório ''D:\'', chamado ''vagrant''. Dentro desta pasta será criado o ambiente virtual usando vagrant.<br \>Copie o box criado para dentro da pasta ''D:\vagrant'', iniciamos com a primeira linha de comando pelo '''''prompt de comando'''''.<br \><syntaxhighlight lang="ps1con">vagrant box add dsvm D:\vagrant\ds-vm.box
</syntaxhighlight>'''Onde:''' ''vagrant'' -> chama a ferramenta<br \>''box'' -> comando para gerenciar boxes<br \>''add'' -> parâmetro que vem depois do comando ''box'', serve para poder adicionar a box<br \>''dsvm'' -> nome para a box (você pode definir um nome qualquer)<br \>''D:\vagrant\ds-vm.box'' -> caminho onde se encontra atualmente a box criada<br \>Esta linha de comando coloca a box em seu cache global ''vagrant''. Por padrão, é uma pasta chamada '''''.vagrant.d''''' e fica localizada dentro do diretório pessoal (por exemplo, dentro de ''C:\Users\<usuario>'').<br \><br \>'''''Boas práticas de TI'''''<br \><br \>Uma vez aplicado a linha de comando, já basta para ser usada em diversas situações. Caso você opte usar a linha de comando definindo um nome diferente para a box e usar o mesmo arquivo .box, vai ocupar muito espaço em disco desnecessariamente.<br \>Segue abaixo de como o processo de ''descompactação'' é gerado. '''''Obs.''''': esse processo todo leva e 45 minutos a 1h para concluir, dependendo da performance do host.<br \><div align="left">[[Arquivo:Vagrant22.png|none|400px|caption]]</div>A próxima linha de comando a ser inserida é mostrada abaixo.<br \><syntaxhighlight lang="ps1con">vagrant init</syntaxhighlight>O comando ''init'', que vem depois de ''vagrant'', cria um arquivo '''''Vagrantfile''''' dentro do seu diretório atual (deste exemplo, é o ''D:\vagrant\''). Segue abaixo a figura após aplicar a linha de comando.<br \><div align="left">[[Arquivo:Vagrant23.png|none|400px|caption]]</div>É neste arquivo que faremos algumas modificações antes de criar a VM a partir do box, abre este arquivo com botão direito do mouse e selecione '''''Open with''''' para abrir com notepad.<br \><div align="left">[[Arquivo:Vagrant24.png|none|400px|caption]]</div>O Vagrantfile possui uma biblioteca de comandos e parâmetros já definidos, como pode ver na figura anterior, há exemplos de comandos e parâmetros nos comentários.<br \>Para o nosso exemplo, removi um único comando que não está protegido por comentário e que é ''default'' do Vagrantfile, o <code>config.vm.box = “base”</code>. Este comando fica abaixo da linha <code># boxes at https://atlas.hashicorp.com/search.</code><br \>Foi feito uma modificação no Vagrantfile, para definir o tipo de VM necessária para um projeto, assim como configurar e prover esta VM. Segue a figura abaixo de como foi definido.<syntaxhighlight lang="doscon"># -*- mode: ruby -*-
# vi: set ft=ruby :

# All Vagrant configuration is done below. The "2" in Vagrant.configure
# configures the configuration version (we support older styles for
# backwards compatibility). Please don't change it unless you know what
# you're doing.
Vagrant.configure(2) do |config|
  # The most common configuration options are documented and commented below.
  # For a complete reference, please see the online documentation at
  # https://docs.vagrantup.com.

  # Every Vagrant development environment requires a box. You can search for
  # boxes at https://atlas.hashicorp.com/search.
  config.winrm.username = "<user>"         (1)
  config.winrm.password = "<pwd user>"     (2)
  # VM Windows 1                           (3)
  config.vm.define "web" do |web|          (4)
	  web.vm.hostname = "MS-EXEMPLO"   (5)
  	  web.vm.box = "dsvm"              (6)
  	  web.vm.provider "hyperv" do |y|  (7)
               y.ip_address_timeout = 420  (8)
          end                              (9)
  end                                      (10)

  # Disable automatic box update checking. If you disable this, then
  # boxes will only be checked for updates when the user runs
</syntaxhighlight>'''Onde:'''<br \>1 – Este comando define como Vagrant irá acessar a VM sobre ''WinRM'' e o '''''username''''' que o Vagrant irá usar para logar o serviço ''WinRM''.<br \>2 – Este comando define como Vagrant irá acessar a VM sobre ''WinRM'' e o '''''password''''' que o Vagrant irá usar para autenticar o usuário ''WinRM''.<br \>3 – Comentário para melhor identificar o tipo de VM.<br \>4 – Esta linha de comando substitui o '''''config''''' para '''''web''''', para melhor definição de um nome para ser usado na modificação da configuração de uma VM, que o Vagrant gerenciará.<br \>5 – Este comando define o nome da VM, no caso é MS-EXEMPLO.<br \>6 – Este comando define qual box será usada para criar a VM, no caso é ''dsvm''.<br \>7 – Esta linha de comando substitui o ''web'' para ''y'', para melhor definição de um nome para ser usado na modificação das configurações em que são específicas para um certo provedor, no caso o ''Hyper-V''.<br \>8 – Este comando define o tempo em segundos para aguardar a VM de informar um endereço IP.<br \>9 – Final da estrutura referente ao item 7<br \>10 – Final da estrutura referente ao item 4<br \>Finalmente, a última linha de comando irá criar a VM através do box em seu provedor, no caso o Hyper-V. Para Hyper-V, precisa incluir uma opção que é <code>-–provider</code>.<br \><syntaxhighlight lang="doscon">vagrant up -–provider hyperv</syntaxhighlight>'''Onde:'''<br \>''vagrant'' -> chama a ferramenta<br \>''up'' -> comando para iniciar a VM<br \>''-- provider'' -> parâmetro informa o provedor, no caso o Hyper-V<br \>''hyperv'' -> hipervisor informado<br \>Segue a figura abaixo após aplicar a linha de comando.<br \><div align="left">[[Arquivo:Vagrant26.png|none|400px|caption]]</div>Feito isso, a VM já se encontra operacional, verifique pelo Gerenciador Hyper-V e encontrará a tal VM criada através do Vagrant (destaque em vermelho).<br \><div align="left">[[Arquivo:Vagrant27.png|none|400px|caption]]</div><br \>

==== Manipulando a VM usando comandos Vagrant ====

:- Para iniciar a configuração de uma VM<syntaxhighlight lang="doscon">vagrant init
</syntaxhighlight>- Para iniciar uma VM<syntaxhighlight lang="doscon">vagrant up
</syntaxhighlight>- Para desligar a VM<syntaxhighlight lang="doscon">vagrant halt
</syntaxhighlight>- Para regarregar a VM (reboot)<syntaxhighlight lang="doscon">vagrant reload
</syntaxhighlight>- Para suspender a VM<syntaxhighlight lang="doscon">vagrant suspend
</syntaxhighlight>- Para fazer resumo de uma VM suspensa<syntaxhighlight lang="doscon">vagrant resume
</syntaxhighlight>- Para verificar o status de uma VM (se está ''off-line'' ou ''online'')<syntaxhighlight lang="doscon">vagrant status
</syntaxhighlight>- Para destruir a VM, apagando ela do host<syntaxhighlight lang="doscon">vagrant destroy
</syntaxhighlight>