Configuracao Ambiente Dev - fga-eps-mds/2017.1-Cadernos-API GitHub Wiki

Ambiente de desenvolvimento MDS/GPP

Histórico de Revisão

Data Versão Modificação Autor
21/03/2017 0.1.0 Passo a passo ambiente de desenvolvimento Fábio Teixeira
23/03/2017 0.1.1 Instalação do virtualbox 5 Fábio Teixeira
23/03/2017 0.1.2 Instalação do vagrant Fábio Teixeira
18/04/2017 1.0.0 Atualização do Vagrantfile Fábio Teixeira

Summary

  1. Vagrant e Virtualbox
    1. Instalação do virtualbox
    2. Virtualbox 5
    3. Instalação do vagrant
    4. Vagrant >= 1.8
  2. Box vagrant
    1. Instalação da box pronta para uso
    2. Instalação manual do rails em uma box
    3. Utilizando a box

Vagrant e Virtualbox

Iremos utilizar o vagrant, uma ferramenta que nos permite subir rapidamente tudo que for necessário para o ambiente de desenvolvimento. Mas para tal é necessário que ambos o vagrant e o virtualbox estejam instalados.

Instalação do virtualbox

sudo apt-get update
sudo apt-get install virtualbox

Após instalado verifique a sua versão:

virtualbox -v

Caso ela seja menor que a 5, significa que a sua distro não possuí o pacote com a versão que precisamos. Nesse caso prossiga para a instalação da versão correta: Virtualbox 5.

Virtualbox 5

ATENÇÃO Siga esses passos a não ser que a sua versão seja inferior a 5.

Desinstale a sua versão atual e instale a do site do mantenedor

sudo apt-get remove virtualbox

Baixe o pacote deb da sua distro: www.virtualbox.org

Pelo terminal, navegue até a sua pasta de downloads e instale o pacote baixado:

sudo dpkg -i NOME_DO_PACOTE.deb

Instalação do vagrant

De forma semelhante a instalação do virtualbox, instale o vagrant:

sudo apt-get update
sudo apt-get install vagrant

Verifique a sua versão:

vagrant -v

Caso a versão instalada seja menor que a 1.8, a sua distro não possuí o pacote com a versão que precisamos(>= 1.8). Então prossiga para a instalação da versão correta: vagrant >= 1.8

Vagrant >= 1.8

ATENÇÃO siga esses passos a não ser que a sua versão seja inferior a 1.8.

Desinstale a sua versão atual:

sudo apt-get remove vagrant

Baixe o vagrant do site de seu mantenedor, www.vagrantup.com e pelo terminal, navegue até a sua pasta de downloads e instale a versão baixada do vagrant:

sudo dkpg -i NOME_DO_PACOTE_BAIXADO.db

Box vagrant

Uma com o ambiente Ruby on Rails 5.0.2 já está configurada, bastando apenas ter o virtualbox e o vagrant instalados.

Instalação da box pronta para uso

Crie uma pasta para o seu vagrant, sugestão:

mkdir vagrant_folder

Entre na sua pasta do vagrant e baixe o nosso Vagrantfile:

cd vagrant_folder
wget https://raw.githubusercontent.com/fga-gpp-mds/2017.1-Cadernos-API/homolog/Vagrantfile

Inicie o vagrant

vagrant up mdsgpp
vagrant ssh mdsgpp

Na primeira vez que a box for montada o vagrant irá fazer o download, mas em futuras inicializações com a mesma box o vagrant não irá baixa-la novamente.

Instalação manual do rails em uma box

Caso prefira montar o ambiente em vez de usar a box criada. Os passos abaixo são os mesmos que foram utilizados para criar a box do vagrant

Instale o virtualbox e o vagrant

sudo apt-get update --fix-missing
sudo apt-get install virtualbox vagrant

Crie uma pasta para o seu vagrant e entrem nela

mkdir vagrant_folder
cd vagrant_folder

Inicialize o vagrant

vagrant init

Abra o Vagrantfile gerado com um editor de sua preferencia e adicione:

config.vm.define "mdsgpp" do |xenial|
  xenial.vm.box = "ubuntu/xenial64"
  xenial.vm.network "forwarded_port", guest: 3000, host: 3000
  xenial.vm.network "forwarded_port", guest: 8000, host: 8000
  xenial.vm.network "forwarded_port", guest: 8080, host: 8080
end

config.vm.provider "virtualbox" do |vb|
  vb.memory = "1024"
end

Inicialize a VM. O vagrant vai baixar a box, mas só na 1ª vez

vagrant up mdsgpp

Entre na box

vagrant ssh mdsgpp

baixe os scripts de instalação do ambiente

curl https://raw.githubusercontent.com/wiki/fga-gpp-mds/2017.1-Cadernos-API/ambiente/install-part-1-pacotes.sh > install-part-1-pacotes.sh

curl https://raw.githubusercontent.com/wiki/fga-gpp-mds/2017.1-Cadernos-API/ambiente/install-part-2-rails.sh > install-part-2-rails.sh

Deixe os arquivos baixados como executáveis

chmod +x install-part-1-pacotes.sh

chmod +x install-part-2-rails.sh

Execute eles nessa ordem:

./install-part-1-pacotes.sh

./install-part-2-rails.sh

O primeiro script(install-part-1-pacotes.sh) irá lhe perguntar seu nome e email para configuração do GIT e chave ssh

Utilizando a box

Sair da BOX:

exit

Desligar a BOX:

vagrant halt mdsgpp

Usar a BOX depois:

vagrant up mdsgpp

vagrant ssh mdsgpp