Usando o EB CLI com AWS CodeBuild - AWS Elastic Beanstalk

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á.

Usando o EB CLI com AWS CodeBuild

O AWS CodeBuild compila o código-fonte, roda testes de unidade e produz artefatos prontos para implantação. É possível usar o CodeBuild com a CLI do EB para automatizar a criação do aplicativo a partir de seu código-fonte. A criação do ambiente e cada implantação subsequente iniciam com uma etapa de criação e com a implantação do aplicativo resultante.

nota

Algumas regiões não oferecem CodeBuild. A integração entre o Elastic CodeBuild Beanstalk não funciona nessas regiões.

Para obter informações sobre os AWS serviços oferecidos em cada região, consulte a Tabela de regiões.

Como criar uma aplicação do

Para criar um aplicativo do Elastic Beanstalk que usa CodeBuild
  1. Inclua um arquivo de especificação de CodeBuild compilação buildspec.yml,, na pasta do aplicativo.

  2. Adicione uma entrada eb_codebuild_settings com opções específicas do Elastic Beanstalk ao arquivo.

  3. Execute eb init na pasta.

    nota

    Não use os caracteres ponto (.) ou espaço ( ) no nome do aplicativo ao usar o EB CLI com. CodeBuild

O Elastic Beanstalk CodeBuild estende o formato do arquivo de especificação de compilação para incluir as seguintes configurações adicionais:

eb_codebuild_settings: CodeBuildServiceRole: role-name ComputeType: size Image: image Timeout: minutes
CodeBuildServiceRole

O ARN ou o nome da função de serviço AWS Identity and Access Management (IAM) que CodeBuild pode ser usada para interagir com AWS serviços dependentes em seu nome. Este valor é obrigatório. Se você omiti-lo, qualquer comando eb create ou eb deploy subsequente apresentará falha.

Para saber mais sobre como criar uma função de serviço para CodeBuild, consulte Criar uma função CodeBuild de serviço no Guia AWS CodeBuild do usuário.

nota

Você também precisa de permissões para realizar ações CodeBuild por si só. A política de usuários gerenciados do AdministratorAccessElastic AWSElastic Beanstalk - Beanstalk inclui todas as permissões de ação necessárias. CodeBuild Se você não estiver usando a política gerenciada, certifique-se de conceder as permissões a seguir na política de usuário.

"codebuild:CreateProject", "codebuild:DeleteProject", "codebuild:BatchGetBuilds", "codebuild:StartBuild"

Para obter detalhes, consulte Gerenciar políticas de usuário do Elastic Beanstalk.

ComputeType

A quantidade de recursos usados pelo contêiner Docker no ambiente de CodeBuild compilação. Os valores válidos são BUILD_ GENERAL1 _SMALL, BUILD_ _MEDIUM e BUILD_ GENERAL1 _LARGE. GENERAL1

Image

O nome da imagem do Docker Hub ou do Amazon ECR CodeBuild usada para o ambiente de construção. Essa imagem do Docker deve conter todas as ferramentas e bibliotecas de tempo de execução necessárias para criar seu código e deve corresponder à plataforma de destino do seu aplicativo. CodeBuild gerencia e mantém um conjunto de imagens especificamente destinado a ser usado com o Elastic Beanstalk. É recomendado que você use uma delas. Para obter detalhes, consulte Imagens do Docker fornecidas CodeBuild no Guia do AWS CodeBuild usuário.

O valor Image é opcional. Se você omiti-lo, o comando eb init tentará escolher uma imagem que melhor corresponde à plataforma de destino. Além disso, se você executar eb init no modo interativo e ele falhar na escolha de uma imagem para você, será solicitado que você escolha uma. Ao final de uma inicialização bem-sucedida, eb init grava a imagem escolhida no arquivo buildspec.yml.

Timeout

A duração, em minutos, da execução da CodeBuild compilação antes do tempo limite. Este valor é opcional. Para obter detalhes sobre valores válidos e padrão, consulte Criar um projeto de compilação em CodeBuild.

nota

Esse tempo limite controla a duração máxima de uma CodeBuild execução, e a CLI do EB também o respeita como parte de sua primeira etapa para criar uma versão do aplicativo. É diferente do valor que você pode especificar na opção --timeout dos comandos eb create ou eb deploy. O último valor controla a duração máxima que a CLI do EB aguarda para a criação ou atualização do ambiente.

Criar e implantar o código do aplicativo

Sempre que o código do aplicativo precisa ser implantado, a CLI do EB CodeBuild usa para executar uma compilação e, em seguida, implanta os artefatos de compilação resultantes em seu ambiente. Isso ocorre ao criar um ambiente do Elastic Beanstalk para a aplicação usando o comando eb create e sempre que você implantar alterações no código no ambiente usando o comando eb deploy.

Se a CodeBuild etapa falhar, a criação ou implantação do ambiente não será iniciada.