Entornos en la nube

Crea, configura y comparte entornos reutilizables para tareas en Codex Cloud

Codex Cloud ejecuta tareas de programación en la nube, para que el trabajo continúe mientras tu computadora está en reposo. Úsalo en la web, en dispositivos móviles o en la aplicación de escritorio para editar código, ejecutar comandos y revisar resultados.

Un entorno en la nube es la configuración reutilizable que usan las tareas: repositorios, dependencias, herramientas y ajustes de acceso. Codex inspecciona tus repositorios, prepara la configuración y la prueba contigo. Cada tarea nueva obtiene su propio espacio de trabajo aislado a partir del entorno publicado.

Para una introducción, consulta la descripción general de Codex Cloud.

Inicia una tarea en Codex Cloud

En la web o en la aplicación de escritorio, elige Trabajar en > Nube y selecciona un entorno publicado. En dispositivos móviles, abre Codex y selecciona un entorno publicado. Describe lo que quieres que haga Codex y envía la solicitud. Si necesitas una nueva configuración, crea un entorno en la web o en la aplicación de escritorio.

Los administradores de Enterprise pueden revisar el acceso al espacio de trabajo antes de implementar Codex Cloud.

Crea y publica un entorno

Crea nuevos entornos en la web o en la aplicación de escritorio. Inicia sesión con tu cuenta de ChatGPT:

  1. En una tarea nueva, elige Trabajar en > Nube, abre Seleccionar entorno y selecciona Crear entorno.
  2. Selecciona los repositorios de GitHub que se descargarán. Conecta GitHub si se te solicita.
  3. Selecciona Comenzar. Codex inspecciona los repositorios, instala dependencias y herramientas, y prueba el flujo de trabajo.
  4. Proporciona el acceso o la información que falten cuando se te solicite. También puedes pedir versiones, comandos o servicios específicos.
  5. Revisa el informe de preparación, la configuración y los archivos. Resuelve el trabajo pendiente, guarda los cambios y selecciona Publicar.
  6. Cuando aparezca Entorno publicado, selecciona Iniciar una tarea nueva y describe lo que quieres que haga Codex.

También puedes empezar desde Configuración > Codex Cloud > Entornos > Crear entorno.

Personaliza la instalación y el inicio

Codex identifica entornos de ejecución, versiones de paquetes, herramientas y servicios a partir de tus repositorios. Ajusta la configuración en la conversación; no necesitas escribir un script de instalación por tu cuenta.

Codex puede registrar la configuración probada en dos campos:

  • Script de instalación: comandos para instalar dependencias y preparar recursos de desarrollo.
  • Habilidad de inicio: instrucciones para iniciar servicios y comprobar que estén listos.

Reutiliza y actualiza el estado guardado

  • Tarea nueva: comienza a partir del sistema de archivos preparado del entorno publicado.
  • Tarea existente: continúa con sus propios archivos guardados, incluidos los cambios sin confirmar y las herramientas instaladas.
  • Actualización del repositorio: se ejecuta automáticamente en segundo plano y conserva las cachés de dependencias sin volver a ejecutar los comandos de instalación o inicio.

Para actualizar la configuración reutilizable, abre Configuración > Codex Cloud > Entornos. En el menú … del entorno, selecciona Editar. Describe el cambio, deja que Codex lo prepare y lo pruebe, guarda los cambios y selecciona Volver a publicar. Inicia una tarea nueva para usar la actualización; las tareas existentes conservan su propio estado.

Confirma el trabajo importante en el control de versiones o guarda los resultados que necesites. El estado guardado no sustituye al control de versiones.

Configura variables de entorno y secretos de red

Codex identifica la configuración que falta y solicita los valores que no puede inferir. En la configuración del entorno, selecciona Administrar junto a Variables de entorno o Secretos HTTP. Elige cómo proporcionar cada valor:

Configuración Úsala para Entrega
Variable de entorno Un valor que un programa debe leer directamente Se pasa directamente a los programas del entorno.
Secreto de red Una credencial enviada a un servicio HTTPS específico Los programas reciben un marcador de posición; el proxy lo sustituye por el valor real para los destinos permitidos.

