Cloud

Documentação para começar a trabalhar no projeto no cloud da iTFlex.

O código backend do projeto cloud se encontra no repositório itflex no diretório cloud/src/python.

Primeiros passos

Antes de executar o projeto pela primeira vez é necessário executar os seguintes passos:

Adicionar os arquivos do certificado default no diretório /etc/pki/itflex. Os arquivos necessários são ca.crt, default.crt e default.key.
Criar arquivo services.env para utilizar o docker-compose

# cdm
mkdir compose/cdm/envs
touch compose/cdm/envs/services.env

Instalação de dependências

No diretório cloud/src/python criar o ambiente virtual e intalar as dependências.

# no diretório cloud/src/python
cd cloud/src/python
python3.6 -m venv venv
venv_activate

pip install -r requirements.txt
pip install -r dev_requirements.txt

Executar o projeto localmente

Executar os comandos no diretório /cloud/].

Fazer a construção/build dos pacotes.

Você pode escolher uma das opções abaixo, isso irá depender do propósito da execução.

# build geral
make build

# build dos pacotes base
make bases.build

# build dos pacotes dos serviços
make services.build

# build dos pacotes frontend
make frontend.build

# build dos pacotes do cdm
make cdm.build

Rodar o projeto

# executa o cdm
make cdm.run

# destrói os containers do cdm
make cdm.stop

É possível acessar a aplciação pelo https://localhost:443 utilizando o usuário admin e senha admin.

Parando um container para executar com o script python

Se você quiser executar o backend se usar o container cdm_infra-apigateway você pode executar o seguinte comando:

# parar container 
docker stop cdm_infra-apigateway_1

# rodar o projeto python localmente sem container
cd /cloud/src/python
sudo ./run.sh

Utilizando a ferramenta CLI

Para utilizar a ferramenta CLI basta estar no diretório /cloud/src/python com o ambiente virtual ativo e executar os seguintes comandos, lembrese que o namespace é opcional:

# python -m itflex_cli user@host:port namespace

python -m itflex_cli admin@localhost:8000 itflex

Caso queira utilizar o namespace é necessário editar o método main do arquivo cloud/src/python/itflex_cli/__init__.py. É necessário alterar o host (linha 148) de host = "https://" + host para host = "http://" + host.

Rodar documentação das APIs

Para rodar a documentação das APIs basta executar o scrip abaixo e acessar a URL dada.

# script localizado em /cloud/src/python
./run_docs.sh

Caso queira acessar alguma documentação já mergeada acesse https://localhost/api/docs