From 07d75df75ada34ef4b7de9cb07770b19251520f1 Mon Sep 17 00:00:00 2001
From: Silvio Rhatto <rhatto@riseup.net>
Date: Sun, 1 Oct 2017 17:21:16 -0300
Subject: Change markdown extension to .md

---
 bootstrap.md | 295 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 295 insertions(+)
 create mode 100644 bootstrap.md

(limited to 'bootstrap.md')

diff --git a/bootstrap.md b/bootstrap.md
new file mode 100644
index 0000000..c02bfd2
--- /dev/null
+++ b/bootstrap.md
@@ -0,0 +1,295 @@
+[[!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
+----------------------------------
+
+Configure algumas variáveis de ambiente:
+
+    export domain="projeto.org"
+    export hostname=`hostname | sed -e s/\\\\..*$//`
+    export puppet_bootstrap_dir=/var/tmp/puppet-bootstrap
+    export PUPPETLIB=${puppet_bootstrap_dir}/modules
+
+Configure o arquivo `/etc/hosts` (a ordem dos hostnames influencia nos resultados do `facter`):
+
+    cat > /etc/hosts <<EOF
+    127.0.0.1 ${hostname}.${domain} ${hostname}
+    127.0.0.1 localhost
+    EOF
+
+Instale o git e o puppet e clone o repositório `puppet-bootstrap`:
+
+    apt-get -y install git-core puppet wipe
+    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.
+
+Prepare o servidor para a utilização do puppet.
+
+    puppet apply -d -v ${puppet_bootstrap_dir}/manifests/stage0.pp
+
+Crie um vserver para abrigar o nó administrativo:
+
+    puppet apply -d -v ${puppet_bootstrap_dir}/manifests/host-stage1.pp
+
+Anote a fingerprint da chave ssh do vserver:
+
+    vserver ${hostname}-master exec ssh-keygen -l -f /etc/ssh/ssh_host_rsa_key.pub
+
+Configuração do nó administrativo
+---------------------------------
+
+A partir deste momento, vamos trabalhar apenas no nó administrativo recém criado.
+
+Copie o `puppet-bootstrap` e a configuração padrão para o vserver e limpe os rastros:
+
+    echo LANG=C > /var/vservers/${hostname}-master/etc/default/locale
+    cp -r ${puppet_bootstrap_dir} \
+      /var/vservers/${hostname}-master/${puppet_bootstrap_dir}
+    cp -r /usr/local/puppet \
+      /var/vservers/${hostname}-master/usr/local/puppet
+    wipe -rcfq -S r -R /dev/urandom ${puppet_bootstrap_dir} /usr/local/puppet
+
+Acesse o vserver e instale algumas ferramentas:
+
+    vserver ${hostname}-master enter
+    apt-get update
+    apt-get -y upgrade
+    apt-get -y install git puppet puppetmaster wipe
+
+Configure o hostname e domínio do nó administrativo:
+
+    cat > /etc/hosts <<EOF
+    127.0.0.1 ${hostname}-master.${domain} ${hostname}
+    127.0.0.1 localhost
+    EOF
+
+Prepare o vserver para a utilização do puppet.
+
+    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.${domain}:2202/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 `/usr/local/puppet/default-conf` de acordo com suas necessidades e incialize os repositórios em `/etc/puppet` e `/var/git/repositories/puppet`):
+
+    /etc/init.d/puppetmaster stop
+    rm -rf /etc/puppet && mkdir /etc/puppet
+    cd /etc/puppet
+    cp -r /usr/local/puppet/default-conf/* .
+    wipe -rcfq -S r -R /usr/local/puppet
+    git init
+    git add *
+    puppet-bootstrap add-submodules /etc/puppet
+    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@${hotname}.${domain}:2202/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
+    # 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
+    cd ~/projeto/keyring
+    git init
+    git remote add origin ssh://gitosis@servidor.${domain}:2202/keyring.git
+    git add *
+    git commit -m "initial commit"
+    git push origin master
+
+Clone o repositório de configuração do puppet e registre uma nova hydra:
+
+    puppet_dir=~/projeto/puppet
+    git clone git://gitosis@servidor.${domain}:2202/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 -y 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:${port}"
+    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:${port}"
+
+    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
-- 
cgit v1.2.3