Para los secretos de red, establece Clave, Valor y Dominios permitidos. Usa una clave distinta de la de cualquier variable directa. La sustitución funciona para HTTPS en el puerto 443, durante la configuración y las tareas; no coloca la credencial real en un proceso local ni en un archivo.

Al guardar secretos de red que pertenecen al entorno, se añaden sus destinos al acceso restringido a Internet. Las variables directas y los valores personales no añaden destinos. Revisa la política de red guardada antes de hacer pruebas. Para conocer los requisitos del espacio de trabajo, consulta Agent Security.

Proporciona valores personales

Usa la Bóveda personal para guardar tus propias variables de entorno y secretos de red para los entornos en la nube de tu espacio de trabajo.

Un entorno compartido puede solicitar valores que cada persona proporciona desde su propia cuenta. Al compartir el entorno, se comparten estos requisitos, no tus credenciales personales.

Cuando se te solicite, introduce los valores obligatorios en Añadir secretos personales y selecciona Guardar e iniciar. Los valores opcionales pueden dejarse sin establecer.

Para administrar los valores de antemano:

  1. Abre Configuración > Codex Cloud y selecciona la pestaña Bóveda personal.
  2. Selecciona Añadir, elige Variable de entorno o Secreto de red en Tipo e introduce la Clave correspondiente y tu Valor.
  3. En Se aplica a, elige Todos los entornos o Entornos seleccionados, y luego Guardar.

Solo los valores solicitados llegan a una tarea. Un valor para un entorno específico tiene prioridad sobre un valor predeterminado general. Los secretos de red personales usan los destinos permitidos del entorno y sustituyen los marcadores de posición de la misma manera.

Comparte dentro de un espacio de trabajo Enterprise

Comparte una configuración preparada para que tus colegas puedan iniciar sus propias tareas a partir de ella:

  1. Abre la configuración del entorno.
  2. En Privacidad > Quién puede usarlo, elige tu espacio de trabajo.
  3. Guarda el cambio. Publica el entorno si aún no lo has hecho.

Elige Solo yo en Quién puede usarlo para mantener el entorno privado. Cada tarea tiene archivos de trabajo independientes; el acceso a la configuración no concede acceso a la tarea de otra persona ni permiso para editar el entorno.

Revisa los archivos preparados y las credenciales que pertenecen al entorno antes de compartirlo. Las identidades en la nube y las conexiones VPN también pueden proporcionar acceso compartido a servicios. El acceso a los repositorios y las conexiones personales dependen de la cuenta que ejecuta la tarea.

Usar Codex en la nube controla el acceso a las tareas. Administrar entornos del espacio de trabajo controla la creación y edición de entornos compartidos con el espacio de trabajo. Consulta Roles y permisos del espacio de trabajo.

Agent Security

La configuración de acceso a internet del entorno define a qué destinos de internet público puede acceder su máquina virtual. La configuración de VPN conecta de forma independiente esa máquina virtual con servicios de una red privada.

En los espacios de trabajo Enterprise, los administradores usan Agent Security para configurar los requisitos del espacio de trabajo sobre el comportamiento de los agentes, la red de ejecución administrada y el uso de herramientas compatibles. Estos requisitos se aplican junto con los ajustes de dominio guardados en cada entorno. Consulta Agent Security para conocer las políticas globales y las excepciones compatibles con Codex Cloud.

Conéctate a servicios

Configura el acceso a los registros de paquetes, las API y los demás servicios que tu flujo de trabajo necesita:

  1. En la configuración del entorno, elige cuánto acceso a Internet público necesita tu flujo de trabajo. Activa Habilitar todo el acceso a Internet público para obtener acceso público completo. Esto incluye los destinos cubiertos por los controles de gestores de paquetes y dominios adicionales, por lo que esos controles más específicos quedan deshabilitados.
  2. Para restringir el acceso a Internet público, desactiva Habilitar todo el acceso a Internet público y luego permite gestores de paquetes o añade hosts específicos en Dominios adicionales permitidos. Desactivar el acceso público completo sigue permitiendo el acceso a estos destinos autorizados.
  3. Guarda y prueba los servicios durante la configuración. Publica o vuelve a publicar y luego verifica el acceso en una tarea nueva.

