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

# Crie uma amostra de crachás com CodeBuild
<a name="sample-build-badges"></a>

AWS CodeBuild agora suporta o uso de emblemas de construção, que fornecem uma imagem incorporável e gerada dinamicamente (*emblema*) que exibe o status da versão mais recente de um projeto. Essa imagem pode ser acessada por meio de uma URL publicamente disponível gerada para seu CodeBuild projeto. Isso permite que qualquer pessoa visualize o status de um CodeBuild projeto. Como não contêm informações de segurança, os emblemas de compilação não exigem autenticação.

**Topics**
+ [Criar um projeto de compilação com emblemas de compilação](#sample-build-badges-request-running)
+ [Acesse os emblemas de AWS CodeBuild construção](access-badges.md)
+ [Publique emblemas de CodeBuild construção](publish-badges.md)
+ [CodeBuild status do crachá](badge-statuses.md)

## Criar um projeto de compilação com emblemas de compilação
<a name="sample-build-badges-request-running"></a>

Use um dos procedimentos a seguir para criar um projeto de compilação com emblemas de compilação ativados. Você pode usar AWS CLI ou Console de gerenciamento da AWS o.

**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 [Crie um projeto de compilação (AWS CLI)](create-project.md#create-project-cli). Para incluir emblemas de construção em seu AWS CodeBuild projeto, você deve especificar *badgeEnabled* com um valor de`true`.

**Para criar um projeto de compilação com emblemas de compilação habilitados (console)**

1. Abra o AWS CodeBuild console em [https://console.aws.amazon.com/codesuite/codebuild/home](https://console.aws.amazon.com/codesuite/codebuild/home).

1.  Se uma página de CodeBuild informações for exibida, escolha **Criar projeto de construção**. Caso contrário, no painel de navegação, expanda **Compilar**, escolha **Projetos de compilação** e, depois, **Criar projeto de compilação**. 

1. Em **Nome do projeto**, insira um nome para esse projeto de compilação. Os nomes dos projetos de criação devem ser exclusivos em cada AWS conta. 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.

1. 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**  
 CodeBuild não oferece suporte à criação de emblemas com o provedor de origem do Amazon S3. Como AWS CodePipeline usa o Amazon S3 para transferências de artefatos, os emblemas de construção não são compatíveis com projetos de construção que fazem parte de um pipeline criado em. CodePipeline 
   + Se você tiver escolhido **CodeCommit**, em **Repository (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ê escolher **GitHub**, siga as instruções para se conectar (ou reconectar) com GitHub. Na página GitHub **Autorizar aplicativo**, em **Acesso à organização**, escolha **Solicitar acesso** ao lado de cada repositório que você AWS CodeBuild deseja 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 de escolher **Conceder acesso**, de volta ao AWS CodeBuild console, para **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.

1. Em **Ambiente**:

   Para **Imagem do ambiente**, faça um dos seguintes procedimentos:
   + Para usar uma imagem do Docker gerenciada por AWS CodeBuild, escolha **Imagem gerenciada** e, em seguida, faça seleções em **Sistema operacional**, **Tempo de execução (s)**, **Imagem e Versão da** **imagem**. Faça uma seleção em **Environment type (Tipo de ambiente)** se estiver disponível.
   + Para usar outra imagem do Docker, selecione **Custom image (Imagem personalizada)**. Em **Tipo de ambiente**, selecione **ARM**, **Linux**, **Linux GPU** ou **Windows**. Se você selecionar **Other registry (Outro registro)**, em **External registry URL (URL de registro externo)**, insira o nome e a tag da imagem do Docker no Docker Hub usando o formato `docker repository/docker image name`. Se você escolher o **Amazon ECR**, use o **repositório Amazon ECR e** a imagem do **Amazon ECR para escolher a imagem** do Docker em sua conta. AWS 
   + Para usar uma imagem privada do Docker, selecione **Imagem personalizada**. Em **Tipo de ambiente**, selecione **ARM**, **Linux**, **Linux GPU** ou **Windows**. Em **Image registry (Registro da imagem)**, selecione **Other registry (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?](https://docs.aws.amazon.com/secretsmanager/latest/userguide/) no *Guia do usuário do AWS Secrets Manager *.

1. Em **Perfil de serviço**, faça um dos seguintes procedimentos:
   + Se você não tiver uma função CodeBuild de serviço, escolha **Nova função de serviço**. No campo **Role name**, digite o nome da nova função.
   + Se você tiver uma função CodeBuild de serviço, escolha **Função 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, você pode criar uma função de CodeBuild serviço ao mesmo tempo. Por padrão, a função funciona somente com esse projeto de build. Se você usar o console para associar essa função de serviço a outro projeto de compilação, a função será atualizada para funcionar com os outros projetos de compilação. Uma função de serviço pode funcionar com até 10 projetos de compilação.

1. 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 o [Referência de buildspec](build-spec-ref.md).

1. 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 **Name (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 **Bucket name**, 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 de `files` em [Sintaxe de buildspec](build-spec-ref.md#build-spec-ref-syntax).

1. Expanda **Configuração adicional** e escolha as opções conforme apropriado.

1. Selecione **Create build project (Criar projeto de compilação)**. Na página **Revisão**, escolha **Iniciar compilação** para executar a compilação.

# Acesse os emblemas de AWS CodeBuild construção
<a name="access-badges"></a>

Você pode usar o AWS CodeBuild console ou o AWS CLI para acessar os emblemas de construção.
+ No CodeBuild console, na lista de projetos de construção, na coluna **Nome**, escolha o link que corresponde ao projeto de construção. Na *project-name* página **Criar projeto:**, em **Configuração**, escolha **Copiar URL do selo**. Para obter mais informações, consulte [Visualizar detalhes de um projeto de compilação (console)](view-project-details.md#view-project-details-console).
+ No AWS CLI, execute o `batch-get-projects` comando. O URL do emblema de compilação está incluído na seção de detalhes do ambiente do projeto da saída. Para obter mais informações, consulte [Visualizar detalhes de um projeto de compilação (AWS CLI)](view-project-details.md#view-project-details-cli).

O URL de solicitação do emblema de compilação é gerado com uma ramificação padrão comum, mas é possível especificar qualquer ramificação no repositório de origem utilizado para executar uma compilação. Por exemplo:

```
https://codebuild.us-east-1.amazon.com/badges?uuid=...&branch=<branch>
```

Você também pode especificar uma tag do repositório de origem substituindo o parâmetro `branch` pelo parâmetro `tag` no URL do emblema. Por exemplo: 

```
https://codebuild.us-east-1.amazon.com/badges?uuid=...&tag=<tag>
```

# Publique emblemas de CodeBuild construção
<a name="publish-badges"></a>

É possível exibir o status da versão mais recente em um arquivo de markdown usando o URL do emblema de compilação em uma imagem de markdown. Isso é útil para exibir o status da compilação mais recente no arquivo readme.md no seu repositório de origem (por exemplo, ou). GitHub CodeCommit Por exemplo:

```
![](<build badge URL>)
```

# CodeBuild status do crachá
<a name="badge-statuses"></a>

O emblema de CodeBuild construção pode ter um dos seguintes status.
+ **PASSING** A compilação mais recente na ramificação indicada passada. 
+ **FAILING** A compilação mais recente na ramificação indicada expirou, falhou, apresentou defeito ou foi parada.
+ **IN\$1PROGRESS** A compilação mais recente na ramificação indicada está em andamento.
+ **UNKNOWN** O projeto ainda não executou uma compilação para a ramificação indicada ou nenhuma. Além disso, o recurso de emblemas de compilação pode ter sido desabilitado.