

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

# Solução de problemas da Amazon CodeCatalyst
<a name="troubleshooting"></a>

As informações a seguir podem ajudá-lo a solucionar problemas comuns no CodeCatalyst. Você também pode usar o relatório de CodeCatalyst saúde da Amazon para determinar se há problemas de serviço que possam estar afetando sua experiência.

**Topics**
+ [Solução de problemas de acesso gerais](#troubleshooting-general)
+ [Solução de problemas de suporte](#troubleshoot-support)
+ [Parte ou toda a Amazon CodeCatalyst não está disponível](#service-unavailable)
+ [Não consigo criar um projeto no CodeCatalyst](#troubleshoot-create-project)
+ [Não consigo acessar meu espaço BID como um novo usuário ou não posso ser adicionado como um novo usuário de SSO devido ao nome de usuário truncado](#troubleshoot-username-truncated)
+ [Adicionar um usuário do SSO ao meu espaço federado como um novo usuário criou um usuário duplicado](#troubleshoot-username-duplicated-SSO)
+ [Quero enviar feedback em CodeCatalyst](#troubleshoot-create-feedback)
+ [Solucionar problemas com repositórios de origem](troubleshooting-source.md)
+ [Solução de problemas de projetos e esquemas](projects-troubleshooting.md)
+ [Solucionar problemas com Ambientes de Desenvolvimento](devenvironments-troubleshooting.md)
+ [Solucionar problemas com fluxos de trabalho](troubleshooting-workflows.md)
+ [Solução de problemas](troubleshooting-issues.md)
+ [Solução de problemas com a pesquisa em CodeCatalyst](troubleshooting-search.md)
+ [Solução de problemas com extensões](troubleshooting-extensions.md)
+ [Solução de problemas de contas associadas ao seu espaço](troubleshooting-connections.md)
+ [Solução de problemas entre o Amazon CodeCatalyst e os SDKs da AWS ou AWS CLI](troubleshooting-cli-sdk.md)

## Solução de problemas de acesso gerais
<a name="troubleshooting-general"></a>

### Esqueci minha senha
<a name="id-forgot-password"></a>

**Problema:** esqueci a senha que uso para minha ID do AWS construtor e da Amazon CodeCatalyst.

**Possíveis correções:** a maneira mais fácil de corrigir esse problema é redefinir sua senha.

1. Abra a [Amazon CodeCatalyst](https://codecatalyst.aws/) e insira seu **endereço de e-mail**. Depois, escolha **Continuar**.

1. Escolha **Esqueci a senha**

1. Enviaremos um e-mail com um link para você alterar sua senha. Se você não vir o e-mail em sua conta, verifique a pasta de spam.

### Parte ou toda a Amazon CodeCatalyst não está disponível
<a name="service-unavailable"></a>

**Problema:** acessei ou segui um link para o CodeCatalyst console, mas vejo um erro.

**Possíveis correções:** os motivos mais comuns para esse problema são que você seguiu um link para um projeto ou espaço para o qual não foi convidado, ou há um problema de disponibilidade geral com o serviço. Confira o [relatório de integridade](health-dashboard.md) para ver se há algum problema conhecido com o serviço. Caso contrário, entre em contato com a pessoa que o convidou para o projeto ou espaço e peça outro convite. Se você não foi convidado para nenhum projeto ou espaço, pode se inscrever e [criar seu próprio espaço e projetos](sign-up-create-resources.md).

### Não consigo criar um projeto no CodeCatalyst
<a name="troubleshoot-create-project"></a>

**Problema:** quero criar um projeto, mas o botão **Criar projeto** aparece como indisponível ou recebo uma mensagem de erro.

**Possíveis correções: os** motivos mais comuns para esse problema são que você está conectado ao console com uma ID de AWS construtor que não tem a função de **administrador do Space**. Você deve ter esse perfil para criar projetos em um espaço.

Se você tiver essa função e o botão não aparecer como disponível, pode haver um problema transitório com o serviço. Atualize o navegador e tente novamente.

## Solução de problemas de suporte
<a name="troubleshoot-support"></a>

### Recebo uma mensagem de erro ao acessar Suporte a Amazon CodeCatalyst
<a name="troubleshoot-support-rolepolicy"></a>

**Problema:** Quando escolho a CodeCatalyst opção Suporte para a Amazon, recebo a seguinte mensagem de erro:

**`Unable to assume role`**

`To access support cases, you must add the role AWSRoleForCodeCatalystSupport to the Conta da AWS that is the billing account for the space.`

**Possíveis correções:** adicione o perfil necessário para a Conta da AWS que é a conta de faturamento do espaço. A conta designada como conta de faturamento do espaço usa o perfil `AWSRoleForCodeCatalystSupport` e a política gerenciada `AmazonCodeCatalystSupportAccess`. Para obter mais informações, consulte [Criação do perfil **AWSRoleForCodeCatalystSupport** para a conta e o espaço](ipa-iam-roles.md#ipa-iam-roles-support-create).

**nota**  
Um AWS Builder ID só pode obter suporte para o alias com o qual está autenticado e somente para recursos com base nas permissões em. CodeCatalyst O suporte de conta e faturamento está disponível para todos os usuários do espaço. No entanto, os criadores só podem obter suporte para recursos e informações para os quais tenham permissão. CodeCatalyst

### Não consigo criar casos de suporte técnico para meu espaço
<a name="troubleshoot-support-technical-cases"></a>

**Problema:** não consigo criar casos de suporte técnico para meu espaço.

**Correções:** um plano Business Support ou Enterprise Support precisa ser adicionado à conta de faturamento de espaço para que os usuários do espaço criem casos de suporte técnico. Peça para que o administrador do espaço adicione um plano de Suporte à sua conta de faturamento do espaço ou acesse https://repost.aws/ para perguntar à comunidade da AWS .

### Minha conta para casos de suporte não está mais conectada ao meu espaço no CodeCatalyst
<a name="troubleshoot-support-disconnected-account"></a>

**Problema:** Minha conta para casos de suporte não está mais conectada ao meu espaço em CodeCatalyst.

**Correções:** se um usuário com a função de **administrador do Space** mudar de conta de faturamento do espaço, isso desconectará o Suporte plano e todos os casos associados do espaço. Os Suporte casos associados à antiga conta de cobrança espacial não estarão mais visíveis na Suporte Amazon CodeCatalyst. O usuário raiz dessa conta de faturamento pode visualizar e resolver casos antigos a partir do Console de gerenciamento da AWS e pode configurar permissões do IAM Suporte para que outros usuários visualizem e resolvam casos antigos. Você não poderá continuar recebendo suporte técnico da antiga conta CodeCatalyst de faturamento espacial por meio do Console de gerenciamento da AWS, mas poderá receber suporte técnico para outros serviços até que seu Suporte plano seja cancelado.

Para ter mais informações, consulte [Updating, resolving, and reopening your case](https://docs.aws.amazon.com//awssupport/latest/user/monitoring-your-case.html) no *Guia do usuário do Suporte *.

### Não consigo abrir um caso de suporte para outro AWS service (Serviço da AWS) na Suporte Amazon CodeCatalyst
<a name="troubleshoot-support-other-services"></a>

**Problema:** Não consigo abrir um caso de suporte para outro AWS service (Serviço da AWS) em Suporte for CodeCatalyst.

**Possíveis correções:** você só pode abrir casos de CodeCatalyst suporte a partir de Suporte for CodeCatalyst. Se você precisar de suporte para serviços ou recursos implantados de outro serviço AWS, da CodeCatalyst Amazon ou de outro serviço terceirizado, precisará criar um caso por meio do canal de suporte de serviços terceirizado Console de gerenciamento da AWS ou do canal de suporte de serviços terceirizado. Para ter mais informações, consulte [Creating support cases and case management](https://docs.aws.amazon.com//awssupport/latest/user/case-management.html) no *Guia do usuário do Suporte *. 

## Parte ou toda a Amazon CodeCatalyst não está disponível
<a name="service-unavailable"></a>

**Problema:** acessei ou segui um link para o CodeCatalyst console, mas vejo um erro.

**Possíveis correções:** os motivos mais comuns para esse problema são que você seguiu um link para um projeto ou espaço para o qual não foi convidado, ou há um problema de disponibilidade geral com o serviço. Confira o [relatório de integridade](health-dashboard.md) para ver se há algum problema conhecido com o serviço. Caso contrário, entre em contato com a pessoa que o convidou para o projeto ou espaço e peça outro convite. Se você não foi convidado para nenhum projeto ou espaço, pode se inscrever e [criar seu próprio espaço e projetos](sign-up-create-resources.md).

## Não consigo criar um projeto no CodeCatalyst
<a name="troubleshoot-create-project"></a>

**Problema:** quero criar um projeto, mas o botão **Criar projeto** aparece como indisponível ou recebo uma mensagem de erro.

**Possíveis correções: os** motivos mais comuns para esse problema são que você está conectado ao console com uma ID de AWS construtor que não tem a função de **administrador do Space**. Você deve ter esse perfil para criar projetos em um espaço.

Se você tiver essa função e o botão não aparecer como disponível, pode haver um problema transitório com o serviço. Atualize o navegador e tente novamente.

## Não consigo acessar meu espaço BID como um novo usuário ou não posso ser adicionado como um novo usuário de SSO devido ao nome de usuário truncado
<a name="troubleshoot-username-truncated"></a>

**Problema:** CodeCatalyst trunca os nomes de usuário após 100 caracteres, o que pode fazer com que alguns nomes de usuário pareçam idênticos. Como um novo usuário acessando um CodeCatalyst espaço, eu enfrento esse problema dependendo do tipo de espaço, da seguinte forma:
+ Tenho uma ID de AWS construtor que quero usar para fazer login CodeCatalyst. Quando tento entrar no espaço, recebo uma mensagem informando que meu nome de usuário não é válido.
+ Sou administrador de identidade federado de um CodeCatalyst espaço que oferece suporte à federação de identidades. Ao adicionar um novo usuário aos usuários e grupos de SSO no Centro de Identidade do IAM, recebo uma mensagem de que o usuário não é válido.

**Possíveis correções:** o primeiro usuário a entrar CodeCatalyst ou ser adicionado ao espaço como usuário de SSO com um determinado nome de usuário truncado será bem-sucedido. Qualquer usuário que se cadastrar com um AWS Builder ID ou for adicionado ao IAM Identity Center depois disso não conseguirá fazer login porque o nome parecerá duplicado. Dependendo do tipo de espaço, siga um destes procedimentos:
+ Para poder entrar no espaço AWS Builder ID, cadastre-se com um nome de usuário diferente.
+ Para adicionar o novo usuário no Centro de Identidade do IAM, adicione-o com um nome de usuário diferente.

**nota**  
Mesmo que o nome de usuário pareça estar truncado, CodeCatalyst mapeia a identidade de uma forma que não seja afetada por nomes de usuário com nomes truncados. No entanto, se for criado um nome de usuário igual a um nome de usuário truncado, esse nome de usuário não estará disponível se outro usuário associado (com o mesmo espaço ou aplicativo do IAM Identity Center) já tiver ingressado CodeCatalyst com esse nome de usuário truncado.

## Adicionar um usuário do SSO ao meu espaço federado como um novo usuário criou um usuário duplicado
<a name="troubleshoot-username-duplicated-SSO"></a>

**Problema:** usuários de CodeCatalyst SSO adicionados a um CodeCatalyst espaço e depois removidos podem ter um problema na tentativa de reutilização do nome de usuário. Isso pode resultar em um erro semelhante ao seguinte, em que o usuário não pode ser duplicado, mesmo que tenha sido recriado. 

**`Unable to assume role`**

`To access support cases, you must add the role AWSRoleForCodeCatalystSupport to the Conta da AWS that is the billing account for the space.`

**Possíveis correções:** se um usuário existente do IDC for excluído e um novo usuário for recriado com o mesmo nome de usuário, o novo usuário não poderá fazer login devido ao conflito do nome de usuário com o usuário antigo. Depois que um nome de usuário é adicionado a um espaço como um usuário do SSO, o nome não pode ser usado novamente. Qualquer usuário que se cadastrar com um AWS Builder ID ou for adicionado ao IAM Identity Center depois disso não conseguirá fazer login porque o nome parecerá duplicado. 

Dependendo do tipo de espaço, siga um destes procedimentos:
+ Para poder entrar no espaço AWS Builder ID, cadastre-se com um nome de usuário diferente.
+ Para adicionar o novo usuário no Centro de Identidade do IAM, adicione-o com um nome de usuário diferente.

## Quero enviar feedback em CodeCatalyst
<a name="troubleshoot-create-feedback"></a>

**Problema:** Encontrei um bug CodeCatalyst e quero enviar um feedback.

**Possíveis correções:** você pode enviar feedback diretamente em CodeCatalyst.

1. Abra o CodeCatalyst console em [https://codecatalyst.aws/](https://codecatalyst.aws/).

1. No painel de navegação, selecione **Enviar feedback**.

1. Selecione o tipo de feedback no menu suspenso e insira seu feedback.

# Solucionar problemas com repositórios de origem
<a name="troubleshooting-source"></a>

As informações a seguir podem ajudá-lo a solucionar problemas comuns com repositórios de origem em. CodeCatalyst

**Topics**
+ [Atingi o máximo de armazenamento do meu espaço e são exibidos avisos ou erros](#source-troubleshoot-storage)
+ [Eu recebo uma mensagem de erro ao tentar clonar ou enviar para um repositório de CodeCatalyst origem da Amazon](#source-troubleshoot-clone)
+ [Eu recebo uma mensagem de erro ao tentar confirmar ou enviar para um repositório de CodeCatalyst origem da Amazon](#source-troubleshoot-commit-code)
+ [Preciso de um repositório de origem para meu projeto](#source-troubleshoot-need-repository)
+ [Meu repositório de origem é totalmente novo, mas contém uma confirmação](#source-troubleshoot-initial-commit)
+ [Quero uma ramificação diferente como minha ramificação padrão](#source-troubleshoot-default-branch)
+ [Estou recebendo e-mails sobre atividades em solicitações pull](#source-troubleshoot-repository-emails)
+ [Esqueci meu token de acesso pessoal (PAT)](#source-troubleshoot-forgot-pat)
+ [Uma solicitação pull não exibe as alterações esperadas](#source-troubleshoot-pull-request-diff)
+ [Uma solicitação pull mostra o status Não mesclável](#source-troubleshoot-pull-request-not-mergeable)

## Atingi o máximo de armazenamento do meu espaço e são exibidos avisos ou erros
<a name="source-troubleshoot-storage"></a>

**Problema:** quero enviar o código para um ou mais repositórios de origem em CodeCatalyst, mas vejo um erro. No console, vejo uma mensagem na página de repositório de origem informando que atingi o limite de armazenamento do espaço. 

**Possíveis correções:** dependendo do seu perfil no projeto ou no espaço, você pode reduzir o tamanho de um ou mais repositórios de origem, excluir repositórios de origem não usados ou alterar seu nível de faturamento para um que tenha mais armazenamento.
+ Para reduzir o tamanho de um repositório de origem em um projeto, exclua ramificações não usadas. Para obter mais informações, consulte [Exclusão de uma ramificação](source-branches-delete.md) e [Perfil de colaborador](ipa-role-types.md#ipa-role-contributor).
+ Para reduzir o armazenamento geral de um espaço, exclua repositórios de origem não usados. Para obter mais informações, consulte [Exclusão de um repositório de origem](source-repositories-delete.md) e [Perfil de administrador do projeto](ipa-role-types.md#ipa-role-project-admin).
+ Para aumentar a quantidade de armazenamento disponível para seu espaço, altere seu nível de faturamento para um com mais armazenamento. Para obter mais informações, consulte [Alterar seu nível CodeCatalyst de cobrança](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-billing-change-plan.html) no Amazon CodeCatalyst Administrator Guide.

## Eu recebo uma mensagem de erro ao tentar clonar ou enviar para um repositório de CodeCatalyst origem da Amazon
<a name="source-troubleshoot-clone"></a>

**Problema:** quando tento clonar um repositório de origem em um computador local ou em um Ambiente de Desenvolvimento integrado (IDE), recebo um erro de permissões.

**Possíveis correções:** talvez você não tenha um token de acesso pessoal (PAT) para seu AWS Builder ID, talvez não tenha configurado seu sistema de gerenciamento de credenciais com seu PAT ou seu PAT pode ter expirado. Tente uma ou mais das seguintes soluções:
+ Crie um token de acesso pessoal (PAT). Para obter mais informações, consulte [Conceder aos usuários acesso ao repositório com tokens de acesso pessoal](ipa-tokens-keys.md).
+ Verifique se você aceitou um convite para o projeto que contém o repositório de origem e se você ainda é membro desse projeto. Você não pode clonar um repositório de origem se não for um membro ativo desse projeto. Entre no console e tente navegar até o espaço e o projeto em que você está tentando clonar um repositório de origem. Se você não consegue ver o projeto na lista de projetos do espaço, significa que não é membro desse projeto ou não aceitou um convite para esse projeto. Para obter mais informações, consulte [Aceitando um convite e criando um AWS Builder ID](sign-up-sign-in.md).
+ Verifique se o comando clone está formatado corretamente e inclui sua ID do AWS Builder. Por exemplo:

  ```
  https://LiJuan@git.us-west-2.codecatalyst.aws/v1/ExampleCorp/MyExampleProject/MyExampleRepo
  ```
+ Use o AWS CLI para garantir que você tenha um PAT associado à sua ID do AWS Builder e que ele não esteja expirado. Se você não tiver um ou o PAT estiver expirado, crie um. Para obter mais informações, consulte [Conceder aos usuários acesso ao repositório com tokens de acesso pessoal](ipa-tokens-keys.md).
+ Tente criar um Ambiente de Desenvolvimento para trabalhar com o código no repositório de origem em vez de cloná-lo em um repositório ou IDE local. Para obter mais informações, consulte [Criar um Ambiente de Desenvolvimento](devenvironment-create.md).

## Eu recebo uma mensagem de erro ao tentar confirmar ou enviar para um repositório de CodeCatalyst origem da Amazon
<a name="source-troubleshoot-commit-code"></a>

**Problema:** quando tento enviar para um repositório de origem, recebo um erro de permissões.

**Possíveis correções:** talvez você não tenha um perfil no projeto que permita confirmar e enviar alterações de código para o projeto. Veja seu perfil no projeto em que você está tentando enviar alterações para um repositório de origem. Para obter mais informações, consulte [Obtenção de uma lista dos membros e perfis no projeto](projects-members.md#projects-members-view) e [Concessão de acesso com perfis de usuário](ipa-roles.md). 

Se você tem um perfil que permite confirmar e enviar alterações, a ramificação em que você está tentando confirmar as alterações pode ter uma regra de ramificação configurada para ela que impede o envio de alterações de código para essa ramificação. Em vez disso, tente criar uma ramificação e enviar seu código para ela. Para obter mais informações, consulte [Gerenciar as ações permitidas para uma ramificação com regras de ramificação](source-branches-branch-rules.md).

## Preciso de um repositório de origem para meu projeto
<a name="source-troubleshoot-need-repository"></a>

**Problema:** meu projeto não tem um repositório de origem ou eu preciso de outro repositório de origem para meu projeto.

**Possíveis correções:** alguns projetos são criados sem nenhum recurso. Se você for membro do projeto, poderá criar repositórios de origem para esse projeto em CodeCatalyst. Se alguém com a função de **administrador do Space** instalar os **GitHub repositórios** e conectá-los a uma GitHub conta, você poderá vinculá-los aos GitHub repositórios disponíveis para adicioná-los ao seu projeto, se tiver a função de administrador do **projeto**. Para ter mais informações, consulte [Criação de um repositório de origem](source-repositories-create.md) e [Vinculação de um repositório de origem](source-repositories-link.md).

## Meu repositório de origem é totalmente novo, mas contém uma confirmação
<a name="source-troubleshoot-initial-commit"></a>

**Problema:** acabei de criar um repositório de origem. Ele deve estar vazio, mas contém uma confirmação, uma ramificação e um arquivo `README.md`.

**Possíveis correções:** esse é o comportamento esperado. Todos os repositórios de origem CodeCatalyst incluem uma confirmação inicial que define a ramificação padrão como `main` e inclui um código de amostra (se o repositório tiver sido criado para um projeto usando um esquema que inclua um código de amostra) ou um arquivo markdown modelo para um arquivo README do repositório. Você pode criar ramificações adicionais no console e nos clientes Git. Você pode criar e editar arquivos no console e excluir arquivos em Ambientes de Desenvolvimento e clientes Git.

## Quero uma ramificação diferente como minha ramificação padrão
<a name="source-troubleshoot-default-branch"></a>

**Problema:** meu repositório de origem veio com uma ramificação padrão chamada `main`, mas quero uma ramificação diferente como minha ramificação padrão.

**Possíveis correções:** você não pode alterar ou excluir a ramificação padrão nos repositórios de origem em CodeCatalyst. Você pode criar ramificações adicionais e usar essas ramificações nas ações de origem nos fluxos de trabalho. Você também pode optar por vincular GitHub repositórios e usá-los como repositórios para seu projeto.

## Estou recebendo e-mails sobre atividades em solicitações pull
<a name="source-troubleshoot-repository-emails"></a>

**Problema:** não me inscrevi nem configurei notificações por e-mail sobre a atividade de solicitação pull, mas as estou recebendo mesmo assim.

**Possíveis correções:** as notificações por e-mail são enviadas automaticamente sobre a atividade da solicitação pull. Para obter mais informações, consulte [Análise de código com pull requests na Amazon CodeCatalyst](source-pull-requests.md).

## Esqueci meu token de acesso pessoal (PAT)
<a name="source-troubleshoot-forgot-pat"></a>

**Problema:** estou usando um PAT para clonar, enviar e extrair código para repositórios de origem, mas perdi o valor do meu token e não consigo encontrá-lo no console. CodeCatalyst 

**Possíveis correções:** a maneira mais rápida de resolver esse problema é criar outro PAT e configurar seu gerenciador de credenciais ou IDE para usar esse novo PAT. Só exibimos o valor de um PAT quando você o cria. Se você perder esse valor, ele não poderá ser recuperado. Para obter mais informações, consulte [Conceder aos usuários acesso ao repositório com tokens de acesso pessoal](ipa-tokens-keys.md).

## Uma solicitação pull não exibe as alterações esperadas
<a name="source-troubleshoot-pull-request-diff"></a>

**Problema:** criei uma solicitação pull, mas não vejo as mudanças esperadas entre as ramificações de origem e de destino.

**Possíveis correções:** isso pode ser causado por vários problemas. Tente uma ou mais das seguintes soluções:
+ Você pode estar revisando as alterações entre as revisões mais antigas ou pode não estar vendo as alterações mais recentes. Atualize seu navegador e verifique se você escolheu a comparação entre as revisões que deseja visualizar.
+ Nem todas as alterações em uma solicitação pull podem ser exibidas no console. Por exemplo, você não pode visualizar os submódulos do Git no console, portanto, não pode ver as diferenças em um submódulo em uma solicitação pull. Algumas diferenças podem ser muito grandes para serem exibidas. Para obter mais informações, consulte [Cotas para repositórios de origem em CodeCatalyst](source-quotas.md) e [Visualizar um arquivoVisualizar o histórico de alterações em um arquivo](source-files-view.md).
+ As solicitações pull exibem as diferenças entre a base de mesclagem e qualquer revisão que você escolher. Ao criar uma solicitação pull, a diferença exibida é a diferença entre a ponta da ramificação de origem e a ponta da ramificação de destino. Depois que a solicitação pull é criada, a diferença exibida é entre a revisão e sua base de mesclagem. A base de mesclagem é a confirmação que era a ponta da ramificação de destino quando a revisão foi criada. A base de mesclagem pode mudar entre as revisões. Para obter mais informações sobre diferenças e bases de mesclagem no Git, [git-merge-base](https://git-scm.com/docs/git-merge-base)consulte a documentação do Git. 

## Uma solicitação pull mostra o status Não mesclável
<a name="source-troubleshoot-pull-request-not-mergeable"></a>

**Problema:** quero mesclar uma solicitação pull, mas seu status é exibido como **Não mesclável**.

**Possíveis correções:** isso pode ser causado por um ou mais problemas:
+ Todos os revisores necessários para sua solicitação pull devem aprovar uma solicitação pull antes que ela possa ser mesclada. Revise a lista de revisores obrigatórios para qualquer revisor com um ícone de relógio ao lado do nome. Um ícone de relógio indica que o revisor não aprovou a solicitação pull.
**nota**  
Se um revisor obrigatório tiver sido removido do seu projeto antes de aprovar a solicitação pull, ela não poderá ser mesclada. Feche a solicitação pull e crie uma nova.
+ Pode haver um conflito de mesclagem entre a ramificação de origem e a ramificação de destino. CodeCatalyst não suporta todas as estratégias e opções possíveis de mesclagem do Git. Você pode avaliar as ramificações em busca de conflitos de mesclagem em um Ambiente de Desenvolvimento ou clonar o repositório e usar um IDE ou ferramentas Git para localizar e resolver conflitos de mesclagem. Para obter mais informações, consulte [Mesclar uma solicitação pull](pull-requests-merge.md).

# Solução de problemas de projetos e esquemas
<a name="projects-troubleshooting"></a>

Esta seção pode ajudar você a solucionar alguns problemas comuns que pode encontrar ao trabalhar com projetos e esquemas no Amazon CodeCatalyst.

# API Java com dependências ausentes do AWS Fargate blueprint para apache-maven-3.8.6
<a name="projects-troubleshooting-error-maven"></a>

**Problema:** para um projeto criado a partir da API Java com AWS Fargate blueprint, o fluxo de trabalho falha com um erro por `apache-maven-3.8.6` dependências ausentes. O fluxo de trabalho falha com uma saída semelhante ao seguinte exemplo:

```
Step 8/25 : RUN wget https://dlcdn.apache.org/maven/maven-3/3.8.6/binaries/apache-maven-3.8.6-bin.tar.gz -P /tmp
---> Running in 1851ce6f4d1b
[91m--2023-03-10 01:24:55--  https://dlcdn.apache.org/maven/maven-3/3.8.6/binaries/apache-maven-3.8.6-bin.tar.gz
[0m[91mResolving dlcdn.apache.org (dlcdn.apache.org)... 
[0m[91m151.101.2.132, 2a04:4e42::644
Connecting to dlcdn.apache.org (dlcdn.apache.org)|151.101.2.132|:443... 
[0m[91mconnected.
[0m[91mHTTP request sent, awaiting response... [0m[91m404 Not Found
2023-03-10 01:24:55 ERROR 404: Not Found.
[0mThe command '/bin/sh -c wget https://dlcdn.apache.org/maven/maven-3/3.8.6/binaries/apache-maven-3.8.6-bin.tar.gz -P /tmp' returned a non-zero code: 8
[Container] 2023/03/10 01:24:55 Command failed with exit status 8
```

**Solução:** atualize o Dockerfile do esquema usando as etapas a seguir.

1. Na barra de pesquisa, insira `apache-maven-3.8.6` para localizar o dockerfile dentro do projeto criado com a API Java com o esquema AWS Fargate .

1.  Atualize o Dockerfile (`/static-assets/app/Dockerfile`) para usar `maven:3.9.0-amazoncorretto-11` como imagem base e remova a dependência do pacote `apache-maven-3.8.6`. 

1. (Recomendado) Também recomendamos atualizar o tamanho da pilha do Maven para 6 GB.

Confira abaixo um exemplo de Dockerfile.

```
FROM maven:3.9.0-amazoncorretto-11 AS builder

COPY ./pom.xml ./pom.xml
COPY src ./src/

ENV MAVEN_OPTS='-Xmx6g'

RUN mvn -Dmaven.test.skip=true clean package

FROM amazoncorretto:11-alpine

COPY —from=builder target/CustomerService-0.0.1.jar CustomerService-0.0.1.jar
EXPOSE 80
CMD ["java","-jar","-Dspring.profiles.active=prod","/CustomerService-0.0.1.jar", "—server.port=80"]
```

# O fluxo de trabalho moderno de três camadas do blueprint de aplicativos web **OnPullRequest**falha com erro de permissões para a Amazon CodeGuru
<a name="projects-troubleshooting-onpullrequest"></a>

**Problema:** quando tento executar um fluxo de trabalho para meu projeto, o fluxo de trabalho não é executado com a seguinte mensagem: 

```
Failed at codeguru_codereview: The action failed during runtime. View the action's logs for more details.
```

``

**Solução:** uma possível causa dessa falha de ação pode ser devido à falta de permissões na política de função do IAM, em que sua versão da função de serviço usada por CodeCatalyst in the connected não tem as permissões necessárias para que a ação **codeguru\$1codereview Conta da AWS ** seja executada com êxito. Para corrigir esse problema, a função de serviço deve ser atualizada com as permissões necessárias ou você deve alterar a função de serviço usada para o fluxo de trabalho para uma que tenha as permissões necessárias para a Amazon CodeGuru e o Amazon CodeGuru Reviewer. Realizando as etapas a seguir, encontre seu perfil e atualize as permissões da política de perfil para que o fluxo de trabalho seja executado com êxito.

**nota**  
Essas etapas se aplicam aos seguintes fluxos de trabalho em: CodeCatalyst  
O **OnPullRequest**fluxo de trabalho fornecido para projetos criados com o modelo moderno de aplicativo web de três camadas em. CodeCatalyst
Fluxos de trabalho adicionados aos projetos CodeCatalyst com ações que acessam a Amazon CodeGuru ou o Amazon CodeGuru Reviewer.

Cada projeto contém fluxos de trabalho com ações que usam uma função e um ambiente fornecidos pelos Conta da AWS conectados ao seu projeto em CodeCatalyst. O fluxo de trabalho com as ações e a política designada é armazenado em seu repositório de origem no diretório /.codecatalyst/workflows. Não é necessário modificar o YAML do fluxo de trabalho, a menos que você esteja adicionando um novo ID de perfil ao fluxo de trabalho existente. Para ter mais informações sobre elementos de modelo e formatação do YAML, consulte [Definição do YAML do fluxo de trabalho](workflow-reference.md).

Essas são as etapas detalhadas a serem seguidas para editar sua política de perfil e verificar o YAML do fluxo de trabalho.

**Para referenciar o nome do perfil no YAML do fluxo de trabalho e atualizar a política**

1. Abra o CodeCatalyst console em [https://codecatalyst.aws/](https://codecatalyst.aws/).

1. Navegue até seu CodeCatalyst espaço. Navegue até o projeto.

1. Selecione **CI/CD** e, depois, selecione **Fluxos de trabalho**. 

1. Escolha o fluxo de trabalho intitulado **OnPullRequest**. Escolha a guia **Definição**.

1. No YAML do fluxo de trabalho, no campo `Role:` abaixo da ação **codeguru\$1codereview**, anote o nome do perfil. Esse é o perfil com a política que você modificará no IAM. O exemplo a seguir mostra o nome do perfil.  
![\[Visualizar o nome do perfil do IAM no YAML do fluxo de trabalho\]](http://docs.aws.amazon.com/pt_br/codecatalyst/latest/userguide/images/projects/ts-workflow-role.png)

1. Execute um destes procedimentos:
   + (Recomendado) Atualize a função de serviço conectada ao seu projeto com as permissões necessárias para a Amazon CodeGuru e o Amazon CodeGuru Reviewer. O perfil terá um nome `CodeCatalystWorkflowDevelopmentRole-spaceName` com um identificador exclusivo anexado. Para ter mais informações sobre o perfil e a política de perfis, consulte [Noções básicas sobre o perfil de serviço **CodeCatalystWorkflowDevelopmentRole-*spaceName***](ipa-iam-roles.md#ipa-iam-roles-service-role). Continue com as próximas etapas para atualizar a política no IAM.
**nota**  
Você deve ter acesso de AWS administrador ao Conta da AWS com a função e a política. 
   + Altere a função de serviço usada para o fluxo de trabalho para uma que tenha as permissões necessárias para a Amazon CodeGuru e o Amazon CodeGuru Reviewer ou crie uma nova função com as permissões necessárias.

1. Faça login no Console de gerenciamento da AWS e abra o console do IAM em [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).

   No console do IAM, encontre o perfil na etapa 5, como `CodeCatalystPreviewDevelopmentRole`.

1. No perfil da etapa 5, altere a política de permissão para incluir as permissões `codeguru-reviewer:*` e `codeguru:*`. Depois de adicionar essas permissões, a política de permissões deve ser semelhante à seguinte:

1. Depois de fazer as correções de política, retorne CodeCatalyst e inicie a execução do fluxo de trabalho novamente.

## Ainda está tentando resolver seu problema?
<a name="projects-last-help"></a>

Você pode acessar o [Amazon CodeCatalyst](https://codecatalyst.aws/) ou preencher um [Formulário de feedback de suporte](https://support.aws.amazon.com/#/contacts/aws-account-support/). Na seção **Solicitar informações**, em **Como podemos ajudar**, inclua que você é um cliente do Amazon CodeCatalyst. Forneça o máximo de detalhes possível para que possamos resolver seu problema da maneira mais eficiente.

# Solucionar problemas com Ambientes de Desenvolvimento
<a name="devenvironments-troubleshooting"></a>

Consulte as seções a seguir para solucionar problemas relacionados a Ambientes de Desenvolvimento. Para ter mais informações sobre Ambientes de Desenvolvimento, consulte [Escreva e modifique o código com Dev Environments em CodeCatalystEscrever e modificar código com ambientes de desenvolvimento](devenvironment.md).

**Topics**
+ [A criação do meu Ambiente de Desenvolvimento não foi bem-sucedida devido a um problema com cotas](#troubleshooting-devenvironments-create)
+ [Não consigo enviar alterações do meu Ambiente de Desenvolvimento para uma ramificação específica em um repositório](#troubleshooting-devenvironments-branchrules)
+ [Meu Ambiente de Desenvolvimento não foi retomado](#troubleshooting-devenvironments-resume)
+ [Meu Ambiente de Desenvolvimento foi desconectado](#troubleshooting-devenvironments-connection)
+ [Meu Ambiente de Desenvolvimento conectado à VPC falhou](#troubleshooting-devenvironments-vpc)
+ [Não consigo encontrar em qual diretório meu projeto está](#troubleshooting-devenvironments-projects)
+ [Não consigo me conectar ao Ambiente de Desenvolvimento via SSH](#troubleshooting-devenvironments-connect-ssh)
+ [Não consigo me conectar ao Ambiente de Desenvolvimento via SSH porque minha configuração SSH local está ausente](#troubleshooting-devenvironments-projects-ssh-config)
+ [Não consigo me conectar ao meu ambiente de desenvolvimento via SSH porque estou tendo problemas com AWS Config o `codecatalyst` meu perfil](#troubleshooting-devenvironments-config-profile)
+ [Não consigo criar um ambiente de desenvolvimento quando estou conectado CodeCatalyst usando uma conta de login único](#troubleshoot-create-dev-env-idprovider)
+ [Solução de problemas com IDEs](devenvironments-troubleshooting-ides.md)
+ [Solução de problemas com devfiles](devenvironments-devenvironments-devfile.md)

## A criação do meu Ambiente de Desenvolvimento não foi bem-sucedida devido a um problema com cotas
<a name="troubleshooting-devenvironments-create"></a>

**Problema:** quero criar um ambiente de desenvolvimento no CodeCatalyst, mas vejo um erro. No console, vejo uma mensagem na página Ambientes de Desenvolvimento informando que atingi o limite de armazenamento do espaço.

**Possíveis correções:** dependendo do perfil no projeto ou no espaço, você pode excluir um ou mais dos seus próprios Ambientes de Desenvolvimento ou, se for o administrador do espaço, poderá excluir Ambientes de Desenvolvimento não utilizados criados por outros usuários. Você também pode decidir alterar o nível de faturamento para um que inclua mais armazenamento.
+ Para ver os limites de armazenamento, consulte a guia **Faturamento** do CodeCatalyst espaço da Amazon para ver se as cotas de **uso** atingiram o máximo permitido. Se as cotas tiverem atingido o máximo, entre em contato com alguém com o perfil de administrador do espaço para remover ambientes de desenvolvimento desnecessários ou considerar a alteração do nível de faturamento.
+ Para remover qualquer Ambiente de Desenvolvimento que você criou e que não precisa mais, consulte [Excluir um Ambiente de Desenvolvimento](devenvironment-delete.md).

Se o problema persistir e você receber um erro no seu IDE, verifique se você tem uma CodeCatalyst função que permite criar um ambiente de desenvolvimento. Os perfis de **Administrador do espaço**, **Administrador do projeto** e **Colaborador** têm permissão para criar ambientes de desenvolvimento. Para obter mais informações, consulte [Concessão de acesso com perfis de usuário](ipa-roles.md).

## Não consigo enviar alterações do meu Ambiente de Desenvolvimento para uma ramificação específica em um repositório
<a name="troubleshooting-devenvironments-branchrules"></a>

**Problema:** quero confirmar e enviar alterações de código no meu Ambiente de Desenvolvimento para uma ramificação em um repositório de origem, mas vejo um erro. 

**Possíveis correções:** dependendo do seu perfil no projeto ou no espaço, talvez você não tenha permissões para enviar o código para os repositórios de origem do projeto. Os perfis de **Administrador do espaço**, **Administrador do projeto** e **Colaborador** têm permissão para enviar código aos repositórios do projeto.

Se você for **Colaborador**, mas não conseguir enviar o código para uma ramificação específica, pode haver uma regra configurada para a ramificação específica que impede que os usuários com esse perfil enviem o código para essa ramificação específica. Tente enviar suas alterações para uma ramificação diferente ou criar uma ramificação e, depois, enviar seu código para essa ramificação. Para obter mais informações, consulte [Gerenciar as ações permitidas para uma ramificação com regras de ramificação](source-branches-branch-rules.md).

## Meu Ambiente de Desenvolvimento não foi retomado
<a name="troubleshooting-devenvironments-resume"></a>

**Problema:** meu Ambiente de Desenvolvimento não foi retomado depois que eu o interrompi.

**Possíveis correções:** Para corrigir o problema, consulte a guia **Faturamento** do CodeCatalyst espaço da Amazon para ver se as cotas de **uso** atingiram os limites máximos. Se as cotas tiverem atingido o limite máximo, entre em contato com o administrador do espaço para aumentar o nível de faturamento.

## Meu Ambiente de Desenvolvimento foi desconectado
<a name="troubleshooting-devenvironments-connection"></a>

**Problema:** meu Ambiente de Desenvolvimento foi desconectado enquanto eu o estava usando.

**Possíveis correções:** para resolver o problema, verifique a conexão com a Internet. Se você não estiver conectado à Internet, conecte-se e continue trabalhando no Ambiente de Desenvolvimento.

## Meu Ambiente de Desenvolvimento conectado à VPC falhou
<a name="troubleshooting-devenvironments-vpc"></a>

**Problema:** associei uma conexão VPC ao meu Ambiente de Desenvolvimento e ela está apresentando erros.

**Possíveis correções:** o Docker usa um dispositivo de camada de link, chamado rede de ponte, que permite que os contêineres conectados à mesma rede de ponte se comuniquem. A ponte padrão geralmente usa a sub-rede `172.17.0.0/16` para rede de contêineres. Se a sub-rede da VPC para a instância do ambiente usar o mesmo intervalo de endereços que já for usado pelo Docker, poderá ocorrer um conflito de endereço IP. Para resolver um conflito de endereço IP causado pela Amazon VPC e Docker usando o mesmo bloco de endereços IPv4 CIDR, configure um bloco CIDR diferente de. `172.17.0.0/16`

**nota**  
Não é possível alterar o intervalo de endereços IP de uma VPC ou sub-rede existente.

## Não consigo encontrar em qual diretório meu projeto está
<a name="troubleshooting-devenvironments-projects"></a>

**Problema:** não consigo encontrar em qual diretório meu projeto está.

**Possíveis correções:** para localizar seu projeto, altere o diretório para `/projects`. Esse é o diretório onde você pode encontrar seus projetos.

## Não consigo me conectar ao Ambiente de Desenvolvimento via SSH
<a name="troubleshooting-devenvironments-connect-ssh"></a>

Para solucionar problemas de conexão com seu Ambiente de Desenvolvimento via SSH, você pode executar o comando `ssh` com a opção `-vvv` de mostrar mais informações sobre como resolver seu problema:

```
ssh -vvv codecatalyst-dev-env=<space-name>=<project-name>=<dev-environment-id>
```

## Não consigo me conectar ao Ambiente de Desenvolvimento via SSH porque minha configuração SSH local está ausente
<a name="troubleshooting-devenvironments-projects-ssh-config"></a>

Se sua configuração SSH local (`~/.ssh/config`) estiver ausente ou o conteúdo da seção `Host codecatalyst-dev-env*` estiver desatualizado, você não conseguirá se conectar ao Ambiente de Desenvolvimento via SSH. Para solucionar esse problema, exclua a seção `Host codecatalyst-dev-env*` e execute o primeiro comando do modal **Acesso SSH** novamente. Para obter mais informações, consulte [Estabelecer conexão com um Ambiente de Desenvolvimento usando SSH](devenvironment-connect-ssh.md).

## Não consigo me conectar ao meu ambiente de desenvolvimento via SSH porque estou tendo problemas com AWS Config o `codecatalyst` meu perfil
<a name="troubleshooting-devenvironments-config-profile"></a>

Certifique-se de que seu AWS Config (`~/.aws/config`) para o `codecatalyst` perfil corresponda ao descrito em[Configurando para usar o AWS CLI com CodeCatalyst](set-up-cli.md). Caso contrário, exclua o perfil de `codecatalyst` e execute o primeiro comando do modal **Acesso SSH** novamente. Para obter mais informações, consulte [Estabelecer conexão com um Ambiente de Desenvolvimento usando SSH](devenvironment-connect-ssh.md).

## Não consigo criar um ambiente de desenvolvimento quando estou conectado CodeCatalyst usando uma conta de login único
<a name="troubleshoot-create-dev-env-idprovider"></a>

**Problema:** quando estou conectado ao CodeCatalyst console como usuário de SSO, recebo um erro de exceção desconhecido quando escolho criar um ambiente de desenvolvimento no espaço. Quando escolho criar um ambiente de desenvolvimento e escolher o IDE para acesso, por exemplo AWS Cloud9, tenho problemas semelhantes aos seguintes: 
+ A página **Dev Environments** no CodeCatalyst console mostra o Dev Environment na lista com um `FAILED` estado.
+ Uma mensagem de erro semelhante à mensagem abaixo é exibida:

  **`An unknown exception happened`**

  `We encountered an unknown exception when launching your Dev Environment. Mention your Dev Environment id error_message_ID if you want to report or need any help.`

**Correções possíveis:** 

Os Ambientes de Desenvolvimento não estão disponíveis para usuários em espaços em que o Active Directory é usado como provedor de identidade. Os administradores do espaço podem usar um provedor de identidade alternativo para acessar ambientes de desenvolvimento, como o IAM Identity Center. Para obter mais informações sobre como planejar um espaço que ofereça suporte à federação de identidades, consulte [Planejando seu espaço que ofereça suporte à federação de identidades](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/setting-up-federation.html#setting-up-planning-federation) no *Guia CodeCatalyst do Administrador*.

# Solução de problemas com IDEs
<a name="devenvironments-troubleshooting-ides"></a>

Consulte as seções a seguir para solucionar problemas relacionados aos IDEs no CodeCatalyst. Para ter mais informações sobre IDEs, consulte [Criação de um Ambiente de Desenvolvimento em um IDE](devenvironment-create.md#devenvironment-using-ide).

**Topics**
+ [Eu tenho versões de imagem de runtime incompatíveis no AWS Cloud9](#troubleshooting-devenvironments-c9-runtime)
+ [Não consigo acessar meus arquivos em `/projects/projects` no AWS Cloud9](#troubleshooting-devenvironments-c9-filesystem)
+ [Não consigo iniciar meu Ambiente de Desenvolvimento no AWS Cloud9 usando um devfile personalizado](#troubleshooting-devenvironments-c9-image)
+ [Estou com problemas no AWS Cloud9](#troubleshooting-c9)
+ [No JetBrains, não é possível conectar aos ambientes de desenvolvimento por meio do CodeCatalyst](#troubleshooting-jetbrains-connect)
+ [Não consigo instalar AWS Toolkit para o meu IDE](#troubleshooting-ide-toolkit)
+ [No meu IDE, não consigo iniciar meus ambientes de desenvolvimento](#troubleshooting-ide-launch)

## Eu tenho versões de imagem de runtime incompatíveis no AWS Cloud9
<a name="troubleshooting-devenvironments-c9-runtime"></a>

O AWS Cloud9 está usando versões diferentes do ativo de frontend e da imagem de runtime do backend. Usar versões diferentes pode fazer com que a extensão Git e AWS Toolkit funcionem incorretamente. Para corrigir o problema, navegue até o painel do Ambiente de Desenvolvimento, interrompa o Ambiente de Desenvolvimento e inicie-o novamente. Para corrigir o problema usando APIs, use a API `UpdateDevEnvironment` para atualizar o runtime. Para ter mais informações, consulte [UpdateDevEnvironment](https://docs.aws.amazon.com/codecatalyst/latest/APIReference/API_UpdateDevEnvironment.html) na *Referência da API do Amazon CodeCatalyst*.

## Não consigo acessar meus arquivos em `/projects/projects` no AWS Cloud9
<a name="troubleshooting-devenvironments-c9-filesystem"></a>

O editor do AWS Cloud9 não consegue acessar os arquivos no diretório `/projects/projects`. Para corrigir o problema, use o terminal do AWS Cloud9 para acessar seus arquivos ou movê-los para um diretório diferente.

## Não consigo iniciar meu Ambiente de Desenvolvimento no AWS Cloud9 usando um devfile personalizado
<a name="troubleshooting-devenvironments-c9-image"></a>

Sua imagem do devfile pode não ser compatível com o AWS Cloud9. Para corrigir o problema, revise o devfile do seu repositório e do Ambiente de Desenvolvimento correspondente e crie outro para continuar.

## Estou com problemas no AWS Cloud9
<a name="troubleshooting-c9"></a>

Para outros problemas, consulte a seção de solução de problemas no [Guia do usuário do AWS Cloud9](https://docs.aws.amazon.com/cloud9/latest/user-guide/troubleshooting.html).

## No JetBrains, não é possível conectar aos ambientes de desenvolvimento por meio do CodeCatalyst
<a name="troubleshooting-jetbrains-connect"></a>

Para corrigir o problema, confira se você tem somente a versão mais recente do JetBrains instalada. Se você tiver várias versões, desinstale as versões mais antigas e registre seu manipulador de protocolo novamente fechando o IDE e o navegador. Em seguida, abra o JetBrains e registre o manipulador de protocolo novamente.

## Não consigo instalar AWS Toolkit para o meu IDE
<a name="troubleshooting-ide-toolkit"></a>

Para corrigir esse problema no VS Code, instale manualmente AWS Toolkit for Visual Studio Code no [GitHub](https://github.com/aws/aws-toolkit-vscode/releases).

Para corrigir esse problema no JetBrains, instale manualmente AWS Toolkit for JetBrains no [GitHub](https://github.com/aws/aws-toolkit-jetbrains/releases).

## No meu IDE, não consigo iniciar meus ambientes de desenvolvimento
<a name="troubleshooting-ide-launch"></a>

Para corrigir esse problema no VS Code, confira se você tem a versão mais recente do VS Code e AWS Toolkit for Visual Studio Code instalada. Se você não tiver a versão mais recente, atualize e inicie seu Ambiente de Desenvolvimento. Para ter mais informações, consulte [Amazon CodeCatalyst para VS Code](https://docs.aws.amazon.com/toolkit-for-vscode/latest/userguide/codecatalyst-service.html).

Para corrigir esse problema no JetBrains, confira se você tem a versão mais recente do JetBrains e AWS Toolkit for JetBrains instalada. Se você não tiver a versão mais recente, atualize e inicie seu Ambiente de Desenvolvimento. Para ter mais informações, consulte [Amazon CodeCatalyst para JetBrains](https://docs.aws.amazon.com/toolkit-for-jetbrains/latest/userguide/codecatalyst-overview.html).

# Solução de problemas com devfiles
<a name="devenvironments-devenvironments-devfile"></a>

Consulte as seções a seguir para solucionar problemas relacionados aos devfiles em. CodeCatalyst Para ter mais informações sobre devfiles, consulte [Configuração de um devfile para um Ambiente de Desenvolvimento](devenvironment-devfile.md).

**Topics**
+ [Meu Ambiente de Desenvolvimento está usando o devfile universal padrão, embora eu tenha implementado uma imagem personalizada em um devfile personalizado](#troubleshooting-devenvironments-custom-image)
+ [Meu projeto não está sendo criado em meu Ambiente de Desenvolvimento com o devfile universal padrão](#troubleshooting-devenvironments-default-image)
+ [Quero mover um repositório devfile para um Ambiente de Desenvolvimento](#troubleshooting-devenvironments-devfile-moving)
+ [Estou com um problema ao iniciar meu devfile](#troubleshooting-devenvironments-devfile-recovery)
+ [Não tenho certeza de como verificar o status do meu devfile](#troubleshooting-devenvironments-devfile-status)
+ [Meu devfile não é compatível com as ferramentas fornecidas na imagem mais recente](#troubleshooting-devenvironments-devfile-version)

## Meu Ambiente de Desenvolvimento está usando o devfile universal padrão, embora eu tenha implementado uma imagem personalizada em um devfile personalizado
<a name="troubleshooting-devenvironments-custom-image"></a>

Se CodeCatalyst encontrar erros ao iniciar um ambiente de desenvolvimento que esteja usando um devfile personalizado, o ambiente de desenvolvimento usará como padrão o devfile universal padrão. Para corrigir o problema, você pode verificar o erro exato nos logs em `/aws/mde/logs/devfile.log`. Você também pode verificar se a execução de `postStart` foi bem-sucedida em seus logs: `/aws/mde/logs/devfileCommand.log`.

## Meu projeto não está sendo criado em meu Ambiente de Desenvolvimento com o devfile universal padrão
<a name="troubleshooting-devenvironments-default-image"></a>

Para corrigir o problema, verifique se você não está usando um devfile personalizado. Se você não estiver usando um devfile personalizado, visualize o arquivo `devfile.yaml` no repositório de origem do projeto para localizar e corrigir quaisquer erros.

## Quero mover um repositório devfile para um Ambiente de Desenvolvimento
<a name="troubleshooting-devenvironments-devfile-moving"></a>

Você pode mover o devfile padrão em `/projects/devfile.yaml` para o seu repositório de código-fonte. Para atualizar a localização do devfile, use o seguinte comando: `/aws/mde/mde start --location repository-name/devfile.yaml`.

## Estou com um problema ao iniciar meu devfile
<a name="troubleshooting-devenvironments-devfile-recovery"></a>

Se houver algum problema ao iniciar seu devfile, ele entrará no modo de recuperação para que você ainda possa se conectar ao ambiente e corrigir o devfile. No modo de recuperação, a execução de `/aws/mde/mde status` não conterá a localização do devfile.

```
{
    "status": "STABLE"
}
```

Você pode verificar o erro nos logs em `/aws/mde/logs`, corrigir o devfile e tentar executar `/aws/mde/mde start` novamente.

## Não tenho certeza de como verificar o status do meu devfile
<a name="troubleshooting-devenvironments-devfile-status"></a>

Você pode verificar o status do seu devfile executando `/aws/mde/mde status`. Depois de executar esse comando, você provavelmente verá um dos seguintes:
+ `{"status": "STABLE", "location": "devfile.yaml" }`

  Isso indica que seu devfile está correto.
+ `{"status": "STABLE" }`

  Isso indica que seu devfile não foi iniciado e entrou no modo de recuperação.

Você pode verificar o erro exato nos logs em `/aws/mde/logs/devfile.log`.

Você também pode verificar se a execução de `postStart` foi bem-sucedida em seus logs: `/aws/mde/logs/devfileCommand.log`.

Para obter mais informações, consulte [Especificar imagens de devfile universais para um Ambiente de Desenvolvimento](devenvironment-universal-image.md).

## Meu devfile não é compatível com as ferramentas fornecidas na imagem mais recente
<a name="troubleshooting-devenvironments-devfile-version"></a>

No Ambiente de Desenvolvimento, `devfile` ou `devfile postStart` poderá falhar se as ferramentas `latest` não tiverem as ferramentas necessárias para um projeto específico. Para corrigir o problema, faça o seguinte:<a name="devenvironment-devfile-version"></a>

1. Navegue até o seu devfile.

1. No devfile, atualize para uma versão de imagem granular em vez de `latest`. Ele pode ser similar ao seguinte:

   ```
   components:
     - container:
         image: public.ecr.aws/amazonlinux/universal-image:1.0
   ```

1. Crie um Ambiente de Desenvolvimento usando o devfile atualizado.

# Solucionar problemas com fluxos de trabalho
<a name="troubleshooting-workflows"></a>

Consulte as seções a seguir para solucionar problemas relacionados aos fluxos de trabalho na Amazon. CodeCatalyst Para obter mais informações sobre fluxos de trabalho, consulte [Compilação, teste e implantação com fluxos de trabalhoCompilação, teste e implantação com fluxos de trabalho](workflow.md).

**Topics**
+ [Como faço para corrigir as mensagens “O fluxo de trabalho está inativo”?](#troubleshooting-workflows-inactive)
+ [Como faço para corrigir os erros “A definição do fluxo de trabalho tem *n* erros”?](#troubleshooting-workflows-asterisks)
+ [Como faço para corrigir os erros “Não é possível localizar credenciais” e ExpiredToken "”?](#troubleshooting-workflows-auth-errors-eks)
+ [Como faço para corrigir os erros “Não foi possível conectar-se ao servidor”?](#troubleshooting-workflows-unable-connect-eks)
+ [Por que os CodeDeploy campos estão ausentes no editor visual?](#troubleshooting-workflows-codedeploy)
+ [Como faço para corrigir erros de recursos do IAM?](#troubleshooting-workflows-capabilities)
+ [Como faço para corrigir erros de “instalação npm”?](#troubleshooting-workflows-npm)
+ [Por que vários fluxos de trabalho têm o mesmo nome?](#troubleshooting-workflows-name)
+ [Posso armazenar meus arquivos de definição de fluxo de trabalho em outra pasta?](#troubleshooting-workflows-folder)
+ [Como adiciono ações em sequência ao meu fluxo de trabalho?](#troubleshooting-workflows-visual)
+ [Por que meu fluxo de trabalho é validado com sucesso, mas falha em runtime?](#troubleshooting-workflows-validation)
+ [A descoberta automática não descobre nenhum relatório da minha ação](#troubleshooting-reports-auto-discovery)
+ [Minha ação falha em relatórios descobertos automaticamente depois que eu configuro os critérios de sucesso](#troubleshooting-success-auto-discovery)
+ [A descoberta automática gera relatórios que eu não quero](#troubleshooting-unwanted-auto-discovery)
+ [A descoberta automática gera diversos pequenos relatórios para uma única estrutura de teste](#troubleshooting-reports-combined)
+ [Os fluxos de trabalho listados abaixo CI/CD não correspondem aos do repositório de origem](#troubleshooting-workflow-source)
+ [Não consigo criar ou atualizar fluxos de trabalho](#troubleshooting-workflows-branchrules)

## Como faço para corrigir as mensagens “O fluxo de trabalho está inativo”?
<a name="troubleshooting-workflows-inactive"></a>

**Problema**: No CodeCatalyst console, em **CI/CD**, **Fluxos de trabalho**, seu fluxo de trabalho aparece com a seguinte mensagem: 

`Workflow is inactive.`

Essa mensagem indica que o arquivo de definição do fluxo de trabalho contém um gatilho que não se aplica à ramificação em que você está atualmente. Por exemplo, seu arquivo de definição de fluxo de trabalho pode conter um gatilho `PUSH` que faz referência à sua ramificação `main`, mas você está em uma ramificação de recursos. Como as alterações que você está fazendo em sua ramificação de recursos não se aplicam e não iniciarão a `main` execução do fluxo de trabalho`main`, CodeCatalyst desative o fluxo de trabalho na ramificação e o marque como. `Inactive`

**Correções possíveis:**

Se quiser iniciar um fluxo de trabalho na ramificação de recursos, faça o seguinte:
+ Em sua ramificação de recursos, no arquivo de definição do fluxo de trabalho, remova a propriedade `Branches` da seção `Triggers` para que fique assim:

  ```
  Triggers:
    - Type: PUSH
  ```

  Essa configuração faz com que o gatilho seja ativado ao enviar para qualquer ramificação, incluindo sua ramificação de recursos. Se o gatilho estiver ativado, CodeCatalyst iniciará a execução de um fluxo de trabalho usando o arquivo de definição do fluxo de trabalho e os arquivos de origem em qualquer ramificação para a qual você esteja enviando.
+ Em sua ramificação de recursos, no arquivo de definição do fluxo de trabalho, remova a seção `Triggers` e execute o fluxo de trabalho manualmente.
+ Em sua ramificação de recursos, no arquivo de definição do fluxo de trabalho, altere a seção `PUSH` para que ela faça referência à sua ramificação de recursos em vez de outra ramificação (como `main`, por exemplo).

**Importante**  
Tome cuidado para não confirmar essas alterações se você não pretende mesclá-las de volta à sua ramificação `main`.

Para ter mais informações sobre como editar o arquivo de definição de fluxo de trabalho, consulte [Criação de um fluxo de trabalho](workflows-create-workflow.md).

Para ter mais informações sobre gatilhos, consulte [Início da execução automática de um fluxo de trabalho usando gatilhos](workflows-add-trigger.md).

## Como faço para corrigir os erros “A definição do fluxo de trabalho tem *n* erros”?
<a name="troubleshooting-workflows-asterisks"></a>

**Problema:** você vê uma das seguintes mensagens de erro:

**Erro 1**:

Na página **CI/CD**, **Fluxos de trabalho**, abaixo do nome do seu fluxo de trabalho, é possível visualizar:

`Workflow definition has n errors`

**Erro 2:**

Ao editar um fluxo de trabalho, você escolhe o botão **Validar** e a seguinte mensagem aparece na parte superior do CodeCatalyst console:

`The workflow definition has errors. Fix the errors and choose Validate to verify your changes.`

**Erro 3:**

Depois de navegar até a página de detalhes do seu fluxo de trabalho, o seguinte erro será exibido no campo **Definição do fluxo de trabalho**:

`n errors`

**Correções possíveis:** 
+ Selecione **CI/CD**, **Fluxos de trabalho** e o nome do fluxo de trabalho que tem o erro. No campo **Definição do fluxo de trabalho** próximo à parte superior, selecione o link para o erro. Os detalhes sobre o erro são exibidos na parte inferior da página. Siga as dicas de solução de problemas no erro para corrigir o problema.
+ Verifique se o arquivo de definição do fluxo de trabalho é um arquivo YAML.
+ Verifique se as propriedades YAML no arquivo de definição do fluxo de trabalho estão aninhadas no nível correto. Para ver como as propriedades devem ser aninhadas no arquivo de definição do fluxo de trabalho, consulte [Definição do YAML do fluxo de trabalho](workflow-reference.md) ou a documentação da sua ação, vinculada de [Adição de uma ação a um fluxo de trabalho](workflows-add-action.md). 
+ Verifique se os asteriscos (`*`) e outros caracteres especiais escaparam corretamente. Para escapar deles, adicione aspas simples ou duplas. Por exemplo:

  ```
  Outputs:      
    Artifacts:
      - Name: myartifact
        Files:
          - "**/*"
  ```

  Para ter mais informações sobre caracteres especiais no arquivo de definição de fluxo de trabalho, consulte [Diretrizes e convenções de sintaxe](workflow-reference.md#workflow.terms.syntax.conv).
+ Verifique se as propriedades YAML no arquivo de definição do fluxo de trabalho fazem uso correto de letras maiúsculas e minúsculas. Para ter mais informações sobre regras de uso de maiúsculas e minúsculas, consulte [Diretrizes e convenções de sintaxe](workflow-reference.md#workflow.terms.syntax.conv). Para determinar o uso de maiúsculas e minúsculas correto de cada propriedade, consulte [Definição do YAML do fluxo de trabalho](workflow-reference.md) ou a documentação da sua ação, vinculada de [Adição de uma ação a um fluxo de trabalho](workflows-add-action.md).
+ Verifique se a propriedade `SchemaVersion` está presente e definida para a versão correta no arquivo de definição do fluxo de trabalho. Para obter mais informações, consulte [SchemaVersion](workflow-reference.md#workflow.schemaversion).
+ Certifique-se de que a seção `Triggers` no arquivo de definição do fluxo de trabalho inclua todas as propriedades necessárias. Para determinar as propriedades necessárias, selecione o gatilho no [editor visual](workflow.md#workflow.editors) e procure os campos com informações ausentes ou consulte a documentação de referência do gatilho em [Triggers](workflow-reference.md#triggers-reference).
+ Certifique-se de que a propriedade `DependsOn` no arquivo de definição do fluxo de trabalho esteja configurada corretamente e não introduza dependências circulares. Para obter mais informações, consulte [Sequenciar ações](workflows-depends-on.md).
+ Certifique-se de que a seção `Actions` no arquivo de definição do fluxo de trabalho inclua pelo menos uma ação. Para obter mais informações, consulte [Ações](workflow-reference.md#actions-reference). 
+ Assegure-se de que cada ação inclua todas as propriedades necessárias. Para determinar as propriedades necessárias, selecione a ação no [editor visual](workflow.md#workflow.editors) e procure por campos com informações ausentes ou consulte a documentação da sua ação, vinculada de [Adição de uma ação a um fluxo de trabalho](workflows-add-action.md).
+ Assegure-se de que todos os artefatos de entrada tenham artefatos de saída correspondentes. Para obter mais informações, consulte [Definir um artefato de saída](workflows-working-artifacts-output.md).
+ Assegure-se de que as variáveis definidas em uma ação sejam exportadas para que possam ser usadas em outras ações. Para obter mais informações, consulte [Exportação de uma variável para que outras ações possam usá-la](workflows-working-with-variables-export-input.md).

## Como faço para corrigir os erros “Não é possível localizar credenciais” e ExpiredToken "”?
<a name="troubleshooting-workflows-auth-errors-eks"></a>

**Problema**: durante o trabalho em [Tutorial: Implantar uma aplicação no Amazon EKS](deploy-tut-eks.md), você vê uma ou as duas mensagens de erro a seguir na janela do terminal da sua máquina de desenvolvimento:

`Unable to locate credentials. You can configure credentials by running "aws configure".`

`ExpiredToken: The security token included in the request is expired` 

**Correções possíveis:**

Esses erros indicam que as credenciais que você está usando para acessar AWS os serviços expiraram. Nesse caso, não execute o comando `aws configure`. Em vez disso, use as instruções a seguir para atualizar sua chave de AWS acesso e token de sessão.

**Para atualizar sua chave de AWS acesso e token de sessão**

1. Verifique se você tem o URL do portal de AWS acesso, o nome de usuário e a senha do usuário que você está usando no tutorial completo do Amazon EKS (`codecatalyst-eks-user`). Você deve ter configurado esses itens ao concluir [Etapa 1: configurar sua máquina de desenvolvimento](deploy-tut-eks.md#deploy-tut-eks-dev-env-create) do tutorial.
**nota**  
Se você não tiver essas informações, acesse a página de detalhes do `codecatalyst-eks-user` no IAM Identity Center, selecione **Redefinir senha**, **Gerar uma senha de uso único [...]** e **Redefinir senha** novamente para exibir as informações na tela.

1. Execute um destes procedimentos:
   + Cole o URL do portal de AWS acesso na barra de endereço do seu navegador.

     Ou
   + Atualize a página do portal de AWS acesso se ela já estiver carregada.

1. Faça login com o nome de usuário e senha de `codecatalyst-eks-user`, caso ainda não tenha feito.

1. Selecione **Conta da AWS** e, depois, escolha o nome da Conta da AWS a que você atribuiu o usuário `codecatalyst-eks-user` e o conjunto de permissões.

1. Ao lado do nome do conjunto de permissões (`codecatalyst-eks-permission-set`), selecione **Linha de comando ou acesso programático**.

1. Copie os comandos no meio da página. Eles são semelhantes a:

   ```
   export AWS_ACCESS_KEY_ID="AKIAIOSFODNN7EXAMPLE" 
   export AWS_SECRET_ACCESS_KEY="wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY" 
   export AWS_SESSION_TOKEN="session-token"
   ```

   ... onde *session-token* está uma longa sequência aleatória.

1. Cole os comandos no prompt do terminal em sua máquina de desenvolvimento e pressione Enter.

   As novas chaves e o token da sessão são carregados.

   Você atualizou suas credenciais. Os `kubectl` comandos AWS CLI`eksctl`, e agora devem funcionar. 

## Como faço para corrigir os erros “Não foi possível conectar-se ao servidor”?
<a name="troubleshooting-workflows-unable-connect-eks"></a>

**Problema**: ao trabalhar no tutorial descrito em [Tutorial: Implantar uma aplicação no Amazon EKS](deploy-tut-eks.md), você vê uma mensagem de erro semelhante à seguinte na janela do terminal da sua máquina de desenvolvimento:

`Unable to connect to the server: dial tcp: lookup long-string.gr7.us-west-2.eks.amazonaws.com on 1.2.3.4:5: no such host`

**Correções possíveis:**

Esse erro geralmente indica que as credenciais que o utilitário `kubectl` está usando para se conectar ao seu cluster Amazon EKS expiraram. Para solucionar o problema, atualize as credenciais inserindo o comando a seguir no prompt do terminal:

```
aws eks update-kubeconfig --name codecatalyst-eks-cluster --region us-west-2
```

Em que:
+ *codecatalyst-eks-cluster*é substituído pelo nome do seu cluster Amazon EKS.
+ *us-west-2*é substituído pela AWS região em que seu cluster está implantado.

## Por que os CodeDeploy campos estão ausentes no editor visual?
<a name="troubleshooting-workflows-codedeploy"></a>

**Problema**: você está usando uma ação [Deploy to Amazon ECS](deploy-action-ecs.md) e não está vendo os CodeDeploy campos, como **CodeDeploy AppSpec**no editor visual do fluxo de trabalho. Esse problema pode ocorrer porque o serviço Amazon ECS especificado no campo **Serviço** não está configurado para realizar implantações azuis/verdes.

**Correções possíveis:** 
+ Escolha um serviço do Amazon ECS diferente na guia **Configuração** da ação **Implantar no Amazon ECS**. Para obter mais informações, consulte [Implantação no Amazon ECS com um fluxo de trabalho](deploy-action-ecs.md).
+ Configure o serviço Amazon ECS selecionado para realizar blue/green implantações. Para obter mais informações sobre a configuração de blue/green implantações, consulte Implantação [azul/verde no](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/deployment-type-bluegreen.html) *Amazon Elastic Container CodeDeploy* Service Developer Guide.

## Como faço para corrigir erros de recursos do IAM?
<a name="troubleshooting-workflows-capabilities"></a>

**Problema**: você está usando uma ação [Deploy CloudFormation stack](deploy-action-cfn.md) e vê `##[error] requires capabilities: [capability-name]` nos registros da ação **Deploy CloudFormation stack**.

**Possíveis correções**: conclua o procedimento a seguir para adicionar o recurso ao arquivo de definição do fluxo de trabalho. Para obter mais informações sobre os recursos do IAM, consulte Como [reconhecer recursos do IAM em CloudFormation modelos](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-iam-template.html#using-iam-capabilities) no *Guia do usuário do IAM*.

------
#### [ Visual ]

**Como adicionar um recurso do IAM usando o editor visual**

1. Abra o CodeCatalyst console em [https://codecatalyst.aws/](https://codecatalyst.aws/).

1. Selecione o projeto.

1. No painel de navegação, escolha **CI/CD** e **Fluxos de trabalho**.

1. Selecione o nome do fluxo de trabalho. É possível filtrar pelo nome do repositório ou da ramificação de origem em que o fluxo de trabalho está definido, ou filtrar pelo nome ou o status do fluxo de trabalho.

1. Escolha **Editar**.

1. Selecione **Visual**.

1. No diagrama do fluxo de trabalho, selecione sua ação **Implantar pilha CloudFormation **.

1. Escolha a guia **Configuração**.

1. Na parte inferior, selecione **Avançado – opcional**.

1. Na lista suspensa **Capacidades**, marque a caixa de seleção ao lado do recurso mencionado na mensagem de erro. Se o recurso não estiver disponível na lista, use o editor YAML para adicioná-lo.

1. (Opcional) Selecione **Validar** para validar o código YAML do fluxo de trabalho antes de confirmar.

1. Selecione **Confirmar**, insira uma mensagem de confirmação e escolha **Confirmar** novamente.

1. Se a execução de um novo fluxo de trabalho não for iniciada automaticamente, execute o fluxo de trabalho manualmente para ver se as alterações corrigem o erro. Para ter mais informações sobre como executar manualmente um fluxo de trabalho, consulte [Iniciar um fluxo de trabalho executado manualmente](workflows-manually-start.md).

------
#### [ YAML ]

**Como adicionar um recurso do IAM usando o editor YAML**

1. Abra o CodeCatalyst console em [https://codecatalyst.aws/](https://codecatalyst.aws/).

1. Selecione o projeto.

1. No painel de navegação, escolha **CI/CD** e **Fluxos de trabalho**.

1. Selecione o nome do fluxo de trabalho. É possível filtrar pelo nome do repositório ou da ramificação de origem em que o fluxo de trabalho está definido, ou filtrar pelo nome ou o status do fluxo de trabalho.

1. Escolha **Editar**.

1. Selecione **YAML**.

1. Na ação **Deploy CloudFormation stack**, adicione uma `capabilities` propriedade, como esta:

   ```
   DeployCloudFormationStack:
     Configuration:
       capabilities: capability-name
   ```

   *capability-name*Substitua pelo nome do recurso do IAM mostrado na mensagem de erro. Use vírgulas e nenhum espaço para listar vários recursos. Para ter mais informações, consulte a descrição da propriedade `capabilities` em [Ação “Implantar CloudFormation pilha” YAML](deploy-action-ref-cfn.md).

1. (Opcional) Selecione **Validar** para validar o código YAML do fluxo de trabalho antes de confirmar.

1. Selecione **Confirmar**, insira uma mensagem de confirmação e escolha **Confirmar** novamente.

1. Se a execução de um novo fluxo de trabalho não for iniciada automaticamente, execute o fluxo de trabalho manualmente para ver se as alterações corrigem o erro. Para ter mais informações sobre como executar manualmente um fluxo de trabalho, consulte [Iniciar um fluxo de trabalho executado manualmente](workflows-manually-start.md).

------

## Como faço para corrigir erros de “instalação npm”?
<a name="troubleshooting-workflows-npm"></a>

**Problema**: sua [ação de implantar AWS CDK](cdk-dep-action.md) ou [ação de bootstrap AWS CDK](cdk-boot-action.md) falha com o erro `npm install`. Esse erro pode ocorrer porque você está armazenando as dependências do seu AWS CDK aplicativo em um registro privado do gerenciador de pacotes de nós (npm) que não pode ser acessado pela ação. 

**Possíveis correções**: use as instruções a seguir para atualizar o `cdk.json` arquivo do seu AWS CDK aplicativo com informações adicionais de registro e autenticação.

**Antes de começar**

1. Crie segredos para suas informações de autenticação. Você referenciará esses segredos no arquivo `cdk.json` em vez de fornecer os equivalentes em texto não criptografado. Para criar os segredos:

   1. Abra o CodeCatalyst console em [https://codecatalyst.aws/](https://codecatalyst.aws/).

   1. Selecione o projeto.

   1. No painel de navegação, escolha **CI/CD** e **Segredos**.

   1. Crie dois segredos com as seguintes propriedades:    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/codecatalyst/latest/userguide/troubleshooting-workflows.html)

      Para ter mais informações sobre segredos, consulte [Mascarar dados usando segredos](workflows-secrets.md).

1. Adicione os segredos como variáveis de ambiente à sua AWS CDK ação. A ação substituirá as variáveis por valores reais quando for executada. Para adicionar os segredos:

   1. No painel de navegação, escolha **CI/CD** e **Fluxos de trabalho**.

   1. Selecione o nome do fluxo de trabalho. É possível filtrar pelo nome do repositório ou da ramificação de origem em que o fluxo de trabalho está definido, ou filtrar pelo nome ou o status do fluxo de trabalho.

   1. Escolha **Editar**.

   1. Selecione **Visual**.

   1. No diagrama do fluxo de trabalho, escolha sua AWS CDK ação.

   1. Escolha a guia **Entradas**.

   1. Adicione duas variáveis com as seguintes propriedades:    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/codecatalyst/latest/userguide/troubleshooting-workflows.html)

      Agora você tem duas variáveis contendo referências a segredos.

   O código YAML do arquivo de definição de fluxo de trabalho deve ser semelhante ao seguinte:
**nota**  
O exemplo de código a seguir é de uma ação de **AWS CDK bootstrap**; uma ação de **AWS CDK implantação** será semelhante.

   ```
   Name: CDK_Bootstrap_Action
   SchemaVersion: 1.0
   Actions:
     CDKBootstrapAction:
       Identifier: aws/cdk-bootstrap@v2
       Inputs:
         Variables:
           - Name: NPMUSER
             Value: ${Secrets.npmUsername}
           - Name: NPMTOKEN
             Value: ${Secrets.npmAuthToken}
         Sources:
           - WorkflowSource
       Environment:
         Name: Dev2
         Connections:
           - Name: account-connection
             Role: codecatalystAdmin
       Configuration:
         Parameters:
           Region: "us-east-2"
   ```

   Agora, você está pronto para usar as variáveis `NPMUSER` e `NPMTOKEN` em seu arquivo `cdk.json`. Vá para o próximo procedimento.

**Como atualizar o arquivo cdk.json**

1. Vá para o diretório raiz do seu AWS CDK projeto e abra o `cdk.json` arquivo.

1. Encontre a `"app":` propriedade e altere-a para incluir o código mostrado em*red italics*:
**nota**  
O código de exemplo a seguir é de um TypeScript projeto. Se você estiver usando um JavaScript projeto, o código parecerá semelhante, mas não idêntico.

   ```
   {
     "app": "npm set registry=https://your-registry/folder/CDK-package/ --userconfig .npmrc && npm set //your-registry/folder/CDK-package/:always-auth=true --userconfig .npmrc && npm set //your-registry/folder/CDK-package/:_authToken=\"${NPMUSER}\":\"${NPMTOKEN}\" && npm install  && npx ts-node --prefer-ts-exts bin/hello-cdk.ts|js",
     "watch": {
       "include": [
         "**"
       ],
       "exclude": [
         "README.md",
         "cdk*.json",
         "**/*.d.ts",
         "**/*.js",
         "tsconfig.json",
         "package*.json",
   ...
   ```

1. No código destacado em*red italics*, substitua:
   + *your-registry/folder/CDK-package/*com o caminho para as dependências AWS CDK do seu projeto em seu registro privado.
   + *hello-cdk.ts\$1.js*com o nome do seu arquivo de ponto de entrada. Isso pode ser um arquivo `.ts` (TypeScript) ou `.js` (JavaScript), dependendo do idioma que você está usando.
**nota**  
A ação substituirá *NPMTOKEN* as variáveis *NPMUSER* e pelo nome de usuário npm e pelo token de acesso que você especificou em **Segredos**.

1. Salve o arquivo `cdk.json`.

1. Execute mais uma vez a ação manualmente para ver se as alterações corrigem o erro. Para ter mais informações sobre como executar ações manualmente, consulte [Iniciar um fluxo de trabalho executado manualmente](workflows-manually-start.md).

## Por que vários fluxos de trabalho têm o mesmo nome?
<a name="troubleshooting-workflows-name"></a>



Os fluxos de trabalho são armazenados por ramificação, por repositório. Dois fluxos de trabalho diferentes podem ter o mesmo nome se existirem em ramificações diferentes. Na página Fluxos de trabalho, você pode diferenciar fluxos de trabalho com o mesmo nome observando o nome da ramificação. Para obter mais informações, consulte [Organizando seu trabalho de código-fonte com filiais na Amazon CodeCatalyst](source-branches.md).

![\[Ramificação de fluxo de trabalho\]](http://docs.aws.amazon.com/pt_br/codecatalyst/latest/userguide/images/flows/workflow-branch.png)


## Posso armazenar meus arquivos de definição de fluxo de trabalho em outra pasta?
<a name="troubleshooting-workflows-folder"></a>

Não, você deve armazenar todos os arquivos de definição de fluxo de trabalho na pasta `.codecatalyst/workflows` ou nas subpastas dessa pasta. Se você estiver usando um repositório mono com vários projetos lógicos, coloque todos os seus arquivos de definição de fluxo de trabalho na pasta `.codecatalyst/workflows` ou em uma de suas subpastas e, depois, use o campo **Arquivos alterados** (editor visual) ou a propriedade `FilesChanged` (editor YAML) dentro de um gatilho para acionar o fluxo de trabalho automaticamente em um caminho de projeto especificado. Para obter mais informações, consulte [Adição de gatilhos aos fluxos de trabalho](workflows-add-trigger-add.md) e [Exemplo: um gatilho com um envio, ramificações e arquivos](workflows-add-trigger-examples.md#workflows-add-trigger-examples-push-multi).

## Como adiciono ações em sequência ao meu fluxo de trabalho?
<a name="troubleshooting-workflows-visual"></a>

Por padrão, quando você adiciona uma ação ao seu fluxo de trabalho, ela não terá dependências e será executada paralelamente a outras ações.

Se quiser organizar as ações em sequência, defina uma dependência em outra ação configurando o campo `DependsOn`. Você também pode configurar uma ação para consumir artefatos ou variáveis que são saídas de outras ações. Para obter mais informações, consulte [Sequenciar ações](workflows-depends-on.md).

## Por que meu fluxo de trabalho é validado com sucesso, mas falha em runtime?
<a name="troubleshooting-workflows-validation"></a>

Se você validou seu fluxo de trabalho usando o botão `Validate`, mas ele falhou mesmo assim, pode haver uma limitação no validador.

Qualquer erro relacionado a um CodeCatalyst recurso, como segredos, ambientes ou frotas, na configuração do fluxo de trabalho não será registrado durante uma confirmação. Se alguma referência não válida for usada, o erro só será identificado quando um fluxo de trabalho for executado. Da mesma forma, se houver algum erro na configuração da ação, como falta de um campo obrigatório ou erros de digitação nos atributos da ação, eles serão identificados somente quando o fluxo de trabalho for executado. Para obter mais informações, consulte [Criação de um fluxo de trabalho](workflows-create-workflow.md).

## A descoberta automática não descobre nenhum relatório da minha ação
<a name="troubleshooting-reports-auto-discovery"></a>

**Problema:** configurei a descoberta automática para uma ação que executa testes, mas nenhum relatório é descoberto pelo CodeCatalyst.

**Possíveis correções:** isso pode ser causado por vários problemas. Tente uma ou mais das seguintes soluções:
+ Certifique-se de que a ferramenta usada para executar testes produza saídas em um dos formatos que CodeCatalyst compreende. Por exemplo, se você quiser permitir `pytest` CodeCatalyst a descoberta de relatórios de cobertura de teste e código, inclua os seguintes argumentos:

  ```
  --junitxml=test_results.xml --cov-report xml:test_coverage.xml
  ```

  Para obter mais informações, consulte [Tipos de relatório de qualidade](test-workflow-actions.md#test-reporting).
+ Certifique-se de que a extensão do arquivo para as saídas seja consistente com o formato escolhido. Por exemplo, ao configurar `pytest` para produzir resultados no formato `JUnitXML`, verifique se a extensão do arquivo é `.xml`. Para obter mais informações, consulte [Tipos de relatório de qualidade](test-workflow-actions.md#test-reporting).
+ Certifique-se de que `IncludePaths` esteja configurado para incluir todo o sistema de arquivos (`**/*`), a menos que você esteja excluindo determinadas pastas propositalmente. Da mesma forma, certifique-se de que `ExcludePaths` não exclua os diretórios onde você espera que seus relatórios estejam localizados.
+ Se você configurou manualmente um relatório para usar um arquivo de saída específico, ele será excluído da descoberta automática. Para obter mais informações, consulte [Exemplo de relatórios de qualidade YAML](test-config-action.md#test.success-criteria-example).
+ A descoberta automática pode não encontrar relatórios porque a ação falhou antes que qualquer saída fosse gerada. Por exemplo, a compilação pode ter falhado antes da execução de qualquer teste de unidade.

## Minha ação falha em relatórios descobertos automaticamente depois que eu configuro os critérios de sucesso
<a name="troubleshooting-success-auto-discovery"></a>

**Problema:** quando eu habilito a descoberta automática e configuro os critérios de sucesso, alguns dos relatórios não atendem aos critérios de sucesso e, como resultado, a ação falha.

**Possíveis correções:** para resolver isso, tente uma ou mais das seguintes soluções:
+ Modifique `IncludePaths` ou `ExcludePaths` para excluir relatórios nos quais você não está interessado.
+ Atualize os critérios de sucesso para permitir que todos os relatórios sejam aprovados. Por exemplo, se dois relatórios foram descobertos com um com cobertura de linha de 50% e outro de 70%, ajuste a cobertura mínima da linha para 50%. Para obter mais informações, consulte [Critérios de sucesso](test-best-practices.md#test.best-success-criteria).
+ Transforme o relatório de falha em um relatório configurado manualmente. Isso permite que você configure diferentes critérios de sucesso para esse relatório específico. Para obter mais informações, consulte [Configuração de critérios de sucesso para relatórios](test-config-action.md#test.success-criteria).

## A descoberta automática gera relatórios que eu não quero
<a name="troubleshooting-unwanted-auto-discovery"></a>

**Problema:** quando eu habilito a descoberta automática, ela gera relatórios que eu não quero. Por exemplo, CodeCatalyst gera relatórios de cobertura de código para arquivos incluídos nas dependências do meu aplicativo armazenadas em`node_modules`.

**Possíveis correções:** você pode ajustar a configuração de `ExcludePaths` para excluir arquivos indesejados. Por exemplo, para excluir `node_modules`, adicione `node_modules/**/*`. Para obter mais informações, consulte [Inclusão/exclusão de caminhos](test-best-practices.md#test.best-include-exclude).

## A descoberta automática gera diversos pequenos relatórios para uma única estrutura de teste
<a name="troubleshooting-reports-combined"></a>

**Problema:** quando uso determinadas estruturas de relatórios de cobertura de código e teste, percebi que a descoberta automática gera um grande número de relatórios. Por exemplo, ao usar o [plug-in Maven Surefire](https://maven.apache.org/surefire/maven-surefire-plugin/), a descoberta automática produz um relatório diferente para cada classe de teste. 

**Possíveis correções:** sua estrutura pode ser capaz de agregar saídas em um único arquivo. Por exemplo, se você estiver usando o plug-in Maven Surefire, use `npx junit-merge` para agregar os arquivos manualmente. A expressão completa pode ser semelhante a:

```
mvn test; cd test-package-path/surefire-reports && npx junit-merge -d ./ && rm *Test.xml
```

## Os fluxos de trabalho listados abaixo CI/CD não correspondem aos do repositório de origem
<a name="troubleshooting-workflow-source"></a>

**Problema:** os fluxos de trabalho exibidos na página **CI/CD**, **Fluxos de trabalho** não correspondem aos da pasta `~/.codecatalyst/workflows/` em seu [repositório de origem](source.md). Você poderá ver as seguintes incompatibilidades:
+ Um fluxo de trabalho é exibido na página **Fluxos de trabalho**, mas um arquivo de definição de fluxo de trabalho correspondente não existe no seu repositório de origem.
+ Existe um arquivo de definição de fluxo de trabalho no seu repositório de origem, mas um fluxo de trabalho correspondente não é exibido na página **Fluxos de trabalho**.
+ Existe um fluxo de trabalho no repositório de origem e na página **Fluxos de trabalho**, mas eles são diferentes.

Esse problema pode ocorrer se a página **Fluxos de trabalho** não estiver atualizada ou se uma cota de fluxo de trabalho tiver excedido.

**Correções possíveis:**
+ Espere. Normalmente, você precisa esperar dois ou três segundos após uma confirmação na origem antes de ver a alteração na página **Fluxos de trabalho**.
+ Se você excedeu uma cota de fluxo de trabalho, siga um destes procedimentos:
**nota**  
Para determinar se uma cota de fluxo de trabalho foi excedida, revise [Cotas para fluxos de trabalho em CodeCatalyst](workflows-quotas.md) e compare as cotas documentadas com os fluxos de trabalho em seu repositório de origem ou na página **Fluxos de trabalho**. Não há mensagem de erro que indique que uma cota foi excedida, então você terá que investigar por conta própria.
  + Se você excedeu a cota de **Número máximo de fluxos de trabalho por espaço**, exclua alguns fluxos de trabalho e, depois, realize um teste de confirmação no arquivo de definição do fluxo de trabalho. Um exemplo de confirmação de teste pode ser adicionado em um espaço no arquivo.
  + Se você excedeu a cota de **Tamanho máximo do arquivo de definição de fluxo de trabalho**, altere o arquivo de definição de fluxo de trabalho para reduzir seu tamanho.
  + Se você excedeu a cota de **Número máximo de arquivos de fluxo de trabalho processados ​​em um único evento de origem**, realize várias confirmações de teste. Modifique menos do que o número máximo de fluxos de trabalho em cada confirmação.

## Não consigo criar ou atualizar fluxos de trabalho
<a name="troubleshooting-workflows-branchrules"></a>

**Problema:** quero criar ou atualizar um fluxo de trabalho, mas vejo um erro quando tento confirmar a alteração.

**Possíveis correções:** dependendo do seu perfil no projeto ou no espaço, talvez você não tenha permissões para enviar o código para os repositórios de origem do projeto. Os arquivos YAML para fluxos de trabalho são armazenados em repositórios. Para obter mais informações, consulte [Arquivos de definição de fluxo de trabalho](workflows-concepts.md#workflows-concepts-workflows-def). Os perfis de **Administrador do espaço**, **Administrador do projeto** e **Colaborador** têm permissão para confirmar e enviar o código aos repositórios do projeto.

Se você tiver o perfil de **Colaborador**, mas não consegue criar ou confirmar alterações no fluxo de trabalho YAML em uma ramificação específica, pode haver uma regra de ramificação configurada para essa ramificação que impede que usuários com esse perfil enviem código para essa ramificação específica. Tente criar um fluxo de trabalho ou confirmar suas alterações em uma ramificação diferente. Para obter mais informações, consulte [Gerenciar as ações permitidas para uma ramificação com regras de ramificação](source-branches-branch-rules.md).

# Solução de problemas
<a name="troubleshooting-issues"></a>

As informações a seguir podem ajudá-lo a solucionar problemas comuns com problemas em CodeCatalyst.

**Topics**
+ [Não consigo selecionar um destinatário para o meu problema](#troubleshooting-issues-assignees)

## Não consigo selecionar um destinatário para o meu problema
<a name="troubleshooting-issues-assignees"></a>

**Problema:** ao criar um problema, a lista de destinatários fica vazia.

**Possíveis correções:** a lista de responsáveis está diretamente vinculada aos CodeCatalyst usuários listados como membros do projeto. Para verificar se o acesso ao perfil do usuário está funcionando corretamente, selecione o ícone do perfil e **Perfil do usuário**. Se as informações do perfil do usuário não forem preenchidas, confira se há incidentes no relatório de integridade. Se ele for preenchido, registre um tíquete de serviço.

# Solução de problemas com a pesquisa em CodeCatalyst
<a name="troubleshooting-search"></a>

Consulte as seções a seguir para solucionar problemas relacionados à pesquisa. CodeCatalyst Para obter mais informações sobre fluxos de trabalho, consulte [Pesquisa do código, problemas, projetos e usuários no CodeCatalystPesquisa do código, problemas, projetos e usuários](search.md).

**Topics**
+ [Não consigo encontrar um usuário no meu projeto](#troubleshooting-search-users)
+ [Não vejo o que estou procurando no meu projeto ou espaço](#troubleshooting-missing-results)
+ [O número de resultados de pesquisa continua mudando quando eu navego pelas páginas](#troubleshooting-search-results)
+ [Minha consulta de pesquisa não está sendo concluída](#troubleshooting-requests-limits)

## Não consigo encontrar um usuário no meu projeto
<a name="troubleshooting-search-users"></a>

**Problema:** quando tento visualizar os detalhes de um usuário, não vejo suas informações no projeto.

**Possíveis correções:** no momento, a pesquisa não é compatível com a pesquisa de usuários em um projeto. Para pesquisar usuários com acesso ao seu espaço, alterne para **Este espaço** em QuickSearch ou remova quaisquer filtros de projeto que você possa ter especificado usando a linguagem de consulta avançada.

## Não vejo o que estou procurando no meu projeto ou espaço
<a name="troubleshooting-missing-results"></a>

**Problema:** os resultados não aparecem quando tento pesquisar informações específicas.

**Possíveis correções:** é provável que as atualizações de conteúdo levem alguns segundos para serem atualizadas nos resultados da pesquisa. Atualizações grandes podem levar alguns minutos.

Para recursos que não foram atualizados recentemente, talvez seja necessário refinar sua pesquisa. Você pode refinar adicionando mais palavras-chave ou usando a linguagem de consulta avançada. Para ter mais informações sobre como refinar suas consultas, consulte [Refinamento da sua consulta de pesquisa](search.md#search-query-language-examples).

## O número de resultados de pesquisa continua mudando quando eu navego pelas páginas
<a name="troubleshooting-search-results"></a>

**Problema:** o número de resultados da pesquisa parece mudar quando eu vou para a próxima página, então não está claro quantos resultados totais existem.

**Possíveis correções:** ao navegar pelas páginas dos resultados da pesquisa, você pode ver uma alteração no número de resultados de pesquisa que correspondem à sua consulta. O número de resultados pode ser atualizado para refletir um número mais preciso de correspondências descobertas conforme você navega pelas páginas.

Ao navegar pelos resultados, você pode ver a seguinte mensagem: **Nenhum resultado para “teste”**. Você receberá a mensagem caso não tenha acesso aos demais resultados.

## Minha consulta de pesquisa não está sendo concluída
<a name="troubleshooting-requests-limits"></a>

**Problema:** os resultados da minha consulta de pesquisa não estão aparecendo e parece que estão demorando muito.

**Possíveis correções:** sua pesquisa pode não ser concluída quando há muitas pesquisas sendo feitas ao mesmo tempo no espaço, seja de forma programática ou devido à alta atividade da equipe. Se você estiver executando pesquisas programáticas, pause-as ou diminua-as. Caso contrário, tente novamente em alguns segundos.

# Solução de problemas com extensões
<a name="troubleshooting-extensions"></a>

Consulte as seções a seguir para solucionar problemas relacionados às extensões em CodeCatalyst. Para obter mais informações sobre extensões, consulte [Adicione funcionalidade a projetos com extensões no CodeCatalystAdicionar funcionalidade a projetos com extensões](extensions.md).

**Topics**
+ [Não consigo ver as alterações em um repositório de terceiros vinculado nem pesquisar os resultados dessas alterações](#troubleshooting-detect-3p-changes)

## Não consigo ver as alterações em um repositório de terceiros vinculado nem pesquisar os resultados dessas alterações
<a name="troubleshooting-detect-3p-changes"></a>

**Problema:** as alterações no meu repositório de terceiros não estão aparecendo no. CodeCatalyst

**Possíveis correções:** CodeCatalyst atualmente não suporta a detecção de alterações na ramificação padrão para repositórios vinculados. Para alterar a ramificação padrão de um repositório vinculado, você deve primeiro desvinculá-la CodeCatalyst, alterar a ramificação padrão e depois vinculá-la novamente. Para obter mais informações, consulte [Vinculando GitHub repositórios, repositórios do Bitbucket, repositórios de GitLab projetos e projetos do Jira no CodeCatalyst](extensions-link.md).

# Solução de problemas de contas associadas ao seu espaço
<a name="troubleshooting-connections"></a>

Em CodeCatalyst, você pode adicionar um Conta da AWS ao seu espaço para conceder permissões aos recursos e para fins de cobrança. As informações a seguir podem ajudá-lo a solucionar problemas comuns com contas associadas no CodeCatalyst.

**Topics**
+ [Minha solicitação de Conta da AWS conexão recebe um erro de token inválido](#troubleshooting-connection-token)
+ [O fluxo de trabalho do meu CodeCatalyst projeto da Amazon falha com um erro na conta configurada, no ambiente ou na função do IAM](#connections-troubleshoot-workflow)
+ [Preciso de uma conta, perfil e ambiente associados para criar um projeto](#connections-troubleshoot-environment)
+ [Não consigo acessar a página do Amazon CodeCatalyst Spaces no Console de gerenciamento da AWS](#connections-troubleshoot-console)
+ [Quero uma conta diferente como minha conta de faturamento](#connections-troubleshoot-billing)
+ [O fluxo de trabalho do meu projeto falha com um erro de nome de conexão](#connections-troubleshoot-restriction)

## Minha solicitação de Conta da AWS conexão recebe um erro de token inválido
<a name="troubleshooting-connection-token"></a>

**Problema:** ao criar uma solicitação de conexão com um token de conexão, a página não aceita o token e mostra um erro informando que o token não é válido.

**Possíveis correções:** forneça o ID da conta que você deseja adicionar ao seu espaço. Você deve ter permissões administrativas para sua conta Conta da AWS ou ser capaz de trabalhar com seu administrador para adicionar a conta.

Quando você optar por verificar a conta, uma nova janela do navegador será aberta no Console de gerenciamento da AWS. É necessário que a mesma conta esteja logada no lado do console. Tente novamente depois de verificar o seguinte:
+ Você está logado no Console de gerenciamento da AWS com o mesmo Conta da AWS que deseja adicionar ao seu espaço.
+ Você está logado no Console de gerenciamento da AWS com a região definida como a região correta para o seu espaço.
+ Se você chegou da página de faturamento e deseja adicionar a Conta da AWS como uma conta de faturamento especificada ao seu espaço, verifique se a conta não atingiu a cota como conta de faturamento para outro espaço ou espaços.

## O fluxo de trabalho do meu CodeCatalyst projeto da Amazon falha com um erro na conta configurada, no ambiente ou na função do IAM
<a name="connections-troubleshoot-workflow"></a>

**Problema:** quando o fluxo de trabalho é executado e não encontra uma conta configurada ou perfis do IAM associados ao seu espaço, você deve preencher os campos de perfil, conexão e ambiente manualmente no YAML do fluxo de trabalho. Visualize a ação do fluxo de trabalho com falha e observe se as mensagens de erro são as seguintes: 
+ O perfil não está disponível para uso com a conexão associada ao ambiente.
+ A ação não foi bem-sucedida. Status: FALHA; O valor fornecido para a conexão da conta ou do ambiente não é válido. Verifique se a conexão está associada ao seu espaço e se o ambiente está associado ao seu projeto.
+ A ação não foi bem-sucedida. Status: FALHA; O valor fornecido para o perfil do IAM não é válido. Verifique se o nome existe, se a função do IAM foi adicionada à conexão da sua conta e se a conexão já está associada ao seu CodeCatalyst espaço na Amazon

**Possíveis correções:** verifique se os campos YAML do fluxo de trabalho têm valores precisos para [Ambiente](build-action-ref.md#build.environment), [Conexões](build-action-ref.md#build.environment.connections) e [Perfil](build-action-ref.md#build.environment.connections.role). As ações do CodeCatalyst fluxo de trabalho que exigem um ambiente são ações de criação ou implantação que executam AWS recursos ou geram pilhas AWS de recursos.

Selecione o bloco de ação do fluxo de trabalho com falha e **Visual**. Escolha a guia **Configuração**. Se os campos **Ambiente**, **Nome da conexão** e **Nome do perfil** não estiverem preenchidos, você precisará atualizar manualmente o fluxo de trabalho. Use as etapas a seguir para editar seu YAML de fluxo de trabalho:
+ Expanda o diretório `/.codecatalyst` e, depois, expanda o diretório `/workflows`. Abra o arquivo YAML do fluxo de trabalho. Certifique-se de que os perfis do IAM e as informações da conta estejam especificadas no YAML configurado para seu fluxo de trabalho. Exemplo: 

  ```
  Actions:
    cdk_bootstrap:
      Identifier: action-@v1
      Inputs:
        Sources:
          - WorkflowSource
      Environment:
        Name: Staging
        Connections:
          - Name: account-connection
            Role: build-role
  ```

  As propriedades **Environment, Connection e Role** são necessárias para executar ações CodeCatalyst de criação e implantação de fluxo de trabalho com AWS recursos. Para ver um exemplo, consulte os parâmetros YAML de referência da ação de CodeCatalyst construção para [Ambiente](build-action-ref.md#build.environment), [Conexões](build-action-ref.md#build.environment.connections) e [Função](build-action-ref.md#build.environment.connections.role).
+ Certifique-se de que seu espaço tenha uma conta adicionada a ele e de que a conta tenha o perfil ou perfis do IAM apropriados adicionados à conta. Você pode ajustar ou adicionar contas se tiver o perfil de **administrador do espaço**. Para obter mais informações, consulte [Permitindo acesso a AWS recursos com conexão Contas da AWS](ipa-connect-account.md).

## Preciso de uma conta, perfil e ambiente associados para criar um projeto
<a name="connections-troubleshoot-environment"></a>

**Problema:** nas opções de criação do projeto, meu projeto não tem uma conta adicional disponível no meu espaço ou eu preciso adicionar outra conta ao meu espaço para uso do meu projeto.

**Possíveis correções:** Para o seu espaço, você pode adicionar Contas da AWS autorizações para adicioná-las ao seu projeto se tiver a função de **administrador do Space**. Você também deve ter uma Conta da AWS com permissões administrativas ou que pode trabalhar com seu administrador da AWS .

Para garantir que uma conta e um perfil estejam disponíveis na tela de criação do projeto, primeiro adicione a conta e os perfis. Para obter mais informações, consulte [Permitindo acesso a AWS recursos com conexão Contas da AWS](ipa-connect-account.md).

Você tem a opção de escolher criar um perfil de serviço com uma política de perfil chamada política de perfil de **CodeCatalystWorkflowDevelopmentRole-*spaceName***. O perfil terá um nome `CodeCatalystWorkflowDevelopmentRole-spaceName` com um identificador exclusivo anexado. Para ter mais informações sobre o perfil e a política de perfis, consulte [Noções básicas sobre o perfil de serviço **CodeCatalystWorkflowDevelopmentRole-*spaceName***](ipa-iam-roles.md#ipa-iam-roles-service-role). Para as etapas necessárias para criar o perfil, consulte [Criar o perfil **CodeCatalystWorkflowDevelopmentRole-*spaceName*** para a conta e o espaço](ipa-iam-roles.md#ipa-iam-roles-service-create). A função é adicionada à sua conta e está disponível nas páginas de criação do projeto em CodeCatalyst.

## Não consigo acessar a página do Amazon CodeCatalyst Spaces no Console de gerenciamento da AWS
<a name="connections-troubleshoot-console"></a>

**Problema:** Quando tento acessar a CodeCatalyst página da Amazon no Console de gerenciamento da AWS para adicionar uma conta ao meu CodeCatalyst espaço ou adicionar funções a uma conta em AWS, recebo um erro de permissão.

**Correções possíveis:**

Para o seu espaço, você pode adicionar Contas da AWS autorizações para adicioná-las ao seu projeto se tiver a função de **administrador do espaço**. Você também deve ter uma Conta da AWS com permissões administrativas ou que pode trabalhar com seu administrador da AWS . Primeiro, você deve se certificar de que está conectado Console de gerenciamento da AWS com a mesma conta que deseja gerenciar. Depois de fazer login no Console de gerenciamento da AWS, você pode abrir o console e tentar novamente.

Abra a CodeCatalyst página da Amazon Console de gerenciamento da AWS em [https://us-west-2.console.aws.amazon.com/codecatalyst/casa? região = us-west-2\$1/](https://us-west-2.console.aws.amazon.com/codecatalyst/home?region=us-west-2#/).

## Quero uma conta diferente como minha conta de faturamento
<a name="connections-troubleshoot-billing"></a>

**Problema:** Ao configurar meu CodeCatalyst login, concluí várias etapas para configurar meu espaço e associar um autorizado Conta da AWS. Agora, quero autorizar uma conta diferente para faturamento.

**Possíveis correções:** para seu espaço, você pode autorizar contas de faturamento se tiver a função de **administrador do espaço**. Você também deve ter um Conta da AWS local onde tenha permissões administrativas ou possa trabalhar com seu AWS administrador.

Para obter mais informações, consulte [Gerenciando o faturamento](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-billing.html) no Amazon CodeCatalyst Administrator Guide.

## O fluxo de trabalho do meu projeto falha com um erro de nome de conexão
<a name="connections-troubleshoot-restriction"></a>

**Problema:** ao criar um projeto e depois executar o fluxo de trabalho do projeto, o fluxo de trabalho falha e mostra um erro de que o nome da conexão não é válido, da seguinte forma:

Falha em <action\$1name>: o nome da conexão não é válido.

**Possíveis correções:** forneça o ID da conta que você deseja adicionar ao seu espaço e certifique-se de que a conta não esteja habilitada para conexões de contas restritas ao projeto. Se a conta estiver habilitada para conexões de conta restritas ao projeto, talvez seja necessário atualizar a conexão da conta habilitando o acesso ao novo projeto. Para ter mais informações, consulte [Configuração de conexões de contas restritas ao projeto](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-accounts.html#managing-accounts-restriction).

# Solução de problemas entre o Amazon CodeCatalyst e os SDKs da AWS ou AWS CLI
<a name="troubleshooting-cli-sdk"></a>

As informações a seguir podem ajudar você a solucionar problemas comuns ao trabalhar com o CodeCatalyst e os SDKs de AWS CLI ou da AWS.

**Topics**
+ [Eu recebo uma mensagem de erro quando entro em **aws codecatalyst** em uma linha de comando ou terminal dizendo que é uma escolha inválida](#cli-sdk-troubleshoot-no-commands)
+ [Eu recebo um erro de credenciais quando executo comandos **aws codecatalyst**](#cli-sdk-troubleshoot-profile)

## Eu recebo uma mensagem de erro quando entro em **aws codecatalyst** em uma linha de comando ou terminal dizendo que é uma escolha inválida
<a name="cli-sdk-troubleshoot-no-commands"></a>

**Problema:** quando tento usar o AWS CLI com o CodeCatalyst, um ou mais dos comandos **aws codecatalyst** não são reconhecidos como válidos.

**Solução:** a causa mais comum desse problema é que você está usando uma versão do AWS CLI que não contém as atualizações mais recentes dos últimos serviços e comandos. Atualize a instalação do AWS CLI e tente de novo. Para obter mais informações, consulte [Configurando para usar o AWS CLI com CodeCatalyst](set-up-cli.md).

## Eu recebo um erro de credenciais quando executo comandos **aws codecatalyst**
<a name="cli-sdk-troubleshoot-profile"></a>

**Problema:** quando tento usar o AWS CLI com o CodeCatalyst, recebo uma mensagem informando `You can configure credentials by running "aws configure".` ou `Unable to locate authorization token`.

**Solução:** você deve configurar um perfil do AWS CLI para trabalhar com os comandos do CodeCatalyst. Para obter mais informações, consulte [Configurando para usar o AWS CLI com CodeCatalyst](set-up-cli.md).