summaryrefslogtreecommitdiff
path: root/bootstrap.mdwn
blob: 6db424e5ec13aabcada03f15abcd1e98bb0778f1 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
[[!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