El acceso a Internet público y el acceso por VPN son independientes. Puedes usar cualquiera de los dos o ambos. La configuración de Internet público se aplica a las conexiones fuera de Tailscale, incluso cuando una ruta de subred de Tailscale usa direcciones IP públicas. Restringir el acceso a Internet público no deshabilita la VPN configurada.

Para conocer los requisitos del espacio de trabajo, consulta Agent Security. Permitir un destino no proporciona credenciales ni concede permisos en ese servicio.

Dominios incluidos en la opción predefinida Gestores de paquetes

La opción predefinida Gestores de paquetes permite estos registros, repositorios y hosts de descarga:

  • npm y Yarn: registry.npmjs.org, registry.yarnpkg.com
  • PyPI y PyTorch: pypi.org, files.pythonhosted.org, download.pytorch.org, download-r2.pytorch.org
  • Rust: crates.io, index.crates.io, static.crates.io, static.rust-lang.org
  • Go: proxy.golang.org, sum.golang.org
  • Maven y Gradle: repo.maven.apache.org, repo1.maven.org, plugins.gradle.org, plugins-artifacts.gradle.org, services.gradle.org, downloads.gradle.org
  • Bazel: bcr.bazel.build, mirror.bazel.build
  • Buf: buf.build
  • CPAN: cpan.metacpan.org
  • Repositorios de Ubuntu y Debian: archive.ubuntu.com, security.ubuntu.com, ports.ubuntu.com, ppa.launchpadcontent.net, deb.debian.org, security.debian.org
  • Repositorios de proveedores: packages.microsoft.com, apt.buildkite.com, developer.download.nvidia.com, deb.nodesource.com
  • Código fuente, archivos, versiones y LFS de GitHub: github.com, codeload.github.com, github-cloud.githubusercontent.com, github-cloud.s3.amazonaws.com, release-assets.githubusercontent.com
  • Otras descargas: dl.google.com, pkgconfig.freedesktop.org

Para los dominios raíz registrados, Codex también permite el nombre de host www correspondiente. Los demás subdominios requieren sus propias entradas de dominio permitido. Añade cualquier otro host que requieran tus dependencias en Dominios adicionales permitidos.

Para los servicios accesibles a través de Internet que filtran las conexiones por IP de origen, usa la fuente de IP de salida de los agentes. Permite todos los rangos publicados, consulta la fuente a diario y actualiza la lista de permitidos del servicio cuando cambien los rangos. Estos rangos se comparten entre clientes; mantén los controles de autenticación y autorización del servicio.

Redes privadas (VPN)

Permite que las tareas en la nube accedan a servicios de tu red privada mediante una conexión VPN. Tailscale usa el DNS privado, las rutas de subred y las reglas de acceso que hayas configurado. No necesitas una lista de IP o dominios permitidos específica para Codex para los destinos accesibles mediante Tailscale, incluidos HTTP, HTTPS y otros servicios TCP.

  1. En la configuración del entorno, selecciona el icono de lápiz junto a Tailscale.
  2. Introduce las credenciales de conexión de tu proveedor de VPN.
  3. Configura las rutas, el DNS y las reglas de acceso necesarios en Tailscale para que la identidad VPN del entorno pueda acceder a los servicios previstos.
  4. Guarda y luego publica o vuelve a publicar. Inicia una tarea nueva y prueba el servicio.

Tailscale es el proveedor de VPN compatible actualmente. Al crear una clave de autenticación de Tailscale, activa tanto Reutilizable como Efímera. Una clave reutilizable permite que las nuevas VM de tareas en la nube se unan a tu red. Tailscale elimina automáticamente los dispositivos efímeros después de que se desconectan. Está previsto añadir compatibilidad con otros proveedores de VPN.

Se admiten rutas de subredes IPv4 privadas. Las tareas pueden usar el DNS dividido de Tailscale y MagicDNS para acceder a servicios privados mediante el nombre de host.

Si tu servicio usa el DNS interno de tu organización, configura el DNS dividido en la consola de administración de Tailscale para enviar las consultas de tu dominio interno a tu servidor DNS. Usa el nombre de host completo del servicio, como api.corp.example.com, que debe resolverse a una dirección IPv4. El destino debe ser accesible mediante las rutas de Tailscale configuradas y estar permitido por tus reglas de acceso de Tailscale.

