Commit 02a65fe477564d8e25d773519f85b5dc30d798cb

Authored by Rafael Gloria
1 parent 8ba19d23
Exists in master

Atualizando repositório de instalação do Puppet.

Showing 1 changed file with 158 additions and 151 deletions   Show diff stats
1 -# Simec - Sistema Integrado de Monitoramento, Execução e Controle 1 +imec - Sistema Integrado de Monitoramento, Execução e Controle
2 2
3 #### Tabela de Conteúdo 3 #### Tabela de Conteúdo
4 4
@@ -26,257 +26,264 @@ o banco de dados PostgresSQL localmente ou configurar o acesso a um banco remoto @@ -26,257 +26,264 @@ o banco de dados PostgresSQL localmente ou configurar o acesso a um banco remoto
26 ## Compatibilidade 26 ## Compatibilidade
27 27
28 * Compatível com CentOS 7 e Debian >= 7 28 * Compatível com CentOS 7 e Debian >= 7
29 - * Escrito com recursos do Puppet 3.  
30 - * O Simec utiliza APACHE 2 e PostgreSQL 8.4 ou superior.  
31 - * Este módulo usa **PostgreSQL 9.3.** 29 + * Escrito com recursos do Puppet 3.
  30 + * O Simec utiliza APACHE 2 e PostgreSQL 8.4 ou superior.
  31 + * Este módulo usa **PostgreSQL 9.3.**
32 32
33 -## Requisitos 33 + ## Requisitos
34 34
35 - * Pelo menos 2 gigas de RAM  
36 - * Pelo menos 10 gigas de disco  
37 - * Acesso a internet para instalação de pacotes 35 + * Pelo menos 2 gigas de RAM
  36 + * Pelo menos 10 gigas de disco
  37 + * Acesso a internet para instalação de pacotes
38 38
39 -## Setup **Install Puppet** 39 + ## Setup **Install Puppet**
  40 +
  41 + Instale o repositório do puppet para o seu Sistema Operacional.
  42 +
  43 + Debian 7
  44 + $ wget https://apt.puppetlabs.com/puppetlabs-release-wheezy.deb
  45 + $ sudo dpkg -i puppetlabs-release-wheezy.deb
  46 +
  47 + Debian 8
  48 + $ wget https://apt.puppetlabs.com/puppetlabs-release-jessie.deb
  49 + $ sudo dpkg -i puppetlabs-release-jessie.deb
  50 +
  51 + Pós instalação do repositório puppet para o Debian
  52 + $ sudo apt-get update
  53 + $ sudo apt-get install puppet-agent
40 54
41 -Instale o repositório do puppet para o seu Sistema Operacional. 55 + CentOS
  56 + $ sudo rpm -Uvh https://yum.puppetlabs.com/puppetlabs-release-pc1-el-7.noarch.rpm
  57 + # yum install puppet-agent
42 58
43 - Debian  
44 - $ wget https://apt.puppetlabs.com/puppetlabs-release-stable.deb  
45 - $ sudo dpkg -i puppetlabs-release-stable.deb  
46 - $ sudo apt-get update  
47 - $ sudo apt-get install puppet-agent 59 + Em caso de instalações ServerLess, será preciso instalar o módulo no diretório de módulos de acordo com o S.O.
48 60
49 - CentOS  
50 - $ sudo rpm -Uvh https://yum.puppetlabs.com/puppetlabs-release-pc1-el-7.noarch.rpm  
51 - # yum install puppet-agent 61 + Gerelamente no Debian:
52 62
53 -Em caso de instalações ServerLess, será preciso instalar o módulo no diretório de módulos de acordo com o S.O. 63 + obs.: PASTADOMODULO deve ter o nome de **"simec"**
  64 + Ex: /etc/puppet/modules/simec
54 65
55 -Gerelamente no Debian: 66 + # cp -av PASTADOMODULO /etc/puppetlabs/code/environment/production/modules/PASTADOMODULO
56 67
57 -obs.: PASTADOMODULO deve ter o nome de **"simec"**  
58 -Ex: /etc/puppet/modules/simec 68 + ou
59 69
60 - # cp -av PASTADOMODULO /etc/puppetlabs/code/environment/production/modules/PASTADOMODULO 70 + Geralmente no CentOS
61 71
62 -ou 72 + # cp -av PASTADOMODULO /etc/puppet/modules/PASTADOMODULO
63 73
64 -Geralmente no CentOS 74 + Dependendo do Sistema Operacional.
65 75
66 - # cp -av PASTADOMODULO /etc/puppet/modules/PASTADOMODULO  
67 76
68 -Dependendo do Sistema Operacional. 77 + ## ServerLess
69 78
  79 + Após criar o manifest, execute o puppet em modo serverless. (obs.: é necessário
  80 + instalar os módulos de dependência.)
