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
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
**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
**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
**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
**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
**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á
**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
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===
```
## Não consigo me conectar ao Ambiente de Desenvolvimento via SSH porque minha configuração SSH local está ausente
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
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
**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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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:
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.