

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

# 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*.