As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
Configure um pipeline de CI/CD para cargas de trabalho híbridas no Amazon ECS Anywhere usando o AWS CDK e GitLab
Criado pelo Dr. Rahul Sharad Gaikwad (AWS)
Repositório de código: amazon-ecs-anywhere-cicd - pipeline-cdk-sample | Ambiente: PoC ou piloto | Tecnologias: nuvem híbrida; contêineres e microsserviços; infraestrutura; DevOps |
Workload: código aberto | Serviços da AWS: AWS CDK; AWS CodePipeline; Amazon ECS; AWS Systems Manager; AWS CodeCommit |
Resumo
O Amazon ECS Anywhere é uma extensão do Amazon Elastic Container Service (Amazon ECS). Ele fornece suporte para registrar uma instância externa, como um servidor on-premises ou uma máquina virtual (VM), no cluster do Amazon ECS. Esse atributo ajuda a reduzir custos e mitigar operações e orquestrações de contêineres on-premises. Você pode usar o ECS Anywhere para implantar e executar aplicativos de contêiner em ambientes on-premises e na nuvem. Isso elimina a necessidade de sua equipe aprender vários domínios e conjuntos de habilidades ou gerenciar softwares complexos por conta própria.
Esse padrão descreve uma step-by-step abordagem para provisionar um cluster do Amazon ECS com instâncias do Amazon ECS Anywhere usando pilhas do Cloud Development Kit (AWS CDK) da Amazon Web Services (AWS). Em seguida, você usa CodePipeline a AWS para configurar um pipeline de integração e implantação contínuas (CI/CD). Em seguida, você replica seu repositório de GitLab código para a AWS CodeCommit e implanta seu aplicativo em contêineres no cluster Amazon ECS.
Esse padrão foi projetado para ajudar aqueles que usam a infraestrutura local para executar aplicativos de contêiner e gerenciar GitLab a base de código do aplicativo. Você pode gerenciar essas workloads usando os serviços de Nuvem AWS, sem perturbar sua infraestrutura on-premises existente.
Pré-requisitos e limitações
Pré-requisitos
Uma conta AWS ativa
Um aplicativo de contêiner executado na infraestrutura on-premises.
Um GitLab repositório onde você gerencia a base de código do seu aplicativo. Para obter mais informações, consulte Repositório
(GitLab). AWS Command Line Interface (AWS CLI), instalada e configurada. Para obter mais informações, consulte Instalar ou atualizar a versão mais recente da AWS CLI (Documentação da AWS CLI).
AWS CDK Toolkit, instalado e configurado globalmente. Para obter mais informações, consulte Instalar o AWS CDK na documentação do AWS CDK Workshop.
npm, instalado e configurado para o AWS CDK em. TypeScript Para obter mais informações, consulte Como baixar e instalar o Node.js e o npm
(documentação do npm).
Limitações
Para limitações e considerações, consulte Instâncias externas (Amazon ECS Anywhere) na documentação do Amazon ECS.
Versões do produto
AWS CDK Toolkit versão 2.27.0 ou superior
npm versão 7.20.3 ou superior
Node.js versão 16.6.1 ou superior
Arquitetura
Pilha de tecnologias de destino
AWS CDK
AWS CloudFormation
AWS CodeBuild
AWS CodeCommit
AWS CodePipeline
Amazon ECS Anywhere
Amazon Elastic Container Registry (Amazon ECR)
AWS Identity and Access Management (IAM)
AWS Systems Manager
GitLab repositório
Arquitetura de destino
![Diagrama de arquitetura da configuração do cluster Amazon ECS e do pipeline de CI/CD.](images/pattern-img/b0f35986-a839-4b01-8eb0-4748182ddafc/images/85b8d4d9-3591-4d69-a54b-64aa543498f1.png)
Esse diagrama representa dois fluxos de trabalho principais descritos nesse padrão, provisionando o cluster do Amazon ECS e configurando o pipeline de CI/CD que configura e implanta o pipeline de CI/CD, da seguinte forma:
Provisionar o cluster do Amazon ECS
Quando você implanta a primeira pilha de CDK da AWS, ela cria uma CloudFormation pilha na AWS.
Essa CloudFormation pilha provisiona um cluster do Amazon ECS e recursos relacionados da AWS.
Para registrar uma instância externa com um cluster do Amazon ECS, você deve instalar o AWS Systems Manager Agent (SSM Agent) na sua VM e registrar a VM como uma instância gerenciada do AWS Systems Manager.
Você deve instalar o agente de contêiner do Amazon ECS e o Docker na sua VM para registrá-la como instância externa com o cluster do Amazon ECS.
Quando a instância externa é registrada e configurada com o cluster Amazon ECS, ela pode executar vários contêineres na sua VM, que é registrada como uma instância externa.
O cluster do Amazon ECS está ativo e pode executar as cargas de trabalho do aplicativo por meio de contêineres. A instância de contêiner Amazon ECS Anywhere é executada em um ambiente on-premises, mas está associada ao cluster do Amazon ECS na nuvem.
Configurando e implantando o pipeline de CI/CD
Quando você implanta a segunda pilha de CDK da AWS, ela cria outra CloudFormation pilha na AWS.
Essa CloudFormation pilha provisiona um pipeline CodePipeline e recursos relacionados da AWS.
Você envia e mescla as alterações do código do aplicativo em um repositório local GitLab .
O GitLab repositório é automaticamente replicado para o CodeCommit repositório.
As atualizações do CodeCommit repositório são CodePipeline iniciadas automaticamente.
CodePipeline copia o código CodeCommit e cria o aplicativo implantável integrado. CodeBuild
CodePipeline cria uma imagem Docker do ambiente de CodeBuild construção e a envia para o repositório Amazon ECR.
CodePipeline inicia CodeDeploy ações que extraem a imagem do contêiner do repositório Amazon ECR.
CodePipeline implanta a imagem do contêiner no cluster Amazon ECS.
Automação e escala
Esse padrão usa o AWS CDK como uma ferramenta de infraestrutura como código (IaC) para configurar e implantar essa arquitetura. O AWS CDK ajuda você a orquestrar os recursos da AWS e configurar o Amazon ECS Anywhere e o pipeline de CI/CD.
Ferramentas
Serviços da AWS
O AWS Cloud Development Kit (AWS CDK) é uma estrutura de desenvolvimento de software que ajuda você a definir e provisionar a infraestrutura da Nuvem AWS em código.
CodeCommitA AWS é um serviço de controle de versão que ajuda você a armazenar e gerenciar repositórios Git de forma privada, sem precisar gerenciar seu próprio sistema de controle de origem.
CodePipelineA AWS ajuda você a modelar e configurar rapidamente os diferentes estágios de uma versão de software e automatizar as etapas necessárias para liberar alterações de software continuamente.
A AWS Command Line Interface (AWS CLI) é uma ferramenta de código aberto que permite que você interaja com serviços da AWS usando comandos no shell da linha de comando.
O Amazon Elastic Container Registry (Amazon ECR) é um serviço gerenciado de registro de imagens de contêineres seguro, escalável e confiável.
O Amazon Elastic Container Service (Amazon ECS) é um serviço de gerenciamento de contêineres escalável e rápido que facilita a execução, a interrupção e o gerenciamento de contêineres em um cluster. Esse padrão também usa o Amazon ECS Anywhere, que fornece suporte para registrar um servidor on-premises ou uma VM no cluster do Amazon ECS.
Outras ferramentas
O Node.js
é um ambiente de tempo de JavaScript execução orientado a eventos projetado para criar aplicativos de rede escaláveis. O npm
é um registro de software executado em um ambiente Node.js e usado para compartilhar ou emprestar pacotes e gerenciar a implantação de pacotes privados. O Vagrant
é um utilitário de código aberto para criar e manter ambientes portáteis de desenvolvimento de software virtual. Para fins de demonstração, esse padrão usa o Vagrant para criar uma VM on-premises.
Repositório de código
O código desse padrão está disponível no pipeline de GitHub CI/CD do Amazon ECS Anywhere usando o repositório AWS
Práticas recomendadas
Considere as seguintes práticas recomendadas ao implantar esse padrão:
Épicos
Tarefa | Descrição | Habilidades necessárias |
---|---|---|
Verifique a versão do AWS CDK. | Verifique a versão do AWS CDK Toolkit inserindo o comando a seguir.
Este padrão requer a versão 2.27.0 ou superior. Se você tiver uma versão anterior, siga as instruções na documentação do AWS CDK para atualizá-la. | DevOps engenheiro |
Verificar a versão do npm. | Verifique a versão do npm inserindo o comando a seguir.
Este padrão requer a versão 7.20.3 ou superior. Se você tiver uma versão anterior, siga as instruções na documentação do npm | DevOps engenheiro |
Configurar credenciais da AWS. | Configure as credenciais da AWS inserindo o comando
| DevOps engenheiro |
Tarefa | Descrição | Habilidades necessárias |
---|---|---|
Clone o repositório de códigos do AWS CDK. |
| DevOps engenheiro |
Faça o bootstrap do ambiente. | Implante o CloudFormation modelo na conta e na região da AWS que você deseja usar inserindo o seguinte comando.
Para obter mais informações, consulte Inicialização na documentação do AWS CDK. | DevOps engenheiro |
Tarefa | Descrição | Habilidades necessárias |
---|---|---|
Instale as dependências do pacote e compile os TypeScript arquivos. | Instale as dependências do pacote e compile os TypeScript arquivos digitando os seguintes comandos.
Esses comandos instalam todos os pacotes do repositório de exemplo. Para obter mais informações, consulte npm ci | DevOps engenheiro |
Crie o projeto. | Para compilar o código do projeto, digite o comando a seguir.
Para obter mais informações sobre como criar e implantar o projeto, consulte Seu primeiro aplicativo da AWS CDK na documentação da AWS CDK. | DevOps engenheiro |
Implante a pilha de infraestrutura do Amazon ECS Anywhere. |
| DevOps engenheiro |
Verifique a criação e a saída da pilha. |
| DevOps engenheiro |
Tarefa | Descrição | Habilidades necessárias |
---|---|---|
Configurar a VM. | Crie uma VM Vagrant inserindo o comando | DevOps engenheiro |
Registre sua VM como uma instância externa. |
Isso configura sua VM como uma instância externa do Amazon ECS Anywhere e registra a instância no cluster do Amazon ECS. Para obter mais informações, consulte Registro de uma instância externa em um cluster | DevOps engenheiro |
Verifique o status do Amazon ECS Anywhere e da VM externa. | Para verificar se sua VM está conectada ao ambiente de gerenciamento do Amazon ECS e em execução, use os seguintes comandos.
| DevOps engenheiro |
Tarefa | Descrição | Habilidades necessárias |
---|---|---|
Crie uma ramificação no CodeCommit repositório. | Crie uma ramificação nomeada
| DevOps engenheiro |
Configure o espelhamento do repositório. | Você pode espelhar um GitLab repositório de e para fontes externas. Você pode selecionar qual repositório serve como fonte. Ramificações, tags e commits são sincronizados automaticamente. Configure um push mirror entre o GitLab repositório que hospeda seu aplicativo e o CodeCommit repositório. Para obter instruções, consulte Configurar um espelho de pressão de GitLab para CodeCommit Observação: por padrão, o espelhamento sincroniza automaticamente o repositório. Se você quiser atualizar manualmente os repositórios, consulte Atualizar um espelho | DevOps engenheiro |
Implante a pilha de pipeline de CI/CD. | Implemente a pilha do
| DevOps engenheiro |
Testar o pipeline de CI/CD. |
| DevOps engenheiro |
Tarefa | Descrição | Habilidades necessárias |
---|---|---|
Limpe e exclua os recursos. | Depois de percorrer esse padrão, você deve remover os proof-of-concept recursos que criou. Para limpar, insira os comandos a seguir.
| DevOps engenheiro |
Solução de problemas
Problema | Solução |
---|---|
Erros sobre pacotes ausentes ao instalar dependências de pacotes. | Insira um dos comandos a seguir para resolver pacotes ausentes.
ou
|
Ao executar o comando
| A pilha do |
Uma verificação de integridade do Amazon ECS retorna
| Reinicie o agente do Amazon ECS na VM do Vagrant inserindo os comandos a seguir.
|