A Amazon não CodeCatalyst está mais aberta a novos clientes. Os clientes atuais podem continuar usando o serviço normalmente. Para obter mais informações, consulte [Como migrar do CodeCatalyst](migration.md).

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

# Configurando para usar o AWS CLI com CodeCatalyst
<a name="set-up-cli"></a>

O CodeCatalyst console da Amazon é onde você trabalhará na maioria das suas tarefas diárias. No entanto, talvez você queira configurar e configurar o AWS CLI quando estiver trabalhando com ambientes de desenvolvimento, tokens de acesso pessoal ou registros de eventos em CodeCatalyst. Você deve instalar AWS CLI e configurar um perfil antes de poder usá-lo com CodeCatalyst.<a name="how-to-set-up-cli"></a>

# Para configurar o AWS CLI para CodeCatalyst
<a name="how-to-set-up-cli"></a>

1. Instale a versão mais recente do AWS CLI. Se você já tiver uma versão do AWS CLI instalado, verifique se ela é recente e inclui comandos para CodeCatalyst, e atualize-a se necessário. Para verificar se você tem uma versão instalada que inclui CodeCatalyst comandos, abra um prompt de comando e execute o seguinte comando:

   ```
   aws codecatalyst help
   ```

   Se você ver uma lista de CodeCatalyst comandos, você tem uma versão compatível CodeCatalyst. Se o comando não for reconhecido, atualize sua versão do AWS CLI para a versão mais recente. Para obter mais informações, consulte [Instalando ou atualizando a versão mais recente do AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) no Guia AWS Command Line Interface do Usuário.

1. Execute o **aws configure** comando para criar um perfil se você não tiver um ou se quiser usar um perfil nomeado especificamente para CodeCatalyst. Recomendamos criar um perfil nomeado para usar especificamente CodeCatalyst, mas você também pode usar o perfil padrão. Para obter mais informações, consulte [Noções básicas de configuração](https://docs.aws.amazon.com//cli/latest/userguide/cli-configure-quickstart.html).

1. Edite o `config` arquivo do perfil para adicionar uma seção à qual se conectar da CodeCatalyst seguinte maneira. O arquivo `config` está localizado em `~/.aws/config` no Linux ou MacOS ou em `C:\Users\USERNAME\.aws\config` no Windows.

   ```
   [profile codecatalyst]
   region = us-west-2
   sso_session = codecatalyst
   
   [sso-session codecatalyst]
   sso_region = us-east-1
   sso_start_url = https://view.awsapps.com/start
   sso_registration_scopes = codecatalyst:read_write
   ```

1. Salve o arquivo.

1. Antes de tentar executar qualquer CodeCatalyst comando, abra um novo terminal ou prompt de comando e execute o comando a seguir para solicitar e recuperar credenciais para executar comandos. `aws codecatalyst` Substitua `codecatalyst` pelo nome do seu perfil, se necessário.

   ```
   aws sso login --profile codecatalyst
   ```

Para ver exemplos de comandos **codecatalyst**, consulte os seguintes tópicos:
+ [Conceder aos usuários acesso ao repositório com tokens de acesso pessoal](ipa-tokens-keys.md)
+ [Acesso a eventos de logs usando o registro de eventos](ipa-logs.md)