

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

# Configurar uma credencial de registro privada para executores auto-hospedados
<a name="private-registry-sample-configure-runners"></a>

Use as instruções apresentadas a seguir para configurar uma credencial de registro para um executor auto-hospedado.

**nota**  
Observe que essas credenciais só serão usadas se as imagens forem substituídas pelas de registros privados. 

------
#### [ AWS Management 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. Crie um projeto de compilação ou selecione um já existente. Para obter informações, consulte [Criar um projeto de compilação (console)](create-project.md#create-project-console) e [Alterar configurações de um projeto de compilação (console)](change-project.md#change-project-console).

1.  Em **Ambiente**, escolha **Configuração adicional**. 

1.  Em **Configuração adicional**, insira o nome ou ARN do formulário secreto AWS Secrets Manager para a **credencial do Registro** - opcional.  
![A configuração da credencial do registro.](http://docs.aws.amazon.com/pt_br/codebuild/latest/userguide/images/registry-credential.png)

------
#### [ AWS CLI ]

1. Se você quiser criar um projeto, execute o comando **create-project**.

   ```
   aws codebuild create-project \
       --name {{project-name}} \
       --source type={{source-type}},location={{source-location}} \
       --environment "type={{environment-type}},image={{image}},computeType={{compute-type}},registryCredential={credentialProvider=SECRETS_MANAGER,credential={{secret-name-or-arn}}},imagePullCredentialsType=CODEBUILD|SERVICE_ROLE" \
       --artifacts type={{artifacts-type}} \
       --service-role arn:aws:iam::{{account-ID}}:role/service-role/{{service-role-name}}
   ```

1. Se você quiser atualizar um projeto já existente, execute o comando **update-project**.

   ```
   aws codebuild update-project \
       --name {{project-name}} \
       --environment "type={{environment-type}},image={{image}},computeType={{compute-type}},registryCredential={credentialProvider=SECRETS_MANAGER,credential={{secret-name-or-arn}}}"
   ```

------