Download as
Browse Code »

Commit 165f481e1bffde1591b1e567faa6c2a5631fd889

Authored by Paulo Tada
1 parent 8f39aad6
Exists in master and in 1 other branch mezuro_spb

Update documentation with Mezuro notes

Showing 5 changed files with 38 additions and 12 deletions   Show diff stats
docs/arquitetura.rst.in
  Diff comments   View file @165f481
... ... @@ -14,7 +14,7 @@ máquina, onde são distribuidas para os serviços solicitados. Todos os bancos
14 14 de dados relevantes estão concentrados em uma única máquina e todos os
15 15 emails disparados pelo sistema partem de um mesmo *relay*.
16 16  
17   -O ambiente é composto por 7 máquinas com funções distintas:
  17 +O ambiente é composto por 6 máquinas com funções distintas:
18 18  
19 19 * **Reverseproxy**
20 20  
... ... @@ -47,11 +47,6 @@ O ambiente é composto por 7 máquinas com funções distintas:
47 47 * Servidor de banco de dados PostgreSQL;
48 48  
49 49  
50   -* **Mezuro**
51   -
52   - * Servidor de análise de código Mezuro;
53   -
54   -
55 50 * **Monitor**
56 51  
57 52 * Monitoramento de informações dos outros serviços;
... ... @@ -67,7 +62,7 @@ Conexões na porta 22 da máquina reverseproxy são redirecionadas para integrat
67 62 Todas as máquinas aceitam conexões **ssh** originadas apenas da máquina integration,
68 63 ou seja, não é possível realizar conexões **ssh** nas demais
69 64 máquinas se a conexão não for originada da integration.
70   -As máquinas **email**, **social**, **database** e **mezuro** aceitam conexão **ssh**
  65 +As máquinas **email**, **social** e **database** aceitam conexão **ssh**
71 66 vindas da integration na porta 22 e a reverseproxy em uma porta alternativa,
72 67 especificada no arquivo de configuração
73 68 do ambiente, `config/$SPB_ENV/config.yaml` pelo valor `alt_ssh_port`.
... ...
docs/implantacao.rst.in
  Diff comments   View file @165f481
... ... @@ -175,7 +175,6 @@ O comando acima deve dar o seguinte resultado::
175 175 email ssh
176 176 social ssh
177 177 database ssh
178   - mezuro ssh
179 178 monitor ssh
180 179 reverseproxy ssh
181 180  
... ... @@ -217,8 +216,6 @@ parecido com o seguinte::
217 216 social: Qui Mai 14 18:59:24 BRT 2015
218 217 database: $ sudo date
219 218 database: Qui Mai 14 18:59:27 BRT 2015
220   - mezuro: $ sudo date
221   - mezuro: Qui Mai 14 18:59:24 BRT 2015
222 219 monitor: $ sudo date
223 220 monitor: Qui Mai 14 18:59:25 BRT 2015
224 221 reverseproxy: $ sudo date
... ... @@ -337,7 +334,6 @@ atualização em ambientes especificos, por meio dos comandos abaixo:
337 334 * Atualizar a integration: rake converge:social SPB_ENV=homologa
338 335 * Atualizar a email: rake converge:email SPB_ENV=homologa
339 336 * Atualizar a database: rake converge:database SPB_ENV=homolga
340   - * Atualizar a mezuro: rake converge:mezuro SPB_ENV=homolga
341 337 * Atualizar a monitor: rake converge:monitor SPB_ENV=homolga
342 338 * Atualizar a reverseproxy: rake converge:reverseproxy SPB_ENV=homologa
343 339  
... ...
docs/index.rst.in
  Diff comments   View file @165f481
... ... @@ -14,3 +14,4 @@ Software Público Brasileiro: Manual de Operação (@@SPB_ENV@@)
14 14 apoio
15 15 busca_global
16 16 pacotes
  17 + mezuro
... ...
docs/introducao.rst.in
  Diff comments   View file @165f481
... ... @@ -48,8 +48,17 @@ consistente.
48 48  
49 49 .. _`GNU Mailman`: http://www.gnu.org/software/mailman/
50 50  
  51 +* O Mezuro_ é uma plataforma web livre para avaliação colaborativa de código
  52 + fonte. Aqui você pode avaliar seu código fonte com os SCMs mais populares
  53 + (como Git e SVN), apenas fornecendo sua URL. Por enquanto, você pode
  54 + avaliar códigos em C, C++, Java, Ruby, Python e PHP mas nós pretendemos
  55 + dar suporte a mais linguagens no futuro.
  56 + **Nota**: nas configurações atuais do SPB, o Mezuro não está incluso. Leia
  57 + :doc:`/mezuro`.
  58 +
  59 +.. _Mezuro: http://mezuro.org/
  60 +
51 61 O restando deste manual descreve a arquitetura do SPB bem como os
52 62 procedimentos necessários para sua implantação, manutenção, backup e
53 63 restauração e gestão de firewall.
54 64  
55   -
... ...
docs/mezuro.rst.in 0 → 100644
  Diff comments   View file @165f481
... ... @@ -0,0 +1,25 @@
  1 +Mezuro
  2 +==========
  3 +
  4 +O Mezuro no ambiente do SPB foi adicionado em suas últimas release.
  5 +A integração e funcionamento foi validado pela equipe de desenvolvimento.
  6 +Entretanto não foi colocado em produção. Há uma versão do SPB com a adição
  7 +do Mezuro em uma branch separada `mezuro_spb`_. O converge a partir desta branch
  8 +e com a devida máquina disponível no ambiente, é possível subir a instancia do
  9 +SPB com a integração do Mezuro.
  10 +
  11 +.. _`mezuro_spb`:
  12 +
  13 +Disponibilização das Máquinas
  14 +---------------------------------
  15 +
  16 +A configuração da arquitetura do SPB muda com a adição do Mezuro. É necessário
  17 +uma máquina dedicada para o serviço. Os três componentes principais do Mezuro
  18 +são: kalibro processor, kalibro configurations e prezento. Ambos os kalibros
  19 +são implantados na máquina `mezuro` e são responsáveis pela coleta das métricas
  20 +de códigos disponíveis nos projetos. O prezento é implantado na máquina
  21 +integration e é responsável pela interface gráfica de interação com o usuário.
  22 +
  23 +A comunicação entre os componentes é feito por webserver, ou seja, os kalibros
  24 +disponibilizam as métricas por serviços TCP port 80 para o componente prezento
  25 +realizar a apresentação dos dados.
... ...