Las tareas de un entorno compartido usan la identidad de VPN configurada en él.

Conéctate a servicios TCP

Usa la VPN para conectarte a servicios TCP, como bases de datos o SSH. Los destinos TCP deben usar direcciones IPv4 enrutadas a través de Tailscale. En el caso de los nombres de host, cada dirección IPv4 resuelta debe usar esas rutas. Las direcciones protegidas por la plataforma siguen bloqueadas.

Los clientes TCP deben conectarse mediante el proxy HTTP CONNECT del entorno en proxy:8088, ya sea directamente o mediante una herramienta de reenvío local. Para los destinos con nombre de host, conserva el nombre de host para que el proxy resuelva el DNS. Los túneles TCP no interceptan TLS ni inyectan secretos de red: el cliente debe proporcionar las credenciales del servicio y verificar su certificado TLS cuando corresponda. Las solicitudes que necesiten sustitución de secretos de red deben usar el proxy HTTPS configurado y cumplir las reglas de dominios permitidos del secreto; la sustitución funciona en el puerto 443.

Después de cambiar la configuración de la VPN, guarda los cambios y luego publica o vuelve a publicar el entorno. Reemplaza los entornos que ya estén en ejecución para usar la configuración actualizada de la VPN. Inicia una tarea nueva y prueba el acceso. Desvincular la VPN de un borrador no revoca las conexiones existentes; reemplaza o termina el entorno afectado para revocar el acceso.

Accede a recursos en la nube con OIDC

OpenID Connect (OIDC) permite que una tarea obtenga credenciales de corta duración para recursos en la nube. Tu organización configura la relación de confianza con el proveedor de nube y concede a la identidad los permisos que necesita el flujo de trabajo.

  1. Abre Opciones avanzadas > OIDC en la configuración del entorno guardado.
  2. Selecciona Añadir y luego elige una conexión disponible o Crear conexión… para un proveedor compatible.
  3. Para una conexión nueva, introduce los datos de identidad del proveedor y créala. En el proveedor, configura la relación de confianza con los valores mostrados de Emisor, Audiencia y Sujeto o las condiciones de las declaraciones, y concede permisos sobre los recursos.
  4. Confirma que la conexión esté vinculada y revisa su alias. Guarda y luego publica o vuelve a publicar el entorno.
  5. Inicia una tarea nueva y prueba una operación permitida y otra denegada.

La configuración varía según el proveedor y solo se pueden vincular conexiones compatibles. Los permisos de la identidad determinan el acceso; tus permisos personales en el proveedor no se transfieren a ella. Permite los puntos de conexión del proveedor y los destinos de los servicios necesarios por separado en la política de red.

Guarda los cambios de vinculación o alias para aplicarlos durante la configuración; publica o vuelve a publicar para usarlos en tareas nuevas. Editar una conexión de identidad compartida puede afectar a otros entornos que la usen.

Compatibilidad con OIDC por proveedor

La compatibilidad depende del servicio, la operación y el cliente que utilice. La compatibilidad se aplica a las operaciones y los clientes que se enumeran aquí.

AWS

Servicio o flujo de trabajo Estado Alcance y limitaciones
AWS CLI y boto3 Compatible Autenticación y renovación de credenciales.
Amazon S3 Compatible Lectura y carga de objetos, estado de Terraform y solicitudes prefirmadas desde el entorno de Codex.
Amazon ECR Compatible Descarga y carga de imágenes para registros privados.
AWS CodeArtifact Compatible Instalación y publicación de paquetes npm y Python.
Amazon EKS Compatible kubectl, Helm, registros, exec y reenvío de puertos.
Amazon ECS Compatible exec de Fargate y reenvío de puertos.
Amazon Bedrock Compatible Inferencia de texto y streaming con Nova Micro. No se incluyen otros modelos.
Inicio de sesión en bases de datos con IAM de Amazon RDS Aún no compatible Autenticación en bases de datos PostgreSQL y MySQL mediante IAM.

Google Cloud

