Commit 07e70955769dbcf17381545ee7eee9a3e7f8379c

Authored by Sergio Oliveira
2 parents 3494328a 29fcfaaa

Merge branch 'master' of portal.softwarepublico.gov.br:softwarepublico/softwarepublico

Showing 2 changed files with 42 additions and 4 deletions   Show diff stats
docs/backup.rst.in
... ... @@ -19,6 +19,10 @@ Esta operação vai copiar arquivos e *dumps* dos bancos de dados do
19 19 Noosfero, GitLab, Colab e Mailman, e copiá-los para um subdiretório
20 20 chamado ``backups`` na sua estação de trabalho.
21 21  
  22 +Toda vez que o procedimento de backup é executado, o diretório ``backups`` é removido no início do procedimento, de modo que não se deve armazenar os backups obtidos em tal diretório.
  23 +
  24 +Note que o comando para resgatar os backups, especificado acima, apenas copia arquivos das máquinas ``integration`` e ``social`` para sua estação de trabalho. Os backups são realizados em tais servidores utilizando o ``rsnapshot``, e podem ser encontrados no diretório ``/.snapshots`` em cada um dos servidores mencionados.
  25 +
22 26 Procedimento de restauração
23 27 ---------------------------
24 28  
... ...
docs/implantacao.rst.in
... ... @@ -260,14 +260,25 @@ Todas as possibilidades de comandos serão listados se você executar
260 260 Atualizações
261 261 ------------
262 262  
263   -Para atualizar o sistema, primeiro atualize o repositório de gestão de
264   -configuração::
  263 +O primeiro passo para realizar a atualização do ambiente consiste em entrar
  264 +na pasta do repositório de configuração. Em caso de dúvida, veja a seção
  265 +"Obtendo o Repositório de Configuração".
265 266  
  267 +Em seguida atualize o repositório de gestão de configuração com o comando
  268 +abaixo::
  269 +
  270 + $ cd /diretorio/deconfiguracao/softwarepublico
266 271 $ git pull
267 272  
268   -Após isso, basta executar o comando ``converge`` novamente::
  273 +Após isso, basta executar o comando ``converge`` novamente no ambiente
  274 +especifico::
269 275  
270   - $ rake converge SPB_ENV=@@SPB_ENV@@
  276 + $ rake converge SPB_ENV=[Ambiente Especifico]
  277 +
  278 +Repare que ``SPB_ENV``, assume os seguintes valores de acordo com o ambiente
  279 +que será atualizado. Logo, se você deseja atualizar o ambiente de homologação
  280 +use ``SPB_ENV=homologa``. Se você deseja atualizar o ambiente de produção, use
  281 +``SPB_ENV=prod``.
271 282  
272 283 Caso após a atualização o noosfero não funcionar corretamente, provavelmente
273 284 um erro de *'502 Bad Gateway'* irá aparecer, reinicie o ambiente social::
... ... @@ -276,3 +287,26 @@ um erro de *'502 Bad Gateway'* irá aparecer, reinicie o ambiente social::
276 287 $ sudo shutdown -r
277 288  
278 289 Aguarde o ambiente reiniciar, e atualize a pagina.
  290 +
  291 +Atualizações pontuais
  292 +---------------------
  293 +
  294 +Algumas vezes é preciso fazer atualizações em apenas um dos ambientes, como
  295 +por exemplo, aplicar uma correção de bug. Tais correções/atualizações podem
  296 +não precisar convergir o ambiente inteiro. Neste caso é possível fazer a
  297 +atualização em ambientes especificos, por meio dos comandos abaixo:
  298 +
  299 + * Atualizar a social: rake converge:social SPB_ENV=homologa
  300 + * Atualizar a integration: rake converge:social SPB_ENV=homologa
  301 + * Atualizar a email: rake converge:email SPB_ENV=homologa
  302 + * Atualizar a database: rake converge:database SPB_ENV=homolga
  303 + * Atualizar a reverseproxy: rake converge:reverseproxy SPB_ENV=homologa
  304 +
  305 +> Atenção: Estes comandos devem ser executados dentro da pasta
  306 +"softwarepublico", previamente clonada do repositório. Em caso de dúvida
  307 +consulte a seção "Obtendo o Repositório de Configuração".
  308 +
  309 +Lembrando que a variável SPB_ENV, assume o valor do ambiente em que será
  310 +executado a atulização. Logo, se você estiver querendo atualizar o ambiente
  311 +de homologação então use SPB_ENV=homologa, caso você deseje atualizar o
  312 +ambiente de produção utilize SPB_ENV=prod.
... ...