https://github.com/ingriidssantoss/projeto_devops

Projeto de automação de infraestrutura com Terraform, configurando uma instância EC2 na AWS com Nginx. Inclui provisionamento automatizado de rede, segurança e personalização do servidor web como parte de um desafio de DevOps.
https://github.com/ingriidssantoss/projeto_devops

automacao aws cloud devops ec2 iac infraestrutura nginx terraform

Last synced: 3 months ago
JSON representation

Projeto de automação de infraestrutura com Terraform, configurando uma instância EC2 na AWS com Nginx. Inclui provisionamento automatizado de rede, segurança e personalização do servidor web como parte de um desafio de DevOps.

• Host: GitHub
• URL: https://github.com/ingriidssantoss/projeto_devops
• Owner: ingriidssantoss
• Created: 2024-10-19T04:54:36.000Z (over 1 year ago)
• Default Branch: master
• Last Pushed: 2024-10-20T21:00:32.000Z (over 1 year ago)
• Last Synced: 2025-03-27T05:33:49.642Z (about 1 year ago)
• Topics: automacao, aws, cloud, devops, ec2, iac, infraestrutura, nginx, terraform
• Language: HCL
• Homepage:
• Size: 188 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
## Análise Técnica do Código Terraform

### ○ Leitura do Arquivo

Primeiro, estudei o arquivo `main.tf` fornecido. O código original tinha como objetivo provisionar uma infraestrutura básica na AWS usando o Terraform, criando recursos essenciais para configurar um ambiente seguro e funcional.

### ○ Descrição Técnica

O código `main.tf` realiza as seguintes operações:

- **Provider AWS**: Define a região onde os recursos serão provisionados (`us-east-1`).

- **Variáveis**: Contém variáveis para o nome do projeto e do candidato, permitindo personalizar os nomes dos recursos.

- **TLS Private Key**: Gera uma chave privada para ser usada na criação de um par de chaves EC2, permitindo o acesso SSH à instância.

- **VPC e Subnet**: Cria uma VPC (`10.0.0.0/16`) e uma Subnet (`10.0.1.0/24`) associada para isolar a rede.

- **Internet Gateway e Route Table**: Configura um gateway de internet e associa uma tabela de rotas para permitir o tráfego externo.

- **Security Group**: Permite o tráfego SSH e HTTP de qualquer origem.

- **Instância EC2**: Cria uma instância EC2 utilizando uma AMI do Debian 12, do tipo `t2.micro`.

- **Outputs**: Exibe a chave privada gerada e o endereço IP público da instância.

### ○ Observações

- A configuração de segurança permitia tráfego SSH e HTTP de qualquer origem, o que poderia ser melhorado para restringir o acesso.

- A instalação do Nginx não era automatizada, exigindo configuração manual na instância após a criação.

---

## Modificação e Melhoria do Código Terraform

### ○ Aplicação de Melhorias de Segurança

