

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
<a name="devenvironments-troubleshooting"></a>

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
<a name="troubleshooting-devenvironments-create"></a>

**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
<a name="troubleshooting-devenvironments-branchrules"></a>

**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
<a name="troubleshooting-devenvironments-resume"></a>

**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
<a name="troubleshooting-devenvironments-connection"></a>

**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
<a name="troubleshooting-devenvironments-vpc"></a>

**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
<a name="troubleshooting-devenvironments-projects"></a>

**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
<a name="troubleshooting-devenvironments-connect-ssh"></a>

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=<space-name>=<project-name>=<dev-environment-id>
```

## No puedo conectarme a mi entorno de desarrollo a través de SSH porque falta mi configuración de SSH local
<a name="troubleshooting-devenvironments-projects-ssh-config"></a>

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`
<a name="troubleshooting-devenvironments-config-profile"></a>

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
<a name="troubleshoot-create-dev-env-idprovider"></a>

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