Este projeto pode ser utilizado como um sub-módulo de qualquer outro que necessite de uma box Vagrant provisionada para construção e execução de sites criados com o uso do Middleman.
- 10/Mar/2016 - http://github.com/paulojeronimo/opendevise.io
- Fork do projeto que cria o site da OpenDevise
- 10/Mar/2016 - http://github.com/paulojeronimo/atomic-site
- Fork do projeto que cria o site do Project Atomic
- 09/Mar/2016 - http://github.com/paulojeronimo/middleman-guides
- Fork do projeto que cria o site do Middleman
- 08/Mar/2016 - http://github.com/paulojeronimo/middleman-asciidoc-example
Se você estiver utilizando o Windows, precisará de um interpretador Bash para executar scripts deste projeto. Uma forma de se instalar esse interpretador é através da instalação do Cygwin, conforme os passos descritos pelo Paulo Jerônimo.
No Windows, uma das formas de se instalar o VirtualBox é através do Chocolatey. Faça a sua instalação e, em seguida, execute o comando:
choco install virtualbox VirtualBox.ExtensionPack -y
No Fedora 23, a instalação do VirtualBox é detalhada neste artigo do Paulo Jerônimo.
No Windows, de forma semelhante a instalação do VirtualBox, o Vagrant também pode ser instado através do Chocolatey. Utilize o seguinte comando:
choco install vagrant -y
No Fedora 23, a instalação do Vagrant é detalhada no site Fedora Developer.
O plugin vagrant-vbguest é utilizado no Vagrantfile deste projeto para impedir a atualização do VirtualBox Guest Additions na box, caso o Vagrant detectasse que ele está mais atual na versão do VirtualBox sendo utilizada. Impedir essa atualização evita problemas que poderiam ocorrer na montagem de diretórios compartilhados caso a box fosse atualizada.
Esse plugin pode ser instalado com o seguinte comando:
vagrant plugin install vagrant-vbguest
Por default, este projeto já está configurado para provisionar uma máquina executando o Fedora 23. A box base utilizada é a boxcutter/fedora23 cujo projeto de construção está disponível no GitHub. O provisionamento dessa base é realizado através de shell script, pelo script provision/fedora23.
Para construir uma box que possa ser utilizada dentro de teu projeto Middleman, execute os seguintes passos:
git clone https://github.com/paulojeronimo/middleman-box
cd middleman-box
vagrant up
O teu projeto Middleman pode ser colocado em execução na box provisionada, e acessível pela porta URL default http://localhost:4567, através do seguinte comando:
./middleman-server
O script middleman-server também pode ser executado automaticamente ao final do processo de provisionamento, se o valor para o parâmetro de configuração executa_servidor_midlleman for true. Nesse caso, como o servidor do Middleman estará em execução, você notará que o shell ficará preso na execução do comando vagrant up. Para interromper esse servidor e, consequentemente, a execução da aplicação, você precisará digitar um <Ctrl+C>. Em seguida, deverá executar o comando ./middleman-server stop.
Toda vez que o servidor Middleman for interrompido dentro da box, você poderá reexecutar esse script (middleman-server) para colocar o Middleman em execução novamente.
Os passos a seguir exemplificam como este projeto pode ser utilizado na criação de um novo site que será construído com a utilização do Middleman.
mkdir meu-novo-site-middleman && cd $_
middleman_box=https://github.com/paulojeronimo/middleman-box
git clone $middleman_box
cd `basename $middleman_box`
vagrant up
vagrant ssh
gem install middleman
middleman init meu-novo-site-middleman
rsync -av meu-novo-site-middleman/ /vagrant/
rm -rf meu-novo-site-middleman
cd /vagrant
bundle exec middleman server
Abra a URL http://localhost:4567 em teu browser. Edite os arquivos de teu novo site acessando o diretório meu-novo-site-middleman (criado no teu HOST).