- **Restrição de Acesso SSH**: Modifiquei o código do Security Group para permitir tráfego SSH apenas do meu IP público específico, restringindo o acesso à instância.

  ```hcl

  ingress {

    description = "Allow SSH from my IP"

    from_port   = 22

    to_port     = 22

    protocol    = "tcp"

    cidr_blocks = ["191.57.168.63/32"]

  }

![Modificação do Security Group](imagens/security-group-settings.png)

### ○ Pré-requisitos

Para executar este projeto, eu precisei garantir que alguns pré-requisitos estivessem atendidos:

1. **Terraform**: Certifiquei-me de que o Terraform estava instalado em minha máquina local.

2. **AWS CLI**: Configurei o AWS CLI com as credenciais da minha conta AWS.

3. **Chave de Acesso e Secreta da AWS**: Utilizei uma chave de acesso (`Access Key ID`) e uma chave secreta (`Secret Access Key`) para configurar o AWS CLI.

### ○ Configuração do Ambiente

1. **Configuração do AWS CLI**:

   - No terminal, eu executei o seguinte comando para configurar o AWS CLI:

     ```bash

     aws configure

     ```

   - Inserindo as informações solicitadas:

     - **AWS Access Key ID**: Minha chave de acesso.

     - **AWS Secret Access Key**: Minha chave secreta.

     - **Default region name**: `us-east-1`

     - **Default output format**: `json`

     ### ○ Inicializando o Terraform

1. **Inicialização do Terraform**:

   - No diretório do projeto, inicializei o Terraform com o comando:

     ```bash

     terraform init

     ```

   - Esse comando baixou os plugins necessários e configurou o ambiente para o uso do Terraform.

2. **Revisão do Plano de Execução**:

   - Para verificar o plano de execução e os recursos que seriam criados, usei:

     ```bash

     terraform plan

     ```

   - Analisei a saída para confirmar que todos os recursos estavam corretos antes de prosseguir.

3. **Aplicação da Configuração do Terraform**:

   - Para provisionar a infraestrutura, apliquei o plano com:

     ```bash

     terraform apply

     ```

   - Quando solicitado, confirmei a execução digitando "yes". Isso criou os recursos especificados no arquivo `main.tf`, incluindo VPC, Subnet, Security Group, Key Pair e a instância EC2 com o Nginx instalado.

   ![Resultado concluído do Apply](imagens/terraform-apply-output.png)

### ○ Acesso à Instância EC2

1. **Obtenção do Endereço IP Público**:

   - Depois de executar o `terraform apply`, o Terraform exibiu o endereço IP público da instância EC2. Anotei esse IP para poder acessar a instância.

2. **Conexão à Instância EC2 via SSH**:

   - Para me conectar à instância via SSH, utilizei o seguinte comando, substituindo `` pelo IP público da minha instância:

     ```bash

     ssh -i my-key.pem admin@

     ```

    ![Resumo da Instância EC2](imagens/ec2-instance-summary.png)

3. **Verificação do Status do Nginx**:

   - Após a conexão, verifiquei se o Nginx estava ativo e em execução com:

     ```bash

     sudo systemctl status nginx

     ```

   - Caso não estivesse rodando, usei o comando para iniciá-lo:

     ```bash

     sudo systemctl start nginx

     ```

### ○ Acessando o Nginx pelo Navegador

1. **Acesso à Página Personalizada**:

   - Abri um navegador web e digitei o IP público da instância EC2 na barra de endereços:

     ```

     http://3.89.100.77/

     ```

   - Isso carregou a página personalizada do Nginx, que eu configurei para exibir as informações do desafio.

   ![Resultado da Página Personalizada do Nginx](imagens/nginx-welcome.png)

## Conclusão

Neste desafio de DevOps para a VExpenses, consegui provisionar uma infraestrutura automatizada na AWS usando Terraform, com o objetivo de configurar um ambiente seguro e funcional. Durante o processo, realizei as seguintes atividades:

1. **Análise e melhorias no código Terraform original**: Adicionei melhorias de segurança, como a restrição de acesso SSH para um endereço IP específico, e automatizei a instalação do Nginx usando um script `user_data`, garantindo que o servidor estivesse disponível assim que a instância EC2 fosse provisionada.

2. **Automatização de processos**: O uso do `user_data` para configurar o Nginx automaticamente eliminou a necessidade de configurações manuais pós-criação, reduzindo a margem para erros. A personalização da página inicial do Nginx foi feita para fornecer uma mensagem específica para o desafio, destacando as tecnologias utilizadas e detalhes do projeto.

3. **Configuração de segurança**: A política de segurança foi aprimorada ao restringir o tráfego SSH e garantir que o acesso fosse feito apenas por fontes autorizadas.

4. **Entrega final**: Com a instância EC2 em execução e o Nginx configurado, o projeto foi concluído com sucesso. A página personalizada está disponível para acesso, confirmando que os recursos foram provisionados e configurados corretamente.

## Disponibilidade dos Arquivos

Os arquivos do projeto estão disponíveis no repositório GitHub. Eles incluem:

- `main.tf`: O arquivo Terraform que define toda a infraestrutura, com as melhorias de segurança e automação implementadas.

- `index.nginx-debian.html`: O arquivo HTML personalizado que foi configurado na instância EC2 para exibir a mensagem do desafio.

## Autor 

Esse projeto foi desenvolvido por Ingrid Lauanne Leite dos Santos.