70 81
71 -## ServerLess 82 + # puppet module install puppetlabs-vcsrepo
  83 + # puppet module install puppetlabs-apache
  84 + # puppet module install herculesteam-augeasproviders_postgresql
  85 + # puppet apply /tmp/meusimec.pp
72 86
73 -Após criar o manifest, execute o puppet em modo serverless. (obs.: é necessário  
74 -instalar os módulos de dependência.) 87 + obs.: /tmp/meusimec.pp é o arquivo com a declaração da classe (Veja mais em [Uso](#uso)).
75 88
76 - # puppet module install puppetlabs-vcsrepo  
77 - # puppet module install puppetlabs-apache  
78 - # puppet module install herculesteam-augeasproviders_postgresql  
79 - # puppet apply /tmp/meusimec.pp  
80 89
81 -obs.: /tmp/meusimec.pp é o arquivo com a declaração da classe (Veja mais em [Uso](#uso)). 90 + ## Uso
82 91
  92 + Para instalar o SIMEC com banco local (o padrão é banco remoto) e parâmetros padrões:
83 93
84 -## Uso 94 + ```puppet
  95 + class { '::simec':
  96 + vhost => 'meusimec.dominio',
  97 + install_db => true
  98 + }
  99 + ```
  100 + Para instalar o SIMEC com banco remoto:
85 101
86 -Para instalar o SIMEC com banco local (o padrão é banco remoto) e parâmetros padrões: 102 + ```puppet
  103 + class {'::simec':
  104 + vhost => 'meusimec.dominio',
  105 + install_db => false,
  106 + db_name => 'nomedabase',
  107 + db_username => 'usuariodeconexao',
  108 + db_password => 'SenhaSuperForte',
  109 + db_host => 'HostRemotodoBanco', #Ex: '192.168.1.1'
  110 + }
  111 + ```
87 112
88 -```puppet  
89 -class { '::simec':  
90 - vhost => 'meusimec.dominio',  
91 - install_db => true  
92 -}  
93 -```  
94 -Para instalar o SIMEC com banco remoto: 113 + Para especificar um repositório, DocumentRoot e um sistema de controle de versão diferente do git, use:
  114 + (obs.: é necessário um repositório com permissão de clone (git) ou chekout (svn) sem exigir autenticação.)
95 115
96 -```puppet  
97 -class {'::simec':  
98 - vhost => 'meusimec.dominio',  
99 - install_db => false,  
100 - db_name => 'nomedabase',  
101 - db_username => 'usuariodeconexao',  
102 - db_password => 'SenhaSuperForte',  
103 - db_host => 'HostRemotodoBanco', #Ex: '192.168.1.1'  
104 -}  
105 -``` 116 + ```puppet
  117 + class {'::simec':
  118 + vhost => 'meusimec.dominio',
  119 + source => 'http://repositorioSVNdosimec',
  120 + datadir => '/var/www/simec',
  121 + vcsprovider => 'svn'
  122 + }
  123 + ```
  124 + Exemplo de uma declaração com TODOS os parâmetros:
106 125
107 -Para especificar um repositório, DocumentRoot e um sistema de controle de versão diferente do git, use:  
108 -(obs.: é necessário um repositório com permissão de clone (git) ou chekout (svn) sem exigir autenticação.) 126 + ```puppet
  127 + class {'::simec':
  128 + vhost => 'meusimec.dominio',
  129 + source => 'http://repositoriodosimec',
  130 + datadir => '/var/www/simec',
  131 + install_db => true,
  132 + db_name => 'dbsimec',
  133 + db_username => 'usrsimec',
  134 + db_password => 'MinhaSenhaForte',
  135 + db_host => '192.168.1.1',
  136 + db_port => '5432',
  137 + emails => 'meuemail@meudominio ; outroemail@outrodominio',
  138 + vcsprovider => 'git',
  139 + apacheuser => 'apache',
  140 + repoensure => 'present'
  141 + }
  142 + ```
109 143
110 -```puppet  
111 -class {'::simec':  
112 - vhost => 'meusimec.dominio',  
113 - source => 'http://repositorioSVNdosimec',  
114 - datadir => '/var/www/simec',  
115 - vcsprovider => 'svn'  
116 -}  
117 -```  
118 -Exemplo de uma declaração com TODOS os parâmetros: 144 + ## Classes
119 145
120 -```puppet  
121 -class {'::simec':  
122 - vhost => 'meusimec.dominio',  
123 - source => 'http://repositoriodosimec',  
124 - datadir => '/var/www/simec',  
125 - install_db => true,  
126 - db_name => 'dbsimec',  
127 - db_username => 'usrsimec',  
128 - db_password => 'MinhaSenhaForte',  
129 - db_host => '192.168.1.1',  
130 - db_port => '5432',  
131 - emails => 'meuemail@meudominio ; outroemail@outrodominio',  
132 - vcsprovider => 'git',  
133 - apacheuser => 'apache',  
134 - repoensure => 'present'  
135 -}  
136 -``` 146 + ### Resumo das Classes
137 147
138 -## Classes 148 + #### Classe simec::apache
139 149
140 -### Resumo das Classes 150 + * Instalação e configuração do Apache
  151 + * Módulos do Apache
  152 + * Configuração do Vhost com Aliases, etc.
  153 + * Configuração do Parâmetros do PHP no Vhost via php_value e php_admin.
141 154
142 -#### Classe simec::apache 155 + #### Classe simec::postgresql
143 156
144 - * Instalação e configuração do Apache  
145 - * Módulos do Apache  
146 - * Configuração do Vhost com Aliases, etc.  
147 - * Configuração do Parâmetros do PHP no Vhost via php_value e php_admin. 157 + * Instalação do Servidor PostgreSQL.
  158 + * Configuração do Repositório oficial do PostgreSQL.
  159 + * Instalação dos pacotes do PostGis (GeoProcessamento).
  160 + * Criação da Base de Dados.
  161 + * Configuração do pg_hba.conf.
  162 + * Restore do Dump da Base de Dados.
148 163
149 -#### Classe simec::postgresql 164 + #### Classe simec::install
150 165
151 - * Instalação do Servidor PostgreSQL.  
152 - * Configuração do Repositório oficial do PostgreSQL.  
153 - * Instalação dos pacotes do PostGis (GeoProcessamento).  
154 - * Criação da Base de Dados.  
155 - * Configuração do pg_hba.conf.  
156 - * Restore do Dump da Base de Dados. 166 + * Instalação dos Pacotes php.
  167 + * Instalação do Pacote do Provider para o VCSREPO (Controle de versionamento, git, svn, etc.).
  168 + * Clone, etc. do Repositório com o código do SIMEC para o $datadir definido.
157 169
158 -#### Classe simec::install 170 + #### Classe simec::config
159 171
160 - * Instalação dos Pacotes php.  
161 - * Instalação do Pacote do Provider para o VCSREPO (Controle de versionamento, git, svn, etc.).  
162 - * Clone, etc. do Repositório com o código do SIMEC para o $datadir definido. 172 + * Configuração dos arquivos do SIMEC via Template ERB.
  173 + * Arquivo principal do simec (config.inc).
  174 + * Arquivo de Configuração para conexão com o Banco (database.php).
163 175
164 -#### Classe simec::config 176 + #### Classe simec::params
165 177
166 - * Configuração dos arquivos do SIMEC via Template ERB.  
167 - * Arquivo principal do simec (config.inc).  
168 - * Arquivo de Configuração para conexão com o Banco (database.php). 178 + * Configuração dos parâmetros padrões.
  179 + * Definição do $apacheuser de acordo com o facter osfamily (RedHat e Debian).
  180 + * Definição dos pacotes a serem instalados.
169 181
170 -#### Classe simec::params 182 + #### Classe simec:init
171 183
172 - * Configuração dos parâmetros padrões.  
173 - * Definição do $apacheuser de acordo com o facter osfamily (RedHat e Debian).  
174 - * Definição dos pacotes a serem instalados. 184 + * Classe principal para saber como chamar (Veja mais em [Uso](#uso)).
  185 + * Verificação do valor da variável $instal_db para decidir se há necessidade de instalação do banco localmente ou não.
175 186
176 -#### Classe simec:init 187 + ## Parâmetros
177 188
178 - * Classe principal para saber como chamar (Veja mais em [Uso](#uso)).  
179 - * Verificação do valor da variável $instal_db para decidir se há necessidade de instalação do banco localmente ou não. 189 + ### Informações do Parâmetros
180 190
181 -## Parâmetros 191 + [**vhost**]
182 192
183 -### Informações do Parâmetros 193 + Domínio que será configurado no vhost ex.: simec.seudominio.gov. **Valor Padrão: simec.dominio.gov.br**
184 194
185 - [**vhost**]  
186 195
187 -Domínio que será configurado no vhost ex.: simec.seudominio.gov. **Valor Padrão: simec.dominio.gov.br**  
188 196
  197 + [**datadir**]
189 198
  199 + Local em que o código será baixado e serão feitos os apontamentos no vhost. **Valor Padrão: /var/www/html/simec**
190 200
191 - [**datadir**]  
192 201
193 -Local em que o código será baixado e serão feitos os apontamentos no vhost. **Valor Padrão: /var/www/html/simec**  
194 202
  203 + [**apacheuser**]
195 204
  205 + Usuário do serviço apache, definido automaticamente pelo facter osfamily caso seja RedHat ou Debian
196 206
197 - [**apacheuser**]  
198 207
199 -Usuário do serviço apache, definido automaticamente pelo facter osfamily caso seja RedHat ou Debian  
200 208
  209 + [**db_username**]
201 210
  211 + Nome do usuário de conexão com o banco de dados. **Valor Padrão: user_simec**
202 212
203 - [**db_username**]  
204 213
205 -Nome do usuário de conexão com o banco de dados. **Valor Padrão: user_simec**  
206 214
  215 + [**db_password**]
207 216
  217 + Senha de conexão com o banco de dados. **Valor Padrão: 841j8K9J67p788x**
208 218
209 - [**db_password**]  
210 219
211 -Senha de conexão com o banco de dados. **Valor Padrão: 841j8K9J67p788x**  
212 220
  221 + [**db_name**]
213 222
  223 + Nome da base de dados. **Valor Padrão: db_simec**
214 224
215 - [**db_name**]  
216 225
217 -Nome da base de dados. **Valor Padrão: db_simec**  
218 226
  227 + [**db_host**]
219 228
  229 + IP ou nome do servidor de banco de dados. **Valor Padrão: $::ipaddress**
220 230
221 - [**db_host**]  
222 231
223 -IP ou nome do servidor de banco de dados. **Valor Padrão: $::ipaddress**  
224 232
  233 + [**db_port**]
225 234
  235 + Porta de Conexão com o servidor de banco de dados. **Valor Padrão: 5432**
226 236
227 - [**db_port**]  
228 237
229 -Porta de Conexão com o servidor de banco de dados. **Valor Padrão: 5432**  
230 238
  239 + [**vcsprovider**]
231 240
  241 + Pacote do Sistema de Controle de Versionamento. **Valor Padrão: git**
232 242
233 - [**vcsprovider**]  
234 243
235 -Pacote do Sistema de Controle de Versionamento. **Valor Padrão: git**  
236 244
  245 + [**repoensure**]
237 246
  247 + Definição se será realizado o download do código via VCSREPO. **Valor Padrão: present** (Fazer Download)
238 248
239 - [**repoensure**]  
240 249
241 -Definição se será realizado o download do código via VCSREPO. **Valor Padrão: present** (Fazer Download)  
242 250
  251 + [**source**]
243 252
  253 + URL do Repositório do código. **Valor padrão: https://softwarepublico.gov.br/gitlab/simec/simec.git**
244 254
245 - [**source**]  
246 255
247 -URL do Repositório do código. **Valor padrão: https://softwarepublico.gov.br/gitlab/simec/simec.git**  
248 256
  257 + [**emails**]
249 258
  259 + Emails configurados no arquivo de configuração principal do SIMEC config.inc para receber informações do sistema.
250 260
251 - [**emails**]  
252 261
253 -Emails configurados no arquivo de configuração principal do SIMEC config.inc para receber informações do sistema.  
254 262
  263 + [**install_db**]
255 264
  265 + Variável booleana para definir se será instalado o banco de dados localmente. **Valor Padrão: false**
256 266
257 - [**install_db**] 267 +
  268 + ### Acesso
258 269
259 -Variável booleana para definir se será instalado o banco de dados localmente. **Valor Padrão: false** 270 + Sistema instalado e o apontamento no DNS para o domínio escolhido ($vhost) ao menos na máquina com o navegador.
260 271
261 -  
262 -### Acesso 272 + Acesso ao endereço no navegador Ex:"http://simec.dominio.gov.br". Carregada a página de login, o sistema solicitará o CPF e a SENHA para acesso.
263 273
264 -Sistema instalado e o apontamento no DNS para o domínio escolhido ($vhost) ao menos na máquina com o navegador.  
265 274
266 -Acesso ao endereço no navegador Ex:"http://simec.dominio.gov.br". Carregada a página de login, o sistema solicitará o CPF e a SENHA para acesso.  
267 275
  276 + Acesso administrativo:
268 277
  278 + **CPF: 86274565426**
269 279
270 -Acesso administrativo: 280 + **Senha: 123456**
271 281
272 -**CPF: 86274565426** 282 + ### Pendente
273 283
274 -**Senha: 123456** 284 + Configuração do módulo para outros Sistemas Operacionais.
275 285
276 -### Pendente 286 + ### Referências
  287 + * https://softwarepublico.gov.br/social/simec/
277 288
278 -Configuração do módulo para outros Sistemas Operacionais.  
279 -  
280 -### Referências  
281 - * https://softwarepublico.gov.br/social/simec/  
282 289