Servicio o flujo de trabajo Estado Alcance y limitaciones
gcloud y Cloud Storage Compatible gcloud, estado de Terraform, lectura de objetos y cargas, incluidas las cargas reanudables.
Contenedores de Artifact Registry Compatible Descarga y carga de imágenes de Docker, probadas con capas de hasta 1 GiB.
Paquetes de Artifact Registry Compatible Instalación y publicación de paquetes de npm, Python y Maven. Las cargas están limitadas a 10 MiB. Maven usa credenciales de gcloud.
Google Kubernetes Engine (GKE) Compatible kubectl, despliegues, registros, exec y reenvío de puertos.
IAM, Secret Manager y Cloud KMS Compatible Gestión de cuentas de servicio, operaciones con secretos y cifrado y firma con KMS. Se excluye la exportación de claves de cuentas de servicio.
Inicio de sesión en bases de datos con IAM de Cloud SQL Aún no compatible Autenticación en bases de datos con IAM.

Azure

Servicio o flujo de trabajo Estado Alcance y limitaciones
Azure CLI y perfiles de identidad Compatible Autenticación y selección de perfiles.
Resource Manager, Blob Storage y ADLS Aún no compatible Los flujos de trabajo OIDC para estos servicios aún no son compatibles.
Descarga de imágenes de Container Registry Aún no compatible Las descargas de imágenes aún no son compatibles.
Carga de imágenes en Container Registry Aún no compatible Las cargas de imágenes no están disponibles.

Ejecuta una tarea y vuelve a ella

Selecciona un entorno publicado y describe tu objetivo. Codex usa sus repositorios y herramientas para editar archivos, ejecutar comandos y comprobar su trabajo. Revisa los cambios y los resultados de las pruebas antes de confirmar los cambios o abrir una pull request.

Continúa en la web o en dispositivos móviles

En la web, elige Trabajar en > Nube y selecciona un entorno. En dispositivos móviles, abre Codex y elige un entorno disponible. Crea nuevos entornos en la web o en la aplicación de escritorio.

Vuelve a abrir la misma tarea para continuar el trabajo en distintos dispositivos. Una tarea nueva inicia un trabajo independiente a partir de la configuración publicada. Las tareas de Codex Cloud pueden seguir trabajando mientras tu computadora está en reposo.

Inicia tareas desde Slack o Microsoft Teams

En un espacio de trabajo Enterprise con la delegación en la nube habilitada, pide a @ChatGPT en Slack o Microsoft Teams que trabaje en un repositorio. Codex usa el contexto de la conversación para elegir un entorno compartido con tu espacio de trabajo y disponible para la cuenta que ejecuta la tarea. Puedes indicar un entorno preferido o añadir instrucciones en tu prompt.

En Slack, los espacios de trabajo con control de acceso basado en roles de Codex Cloud deben conceder acceso a Codex Cloud tanto a la cuenta de servicio de la implementación como al usuario solicitante. Consulta Habilitar Codex Cloud para Slack para conocer la configuración administrativa.

Completa las solicitudes de conexión y aprobación, y luego revisa el resultado en la conversación. Continúa desde la misma cuenta conectada para seguir con la tarea; la solicitud de otro participante no continúa tu tarea automáticamente.

Consulta Administrar ChatGPT en Slack y Teams para configurar el espacio de trabajo y Usar ChatGPT en Slack para conocer los controles de tareas de Slack.

Especificaciones de la VM

Cada tarea en la nube se ejecuta en una VM con estos recursos predeterminados:

Plan de ChatGPT vCPUs Memoria Espacio en disco
Plus, Edu Plus 2 8 GiB 8 GiB
Pro, Business, Enterprise 4 16 GiB 32 GiB
Edu, Edu Pro 4 16 GiB 32 GiB

De forma predeterminada, el estado guardado de la VM de una tarea se puede recuperar durante un máximo de siete días desde la última vez que iniciaste un turno o reanudaste la tarea.

Hay VM más grandes y especificaciones personalizadas disponibles para Enterprise. Contacta a tu equipo de cuenta de OpenAI para conocer las configuraciones y los precios disponibles.

Limitaciones actuales

Las siguientes capacidades aún no son compatibles con los entornos en la nube y están en nuestra hoja de ruta:

  • Uso de la computadora y del navegador
  • GitLab y GitHub Enterprise Server autohospedado

