path: root/bootstrap.mdwn

[[!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).

Configura��o da m�quina hospedeira
----------------------------------

Preencha o hostname e dom�nio da m�quina no arquivo `/etc/hosts`. A ordem dos hostnames � importante para os facts `hostname` e `domain`. Troque `servidor` pelo hostname da m�quina e `projeto.org` pelo dom�nio:

    127.0.0.1 localhost
    xxx.yyy.zzz.www servidor.projeto.org servidor

Clone o reposit�rio `puppet-bootstrap`:

    export puppet_bootstrap_dir=/tmp/puppet-bootstrap
    export PUPPETLIB=$puppet_bootstrap_dir/modules
    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.

Os comandos a seguir realizam as seguintes tarefas:

* Instala��o dos m�dulos do puppet em `/tmp/puppet-bootstrap/modules`.
* Cria��o de um vserver para abrigar o n� administrativo.
* Configura��o do firewall para acesso externo ao vserver via ssh.

    puppet apply -d -v $puppet_bootstrap_dir/manifests/stage0.pp
    puppet apply -d -v $puppet_bootstrap_dir/manifests/host-stage1.pp


Configura��o do n� administrativo
---------------------------------

A partir deste momento, vamos trabalhar apenas no n� administrativo rec�m criado.

Acesse o n� administrativo e clone o `puppet-bootstrap` novamente:

    vserver servidor-master enter
    export PUPPETLIB=$puppet_bootstrap_dir/modules
    git clone git://git.sarava.org/puppet-bootstrap $puppet_bootstrap_dir

Os comandos a seguir realizam as seguintes tarefas:

* Instala��o dos m�dulos do puppet.
* Gera��o de uma configura��o padr�o do puppet em `/var/local/puppet/default-conf`.
* Instala��o do gitosis.
* Instala��o do puppetmaster com configura��o de atualiza��o peri�dica do reposit�rio em `/etc/puppet` (que criaremos em instantes).

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


Cria��o de reposit�rios padr�o
------------------------------

D� acesso ao reposit�rio administrativo do gitosis a um usu�rio:

    sudo -H -u gitosis gitosis-init < FILENAME.pub

Clone o reposit�rio administrativo do gitosis remotamente:

    git clone ssh://gitosis@servidor.projeto.org:porta/gitosis-admin

Altere o arquivo `gitosis-admin/gitosis.conf` do reposit�rio clonado e crie um reposit�rio para a configura��o do puppet e um reposit�rio para suas chaves criptogr�ficas:

    [gitosis]
    daemon      = no
    gitweb      = no
    public_http = no
    
    [group admin]
    writable = gitosis-admin puppet keyring
    members = usuario@maquina

Empurre as mudan�as para o servidor:

    git commit -a -m "Adicionando reposit�rios para puppet e keyring"
    git push origin master

Para adicionar um novo usu�rio ao gitosis, basta adicionar as chaves p�blicas ssh ao diret�rio `gitosis-admin/keydir/` com um nome de arquivo do tipo `usuario@maquina.pub`.

Configura��o do reposit�rio puppet
----------------------------------

Altere as configura��es padr�o do puppet em `/var/local/puppet/default-conf` de acordo com suas necessidades, fa�a uma c�pia das configura��es para o `/etc/puppet`, crie um novo reposit�rio git neste local e clone o reposit�rio para o diret�rio do gitosis:

    cd /etc/puppet
    cp -r /var/local/puppet/default-conf/* .
    git init
    git add *
    git commit -m "Initial config."
    git clone --bare /etc/puppet/ /var/git/repositories/puppet.git
    chown -R gitosis:gitosis /var/git/repositories/puppet.git

Agora j� podemos clonar o reposit�rio de configura��es do puppet remotamente:

    git clone ssh://gitosis@servidor.projeto.org:porta/puppet.git

Configura��o da hydra
---------------------

Esta parte da instala��o gera chaves criptogr�ficas e portanto deve ocorrer em uma m�quina com um n�vel de seguran�a significativo (criptografia de disco, bootless, etc).

Instale `hydra` e `keyringer`:

    sudo apt-get -y install git-core
    # hydra
    sudo git clone git://git.sarava.org/hydra /usr/local/hydra
    sudo ln -sf /usr/local/hydra/hydra /usr/local/sbin/hydra
    sudo ln -sf /usr/local/hydra/hydra /usr/local/sbin/hydractl
    sudo ln -sf /usr/local/hydra/hydra /usr/local/sbin/hydractl
    # keyringer
    sudo git clone git://git.sarava.org/keyringer /usr/local/keyringer
    sudo ln -sf /usr/local/keyringer/keyringer /usr/local/bin/keyringer

Tenha certeza que possui em seu chaveiro gpg as chaves dos usu�rios que ir�o acessar o reposit�rio de chaves. Crie um keyring para o projeto clonando o reposit�rio configurado:

    keyringer projeto init ~/projeto/keyring ssh://gitosis@servidor.projeto.org:porta/keyring.git

Clone o reposit�rio de configura��o do puppet e registre uma nova hydra:

    puppet_dir=~/projeto/puppet
    git clone git://gitosis@servidor.projeto.org:porta/puppet $puppet_dir
    hydra projeto register $puppet_dir

Gere novas chaves para os n�s configurados e as envie para os n�s:

    hydra projeto newkeys
    hydra projeto import servidor.pub


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 | sed -e s/^puppet-//`"
      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 | sed -e s/^puppet-//`"
      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