Commit fd46bcc9cdddf57aa7da7a2f7c05c020daac65f6

Authored by Lucas Kanashiro
1 parent 62fd42da

draft of architecture section

Showing 1 changed file with 27 additions and 14 deletions   Show diff stats
OSS-2017/03-architecture.tex
... ... @@ -2,6 +2,8 @@
2 2  
3 3 %TODO: Kanashiro
4 4  
  5 +The SPB platform was deployed in 7 virtual machines with different functions,
  6 +as we can see in Figure \ref{fig:architecture}.
5 7  
6 8 \begin{figure}[hbt]
7 9 \centering
... ... @@ -10,17 +12,28 @@
10 12 \label{fig:architecture}
11 13 \end{figure}
12 14  
13   -O ambiente é composto por 7 máquinas com funções distintas:
14   -
15   -\begin{itemize}
16   -
17   -\item Reverseproxy: Proxy reverso
18   -\item Integration: Segundo proxy reverso, Repositórios Git, Listas de email e Backend final de email
19   -\item Email: Relay de email
20   -\item Social: Servidor de rede social Noosfero
21   -\item Database: Servidor de banco de dados PostgreSQL
22   -\item Mezuro: Servidor de análise de código Mezuro
23   -\item Monitor: Monitoramento de informações dos outros serviços
24   -
25   -\end{itemize}
26   -
  15 +The \textit{reverseproxy} handles the HTTP requests and redirects them to the
  16 +\textit{integration}, the \textit{email} sends and receives e-mails on behalf
  17 +of the platform and the \textit{monitor} keeps the entire environment tracked.
  18 +These three \textit{VMs} mentioned - \textit{reverseproxy}, \textit{email} and
  19 +\textit{monitor} - are accessible via Internet and the other ones are only
  20 +available in the local network created between them.
  21 +
  22 +\textit{Integration} works as a second layer of proxy beneath
  23 +\textit{reverseproxy}, any request to the platform will be handled by it. The
  24 +Colab service provides interface, authentication and search engine integration
  25 +among all the services. When a request is received to a specific service,
  26 +Colab authenticates the user in the target tool, sends the request and makes a
  27 +visual transformation in the HTML page which is the content of the response.
  28 +Another user-oriented feature is the integrated search engine, when the user
  29 +want to find something in the platform Colab will perform the search in the
  30 +whole databases. Colab itself provides a web interface for GNU Mailman and we
  31 +have two others integrated tools in \textit{integration}: Gitlab and Prezento.
  32 +Gitlab provides web interface for Git repositories and issues tracker, and
  33 +Prezento is a front-end for source code static analysis.
  34 +
  35 +The source code static analysis is performed by \textit{mezuro}. It runs some
  36 +static analysis tools on source code stored in repository and provide this data
  37 +to Prezento. A social network and CMS (Content Manager System) is provided by
  38 +Noosfero in \textit{social}, and the databases of all tools with a cache
  39 +service are in \textit{database}.
... ...