O AWS CodeBuild já dá suporte ao uso de emblemas de compilação, que fornecem uma imagem incorporável gerada dinamicamente (emblema) que exibe o status da última compilação de um projeto. Essa imagem é acessível por meio de um URL disponível publicamente gerado para o projeto do CodeBuild. Isso permite que qualquer pessoa veja o status de um projeto do CodeBuild. Como não contêm informações de segurança, os emblemas de compilação não exigem autenticação.
Tópicos
Criar um projeto de compilação com emblemas de compilação
Use um dos procedimentos a seguir para criar um projeto de compilação com emblemas de compilação ativados. É possível usar a AWS CLI ou o AWS Management Console.
Para criar um projeto de compilação com emblemas de compilação habilitados (AWS CLI)
Para obter informações sobre como criar um projeto de compilação, consulte Criar um projeto de compilação (AWS CLI). Para incluir emblemas de compilação com o projeto do AWS CodeBuild, é necessário especificar
badgeEnabled
com um valor detrue
.
Para criar um projeto de compilação com emblemas de compilação habilitados (console)
Abra o console do AWS CodeBuild em https://console.aws.amazon.com/codesuite/codebuild/home
. -
Se uma página de informações do CodeBuild for exibida, selecione Criar projeto de compilação. Caso contrário, no painel de navegação, expanda Compilar, escolha Projetos de compilação e, depois, Criar projeto de compilação.
Em Nome do projeto, insira um nome para esse projeto de compilação. Os nomes de projeto de compilação devem ser únicos em cada conta da AWS. Também é possível incluir uma descrição opcional do projeto de compilação para ajudar outros usuários a entender para que esse projeto é usado.
-
Em Source (Origem), em Source provider (Fornecedor de origem), selecione tipo de fornecedor de código-fonte e faça um dos seguintes procedimentos:
nota
O CodeBuild não é compatível com emblemas de compilação com o provedor de origem do Amazon S3. Como o AWS CodePipeline usa o Amazon S3 para transferências de artefatos, os emblemas de compilação não são compatíveis com projetos de compilação que fazem parte de um pipeline criado no CodePipeline.
-
Se você tiver escolhido CodeCommit, para Repositório, escolha o nome do repositório. Selecione Habilitar emblema da compilação para que o status de compilação do projeto fique visível e possa ser incorporado.
-
Se você escolheu GitHub, siga as instruções para conectar-se (ou reconectar-se) a GitHub. Na página Authorize application (Autorizar aplicativo) do GitHub, em Organization access (Acesso à organização), escolha Request access (Solicitar acesso) ao lado de cada repositório que você deseja que o AWS CodeBuild possa acessar. Depois que você escolher Authorize application (Autorizar aplicação), no console do AWS CodeBuild, em Repository (Repositório), escolha o nome do repositório que contém o código-fonte. Selecione Habilitar emblema da compilação para que o status de compilação do projeto fique visível e possa ser incorporado.
-
Se você escolher Bitbucket, siga as instruções para se conectar (ou reconectar) ao Bitbucket. Na página Confirm access to your account do Bitbucket, em Organization access, escolha Grant access. Depois que você escolher Grant access (Conceder acesso), no console do AWS CodeBuild, em Repository (Repositório), escolha o nome do repositório que contém o código-fonte. Selecione Habilitar emblema da compilação para que o status de compilação do projeto fique visível e possa ser incorporado.
Importante
A atualização da origem do projeto pode afetar a precisão dos emblemas de compilação do projeto.
-
-
Em Ambiente:
Para Imagem do ambiente, faça um dos seguintes procedimentos:
-
Para usar uma imagem do Docker gerenciada pelo AWS CodeBuild, selecione Imagem gerenciada e faça as escolhas em Sistema operacional, Runtime(s), Imagem e Versão da imagem. Faça uma seleção em Tipo de ambiente se estiver disponível.
-
Para usar outra imagem do Docker, selecione Imagem personalizada. Em Tipo de ambiente, selecione ARM, Linux, Linux GPU ou Windows. Se você selecionar Outro registro, em URL de registro externo, insira o nome e a tag da imagem do Docker no Docker Hub usando o formato
. Se você escolher Amazon ECR, use Repositório do Amazon ECR e Imagem do Amazon ECR para selecionar a imagem do Docker na conta da AWS.docker repository
/docker image name
-
Para usar uma imagem privada do Docker, selecione Imagem personalizada. Em Tipo de ambiente, selecione ARM, Linux, Linux GPU ou Windows. Em Registro da imagem, selecione Outro registro e insira o ARN das credenciais da imagem privada do Docker. As credenciais devem ser criadas pelo Secrets Manager. Para obter mais informações, consulte O que é o AWS Secrets Manager? no Guia do usuário do AWS Secrets Manager.
-
-
Em Perfil de serviço, faça um dos seguintes procedimentos:
-
Se você não tiver um perfil de serviço do CodeBuild, selecione Novo perfil de serviço. No campo Nome da função, digite o nome da nova função.
-
Se você tiver um perfil de serviço do CodeBuild, selecione Perfil de serviço existente. Em ARN do perfil, escolha o perfil de serviço.
nota
Ao usar o console para criar ou atualizar um projeto de compilação, é possível criar um perfil de serviço do CodeBuild ao mesmo tempo. Por padrão, a função funciona somente com esse projeto de compilação. Se você usar o console para associar esse perfil de serviço a outro projeto de compilação, a função será atualizada para funcionar com os outros projetos de compilação. Um perfil de serviço pode funcionar com até 10 projetos de compilação.
-
-
Em Buildspec, siga um destes procedimentos:
-
Escolha Usar um arquivo buildspec para usar o arquivo buildspec.yml no diretório raiz do código-fonte.
-
Selecione Inserir comandos de compilação para usar o console para inserir comandos de compilação.
Para obter mais informações, consulte Referência de buildspec.
-
-
Em Artefatos, para Tipo, faça um dos seguintes procedimentos:
-
Se você não quiser criar artefatos de saída de compilação, selecione Nenhum artefato.
-
Para armazenar a saída de compilação em um bucket do S3, escolha Amazon S3 e faça o seguinte:
-
Se você quiser usar o nome do projeto para a pasta ou arquivo ZIP de saída da compilação, deixe Nome em branco. Caso contrário, insira o nome. Por padrão, o nome do artefato é o nome do projeto. Se você quiser usar um nome diferente, insira-o na caixa de nome do artefato. Se você quiser gerar um arquivo ZIP, inclua a extensão zip.
-
Para Nome do bucket, selecione o nome do bucket de saída.
-
Se você tiver escolhido Inserir comandos de compilação anteriormente neste procedimento, em Arquivos de saída, insira os locais dos arquivos da compilação que deseja incluir na pasta ou no arquivo ZIP de saída da compilação. Para vários locais, separe-os com uma vírgula (por exemplo,
appspec.yml, target/my-app.jar
). Para obter mais informações, consulte a descrição defiles
em Sintaxe de buildspec.
-
-
-
Expanda Configuração adicional e escolha as opções conforme apropriado.
-
Selecione Criar projeto de compilação. Na página Revisão, escolha Iniciar compilação para executar a compilação.