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.
# Escribe y modifica código con entornos de desarrollo en CodeCatalyst
Los entornos de desarrollo son entornos de desarrollo basados en la nube. En Amazon CodeCatalyst, utilizas Dev Environments para trabajar en el código almacenado en los repositorios de código fuente de tu proyecto. Al crear entornos de desarrollo, tiene varias opciones:
+ Cree un entorno de desarrollo específico para el proyecto CodeCatalyst para trabajar en el código con un entorno de desarrollo integrado (IDE) compatible.
+ Crear un entorno de desarrollo vacío para clonar el código desde un repositorio de código fuente y trabajar en él con un IDE compatible.
+ Crear un entorno de desarrollo en un IDE y clonar un repositorio de código fuente en el entorno de desarrollo.
Un *devfile* es un archivo de YAML estándar abierto que estandariza sus entornos de desarrollo. En otras palabras, este archivo codifica las herramientas de desarrollo necesarias para su entorno de desarrollo. Esto le permite configurar rápidamente un entorno de desarrollo, cambiar de proyecto y replicar la configuración del entorno de desarrollo entre los miembros del equipo. Los entornos de desarrollo minimizan el tiempo que dedica a crear y mantener un entorno de desarrollo local, ya que utilizan un devfile que configura todas las herramientas que necesita para codificar, probar y depurar un proyecto determinado.
**importante**
Los entornos de desarrollo pueden ejecutar scripts a través de archivos de desarrollo que tienen acceso a sus credenciales. CodeCatalyst Inspeccione el repositorio antes de abrir recursos que no sean de confianza.
Las herramientas del proyecto y las bibliotecas de aplicaciones incluidas en el entorno de desarrollo se definen mediante el devfile en el repositorio de código fuente de su proyecto. Si no tienes un devfile en tu repositorio de origen, aplica CodeCatalyst automáticamente un devfile predeterminado. Este devfile predeterminado incluye las herramientas para los marcos y lenguajes de programación más utilizados. Si tu proyecto se creó con un blueprint, se crea automáticamente un devfile con. CodeCatalyst Para obtener más información sobre el devfile, consulte [https://devfile.io](https://devfile.io).
Una vez creado el entorno de desarrollo, solo usted podrá acceder a él. En su entorno de desarrollo, puede ver el código del repositorio de código fuente y trabajar en él en un IDE compatible.
De forma predeterminada, los entornos de desarrollo se crean con un procesador de 2 núcleos, 4 GB de RAM y 16 GB de almacenamiento persistente. Si tiene permisos de administrador del espacio, puede cambiar el nivel de facturación del espacio para usar diferentes opciones de configuración del entorno de desarrollo y administrar los límites de computación y almacenamiento.
**Topics**
+ [Creación de un entorno de desarrollo](devenvironment-create.md)
+ [Detención de un entorno de desarrollo](devenvironment-stop.md)
+ [Reanudación de un entorno de desarrollo](devenvironment-resume.md)
+ [Edición de un entorno de desarrollo](devenvironment-edit.md)
+ [Eliminación de un entorno de desarrollo](devenvironment-delete.md)
+ [Conexión a un entorno de desarrollo con SSH](devenvironment-connect-ssh.md)
+ [Configuración de un devfile para un entorno de desarrollo](devenvironment-devfile.md)
+ [Asociación de una conexión de VPC a un entorno de desarrollo](devenvironment-using-vpc.md)
+ [Cuotas para entornos de desarrollo en CodeCatalyst](devenvironment-limits.md)
# Creación de un entorno de desarrollo
Puede crear un entorno de desarrollo de varias maneras:
+ Cree un entorno de desarrollo CodeCatalyst con un repositorio de CodeCatalyst código fuente o un repositorio de [código enlazado](source-repositories-link.md) desde las páginas de **descripción general**, **entornos de desarrollo** o **repositorios de código fuente**
+ Cree un entorno de desarrollo vacío CodeCatalyst que no esté conectado a un repositorio de origen desde la página de entornos de desarrollo
+ Cree un entorno de desarrollo en el IDE que desee y clone cualquier repositorio de código fuente en el entorno de desarrollo.
**importante**
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. Para obtener más información, consulte [No puedo crear un entorno de desarrollo si he iniciado sesión CodeCatalyst con una cuenta de inicio de sesión único](devenvironments-troubleshooting.md#troubleshoot-create-dev-env-idprovider).
Puede crear un entorno de desarrollo para cada ramificación de un repositorio. Un proyecto puede tener varios repositorios. Los entornos de desarrollo que crees solo se pueden gestionar con tu CodeCatalyst cuenta, pero puedes abrir el entorno de desarrollo y trabajar en él con cualquiera de los compatibles IDEs. Debe tener el AWS Toolkit instalado para poder utilizar entornos de desarrollo en su IDE. Para obtener más información, consulte [Entornos de desarrollo integrados compatibles](#devenvironment-supported-ide). De forma predeterminada, los entornos de desarrollo se crean con un procesador de 2 núcleos, 4 GB de RAM y 16 GB de almacenamiento persistente.
**nota**
Si ha creado un entorno de desarrollo asociado a un repositorio de código fuente, la columna **Recursos** siempre muestra la ramificación que especificó al crear este entorno de desarrollo. Esto se aplica incluso si crea otra ramificación, cambia a otra ramificación dentro del entorno de desarrollo o clona un repositorio adicional. Si ha creado un entorno de desarrollo vacío, la columna **Recursos** estará en blanco.
## Entornos de desarrollo integrados compatibles
Puede utilizar los entornos de desarrollo con los siguientes entornos de desarrollo integrados compatibles (IDEs):
+ [AWS Cloud9](https://docs.aws.amazon.com/cloud9/latest/user-guide/welcome.html)
+ [JetBrains IDEs](https://www.jetbrains.com/help)
+ [IntelliJ IDEA Ultimate](https://www.jetbrains.com/help/idea/getting-started.html)
+ [GoLand](https://www.jetbrains.com/help/go/getting-started.html)
+ [PyCharmProfesional](https://www.jetbrains.com/help/pycharm/getting-started.html)
+ [Visual Studio Code](https://code.visualstudio.com/docs)
## Crear un entorno de desarrollo en CodeCatalyst
Para empezar a trabajar con Dev Environment en CodeCatalyst, autentícate e inicia sesión con tu [AWS Builder ID](id-how-to-sign-in.md) o [SSO](sign-in-sso.md).
**Creación de un entorno de desarrollo desde una ramificación**
1. [Abre la CodeCatalyst consola en https://codecatalyst.aws/.](https://codecatalyst.aws/)
1. Vaya al proyecto donde quiera crear un entorno de desarrollo.
1. En el panel de navegación, lleve a cabo alguna de las siguientes acciones:
+ Seleccione **Descripción general** y vaya a la sección **Mis entornos de desarrollo**.
+ Seleccione **Código** y **Entornos de desarrollo**.
+ Seleccione **Código** y **Repositorios de código fuente** y elija el repositorio para el que quiera crear un entorno de desarrollo.
1. Seleccione **Crear entorno de desarrollo**.
1. Seleccione un IDE compatible en el menú desplegable. Para obtener más información, consulte [Entornos de desarrollo integrados compatibles](#devenvironment-supported-ide).
1. Seleccione **Clonar un repositorio**.
1. Realice una de las siguientes acciones:
1. Elija el repositorio que desea clonar, elija **Trabajar en la ramificación existente** y, a continuación, elija una ramificación del menú desplegable **Ramificación existente**.
**nota**
Si elige un repositorio de terceros, debe trabajar en una ramificación existente.
1. Elija el repositorio que desea clonar, elija **Trabajar en una nueva ramificación**, introduzca el nombre de la ramificación en el campo **Nombre de ramificación**, y elija una ramificación a partir de la cual crear la ramificación nueva en el menú desplegable **Crear ramificación desde**.
**nota**
Si crea un entorno de desarrollo desde la página **Repositorios de código fuente** o desde un repositorio de código fuente específico, no necesita elegir un repositorio. El entorno de desarrollo se creará a partir del repositorio de código fuente que haya elegido en la página **Repositorios de origen**.
1. (Opcional) En **Alias: opcional**, añada un alias para el entorno de desarrollo.
1. (Opcional) Elija el botón de edición **Configuración del entorno de desarrollo** para editar la configuración de computación, almacenamiento o tiempo de espera del entorno de desarrollo.
1. (Opcional) En **Amazon Virtual Private Cloud (Amazon VPC): opcional**, seleccione la conexión de VPC que quiera asociar a su entorno de desarrollo en el menú desplegable.
Si se establece una VPC predeterminada para su espacio, los entornos de desarrollo se ejecutarán conectados a esa VPC. Puede invalidar este comportamiento asociando una conexión de VPC diferente. Además, tenga en cuenta que los entornos de desarrollo conectados a una VPC no admiten AWS Toolkit.
Si la conexión de VPC que quieres usar no aparece en la lista, puede que se deba a que incluye una Cuenta de AWS conexión que no está permitida en tu proyecto. Para obtener más información, consulte [Configuración de conexiones de cuentas restringidas por proyectos](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-accounts-restriction.html) en la Guía * CodeCatalyst del administrador de Amazon*.
**nota**
Al crear un entorno de desarrollo con una conexión de VPC, se crea una nueva interfaz de red dentro de la VPC. CodeCatalyst interactúa con esta interfaz mediante el rol de VPC asociado. Además, asegúrese de que el bloque IPv4 CIDR **no** esté configurado para el rango de `172.16.0.0/12` direcciones IP.
1. Seleccione **Crear**. Mientras se crea el entorno de desarrollo, la columna de estado del entorno de desarrollo mostrará **Iniciando** y la columna de estado mostrará **Ejecutando** una vez se haya creado el entorno de desarrollo.
**Creación de un entorno de desarrollo vacío**
1. Abra la CodeCatalyst consola en [https://codecatalyst.aws/](https://codecatalyst.aws/).
1. Vaya al proyecto donde quiera crear un entorno de desarrollo.
1. En el panel de navegación, lleve a cabo alguna de las siguientes acciones:
+ Seleccione **Descripción general** y vaya a la sección **Mis entornos de desarrollo**.
+ Seleccione **Código** y **Entornos de desarrollo**.
1. Seleccione **Crear entorno de desarrollo**.
1. Seleccione un IDE compatible en el menú desplegable. Para obtener más información, consulte [Entornos de desarrollo integrados compatibles](#devenvironment-supported-ide).
1. Seleccione **Crear un entorno de desarrollo vacío**.
1. (Opcional) En **Alias: opcional**, añada un alias para el entorno de desarrollo.
1. (Opcional) Elija el botón de edición **Configuración del entorno de desarrollo** para editar la configuración de computación, almacenamiento o tiempo de espera del entorno de desarrollo.
1. (Opcional) En **Amazon Virtual Private Cloud (Amazon VPC): opcional**, seleccione la conexión de VPC que quiera asociar a su entorno de desarrollo en el menú desplegable.
Si se establece una VPC predeterminada para su espacio, los entornos de desarrollo se ejecutarán conectados a esa VPC. Puede invalidar este comportamiento asociando una conexión de VPC diferente. Además, tenga en cuenta que los entornos de desarrollo conectados a una VPC no admiten AWS Toolkit.
Si la conexión de VPC que quieres usar no aparece en la lista, puede que se deba a que incluye una Cuenta de AWS conexión que no está permitida en tu proyecto. Para obtener más información, consulte [Configuración de conexiones de cuentas restringidas por proyectos](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-accounts-restriction.html) en la Guía * CodeCatalyst del administrador de Amazon*.
**nota**
Al crear un entorno de desarrollo con una conexión de VPC, se crea una nueva interfaz de red dentro de la VPC. CodeCatalyst interactúa con esta interfaz mediante el rol de VPC asociado. Además, asegúrese de que el bloque IPv4 CIDR **no** esté configurado para el rango de `172.16.0.0/12` direcciones IP.
1. Seleccione **Crear**. Mientras se crea el entorno de desarrollo, la columna de estado del entorno de desarrollo mostrará **Iniciando** y la columna de estado mostrará **Ejecutando** una vez se haya creado el entorno de desarrollo.
**nota**
Crear y abrir un entorno de desarrollo por primera vez puede tardar entre uno y dos minutos.
**nota**
Una vez que se abra el entorno de desarrollo en el IDE, es posible que tenga que cambiar el directorio al repositorio de código fuente antes de confirmar e insertar los cambios en el código.
## Creación de un entorno de desarrollo en un IDE
Puede usar un entorno de desarrollo para trabajar con el código almacenado en los repositorios de código fuente de su proyecto. Los entornos de desarrollo aumentan la velocidad de desarrollo, ya que puede empezar a programar de forma inmediata en un entorno de desarrollo en la nube totalmente funcional y específico del proyecto con un entorno de desarrollo integrado (IDE) compatible.
Para obtener información sobre cómo trabajar CodeCatalyst desde un IDE, consulte la siguiente documentación.
+ [Amazon CodeCatalyst para JetBrains IDEs](https://docs.aws.amazon.com/toolkit-for-jetbrains/latest/userguide/codecatalyst-service.html)
+ [Amazon CodeCatalyst para VS Code](https://docs.aws.amazon.com/toolkit-for-vscode/latest/userguide/codecatalyst-service.html)
+ [Amazon CodeCatalyst para AWS Cloud9](https://docs.aws.amazon.com/cloud9/latest/user-guide/ide-toolkits-cloud9.html)
# Detención de un entorno de desarrollo
El directorio `/projects` de un entorno de desarrollo almacena los archivos que se extraen del repositorio de código fuente y el devfile que se utiliza para configurar el entorno de desarrollo. El directorio `/home`, que está vacío al crear el entorno de desarrollo, almacena los archivos que se crean mientras se utiliza el entorno de desarrollo. Todo lo que hay en los directorios `/projects` y `/home` de un entorno de desarrollo se almacena de forma permanente, por lo que puede dejar de trabajar en él si necesita cambiar a otro entorno de desarrollo, repositorio o proyecto.
**aviso**
No se agotará el tiempo de espera de un entorno de desarrollo si alguna instancia, incluidos los navegadores web y los servidores remotos IDEs, permanece conectada. Por lo tanto, asegúrese de cerrar todas las instancias conectadas para evitar incurrir en costes adicionales.
Un entorno de desarrollo se detiene automáticamente si permanece inactivo durante el tiempo seleccionado en los campos **Tiempo de espera** cuando se creó el entorno de desarrollo. Puede detener el entorno de desarrollo antes de que se quede inactivo. Si seleccionó **Sin tiempo de espera** al crear su entorno de desarrollo, el entorno de desarrollo no se detendrá automáticamente. En lugar de ello, se ejecutará de forma continua.
**aviso**
Si detiene un entorno de desarrollo asociado a una conexión de VPC eliminada, no se podrá reanudar.
**Detención de un entorno de desarrollo desde la página Entornos de desarrollo**
1. Abre la CodeCatalyst consola en [https://codecatalyst.aws/](https://codecatalyst.aws/).
1. Vaya al proyecto donde desea detener un entorno de desarrollo.
1. En el panel de navegación, seleccione **Código**.
1. Elija **Entornos de desarrollo**.
1. Elija el botón de opción del entorno de desarrollo que desee detener.
1. En el menú **Acciones**, elija **Detener**.
**nota**
El uso de computación se factura solo mientras el entorno de desarrollo está en ejecución, pero el uso del almacenamiento se factura durante todo el tiempo que el entorno de desarrollo esté en funcionamiento. Detenga su entorno de desarrollo cuando no esté en uso para detener la facturación de computación.
# Reanudación de un entorno de desarrollo
El directorio `/projects` de un entorno de desarrollo almacena los archivos que se extraen del repositorio de código fuente y el devfile que se utiliza para configurar el entorno de desarrollo. El directorio `/home`, que está vacío al crear el entorno de desarrollo, almacena los archivos que se crean mientras se utiliza el entorno de desarrollo. Todo lo que hay en los directorios `/projects` y `/home` de un entorno de desarrollo se almacena de forma permanente, por lo que puede dejar de trabajar en él si necesita cambiar a otro entorno de desarrollo, repositorio o proyecto y volver a trabajar en él más adelante.
Un entorno de desarrollo se detiene automáticamente si permanece inactivo durante el tiempo seleccionado en los campos **Tiempo de espera** cuando se creó el entorno de desarrollo. Debe cerrar la pestaña del AWS Cloud9 navegador para que el entorno de desarrollo esté inactivo.
**nota**
El entorno de desarrollo sigue disponible y en funcionamiento incluso si elimina la ramificación con la que lo creó. Si quiere volver a trabajar en un entorno de desarrollo en el que ha eliminado la ramificación, cree una ramificación nueva e incorpore los cambios en ella.
**Reanudación de un entorno de desarrollo desde la página de información general**
1. Abra la CodeCatalyst consola en [https://codecatalyst.aws/](https://codecatalyst.aws/).
1. Vaya al proyecto donde desea reanudar un entorno de desarrollo y acceda a la sección **Mis entornos de desarrollo**.
1. Seleccione **Reanudar en (IDE)**.
+ Para JetBrains IDEs, elija JetBrains Gateway-EAP cuando se le pida que **elija una aplicación para abrir** el enlace -gateway. JetBrains Elija **Abrir enlace** para confirmar cuando se le pida.
+ Para el IDE de VS Code, seleccione VS Code cuando se le pida que **elija una aplicación para abrir el enlace de VS Code**. Seleccione **Abrir enlace** para confirmar.
**Reanudación un entorno de desarrollo desde el repositorio de código fuente**
1. [Abra la consola en https://codecatalyst.aws/. CodeCatalyst ](https://codecatalyst.aws/)
1. Vaya al proyecto donde desea reanudar un entorno de desarrollo.
1. En el panel de navegación, seleccione **Código**.
1. Elija **Repositorios de código fuente**.
1. Elija el repositorio de código fuente que contenga el entorno de desarrollo que desea reanudar.
1. Elija el nombre de la ramificación para ver un menú desplegable de sus ramificaciones y, a continuación, elija su ramificación.
1. Elija **Reanudar entorno de desarrollo**.
+ Para JetBrains IDEs, elija **Abrir enlace** para confirmar cuando se le pregunte si desea **permitir que este sitio abra el enlace JetBrains -gateway con JetBrains Gateway?** .
+ Para el IDE de VS Code, elija **Abrir enlace** para confirmar cuando se le pregunte si desea **permitir que este sitio abra el enlace de VS Code con Visual Studio Code**.
**Reanudación de un entorno de desarrollo desde la página Entornos de desarrollo**
1. Abre la CodeCatalyst consola en [https://codecatalyst.aws/](https://codecatalyst.aws/).
1. Vaya al proyecto donde desea reanudar un entorno de desarrollo.
1. En el panel de navegación, seleccione **Código**.
1. Elija **Entornos de desarrollo**.
1. En la columna **IDE**, elija **Reanudar en (IDE)** para el entorno de desarrollo.
+ Para JetBrains IDEs, elija **Abrir enlace** para confirmar cuando se le pregunte si desea **permitir que este sitio abra el enlace JetBrains -gateway con JetBrains Gateway?** .
+ Para el IDE de VS Code, elija **Abrir enlace** para confirmar cuando se le pregunte si desea **permitir que este sitio abra el enlace de VS Code con Visual Studio Code**.
**nota**
La reanudación de un entorno de desarrollo puede tardar unos minutos.
# Edición de un entorno de desarrollo
Mientras su IDE está en ejecución, puede editar el entorno de desarrollo. Si edita la configuración de computación o de tiempo de espera de inactividad, el entorno de desarrollo se reiniciará después de guardar los cambios.
**Edición de un entorno de desarrollo**
1. Abre la CodeCatalyst consola en [https://codecatalyst.aws/](https://codecatalyst.aws/).
1. Vaya al proyecto donde desea editar un entorno de desarrollo.
1. En el panel de navegación, seleccione **Código**.
1. Elija **Entornos de desarrollo**.
1. Elija el entorno de desarrollo que desee editar.
1. Elija **Edit (Edición de)**.
1. Realice los cambios que desee en la configuración de computación o tiempo de espera de inactividad.
1. Seleccione **Save**.
# Eliminación de un entorno de desarrollo
Cuando haya terminado de trabajar en el contenido almacenado en su entorno de desarrollo, puede eliminar el entorno de desarrollo. Cree un nuevo entorno de desarrollo para trabajar en contenido nuevo. Si elimina el entorno de desarrollo, el contenido persistente se eliminará de forma permanente. Antes de eliminar un entorno de desarrollo, asegúrese de confirmar y enviar los cambios de código al repositorio de código fuente original del entorno de desarrollo. Una vez eliminado su entorno de desarrollo, se detendrá la facturación de computación y almacenamiento del entorno de desarrollo.
Después de eliminar el entorno de desarrollo, es posible que la cuota de almacenamiento tarde unos minutos en actualizarse. Si ha alcanzado la cuota de almacenamiento, no podrá crear un nuevo entorno de desarrollo durante este tiempo.
**importante**
La eliminación de un entorno de desarrollo no se puede deshacer. Después de eliminar un entorno de desarrollo, no puede recuperarlo.
**Eliminación de un entorno de desarrollo**
1. Abre la CodeCatalyst consola en [https://codecatalyst.aws/](https://codecatalyst.aws/).
1. Vaya al proyecto donde desea eliminar el entorno de desarrollo.
1. En el panel de navegación, seleccione **Código**.
1. Elija **Entornos de desarrollo**.
1. Elija el entorno de desarrollo que desee eliminar.
1. Elija **Eliminar**.
1. Introduzca **delete** para confirmar la eliminación del entorno de desarrollo.
1. Elija **Eliminar**.
**nota**
Antes de eliminar una conexión de VPC en su espacio, asegúrese de eliminar el entorno de desarrollo asociado a esa VPC.
Incluso si elimina un entorno de desarrollo, es posible que no elimine la interfaz de red de la VPC. Asegúrese de limpiar los recursos según sea necesario. Si se produce un error al eliminar un entorno de desarrollo conectado a una VPC, debe [desconectar](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-eni.html#detach_eni) la conexión obsoleta y [eliminarla](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-eni.html#delete_eni) después de confirmar que no se esté utilizando.
# Conexión a un entorno de desarrollo con SSH
Puede conectarse a su entorno de desarrollo mediante SSH para realizar acciones sin limitaciones, como el reenvío de puertos, la carga y descarga de archivos y el uso de otras. IDEs
**nota**
Si quiere seguir usando SSH durante un tiempo prolongado después de cerrar la pestaña o ventana del IDE, asegúrese de establecer un tiempo de espera alto para su entorno de desarrollo para que no se detenga debido a la inactividad del IDE.
**Requisitos previos**
+ Necesita uno de los sistemas operativos siguientes:
+ Windows 10 o posterior y OpenSSH habilitado
+ macOS y Bash versión 3 o superior
+ Linux con `yum`, administradores de paquetes de `dpkg` o `rpm` y Bash versión 3 o superior
+ También necesitas la AWS CLI versión 2.9.4 o superior.
**Conexión a un entorno de desarrollo con SSH**
1. Abre la CodeCatalyst consola en [https://codecatalyst.aws/](https://codecatalyst.aws/).
1. Vaya al proyecto donde desea conectarse a un entorno de desarrollo mediante SSH.
1. En el panel de navegación, seleccione **Código**.
1. Elija **Entornos de desarrollo**.
1. Elija el entorno de desarrollo en ejecución al que desee conectarse mediante SSH.
1. Seleccione **Conectarse a través de SSH**, elija el sistema operativo que desee y haga lo siguiente:
+ Si aún no lo ha hecho, pegue y ejecute el primer comando en el terminal que haya especificado. El comando descarga un script y ejecuta las siguientes modificaciones en su entorno local para que pueda conectarte al entorno de desarrollo mediante SSH:
+ Instala el [complemento Session Manager para AWS CLI](https://docs.aws.amazon.com/systems-manager/latest/userguide/session-manager-working-with-install-plugin.html)
+ Modifica tu cuenta local AWS Config y añade un CodeCatalyst perfil para que puedas iniciar sesión con el SSO. Para obtener más información, consulte [Configuración para usar el AWS CLI con CodeCatalyst](set-up-cli.md).
+ Modifica la configuración de SSH local y añade la configuración necesaria para conectarse a su entorno de desarrollo mediante SSH.
+ Añade un script al directorio `~/.aws/codecatalyst-dev-env` que utiliza el cliente SSH para conectarse a su entorno de desarrollo. Este script llama a la [CodeCatalyst StartDevEnvironmentSession API](https://docs.aws.amazon.com/codecatalyst/latest/APIReference/API_StartDevEnvironmentSession.html) y utiliza un AWS Systems Manager Session Manager complemento para establecer una AWS Systems Manager sesión con tu entorno de desarrollo, que el cliente SSH local utiliza para conectarse de forma segura al entorno de desarrollo remoto.
+ Inicia sesión en Amazon CodeCatalyst mediante AWS el inicio de sesión único con el segundo comando. [Este comando solicita y recupera las credenciales para que el script del `~/.aws/codecatalyst-dev-env` directorio pueda llamar a la API. CodeCatalyst StartDevEnvironmentSession ](https://docs.aws.amazon.com/codecatalyst/latest/APIReference/API_StartDevEnvironmentSession.html) Este comando debe ejecutarse cada vez que caduquen las credenciales. Cuando ejecute el último comando en el modal (ssh ), aparecerá un error si sus credenciales han caducado o si no ha realizado el inicio de sesión SSO como se indica en este paso.
+ Conéctese al entorno de desarrollo especificado mediante SSH con el tercer comando. Este comando tiene la siguiente estructura:
```
ssh codecatalyst-dev-env===
```
También puede usar este comando para realizar otras acciones permitidas por el cliente SSH, como el enrutamiento de puertos o la carga y descarga de archivos:
+ Enrutamiento de puertos:
```
ssh -L :127.0.0.1: codecatalyst-dev-env===
```
+ Cargar un archivo en el directorio principal del entorno de desarrollo:
```
scp -O codecatalyst-dev-env===:
```
# Configuración de un devfile para un entorno de desarrollo
Un *devfile* es un estándar abierto que le ayuda a personalizar los entornos de desarrollo de su equipo. Un devfile es un archivo YAML que codifica las herramientas de desarrollo necesarias. Al configurar un devfile, puede predeterminar las herramientas de proyecto y las bibliotecas de aplicaciones que necesita y Amazon las CodeCatalyst instala en su entorno de desarrollo por usted. El devfile es específico del repositorio para el que se creó y se puede crear un devfile distinto para cada repositorio. El entorno de desarrollo admite comandos y eventos, y proporciona una imagen de devfile universal predeterminada.
Si crea un proyecto con el esquema vacío, puede crear un devfile manualmente. Si crea un proyecto con un plano diferente, CodeCatalyst crea un devfile automáticamente. El directorio `/projects` de un entorno de desarrollo almacena los archivos que se extraen del repositorio de código fuente y el devfile. El directorio `/home`, que está vacío al crear por primera vez el entorno de desarrollo, almacena los archivos que se crean mientras se utiliza el entorno de desarrollo. Todo lo que hay en los directorios `/projects` y `/home` de un entorno de desarrollo se almacena de forma persistente.
**nota**
La carpeta `/home` solo cambia si cambia el nombre del devfile o del componente del devfile. Si cambia el nombre del devfile o del componente del devfile, se sustituirá el contenido del directorio `/home` y no se podrán recuperar los datos del directorio `/home` anterior.
Si crea un entorno de desarrollo con un repositorio de código fuente que no contiene un devfile en su raíz, o si crea un entorno de desarrollo sin un repositorio de código fuente, se aplicará automáticamente un devfile universal predeterminado al repositorio de código fuente. Para todos se utiliza la misma imagen de devfile universal predeterminada. IDEs CodeCatalyst actualmente es compatible con la versión 2.0.0 de devfile. Para obtener más información sobre el devfile, consulte [Devfile schema - Version 2.0.0](https://devfile.io/docs/2.0.0/devfile-schema).
**nota**
Solo puede incluir imágenes de contenedor público en su archivo de desarrollo.
Tenga en cuenta que los entornos de desarrollo conectados a una VPC solo admiten las siguientes imágenes de devfile:
+ Imagen universal
+ Imágenes privadas de Amazon ECR, si el repositorio está en la misma región que la VPC
**Topics**
+ [Edición de un devfile de repositorio para un entorno de desarrollo](devenvironment-devfile-moving.md)
+ [Funciones de Devfile compatibles con CodeCatalyst](#devenvironment-devfile-support)
+ [Ejemplo de un devfile para un entorno de desarrollo](#devenvironment-devfile-example)
+ [Solución de problemas de un devfile de repositorio mediante el modo de recuperación](#devenvironment-devfile-recovery)
+ [Especificación de imágenes de devfile universales para un entorno de desarrollo](devenvironment-universal-image.md)
+ [Comandos de devfile](devenvironment-devfile-commands.md)
+ [Eventos de devfile](devenvironment-devfile-events.md)
+ [Componentes de devfile](devenvironment-devfile-components.md)
# Edición de un devfile de repositorio para un entorno de desarrollo
Utilice el siguiente procedimiento para editar un devfile de repositorio para un entorno de desarrollo.
## Edición de un archivo de desarrollo de repositorio para un entorno de desarrollo en CodeCatalyst
**Edición del devfile de repositorio**
1. Abra la CodeCatalyst consola en [https://codecatalyst.aws/](https://codecatalyst.aws/).
1. Vaya al proyecto que contenga el repositorio de código fuente para el que desee editar el devfile.
1. En el panel de navegación, seleccione **Código**.
1. Elija **Repositorios de código fuente**.
1. Elija el repositorio de código fuente que contenga el devfile que desea editar.
1. En la lista de archivos, seleccione el archivo `devfile.yaml`.
1. Elija **Edit (Edición de)**.
1. Edite el devfile.
1. Elija **Confirmar** o cree una solicitud de extracción para que un miembro del equipo pueda revisar y aprobar los cambios.
**nota**
Si edita el devfile, debe reiniciar el devfile para que se apliquen los cambios. Esto se puede hacer ejecutando `/aws/mde/mde start --location devfile.yaml`. Si hay algún problema al iniciar el devfile, entrará en modo de recuperación. Sin embargo, si edita un devfile asociado a un entorno de desarrollo conectado a una VPC, tendrá que reiniciar el entorno de desarrollo en su lugar para que los cambios surtan efecto.
Puede saber qué devfile se está utilizando ejecutando `/aws/mde/mde status`. El campo de ubicación tiene la ruta del devfile relativa a la carpeta `/projects` del entorno.
```
{
"status": "STABLE",
"location": "devfile.yaml"
}
```
También 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`.
## Edición de un devfile de repositorio para un entorno de desarrollo en un IDE
Para cambiar la configuración de un entorno de desarrollo, debe editar el devfile. Le recomendamos que edite el archivo de desarrollo en un IDE compatible y, a continuación, actualice su entorno de desarrollo, pero también puede editar el archivo de desarrollo desde la raíz del repositorio de origen en. CodeCatalyst Si edita el devfile en un IDE compatible, debe confirmar y enviar los cambios al repositorio de código fuente o crear una solicitud de extracción para que un miembro del equipo pueda revisar y aprobar los cambios en el devfile.
+ [Edición del archivo de desarrollo del repositorio para un entorno de desarrollo en AWS Cloud9](https://docs.aws.amazon.com/cloud9/latest/user-guide/devenvironment-cloud9.title.html#ide-toolkits-edit-devfile-cloud9)
+ [Edición del devfile de repositorio para un entorno de desarrollo en VS Code](https://docs.aws.amazon.com/toolkit-for-vscode/latest/userguide/codecatalyst-devenvironment.html#codecatalyst-devenvironment-devfile)
+ [Edición del archivo de desarrollo del repositorio para un entorno de desarrollo en JetBrains](https://docs.aws.amazon.com/toolkit-for-jetbrains/latest/userguide/codecatalyst-overview.html#codecatalyst-overview-default)
## Funciones de Devfile compatibles con CodeCatalyst
CodeCatalyst admite las siguientes funciones de devfile en la versión 2.0.0. Para obtener más información sobre el devfile, consulte [Devfile schema - Version 2.0.0](https://devfile.io/docs/2.0.0/devfile-schema).
| Característica | Tipo |
| --- | --- |
| `exec` | Comando |
| `postStart` | Event |
| `container` | Componente |
| `args` | Propiedades del componente |
| `env` | Propiedades del componente |
| `mountSources` | Propiedades del componente |
| `volumeMounts` | Propiedades del componente |
## Ejemplo de un devfile para un entorno de desarrollo
A continuación se muestra un ejemplo de un devfile sencillo.
```
schemaVersion: 2.0.0
metadata:
name: al2
components:
- name: test
container:
image: public.ecr.aws/amazonlinux/amazonlinux:2
mountSources: true
command: ['sleep', 'infinity']
- name: dockerstore
commands:
- id: setupscript
exec:
component: test
commandLine: "chmod +x script.sh"
workingDir: /projects/devfiles
- id: executescript
exec:
component: test
commandLine: "/projects/devfiles/script.sh"
- id: yumupdate
exec:
component: test
commandLine: "yum -y update --security"
events:
postStart:
- setupscript
- executescript
- yumupdate
```
Los registros de inicio, comandos y eventos del devfile se capturan y almacenan en `/aws/mde/logs`. Para depurar el comportamiento del devfile, inicie el entorno de desarrollo con un devfile que funcione y acceda a los registros.
## Solución de problemas de un devfile de repositorio mediante el modo de recuperación
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`.
# Especificación de imágenes de devfile universales para un entorno de desarrollo
La *imagen universal* predeterminada incluye los lenguajes de programación más utilizados y las herramientas relacionadas que se pueden usar para su IDE. Si no se especifica ninguna imagen, CodeCatalyst proporciona esta imagen y contiene herramientas mantenidas por CodeCatalyst. Para mantenerse informado de las nuevas versiones de imágenes, consulte [Suscripción a notificaciones de imágenes universales con SNS](#devenvironment-universal-notifications).
Amazon apoya CodeCatalyst activamente las siguientes imágenes de devfile:
| Versión de imagen | Identificador de imagen |
| --- | --- |
| Universal image 4.0 | public.ecr.aws/aws-mde/universal-image:4.0 |
| Universal image 5.0 | public.ecr.aws/aws-mde/universal-image:5.0 |
**nota**
También puede utilizar `public.ecr.aws/aws-mde/universal-image:latest` para obtener la imagen más reciente, que actualmente es `public.ecr.aws/aws-mde/universal-image:5.0`.
CodeCatalyst ha dejado en desuso las siguientes imágenes. Puede seguir utilizando estas imágenes, pero no estarán almacenadas en caché en el host de compilación y, por lo tanto, aumentará el tiempo de arranque de los entornos de desarrollo.
| Versión de imagen | Identificador de imagen | Fecha de baja |
| --- | --- | --- |
| Universal image 1.0 | public.ecr.aws/aws-mde/universal-image:1.0 | 16 de agosto de 2024 |
| Universal image 2.0 | public.ecr.aws/aws-mde/universal-image:2.0 | 16 de agosto de 2024 |
| Universal image 3.0 | public.ecr.aws/aws-mde/universal-image:3.0 | 30 de julio de 2025 |
**nota**
Si lo estás usando AWS Cloud9, la función de autocompletar no funcionará para PHP, Ruby y CSS después de la actualización a`universal-image:3.0`.
**Topics**
+ [Suscripción a notificaciones de imágenes universales con SNS](#devenvironment-universal-notifications)
+ [Versiones del entorno en tiempo de ejecución de imágenes universales 4.0](#devenvironment-universal-runtimes-4.0)
+ [Versiones en tiempo de ejecución de Universal Image 5.0](#devenvironment-universal-runtimes-5.0)
## Suscripción a notificaciones de imágenes universales con SNS
CodeCatalyst proporciona un servicio universal de notificación de imágenes. Puede utilizarla para suscribirse a un tema del Amazon Simple Notification Service (SNS) que le notifique cuando se publiquen actualizaciones de imágenes CodeCatalyst universales. Para obtener más información sobre los temas de SNS, consulte [¿Qué es Amazon Simple Notification Service?](https://docs.aws.amazon.com/sns/latest/dg/welcome.html)
Cada vez que se publican nuevas imágenes universales, enviamos notificaciones a los suscriptores; en esta sección se describe cómo suscribirse a las actualizaciones de imágenes CodeCatalyst universales.
**Mensaje de ejemplo**
```
{
"Type": "Notification",
"MessageId": "123456789",
"TopicArn": "arn:aws:sns:us-east-1:1234657890:universal-image-updates",
"Subject": "New Universal Image Release",
"Message": {
"v1": {
"Message": "A new version of the Universal Image has been released. You are now able to launch new DevEnvironments using this image.",
"image ": {
"release_type": "MAJOR VERSION",
"image_name": "universal-image",
"image_version": "2.0",
"image_uri": "public.ecr.aws/amazonlinux/universal-image:2.0"
}
}
},
"Timestamp": "2021-09-03T19:05:57.882Z",
"UnsubscribeURL": "example url"
}
```
**Para suscribirse a actualizaciones de imágenes CodeCatalyst universales mediante la consola Amazon SNS**
1. Abra [Panel](https://console.aws.amazon.com/sns/v2/home) en la consola de Amazon SNS.
1. En la barra de navegación, elija su. Región de AWS
1. En el panel de navegación, seleccione **Suscripciones** y, a continuación, elija **Crear suscripción**.
1. En **ARN del tema**, escriba `arn:aws:sns:us-east-1:089793673375:universal-image-updates`.
1. En **Protocol (Protocolo)**, elija **Email (Correo electrónico)**.
1. En **Punto de conexión**, proporcione una dirección de correo electrónico. Esta dirección de correo electrónico se usará para recibir las notificaciones.
1. Seleccione **Crear subscripción**.
1. Recibirás un correo electrónico de confirmación con el asunto «AWS Notificación: confirmación de suscripción». Abra el correo electrónico y elija **Confirmar suscripción**.
**Para cancelar la suscripción a las actualizaciones CodeCatalyst universales de imágenes mediante la consola Amazon SNS**
1. Abra [Panel](https://console.aws.amazon.com/sns/v2/home) en la consola de Amazon SNS.
1. En la barra de navegación, elija su. Región de AWS
1. En el panel de navegación, elija **Suscripciones** y, a continuación, seleccione la suscripción de la que desea darse de baja.
1. Elija **Acciones** y después **Eliminar suscripciones**.
1. Elija **Eliminar**.
## Versiones del entorno en tiempo de ejecución de imágenes universales 4.0
En la tabla siguiente se muestran los entornos en tiempo de ejecución disponibles para `universal-image:4.0`.
**Versiones del entorno en tiempo de ejecución de `universal-image:4.0`**
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/codecatalyst/latest/userguide/devenvironment-universal-image.html)
## Versiones en tiempo de ejecución de Universal Image 5.0
En la tabla siguiente se muestran los entornos en tiempo de ejecución disponibles para `universal-image:5.0`.
**Versiones del entorno en tiempo de ejecución de `universal-image:5.0`**
| Nombre del entorno de tiempo de ejecución | Versión | Versión principal específica y última versión secundaria |
| --- | --- | --- |
| CLI de AWS | 2.25 | `aws-cli: 2.x` |
| Docker Compose | 2.34 | `docker-compose: 2.x` |
| dotnet | 8.0 | `dotnet: 8.x` |
| golang | 1.24 | `golang: 1.x` |
| java | corretto21 | `java: corretto21.x` |
| nodejs | 22.0 | `nodejs: 22.x` |
| php | 8.3.16 | `php: 8.x` |
| python | 3.12 | `python: 3.x` |
| ruby | 3.4.2 | `ruby: 3.x` |
| Terraform | 1.10.5 | `terraform: 1.x` |
# Comandos de devfile
Actualmente, CodeCatalyst solo admite `exec` comandos en su devfile. Para obtener más información, consulte [Adding commands](https://devfile.io/docs/2.0.0/adding-commands) en la documentación de Devfile.io.
En el siguiente ejemplo se muestra cómo especificar comandos `exec` en un devfile.
```
commands:
- id: setupscript
exec:
component: test
commandLine: "chmod +x script.sh"
workingDir: /projects/devfiles
- id: executescript
exec:
component: test
commandLine: "./projects/devfiles/script.sh"
- id: updateyum
exec:
component: test
commandLine: "yum -y update --security"
```
Una vez conectado a su entorno de desarrollo, puede ejecutar los comandos definidos a través del terminal.
```
/aws/mde/mde command
/aws/mde/mde command executescript
```
En el caso de comandos de ejecución prolongada, puede usa el indicador de streaming `-s` para mostrar la ejecución del comando en tiempo real.
```
/aws/mde/mde -s command
```
**nota**
`command-id` debe estar en minúscula.
## Los parámetros de ejecución son compatibles con CodeCatalyst
CodeCatalyst admite los siguientes `exec` parámetros en la versión 2.0.0 de devfile.
+ `commandLine`
+ `component`
+ `id`
+ `workingDir`
# Eventos de devfile
Actualmente, CodeCatalyst solo admite `postStart` eventos en tu devfile. Para obtener más información, consulta la documentación [postStartObject](https://devfile.io/docs/2.0.0/adding-event-bindings#post-start-object)de DevFile.io.
En el siguiente ejemplo se muestra cómo añadir enlaces de eventos `postStart` en un devfile.
```
commands:
- id: executescript
exec:
component: test
commandLine: "./projects/devfiles/script.sh"
- id: updateyum
exec:
component: test
commandLine: "yum -y update --security"
events:
postStart:
- updateyum
- executescript
```
Tras el inicio, su entorno de desarrollo ejecutará los comandos `postStart` especificados en el orden en que estén definidos. Si se produce un error en un comando, el entorno de desarrollo seguirá ejecutándose y el resultado de la ejecución se almacenará en los registros bajo `/aws/mde/logs`.
# Componentes de devfile
Actualmente, CodeCatalyst solo admite `container` los componentes de su devfile. Para obtener más información, consulte [Adding components](https://devfile.io/docs/2.0.0/adding-components) en la documentación de Devfile.io.
El siguiente ejemplo muestra cómo agregar un comando de inicio a su contenedor en un devfile.
```
components:
- name: test
container:
image: public.ecr.aws/amazonlinux/amazonlinux:2
command: ['sleep', 'infinity']
```
**nota**
Si el contenedor tiene un comando de entrada de corta duración, debe incluir `command: ['sleep', 'infinity']` para que el contenedor siga funcionando.
CodeCatalyst también admite las siguientes propiedades en el componente contenedor:`args`, `env``mountSources`, y`volumeMounts`.
# Asociación de una conexión de VPC a un entorno de desarrollo
Una *conexión de VPC* es un CodeCatalyst recurso que contiene todas las configuraciones necesarias para que su flujo de trabajo acceda a una VPC. Los administradores del espacio pueden añadir sus propias conexiones de VPC en la CodeCatalyst consola de Amazon en nombre de los miembros del espacio. Al añadir una conexión de VPC, los miembros del espacio pueden ejecutar acciones de flujo de trabajo y crear entornos de desarrollo que cumplan las reglas de la red y puedan acceder a los recursos de la VPC asociada.
**importante**
Los entornos de desarrollo con una conexión de VPC no admiten [repositorios de fuentes de terceros vinculados](source-repositories-link.md) a ellos. CodeCatalyst
Solo puede asociar un entorno de desarrollo a una conexión de VPC al crear un entorno de desarrollo. No puede cambiar la conexión de VPC asociada a su entorno de desarrollo después de crearlo. Si quiere usar una conexión de VPC diferente, tiene que eliminar el entorno de desarrollo actual y crear uno nuevo.
**nota**
Los entornos de desarrollo solo se pueden asociar a una conexión de VPC con una AWS cuenta que tenga acceso a tu proyecto. Para obtener más información, consulte [Configuración de conexiones de cuentas restringidas por proyectos](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-accounts-restriction.html) en la Guía * CodeCatalyst del administrador de Amazon*.
Tenga en cuenta que los entornos de desarrollo utilizan varios AWS recursos y servicios al crearlos. Esto significa que los entornos de desarrollo se conectan a los siguientes AWS servicios:
+ Amazon CodeCatalyst
+ AWS SSM
+ AWS KMS
+ Amazon ECR
+ Amazon CloudWatch
+ Amazon ECS
**nota**
AWS Toolkit no admite la creación de entornos de desarrollo con una conexión de VPC asociada. Ten en cuenta también que si utilizas un IDE distinto de este AWS Cloud9, es posible que los tiempos de carga sean de unos cinco minutos.
Debe tener el rol **Administrador del espacio** o el rol **Usuario avanzado** para administrar las conexiones de VPC en el nivel de espacio. Para obtener más información al respecto VPCs, consulte [Administrar Amazon VPCs CodeCatalyst en](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-vpcs.html) la *Guía CodeCatalyst del administrador*.
# Cuotas para entornos de desarrollo en CodeCatalyst
En la siguiente tabla se describen las cuotas y los límites de los entornos de desarrollo en Amazon CodeCatalyst. Para obtener más información sobre las cuotas en Amazon CodeCatalyst, consulta[Cuotas de CodeCatalyst](quotas.md).
| | |
| --- |--- |
| Número de horas del entorno de desarrollo al mes | Las horas del entorno de desarrollo se ven afectadas por los límites generales de almacenamiento de su espacio. Para obtener más información, consulte [Precios](https://codecatalyst.aws/explore/pricing) y [Solución de problemas con los entornos de desarrollo](devenvironments-troubleshooting.md). |
| Cantidad de almacenamiento en el entorno de desarrollo por espacio | El almacenamiento del entorno de desarrollo se ve afectado por los límites generales de almacenamiento de su espacio. Para obtener más información, consulte [Precios](https://codecatalyst.aws/explore/pricing) y [Solución de problemas con los entornos de desarrollo](devenvironments-troubleshooting.md). |
| Cantidad de computación del entorno de desarrollo | La computación del entorno de desarrollo se ve afectada por los límites generales de almacenamiento de su espacio. Para obtener más información, consulte [Precios](https://codecatalyst.aws/explore/pricing) y [Solución de problemas con los entornos de desarrollo](devenvironments-troubleshooting.md). |