Visão geral e pré-requisitos

A instalacao da Hotwallets acontece em duas partes:

1. o ambiente principal, que sobe os servicos centrais da plataforma;
2. o cosigner, que roda separado e protege operacoes sensiveis.

O que sera instalado

No ambiente principal, os componentes mais relevantes sao:

• Frontend admin Interface visual da plataforma.
• API Servico responsavel por receber requisicoes e executar regras da aplicacao.
• Banco de dados Armazena os dados persistidos da plataforma.
• Message broker Faz a troca de mensagens entre servicos internos.
• Signer Participa do processamento das operacoes sensiveis.
• Cosigner Componente separado, instalado em outra maquina, usado na camada de seguranca das assinaturas.

Glossario rapido

• Docker Plataforma usada para executar os servicos da aplicacao em containers.
• Container Unidade isolada usada para executar um servico.
• EC2 Maquina virtual da AWS.
• IAM Role Identidade da AWS usada para dar permissao de acesso a recursos.
• ARN Identificador textual de um recurso na AWS.
• S3 Servico de armazenamento de arquivos da AWS.
• KMS Servico da AWS usado para gerenciamento de chaves criptograficas.
• Nitro Enclaves Recurso de isolamento da AWS usado pelo cosigner.

Ordem recomendada

Siga esta ordem:

1. conferir os pre-requisitos;
2. preparar o ambiente principal;
3. subir os servicos principais;
4. validar o acesso inicial;
5. preparar a AWS para o cosigner;
6. instalar o cosigner na EC2 separada;
7. validar os servicos do cosigner.

Antes de comecar

Antes de iniciar, confirme que voce ja tem:

• uma maquina ou servidor para instalar o ambiente principal da Hotwallets;
• Docker e Docker Compose funcionando nessa maquina;
• os arquivos, imagens ou pacotes de instalacao enviados pela equipe da Hotwallets;
• uma instancia EC2, caso a entrega inclua cosigner separado;
• acesso para executar comandos na maquina principal e, se necessario, na EC2 do cosigner;
• acesso ao console da AWS com permissao para criar IAM Role, bucket S3, chave KMS e instancia EC2, quando houver cosigner.

O que precisa estar em maos

Antes de seguir para a execucao, confirme estes itens:

• pacote ou repositorio da instalacao principal;
• instrucoes ou artefatos do cosigner, quando esse componente fizer parte da entrega;
• acessos de rede, terminal e credenciais necessarias;
• definicao de qual maquina sera usada como ambiente principal;
• definicao de quantos cosigners serao instalados no ambiente.

Como saber se voce pode seguir

Voce pode avancar para a proxima etapa quando:

• todos os acessos ja estiverem disponiveis;
• a maquina principal estiver pronta para executar Docker;
• a necessidade de cosigner estiver confirmada;
• os arquivos de instalacao tiverem sido recebidos.

Se algum desses itens ainda nao estiver disponivel, pare nesta etapa e resolva a dependencia antes de continuar.