Amazon ya no CodeCatalyst está abierto a nuevos clientes. Los clientes existentes pueden seguir utilizando el servicio con normalidad. Para obtener más información, consulte [Cómo migrar desde CodeCatalyst](migration.md).
Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Solución de problemas con los entornos de desarrollo
Consulte las siguientes secciones para solucionar problemas relacionados con los entornos de desarrollo. Para obtener más información sobre los entornos de desarrollo, consulte [Escribe y modifica código con entornos de desarrollo en CodeCatalystCreación y modificación de código con entornos de desarrollo](devenvironment.md).
**Topics**
+ [La creación de mi entorno de desarrollo no se ha realizado correctamente debido a un problema con las cuotas](#troubleshooting-devenvironments-create)
+ [No puedo incorporar los cambios de mi entorno de desarrollo en una ramificación específica de un repositorio](#troubleshooting-devenvironments-branchrules)
+ [Mi entorno de desarrollo no se reanuda](#troubleshooting-devenvironments-resume)
+ [Mi entorno de desarrollo se desconecta](#troubleshooting-devenvironments-connection)
+ [Se produjo un error en mi entorno de desarrollo conectado a una VPC](#troubleshooting-devenvironments-vpc)
+ [No encuentro el directorio en el que está mi proyecto](#troubleshooting-devenvironments-projects)
+ [No puedo conectarme a mi entorno de desarrollo a través de SSH](#troubleshooting-devenvironments-connect-ssh)
+ [No puedo conectarme a mi entorno de desarrollo a través de SSH porque falta mi configuración de SSH local](#troubleshooting-devenvironments-projects-ssh-config)
+ [No puedo conectarme a mi entorno de desarrollo a través de SSH porque tengo problemas con mi perfil AWS Config `codecatalyst`](#troubleshooting-devenvironments-config-profile)
+ [No puedo crear un entorno de desarrollo si he iniciado sesión CodeCatalyst con una cuenta de inicio de sesión único](#troubleshoot-create-dev-env-idprovider)
+ [Solución de problemas con los IDE](devenvironments-troubleshooting-ides.md)
+ [Solución de problemas con los devfiles](devenvironments-devenvironments-devfile.md)
## La creación de mi entorno de desarrollo no se ha realizado correctamente debido a un problema con las cuotas
**Problema:** quiero crear un entorno de desarrollo en él CodeCatalyst, pero aparece un error. En la consola, veo un mensaje en la página Entornos de desarrollo que indica que he alcanzado el límite de almacenamiento del espacio.
**Soluciones posibles:** en función de su rol en el proyecto o espacio, puede eliminar uno o varios de sus propios entornos de desarrollo o, si tiene el rol de administrador del espacio, puede eliminar los entornos de desarrollo no utilizados creados por otros usuarios. También puede decidir cambiar el nivel de facturación por uno que incluya más espacio de almacenamiento.
+ Para ver los límites de almacenamiento, consulta la pestaña **Facturación** del CodeCatalyst espacio de Amazon para comprobar si las cuotas de **uso** han alcanzado el máximo permitido. Si las cuotas han alcanzado el máximo, póngase en contacto con alguien que tenga el rol de administrador del espacio para eliminar los entornos de desarrollo innecesarios o para que considere si debería cambiar el nivel de facturación.
+ Para eliminar todos los entornos de desarrollo que haya creado y que ya no necesite, consulte [Eliminación de un entorno de desarrollo](devenvironment-delete.md).
Si el problema persiste y aparece un error en el IDE, compruebe que tiene un CodeCatalyst rol que le permita crear un entorno de desarrollo. El rol **Administrador del espacio**, el rol **Administrador del proyecto** y el rol **Colaborador** tienen permiso para crear entornos de desarrollo. Para obtener más información, consulte [Concesión de acceso en los roles de usuario](ipa-roles.md).
## No puedo incorporar los cambios de mi entorno de desarrollo en una ramificación específica de un repositorio
**Problema:** quiero confirmar e incorporar los cambios de código de mi entorno de desarrollo en una ramificación de un repositorio de código fuente, pero aparece un error.
**Soluciones posibles:** en función de su rol en el proyecto o el espacio, es posible que no tenga permisos para incorporar código en los repositorios de código fuente del proyecto. El rol **Administrador del espacio**, el rol **Administrador del proyecto** y el rol **Colaborador** tienen permiso para incorporar código en los repositorios del proyecto.
Si tiene el rol **Colaborador** pero no puede incorporar código en una ramificación específica, es posible que haya una regla de ramificación configurada para esa ramificación específica que impida a los usuarios con ese rol incorporar código en esa ramificación en particular. Intente incorporar los cambios en una ramificación diferente o crear una ramificación y, a continuación, incorporar el código en esa ramificación. Para obtener más información, consulte [Administración de las acciones permitidas para una ramificación con reglas de ramificación](source-branches-branch-rules.md).
## Mi entorno de desarrollo no se reanuda
**Problema:** mi entorno de desarrollo no se reanudó después de detenerlo.
**Posibles soluciones:** para solucionar el problema, consulta la pestaña **Facturación** del CodeCatalyst espacio de Amazon para comprobar si las cuotas de **uso** han alcanzado los límites máximos. Si las cuotas han alcanzado el límite máximo, póngase en contacto con el administrador del espacio para aumentar el nivel de facturación.
## Mi entorno de desarrollo se desconecta
**Problema:** mi entorno de desarrollo se desconectó mientras lo estaba usando.
**Soluciones posibles:** para solucionar el problema, compruebe su conexión a Internet. Si no está conectado a Internet, conéctese y reanude el trabajo en su entorno de desarrollo.
## Se produjo un error en mi entorno de desarrollo conectado a una VPC
**Problema:** he asociado una conexión de VPC a mi entorno de desarrollo y se producen errores.
**Soluciones posibles:** Docker utiliza un dispositivo de capa de enlace llamado red de puente que permite que los contenedores conectados a la misma red de puente se comuniquen. El puente predeterminado suele utilizar la subred `172.17.0.0/16` para las redes de contenedores. Si la subred de VPC para la instancia del entorno utiliza el mismo rango de direcciones que Docker, es posible que se produzca un conflicto de dirección IP. Para resolver un conflicto de direcciones IP provocado por Amazon VPC y Docker usar el mismo bloque de direcciones IPv4 CIDR, configure un bloque CIDR diferente de. `172.17.0.0/16`
**nota**
No puede cambiar el intervalo de direcciones IP de una VPC o subred existente.
## No encuentro el directorio en el que está mi proyecto
**Problema**: no encuentro el directorio en el que está mi proyecto.
**Soluciones posibles:** para localizar su proyecto, cambie el directorio a `/projects`. Este es el directorio donde puede encontrar sus proyectos.
## No puedo conectarme a mi entorno de desarrollo a través de SSH
Para solucionar los problemas de conexión a su entorno de desarrollo a través de SSH, puede ejecutar el comando `ssh` con la opción `-vvv` para mostrar más información sobre cómo resolver el problema:
```
ssh -vvv codecatalyst-dev-env===
```
## No puedo conectarme a mi entorno de desarrollo a través de SSH porque falta mi configuración de SSH local
Si falta la configuración de SSH local (`~/.ssh/config`) o el contenido de la sección `Host codecatalyst-dev-env*` no está actualizado, no podrá conectarse a su entorno de desarrollo a través de SSH. Para solucionar este problema, elimine la sección `Host codecatalyst-dev-env*` y vuelve a ejecutar el primer comando desde el modal **Acceso SSH**. Para obtener más información, consulte [Conexión a un entorno de desarrollo con SSH](devenvironment-connect-ssh.md).
## No puedo conectarme a mi entorno de desarrollo a través de SSH porque tengo problemas con mi perfil AWS Config `codecatalyst`
Asegúrese de que su AWS Config (`~/.aws/config`) del `codecatalyst` perfil coincida con el que se describe en[Configuración para usar el AWS CLI con CodeCatalyst](set-up-cli.md). Si no es así, elimine el perfil de `codecatalyst` y vuelva a ejecutar el primer comando desde el modal **Acceso SSH**. Para obtener más información, consulte [Conexión a un entorno de desarrollo con SSH](devenvironment-connect-ssh.md).
## No puedo crear un entorno de desarrollo si he iniciado sesión CodeCatalyst con una cuenta de inicio de sesión único
**Problema:** cuando inicio sesión en la CodeCatalyst consola como usuario de SSO, recibo un error de excepción desconocido cuando elijo crear un entorno de desarrollo en el espacio. Cuando elijo crear un entorno de desarrollo y elegir el IDE al que acceder, por ejemplo AWS Cloud9, tengo problemas similares a los siguientes:
+ La **página Entornos** de desarrollo de la CodeCatalyst consola muestra el entorno de desarrollo en la lista con un `FAILED` estado.
+ Aparece un mensaje de error similar al siguiente:
**`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.`
**Posibles soluciones**:
Los entornos de desarrollo no están disponibles para los usuarios en los espacios en los que se use Active Directory como proveedor de identidad. Los administradores del espacio pueden usar un proveedor de identidad alternativo para acceder a los entornos de desarrollo, como IAM Identity Center. Para obtener más información sobre cómo planificar un espacio que admita la federación de identidades, [consulte Planear un espacio que admita la federación de identidades](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/setting-up-federation.html#setting-up-planning-federation) en la *Guía CodeCatalyst del administrador*.
# Solución de problemas con los IDE
Consulte las siguientes secciones para solucionar problemas relacionados con los IDE en CodeCatalyst. Para obtener más información sobre los IDE, consulte [Creación de un entorno de desarrollo en un IDE](devenvironment-create.md#devenvironment-using-ide).
**Topics**
+ [Tengo versiones de imágenes en tiempo de ejecución que no coinciden en AWS Cloud9](#troubleshooting-devenvironments-c9-runtime)
+ [No puedo acceder a mis archivos en `/projects/projects` en AWS Cloud9](#troubleshooting-devenvironments-c9-filesystem)
+ [No puedo iniciar mi entorno de desarrollo en AWS Cloud9 con un devfile personalizado](#troubleshooting-devenvironments-c9-image)
+ [Tengo problemas en AWS Cloud9](#troubleshooting-c9)
+ [En JetBrains, no puedo conectarme a mis entornos de desarrollo mediante CodeCatalyst](#troubleshooting-jetbrains-connect)
+ [No puedo instalar AWS Toolkit para mi IDE](#troubleshooting-ide-toolkit)
+ [En mi IDE, no puedo iniciar mis entornos de desarrollo](#troubleshooting-ide-launch)
## Tengo versiones de imágenes en tiempo de ejecución que no coinciden en AWS Cloud9
AWS Cloud9 está utilizando diferentes versiones del recurso de frontend y de la imagen en tiempo de ejecución del backend. El uso de versiones diferentes puede hacer que la extensión de Git y AWS Toolkit no funcionen correctamente. Para solucionar el problema, vaya al panel de control del entorno de desarrollo, detenga el entorno de desarrollo y vuelva a iniciarlo. Para solucionar el problema con las API, use la API `UpdateDevEnvironment` para actualizar el entorno en tiempo de ejecución. Para obtener más información, consulte [UpdateDevEnvironment](https://docs.aws.amazon.com/codecatalyst/latest/APIReference/API_UpdateDevEnvironment.html) en la *Referencia de la API de Amazon CodeCatalyst*.
## No puedo acceder a mis archivos en `/projects/projects` en AWS Cloud9
El editor de AWS Cloud9 no puede acceder a los archivos del directorio `/projects/projects`. Para solucionar el problema, utilice el terminal de AWS Cloud9 para acceder a sus archivos o moverlos a un directorio diferente.
## No puedo iniciar mi entorno de desarrollo en AWS Cloud9 con un devfile personalizado
Es posible que su imagen de devfile no sea compatible con AWS Cloud9. Para solucionar el problema, revise el devfile del repositorio y el entorno de desarrollo correspondiente y cree uno nuevo para continuar.
## Tengo problemas en AWS Cloud9
Para otros problemas, consulte la sección de solución de problemas de la [Guía del usuario de AWS Cloud9](https://docs.aws.amazon.com/cloud9/latest/user-guide/troubleshooting.html).
## En JetBrains, no puedo conectarme a mis entornos de desarrollo mediante CodeCatalyst
Para solucionar el problema, compruebe que solo tenga instalada la última versión de JetBrains. Si tiene varias versiones, desinstale las versiones anteriores y vuelva a registrar el controlador de protocolos cerrando el IDE y el navegador. A continuación, abra JetBrains y vuelva a registrar el controlador de protocolos.
## No puedo instalar AWS Toolkit para mi IDE
Para solucionar este problema para VS Code, instale AWS Toolkit for Visual Studio Code manualmente desde [GitHub](https://github.com/aws/aws-toolkit-vscode/releases).
Para solucionar este problema para JetBrains, instale AWS Toolkit for JetBrains manualmente desde [GitHub](https://github.com/aws/aws-toolkit-jetbrains/releases).
## En mi IDE, no puedo iniciar mis entornos de desarrollo
Para solucionar este problema para VS Code, compruebe que tenga instalada la última versión de VS Code y AWS Toolkit for Visual Studio Code. Si no tiene la última versión, actualice e inicie su entorno de desarrollo. Para obtener más información, consulte [Amazon CodeCatalyst for VS Code](https://docs.aws.amazon.com/toolkit-for-vscode/latest/userguide/codecatalyst-service.html).
Para solucionar este problema para JetBrains, compruebe que tenga instalada la última versión de JetBrains y AWS Toolkit for JetBrains. Si no tiene la última versión, actualice e inicie su entorno de desarrollo. Para obtener más información, consulte [Amazon CodeCatalyst for JetBrains](https://docs.aws.amazon.com/toolkit-for-jetbrains/latest/userguide/codecatalyst-overview.html).
# Solución de problemas con los devfiles
Consulta las siguientes secciones para solucionar problemas relacionados con los archivos de desarrollo en. CodeCatalyst Para obtener más información sobre los devfiles, consulte [Configuración de un devfile para un entorno de desarrollo](devenvironment-devfile.md).
**Topics**
+ [Mi entorno de desarrollo utiliza el devfile universal predeterminado, aunque he implementado una imagen personalizada en un devfile personalizado](#troubleshooting-devenvironments-custom-image)
+ [Mi proyecto no se compila en mi entorno de desarrollo con el devfile universal predeterminado](#troubleshooting-devenvironments-default-image)
+ [Quiero mover un devfile de repositorio para un entorno de desarrollo](#troubleshooting-devenvironments-devfile-moving)
+ [Tengo problemas para iniciar mi devfile](#troubleshooting-devenvironments-devfile-recovery)
+ [No estoy seguro de cómo comprobar el estado de mi devfile](#troubleshooting-devenvironments-devfile-status)
+ [Mi devfile no es compatible con las herramientas proporcionadas en la última imagen](#troubleshooting-devenvironments-devfile-version)
## Mi entorno de desarrollo utiliza el devfile universal predeterminado, aunque he implementado una imagen personalizada en un devfile personalizado
Si CodeCatalyst se producen errores al iniciar un entorno de desarrollo que utilice un archivo de desarrollo personalizado, el entorno de desarrollo utilizará de forma predeterminada el archivo de desarrollo universal predeterminado. Para solucionar el problema, puede comprobar el error exacto en los registros bajo `/aws/mde/logs/devfile.log`. También puede comprobar si la ejecución de `postStart` se ha realizado correctamente en sus registros: `/aws/mde/logs/devfileCommand.log`.
## Mi proyecto no se compila en mi entorno de desarrollo con el devfile universal predeterminado
Para solucionar el problema, compruebe que no está utilizando un devfile personalizado. Si no está utilizando un devfile personalizado, consulte el archivo `devfile.yaml` del repositorio de código fuente del proyecto para localizar y corregir cualquier error.
## Quiero mover un devfile de repositorio para un entorno de desarrollo
Puede mover el devfile predeterminado de `/projects/devfile.yaml` a su repositorio de código fuente. Para actualizar la ubicación del devfile, use el siguiente comando: `/aws/mde/mde start --location repository-name/devfile.yaml`.
## Tengo problemas para iniciar mi devfile
Si hay algún problema al iniciar el devfile, este pasará al modo de recuperación para que pueda seguir conectándose a su entorno y corregir el devfile. Mientras esté en modo de recuperación, al ejecutar `/aws/mde/mde status` no se incluirá la ubicación del devfile.
```
{
"status": "STABLE"
}
```
Puede comprobar el error en los registros bajo `/aws/mde/logs`, corregir el devfile e intentar volver a ejecutar `/aws/mde/mde start`.
## No estoy seguro de cómo comprobar el estado de mi devfile
Puede comprobar el estado de su devfile ejecutando `/aws/mde/mde status`. Después de ejecutar este comando es posible que vea lo siguiente:
+ `{"status": "STABLE", "location": "devfile.yaml" }`
Esto indica que el devfile es correcto.
+ `{"status": "STABLE" }`
Esto indica que el devfile no se ha podido iniciar y ha entrado en modo de recuperación.
Puede comprobar el error exacto en los registros bajo `/aws/mde/logs/devfile.log`.
También puede comprobar si la ejecución de `postStart` se ha realizado correctamente en sus registros: `/aws/mde/logs/devfileCommand.log`.
Para obtener más información, consulte [Especificación de imágenes de devfile universales para un entorno de desarrollo](devenvironment-universal-image.md).
## Mi devfile no es compatible con las herramientas proporcionadas en la última imagen
En su entorno de desarrollo, `devfile` o `devfile postStart` puede fallar si las herramientas `latest` no tienen las herramientas necesarias para un proyecto específico. Para solucionar el problema, haga lo siguiente:
1. Vaya a su devfile.
1. En el devfile, actualice a una versión de imagen granular en lugar de `latest`. Tendrá un aspecto similar al siguiente:
```
components:
- container:
image: public.ecr.aws/amazonlinux/universal-image:1.0
```
1. Cree un nuevo entorno de desarrollo con el devfile actualizado.