<?xml version="1.0" encoding="UTF-8"?><rss xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom" version="2.0" xmlns:cc="http://cyber.law.harvard.edu/rss/creativeCommonsRssModule.html">
    <channel>
        <title><![CDATA[Stories by Marcelo Palenzuela on Medium]]></title>
        <description><![CDATA[Stories by Marcelo Palenzuela on Medium]]></description>
        <link>https://medium.com/@marcelopalenzuela?source=rss-a209874e5d6a------2</link>
        <image>
            <url>https://cdn-images-1.medium.com/fit/c/150/150/1*jhaAZny8jhv0nj_wR3YiQQ.jpeg</url>
            <title>Stories by Marcelo Palenzuela on Medium</title>
            <link>https://medium.com/@marcelopalenzuela?source=rss-a209874e5d6a------2</link>
        </image>
        <generator>Medium</generator>
        <lastBuildDate>Sun, 22 Nov 2026 21:19:35 GMT</lastBuildDate>
        <atom:link href="https://medium.com/@marcelopalenzuela/feed" rel="self" type="application/rss+xml"/>
        <webMaster><![CDATA[yourfriends@medium.com]]></webMaster>
        <atom:link href="http://medium.superfeedr.com/" rel="hub"/>
        <item>
            <title><![CDATA[CDN com Amazon CloudFront e Origem Protegida]]></title>
            <link>https://marcelopalenzuela.medium.com/cdn-com-amazon-cloudfront-e-origem-protegida-aef0c708cb58?source=rss-a209874e5d6a------2</link>
            <guid isPermaLink="false">https://medium.com/p/aef0c708cb58</guid>
            <category><![CDATA[aws]]></category>
            <category><![CDATA[aws-load-balancer]]></category>
            <category><![CDATA[aws-cloudfront]]></category>
            <category><![CDATA[content-delivery-network]]></category>
            <category><![CDATA[aws-certificate-manager]]></category>
            <dc:creator><![CDATA[Marcelo Palenzuela]]></dc:creator>
            <pubDate>Thu, 19 Nov 2026 23:12:19 GMT</pubDate>
            <atom:updated>2026-11-19T23:31:27.525Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*7xp9LJuTOHy9WBesYh5xUA.png" /></figure><p>Este artigo documenta a inclusão de uma CDN (Content Delivery Network) na frente de uma aplicação containerizada já publicada na AWS, usando o Amazon CloudFront.</p><p>Nesta evolução, o usuário acessa o domínio do CDN, gerenciado no Route 53; o CloudFront, com certificado do AWS Certificate Manager (ACM), encaminha as requisições ao Application Load Balancer (ALB) exclusivamente por HTTPS; e o Security Group do ALB aceita HTTPS somente a partir da managed prefix list do CloudFront.</p><h3>Ponto de partida: o ambiente anterior</h3><p>Esta etapa é uma evolução do ambiente descrito no artigo “Alta Disponibilidade e CI/CD no Amazon ECS com Kiro”, que pode ser lido na íntegra aqui:</p><p><a href="https://marcelopalenzuela.medium.com/alta-disponibilidade-e-ci-cd-no-amazon-ecs-com-kiro-7541cd30c9b6">https://medium.com/r/?url=https%3A%2F%2Fmarcelopalenzuela.medium.com%2Falta-disponibilidade-e-ci-cd-no-amazon-ecs-com-kiro-7541cd30c9b6</a></p><p>Em resumo, aquele ambiente é uma aplicação containerizada em alta disponibilidade: um cluster Amazon ECS com tasks distribuídas em duas Availability Zones, atrás de um Application Load Balancer (ALB) que roteia o tráfego por host-header para os Target Groups de produção e dev. Os domínios são gerenciados no Route 53, com certificados HTTPS do ACM, banco de dados no Amazon RDS com PostgreSQL, imagens versionadas no Amazon ECR e deploy automatizado por pipeline CI/CD (AWS CodePipeline e AWS CodeBuild), com rolling update sem downtime.</p><p>Nesse ambiente, o usuário acessava a aplicação diretamente pelo endereço do ALB, que ficava exposto à Internet. A evolução consistiu em criar uma distribution do CloudFront com o ALB como origem, medir o efeito na latência e, por fim, restringir a origem para que ela receba tráfego apenas do CDN.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*nrhvj6uUWk6-AnNtRl6UEw.png" /></figure><p>Segue abaixo os passos executados para chegarmos ao resultado final desejado:</p><p><strong>1. Plano de preço:</strong> Escolha do plano da distribution no console do CloudFront.</p><p>Ao criar a distribution, o console pede a escolha entre planos de preço fixo (flat-rate) e pay-as-you-go. Neste projeto foi escolhido o pay-as-you-go: o free tier do CloudFront, exibido na própria tela, inclui 1 TB de transferência de saída e 10 milhões de requisições por mês, compartilhados entre todas as distributions da conta. Para comparação, sem o CloudFront a transferência de saída direta das regiões da AWS tem free tier de 100 GB por mês.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*wIksSu3jusu1LAWZskK1VA.png" /></figure><p><strong>2. Nome, tipo e domínio:</strong> Distribution de configuração única (single website) com domínio próprio gerenciado no Route 53.</p><p>Informe o nome da distribution e o domínio que será servido por ela. Como o domínio está hospedado no Route 53 da mesma conta, o console o reconhece e se oferece para gerenciar o DNS automaticamente.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*zZGxgCAT1ApOVoXRSst95A.png" /></figure><p><strong>3. Origem:</strong> Application Load Balancer como origem, com as configurações recomendadas.</p><p>Selecione o tipo de origem Elastic Load Balancer e informe o endereço (DNS) do ALB. Em seguida, mantenha as configurações recomendadas de origem e de cache para conteúdo servido por ELB; elas podem ser ajustadas depois que a distribution for criada.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*gAFNdLZDnxU8ns3SAKEQcg.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*W8wVIw6qmjgPRfWD9flBMw.png" /></figure><p><strong>4. Segurança:</strong> Opção de proteção com AWS WAF.</p><p>O console oferece habilitar proteções do AWS WAF na criação. Neste ambiente de testes, a opção foi mantida desabilitada.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*ZnO_f4SRG1fkCylyXrRXPg.png" /></figure><p><strong>5. Certificado TLS:</strong> Certificado wildcard do ACM reutilizado.</p><p>O CloudFront exige um certificado do ACM para servir HTTPS no domínio próprio. Foi reaproveitado o certificado wildcard (válido para qualquer subdomínio do domínio principal) já emitido no ACM na região us-east-1.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*tG4wgGurALUFRWwiYQrURA.png" /></figure><p><strong>6. Revisão e DNS:</strong> Criação da distribution e dos registros A e AAAA no Route 53.</p><p>Revise as configurações antes de criar. Após a criação, o CloudFront apresenta os registros DNS necessários (A e AAAA, apontando para o endereço da distribution) e se oferece para criá-los automaticamente no Route 53.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*bDWLE3zAfO1pgRGQ8Kbz7w.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/746/1*vh8-xwy__rOYMS8-v6Nqog.png" /></figure><p><strong>7. Validação do acesso pelo CDN:</strong> Aplicação respondendo pelo domínio do CDN.</p><p>Com os registros propagados, a aplicação passa a responder pelo domínio do CDN. Na tela abaixo, é possível validar que a aplicação de testes é acessada pela URL configurada no CloudFront, com HTTPS:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*kktVQ6-kSlKFkUjit5d6TA.png" /></figure><p><strong>8. Teste de latência:</strong> Comparação entre o acesso direto ao ALB e o acesso pelo CloudFront.</p><p>Para um comparativo simples de latência de rede, foram executados 100 pacotes de ping para cada endereço:</p><pre>ping -c 100 &lt;endereço&gt;</pre><p>No acesso direto ao ALB, a latência média foi de 128 ms (mínimo de 125 ms e máximo de 139 ms). Pelo CloudFront, a média caiu para 8 ms (mínimo de 4,5 ms e máximo de 18 ms). Em ambos os casos, não houve perda de pacotes.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/684/1*qCcV6r-NeUQ8eMYMEsDgsA.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/687/1*h2iEafegSN_e28qmfG4I-w.png" /></figure><p>É importante ressaltar o que este teste mede: a latência de rede até o ponto de entrada. Ele não mede o desempenho de cache nem o tempo de resposta da aplicação. Mesmo assim, ilustra o ganho de encerrar a conexão do usuário em um ponto de presença próximo, em vez de na região onde está o ALB.</p><p><strong>9. Proteção da origem:</strong> Fechamento do acesso direto ao ALB.</p><p>Com o CDN funcionando, falta impedir que o ALB continue acessível diretamente pela Internet, o que contornaria o CloudFront. Duas configurações foram aplicadas.</p><p>A primeira, no Security Group do ALB: a regra de entrada passou a ser HTTPS (porta 443) com origem na managed prefix list do CloudFront, em vez de um intervalo aberto de endereços. A prefix list é mantida pela própria AWS e contém os endereços de onde o CloudFront acessa as origens.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*SaQOsYafz25IS9HMuWS3OA.png" /></figure><p>A segunda, na própria origem do CloudFront: o protocolo de comunicação com o ALB foi definido como HTTPS only.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*V81ZwjZ_CYgm2wRKgih3uw.png" /></figure><p>Vale destacar o alcance dessa proteção: a prefix list restringe o acesso no nível de rede aos endereços do CloudFront, e não a uma distribution específica.</p><h3>Conclusão</h3><p>A aplicação, que antes era acessada diretamente pelo endereço do ALB, passou a ser servida por uma distribution do CloudFront com domínio próprio, certificado do ACM e comunicação com a origem exclusivamente por HTTPS. O Security Group do ALB deixou de aceitar HTTPS de qualquer origem e passou a aceitá-lo somente da prefix list do CloudFront.</p><p>O teste de ping mostrou a queda da latência média de 128 ms para 8 ms. O resultado é uma medida de latência de rede, e não de cache. O ganho de um CDN para aplicações dinâmicas depende também das políticas de cache adotadas, e este ambiente utilizou as configurações recomendadas pelo console para origens ELB.</p><p>Como próximo passo natural, vale revisar as políticas de cache para o conteúdo da aplicação e avaliar camadas adicionais de proteção na distribution, como o AWS WAF.</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=aef0c708cb58" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Acesso Privado ao RDS com Túnel SSM e Bastion EC2 sob Demanda]]></title>
            <link>https://marcelopalenzuela.medium.com/acesso-privado-ao-rds-com-t%C3%BAnel-ssm-e-bastion-ec2-sob-demanda-6959db84ce94?source=rss-a209874e5d6a------2</link>
            <guid isPermaLink="false">https://medium.com/p/6959db84ce94</guid>
            <category><![CDATA[aws]]></category>
            <category><![CDATA[aws-cli]]></category>
            <category><![CDATA[aws-ec2]]></category>
            <category><![CDATA[aws-ssm]]></category>
            <category><![CDATA[aws-rds]]></category>
            <dc:creator><![CDATA[Marcelo Palenzuela]]></dc:creator>
            <pubDate>Sun, 08 Nov 2026 00:23:20 GMT</pubDate>
            <atom:updated>2026-11-08T00:23:20.144Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*koSie6pZpAxNQc0Eiry0qQ.png" /></figure><p>Este artigo mostra como acessar uma instância Amazon RDS privada a partir de uma máquina de trabalho local Linux Ubuntu, usando o AWS Systems Manager (SSM) Session Manager e uma instância EC2 como ponte (bastion). O banco continua sem exposição pública: o cliente do banco conecta em 127.0.0.1, e o tráfego chega ao RDS por um túnel de port forwarding para host remoto, aberto pelo documento AWS-StartPortForwardingSessionToRemoteHost.</p><p>O cenário considerado é de uma instância RDS que permanece sempre ligada, e a instância EC2 que funciona como ponte é ligada e desligada sob demanda. Um shell script automatiza todo o ciclo: consulta a situação do RDS, liga a EC2 se necessário, aguarda a conexão SSM, abre o túnel e, ao encerrá-lo com CTRL+C, pergunta se a EC2 deve ser desligada. Com isso, a ponte só existe ligada enquanto alguém precisa dela.</p><p>O acesso é controlado por IAM, com uma policy de privilégio mínimo: permissões são concedidas para ligar e desligar somente a EC2 ponte, consultar somente o RDS indicado e abrir sessões SSM somente nessa EC2 e nesse documento de port forwarding. A autenticação do AWS CLI usa credenciais temporárias, obtidas com aws login.</p><h3>Arquitetura</h3><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*uFULBXvQUSZV0e0oT6YYcw.png" /></figure><p>A máquina de trabalho autentica no IAM com aws login e abre a sessão pelo Systems Manager. A EC2 ponte, dentro da VPC, mantém uma conexão de saída (HTTPS, porta 443) com o Systems Manager, por onde a sessão trafega, e encaminha a conexão ao endpoint do RDS na porta do banco. Como o SSM trabalha com conexões de saída, a EC2 ponte não precisa de regra de entrada (<em>Inbound</em>) no Security Group para esse acesso.</p><p>Para a instância EC2 ponte, pode ser utilizada uma imagem Ubuntu recente ou Amazon Linux.</p><h3>Passos realizados</h3><ol><li><strong>Preparar a máquina de trabalho:</strong> instalar o AWS CLI v2 e o Session Manager Plugin.</li><li><strong>Validar o ambiente AWS:</strong> confirmar a EC2 ponte gerenciada pelo SSM, a conectividade com o RDS e a saída HTTPS.</li><li><strong>Criar a policy IAM de privilégio mínimo:</strong> restringir a policy à EC2 ponte, ao RDS e ao documento de port forwarding.</li><li><strong>Criar o script do túnel:</strong> automatizar consulta do RDS, ligar a EC2, espera, túnel e desligamento.</li><li><strong>Autenticar o AWS CLI:</strong> obter credenciais temporárias com aws login.</li><li><strong>Abrir o túnel:</strong> executar o script informando a EC2 ponte e o RDS.</li><li><strong>Conectar o cliente do banco:</strong> apontar o cliente para 127.0.0.1.</li><li><strong>Encerrar o túnel e desligar a EC2:</strong> CTRL+C e confirmar o desligamento.</li></ol><p>Nos comandos, policies e scripts deste artigo, os valores entre &lt;...&gt; (por exemplo, &lt;ID_CONTA_AWS&gt;) são placeholders: substitua-os pelos nomes e identificadores do seu ambiente. Parâmetros entre colchetes (por exemplo, [&lt;PROFILE_AWS&gt;]) são opcionais.</p><h3>Passo 1. Preparação da máquina de trabalho</h3><p>Instale o AWS CLI v2 (Linux x86_64):</p><pre>cd ~/<br>curl &quot;https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip&quot; -o &quot;awscliv2.zip&quot;<br>unzip awscliv2.zip<br>sudo ./aws/install</pre><p>Depois, instale o Session Manager Plugin (Ubuntu 64 bits):</p><pre>curl &quot;https://s3.amazonaws.com/session-manager-downloads/plugin/latest/ubuntu_64bit/session-manager-plugin.deb&quot; -o &quot;session-manager-plugin.deb&quot;<br>sudo dpkg -i ./session-manager-plugin.deb<br>session-manager-plugin --version</pre><h3>Passo 2. Validação do ambiente AWS</h3><p>Confirme que o ambiente atende aos requisitos abaixo antes de seguir:</p><ul><li><strong>EC2 ponte gerenciada pelo SSM:</strong> a instância precisa ter o SSM Agent na versão 3.1.1374.0 ou superior (requisito do port forwarding para host remoto) e um instance profile com uma role que contém a policy gerenciada AmazonSSMManagedInstanceCore.</li><li><strong>Tag </strong><strong>Name única:</strong> o script localiza a EC2 pela tag Name; se houver mais de uma instância com o mesmo valor, ele recusa a execução.</li><li><strong>Saída HTTPS da EC2 ponte:</strong> a instância precisa ter saída na porta 443 para os endpoints ssm, ssmmessages e ec2messages da região, pela Internet ou por VPC endpoints. Nenhuma porta de entrada é necessária para o acesso do administrador.</li><li><strong>Conectividade EC2 → RDS:</strong> o Security Group do RDS precisa permitir entrada, na porta do banco, a partir da EC2 ponte (por exemplo, referenciando o Security Group da EC2 como origem), e as duas precisam ter rota entre si.</li><li><strong>RDS disponível:</strong> neste modelo de produção, o RDS fica sempre ligado (available); o script não o liga nem o desliga.</li><li><strong>Usuário IAM:</strong> além da policy do próximo passo, o usuário IAM precisa da policy gerenciada SignInLocalDevelopmentAccess, necessária para o aws login.</li></ul><h3>Passo 3. Policy IAM de privilégio mínimo</h3><p>No console IAM, em <em>Policies</em>, crie a policy &lt;NOME_DA_POLICY_TUNEL_RDS&gt; pelo editor JSON e anexe-a ao grupo ou ao usuário que vai usar o script:</p><pre>{<br>  &quot;Version&quot;: &quot;2012-10-17&quot;,<br>  &quot;Statement&quot;: [<br>    {<br>      &quot;Sid&quot;: &quot;ConsultarInstanciasEC2&quot;,<br>      &quot;Effect&quot;: &quot;Allow&quot;,<br>      &quot;Action&quot;: &quot;ec2:DescribeInstances&quot;,<br>      &quot;Resource&quot;: &quot;*&quot;<br>    },<br>    {<br>      &quot;Sid&quot;: &quot;LigarEDesligarEC2Ponte&quot;,<br>      &quot;Effect&quot;: &quot;Allow&quot;,<br>      &quot;Action&quot;: [<br>        &quot;ec2:StartInstances&quot;,<br>        &quot;ec2:StopInstances&quot;<br>      ],<br>      &quot;Resource&quot;: &quot;arn:aws:ec2:&lt;REGIÃO&gt;:&lt;ID_CONTA_AWS&gt;:instance/&lt;ID_INSTÂNCIA_EC2_PONTE&gt;&quot;<br>    },<br>    {<br>      &quot;Sid&quot;: &quot;ConsultarRDS&quot;,<br>      &quot;Effect&quot;: &quot;Allow&quot;,<br>      &quot;Action&quot;: &quot;rds:DescribeDBInstances&quot;,<br>      &quot;Resource&quot;: &quot;arn:aws:rds:&lt;REGIÃO&gt;:&lt;ID_CONTA_AWS&gt;:db:&lt;NOME_DO_RDS&gt;&quot;<br>    },<br>    {<br>      &quot;Sid&quot;: &quot;IniciarTunelHostRemoto&quot;,<br>      &quot;Effect&quot;: &quot;Allow&quot;,<br>      &quot;Action&quot;: &quot;ssm:StartSession&quot;,<br>      &quot;Resource&quot;: [<br>        &quot;arn:aws:ec2:&lt;REGIÃO&gt;:&lt;ID_CONTA_AWS&gt;:instance/&lt;ID_INSTÂNCIA_EC2_PONTE&gt;&quot;,<br>        &quot;arn:aws:ssm:*::document/AWS-StartPortForwardingSessionToRemoteHost&quot;<br>      ]<br>    },<br>    {<br>      &quot;Sid&quot;: &quot;OpenDataChannelPropriaSessao&quot;,<br>      &quot;Effect&quot;: &quot;Allow&quot;,<br>      &quot;Action&quot;: &quot;ssmmessages:OpenDataChannel&quot;,<br>      &quot;Resource&quot;: &quot;arn:aws:ssm:*:*:session/${aws:userid}-*&quot;<br>    },<br>    {<br>      &quot;Sid&quot;: &quot;EncerrarEReconectarPropriasSessoes&quot;,<br>      &quot;Effect&quot;: &quot;Allow&quot;,<br>      &quot;Action&quot;: [<br>        &quot;ssm:TerminateSession&quot;,<br>        &quot;ssm:ResumeSession&quot;<br>      ],<br>      &quot;Resource&quot;: &quot;arn:aws:ssm:*:*:session/${aws:userid}-*&quot;<br>    }<br>  ]<br>}</pre><p>Cada statement existe por um motivo:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/707/1*mQ2av6c_B1mb5ARsDmarmg.png" /></figure><p>Substitua &lt;REGIÃO&gt;, &lt;ID_CONTA_AWS&gt;, &lt;ID_INSTÂNCIA_EC2_PONTE&gt; e &lt;NOME_DO_RDS&gt; (o identificador da instância RDS) pelos valores do seu ambiente.</p><h3>Passo 4. Script do túnel</h3><p>Salve o script abaixo como ssm-rds-tunnel.sh e torne-o executável com chmod +x ssm-rds-tunnel.sh.</p><p>O script segue esta ordem:</p><ol><li>Valida os pré-requisitos (AWS CLI, Session Manager Plugin e credenciais válidas).</li><li>Consulta o RDS (status e endpoint) e interrompe se ele não estiver utilizável.</li><li>Localiza a EC2 ponte pela tag Name e a liga, se estiver desligada.</li><li>Aguarda o tempo de espera (WAIT_EC2, 60 segundos por padrão), usado para a conexão SSM ficar disponível. Se a EC2 ainda não estiver running ao final, a espera se repete até que fique nesse estado.</li><li>Verifica se a porta local está livre e abre o túnel.</li><li>Ao encerrar o túnel (CTRL+C), pergunta se deseja desligar a EC2. Enter confirma o padrão (Sim); se o desligamento falhar, a pergunta se repete.</li></ol><p>O trap &#39;:&#39; INT impede que o CTRL+C encerre o próprio script: o processo filho (aws ssm start-session) recebe o sinal e termina a sessão, e o script segue para a pergunta de desligamento.</p><pre>#!/usr/bin/env bash<br>#<br># ssm-rds-tunnel.sh<br>#<br># Abre um túnel SSM (AWS-StartPortForwardingSessionToRemoteHost) até uma<br># instância RDS, usando uma instância EC2 como ponte (bastion). A EC2 ponte é<br># ligada somente quando necessário e, ao encerrar o túnel (CTRL+C), o script<br># pergunta se deseja desligá-la. O RDS não é ligado nem desligado pelo script:<br># ele deve estar disponível (&#39;available&#39;).<br>#<br># Uso:<br>#   ./ssm-rds-tunnel.sh &lt;NOME_DA_EC2&gt; &lt;NOME_DO_RDS&gt; [&lt;PROFILE_AWS&gt;]<br>#<br># Parâmetros:<br>#   1) &lt;NOME_DA_EC2&gt;   obrigatório - valor da tag &quot;Name&quot; da instância EC2 ponte<br>#   2) &lt;NOME_DO_RDS&gt;   obrigatório - identificador (DBInstanceIdentifier) do RDS<br>#   3) &lt;PROFILE_AWS&gt;   opcional    - profile do AWS CLI (ex.: o usado no aws login)<br>#<br># Variáveis de ambiente opcionais:<br>#   LOCAL_PORT   porta local do túnel (padrão: a mesma porta do RDS)<br>#   WAIT_EC2     segundos de espera após ligar a EC2 (padrão: 60); a espera se<br>#                repete até a EC2 ficar &#39;running&#39;<br>#<br># Ordem de execução:<br>#   1) consulta o RDS (status e endpoint) e interrompe se ele não estiver<br>#      utilizável;<br>#   2) liga a EC2 (se estiver desligada) e aguarda o tempo de espera, que serve<br>#      para o estabelecimento da conexão SSM. Se a EC2 ainda não estiver<br>#      &#39;running&#39; ao fim da espera, a espera se repete até que fique nesse estado;<br>#   3) abre o túnel;<br>#   4) ao encerrar o túnel (CTRL+C), pergunta se deseja desligar a EC2 (Enter<br>#      confirma o padrão, que é Sim). Se o desligamento falhar, a pergunta se<br>#      repete.<br>#<br># Exemplo:<br>#   LOCAL_PORT=5433 ./ssm-rds-tunnel.sh minha-ec2-ponte meu-rds meu-profile<br>#   (depois, em outro terminal: psql -h 127.0.0.1 -p 5433 -U &lt;USUARIO&gt; -d &lt;BANCO&gt;)<br>#<br># Requisitos: AWS CLI v2, Session Manager Plugin e credenciais válidas<br># (aws login). A instância EC2 precisa ser gerenciada pelo SSM.<br><br>set -uo pipefail<br><br>WAIT_EC2=&quot;${WAIT_EC2:-60}&quot;<br>LOCAL_PORT=&quot;${LOCAL_PORT:-}&quot;<br><br>uso() {<br>  cat &lt;&lt;EOT<br>Uso: $(basename &quot;$0&quot;) &lt;NOME_DA_EC2&gt; &lt;NOME_DO_RDS&gt; [&lt;PROFILE_AWS&gt;]<br><br>  NOME_DA_EC2   (obrigatório) valor da tag Name da instância EC2 ponte<br>  NOME_DO_RDS   (obrigatório) identificador da instância RDS<br>  PROFILE_AWS   (opcional)    profile do AWS CLI<br><br>Variáveis opcionais: LOCAL_PORT (padrão: porta do RDS), WAIT_EC2 (60)<br>EOT<br>}<br><br>info() { printf &#39;[%s] %s\n&#39; &quot;$(date +%H:%M:%S)&quot; &quot;$*&quot;; }<br>erro() { printf &#39;[ERRO] %s\n&#39; &quot;$*&quot; &gt;&amp;2; exit 1; }<br><br># Espera N segundos mostrando a contagem regressiva. A linha traz o horário em<br># que a espera começou e, ao final, o horário em que ela terminou.<br>aguardar() {<br>  local total=&quot;$1&quot; texto=&quot;$2&quot; restante inicio<br>  inicio=&quot;$(date +%H:%M:%S)&quot;<br>  for ((restante = total; restante &gt; 0; restante--)); do<br>    printf &#39;\r[%s] %s: %3ds restantes &#39; &quot;$inicio&quot; &quot;$texto&quot; &quot;$restante&quot;<br>    sleep 1<br>  done<br>  printf &#39;\r[%s] %s: concluído.%20s\n&#39; &quot;$(date +%H:%M:%S)&quot; &quot;$texto&quot; &quot;&quot;<br>}<br><br># Espera o que falta de um tempo total contado a partir de um instante inicial<br># (em segundos desde a época). Se o tempo já passou, não espera.<br>aguardar_restante() {<br>  local inicio=&quot;$1&quot; total=&quot;$2&quot; texto=&quot;$3&quot; restante<br>  restante=$((total - ($(date +%s) - inicio)))<br>  if ((restante &gt; 0)); then<br>    aguardar &quot;$restante&quot; &quot;$texto&quot;<br>  fi<br>}<br><br># Pergunta Sim (S) ou Não (N). Enter confirma o padrão (Sim).<br># Retorna 0 para Sim e 1 para Não. Se a leitura for interrompida (CTRL+C ou<br># fim da entrada), assume Não.<br>perguntar_sn() {<br>  local pergunta=&quot;$1&quot; resp<br>  while true; do<br>    if ! read -r -p &quot;${pergunta} Sim (S) ou Não (N) [padrão: S]: &quot; resp; then<br>      echo<br>      echo &quot;Leitura interrompida; assumindo Não (N).&quot;<br>      return 1<br>    fi<br>    case &quot;${resp,,}&quot; in<br>      &quot;&quot; | s | sim) return 0 ;;<br>      n | nao | não) return 1 ;;<br>      *) echo &quot;Responda com S ou N (Enter = S).&quot; ;;<br>    esac<br>  done<br>}<br><br># ---------------------------------------------------------------- parâmetros<br>if [[ &quot;${1:-}&quot; == &quot;-h&quot; || &quot;${1:-}&quot; == &quot;--help&quot; ]]; then<br>  uso<br>  exit 0<br>fi<br>if [[ $# -lt 2 || $# -gt 3 ]]; then<br>  uso &gt;&amp;2<br>  exit 1<br>fi<br><br>EC2_NAME=&quot;$1&quot;<br>RDS_NAME=&quot;$2&quot;<br>PROFILE=&quot;${3:-}&quot;<br><br>AWS=(aws)<br>if [[ -n &quot;$PROFILE&quot; ]]; then<br>  AWS+=(--profile &quot;$PROFILE&quot;)<br>fi<br><br># ------------------------------------------------------------- pré-requisitos<br>command -v aws &gt;/dev/null 2&gt;&amp;1 || erro &quot;AWS CLI não encontrado no PATH.&quot;<br>command -v session-manager-plugin &gt;/dev/null 2&gt;&amp;1 || erro &quot;Session Manager Plugin não encontrado no PATH.&quot;<br><br>&quot;${AWS[@]}&quot; sts get-caller-identity &gt;/dev/null 2&gt;&amp;1 ||<br>  erro &quot;Credenciais inválidas ou expiradas. Execute: aws login${PROFILE:+ --profile $PROFILE}&quot;<br><br># ------------------------------------------------- Status e Endpoint do RDS<br>RDS_STATUS=&quot;&quot; RDS_ENDPOINT=&quot;&quot; RDS_PORT=&quot;&quot;<br>saida=$(&quot;${AWS[@]}&quot; rds describe-db-instances \<br>  --db-instance-identifier &quot;$RDS_NAME&quot; \<br>  --query &#39;DBInstances[0].[DBInstanceStatus,Endpoint.Address,Endpoint.Port]&#39; \<br>  --output text 2&gt;&amp;1) ||<br>  erro &quot;Não foi possível consultar a instância RDS &#39;${RDS_NAME}&#39;: ${saida}&quot;<br>read -r RDS_STATUS RDS_ENDPOINT RDS_PORT &lt;&lt;&lt;&quot;$saida&quot;<br>[[ &quot;$RDS_ENDPOINT&quot; == &quot;None&quot; ]] &amp;&amp; RDS_ENDPOINT=&quot;&quot;<br>[[ &quot;$RDS_PORT&quot; == &quot;None&quot; ]] &amp;&amp; RDS_PORT=&quot;&quot;<br>info &quot;RDS &#39;${RDS_NAME}&#39; -&gt; status: ${RDS_STATUS}; endpoint: ${RDS_ENDPOINT:-(indisponível)}&quot;<br><br># O RDS não é gerenciado por este script: precisa estar utilizável.<br>case &quot;$RDS_STATUS&quot; in<br>  available) ;;<br>  stopped | stopping | starting | failed | deleting | deleted | storage-full | \<br>    incompatible-* | restore-error | inaccessible-encryption-credentials*)<br>    erro &quot;O RDS está com status &#39;${RDS_STATUS}&#39; e não aceita conexões. Verifique a instância no console.&quot;<br>    ;;<br>  *)<br>    info &quot;O RDS está com status &#39;${RDS_STATUS}&#39;; seguindo, mas a conexão pode falhar.&quot;<br>    ;;<br>esac<br><br>[[ -n &quot;$RDS_ENDPOINT&quot; &amp;&amp; -n &quot;$RDS_PORT&quot; ]] ||<br>  erro &quot;Endpoint do RDS indisponível (status: ${RDS_STATUS}).&quot;<br><br># --------------------------------------------------- ID da instância EC2 (tag Name)<br>EC2_IDS=$(&quot;${AWS[@]}&quot; ec2 describe-instances \<br>  --filters &quot;Name=tag:Name,Values=${EC2_NAME}&quot; \<br>  &quot;Name=instance-state-name,Values=pending,running,stopping,stopped&quot; \<br>  --query &#39;Reservations[].Instances[].InstanceId&#39; --output text) ||<br>  erro &quot;Falha ao consultar as instâncias EC2.&quot;<br><br>read -r -a EC2_LISTA &lt;&lt;&lt;&quot;$EC2_IDS&quot;<br>if [[ ${#EC2_LISTA[@]} -eq 0 ]]; then<br>  erro &quot;Nenhuma instância EC2 encontrada com a tag Name &#39;${EC2_NAME}&#39;.&quot;<br>elif [[ ${#EC2_LISTA[@]} -gt 1 ]]; then<br>  erro &quot;Mais de uma instância EC2 com a tag Name &#39;${EC2_NAME}&#39;: ${EC2_LISTA[*]}&quot;<br>fi<br>EC2_ID=&quot;${EC2_LISTA[0]}&quot;<br><br>consultar_ec2() {<br>  EC2_ESTADO=$(&quot;${AWS[@]}&quot; ec2 describe-instances --instance-ids &quot;$EC2_ID&quot; \<br>    --query &#39;Reservations[0].Instances[0].State.Name&#39; --output text) ||<br>    erro &quot;Falha ao consultar o estado da EC2.&quot;<br>}<br><br>consultar_ec2<br>info &quot;EC2 &#39;${EC2_NAME}&#39; -&gt; status: ${EC2_ESTADO}; id: ${EC2_ID}&quot;<br><br># ------------------------------------------------------------- Ligar a EC2<br>EC2_LIGOU=0<br>EC2_T0=0<br><br>case &quot;$EC2_ESTADO&quot; in<br>  running)<br>    info &quot;EC2 já está ligada.&quot;<br>    ;;<br>  stopped | stopping)<br>    if [[ &quot;$EC2_ESTADO&quot; == &quot;stopping&quot; ]]; then<br>      info &quot;EC2 está desligando; aguardando o desligamento para ligá-la novamente...&quot;<br>      &quot;${AWS[@]}&quot; ec2 wait instance-stopped --instance-ids &quot;$EC2_ID&quot; ||<br>        erro &quot;A EC2 não chegou ao estado &#39;stopped&#39;.&quot;<br>    fi<br>    info &quot;Ligando a EC2 ${EC2_ID}...&quot;<br>    &quot;${AWS[@]}&quot; ec2 start-instances --instance-ids &quot;$EC2_ID&quot; &gt;/dev/null ||<br>      erro &quot;Falha ao ligar a EC2.&quot;<br>    EC2_LIGOU=1<br>    EC2_T0=$(date +%s)<br>    ;;<br>  pending)<br>    info &quot;EC2 já está iniciando.&quot;<br>    EC2_LIGOU=1<br>    EC2_T0=$(date +%s)<br>    ;;<br>  *)<br>    erro &quot;Estado inesperado da EC2: ${EC2_ESTADO}&quot;<br>    ;;<br>esac<br><br># ------------------------------------------------ Espera (conexão SSM)<br>if ((EC2_LIGOU)); then<br>  aguardar_restante &quot;$EC2_T0&quot; &quot;$WAIT_EC2&quot; &quot;Aguardando o EC2 para a conexão SSM&quot;<br>  consultar_ec2<br>  # Repete a espera até a EC2 ficar &#39;running&#39; (CTRL+C interrompe o script).<br>  while [[ &quot;$EC2_ESTADO&quot; != &quot;running&quot; ]]; do<br>    case &quot;$EC2_ESTADO&quot; in<br>      stopping | stopped | shutting-down | terminated)<br>        erro &quot;A EC2 entrou no estado &#39;${EC2_ESTADO}&#39; e não ficará &#39;running&#39; sozinha. Verifique a instância no console.&quot;<br>        ;;<br>    esac<br>    info &quot;A EC2 ainda está com status &#39;${EC2_ESTADO}&#39;. Repetindo a espera até ela ficar &#39;running&#39;.&quot;<br>    aguardar &quot;$WAIT_EC2&quot; &quot;Aguardando o EC2 para a conexão SSM&quot;<br>    consultar_ec2<br>  done<br>  info &quot;EC2 disponível (status: ${EC2_ESTADO}).&quot;<br>fi<br><br># ------------------------------------------------------- Porta local do túnel<br>LOCAL_PORT=&quot;${LOCAL_PORT:-$RDS_PORT}&quot;<br>if command -v ss &gt;/dev/null 2&gt;&amp;1 &amp;&amp; ss -ltn &quot;sport = :${LOCAL_PORT}&quot; | tail -n +2 | grep -q .; then<br>  erro &quot;A porta local ${LOCAL_PORT} já está em uso. Use outra: LOCAL_PORT=&lt;PORTA&gt; $(basename &quot;$0&quot;) ...&quot;<br>fi<br><br># ----------------------------------------------------- Túnel SSM até o RDS<br>echo<br>info &quot;Abrindo o túnel: 127.0.0.1:${LOCAL_PORT} -&gt; ${RDS_ENDPOINT}:${RDS_PORT} (via ${EC2_ID})&quot;<br>info &quot;Conecte o cliente do banco em 127.0.0.1:${LOCAL_PORT}. Pressione CTRL+C para encerrar o túnel.&quot;<br>echo<br><br># O trap evita que o CTRL+C encerre o script; o filho (aws/plugin) recebe o<br># CTRL+C normalmente e termina a sessão, e o script segue para a pergunta.<br>trap &#39;:&#39; INT<br><br>&quot;${AWS[@]}&quot; ssm start-session \<br>  --target &quot;$EC2_ID&quot; \<br>  --document-name AWS-StartPortForwardingSessionToRemoteHost \<br>  --parameters &quot;{\&quot;host\&quot;:[\&quot;${RDS_ENDPOINT}\&quot;],\&quot;portNumber\&quot;:[\&quot;${RDS_PORT}\&quot;],\&quot;localPortNumber\&quot;:[\&quot;${LOCAL_PORT}\&quot;]}&quot;<br>SSM_RC=$?<br><br>echo<br>info &quot;Sessão SSM encerrada (código de saída: ${SSM_RC}).&quot;<br>echo<br><br># ------------------------------------------------------------- Desligar a EC2<br># Se o desligamento falhar, a pergunta se repete (responda N para seguir adiante).<br>desligar_ec2() {<br>  local novo_estado<br>  while perguntar_sn &quot;Deseja desligar a instância EC2 &#39;${EC2_NAME}&#39; (${EC2_ID})?&quot;; do<br>    info &quot;Desligando a EC2 ${EC2_ID}...&quot;<br>    if novo_estado=$(&quot;${AWS[@]}&quot; ec2 stop-instances --instance-ids &quot;$EC2_ID&quot; \<br>      --query &#39;StoppingInstances[0].CurrentState.Name&#39; --output text); then<br>      info &quot;EC2: estado ${novo_estado}.&quot;<br>      return 0<br>    fi<br>    info &quot;Não foi possível desligar a EC2 (veja a mensagem acima). A pergunta será repetida.&quot;<br>    echo<br>  done<br>  info &quot;EC2 mantida ligada.&quot;<br>}<br><br>desligar_ec2<br><br>info &quot;Concluído.&quot;</pre><h3>Passo 5. Autenticação do AWS CLI</h3><p>Inicie o aws login. O parâmetro --profile é opcional; utilize-o caso você trabalhe com várias contas AWS:</p><pre>aws login [--profile &lt;NOME_DO_PROFILE&gt;]</pre><p>O comando abre o navegador para o login do usuário IAM e grava credenciais temporárias no profile. O script valida as credenciais antes de qualquer ação e, se estiverem expiradas, indica o comando a executar.</p><h3>Passo 6. Abertura do túnel</h3><p>Execute o script informando o valor da tag Name da EC2 ponte, o identificador do RDS e, opcionalmente, o profile:</p><pre>./ssm-rds-tunnel.sh &lt;NOME_DA_EC2&gt; &lt;NOME_DO_RDS&gt; [&lt;PROFILE_AWS&gt;]</pre><p>Para usar uma porta local diferente da porta do RDS (por exemplo, quando a porta padrão já está em uso na máquina de trabalho) ou alterar o tempo de espera:</p><pre>LOCAL_PORT=5433 WAIT_EC2=90 ./ssm-rds-tunnel.sh &lt;NOME_DA_EC2&gt; &lt;NOME_DO_RDS&gt; [&lt;PROFILE_AWS&gt;]</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*MxZojHlM4YCDVCiwOWqFqQ.png" /><figcaption>Demonstração do script em ação.</figcaption></figure><p>Por baixo, o script executa o comando abaixo, com o endpoint e a porta lidos do próprio RDS:</p><pre>aws ssm start-session \<br>  --target &lt;ID_INSTÂNCIA_EC2_PONTE&gt; \<br>  --document-name AWS-StartPortForwardingSessionToRemoteHost \<br>  --parameters &#39;{&quot;host&quot;:[&quot;&lt;ENDPOINT_DO_RDS&gt;&quot;],&quot;portNumber&quot;:[&quot;&lt;PORTA_DO_RDS&gt;&quot;],&quot;localPortNumber&quot;:[&quot;&lt;PORTA_LOCAL&gt;&quot;]}&#39;</pre><p>Mantenha o terminal aberto enquanto o túnel estiver em uso.</p><h3>Passo 7. Conexão do cliente do banco</h3><p>Em outro terminal, conecte o cliente do banco em 127.0.0.1, na porta local do túnel. No exemplo, o cliente psql, para um RDS PostgreSQL:</p><pre>psql -h 127.0.0.1 -p &lt;PORTA_LOCAL&gt; -U &lt;USUARIO&gt; -d &lt;BANCO&gt;</pre><h3>Passo 8. Encerramento do túnel e desligamento da EC2</h3><p>Quando terminar, encerre o cliente do banco e pressione CTRL+C no terminal do script. A sessão SSM é encerrada e o script pergunta se deseja desligar a EC2 ponte:</p><pre>Deseja desligar a instância EC2 &#39;&lt;NOME_DA_EC2&gt;&#39; (&lt;ID_INSTÂNCIA_EC2_PONTE&gt;)? Sim (S) ou Não (N) [padrão: S]:</pre><p>Responda S (ou Enter) para desligar a EC2, ou N para mantê-la ligada, por exemplo, se outra pessoa ainda precisar do acesso.</p><h3>Conclusão</h3><p>O acesso ao RDS passou a depender apenas de IAM e de conexões de saída: o banco não tem exposição pública, e a EC2 ponte não precisa de regra de entrada para o acesso do administrador. A autenticação usa credenciais temporárias obtidas com aws login, e a policy limita o que o usuário consegue fazer: ligar e desligar uma única EC2, consultar um único RDS e abrir sessões SSM somente nessa EC2 e no documento de port forwarding.</p><p>Ligar a ponte apenas quando necessário reduz a superfície de acesso, já que ela fica desligada fora das janelas de uso. Em relação ao custo, a EC2 desligada deixa de cobrar pelo uso de computação, mas os volumes EBS anexados continuam sendo cobrados.</p><p>Como próximos passos naturais, vale registrar as sessões do Session Manager (CloudWatch Logs ou S3) para auditoria, restringir a policy por tags quando houver várias pontes, e adaptar o script para o fluxo de acesso da sua equipe.</p><h3>Fontes Oficiais para Consulta</h3><p>Starting a session (port forwarding to remote host):<br> <a href="https://docs.aws.amazon.com/systems-manager/latest/userguide/session-manager-working-with-sessions-start.html">https://docs.aws.amazon.com/systems-manager/latest/userguide/session-manager-working-with-sessions-start.html</a></p><p>Session Manager prerequisites:<br> <a href="https://docs.aws.amazon.com/systems-manager/latest/userguide/session-manager-prerequisites.html">https://docs.aws.amazon.com/systems-manager/latest/userguide/session-manager-prerequisites.html</a></p><p>Sample IAM policies for Session Manager:<br> <a href="https://docs.aws.amazon.com/systems-manager/latest/userguide/getting-started-restrict-access-quickstart.html">https://docs.aws.amazon.com/systems-manager/latest/userguide/getting-started-restrict-access-quickstart.html</a></p><p>Amazon EC2 instance state changes (instâncias paradas):<br> <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-lifecycle.html">https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-lifecycle.html</a></p><p>How do I use an Amazon EC2 instance as a bastion host to connect to a private Amazon RDS DB instance from a local machine?:<br> <a href="https://repost.aws/knowledge-center/rds-connect-ec2-bastion-host">https://repost.aws/knowledge-center/rds-connect-ec2-bastion-host</a></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=6959db84ce94" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Compartilhando uma VPN Site-to-Site entre contas AWS com Transit Gateway]]></title>
            <link>https://marcelopalenzuela.medium.com/compartilhando-uma-vpn-site-to-site-entre-contas-aws-com-transit-gateway-4f3bd2b8161f?source=rss-a209874e5d6a------2</link>
            <guid isPermaLink="false">https://medium.com/p/4f3bd2b8161f</guid>
            <category><![CDATA[aws-transit-gateway]]></category>
            <category><![CDATA[vpn]]></category>
            <category><![CDATA[aws-vpc]]></category>
            <category><![CDATA[aws-ram]]></category>
            <category><![CDATA[aws]]></category>
            <dc:creator><![CDATA[Marcelo Palenzuela]]></dc:creator>
            <pubDate>Sun, 01 Nov 2026 15:16:49 GMT</pubDate>
            <atom:updated>2026-11-01T15:16:49.194Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*zDhr5D6qV0XxZwwC44J4EA.png" /></figure><p>Em ambientes com várias contas AWS, é comum que duas ou mais contas precisem de conectividade com a rede on-premises ou com parceiros externos. A abordagem mais comum seria criar uma conexão VPN Site-to-Site em cada conta AWS individual, o que multiplica túneis, dispositivos de borda, configurações, custos de manutenção e complexidade.</p><p>Neste artigo, demonstramos como conectar o ambiente on-premises a duas contas AWS em uma AWS Organization (para esta demonstração, utilizaremos contas fictícias de Produção e de Desenvolvimento), utilizando <strong>uma única conexão VPN Site-to-Site</strong> na conta de Produção, terminada em um <strong>AWS Transit Gateway</strong>, e compartilhando esse Transit Gateway com a conta de Desenvolvimento usando o <strong>AWS Resource Access Manager (RAM)</strong>.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/673/1*E5UHNP0lA_h41LXxwEWRIg.png" /></figure><h3>Arquitetura da solução</h3><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*qRTrIBfKiyS5-38IwwrHKQ.png" /></figure><p>Segue abaixo a arquitetura do ambiente simulado neste artigo:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/676/1*Pufvbcqa5CNmRXFwR8RSkA.png" /><figcaption>Tabela declarativa de endereçamento dos ambientes utilizados neste artigo.</figcaption></figure><p>O fluxo lógico é: <strong>On-premises → VPN (túnel IPsec) → Transit Gateway (conta de Produção) → VPCs de Produção e de Desenvolvimento</strong>.</p><h3>Passos realizados (visão geral)</h3><ol><li><strong>Criar o Transit Gateway na conta de Produção:</strong> com <em>Default route table association</em> e <em>Default route table propagation</em> habilitados;</li><li><strong>Anexar a VPC de Produção ao Transit Gateway:</strong> attachment do tipo VPC;</li><li><strong>Criar o attachment do tipo VPN:</strong> o processo cria o customer gateway e a conexão Site-to-Site VPN;</li><li><strong>Criar rotas e liberar o Security Group em Produção:</strong> rota estática na Transit Gateway Route Table e na route table da subnet, com ICMP liberado;</li><li><strong>Habilitar o compartilhamento do RAM com o AWS Organizations:</strong> na conta de gerenciamento;</li><li><strong>Compartilhar o Transit Gateway com a conta de Desenvolvimento:</strong> via RAM, na conta de Produção;</li><li><strong>Criar o attachment de VPC na conta de Desenvolvimento e aceitá-lo na conta de Produção</strong>;</li><li><strong>Ajustar rotas e Security Group na conta de Desenvolvimento e validar a conectividade</strong>.</li></ol><h3>Parte 1: On-premises ↔ Produção</h3><h3>1. Transit Gateway e attachment de VPC</h3><p>a. Crie o Transit Gateway na conta de Produção. Ao criar um Transit Gateway, a AWS cria uma route table padrão que, com as opções <em>Default route table association</em> e <em>Default route table propagation</em> habilitadas, passa a ser usada como tabela de associação e de propagação padrão dos attachments.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*7KZzo4PEuZk-LGP4BET0iQ.png" /><figcaption>Detalhes do Transit Gateway (TGW).</figcaption></figure><p>b. Em seguida, crie um Transit Gateway Attachment do tipo VPC, indicando a VPC de Produção e a subnet onde estão os recursos que precisam ser acessados na rede On-premises. No nosso exemplo, vamos conectar a subnet onde se encontra nosso servidor de produção (Server-Prod1). Com as opções acima habilitadas, o attachment é associado automaticamente à route table padrão e propaga nela o CIDR da VPC (172.16.0.0/16).</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*x1FtuIclcnCP0ilAFXeQ6w.png" /><figcaption>Detalhes do Transit Gateway Attachment.</figcaption></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*0nZq7qIXuwBzDzVs1AufFg.png" /><figcaption>Detalhes do Default Route Tables do Transit Gateway.</figcaption></figure><h3>2. Attachment de VPN</h3><p>a. Crie então um attachment do tipo VPN. Durante esse processo, são criados o <strong>customer gateway</strong> (que informa à AWS o IP público do dispositivo on-premises) e a <strong>conexão Site-to-Site VPN</strong>.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*FhuzRDDkA3snph5PmZj7XA.png" /><figcaption>Detalhes do Transit Gateway Attachment.</figcaption></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*GFoJ58CEO4TdIWHEY5-Zfg.png" /><figcaption>Detalhes do Customer Gateway criado.</figcaption></figure><p>b. Na aba Details da conexão VPN, os campos <em>Local IPv4 network CIDR</em> e <em>Remote IPv4 network CIDR</em> ficam com o valor padrão 0.0.0.0/0. Utilizaremos roteamento do tipo <strong>Static</strong>.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*48Xfl9KHAZYIGtjeptofGg.png" /><figcaption>Detalhes da Conexão VPN.</figcaption></figure><p>c. Logo após a criação, os dois túneis da conexão VPN aparecem como <strong>Down</strong>, pois o customer gateway device ainda não foi configurado. A chave pré-compartilhada (PSK) de cada túnel é gerada pela AWS na criação da conexão e fica armazenada no próprio serviço Site-to-Site VPN.</p><p>Para obtê-la, selecione a conexão, escolha <strong>Download configuration</strong>, informe Vendor, Platform, Software e versão do IKE correspondentes ao dispositivo (ou <em>Generic</em>) e faça o download. O arquivo contém a PSK e os IPs externos de cada túnel.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*sSCovJmFug1iqDq-TQJdKw.png" /><figcaption>Detalhes dos túneis VPN.</figcaption></figure><h3>3. Configuração do IPsec no Ambiente On-premises</h3><p>a. No servidor IPsec on-premises, utilize as instruções do arquivo baixado no passo anterior.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/672/1*IjvbkwUl1-gJDwgYjt_GyA.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/673/1*BNggOWY8TWTu9B4aGCNjUw.png" /></figure><p>Em nosso laboratório, utilizamos o endereço IP público do Tunnel 1 no servidor IPsec do ambiente On-premises.</p><p>b. Após subir e iniciar a configuração, o <strong>Tunnel 1</strong> na AWS passa para <strong>Up</strong>.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*SJX2HxWKseySYfdRg4TmyQ.png" /><figcaption>Detalhes dos túneis VPN.</figcaption></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/672/1*o_lae3ytR7CfIhnQoIFTHA.png" /></figure><h3>4. Roteamento e Security Group</h3><p>a. Como a conexão usa <strong>roteamento estático</strong>, é preciso criar uma rota estática na Transit Gateway Route Table padrão, apontando a rede on-premises (10.10.0.0/16) para o attachment do tipo VPN. A documentação da AWS destaca que, para VPNs estáticas, as rotas precisam ser adicionadas à route table do Transit Gateway.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*jBbTIp6nJbpL3YbVXikf-w.png" /><figcaption>Criação da rota estática no Default Route Tables do Transit Gateway.</figcaption></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*mXmnFL2sd2mhfSjKVBy7Kg.png" /><figcaption>Rota estática no Default Route Tables do Transit Gateway.</figcaption></figure><p>b. Na route table da subnet do servidor de Produção, crie uma rota para 10.10.0.0/16 tendo o Transit Gateway como destino.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*fI5LEQl4O8BSypcGvFRFBQ.png" /><figcaption>Criação da rota estática na Route Table onde se encontram os recursos que precisam ser acessados pelo ambiente On-premises.</figcaption></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*RN8zbLLyOvQviI0_2s-qPA.png" /><figcaption>Rota estática na Route Table onde se encontram os recursos que precisam ser acessados pelo ambiente On-premises.</figcaption></figure><p>c. Por fim, libere no Security Group do servidor de Produção o tráfego originado da rede on-premises. No laboratório, apenas ICMP, usado nos testes.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*bJ9aNn3tOG_xdrEvOnZ6Mg.png" /><figcaption>Security Group do servidor de Produção.</figcaption></figure><h3>5. Validação</h3><p>a. Teste com ping da máquina do usuário para o servidor de Produção e, depois, no sentido inverso:</p><pre>10.10.11.60  -&gt;  172.16.10.95<br>172.16.10.95 -&gt;  10.10.11.60</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/540/1*HjFoboa92PXYk4VOcCsX6Q.png" /><figcaption>Ping 10.10.11.60 -&gt; 172.16.10.95</figcaption></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/545/1*TInhMq9QueIiXYNA8xiYzg.png" /><figcaption>Ping 172.16.10.95 -&gt; 10.10.11.60</figcaption></figure><h3>Parte 2: On-premises ↔ Desenvolvimento, com o Transit Gateway compartilhado</h3><h3>1. Habilitar o RAM com o AWS Organizations</h3><p>a. Na <strong>conta de gerenciamento</strong>, habilite <strong>Enable sharing with AWS Organizations</strong> nas configurações do AWS RAM.</p><p>Esse passo só pode ser feito pela conta de gerenciamento, e a organização precisa ter todos os recursos (<em>all features</em>) habilitados. A AWS recomenda habilitar pelo console ou CLI do RAM, o que garante a criação da service-linked role usada pelo serviço.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*OzbqsfRdzu9Kd00ulWhrNg.png" /><figcaption>Settings do AWS Resource Access Manager.</figcaption></figure><h3>2. Compartilhar o Transit Gateway</h3><p>a. Na conta de Produção, dona do Transit Gateway, crie o resource share no RAM incluindo o Transit Gateway e a conta de Desenvolvimento como principal.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/988/1*TrGyoWhsR96K-NOCdQRMyw.png" /><figcaption>Detalhes do compartilhamento do Transit Gateway utilizando o AWS Resource Access Manager.</figcaption></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/985/1*52gMXaGb20xgpDxmR_pBPg.png" /><figcaption>Seleção do Principal ID (Account ID da conta de Desenvolvimento) no AWS Resource Access Manager.</figcaption></figure><p>O resource share usa a permissão gerenciada padrão para Transit Gateway (AWSRAMDefaultPermissionTransitGateway), com a opção de principais externos desabilitada e a conta de Desenvolvimento associada diretamente como principal.</p><p>b. Na conta de Desenvolvimento, o Transit Gateway compartilhado já aparece listado.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*Qd9KjIsv7pH-i5tm3f4Jng.png" /><figcaption>Em Transit Gateways na conta de Desenvolvimento, o compartilhamento do Transit Gateway proveniente da conta de Produção aparece como disponível.</figcaption></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/670/1*YKHRQoXABefYszmyQ-SkTA.png" /></figure><h3>3. Attachment de VPC na conta de Desenvolvimento</h3><p>a. Na conta de Desenvolvimento, crie um attachment do tipo VPC apontando para o Transit Gateway compartilhado, selecionando a VPC e a subnet onde se encontram os recursos que devem ser acessados pela rede On-premises. Em nosso laboratório, selecionamos a subnet onde se encontra o servidor Server-Dev1.</p><p>Vale lembrar que o Transit Gateway só recebe tráfego das Availability Zones em que o attachment tem uma subnet. Quando o Transit Gateway e os attachments estão em contas diferentes, a AWS recomenda identificar as zonas pelo <strong>AZ ID</strong> (por exemplo, use1-az1).</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*9TdbyIy-Vpuc5nOaI3mxtA.png" /><figcaption>Criação do Transit Gateway Attachment na conta de Desenvolvimento (Parte 1/2).</figcaption></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*-Bp-dihmIjqB6RlcgsmRsg.png" /><figcaption>Criação do Transit Gateway Attachment na conta de Desenvolvimento (Parte 2/2).</figcaption></figure><p>Como o Transit Gateway foi criado com <strong>Auto accept shared attachments</strong> desabilitado, o attachment fica em <strong>Pending acceptance</strong>.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*a64u93qDXP-pTQxr_9e26Q.png" /><figcaption>Transit Gateway Attachment em estado <strong>Pending acceptance</strong> na conta de Desenvolvimento<strong>.</strong></figcaption></figure><h3>4. Aceite na conta dona do Transit Gateway</h3><p>a. Na conta de Produção, selecione o attachment pendente e use <strong>Actions → Accept transit gateway attachment</strong>.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*7sI7GFMWMM5eQA4ZM-QGaw.png" /><figcaption>O Transit Gateway Attachment da conta de Desenvolvimento aparece na conta de Produção, para Aceite, Rejeição ou Exclusão.</figcaption></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*kKKYMv86vLfdIkeOvrU2tQ.png" /><figcaption>Em <strong>Actions</strong> do Transit Gateway Attachment, selecionamos a opção <strong>Accept transit gateway attachment </strong>para aceitar a conexão.</figcaption></figure><p>b. Após o aceite, o attachment passa para <strong>Available</strong> na conta de Desenvolvimento. Como a associação e a propagação padrão estão habilitadas, o CIDR da VPC de Desenvolvimento (172.17.0.0/16) é propagado para a route table padrão do Transit Gateway.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*E6-BMmcl2Aapzpn94h8N0A.png" /><figcaption>Transit Gateway Attachment na conta de Desenvolvimento, após aceite da conexão na conta de Produção.</figcaption></figure><h3>5. Rotas, Security Group e validação</h3><p>a. Na route table da subnet de Desenvolvimento, crie a rota para 10.10.0.0/16 com o Transit Gateway como destino e libere ICMP originado da rede on-premises no Security Group do servidor.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*wpcvoiWvd1bUARfzEWKMVA.png" /><figcaption>Criação da rota estática na Route Table onde se encontram os recursos que precisam ser acessados pelo ambiente On-premises na conta de Desenvolvimento.</figcaption></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*R4B4imFHgftGZ_AfRzUFew.png" /><figcaption>Rota estática na Route Table onde se encontram os recursos que precisam ser acessados pelo ambiente On-premises.</figcaption></figure><p>b. Libere no Security Group do servidor de Produção o tráfego originado da rede on-premises. No laboratório, apenas ICMP, usado nos testes.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*bSSw38IvlIHkKTHd-A4DoQ.png" /><figcaption>Security Group do servidor de Desenvolvimento.</figcaption></figure><p>c. Testes de ping nos dois sentidos:</p><pre>10.10.11.60  -&gt;  172.17.10.87<br>172.17.10.87 -&gt;  10.10.11.60</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/546/1*nhBQyqWFdTI7KcCy1WA4RA.png" /><figcaption>Ping 10.10.11.60 -&gt; 172.17.10.87</figcaption></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/537/1*q9DUKqqRbAyyTKUtcdHwpw.png" /><figcaption>Ping 172.17.10.87 -&gt; 10.10.11.60</figcaption></figure><p>d. A configuração final da Transit Gateway Route Table na conta de Produção. Para esse laboratório, ela ficou como segue abaixo.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*RD-CUsVoZwuJ92k1LBCtnA.png" /><figcaption>Configuração final da Default Route Tables do Transit Gateway.</figcaption></figure><h3>Procedimento para adicionar novos attachments</h3><p>O RAM compartilha <strong>apenas o Transit Gateway</strong>. Os attachments não são compartilhados: cada conta cria os seus, e somente a conta dona do Transit Gateway gerencia as Transit Gateway Route Tables (contas com o Transit Gateway compartilhado não podem criar, modificar ou excluir essas route tables, nem suas associações e propagações). Por isso, um novo attachment não exige nenhuma ação no RAM, mas exige ajustes de roteamento e segurança em suas Route Tables e Security Groups internas.</p><p><strong>Novo attachment do tipo VPN</strong> deve ser criado na conta dona do Transit Gateway (a AWS não permite criar attachments de VPN em contas que apenas recebem o compartilhamento):</p><ol><li><strong>Na Transit Gateway Route Table (conta de Produção):</strong> O attachment é associado automaticamente à route table padrão. Com roteamento estático, crie uma rota estática para o CIDR do novo site, apontando para o novo attachment;</li><li><strong>Nas route tables das VPCs que precisam alcançar o novo site (Produção e Desenvolvimento):</strong> Crie uma rota para o CIDR do novo site, tendo o Transit Gateway como destino;</li><li><strong>Nos Security Groups (Produção e Desenvolvimento):</strong> permita o tráfego originado no CIDR do novo site;</li><li><strong>No customer gateway device do novo site: </strong>configure o dispositivo com o arquivo gerado por <em>Download configuration</em> da nova conexão VPN;</li></ol><h3>Conclusão</h3><p>Tecnicamente, demonstramos que uma única conexão VPN Site-to-Site terminada em um Transit Gateway pode atender várias contas de uma Organization.<br> A conta dona do Transit Gateway concentra a VPN e o roteamento, enquanto cada conta consumidora apenas anexa a sua VPC ao Transit Gateway e ajusta as suas próprias Route Tables e Security Groups.<br> Isso reduz o número de túneis e dispositivos de borda a gerenciar e centraliza o controle de roteamento.</p><p>Também ficou claro, na prática, o papel de cada peça: o RAM compartilha somente o Transit Gateway; o aceite necessário é o do attachment, e a conectividade só se completa quando as três camadas de roteamento e segurança estão alinhadas (Transit Gateway Route Table, Route Tables das VPCs e Security Groups).</p><p>Este artigo utiliza uma configuração simplificada para facilitar o entendimento da solução. Em um ambiente real, os próximos passos naturais são:</p><ol><li>Configurar os dois túneis da conexão VPN Site-to-Site e, quando o dispositivo IPsec da rede On-premises suportar, utilizar BGP;</li><li>Usar route tables customizadas no Transit Gateway para isolar Produção e Desenvolvimento, já que hoje ambos compartilham a route table padrão e podem se alcançar;</li><li>Hospedar o Transit Gateway em uma conta dedicada a serviços de rede.</li></ol><h3>Fontes Oficiais para Consulta</h3><p>Leitura complementar recomendada para aprofundamento.</p><p><strong>Shared transit gateways: </strong><a href="https://docs.aws.amazon.com/vpc/latest/tgw/working-with-transit-gateways.html#transit-gateway-share">https://docs.aws.amazon.com/vpc/latest/tgw/working-with-transit-gateways.html#transit-gateway-share</a></p><p><strong>Amazon VPC attachments in AWS Transit Gateway: </strong><a href="https://docs.aws.amazon.com/vpc/latest/tgw/tgw-vpc-attachments.html">https://docs.aws.amazon.com/vpc/latest/tgw/tgw-vpc-attachments.html</a></p><p><strong>AWS Site-to-Site VPN attachments in AWS Transit Gateway: </strong><a href="https://docs.aws.amazon.com/vpc/latest/tgw/tgw-vpn-attachments.html">https://docs.aws.amazon.com/vpc/latest/tgw/tgw-vpn-attachments.html</a></p><p><strong>Sharing your AWS resources: </strong><a href="https://docs.aws.amazon.com/ram/latest/userguide/getting-started-sharing.html">https://docs.aws.amazon.com/ram/latest/userguide/getting-started-sharing.html</a></p><p><strong>Tunnel options for your AWS Site-to-Site VPN connection: </strong><a href="https://docs.aws.amazon.com/vpn/latest/s2svpn/VPNTunnels.html">https://docs.aws.amazon.com/vpn/latest/s2svpn/VPNTunnels.html</a></p><p><strong>Centralize network connectivity using AWS Transit Gateway: </strong><a href="https://docs.aws.amazon.com/prescriptive-guidance/latest/patterns/centralize-network-connectivity-using-aws-transit-gateway.html">https://docs.aws.amazon.com/prescriptive-guidance/latest/patterns/centralize-network-connectivity-using-aws-transit-gateway.html</a></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=4f3bd2b8161f" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Acesso Seguro a Instâncias EC2 com SSM na AWS]]></title>
            <link>https://marcelopalenzuela.medium.com/acesso-seguro-a-inst%C3%A2ncias-ec2-com-ssm-na-aws-540affd228ee?source=rss-a209874e5d6a------2</link>
            <guid isPermaLink="false">https://medium.com/p/540affd228ee</guid>
            <category><![CDATA[linux]]></category>
            <category><![CDATA[aws-ec2]]></category>
            <category><![CDATA[aws]]></category>
            <category><![CDATA[aws-cli]]></category>
            <category><![CDATA[aws-ssm]]></category>
            <dc:creator><![CDATA[Marcelo Palenzuela]]></dc:creator>
            <pubDate>Tue, 27 Oct 2026 03:15:26 GMT</pubDate>
            <atom:updated>2026-10-27T03:21:28.539Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*7bGqR35HAU95G393iM-VNw.png" /></figure><p>Este artigo mostra como acessar instâncias EC2 Linux e Windows pelo AWS Systems Manager (SSM) Session Manager, sem abrir nenhuma porta de entrada SSH e RDP no Security Group, <strong>utilizando uma máquina de trabalho Linux local, com sistema operacional Ubuntu</strong>. O acesso é controlado por IAM, e a instância não precisa expor portas de acesso remoto na Internet.</p><p>Para EC2 Linux, a sessão é aberta pelo terminal da máquina de trabalho, com o Session Manager Plugin instalado. O AWS CLI se autentica com credenciais temporárias, obtidas com aws login, em vez de Access Keys de longa duração. Para isso, o usuário IAM recebe, além da policy de acesso à sessão SSM, a policy SignInLocalDevelopmentAccess.</p><p>Para EC2 Windows, o tráfego RDP segue por um túnel de port forwarding aberto pelo Session Manager, e o cliente RDP conecta em 127.0.0.1. Usuário, grupo e associação da policy seguem o mesmo processo do Linux; apenas a policy necessária muda.</p><p>O SSM trabalha com conexões de saída (Outbound): o Security Group não precisa de regras de entrada (Inbound), mas a instância precisa ter acesso de saída à Internet.</p><h3>Arquitetura</h3><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*sRhDaIE54I2MP8J6qbSt2A.png" /></figure><p>A máquina de trabalho local se autentica no IAM com aws login e abre a sessão pelo Systems Manager, seja o shell no Linux ou o túnel RDP no Windows. As instâncias ficam em uma VPC, com o Security Group sem regras de entrada permissivas além da necessidade, e mantêm uma conexão de saída com o Systems Manager, por onde a sessão trafega.</p><h3>Passos realizados</h3><ol><li><strong>Preparar a máquina de trabalho local com Linux (Ubuntu):</strong> instalar o AWS CLI v2 e o Session Manager Plugin.</li><li><strong>Criar a policy IAM de acesso ao SSM:</strong> permitir iniciar, retomar e encerrar sessões, com filtros opcionais por instância ou por tag específicos.</li><li><strong>Criar o grupo e o usuário IAM:</strong> anexar ao grupo a policy criada e a SignInLocalDevelopmentAccess; o usuário herda as permissões do grupo.</li><li><strong>Ajustar o Security Group da instância:</strong> nenhuma regra de entrada para SSH ou RDP é configurada; a saída continua liberada.</li><li><strong>Autenticar o AWS CLI:</strong> obter credenciais temporárias com aws login.</li><li><strong>Conectar à instância EC2 Linux:</strong> abrir a sessão com aws ssm start-session.</li><li><strong>Conectar à instância EC2 Windows:</strong> abrir um túnel de port forwarding para a porta 3389 e conectar o cliente RDP em 127.0.0.1.</li></ol><h3>Pré-requisitos</h3><p>Confirme que o ambiente AWS atende aos requisitos abaixo antes de seguir. Eles valem para instâncias EC2 Linux e Windows, exceto onde indicado.</p><ul><li><strong>Instância gerenciada pelo Systems Manager:</strong> a instância precisa ter o SSM Agent instalado (versão 2.3.672.0 ou superior para o port forwarding usado no Windows).</li><li><strong>Role na instância:</strong> a instância precisa ter um instance profile com uma role que contém a policy gerenciada AmazonSSMManagedInstanceCore. Sem isso, a instância não aparece como gerenciada e a sessão não abre.</li><li><strong>Saída para a Internet:</strong> a instância precisa ter acesso de saída à Internet. Nenhuma porta de entrada é necessária.</li><li><strong>Máquina de trabalho:</strong> com sistema operacional Linux (Ubuntu), AWS CLI e Session Manager Plugin instalados.</li><li><strong>Permissões do usuário IAM:</strong> a policy de acesso ao SSM e a SignInLocalDevelopmentAccess, criadas nas etapas seguintes.</li><li><strong>Windows:</strong> o serviço de Remote Desktop precisa estar escutando na porta 3389 da instância, que é o padrão nas AMIs fornecidas pela AWS.</li></ul><p>Nos comandos e policies deste artigo, os valores entre &lt;...&gt; (por exemplo, &lt;NOME_DO_GRUPO_SSM&gt;) são placeholders: substitua-os pelos nomes e identificadores do seu ambiente.</p><p>Parâmetros entre colchetes (por exemplo, [--profile &lt;NOME_DO_PROFILE&gt;]) são opcionais.</p><h3>Passo 1. Preparação da máquina de trabalho local</h3><p>Primeiro, instale o AWS CLI v2 (Linux x86_64):</p><pre>cd ~/<br>curl &quot;https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip&quot; -o &quot;awscliv2.zip&quot;<br>unzip awscliv2.zip<br>sudo ./aws/install</pre><p>Depois, instale o Session Manager Plugin (Ubuntu 64 bits):</p><pre>curl &quot;https://s3.amazonaws.com/session-manager-downloads/plugin/latest/ubuntu_64bit/session-manager-plugin.deb&quot; -o &quot;session-manager-plugin.deb&quot;<br>sudo dpkg -i ./session-manager-plugin.deb<br>session-manager-plugin --version</pre><h3>Passo 2. Preparação do Ambiente AWS para Acesso a Instâncias EC2 Linux</h3><h4>2.1. Policy IAM</h4><p>No console IAM, em Policies, crie a policy &lt;NOME_DA_POLICY_SSM_LINUX&gt; pelo editor JSON. Ela permite iniciar sessões no documento SSM-SessionManagerRunShell, abrir o canal de dados e encerrar ou retomar as sessões do próprio usuário:</p><pre>{<br>    &quot;Version&quot;:&quot;2012-10-17&quot;,<br>    &quot;Statement&quot;: [<br>        {<br>            &quot;Effect&quot;: &quot;Allow&quot;,<br>            &quot;Action&quot;: [<br>                &quot;ssm:StartSession&quot;,<br>                &quot;ssm:SendCommand&quot;<br>            ],<br>            &quot;Resource&quot;: [<br>                &quot;arn:aws:ec2:*:*:instance/*&quot;,<br>                &quot;arn:aws:ssm:*:*:document/SSM-SessionManagerRunShell&quot;<br>            ]<br>        },<br>        {<br>         &quot;Effect&quot;: &quot;Allow&quot;,<br>         &quot;Action&quot;: [&quot;ssmmessages:OpenDataChannel&quot;],<br>         &quot;Resource&quot;: [&quot;arn:aws:ssm:*:*:session/${aws:userid}-*&quot;]<br>       },<br>        {<br>            &quot;Effect&quot;: &quot;Allow&quot;,<br>            &quot;Action&quot;: [<br>                &quot;ssm:GetConnectionStatus&quot;,<br>                &quot;ssm:DescribeInstanceInformation&quot;<br>            ],<br>            &quot;Resource&quot;: &quot;*&quot;<br>        },<br>        {<br>            &quot;Effect&quot;: &quot;Allow&quot;,<br>            &quot;Action&quot;: [<br>                &quot;ssm:TerminateSession&quot;,<br>                &quot;ssm:ResumeSession&quot;<br>            ],<br>            &quot;Resource&quot;: [<br>                &quot;arn:aws:ssm:*:*:session/${aws:username}-*&quot;<br>            ]<br>        }<br>    ]<br>}</pre><p>Do jeito que está, a policy vale para qualquer instância da conta. Há dois filtros para restringir o alcance, ambos nas actions ssm:StartSession e ssm:SendCommand:</p><ul><li><strong>Por instância:</strong> troque o primeiro recurso pelo ARN da instância.</li></ul><pre>&quot;Resource&quot;: [<br>    &quot;arn:aws:ec2:&lt;REGIÃO&gt;:&lt;ID_CONTA_AWS&gt;:instance/&lt;ID_INSTÂNCIA_EC2&gt;&quot;,<br>    &quot;arn:aws:ssm:*:*:document/SSM-SessionManagerRunShell&quot;<br>]</pre><ul><li><strong>Por tag:</strong> inclua a seção Condition no mesmo statement.</li></ul><pre>&quot;Condition&quot;: {<br>    &quot;StringEquals&quot;: {<br>        &quot;ssm:resourceTag/&lt;NOME_DA_TAG&gt;&quot;: &quot;&lt;VALOR_DA_TAG&gt;&quot;<br>    }<br>}</pre><h4>2.2. Grupo IAM</h4><p>Crie o grupo &lt;NOME_DO_GRUPO_SSM&gt;.</p><p>Em <em>Attach permissions policies</em>, anexe &lt;NOME_DA_POLICY_SSM_LINUX&gt; e a policy gerenciada SignInLocalDevelopmentAccess, necessária para o aws login.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/962/1*xziFFhk2wOZSzJSWoVFRKQ.png" /></figure><h4>2.3. Usuário IAM</h4><p>Crie o usuário &lt;NOME_DO_USUÁRIO&gt; com acesso ao AWS Management Console e adicione-o ao grupo &lt;NOME_DO_GRUPO_SSM&gt;.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*RXZou38SvB2Jef6dDr9b0w.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*LSlFVyFHqFTGvOsd3jE5Rg.png" /></figure><h4>2.4. Security Group da instância</h4><p>O SSM trabalha com conexões de saída, então a sessão não exige nenhuma porta de entrada para SSH: o Security Group fica sem regras de <em>Inbound</em> para SSH. A instância precisa ter acesso de saída à Internet.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1015/1*FKY3-5tZoEkMu4z370hB_w.png" /></figure><h4>2.5. Autenticação do AWS CLI</h4><p>Utilize o comando abaixo para iniciar o aws login. O parâmetro --profile é opcional; utilize-o caso você trabalhe com várias contas AWS:</p><pre>aws login [--profile &lt;NOME_DO_PROFILE&gt;]</pre><p>O comando abre o navegador para o login do usuário IAM e grava credenciais temporárias no profile.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*NUOmugtVYoMC6aPTZ4x8Dg.png" /></figure><p>Para fixar o profile na sessão do terminal, sem repetir --profile em cada comando:</p><pre>export AWS_PROFILE=&lt;NOME_DO_PROFILE&gt;</pre><h4>2.6. Conexão à instância Linux</h4><p>O comando abaixo inicia a sessão SSM com a instância desejada:</p><pre>aws ssm start-session --target &lt;ID_INSTÂNCIA_EC2&gt; [--profile &lt;NOME_DO_PROFILE&gt;]</pre><p>A sessão abre com o usuário padrão do SSM. Para trabalhar com a conta desejada da instância (P6):</p><pre>sudo su - &lt;CONTA_INSTANCIA_EC2&gt;</pre><p>&lt;CONTA_INSTANCIA_EC2&gt; depende do sistema operacional da instância EC2. Costuma ser &quot;admin&quot; para Debian, &quot;ubuntu&quot; para Ubuntu e &quot;ec2-user&quot; para Amazon Linux.</p><h3>3. Preparação do Ambiente AWS para Acesso a Instâncias EC2 Windows</h3><p>A criação do grupo e do usuário IAM é idêntica à do Linux. Muda apenas a policy, que precisa cobrir o acesso RDP sobre SSM.</p><h4>3.1. Policy IAM</h4><p>Crie a policy &lt;NOME_DA_POLICY_SSM_WINDOWS&gt; pelo editor JSON e anexe-a ao grupo &lt;NOME_DO_GRUPO_SSM&gt;, junto com a SignInLocalDevelopmentAccess.</p><p>O statement AccessTaggedInstances limita o acesso às instâncias que tenham a tag informada; o DocumentoPortForwarding libera o documento usado no túnel RDP pela linha de comando. Os statements com ssm-guiconnect e aws:CalledVia atendem ao Remote Desktop do Fleet Manager, pelo console.</p><pre>{<br>  &quot;Version&quot;: &quot;2012-10-17&quot;,<br>  &quot;Statement&quot;: [<br>    {<br>      &quot;Sid&quot;: &quot;LeituraEC2ParaFleetManager&quot;,<br>      &quot;Effect&quot;: &quot;Allow&quot;,<br>      &quot;Action&quot;: [<br>        &quot;ec2:DescribeInstances&quot;,<br>        &quot;ec2:GetPasswordData&quot;<br>      ],<br>      &quot;Resource&quot;: &quot;*&quot;<br>    },<br>    {<br>      &quot;Sid&quot;: &quot;LeituraSSMParaFleetManager&quot;,<br>      &quot;Effect&quot;: &quot;Allow&quot;,<br>      &quot;Action&quot;: [<br>        &quot;ssm:DescribeInstanceProperties&quot;,<br>        &quot;ssm:GetCommandInvocation&quot;,<br>        &quot;ssm:GetInventorySchema&quot;<br>      ],<br>      &quot;Resource&quot;: &quot;*&quot;<br>    },<br>    {<br>      &quot;Sid&quot;: &quot;AccessTaggedInstances&quot;,<br>      &quot;Effect&quot;: &quot;Allow&quot;,<br>      &quot;Action&quot;: &quot;ssm:StartSession&quot;,<br>      &quot;Resource&quot;: [<br>        &quot;arn:aws:ec2:*:*:instance/*&quot;,<br>        &quot;arn:aws:ssm:*:*:managed-instance/*&quot;<br>      ],<br>      &quot;Condition&quot;: {<br>        &quot;StringEquals&quot;: {<br>          &quot;ssm:resourceTag/NOME_DA_TAG&quot;: &quot;VALOR_DA_TAG&quot;<br>        }<br>      }<br>    },<br>    {<br>      &quot;Sid&quot;: &quot;DocumentoShellCLI&quot;,<br>      &quot;Effect&quot;: &quot;Allow&quot;,<br>      &quot;Action&quot;: &quot;ssm:StartSession&quot;,<br>      &quot;Resource&quot;: &quot;arn:aws:ssm:*:*:document/SSM-SessionManagerRunShell&quot;<br>    },<br>    {<br>      &quot;Sid&quot;: &quot;DocumentoPortForwarding&quot;,<br>      &quot;Effect&quot;: &quot;Allow&quot;,<br>      &quot;Action&quot;: &quot;ssm:StartSession&quot;,<br>      &quot;Resource&quot;: &quot;arn:aws:ssm:*::document/AWS-StartPortForwardingSession&quot;<br>    },<br>    {<br>      &quot;Sid&quot;: &quot;OpenDataChannelCLI&quot;,<br>      &quot;Effect&quot;: &quot;Allow&quot;,<br>      &quot;Action&quot;: &quot;ssmmessages:OpenDataChannel&quot;,<br>      &quot;Resource&quot;: &quot;arn:aws:ssm:*:*:session/${aws:userid}-*&quot;<br>    },<br>    {<br>      &quot;Sid&quot;: &quot;OpenDataChannelFleetManager&quot;,<br>      &quot;Effect&quot;: &quot;Allow&quot;,<br>      &quot;Action&quot;: &quot;ssmmessages:OpenDataChannel&quot;,<br>      &quot;Resource&quot;: &quot;arn:aws:ssm:*:*:session/*&quot;,<br>      &quot;Condition&quot;: {<br>        &quot;ForAnyValue:StringEquals&quot;: {<br>          &quot;aws:CalledVia&quot;: &quot;ssm-guiconnect.amazonaws.com&quot;<br>        }<br>      }<br>    },<br>    {<br>      &quot;Sid&quot;: &quot;EncerrarEReconectarPropriasSessoes&quot;,<br>      &quot;Effect&quot;: &quot;Allow&quot;,<br>      &quot;Action&quot;: [<br>        &quot;ssm:TerminateSession&quot;,<br>        &quot;ssm:ResumeSession&quot;<br>      ],<br>      &quot;Resource&quot;: &quot;arn:aws:ssm:*:*:session/${aws:userid}-*&quot;<br>    },<br>    {<br>      &quot;Sid&quot;: &quot;EncerrarSessaoFleetManager&quot;,<br>      &quot;Effect&quot;: &quot;Allow&quot;,<br>      &quot;Action&quot;: &quot;ssm:TerminateSession&quot;,<br>      &quot;Resource&quot;: &quot;*&quot;,<br>      &quot;Condition&quot;: {<br>        &quot;StringLike&quot;: {<br>          &quot;ssm:resourceTag/aws:ssmmessages:session-id&quot;: &quot;${aws:userid}&quot;<br>        }<br>      }<br>    },<br>    {<br>      &quot;Sid&quot;: &quot;GuiConnect&quot;,<br>      &quot;Effect&quot;: &quot;Allow&quot;,<br>      &quot;Action&quot;: [<br>        &quot;ssm-guiconnect:CancelConnection&quot;,<br>        &quot;ssm-guiconnect:GetConnection&quot;,<br>        &quot;ssm-guiconnect:StartConnection&quot;,<br>        &quot;ssm-guiconnect:ListConnections&quot;<br>      ],<br>      &quot;Resource&quot;: &quot;*&quot;<br>    }<br>  ]<br>}</pre><p>Para restringir por instância, em vez de (ou além de) tag, troque o primeiro recurso do statement AccessTaggedInstances pelo ARN da instância:</p><pre>&quot;Resource&quot;: [<br>    &quot;arn:aws:ec2:&lt;REGIÃO&gt;:&lt;ID_CONTA_AWS&gt;:instance/&lt;ID_INSTÂNCIA_EC2&gt;&quot;,<br>    &quot;arn:aws:ssm:*:*:managed-instance/*&quot;<br>]</pre><h4>3.2. Security Group da instância</h4><p>O mesmo princípio do Linux: nenhuma regra de entrada para RDP é necessária.</p><p>A instância precisa ter acesso de saída à Internet.</p><h4>3.3. Autenticação do AWS CLI</h4><p>Utilize o comando abaixo para iniciar o aws login. O parâmetro --profile é opcional; utilize-o caso você trabalhe com várias contas AWS:</p><pre>aws login [--profile &lt;NOME_DO_PROFILE&gt;]</pre><p>O comando abre o navegador para o login do usuário IAM e grava credenciais temporárias no profile. Para fixar o profile na sessão do terminal, sem repetir --profile em cada comando:</p><pre>export AWS_PROFILE=&lt;NOME_DO_PROFILE&gt;</pre><h4>3.4. Conexão à instância Windows</h4><p>No terminal, abra o túnel entre uma porta local e a porta 3389 da instância, e mantenha o terminal aberto enquanto a conexão RDP estiver em uso:</p><pre>aws ssm start-session --target &lt;ID_DA_INSTANCIA&gt; --document-name AWS-StartPortForwardingSession --parameters portNumber=&quot;3389&quot;,localPortNumber=&quot;&lt;PORTA_LOCAL&gt;&quot; [--profile &lt;NOME_DO_PROFILE&gt;]</pre><p>No Remmina, crie uma conexão RDP para 127.0.0.1:&lt;PORTA_LOCAL&gt; e informe as credenciais do Windows.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/973/1*kiK9ZhJqM3KINQdHepFRaw.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*q68oA9ppYwHwTupbYzPNaw.png" /></figure><h3>Conclusão</h3><p>O acesso às instâncias passou a depender apenas de IAM e de conexões de saída. O Security Group não tem regras de entrada, nem para o shell do Linux nem para o RDP do Windows, e a autenticação do AWS CLI usa credenciais temporárias obtidas com aws login, no lugar de Access Keys de longa duração.</p><p>O mesmo modelo atende os dois sistemas operacionais. A diferença está na policy: o Linux usa o documento SSM-SessionManagerRunShell, e o Windows soma o documento AWS-StartPortForwardingSession, que leva o RDP por um túnel até 127.0.0.1. Como o alcance é definido na policy, ele pode ser restrito por instância ou por tag, e cada pessoa só encerra e retoma as próprias sessões.</p><h3>Fontes Oficiais para Consulta</h3><p><strong>Sample IAM policies for Session Manager:</strong><br> <a href="https://docs.aws.amazon.com/systems-manager/latest/userguide/getting-started-restrict-access-quickstart.html">https://docs.aws.amazon.com/systems-manager/latest/userguide/getting-started-restrict-access-quickstart.html</a></p><p><strong>Connecting to a Windows Server managed instance using Remote Desktop:</strong><br> <a href="https://docs.aws.amazon.com/">https://docs.aws.amazon.com</a><a href="https://docs.aws.eu/systems-manager/latest/userguide/fleet-manager-remote-desktop-connections.html">/systems-manager/latest/userguide/fleet-manager-remote-desktop-connections.html</a></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=540affd228ee" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[VM Hyper-V com Ubuntu 26.04 para Trabalhar com Desenvolvimento em Cloud]]></title>
            <link>https://marcelopalenzuela.medium.com/vm-hyper-v-com-ubuntu-26-04-para-trabalhar-com-desenvolvimento-em-cloud-183d0f8506eb?source=rss-a209874e5d6a------2</link>
            <guid isPermaLink="false">https://medium.com/p/183d0f8506eb</guid>
            <category><![CDATA[git]]></category>
            <category><![CDATA[cloud-computing]]></category>
            <category><![CDATA[python]]></category>
            <category><![CDATA[hypervisors]]></category>
            <category><![CDATA[docker]]></category>
            <dc:creator><![CDATA[Marcelo Palenzuela]]></dc:creator>
            <pubDate>Sun, 18 Oct 2026 12:08:00 GMT</pubDate>
            <atom:updated>2026-10-27T03:21:51.208Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*kF06cEu7x-czC4Po5SDNrQ.png" /></figure><p>Este artigo documenta todos os passos técnicos necessários para preparar uma máquina virtual Linux, utilizada para estudar e trabalhar com cloud e desenvolvimento. Utilizaremos o <strong>Hyper-V</strong>, que já vem disponível no Windows 11 Pro, edição também usada em ambientes corporativos.</p><p>O resultado é uma VM com <strong>Ubuntu Server 26.04 LTS</strong> e ambiente gráfico <strong>XFCE</strong>, acessada pelo Gerenciador do Hyper-V (VMConnect) ou pela Conexão de Área de Trabalho Remota por meio do <strong>xRDP</strong>. Sobre ela vamos instalar as principais ferramentas de trabalho: Google Chrome, Sublime Text, Node.js (NVM), Python (Pyenv), Docker, VS Code, DBeaver, AWS CLI, Git e o <strong>Kiro CLI</strong>, o agente de IA de linha de comando da AWS.</p><p>O artigo é um passo a passo com as telas de cada etapa, para ser seguido do começo ao fim.</p><h3>Arquitetura</h3><p>O computador com Windows 11 Pro é o host. Nele, o Hyper-V executa a VM Ubuntu Server 26.04 (Geração 2), conectada à rede por um comutador virtual externo. O acesso à VM é feito pelo xRDP instalado no Ubuntu, com transporte HvSocket ou da Conexão de Área de Trabalho Remota. As ferramentas de desenvolvimento ficam instaladas dentro da VM.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*bx5H2iv52ucgnMa9JzNMlg.png" /></figure><h3>1. Pré-requisitos</h3><p>Antes de criar a VM, confirme os itens abaixo no computador host.</p><p>a. <strong>Edição do Windows:</strong> o Hyper-V exige Windows 11 <strong>Pro</strong> ou <strong>Enterprise</strong>. Ele não pode ser instalado no Windows 11 Home.</p><p>b. <strong>Hardware:</strong> processador de 64 bits com SLAT (<em>Second Level Address Translation</em>), com suporte a VM Monitor Mode Extension, e no mínimo 4 GB de memória no host.</p><p>c. <strong>Virtualização habilitada no firmware (BIOS/UEFI):</strong> se o Hyper-V não iniciar VMs, verifique essa opção no firmware do computador.</p><p>d. <strong>Hyper-V habilitado.</strong> Abra o <strong>PowerShell como Administrador</strong> e execute:</p><pre>Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Hyper-V -All</pre><p>Quando o PowerShell pedir, digite Y para <strong>reiniciar o computador</strong> e concluir a instalação. Depois do reinício, o <strong>Gerenciador do Hyper-V</strong> aparece no menu Iniciar.</p><h3>2. Configuração da VM no Hyper-V</h3><h4>2.1. Configuração do Comutador Virtual</h4><p>O comutador virtual externo conecta a VM à rede física e à Internet.</p><p>a. No painel <strong>Ações</strong> do Gerenciador do Hyper-V, clique em <strong>Gerenciador de Comutador Virtual</strong>.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/480/1*NKJ5bVZXSSUxYldC4WBn-g.png" /></figure><p>b. Selecione o tipo <strong>Externo</strong> e clique em <strong>Criar Comutador Virtual</strong>.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/726/1*ZFhY13mKk0ZNVmXPF8lPKA.png" /></figure><p>c. Dê um nome ao comutador, escolha o adaptador de rede físico em <strong>Rede externa</strong> e mantenha marcada a opção de compartilhar o adaptador com o sistema operacional de gerenciamento. Clique em <strong>OK</strong>.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/729/1*1St_5tBZJ0IMBHDzhxOdBg.png" /></figure><h4>2.2. Configuração da VM com Ubuntu 26.04</h4><p>a. Baixe a imagem do Ubuntu 26.04 Server LTS:</p><p><a href="https://ubuntu.com/download/server">https://ubuntu.com/download/server</a></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*xRl32PWvcgzXI5DhbANVQA.png" /></figure><p>b. No Gerenciador do Hyper-V, clique com o botão direito no host e escolha <strong>Novo &gt; Máquina Virtual</strong>.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/593/1*-NNr5FPQKxVZKx4Hv_lWeg.png" /></figure><p>c. Na tela <strong>Antes de Começar</strong>, clique em <strong>Avançar</strong>.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/707/1*jE4P486cWKqjnR6S3Fc84g.png" /></figure><p>d. Em <strong>Especificar Nome e Local</strong>, informe &lt;NOME_DA_VM&gt; e, se desejar, escolha outra pasta para armazenar a VM.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/707/1*qYM5NW8QdPQ-GqQ84bD0Wg.png" /></figure><p>e. Em <strong>Especificar Geração</strong>, escolha <strong>Geração 2</strong>. A geração não pode ser alterada depois que a VM é criada.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/707/1*Pquk9WJ2rcRaCHt4x_cUkA.png" /></figure><p>f. Em <strong>Atribuir Memória</strong>, defina a memória inicial. Se possível, utilize ao menos 4096MB.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/707/1*UXAZBPx51K0nlPgjQ3QfXA.png" /></figure><p>g. Em <strong>Configurar Rede</strong>, selecione o comutador virtual &lt;NOME_DO_SWITCH&gt; criado na etapa 2.1.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/705/1*ZonVJo7m-hHZsr0406sdYQ.png" /></figure><p>h. Em <strong>Conectar Disco Rígido Virtual</strong>, crie o disco virtual informando nome, local e tamanho.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/706/1*SPNZgXvU6VmdDrlVijxq3w.png" /></figure><p>i. Em <strong>Opções de Instalação</strong>, selecione <strong>Instalar um sistema operacional de um arquivo de imagem inicializável</strong> e aponte para a ISO baixada.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/707/1*z16Z9qpv3331mBQZm95svA.png" /></figure><p>j. Confira o resumo e clique em <strong>Concluir</strong>.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/707/1*xbE_6EQjXtsGlBMBWpVdew.png" /></figure><h4>2.3. Ajustes da VM Antes de Iniciar a Instalação</h4><p>a. Nas configurações da VM, abra <strong>Segurança</strong> e desmarque <strong>Habilitar Inicialização Segura</strong>.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/725/1*-p-WC3cB2a5s5FKQP-LztQ.png" /></figure><p>b. Em <strong>Memória</strong>, defina ao menos <strong>4096</strong> <strong>MB</strong> de RAM de inicialização e desmarque <strong>Habilitar Memória Dinâmica</strong>.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/724/1*cOLei5dny_iBJCjOKfyknQ.png" /></figure><p>c. Em <strong>Processador</strong>, defina a quantidade de processadores virtuais.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/729/1*pSLc-OVVLIygqi1Tj10uIg.png" /></figure><p>d. Em <strong>Serviços de Integração</strong>, marque todos os serviços, inclusive <strong>Serviços convidados</strong>.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/725/1*ZxVgQnbmsW6L9o64jBlpSA.png" /></figure><p>e. Em <strong>Pontos de Verificação</strong>, desmarque <strong>Habilitar pontos de verificação</strong> (opcional).</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/724/1*m0AzYn71MIxySZIkMrojlw.png" /></figure><h4>2.4. Instalação do Ubuntu 26.04 na VM</h4><p><strong>2.4.1. Início do Instalador</strong></p><p>a. Dê um duplo clique na VM para abrir o VMConnect e clique em <strong>Iniciar</strong>.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/644/1*rbEk91ksbZKKOV3pL5zlDg.png" /></figure><p>b. No menu do GRUB, escolha <strong>Try or Install Ubuntu Server</strong>.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*oGPZKq_bWq8wDRN5qDI7Ow.png" /></figure><p>c. Para sistemas e plataformas de trabalho em nuvem, recomendo sempre utilizar o idioma inglês. Selecione o idioma <strong>English</strong>.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*gUmYlprbTjCysqwSoKaERw.png" /></figure><p>d. Selecione o layout de teclado <strong>Portuguese (Brazil)</strong>. Em Variant, selecione <strong>Portuguese (Brazil, no dead keys)</strong>; essa variante funciona com a maioria dos teclados brasileiros.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*atmNEGCBtIEQgRCzH2ZwBA.png" /></figure><p>e. Mantenha o tipo de instalação <strong>Ubuntu Server</strong> (não minimizado).</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*v2UmksJbGar3NdlPwIA3TA.png" /></figure><p>f. Na configuração de rede, confirme que a interface recebeu endereço IP por DHCP.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*f2T30YSIB5QkCKmXZfTF0w.png" /></figure><p>g. Caso utilize um servidor proxy para acesso à Internet, preencha o seu endereço aqui. Deixe o endereço de proxy em branco se não possuir um.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*bW4VP2RhLlZ7xx258hwxew.png" /></figure><p>h. Aguarde a mensagem de que o mirror passou nos testes (<em>This mirror location passed tests</em>) e continue.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*8UcnVPUwcBD4KbVTKz2PgA.png" /></figure><p><strong>2.4.2. Configuração do Armazenamento</strong></p><p>a. Em <strong>Guided storage configuration</strong>, escolha <strong>Custom storage layout</strong>.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*OH5JbpA_hz1sjlJo-xXb8A.png" /></figure><p>b. Em <strong>AVAILABLE DEVICES</strong>, selecione o disco físico &lt;DISCO&gt; e pressione Enter.</p><p>Escolha <strong>Use As Boot Device</strong>.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*FpFT_1ieLR2feyCAElZ3qQ.png" /></figure><p>c. Confirme que o <strong>FILE SYSTEM SUMMARY</strong> passou a listar o ponto de montagem de boot:</p><ul><li>firmware <strong>UEFI</strong>: aparece /boot/efi, fat32, em uma partição nova (ESP);</li><li>firmware <strong>BIOS legado</strong>: o instalador cria uma pequena partição não formatada no início do disco para o GRUB, e não aparece /boot/efi.</li></ul><p>d. Em <strong>AVAILABLE DEVICES</strong>, selecione o disco &lt;DISCO&gt; (ou a linha <strong>free space</strong> dele) e pressione Enter.</p><p>Escolha <strong>Add GPT Partition</strong>.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*3XrXxm2o7OjhQRL6-CQG-w.png" /></figure><p>e. Preencha o formulário, com sugestão inicial de <strong>4 GB</strong>:</p><ul><li><strong>Size</strong>: 4G</li><li><strong>Format</strong>: ext4</li><li><strong>Mount</strong>: /boot</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/601/1*u8X9Fs_JqcYe43NUsvCXkA.png" /></figure><p>Selecione <strong>Create</strong>.</p><p>f. Em <strong>AVAILABLE DEVICES</strong>, selecione novamente o disco &lt;DISCO&gt; e pressione Enter.</p><p>Escolha <strong>Add GPT Partition</strong>.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*1ixMLSFhVpEBLeFe-s0d5w.png" /></figure><p>g. Preencha o formulário:</p><ul><li><strong>Size</strong>: deixe em branco (usa todo o espaço restante)</li><li><strong>Format</strong>: Leave unformatted</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/598/1*ytvC03uJH7huv42qcIfGEg.png" /></figure><p>Selecione <strong>Create</strong>.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/689/1*aET_lU0KiRDd0BMt093ENw.png" /></figure><p>h. Em <strong>AVAILABLE DEVICES</strong>, selecione <strong>Create volume group (LVM)</strong>.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*SOc5Q0JMR9XJHAAg7Z5Qrg.png" /></figure><p>i. Preencha o diálogo:</p><ul><li><strong>Name</strong>: &lt;NOME_VG&gt;</li><li><strong>Devices</strong>: marque apenas a partição de dados</li><li><strong>Create encrypted volume</strong>: marcado</li><li><strong>Passphrase</strong> e <strong>Confirm passphrase</strong>: informe &lt;PASSPHRASE&gt;</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/601/1*pl80NStJC2HaNz1BHTBvXA.png" /></figure><p>Selecione <strong>Create</strong>.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/686/1*i8SPhYohwJZFDMVD0YCuDw.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/686/1*Wl3nUfCPYKauK-gq9JvzUg.png" /></figure><p>l. Em <strong>USED DEVICES</strong>, selecione o volume group &lt;NOME_VG&gt; e pressione Enter.</p><p>Escolha <strong>Create Logical Volume</strong>.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*fJzTBHM1td0wtUCZ6Joegg.png" /></figure><p>m. Preencha:</p><ul><li><strong>Name</strong>: &lt;NOME_LV_SWAP&gt;</li><li><strong>Size</strong>: &lt;TAMANHO_SWAP&gt;</li><li><strong>Format</strong>: swap</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/607/1*5SHqrpEeNe_rHKAUyrBGLA.png" /></figure><p>Selecione <strong>Create</strong>.</p><p>n. Selecione novamente o volume group &lt;NOME_VG&gt; e pressione Enter.</p><p>Escolha <strong>Create Logical Volume</strong>.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*8tyxxf5DJs1V_ixHPVF8Ig.png" /></figure><p>o. Preencha:</p><ul><li><strong>Name</strong>: &lt;NOME_LV_ROOT&gt;</li><li><strong>Size</strong>: &lt;TAMANHO_ROOT&gt;</li><li><strong>Format</strong>: ext4</li><li><strong>Mount</strong>: /</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/599/1*E0fHBRGKNNxz9Hi87LhYhg.png" /></figure><p>Selecione <strong>Create</strong>.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/687/1*awbk3Uayro6CLw7zZl5gmA.png" /></figure><p>p. Confira o resumo final do armazenamento e selecione <strong>Done</strong>.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*dCF2i-BzDbOIps72IBa0Hw.png" /></figure><h4>2.4.3. Conclusão da Instalação</h4><p>a. Revise o aviso de ação destrutiva e selecione <strong>Continue</strong>.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/598/1*wHdVFsUo22cYhUNBX4zGVg.png" /></figure><p>b. Informe seu nome, o nome do servidor, o nome de usuário e a senha.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*mMQE0srLlCXyLeah7I-cxQ.png" /></figure><p>c. Em <strong>Ubuntu Pro</strong>, selecione <strong>Skip for now</strong>.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*RreUA0L8R-lUq_li4SgEqw.png" /></figure><p>d. Na tela de SSH, mantenha o servidor OpenSSH desmarcado (neste laboratório ele não foi instalado).</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*5mQwe-Yxx2Onqt9TPX-FOg.png" /></figure><p>e. Em <strong>Featured Server Snaps</strong>, não selecione nenhum snap.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*posx0fj_kuN-WdbfAGlCjg.png" /></figure><p>f. Aguarde a conclusão da instalação.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*FZFHeX030xfh6kONx4DivA.png" /></figure><p>g. Quando a instalação terminar, selecione <strong>Reboot Now</strong>.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*dNw_YYldSHBCNxLg6cIkZQ.png" /></figure><p>h. Quando aparecer o aviso para remover a mídia de instalação, ejete a ISO no VMConnect (menu <strong>Mídia &gt; Unidade de DVD</strong>) e pressione Enter.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*j6w_kM52TA475FfcRPq8TQ.png" /></figure><p>i. Digite a passphrase do disco quando for solicitada. Ela é pedida a cada inicialização do servidor.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*FCiAuZdjyBbGepjc9It-Hg.png" /></figure><p>j. Faça login com o usuário criado na instalação.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*RLxZ7Pav4dy6Ja-_BJsCwQ.png" /></figure><p>k. Após o login, confirme a versão do kernel e o endereço IP exibidos.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*xxw3K3PwcSAAenkrXkDg5w.png" /></figure><h3>3. Instalação do Desktop Environment e do XFCE</h3><p>Instale a interface gráfica XFCE no servidor Ubuntu:</p><p>a. <strong>Atualize sua lista de repositórios e pacotes instalados:</strong></p><pre>sudo apt update &amp;&amp; sudo apt upgrade -y</pre><p>b. Atualize o timezone do servidor:</p><pre>sudo timedatectl list-timezones<br>sudo timedatectl set-timezone America/Sao_Paulo<br>date</pre><p>c. Instale o tasksel e execute-o:</p><pre>sudo apt install tasksel -y<br>sudo tasksel</pre><p>d. Na tela do tasksel, use a barra de espaço para marcar as opções <strong>Debian desktop environment</strong> e <strong>Xfce</strong> e confirme em <strong>Ok</strong>.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*U59SQOXxtwdpvZ4EHBC-sQ.png" /></figure><p>e. Aguarde a instalação dos pacotes.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*-v99TkFOXKzFnZiZr52taQ.png" /></figure><h3>4. Instalação do Agente de Integração do Hyper-V</h3><p>a. <strong>Instale os pacotes de integração:</strong></p><pre>sudo apt install linux-cloud-tools-virtual linux-tools-virtual -y</pre><p>b. Faça o reboot do servidor:</p><pre>sudo reboot</pre><p>c. Após o reboot, confirme que a tela de login gráfica é exibida.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*9xYSblVNuZVodXa3X1R_hg.png" /></figure><p>d. <strong>Habilite os serviços:</strong></p><pre>sudo systemctl enable --now hv-kvp-daemon.service<br>sudo systemctl enable --now hv-vss-daemon.service<br>sudo systemctl enable --now hv-fcopy-daemon.service</pre><p>O que isso muda na prática?</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/691/1*fbucnH_odssh5JNfgy31ng.png" /></figure><h3>5. Configurar o Acesso Remoto à VM com xRDP</h3><h4>5.1. Instalar o Servidor XRDP</h4><p>a. Abra o terminal no seu Ubuntu e instale os pacotes necessários:</p><pre>sudo apt install xrdp xorgxrdp -y</pre><h4>5.2. Configurar o Script de Inicialização</h4><p>a. Edite o arquivo de configuração do XRDP:</p><pre>sudo nano /etc/xrdp/xrdp.ini</pre><p>Execute os passos a.1. e a.2. se o acesso ao servidor Ubuntu ocorrer através do Hyper-V Manager (VMConnect). Se for usar o Conexão de Área de Trabalho Remota para acessar o servidor, pule para os passos a.3. e a.4..</p><p>a.1. Procure pela linha port=3389 e altere para: <strong>port=vsock://-1:3389</strong></p><p>a.2. Procure por use_vsock e configure para: <strong>use_vsock=true</strong></p><p>a.3. Procure por security_layer=negotiate e altere para: <strong>security_layer=rdp</strong></p><p>a.4. Salve (Ctrl+O, Enter) e saia (Ctrl+X).</p><p>b. Edite o arquivo de configuração /etc/X11/Xwrapper.config:</p><pre>sudo nano /etc/X11/Xwrapper.config</pre><p>Procure por allowed_users=console e altere para: <strong>allowed_users=anybody</strong></p><p>c. Crie o arquivo ~/.xsession:</p><pre>echo xfce4-session &gt; ~/.xsession</pre><p>d. Dê permissão ao xrdp criar o socket de SSL:</p><pre>sudo usermod -aG ssl-cert xrdp</pre><p>e. Reinicie o serviço do XRDP:</p><pre>sudo systemctl restart xrdp.service &amp;&amp; sudo systemctl status xrdp.service<br># Verifique se o target de inicialização é graphical.target:<br>sudo systemctl get-default<br># Altere o target padrão para graphical.target, se necessário:<br>sudo systemctl set-default graphical.target</pre><p>f. Faça o reboot do servidor:</p><pre>sudo reboot</pre><p>g. No login do xRDP, mantenha <strong>Session</strong> em <strong>Xorg</strong> e entre com o seu usuário e senha.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*t3zh2hZZNWjlq6TBHbzuuw.png" /></figure><p>A partir daqui, seguimos as configurações da VM utilizando a interface gráfica.</p><h4>5.3. Configurar a VM no Windows (PowerShell)</h4><p>Execute esse passo caso o acesso ao servidor Ubuntu ocorra diretamente através do Hyper-V Manager (VMConnect). Se for usar o Conexão de Área de Trabalho Remota para acessar o servidor, pule esse passo.</p><p>O Hyper-V não ativa o suporte a transporte por soquete para Linux por padrão. Você pode habilitá-lo com o transporte <strong>HvSocket</strong>, através do <strong>PowerShell como Administrador</strong> no seu Windows:</p><p>a. Anote o nome exato da VM, que aparece em <strong>Configurações &gt; Nome</strong>. Você o usará nos comandos abaixo.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/723/1*4iWhvpIp2tXbpgpVm0xCQQ.png" /></figure><p>b. Habilite o transporte de soquete para a VM, informando HvSocket:</p><pre>Set-VM -VMName &quot;&lt;NOME_DA_VM&gt;&quot; -EnhancedSessionTransportType &lt;TRANSPORTE&gt;</pre><p>c. Para verificar o transporte configurado:</p><pre>Get-VM -VMName &quot;&lt;NOME_DA_VM&gt;&quot; | Select-Object Name, EnhancedSessionTransportType</pre><h4>5.4. Habilitar o Modo de Sessão no Gerenciador do Hyper-V</h4><p>Execute esse passo caso o acesso ao servidor Ubuntu ocorra diretamente através do Hyper-V Manager (VMConnect). Se for usar o Conexão de Área de Trabalho Remota para acessar o servidor, pule esse passo.</p><p>a. No <strong>Gerenciador do Hyper-V</strong>, vá em <strong>Configurações do Hyper-V</strong> (no menu lateral direito, para o servidor todo).</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/523/1*7W7uLndmDFdbGWIOJPjgeA.png" /></figure><p>b. Em <strong>Política de Modo de Sessão Avançada</strong>, marque “Permitir modo de sessão avançada”.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/725/1*BFz7j4BjURWNdc8SCE6THg.png" /></figure><p>Alternativamente, a política do servidor pode ser habilitada pelo <strong>PowerShell como Administrador</strong>:</p><pre>Set-VMHost -EnableEnhancedSessionMode $true</pre><p>c. Ao abrir a VM pelo VMConnect, clique no ícone de <strong>Sessão Avançada</strong> na barra de ferramentas para alternar para a sessão avançada.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/391/1*yVnBWl83Xh89k9IcaIgzzg.png" /></figure><h4>5.5. Habilitar o Áudio da VM com PipeWire</h4><p>a. Instale o PipeWire:</p><pre>sudo apt install pipewire pipewire-pulse wireplumber pipewire-module-xrdp -y</pre><p>b. Habilite o PipeWire:</p><pre>systemctl --user mask pulseaudio.service pulseaudio.socket<br>systemctl --user --now enable pipewire pipewire-pulse wireplumber<br>sudo systemctl restart xrdp.service</pre><p>c. Faça <strong>logoff e conecte de novo</strong> (ou reinicie a VM) e confira:</p><pre>pactl info | grep &quot;Server Name&quot;<br>pactl list short sinks</pre><p>O esperado é PulseAudio (on PipeWire ...) e um sink com “xrdp” no nome.</p><h3>6. Instalação de Ferramentas</h3><h4>6.1. Google Chrome</h4><p>a. Para fazer o download na versão mais recente sempre, pode utilizar a linha de comando abaixo:</p><pre>curl -L -o ~/chrome.deb https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.deb</pre><p>b. Instale o pacote de instalação do Google Chrome:</p><pre>sudo apt install ~/chrome.deb</pre><h4>6.2. Sublime Text</h4><p>a. O Sublime Text é uma ótima alternativa ao Notepad++ para Linux. Siga o procedimento abaixo para instalar:</p><pre>cd ~/<br>sudo mkdir -p /etc/apt/keyrings<br>wget -qO - https://download.sublimetext.com/sublimehq-pub.gpg | sudo tee /etc/apt/keyrings/sublimehq-pub.asc &gt; /dev/null<br>echo -e &#39;Types: deb\nURIs: https://download.sublimetext.com/\nSuites: apt/stable/\nSigned-By: /etc/apt/keyrings/sublimehq-pub.asc&#39; | sudo tee /etc/apt/sources.list.d/sublime-text.sources<br>sudo apt-get update<br>sudo apt-get install sublime-text -y</pre><h4>6.3. Node.js com NVM</h4><p>É possível instalarmos várias versões do Node.js, seguindo o procedimento abaixo com o NVM (Node Version Manager):</p><p>a. Instale o NVM a partir de script disponibilizado no GitHub:</p><pre>curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash<br># Faça um source de seu arquivo .bashrc:<br>source ~/.bashrc</pre><p>b. Agora, verifique as versões disponíveis do Node.js:</p><pre>nvm list-remote</pre><p>c. Anote a versão que deseja instalar da lista obtida acima. Instale a versão com o comando:</p><pre>nvm install &lt;Versão&gt;<br># Exemplo:<br># nvm install v16.14.0</pre><p>d. Utilize o comando abaixo para listar as versões instaladas, e qual delas está ativa no sistema:</p><pre>nvm list</pre><p>A versão ativa no sistema é exibida com um apontamento “-&gt;” na lista de resposta do comando acima.</p><p>e. Confirme a versão do Node.js ativa no sistema com o comando:</p><pre>node -v<br># ou<br>nvm current</pre><p>f. Para escolher a versão ativa entre as instaladas no sistema, utilize o comando abaixo:</p><pre>nvm use &lt;Versão&gt;<br># Exemplo:<br># nvm use v20.5.0</pre><h4>6.4. Python com Pyenv</h4><p>Para instalar, execute o procedimento abaixo:</p><p>a. Instale os pacotes necessários para a instalação:</p><pre>sudo apt install git curl gcc make perl dkms -y</pre><p>b. Faça o clone do projeto do Pyenv a partir do GitHub para a pasta HOME da conta de usuário em utilização:</p><pre>cd ~/<br>git clone https://github.com/pyenv/pyenv.git ~/.pyenv</pre><p>c. Faça a compilação de um bash dinâmico para melhorar o desempenho do Pyenv:</p><pre>cd ~/.pyenv &amp;&amp; src/configure &amp;&amp; make -C src</pre><p>d. Adicione parâmetros do Pyenv no arquivo .bashrc da conta de usuário em utilização:</p><pre>echo &#39;export PYENV_ROOT=&quot;$HOME/.pyenv&quot;&#39; &gt;&gt; ~/.bashrc<br>echo &#39;command -v pyenv &gt;/dev/null || export PATH=&quot;$PYENV_ROOT/bin:$PATH&quot;&#39; &gt;&gt; ~/.bashrc<br>echo &#39;eval &quot;$(pyenv init -)&quot;&#39; &gt;&gt; ~/.bashrc</pre><p>e. Adicione parâmetros do Pyenv no arquivo .profile da conta de usuário em utilização:</p><pre>echo &#39;export PYENV_ROOT=&quot;$HOME/.pyenv&quot;&#39; &gt;&gt; ~/.profile<br>echo &#39;command -v pyenv &gt;/dev/null || export PATH=&quot;$PYENV_ROOT/bin:$PATH&quot;&#39; &gt;&gt; ~/.profile<br>echo &#39;eval &quot;$(pyenv init -)&quot;&#39; &gt;&gt; ~/.profile</pre><p>f. Se o arquivo .bash_profile existir para a conta de usuário, faça o mesmo procedimento para este arquivo:</p><pre>echo &#39;export PYENV_ROOT=&quot;$HOME/.pyenv&quot;&#39; &gt;&gt; ~/.bash_profile<br>echo &#39;command -v pyenv &gt;/dev/null || export PATH=&quot;$PYENV_ROOT/bin:$PATH&quot;&#39; &gt;&gt; ~/.bash_profile<br>echo &#39;eval &quot;$(pyenv init -)&quot;&#39; &gt;&gt; ~/.bash_profile</pre><p>g. Reinicie o shell para que os parâmetros de PATH sejam efetivados:</p><pre>exec &quot;$SHELL&quot;</pre><p>h. Instale as dependências para compilação do Python, conforme descrito em <a href="https://github.com/pyenv/pyenv/wiki#suggested-build-environment">https://github.com/pyenv/pyenv/wiki#suggested-build-environment</a>:</p><pre>sudo apt install build-essential libssl-dev zlib1g-dev libbz2-dev libreadline-dev libsqlite3-dev curl libncursesw5-dev xz-utils tk-dev libxml2-dev libxmlsec1-dev libffi-dev liblzma-dev -y</pre><p>i. Verifique a versão do Pyenv instalado:</p><pre>pyenv</pre><p>j. Verifique as versões do Python disponíveis para instalação:</p><pre>pyenv install --list</pre><p>k. Instale a versão desejada, utilizando no parâmetro &lt;[Versão do Python]&gt; a versão da mesma forma que aparece listada pelo comando acima:</p><pre>pyenv install &lt;Versão do Python&gt;<br># Exemplo:<br># pyenv install 3.11.4</pre><p>l. Para verificar as versões do Python instaladas, utilize o comando:</p><pre>pyenv versions</pre><p>m. Agora, ative a versão do Python que deseja utilizar, utilizando o comando abaixo:</p><pre>pyenv &lt;Ambiente&gt; &lt;Versão Instalada do Python&gt;</pre><p>Onde &lt;Ambiente&gt; pode ser:</p><ul><li>shell: a versão do Python é selecionada apenas para a sessão corrente do shell;</li><li>local: a versão do Python é selecionada apenas para o diretório corrente e seus subdiretórios;</li><li>global: a versão do Python é selecionada no geral para a conta de usuário logada.</li></ul><p>Onde &lt;Versão Instalada do Python&gt; pode ser:</p><ul><li>Uma das versões do Python instaladas no Pyenv;</li><li>A palavra system, que passa a utilizar o Python instalado no sistema operacional.</li></ul><p>n. Para verificar a versão do Python em uso, utilize o comando abaixo:</p><pre>python3 -V</pre><h4>6.4.1. Criando um virtual environment para o Python</h4><p>a. Crie uma pasta para o seu projeto. Dentro desta pasta, criaremos nosso virtual environment. Abra esta pasta no Visual Studio Code.</p><p>b. Crie o virtual environment dentro da pasta criada no passo anterior, com o comando abaixo, utilizando o terminal do Visual Studio Code:</p><pre>python -m venv &lt;Pasta do Virtual Environment&gt;<br># Exemplo:<br># python -m venv .venv</pre><p>c. Para ativar o virtual environment:</p><pre>source &lt;Pasta do Virtual Environment&gt;/bin/activate</pre><p>d. Para desativar o ambiente, use o comando:</p><pre>deactivate</pre><h4>6.5. Docker e Docker Compose</h4><p>a. O comando abaixo pode ser utilizado para instalar o Docker e o Docker Compose juntos em várias distros Linux:</p><pre>curl -fsSL get.docker.com -o get-docker.sh<br>sudo sh ./get-docker.sh</pre><p>b. Permita que a conta de usuário não root possa gerenciar containers Docker:</p><pre>sudo usermod -aG docker $USER<br>newgrp docker</pre><p>c. Verifique a versão do Docker instalado, e faça um teste:</p><pre>docker --version<br>docker run hello-world</pre><p>d. Habilite o serviço Docker para iniciar com o sistema operacional:</p><pre>sudo systemctl enable docker.service</pre><p>e. Verifique a instalação do Docker Compose:</p><pre>docker compose version</pre><h4>6.6. VS Code</h4><p>a. Faça o download da última versão disponível do Visual Studio Code com o comando:</p><pre>curl -L -o vstudiocode.deb &#39;https://code.visualstudio.com/sha/download?build=stable&amp;os=linux-deb-x64&#39;</pre><p>b. Instale o arquivo baixado:</p><pre>sudo apt install ./vstudiocode.deb -y</pre><p>c. Na tela de confirmação de adição do repositório Microsoft for Visual Studio Code, selecione “Yes”:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/803/1*8i9UelAKhuO3WeKV1V1Mpg.png" /></figure><h4>6.7. DBeaver</h4><p>a. Siga o procedimento abaixo para instalar:</p><pre>cd ~/<br>sudo wget -q -O - https://dbeaver.io/debs/dbeaver.gpg.key | sudo gpg --dearmor -o /usr/share/keyrings/dbeaver.gpg.key<br>echo &quot;deb [signed-by=/usr/share/keyrings/dbeaver.gpg.key] https://dbeaver.io/debs/dbeaver-ce /&quot; | sudo tee /etc/apt/sources.list.d/dbeaver.list<br>sudo apt-get update &amp;&amp; sudo apt-get install dbeaver-ce</pre><h4>6.8. AWS CLI</h4><p>a. A instalação do AWS CLI v2 é muito simples, basta seguir o procedimento abaixo:</p><pre>cd ~/<br>sudo apt install unzip -y<br>curl &quot;https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip&quot; -o &quot;awscliv2.zip&quot;<br>unzip awscliv2.zip<br>sudo ./aws/install<br>aws --version</pre><p>b. Inicie a configuração do AWS CLI:</p><pre>aws configure</pre><h4>6.9. Kiro CLI</h4><p>a. Faça o download e execute o instalador do Kiro CLI:</p><pre>curl --proto &#39;=https&#39; --tlsv1.2 -sSf &#39;https://desktop-release.q.us-east-1.amazonaws.com/latest/kirocli-x86_64-linux.zip&#39; -o &#39;kirocli.zip&#39;<br>unzip kirocli.zip &amp;&amp; ./kirocli/install.sh</pre><p>b. Ao final da instalação, o instalador pergunta se deve ajustar a configuração do shell. Responda <strong>Yes</strong>.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/993/1*fTySzaWtY1v6VI_QRrUsFQ.png" /></figure><p>c. Em seguida, o navegador abre a página de login do Kiro. Escolha o provedor de login.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*DgQN0RMNqAptrS2CAUOkkg.png" /></figure><p>d. Com a autorização aprovada (<em>Request approved</em>), feche a janela do navegador.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*8de2NZhPu-gSsuWs9jf3yQ.png" /></figure><p>e. Reinicie o shell:</p><pre>exec &quot;$SHELL&quot;</pre><p>f. Inicie o Kiro CLI:</p><pre>kiro-cli</pre><p>g. Confirme que a tela inicial do Kiro CLI é exibida.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*H-QT2BPtMGhxFvBCi7FIhA.png" /></figure><h4>6.10. Git</h4><p>a. O comando abaixo instala o Git:</p><pre>sudo apt install git -y<br>git --version</pre><h3>7. Conclusão</h3><p>Com o Hyper-V foi possível montar, no próprio Windows 11 Pro, uma VM Ubuntu Server 26.04 com ambiente gráfico, acesso remoto via xRDP e as ferramentas mais utilizadas para desenvolvimento e trabalho em nuvem.</p><p>Para quem precisa de uma VM que reinicie sozinha junto com o servidor Hyper-V, vale lembrar que a criptografia de disco com passphrase interrompe a inicialização até que alguém digite a senha no console. Essa escolha deve ser feita já na instalação.</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=183d0f8506eb" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Alta Disponibilidade e CI/CD no Amazon ECS com Kiro]]></title>
            <link>https://marcelopalenzuela.medium.com/alta-disponibilidade-e-ci-cd-no-amazon-ecs-com-kiro-7541cd30c9b6?source=rss-a209874e5d6a------2</link>
            <guid isPermaLink="false">https://medium.com/p/7541cd30c9b6</guid>
            <category><![CDATA[aws]]></category>
            <category><![CDATA[aws-codebuild]]></category>
            <category><![CDATA[aws-ecs]]></category>
            <category><![CDATA[aws-codepipeline]]></category>
            <category><![CDATA[cloud-computing]]></category>
            <dc:creator><![CDATA[Marcelo Palenzuela]]></dc:creator>
            <pubDate>Mon, 05 Oct 2026 11:56:01 GMT</pubDate>
            <atom:updated>2026-10-05T11:56:01.426Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*gZlxFKrheTQvAqLMz1gb3g.png" /></figure><p>Este artigo documenta a construção de uma aplicação containerizada com alta disponibilidade na AWS, publicada em ambientes de produção e desenvolvimento, com deploy automatizado via pipeline CI/CD.</p><p>A solução final roda em um cluster Amazon ECS distribuído em duas Availability Zones (AZ), atrás de um Application Load Balancer (ALB) que roteia o tráfego por host-header para dois Target Groups (TG) independentes, produção e dev, cada um com seu próprio ECS Service. Os domínios são gerenciados no Route 53, com certificados HTTPS emitidos pelo AWS Certificate Manager (ACM). O banco de dados roda no Amazon RDS com PostgreSQL e as imagens de container são versionadas no Amazon ECR.</p><p>O deploy evoluiu de um script manual com rollback por tag de commit para um pipeline automatizado com AWS CodePipeline e AWS CodeBuild: todo push na branch main gera uma nova imagem Docker, publica no ECR e atualiza o ECS Service com rolling update, sem downtime.</p><p>Todo o processo de construção foi apoiado, e em alguns casos construído, por um agente de IA treinado na arquitetura do projeto e conectado ao ambiente por meio de MCP. Utilizei MCP Server para o agente poder atuar no ambiente AWS, e outro MCP Server para o agente poder atuar diretamente no banco de dados PostgreSQL.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*w3oQBmgA5OlTXwfUA8UUkw.png" /></figure><p>Segue abaixo os passos executados para chegarmos ao resultado final desejado:</p><p><strong>1.Containerização da aplicação: </strong>Build da imagem Docker e publicação no Amazon ECR.</p><p>Assim que o repositório é criado no ECR, podemos verificar os comandos para publicação de imagens (clicando no botão View push commands):</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/828/1*Js1WI9TQ5_TW1lEgAjxlPA.png" /><figcaption>Instruções de View push commands no ECR.</figcaption></figure><p>Utilizamos esses comandos para carregar imagens no repositório do ECR:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*sIuktwse8EO-Wdt-aGFSGA.png" /><figcaption>Imagens salvas no repositório ECR.</figcaption></figure><p><strong>2.Provisionamento do banco de dados: </strong>Instância do Amazon RDS (PostgreSQL) em <strong>subnet privada</strong>.</p><p>Para aplicações corporativas, é importante provisionar instâncias de bancos de dados em uma subnet privada. Dessa forma, a instância e seus dados estão protegidos quanto ao acesso direto via Internet.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/983/1*BmTxsV0M2w3CTXsc4Q6xSQ.png" /><figcaption>PostgreSQL lançado em uma instância RDS.</figcaption></figure><p><strong>3.Cluster Amazon ECS: </strong>Cluster e service rodando a aplicação containerizada, com tasks distribuídas em duas Availability Zones (us-east-1a e us-east-1b) para tolerância a falhas.</p><p>Para o nosso cluster ECS, utilizamos self-managed instances.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/994/1*IlqzR2VBmw9W46xC64usdw.png" /><figcaption>Cluster ECS.</figcaption></figure><p>Depois, os services são configurados. Nesse projeto, foram criados dois services: um para o ambiente de produção (prod), e outro para o ambiente de desenvolvimento (dev).</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/959/1*Kk7oiq3vIi3FxcZ9KeDHBQ.png" /><figcaption>Services no Cluster ECS.</figcaption></figure><p>Na sequência, é necessário configurar as Tasks de cada Service. É aqui que configuramos o ECS para fazer o deploy das imagens, e onde ajustamos limites para utilização de vCPU e memória RAM de cada uma delas.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/962/1*hTsENwKxoMBqizszXdr8tw.png" /><figcaption>Tasks com limites de vCPU e Memória RAM no Cluster ECS.</figcaption></figure><p><strong>4.Alta disponibilidade com ALB: </strong>Application Load Balancer na frente do cluster, com dois Target Groups (produção e dev) e regras de roteamento por host-header, permitindo dois ambientes na mesma instância do ALB.</p><p>O ALB foi configurado para receber todo o tráfego da Internet, e direcionar para a Task correta.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1008/1*MdG0aXBD1Ora0fKnIoVPkw.png" /><figcaption>Configuração de Listener and Rules do ALB.</figcaption></figure><p>Como utilizaremos certificado digital do ACM para que a aplicação possa ser acessada com segurança, configuramos regras de host headers no listener HTTPS:443.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*QMA8nPXItMvifUsqOLjnEA.png" /><figcaption>Configuração do listener HTTPS:443.</figcaption></figure><p><strong>5.DNS e HTTPS: </strong>Domínios configurados no Route 53 (produção e dev) e certificados emitidos e validados via AWS Certificate Manager.</p><p>No ACM, lançamos um certificado digital do tipo wildcard (válido para qualquer subdomínio do domínio principal). Para esse ambiente, utilizei um domínio que possuo, o <strong>innovsysti.online</strong>.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*mO-9yir0WEaiuiC-pORjhA.png" /><figcaption>Certificado digital lançado no ACM para o domínio innovsysti.online.</figcaption></figure><p>Uma dúvida que muitos podem ter diz respeito ao custo do certificado emitido na AWS: Ele não tem custo, desde que não seja marcada a opção Enable export durante a sua solicitação. Deve ficar claro que esse certificado só pode ser utilizado internamente na infraestrutura AWS.</p><p>Como o Route 53 é o DNS utilizado para gerenciar o domínio, criamos os registros que o ALB utilizará para redirecionar o tráfego aqui.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*o4v5NWNGQ6B-yyagOGGbIw.png" /><figcaption>Registros no Route 53 apontando para o ALB.</figcaption></figure><p>Para esse projeto, criamos os registros formacao.innovsysti.online, para o ambiente de produção, e formacao-dev.innovsysti.online, para o ambiente de desenvolvimento. Ambos os registros só precisam ser apontados para o endereço do ALB; como já vimos nos passos anteriores, o ALB saberá como redirecionar o tráfego, baseado no host header da solicitação.</p><p><strong>6.Provisionamento do ambiente de Dev: </strong>Segundo ECS Service, Target Group e domínio, provisionados com apoio de um agente de IA (Kiro CLI) configurado com o contexto do projeto, seguindo um fluxo de entendimento da solicitação → validação → execução somente após autorização.</p><p>Esse passo em especial foi totalmente criado no Kiro CLI. É importante destacar que o Kiro CLI estava totalmente contextualizado sobre o projeto; ou seja, o agente continha informações detalhadas sobre arquitetura e infraestrutura planejada para o projeto.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*-yKcog-sq6N-2GB2trYc7Q.png" /><figcaption>Kiro-CLI carregado em uma sessão do CloudShell.</figcaption></figure><p>Além disso, o Kiro CLI, com o MCP Server da AWS instalado e funcional, foi capaz de se conectar ao ambiente, fazer análises de arquitetura e até mesmo criar e ajustar componentes da infraestrutura.</p><p>Alguns exemplos de prompts utilizados:</p><pre>Faça um diagnóstico para o app BIA, que está sendo executado no ECS. Em seu diagnóstico, valide: 1. Que a aplicação disponibilizada através do ECS está em execução e   <br>  disponibilizada na Internet através de um endereço IP público; 2. Valide e liste as configurações do cluster, services e tasks do ECS; 3. Funcionamento do banco de     <br>  dados PostgreSQL no RDS; 4. Valide que o app BIA está se comunicando corretamente com o banco de dados PostgreSQL do RDS; 5. Liste e valide os schemas não padrões do   <br>  banco de dados PostgreSQL no RDS; 6. Liste as imagens disponíveis no repositório bia do ECR, e identifique qual delas está sendo executada no momento pelo ECS; 7.      <br>  Valide que as security groups bia-* estão devidamente configurados para o projeto.</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*kiPeCdR2NuHiGhmjCPSU7A.png" /><figcaption>Kiro-CLI utilizado para diagnóstico da infraestrutura do projeto.</figcaption></figure><pre>Crie uma estrutura adicional no cluster do ECS cluster-bia-alb. Lance um service chamado service-bia-alb-dev, utilizando                               <br>   a mesma task definition do service service-bia-alb. No ALB, adicione uma rule no listener do HTTPS para adicionar um                                  <br>   direcionamento de request para o host header formacao-dev.innovsysti.online; envie as requisições deste host header para o                                <br>   target group tg-bia-dev; crie o target group tg-bia-dev, com deregistration delay de 30 segundos. Antes de executar,                                  <br>   informe o seu entendimento a essa solicitação, para verificação.</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/929/1*t-0t0-NUfSe0uoglmSK0fg.png" /><figcaption>Entendimento da solicitação pelo Kiro-CLI</figcaption></figure><p>Após verificação de cada ponto e algumas interações com o Kiro, foi possível concluir a criação de toda a infraestrutura necessária:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*jKJ1sH5dMo0s58fd13fMcg.png" /><figcaption>Entrega da infraestrutura na AWS com Kiro-CLI</figcaption></figure><p><strong>7.Deploy automatizado (CI/CD): </strong>Pipeline com AWS CodePipeline e AWS CodeBuild: cada push na branch main gera uma nova imagem com a tag do commit, publica a imagem no ECR e atualiza o ECS Service via rolling update, sem downtime. Esse passo substituiu o script manual de deploy com rollback usado na etapa inicial.</p><p>Para o push na branch main, utilizei o GitHub como repositório, integrado ao ECS. A cada novo push na branch main do GitHub, o seguinte processo é realizado:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*yRAPfH8uAlCo_5-N1KZXXg.png" /><figcaption>Representação do pipeline CI/CD no ECS.</figcaption></figure><p>Assim que um push é executado no GitHub, podemos ver o CodePipeline em ação na AWS.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*TZr1nwhzsxXYPSJ2Ftfafg.png" /><figcaption>CodePipeline executando o fluxo de Build e Deploy após o push.</figcaption></figure><p><strong>8.Validação: </strong>Testes de disponibilidade com os dois ambientes ativos simultaneamente e acompanhamento do rolling update durante um deploy real.</p><p>Assim que o deploy é finalizado no CodePipeline, podemos testar a aplicação no ar nos endereços configurados no Route 53. No nosso exemplo, utilizamos o endereço <strong>formacao.innovsysti.online</strong> para o app de produção.</p><h3>Conclusão</h3><p>Esse desafio saiu de uma aplicação containerizada rodando em um único service ECS para uma arquitetura com alta disponibilidade real: duas Availability Zones, balanceamento de carga, dois ambientes isolados atrás do mesmo ALB e um pipeline que publica em produção a cada push, sem downtime.</p><p>A parte mais relevante do processo não foi só a infraestrutura em si, mas a forma de provisioná-la: usar um agente de IA com contexto do projeto para acelerar a execução exigiu, na mesma medida, prompts bem estruturados e validação ativa de cada passo antes de autorizar qualquer alteração.</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=7541cd30c9b6" width="1" height="1" alt="">]]></content:encoded>
        </item>
    </channel>
</rss>