update documentation

Antonio Terceiro
1 parent 2e5cf813
Showing 1 changed file with 34 additions and 1 deletions Show diff stats
docs/implantacao.rst.in
@@ -56,11 +56,31 @@ Preparação dos servidores
 * Os servidores precisam estar acessíveis por SSH. Caso necessário,
   podem ser feitas configurações do SSH em
   ``config/@@SPB_ENV@@/ssh_config`` para isso.
+
 * O usuário que vai conectar via SSH nos servidores precisa:
  
-  * ter acesso SSH configurado via chave SSH para evitar digitar senha.
   * ter permissão de usar ``sudo`` sem a necessidade de digitar senha.
  
+  * ter acesso SSH configurado via chave SSH para evitar digitar senha,
+    a partir da estação de trabalho utilizada. Ou seja, a chave pública
+    SSH **da estação de trabalho** deve ser copiada para cada servidor,
+    e.g.::
+
+    $ ssh-copy-id reverseproxy
+    $ ssh-copy-id integration
+    $ ssh-copy-id social
+    $ ssh-copy-id database
+    $ ssh-copy-id email
+
+* O ``sudo`` não deve estar configurado com a opção ``requiretty``. Se
+  houver uma linha como a seguinte em ``/etc/sudoers``, ela deve ser
+  removida (ou comentada, como preferir)::
+
+    $ Defaults requiretty
+
+* A máquina ``integration`` precisa ter o utilitário ``netcat``. No
+  CentOS 7, pode ser instalado o pacote ``nmap-ncat``.
+
 Configuração do ambiente alvo
 -----------------------------
  
@@ -233,3 +253,16 @@ muito mais simples::
  
 Todas as possibilidades de comandos serão listados se você executar
 ``rake -T``. Consulte também a documentação do chake_.
+
+
+Atualizações
+------------
+
+Para atualizar o sistema, primeiro atualize o repositório de gestão de
+configuração::
+
+    $ git pull
+
+Após isso, basta executar o comando ``converge`` novamente::
+
+    $ rake converge SPB_ENV=@@SPB_ENV@@
...	...	@@ -56,11 +56,31 @@ Preparação dos servidores
56	56	* Os servidores precisam estar acessíveis por SSH. Caso necessário,
57	57	podem ser feitas configurações do SSH em
58	58	``config/@@SPB_ENV@@/ssh_config`` para isso.
	59	+
59	60	* O usuário que vai conectar via SSH nos servidores precisa:
60	61
61		- * ter acesso SSH configurado via chave SSH para evitar digitar senha.
62	62	* ter permissão de usar ``sudo`` sem a necessidade de digitar senha.
63	63
	64	+ * ter acesso SSH configurado via chave SSH para evitar digitar senha,
	65	+ a partir da estação de trabalho utilizada. Ou seja, a chave pública
	66	+ SSH da estação de trabalho deve ser copiada para cada servidor,
	67	+ e.g.::
	68	+
	69	+ $ ssh-copy-id reverseproxy
	70	+ $ ssh-copy-id integration
	71	+ $ ssh-copy-id social
	72	+ $ ssh-copy-id database
	73	+ $ ssh-copy-id email
	74	+
	75	+* O ``sudo`` não deve estar configurado com a opção ``requiretty``. Se
	76	+ houver uma linha como a seguinte em ``/etc/sudoers``, ela deve ser
	77	+ removida (ou comentada, como preferir)::
	78	+
	79	+ $ Defaults requiretty
	80	+
	81	+* A máquina ``integration`` precisa ter o utilitário ``netcat``. No
	82	+ CentOS 7, pode ser instalado o pacote ``nmap-ncat``.
	83	+
64	84	Configuração do ambiente alvo
65	85	-----------------------------
66	86
...	...	@@ -233,3 +253,16 @@ muito mais simples::
233	253
234	254	Todas as possibilidades de comandos serão listados se você executar
235	255	``rake -T``. Consulte também a documentação do chake_.
	256	+
	257	+
	258	+Atualizações
	259	+------------
	260	+
	261	+Para atualizar o sistema, primeiro atualize o repositório de gestão de
	262	+configuração::
	263	+
	264	+ $ git pull
	265	+
	266	+Após isso, basta executar o comando ``converge`` novamente::
	267	+
	268	+ $ rake converge SPB_ENV=@@SPB_ENV@@
...	...