Commit 2c35f52c19dd8616e92fdc3e93f370f7dafc8382

Authored by Paulo Tada
1 parent 136dcf09
Exists in master and in 1 other branch mezuro_spb

Updating doc: "apoio" and "implantacao"

Showing 2 changed files with 47 additions and 3 deletions   Show diff stats
docs/apoio.rst.in
... ... @@ -2,6 +2,23 @@ Documentação de Apoio
2 2 =====================
3 3 .. _referencia:
4 4  
  5 +Configuração de Usuário
  6 +---------------
  7 +
  8 +Para a criação de usuário utilize (o comando deve ser executado por um
  9 +usuário com permissão sudo)::
  10 +
  11 + # adduser <NOME DO USUÁRIO>
  12 +
  13 +Edite o arquivo de sudoers com o comando::
  14 +
  15 + # visudo
  16 +
  17 +Adicione a linha no arquivo::
  18 +
  19 + <NOME DO USUÁRIO> ALL=(ALL:ALL) NOPASSWD:ALL
  20 +
  21 +
5 22 Gerar Chave SSH
6 23 ---------------
7 24 Antes de gerar a chave SSH, verifique se o seu sistema já não possui uma chave::
... ...
docs/implantacao.rst.in
... ... @@ -12,8 +12,8 @@ equivalentes estejam instalados.
12 12  
13 13 As seguintes ferramentas serão necessárias:
14 14  
15   -* git_: ferramenta de controle de versão.
16   -* chake_: ferramenta de gestão de configuração. Version 0.13 ou maior.
  15 +* git_: ferramenta de controle de versão;
  16 +* chake_: ferramenta de gestão de configuração. Version 0.13 ou maior;
17 17 * python-sphinx_: ferramenta para gerar documentação HTML.
18 18  
19 19 .. _chake: https://gitlab.com/terceiro/chake
... ... @@ -34,6 +34,32 @@ Além dessas ferramentas, será necessário um emulador de terminal. O
34 34 emulador de terminal padrão do seu ambiente de trabalho, ou qualquer
35 35 outro, vai servir.
36 36  
  37 +**Nota Sphinx**: em alguns casos é necessário configurar as variáveis de ambientes
  38 +`LANGUAGE`, `LANG` e `LC_ALL` para `pt_BR.UTF-8` como::
  39 +
  40 + $ export LANG=pt_BR.UTF-8
  41 + $ export LC_ALL=pt_BR.UTF-8
  42 + $ export LANGUAGE=pt_BR.UTF-8
  43 +
  44 +Para as máquinas do ambiente é necessário as seguintes dependências:
  45 +
  46 +* rsync_: ferramenta de sincronização de arquivos;
  47 +* wget_: ferramenta de download de arquivos via terminal;
  48 +* netcat_: farramenta com utilitários para escrita e leitura de dados por TCP/IP.
  49 +
  50 +.. _rsync: https://rsync.samba.org/
  51 +.. _wget: https://www.gnu.org/software/wget/
  52 +.. _netcat: http://netcat.sourceforge.net/
  53 +
  54 +Para instalar em Debian/Ubuntu::
  55 +
  56 + $ sudo apt-get install rsync wget nc
  57 +
  58 +As máquinas também deve estar com o SELinux habilitado e em modo `permissive`.
  59 +Para isso, altere o arquivo `/etc/sysconfig/selinux` e altere a variável `SELINUX`
  60 +para permissive. Se necessário reinicie a máquina.
  61 +
  62 +
37 63 Obtendo o repositório de configuração
38 64 -------------------------------------
39 65  
... ... @@ -59,7 +85,8 @@ Preparação dos servidores
59 85  
60 86 * O usuário que vai conectar via SSH nos servidores precisa:
61 87  
62   - * ter permissão de usar ``sudo`` sem a necessidade de digitar senha.
  88 + * ter permissão de usar ``sudo`` sem a necessidade de digitar senha,
  89 + veja a :doc:`/apoio`.
63 90  
64 91 * ter acesso SSH configurado via chave SSH para evitar digitar senha,
65 92 a partir da estação de trabalho utilizada. Ou seja, a chave pública
... ...