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