Criação de máquinas virtuais

A proposta deste documento é demonstrar como provisionar máquinas virtuais utilizando as ferramentas VirtualBox ⧉ e Vagrant ⧉. O intuito principal é usar essas máquinas para simular as estações de trabalho dos times técnicos, a fim de validar os procedimentos de instalação e configuração das ferramentas de desenvolvimento em diferentes plataformas, incluindo Windows ⧉, Linux ⧉ e MacOS ⧉. Essa abordagem visa minimizar problemas decorrentes das particularidades de cada sistema operacional e arquitetura (32bit ⧉ ou 64bit ⧉), proporcionando uma experiência mais consistente e satisfatória aos usuários.

Pré-requisitos

Instalação do VirtualBox

O VirtualBox ⧉ é uma ferramenta gratuita e de código aberto que permite criar máquinas virtuais em seu computador. Sua principal finalidade é permitir que os usuários executem vários sistemas operacionais em um único computador, sem a necessidade de hardware adicional ou de reiniciar o sistema.

Para instalar o VirtualBox no seu ambiente, siga estes passos:

Linux Windows

1. Faça o download da versão adequada do VirtualBox no site oficial ⧉.

2. Instale as dependências necessárias para a instalação do binário do VirtualBox com o seguinte comando:

   sudo apt install -y --fix-broken \
       && sudo apt install -y libqt5help5 # (1)!
   

   1. 

3. Instale o pacote do VirtualBox usando o comando abaixo:

   sudo dpkg -i virtualbox-7.0_7.0.8-156879~Ubuntu~jammy_amd64.deb # (1)!
   

   1. 

4. Abra a interface de usuário clicando duas vezes no item de menu chamado Oracle VM VirtualBox.

Dica

Se nenhum dispositivo USB for listado nas configurações da máquina virtual, execute o comando sudo usermod -aG vboxusers $USER e reinicie a máquina hospedeira.

Documentação em progresso

Instalação do Extension Pack

O VirtualBox Extension Pack ⧉ é um pacote que amplia as funcionalidades básicas do VirtualBox, ou seja, ele habilita o uso dos dispositivos da máquina hospedeira, como o USB, WebCam, entre outros.

Para habilitá-lo, siga os passos abaixo:

Linux Windows

1. Baixe o pacote disponível a partir da página de downloads do VirtualBox ⧉.

2. Em seguida, instale o pacote baixado usando o gerenciador do VirtualBox.

   sudo VBoxManage extpack install \
       --replace Oracle_VM_VirtualBox_Extension_Pack-7.0.8.vbox-extpack # (1)!
   

   1. 

3. Por fim, verifique se a instalação foi bem sucedida listando todos os pacotes extras do VirtualBox.

   VBoxManage list extpacks # (1)!
   

   1. 

Documentação em progresso

Instalação do Vagrant

O Vagrant ⧉ é uma ferramenta open-source que permite criar e gerenciar ambientes de desenvolvimento virtualizados de forma isolada em máquinas virtuais ou containers. Isso facilita o compartilhamento e a reprodução desses ambientes em diferentes máquinas.

Para instalar o Vagrant em seu ambiente, siga estes passos:

Linux Windows

1. Importe a chave pública do Vagrant no seu sistema usando o comando:

   wget https://apt.releases.hashicorp.com/gpg -O- --quiet \
       | sudo gpg --dearmor -o /usr/share/keyrings/hashicorp-archive-keyring.gpg # (1)!
   

   1. 

2. Adicione o repositório do Vagrant no seu sistema:

   echo "deb [signed-by=/usr/share/keyrings/hashicorp-archive-keyring.gpg] https://apt.releases.hashicorp.com jammy main" \
       | sudo tee /etc/apt/sources.list.d/hashicorp.list # (1)!
   

   1. 

3. Atualize a listagem de repositórios do apt:

   sudo apt update -y # (1)!
   

   1. 

4. Instale o Vagrant:

   sudo apt install -y vagrant # (1)!
   

   1. 
   Solução de problemas ao provisionar máquinas virtuais Windows

   Para evitar problemas do tipo cannot load such file -- winrm (LoadError) durante o provisionamento de máquinas virtuais Windows, instale as seguintes bibliotecas Ruby ⧉ em seu sistema:

   sudo gem install winrm winrm-fs winrm-elevated
   

5. E por último, verifique se o CLI do vagrant está acessível em seu terminal.

   vagrant --version # (1)!
   

   1. 

Documentação em progresso

Instalação de Plugins Vagrant

Os plugins são extensões que acrescentam funcionalidades extras ao Vagrant, possibilitando aos usuários personalizar suas máquinas virtuais conforme as suas necessidades. Um exemplo disso é o plugin vagrant-reload, que permite reiniciar automaticamente a máquina virtual durante o processo de provisionamento.

Para instalá-lo, siga as seguintes etapas:

1. Abra o terminal e execute o comando a seguir:

   vagrant plugin install vagrant-reload # (1)!
   

   1. 

2. Verifique se a instalação do plugin foi bem sucedida executando o seguinte comando:

   vagrant plugin list # (1)!
   

   1. 

Provisionamento

Máquina Virtual Linux

Para criar uma máquina virtual Linux no VirtualBox com a ajuda do Vagrant, siga os seguintes passos:

Linux Windows

1. Baixe o arquivo Vagrantfile pré-configurado ⧉ para o provisionamento da máquina virtual Linux.

2. Crie um diretório que receberá o conteúdo do arquivo baixado após a extração, usando o seguinte comando:

   mkdir --parents /opt/dev/tools/vagrant/linux
   

3. Extraia o arquivo baixado no diretório desejado com o comando:

   tar -xzf vagrant-linux.tar.gz \
       --directory /opt/dev/tools/vagrant/linux \
       --strip-components=1 # (1)!
   

   1. 

4. Acesse o diretório criado usando o comando:

   cd /opt/dev/tools/vagrant/linux
   

5. Para provisionar a máquina virtual, execute o seguinte comando:

   vagrant up # (1)!
   

   1. 

   Informativo

   O tempo necessário para o provisionamento da máquina virtual pode variar de acordo com o tamanho da imagem e a velocidade da sua conexão com a internet, podendo levar alguns minutos.

6. Após o provisionamento, acesse a máquina virtual no VirtualBox, conforme ilustrado na imagem abaixo:

Documentação em progresso

Máquina Virtual Windows

Para criar uma máquina virtual Windows no VirtualBox utilizando a ferramenta Vagrant, siga os passos abaixo:

Linux Windows

1. Baixe o arquivo Vagrantfile pré-configurado ⧉ para o provisionamento da máquina virtual Windows.

2. Crie um diretório para armazenar o arquivo baixado:

   mkdir --parents /opt/dev/tools/vagrant/windows
   

3. Extraia o arquivo baixado no diretório recém-criado com o seguinte comando:

   tar -xzf vagrant-windows.tar.gz \
       --directory /opt/dev/tools/vagrant/windows \
       --strip-components=1 # (1)!
   

   1. 

4. Acesse o diretório criado utilizando o comando:

   cd /opt/dev/tools/vagrant/windows
   

5. Execute o seguinte comando para provisionar a máquina virtual:

   vagrant up # (1)!
   

   1. 

   Informativo

   O processo pode levar alguns minutos, dependendo do tamanho da imagem e da velocidade da sua conexão com a internet.

6. Após a conclusão do provisionamento, a máquina virtual pode ser acessada no VirtualBox, conforme ilustrado na imagem abaixo:

Documentação em progresso