Antes de usar o AWS CodeBuild, é necessário responder a estas perguntas:
-
Onde o código-fonte é armazenado? O CodeBuild no momento é compatível com a compilação pelos provedores de repositórios de código-fonte a seguir. O código-fonte deve conter um arquivo de especificação de compilação (buildspec). buildspec é uma coleção de comandos de compilação e configurações relacionadas, no formato YAML, que o CodeBuild usa para executar uma compilação. É possível declarar um buildspec em uma definição de projeto de compilação.
Provedor do repositório Obrigatório Documentação CodeCommit Nome do repositório.
(Opcional) Commit ID associada ao código-fonte.
Consulte estes tópicos no Guia do usuário do AWS CodeCommit:
Amazon S3 Nome do bucket de entrada.
Nome do objeto correspondente ao arquivo ZIP de entrada do build que contém o código-fonte.
(Opcional) Version ID associada ao arquivo ZIP de entrada do build.
Consulte estes tópicos no Guia de noções básicas do Amazon S3:
GitHub Nome do repositório.
(Opcional) Commit ID associada ao código-fonte.
Consulte este tópico no site de ajuda do GitHub:
Bitbucket Nome do repositório.
(Opcional) Commit ID associada ao código-fonte.
Consulte este tópico no site de documentação do Bitbucket Cloud:
-
Que comandos de build você precisa executar e em que ordem? Por padrão, o CodeBuild baixa a entrada de compilação do provedor que você especificar e faz upload da saída de compilação para o bucket especificado. Você usa a buildspec para instruir como a entrada de compilação obtida por download é convertida na saída de compilação esperada. Para obter mais informações, consulte Referência de buildspec.
-
De que runtimes e ferramentas você precisa para executar o build? Por exemplo, você está fazendo um build para Java, Ruby, Python ou Node.js? O build precisa de Maven ou Ant, ou de um compilador para Java, Ruby ou Python? O build precisa de Git, AWS CLI, ou outras ferramentas?
O CodeBuild executa as compilações em ambientes que usam imagens do Docker. Essas imagens do Docker devem ser armazenadas em um tipo de repositório compatível com o CodeBuild. Isso inclui o repositório de imagens do Docker do CodeBuild, o Docker Hub e o Amazon Elastic Container Registry (Amazon ECR). Para obter mais informações sobre o repositório de imagens do Docker no CodeBuild, consulte Imagens do Docker fornecidas pelo CodeBuild.
-
Você precisa de recursos da AWS que não são fornecidos automaticamente pelo CodeBuild? Em caso afirmativo, de quais políticas de segurança esses recursos precisam? Por exemplo, talvez seja necessário modificar o perfil de serviço do CodeBuild para permitir que o CodeBuild funcione com esses recursos.
-
Deseja que o CodeBuild funcione com a VPC? Em caso positivo, você precisa do ID da VPC, dos IDs de sub-rede e dos IDs de security group para a configuração da VPC. Para ter mais informações, consulte Usar o AWS CodeBuild com o Amazon Virtual Private Cloud.
Depois de responder a essas perguntas, você deverá ter as configurações e recursos necessários para executar com êxito um build. Para executar seu build, você pode:
-
Use o console do AWS CodeBuild, a AWS CLI ou os SDKs da AWS. Para ter mais informações, consulte Executar compilações manualmente.
-
Crie ou identifique um pipeline no AWS CodePipeline e, então, adicione uma compilação ou uma ação de teste que instrua o CodeBuild a testar automaticamente o código, executar a compilação ou ambos. Para ter mais informações, consulte Usar o CodeBuild com o CodePipeline.