Las habilidades almacenadas en tu repositorio están disponibles en las tareas en la nube. Las habilidades personales de tu computadora local no se sincronizan con los entornos en la nube.

Soluciona problemas de configuración y acceso durante la ejecución

La configuración falla o falta una herramienta necesaria

Busca en la conversación de configuración el comando que falló. Pide a Codex que diagnostique el error y vuelva a ejecutar el comando después de corregirlo. Por ejemplo: "Instala pnpm y ejecuta las pruebas del proyecto".

  • Si la configuración inicial falla, selecciona Volver a intentar para reintentar con los repositorios ya seleccionados en esa sesión de configuración.
  • Si la solución requiere cambiar archivos de código fuente, un manifiesto de paquetes o un archivo de bloqueo, realiza ese cambio en una tarea de programación y luego vuelve a la configuración.

Después de que Codex verifique la configuración, publica o vuelve a publicar el entorno.

Falla la descarga de un paquete o una solicitud HTTPS

Comprueba el nombre de host de destino y la autenticación por separado:

  1. Confirma que el host esté permitido en la configuración de acceso a Internet del entorno. Para un registro privado en packages.example.com, comprueba ese nombre de host exacto. Si las descargas también usan downloads.example.com, ese host también necesita acceso.
  2. Comprueba la URL y las credenciales configuradas en el gestor de paquetes o el cliente. Permitir un dominio no concede acceso al servicio.
  3. Si la autenticación usa un secreto de red, comprueba que sus Dominios permitidos incluyan el destino y que la solicitud use HTTPS en el puerto 443.
  4. En un espacio de trabajo Enterprise, pide a un administrador que compruebe los requisitos de Agent Security aplicables junto con la configuración del entorno.

Guarda los cambios de configuración y prueba la solicitud durante la configuración. Publica o vuelve a publicar y, después, verifica el acceso en una tarea nueva.

Falta un valor obligatorio o no se puede usar

Comprueba que hayas añadido el valor en el lugar correcto de la configuración del entorno:

  • Variables de entorno: úsalas para los valores que los programas necesitan leer directamente, como APP_MODE=development.
  • Secretos HTTP: úsalos para las credenciales que se envían a un servicio HTTPS permitido, como un token de registro privado. Los programas reciben un marcador de posición; el proxy lo sustituye por la credencial en las solicitudes coincidentes. Si el programa necesita leer el valor sin procesar, añádelo en Variables de entorno.

Para un valor personal, comprueba que su Clave coincida con la solicitud del entorno y que Se aplica a incluya ese entorno. Un valor para un entorno específico tiene prioridad sobre un valor predeterminado general.

Consulta Variables de entorno y secretos de red para ver las instrucciones de configuración.

La VPN se conecta, pero no se puede acceder a un servicio HTTP o HTTPS

  1. Confirma que el cliente usa el proxy HTTP/HTTPS configurado del entorno. Al probar con curl, omite --noproxy para que la solicitud use ese proxy.
  2. Para los destinos de Tailscale, revisa las rutas y las reglas de acceso de la VPN. Para los destinos de Internet público, revisa los dominios permitidos del entorno.
  3. Si el servicio es accesible por dirección IP pero no por nombre de host, revisa la configuración de DNS de Tailscale. Para un dominio interno de la empresa, verifica que el DNS dividido apunte al servidor DNS correcto y que el servidor sea accesible a través de tu red de Tailscale. Usa el nombre de host completo del servicio y confirma que se resuelva a una dirección IPv4.

Consulta Redes privadas para configurar la conexión.

Un entorno o sus actualizaciones no están disponibles para una tarea

Comprueba el entorno en Configuración > Codex Cloud > Entornos. Si tiene una etiqueta Sin publicar, termina la configuración y selecciona Publicar para que esté disponible para las tareas.

Para cambiar un entorno publicado, abre su flujo de Editar, deja que Codex prepare y pruebe los cambios y luego selecciona Volver a publicar. Inicia una tarea nueva desde el entorno actualizado para usar la nueva configuración. Las tareas existentes conservan su propio estado de trabajo.