[[!toc  levels=4]]

Bootstrap de uma configuração completa
======================================

Este documento tem como objetivo descrever o **processo de bootstrap** de uma
configuração completa de um servidor utilizando o [Padrão Saravá](/). O
*processo de bootstrap* pode ser compreendido como "o processo de coordenar
diversos processos interdepententes de forma que seja atingida uma configuração
sistêmica estável".

Para este processo, utilizaremos as seguintes ferramentas:

* [Debian GNU/Linux 6.0](http://www.debian.org/releases/squeeze/).
* [Linux-VServer](http://linux-vserver.org/) ([pacote do debian](http://packages.debian.org/squeeze/linux-image-2.6-vserver-686)).
* [Git](http://git-scm.com/) e [gitosis](http://swik.net/gitosis).
* [puppet-bootstrap](http://git.sarava.org/?p=puppet-bootstrap.git;a=summary).
* [hydra](http://git.sarava.org/?p=hydra.git;a=summary).

Os seguintes estágios fazem parte de uma instalação padrão completa:

Instalação do sistema padrão na máquina hospedeira
--------------------------------------------------

Documentação [aqui](/install).

Clonagem do puppet-bootstrap na máquina hospedeira
---------------------------------------------------

    puppet_bootstrap_dir=/tmp/puppet-bootstrap
    apt-get install git-core puppet
    git clone git://git.sarava.org/puppet-bootstrap $puppet_bootstrap_dir

Altere o arquivo `$puppet_bootstrap_dir/manifests/config.pp` de acordo com suas necessidades.

Criação do nó administrativo
----------------------------

Preencha o hostname e domínio da máquina no arquivo `/etc/hosts`:

    127.0.0.1 localhost
    xxx.yyy.zzz.www hostname.domain hostname

Nesta etapa criamos um vserver para abrigar o nó administrativo:

    puppet apply -d -v $puppet_bootstrap_dir/manifests/admin.pp
    puppet apply -d -v $puppet_bootstrap_dir/manifests/firewall.pp

Bootstrap do puppet no vserver administrativo
---------------------------------------------

    puppet apply -d -v $puppet_bootstrap_dir/manifests/default-conf.pp
    puppet apply -d -v $puppet_bootstrap_dir/manifests/gitosis.pp
    puppet apply -d -v $puppet_bootstrap_dir/manifests/puppetmaster.pp

Criação de repositórios padrão
------------------------------

Nesta etapa, criaremos um repositório para o [keyring](https://git.sarava.org/?p=keyringer.git;a=summary) e um repositório com a configuração padrão do puppet.

Partida do puppetmaster
-----------------------

    /etc/init.d/puppetmaster start

Configuração de backups:
------------------------

1. Backup local criptografado:
    1. Criação de chaves GPG.
    2. Configuração do backup local.
2. Backup remoto:
    1. Criação de chaves SSH para armazenamento remoto de backup.
    2. Configuração do backup remoto.

Criação de outros vservers/nós
------------------------------

* Nó de armazenamento ("storage") para agrupamento de backups.
* Proxy.
* Web.
* Test.



Pedaços de código úteis para o bootstrap
========================================

Configuração de submódulos padrão
---------------------------------

    apt-get install puppetmaster puppet git-core openssh-server
    cd /etc/puppet
    mkdir modules
    git init
    git add .
    
    repos="`lynx -dump http://git.sarava.org/?a=project_index | awk '{ print $1 }' | grep ^puppet-`"
    for repo in $repos; do
      module="`basename $repo .git | cut -d - -f 2`"
      if [ ! -d "modules/$module" ]; then
        git submodule add git://git.sarava.org/puppet-$module.git modules/$module
      fi
    done

No caso de bootstrap para um novo projeto, substitua as referências de `git.sarava.org` para `git.projeto.org`.

Configurando referências remotas em massa
-----------------------------------------

    # Configuracao
    origin="sarava.org"
    remotes="sarava.org:porta"
    repos="`lynx -dump http://git.$origin/?a=project_index | awk '{ print $1 }' | grep ^puppet-`"

    # Adicionando referencias
    for repo in $repos; do
      module="`basename $repo .git | cut -d - -f 2`"
      if [ -d "puppet-$module" ]; then
        cd puppet-$module
        for remote in $remotes; do
          ref="`echo $remote   | cut -d . -f 1`"
          domain="`echo remote | cut -d : -f 1`"
          port="`echo remote   | cut -d : -f 2`"
          git remote add $ref ssh://gitosis@git.$domain:$port/puppet-$module.git
          git push $ref master
        done
        cd ..
      fi
    done

Mudando referências em submódulos
---------------------------------

    # Configuracao
    origin="sarava.org"
    dest="exemplo.org"

    cd puppet
    sed -i -e "s/git.$origin/git.$dest/" .gitmodules
    cd modules
    for module in `ls`; do
      cd $module
      git remote rm origin
      git remote add origin git://git.$dest/puppet-$module.git
      git config branch.master.remote origin
      git config branch.master.merge refs/heads/master
      cd ..
    done

Exemplo de criação em massa de módulos
--------------------------------------

    # Configuracao
    origin="sarava.org"
    remotes="sarava.org:porta"

    mkdir puppet-{ikiwiki,moin,mysql,trac}/manifests -p
    touch puppet-{ikiwiki,moin,mysql,trac}/manifests/init.pp
    for module in ikiwiki moin mysql trac; do
      cd puppet-$module
      cp ../puppet-git/LICENSE .
      git init
      git add .
      git commit -a -m "Initial import"
      for remote in $remotes; do
        ref="`echo $remote   | cut -d . -f 1`"
        domain="`echo remote | cut -d : f 1`"
        port="`echo remote   | cut -d : f 2`"
        git remote add $ref ssh://gitosis@git.$domain:$port/puppet-$module.git
        git push $ref master
      done
      cd ..
    done