| |[Home](home)|[Sprints](sprints)|[Requisitos](requisitos)|[Arquitetura](arquitetura)|[Configuração](configuracao)|[Mockups](mockups)|[Banco de Dados](banco_dados)|[Instalação](instalacao)|[Deploy](deploy)|[Gerência](gp)|[Time](time)|[Padronização](padronizacao)|[Git Workflow](git)| | ||
| |---|---|---|---|---|---|---|---|---|---|---|---|---| | ||
| # Deploy da API | ||
| Para fazer o deploy da nossa aplicação fizemos uso da plataforma Amazon pela facilidade de uso e quantidade de recursos oferecidos pela empresa. Com isso precisamos possuir uma conta na Amazon Web Services para poder subir a nossa aplicação. | ||
| Para criar uma conta basta acessar o [endereço deste link](https://portal.aws.amazon.com/gp/aws/developer/registration/index.html?refid=em_127222) e criar gratuitamente a sua conta AWS. | ||
| ### Criando conta AWS | ||
| Com a conta criada vamos para a instanciação da nossa máquina EC2, para isso siga os passos a seguir: | ||
| 1. Acesse a sua conta AWS | ||
| 2. Clique no botão "Services" no canto superior esquerdo da tela | ||
| 3. Na aba de "Compute" selecione a opção "EC2" | ||
| 4. Procure na janela que abriu o botão escrito "Launch Instance" | ||
| 5. Agora nós vamos configurar a nossa instancia, utilize a navegação lateral para clicar na opção "AWS Marketplace" | ||
| 6. Com a opção selecionada, procure por "ECS", irão aparecer algumas opções, selecione a "ECS Optimized Amazon Linux 2" | ||
| 7. Na próxima seção iremos escolher o tipo de instância, caso se deseje continuar no nível gratuito, escolha a opção t2.micro e clique em "Review and Launch" | ||
| 8. Clique em "Launch" | ||
| 9. Agora vamos criar (caso já não possua) um par de chave-valor para acessar a nossa instância | ||
| 10. Para clicar no botão "Create a new key pair" para criar uma nova e informar no campo "Key pair name" o nome da sua chave-valor. | ||
| 11. Após configurado faça download do arquivo chave-valor, pois será utilizado para acessar a nossa máquina. | ||
| 12. Para completar selecione "Launch Instance". | ||
| ### Configurando portas de acesso | ||
| Pronto, você acaba de criar uma instância EC2, vamos configurar a segurança para possibilitar que um cliente externo possa acessar a nossa aplicação. Vamos fazer essa configuração agora: | ||
| 1. Na página inicial das instâncias EC2 selecione a máquina que acabamos de criar para alterar o grupo de segurança | ||
| 2. Ao selecionar, apareceu uma janela embaixo com algumas informações detalhadas da máquina, procure por "Security Groups" e clique no nome ao lado que deve estar em azul | ||
| 3. Na parte superior da página, clique em "Actions" e, em seguida, clique em "Edit Inbound Rules". Na caixa de diálogo que se abrir, clique em "Add Rule" | ||
| 4. Defina o intervalo de portas da regra para 3000 e, em "Source", clique no menu suspenso e selecione "Anywhere". O restante deve ser preenchido automaticamente. | ||
| Pronto, definimos regras de acesso à máquina e precisamos configurar a nossa aplicação na máquina, para isso nós vamos precisar acessar a nossa instância: | ||
| Siga os passos a seguir de acordo com a sua plataforma | ||
| #### Linux | ||
| 1. chmod 400 <NAME_OF_KEYPAIR_FILE> | ||
| 2. ssh -i <NAME_OF_KEYPAIR_FILE>ec2-user@<PUBLIC_DNS> | ||
| 3. git clone http://tools.ages.pucrs.br/appoio/backend.git | ||
| 4. docker build . -t backend | ||
| 5. docker run -d -p 3000:3000 backend | ||
| > Note que a porta de acesso do docker mapeia para a porta 3000, ou seja, a porta definida na nossa aplicação deve ser igual a porta informada no docker, neste caso ```3000``` | ||
| #### Windows | ||
| 1. Download da ferramenta putty: | ||
| [Link para download 64-bit](https://the.earth.li/~sgtatham/putty/latest/w64/putty.exe) | ||
| [Link para download 32-bit](https://the.earth.li/~sgtatham/putty/latest/w32/putty.exe) | ||
| 2. Download da ferramenta puttygen: | ||
| [Link para download 64-bit](https://the.earth.li/~sgtatham/putty/latest/w64/puttygen.exe) | ||
| [Link para download 32-bit](https://the.earth.li/~sgtatham/putty/latest/w32/puttygen.exe) | ||
| 3. Utilize a ferramenta puttygen para transformar a nossa chave-valor de .pem para .ppk clicando no botão "Load" e seleciona o arquivo .pem | ||
| 4. Após carregar o arquivo clique em "Save private key" e coloque o nome que quiser | ||
| 5. Agora abra a ferramenta putty e informe no campo "Host Name (or IP address)" o endereço da sua instância, deve ser semelhante a "[email protected]", para dúvidas de acesso navegue até a página da sua máquina e clique no botão "Actions" e em seguida "Connect", nan aba de "SSH" terá o endereço da máquina | ||
| 6. Com o endereço informado, navegue, no putty, para "Connection" > "SSH" > "Auth", não clique em "GSSAPI", clique em "Auth" e no campo "Private key file for authentication" informe o arquivo gerado pelo nosso puttygen | ||
| 7. Com tudo configurado clique em "Open" | ||
| 8. git clone http://tools.ages.pucrs.br/appoio/backend.git | ||
| 9. docker build . -t backend | ||
| 10. docker run -d -p 3000:3000 backend | ||
| Pronto, o backend da nossa aplicação está pronto para ser utilizado | ||
| \ No newline at end of file |