Solución de problemas de AWS Cloud9 - AWS Cloud9
Installer (Instalador)Entorno de AWS Cloud9Amazon EC2Otros servicios de AWSVista previa de la aplicaciónRendimientoAplicaciones y servicios de terceros

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 de AWS Cloud9

Utilice la siguiente información para identificar y solucionar problemas con AWS Cloud9.

Si el problema no se muestra o necesita ayuda adicional, consulte el foro de discusión de AWS Cloud9. Es posible que se requiera que inicie sesión cuando ingrese en este foro. También puede ponerse en contacto con nosotros directamente.

Installer (Instalador)

La siguiente sección describe la solución de problemas relacionados con el instalador de AWS Cloud9.

El instalador de AWS Cloud9 se bloquea o falla

Problema: cuando descarga y ejecuta el instalador de AWS Cloud9, se muestran uno o más mensajes de error y el script del instalador no muestra Done.

Causa: el instalador de AWS Cloud9 ha detectado uno o más errores de los que no se puede recuperar y se produce un error como resultado.

Solución: para obtener más información, consulte Solución de problemas del instalador de AWS Cloud9. Consulte los problemas comunes, las posibles causas y las soluciones recomendadas proporcionadas.

El instalador de AWS Cloud9 no finaliza después de mostrar: “Package Cloud9 IDE 1”

Problema: AWS Cloud9 se ha instalado en su instancia de Amazon EC2 existente o en su propio servidor durante el proceso de creación de un entorno de desarrollo de SSH. La instalación se detiene cuando aparece el siguiente mensaje en el cuadro de diálogo del Instalador de AWS Cloud9: “Package Cloud9 IDE 1”. Si elige Cancelar, verá el siguiente mensaje: “Error de instalación”. Este error se produce cuando no se pueden instalar los paquetes de AWS Cloud9 en el host SSH del cliente.

Causa: un host SSH requiere que tenga instalado Node.js. Se recomienda instalar la última versión de Node.js compatible con el sistema operativo del host. Si tiene una versión de Node.js en el host que no es compatible con AWS Cloud9, es posible que se produzca un error de instalación.

Solución recomendada: instale una versión de Node.js que AWS Cloud9 admita en el host SSH.

Fallo al instalar dependencias

Problema: AWS Cloud9 necesita acceso a internet para descargar dependencias.

Causas posibles:

  • Si su entorno AWS Cloud9 utiliza un proxy para acceder a internet, AWS Cloud9 necesitará los detalles del proxy para instalar las dependencias. Si no proporcionó los detalles del proxy a AWS Cloud9, aparece este error.

  • Otra causa podría ser que su entorno no permite el tráfico saliente.

Soluciones recomendadas:

  • Para proporcionar los detalles de su proxy a AWS Cloud9, agregue el código siguiente a su archivo ~/.bashrc de entorno:

    export http_proxy=[proxy url for http]
export https_proxy=[proxy url for https]
#Certificate Authority used by your proxy
export NODE_EXTRA_CA_CERTS=[path_to_pem_certificate]

    Por ejemplo, si la URL del proxy HTTP es https://172.31.26.80:3128 y la URL del proxy HTTP es https://172.31.26.80:3129, agregue las siguientes líneas al archivo ~/.bashrc y establezca NODE_EXTRA_CA_CERTS a la ruta del archivo de una entidad de certificación en formato PEM. Para obtener más información sobre esta variable, consulte https://nodejs.org/api/cli.html#node_extra_ca_certsfile.

    export http_proxy=http://172.31.26.80:3128
export https_proxy=https://172.31.26.80:3129
export NODE_EXTRA_CA_CERTS=[path_to_pem_certificate]

  • Si utiliza una instancia de Amazon EC2 sin entrada, debe asegurarse de que se haya configurado un punto de conexión de VPC para Amazon S3. Para obtener más información al respecto, consulte Configuración de puntos de conexión de VPC de Amazon para dependencias de descarga de Amazon S3.

Error del entorno de SSH: “se precisa la versión 3 de Python para instalar pty.js”

Problema: después de abrir un entorno de desarrollo de SSH de AWS Cloud9, el terminal del IDE de AWS Cloud9 muestra un mensaje que indica que se precisa la versión 3 de Python para instalar pty.js.

Causa: para funcionar según lo previsto, el entorno de SSH necesita que la versión 3 de Python esté instalada.

Solución: instale la versión 3 de Python en el entorno. Para comprobar su versión, ejecute el comando python --version desde la terminal de servidor. Para instalar Python 3 en su servidor, consulte uno de los siguientes temas:

Entorno de AWS Cloud9

La siguiente sección describe la solución de problemas relacionados con el entorno de AWS Cloud9.

Error de creación del entorno: “No hemos podido crear las instancias de EC2...”

Problema: cuando intenta crear un entorno de desarrollo de AWS Cloud9, aparece un mensaje con la frase “No hemos podido crear las instancias de EC2 en su cuenta durante la verificación y activación de la cuenta”.

Causa: AWS está verificando y activando actualmente la Cuenta de AWS. Antes de que se complete la activación, que puede tardar hasta 24 horas, no puede crear este ni otros entornos.

Solución: vuelva a intentar crear el entorno más adelante. Si sigue recibiendo este mensaje después de 24 horas, póngase en contacto con el servicio de soporte. Además de esto, es importante saber que, incluso cuando un intento de crear un entorno produce un error, AWS CloudFormation crea una pila relacionada en la cuenta. Estas pilas cuentan para la cuota de creación de pilas de la cuenta. Para evitar agotar la cuota de creación de pilas, puede eliminar estas pilas con error. Para obtener más información, consulte Eliminación de una pila en la consola de AWS CloudFormation en la Guía del usuario de AWS CloudFormation.

Error al crear el entorno: “no dispone de autorización para sts:AssumeRole”.

Problema: al intentar crear un nuevo entorno, verá este error: "No autorizado para ejecutar sts:AssumeRole" y no se creará el entorno.

Causas posibles: no existe un rol vinculado al servicio de AWS Cloud9 en la Cuenta de AWS.

Soluciones recomendadas: crear un rol vinculado al servicio de AWS Cloud9 en la Cuenta de AWS. Puede hacerlo así mediante la ejecución del siguiente comando en la AWS Command Line Interface (AWS CLI) o el AWS CloudShell.

aws iam create-service-linked-role --aws-service-name cloud9.amazonaws.com # For the AWS CLI.
iam create-service-linked-role --aws-service-name cloud9.amazonaws.com     # For the aws-shell.

Si no puede hacerlo, consulte con el administrador de la Cuenta de AWS.

Después de ejecutar este comando, vuelva a intentar crear el entorno.

Las identidades federadas no pueden crear entornos

Problema: al tratar de utilizar una identidad federada de AWS para crear un entorno de desarrollo de AWS Cloud9 aparece un mensaje de error de acceso y no se crea el entorno.

Causa: AWS Cloud9 utiliza roles vinculados a un servicio. El rol vinculado al servicio se crea la primera vez que se crea un entorno en una cuenta utilizando la llamada iam:CreateServiceLinkedRole. Sin embargo, los usuarios federados no pueden llamar a las API de IAM. Para obtener más información, consulte GetFederationToken en la Referencia de la API de AWS Security Token Service.

Solución: pida al administrador de Cuenta de AWS que cree el rol vinculado al servicio para AWS Cloud9 en la consola de IAM o ejecutando este comando con AWS Command Line Interface (AWS CLI):

aws iam create-service-linked-role --aws-service-name cloud9.amazonaws.com

O bien este comando con AWS-shell:

iam create-service-linked-role --aws-service-name cloud9.amazonaws.com

Para obtener más información, consulte Uso de roles vinculados a servicios en la Guía del usuario de IAM.

Error de consola: “el usuario no está autorizado para realizar la acción en el recurso”

Problema: cuando intenta usar la consola de AWS Cloud9 para crear o administrar un entorno de desarrollo de AWS Cloud9, aparece un error que contiene una frase similar a "El usuario arn:aws:iam::123456789012:user/MyUser no está autorizado a realizar cloud9:action en el recurso arn:aws:cloud9:us-east-2:123456789012:environment:12a34567b8cd9012345ef67abcd890e1", donde:

  • arn:aws:iam::123456789012:user/MyUser es el nombre de recurso de Amazon (ARN) del usuario solicitante.

  • action es el nombre de la operación que el usuario solicitó.

  • arn:aws:cloud9:us-east-2:123456789012:environment:12a34567b8cd9012345ef67abcd890e1 es el ARN del entorno que el usuario solicitó para ejecutar la operación.

Causa: el usuario con el que inició sesión en la consola de AWS Cloud9 no tiene los permisos de acceso de AWS adecuados para realizar la acción.

Solución: asegúrese de que el usuario tenga los permisos de acceso de AWS adecuados y, a continuación, intente realizar la acción de nuevo. Para obtener más información, consulte los siguientes temas:

No se puede conectar a un entorno

Problema: los usuarios no se pueden conectar a un entorno y se quedan estancados en la etapa de conexión.

Causa: si cambia los permisos del archivo ~/ .ssh/authorized_keys, quita las claves de AWS Cloud9 de ese archivo o elimina el archivo por completo, es posible que se produzca este problema.

Solución: no elimine este archivo. Si lo elimina, debe volver a crear el entorno y es posible que tenga que adjuntar el Volumen de EBS de un entorno existente al nuevo entorno de EC2. Esto es para recuperar los datos perdidos. Si faltan permisos, asegúrese de que el archivo tenga los permisos Read-Write. Esto es para permitir que el daemon SSH lo lea.

No se puede abrir un entorno

Problema: al intentar abrir un entorno, el IDE no se muestra durante más de cinco minutos.

Causas posibles:

  • El usuario de IAM que ha iniciado sesión en la consola de AWS Cloud9 no tiene los permisos de acceso de AWS necesarios para abrir el entorno.

  • Si el entorno está asociado con una instancia de computación en la nube de AWS (por ejemplo, una instancia de Amazon EC2), lo posible puede ser verdadero:

    • La VPC asociada a la instancia no se establecerá en la configuración correcta para AWS Cloud9.

    • La instancia está pasando de un estado a otro o no está superando las comprobaciones de estado automatizadas cuando AWS Cloud9 intenta conectarse a la instancia.

  • Si el entorno es un entorno de SSH, la instancia de computación en la nube asociada o su propio servidor no tienen la configuración adecuada para permitir el acceso de AWS Cloud9.

Soluciones recomendadas:

No se puede abrir el entorno de AWS Cloud9: "Los colaboradores no pueden acceder a este entorno. Espere hasta que se complete la eliminación de las credenciales temporales administradas o contacte con el propietario de este entorno".

Problema: si alguien que no es el propietario del entorno agrega un nuevo colaborador a un entorno, las credenciales temporales administradas por AWS se desactivan. Las credenciales se desactivan cuando elimina el archivo ~/.aws/credentials. Mientras se elimina el archivo ~/.aws/credentials, los nuevos colaboradores no pueden acceder al entorno de AWS Cloud9.

Causa: impedir el acceso al entorno mientras las credenciales temporales administradas de AWS están siendo eliminadas es una medida de seguridad. Esto permite a los propietarios del entorno confirmar que solo los colaboradores de confianza pueden acceder a credenciales administradas. Si están convencidos de que la lista de colaboradores es válida, los propietarios del entorno pueden volver a habilitar las credenciales administradas para que puedan compartirse. Para obtener más información, consulte Control del acceso a las credenciales temporales administradas por AWS.

Soluciones recomendadas: espere a que se complete la eliminación del archivo ~/.aws/credentials antes de volver a intentar abrir el entorno de AWS Cloud9. El tiempo máximo de espera para la caducidad de las credenciales es de 15 minutos. También puede solicitar al propietario del entorno que vuelva a habilitar o desactive las credenciales temporales administradas. Después de volver a habilitar o desactivar las credenciales, los colaboradores pueden acceder inmediatamente al entorno. Al alternar el estado de las credenciales administradas entre ENABLED (HABILITADAS) y DISABLED (DESHABILITADAS), el propietario del entorno garantiza que las credenciales no permanezcan en un estado intermedio. Un estado intermedio puede impedir que los colaboradores accedan al entorno.

nota

Supongamos que el propietario del entorno y el colaborador pertenecen a la misma Cuenta de AWS. A continuación, el colaborador puede identificar al propietario del entorno para establecer contacto revisando la tarjeta de un entorno en la página Your environments (Sus entornos) en la consola. El propietario del entorno también se muestra en la página Environment details (Detalles del entorno).

Error de eliminación del entorno: “No se pudieron eliminar uno o más entornos”

Problema: cuando intenta eliminar uno o más entornos en la consola de AWS Cloud9, aparece un mensaje que indica que no se pudieron eliminar uno o más entornos y al menos uno de los entornos no se ha eliminado.

Causa posible: es posible que AWS CloudFormation tenga un problema al eliminar uno o más entornos. AWS Cloud9 depende de AWS CloudFormation para crear y eliminar entornos.

Solución recomendada: pruebe a usar AWS CloudFormation para eliminar cada uno de los entornos no eliminados.

  1. Abra la consola de AWS CloudFormation en https://console.aws.amazon.com/cloudformation.

  2. En la barra de navegación de AWS, elija la Región de AWS del entorno.

  3. En la lista de pilas de AWS CloudFormation, seleccione la entrada donde Stack name (Nombre de pila) contiene el nombre del entorno no borrado y Status (Estado) es DELETE_FAILED (ERROR_ELIMINACIÓN). Por ejemplo, si el nombre del entorno es my-demo-environment, elija la pila que comienza con el nombre aws-cloud9-my-demo-environment. (Elija la casilla u opción junto al nombre del entorno, no el propio nombre del entorno).

  4. Elija Actions, Delete Stack (Acciones, Eliminar pila).

  5. Si se le pregunte, elija Yes, Delete (Sí, eliminar).

Este proceso de eliminación de una pila puede tardar unos minutos.

Si la pila desaparece de la lista, el entorno se ha eliminado.

Si la pila sigue mostrando DELETE_FAILED (ERROR_ELIMINACIÓN) después de unos minutos, el entorno sigue sin eliminarse. Puede intentar eliminar manualmente cada uno de los recursos de la pila con error.

nota

La eliminación manual de recursos de la pila con error no elimina la pila en sí de su Cuenta de AWS.

Para eliminar estos recursos manualmente, haga lo siguiente. En la consola de AWS CloudFormation, elija la pila en la que se ha producido el error y, a continuación, seleccione la sección Resources (Recursos). Vaya a la consola en AWS para cada recurso en esta lista y, a continuación, utilice dicha consola para eliminar el recurso.

Cambiar el tiempo de espera de un entorno en el IDE de AWS Cloud9

Problema: los usuarios desean actualizar el tiempo de espera de los entornos de Amazon EC2.

Causa: el tiempo de espera predeterminado es de 30 minutos. Puede que sea demasiado corto para algunos usuarios.

Solución recomendada:

  1. Abra el entorno que desea configurar.

  2. En el IDE de AWS Cloud9, en la barra de menús, elija AWS Cloud9 Preferencias.

  3. En la ventana de Preferencias, desplácese hasta la sección de Instancia de Amazon EC2.

  4. Seleccione el valor de tiempo de espera de la lista disponible y actualícelo.

Error al ejecutar aplicaciones SAM localmente en AWS Toolkit porque el entorno de AWS Cloud9 no tiene suficiente espacio en disco

Problema: se produce un error cuando se utiliza AWS Toolkit para ejecutar comandos de la CLI de AWS SAM para aplicaciones definidas por plantillas SAM.

Posibles causas: al ejecutar y depurar aplicaciones sin servidor de forma local con el kit de herramientas de AWS, AWS SAM utiliza imágenes de Docker. Estas imágenes proporcionan un entorno en tiempo de ejecución y herramientas de compilación que emulan el entorno de Lambda en el que tiene previsto realizar la implementación.

Sin embargo, si el entorno carece de suficiente espacio en disco, la imagen de Docker que proporciona estas características no puede compilarse y la aplicación SAM local no se puede ejecutar. Si esto ocurre, es posible que reciba un error en la pestaña Output (Salida) similar a la siguiente.

Error: Could not find amazon/aws-sam-cli-emulation-image-python3.7:rapid-1.18.1 image locally and failed to pull it from docker.

Este error se relaciona con una aplicación SAM creada con el tiempo de ejecución de Python. Es posible que reciba un mensaje ligeramente diferente, dependiendo del tiempo de ejecución que eligió para la aplicación.

Soluciones recomendadas: libere espacio en disco en su entorno para que la imagen de Docker pueda compilarse. Elimine las imágenes de Docker no utilizadas ejecutando el siguiente comando en el terminal del IDE.

docker image prune -a

Si tiene problemas repetidamente con los comandos de la CLI de SAM debido a restricciones de espacio en disco, cambie a un entorno de desarrollo que utilice un tipo de instancias diferente.

(Volver arriba)

No se puede cargar el IDE con versiones anteriores del navegador Microsoft Edge

Problema: se devuelve el error HTTP403: FORBIDDEN al intentar cargar el IDE de AWS Cloud9 mediante el navegador web Microsoft Edge.

Causas posibles: el IDE de AWS Cloud9 no admite ciertas versiones anteriores de Microsoft Edge.

Soluciones recomendadas: para actualizar el navegador, elija el botón de puntos suspensivos (...) en la barra de herramientas de Microsoft Edge. En el menú, elija Settings (Configuración) y, a continuación, About Microsoft Edge (Acerca de Microsoft Edge). Si se requiere una actualización, esta se descarga e instala automáticamente.

(Volver arriba)

No se puede crear la estructura de subcarpetas /home/ec2-user/environment/home/ec2-user/environment en el explorador de archivos del IDE de AWS Cloud9.

Problema: al crear la estructura de subcarpetas /home/ec2-user/environment/home/ec2-user/environment en el explorador de archivos del IDE de AWS Cloud9, aparece un mensaje de error que indica que no es posible abrir este directorio.

Posibles causas: actualmente no es posible crear una estructura de subcarpetas /home/ec2-user/environment dentro de una carpeta del mismo nombre mediante el sistema de archivos del IDE de AWS Cloud9. No podrá acceder a ningún archivo de este directorio desde el explorador de archivos del IDE de AWS Cloud9, pero podrá acceder a ellos mediante la línea de comandos. Este problema solo afecta a la ruta de archivos /home/ec2-user/environment/home/ec2-user/environment. Las rutas de archivos como /test/home/ec2-user/environment y /home/ec2-user/environment/test deberían funcionar. Es un error conocido que solo afecta al explorador de archivos del IDE de AWS Cloud9.

Soluciones recomendadas: utilice otro nombre y estructura de archivos.

(Volver arriba)

No se puede crear la estructura de subcarpetas /projects/projects en el explorador de archivos del IDE de AWS Cloud9 para CodeCatalyst.

Problema: al crear la estructura de subcarpetas /projects/projects en el explorador de archivos del IDE de AWS Cloud9 de CodeCatalyst, aparece un mensaje de error que indica que no es posible abrir este directorio.

Posibles causas: actualmente no es posible crear una estructura de subcarpetas /projects dentro de una carpeta del mismo nombre mediante el explorador de archivos del IDE de AWS Cloud9 para CodeCatalyst. No podrá acceder a ningún archivo de este directorio desde el explorador de archivos del IDE de AWS Cloud9, pero podrá acceder a ellos mediante la línea de comandos. Este problema solo afecta a la ruta de archivos /projects/projects, las rutas de archivos como /test/projects y /projects/test deberían funcionar. Es un error conocido que solo afecta al explorador de archivos del IDE de AWS Cloud9 para CodeCatalyst.

Soluciones recomendadas: utilice otro nombre y estructura de archivos.

(Volver arriba)

No se puede interactuar con la ventana de terminal en AWS Cloud9 debido a errores de sesión de tmux

Problema: Cuando intenta lanzar una nueva ventana de terminal en AWS Cloud9, la interfaz de línea de comandos esperada no está disponible. No hay símbolo del sistema y no puede ingresar texto. Se devuelven mensajes de error como tmux: need UTF-8 locale (LC_CTYPE) y invalid LC_ALL, LC_CTYPE or LANG.

Posibles causas: un terminal que no responde puede deberse a un error de tmux. AWS Cloud9 emplea la utilidad tmux. De esta forma, la información que se muestra en el terminal persiste incluso cuando la página se recarga o se reconecta al entorno de desarrollo.

En una sesión tmux, lo que se muestra en la ventana del terminal lo administra un cliente. El cliente se comunica con un servidor que puede administrar varias sesiones. El servidor y el cliente se comunican a través de un socket ubicado en la carpeta tmp. Si la carpeta tmp falta en el entorno de desarrollo o se le aplican permisos demasiado restrictivos, las sesiones tmux no pueden ejecutarse. Si esto ocurre, la ventana de terminal del IDE deja de responder.

Soluciones recomendadas: si los errores de tmux le impiden interactuar con la ventana de terminal, use una forma alternativa para crear una carpeta tmp con los permisos adecuados. De esa manera, se pueden ejecutar sesiones tmux. Una solución consiste en exportar LC_CTYPE en .bash_profile o en el archivo .bashrc. Otra solución que se recomienda es usar AWS Systems Manager para establecer una configuración de administración de host. Esto permite el acceso a la instancia correspondiente a través de la consola de Amazon EC2.

Configuración de la administración de host

  1. En primer lugar, en la consola de AWS Cloud9, busque el nombre de la instancia del entorno. Para realizar la prueba, puede elegir el panel correspondiente en la página Your environments (Sus entornos) y elegir View details (Ver detalles). En la página de Environment details (Detalles del Entorno), elija Go to Instance (Ir a la Instancia). En la consola de Amazon EC2, confirme el nombre de la instancia a la que necesita acceder.

  2. Ahora vaya a la consola AWS Systems Manager, y en el panel de navegación, elija Quick Setup (Configuración Rápida).

  3. En la página de Quick Setup (Configuración Rápida), elija Create (Crear).

  4. Para los tipos de configuración, vaya a Host Management (Administración de hosts) y elija Create (Crear).

  5. Para personalizar las opciones de configuración de Host Management, en la sección Targets (Objetivos), elija Manual.

  6. Seleccione la instancia de EC2 a la que desea acceder y, a continuación, elija Create (Crear).

Conexión a la instancia y ejecución de comandos

nota

Los pasos que se indican a continuación corresponden a la nueva consola de EC2.

  1. En el panel de navegación de la consola de Amazon EC2, elija Instances (Instancias) y seleccione la instancia a la que desea conectarse.

  2. Elija Conectar.

    Si Connect (Conectar) no está activado, es posible que tenga que iniciar la instancia en primer lugar.

  3. En el panel Connect to your instance (Conectar con la instancia), en Connection method (Método de conexión), elija Session Manager (Administrador de sesiones) y luego elija Connect (Conectar).

  4. En la ventana de sesión de terminal que se muestra, escriba los siguientes comandos. Estos comandos crean la carpeta tmp con los permisos correctos para que el socket tmux esté disponible.

    sudo mkdir /tmp
sudo chmod 777 /tmp
sudo rmdir /tmp/tmux-*

(Volver arriba)

Amazon EC2

La siguiente sección describe la solución de problemas relacionados con el instalador de Amazon EC2.

Las instancias de Amazon EC2 no se actualizan automáticamente

Problema: las últimas actualizaciones del sistema no se aplican automáticamente a una instancia de Amazon EC2 que se conecta a un entorno de desarrollo de AWS Cloud9.

Causa: la aplicación automática de las últimas actualizaciones del sistema podría hacer que el código o la instancia de Amazon EC2 se comporten de forma imprevista, sin su conocimiento previo o sin su aprobación.

Soluciones recomendadas:

Aplique actualizaciones del sistema a la instancia de Amazon EC2 de forma periódica siguiendo las instrucciones de Actualización del software de instancia en la Guía del usuario de Amazon EC2 para instancias de Linux.

Para ejecutar comandos en la instancia, puede utilizar una sesión del terminal en el IDE de AWS Cloud9 desde el entorno que está conectado a la instancia.

También puede usar una utilidad de acceso remoto SSH como ssh o PuTTY para conectarse a la instancia. Para ello, desde el equipo local, emplee una utilidad de creación de pares de claves SSH, como ssh-keygen o PuTTYgen. Utilice el IDE de AWS Cloud9 desde el entorno que está conectado a la instancia para almacenar la clave pública generada en la instancia. A continuación, sírvase de la utilidad de acceso remoto SSH junto con la clave privada generada para obtener acceso a la instancia. Consulte la documentación de su utilidad para obtener más información.

Error de AWS CLI o AWS-shell: "el token de seguridad incluido en la solicitud no es válido" en un entorno de EC2

Problema: al tratar de utilizar AWS Command Line Interface (AWS CLI) o AWS-shell para ejecutar un comando en el IDE de AWS Cloud9 para un entorno de EC2, aparece un mensaje de error que indica que el token de seguridad incluido en la solicitud no es válido.

Causa: puede generarse un token de seguridad no válido si tiene las credenciales temporales administradas por AWS habilitadas y se ha producido una de las siguientes situaciones:

  • Intentó ejecutar un comando que las credenciales temporales administradas por AWS no permiten. Para ver una lista de comandos permitidos, consulte Acciones compatibles con las credenciales temporales AWS administradas.

  • Las credenciales temporales administradas por AWS caducan automáticamente después de 15 minutos.

  • Las credenciales temporales administradas por AWS para un entorno compartido estaban desactivadas porque alguien distinto del propietario del entorno agregó un nuevo miembro.

Soluciones recomendadas:

  • Ejecute solo aquellos comandos permitidos por las credenciales temporales administradas de AWS. Si necesita ejecutar un comando que no permiten las credenciales temporales administradas por AWS, configure AWS CLI o AWS-shell en el entorno con un conjunto de credenciales permanentes. Esto elimina esta limitación. Para obtener más información, consulte Crear y almacenar las credenciales de acceso permanente en un entorno.

  • Para credenciales desactivadas o caducadas, asegúrese de que el propietario del entorno abra el entorno de modo que AWS Cloud9 pueda actualizar las credenciales temporales en el entorno. Para obtener más información, consulte Control del acceso a las credenciales temporales administradas por AWS.

No se puede conectar al entorno de EC2 porque Docker utiliza las direcciones IP de VPC

Problema: para un entorno de EC2, si lanza la instancia EC2 en una VPC de Amazon que utiliza el bloque de enrutamiento entre dominios sin clases (CIDR) de IPv4 172.17.0.0/16, es posible que la conexión se pueda detener cuando intente abrir ese entorno.

Causa: Docker utiliza un dispositivo de capa de enlace denominado red de puente que permite que los contenedores conectados a la misma red de puente se comuniquen. AWS Cloud9 crea contenedores que utilizan un puente predeterminado para la comunicación de contenedores. 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. Por tanto, si AWS Cloud9 intenta conectarse a la instancia, la tabla de enrutamiento de puerta de enlace enruta esa conexión al puente de Docker. Esto evita que AWS Cloud9 se conecte a la instancia de EC2 que respalda el entorno de desarrollo.

Solución recomendada: para resolver un conflicto de dirección IP que se produce porque Amazon VPC y Docker utilizan el mismo bloque de CIDR de direcciones IPv4, configure una nueva VPC para la instancia que respalda el entorno de EC2. Para esta nueva VPC, configure un bloque de CIDR que sea diferente de 172.17.0.0/16. (No puede cambiar el rango de direcciones IP de una VPC o subred existente).

Para obtener información sobre la configuración, consulte Tamaño de VPC y subred en la Guía del usuario de Amazon VPC.

No se puede crear la estructura de subcarpetas /home/ec2-user/environment/home/ec2-user/environment en el explorador de archivos del IDE de AWS Cloud9.

Problema: al crear la estructura de subcarpetas /home/ec2-user/environment/home/ec2-user/environment en el explorador de archivos del IDE de AWS Cloud9, aparece un mensaje de error que indica que no es posible abrir este directorio.

Posibles causas: actualmente no es posible crear una estructura de subcarpetas /home/ec2-user/environment dentro de una carpeta del mismo nombre mediante el sistema de archivos del IDE de AWS Cloud9. No podrá acceder a ningún archivo de este directorio desde el explorador de archivos del IDE de AWS Cloud9, pero podrá acceder a ellos mediante la línea de comandos. Este problema solo afecta a la ruta de archivos /home/ec2-user/environment/home/ec2-user/environment. Las rutas de archivos como /test/home/ec2-user/environment y /home/ec2-user/environment/test deberían funcionar. Es un error conocido que solo afecta al explorador de archivos del IDE de AWS Cloud9.

Soluciones recomendadas: utilice otro nombre y estructura de archivos.

No se puede lanzar AWS Cloud9 desde la consola cuando una configuración de licencias de AWS License Manager está asociada a instancias de Amazon EC2

Problema: cuando intenta lanzar un entorno de EC2 de AWS Cloud9 desde la consola, se devuelve un mensaje de error unable to access your environment.

Causas posibles: AWS License Manager agiliza la administración de licencias de proveedores de software en toda Nube de AWS. Al configurar License Manager, puede crear configuraciones de licencias, que son conjuntos de reglas de asignación de licencias que se basan en los términos de los contratos de su empresa. Estas configuraciones de licencias se pueden conectar a un mecanismo, como una imagen de máquina de Amazon (AMI) o AWS CloudFormation. Puede utilizar uno de estos mecanismos para lanzar instancias EC2.

Las versiones anteriores de AWSCloud9ServiceRolePolicy para el rol vinculado a servicios (SLR) de AWSServiceRoleForAWSCloud9 no incluyen actualmente la condición de recurso license-configuration. Debido a esto, AWS Cloud9 no tiene permitido iniciar y detener su instancia. Por lo tanto, se le niega el acceso a AWS Cloud9 a su instancia de Amazon EC2 y se devuelve un error.

Soluciones recomendadas: si no puede acceder a un entorno de AWS Cloud9 existente y usa License Manager, reemplace el rol vinculado a servicios AWSCloud9ServiceRolePolicy por la versión del SLR que permita explícitamente acciones de EC2 cuando se aplique license-configuration a la instancia. Para reemplazar el rol antiguo, elimínelo. A continuación, se crea el rol actualizado de forma automática.

No se pueden ejecutar algunos comandos o scripts en un entorno de EC2

Problema: después de abrir un entorno de desarrollo de EC2 de AWS Cloud9, no se pueden instalar algunos tipos de paquetes, ejecutar comandos, como yum o apt, ni ejecutar scripts que contienen comandos que suelen funcionar con otros sistemas operativos Linux.

Causa: las instancias de Amazon EC2 que AWS Cloud9 utiliza para un entorno de EC2 dependen de Amazon Linux (que se basa en Red Hat Enterprise Linux [RHEL]) o Ubuntu Server.

Solución: si instala o administra paquetes o ejecuta comandos o scripts en el IDE de un entorno de EC2, asegúrese de que son compatibles con RHEL (para Amazon Linux) o Ubuntu Server, en función de la instancia para ese entorno.

Mensaje de error que notifica que el perfil de instancias AWSCloud9SSminStanceProfile no existe en la cuenta al crear un entorno de EC2 mediante AWS CloudFormation

Problema: si utiliza el recurso AWS::Cloud9::EnvironmentEC2 de AWS CloudFormation para crear un entorno de EC2, los usuarios reciben un mensaje de error similar a El perfil de instancias AWSCloud9SSmInstanceProfile no existe en la cuenta.

Causa: al crear un entorno de EC2 sin entrada, debe crear la función de servicio AWSCloud9SSMAccessRole y el perfil de instancias AWSCloud9SSMInstanceProfile. Estos recursos de IAM permiten a Systems Manager administrar la instancia de EC2 que respalda su entorno de desarrollo.

Si crea un entorno sin entrada con la consola, AWSCloud9SSMAccessRole y AWSCloud9SSMInstanceProfile se crean automáticamente. No obstante, si utiliza AWS CloudFormation o AWS CLI para crear su primer entorno sin entrada, debe crear estos recursos de IAM manualmente.

Solución recomendada: para obtener información sobre cómo editar la plantilla de AWS CloudFormation y actualizar los permisos de IAM, consulte Uso de AWS CloudFormation para crear entornos de EC2 sin entrada

Mensaje de error que indica que no tiene autorización para perform: ssm:StartSession en el recurso al crear un entorno de EC2 mediante AWS CloudFormation

Problema: si utiliza el recurso AWS::Cloud9::EnvironmentEC2 de AWS CloudFormation para crear un entorno de EC2, los usuarios reciben AccessDeniedException y se les informa de que "no tienen autorización para ejecutar: ssm:StartSession en el recurso".

Causa: el usuario carece del permiso para llamar a la API de StartSession que se requiere como parte de la configuración para los entornos de EC2 que utilizan Systems Manager para las instancias sin entrada.

Solución recomendada: para obtener información sobre cómo editar la plantilla de AWS CloudFormation y actualizar los permisos de IAM, consulte Uso de AWS CloudFormation para crear entornos de EC2 sin entrada.

Mensaje de error que indica que no tiene autorización “para ejecutar: iam:GetInstanceProfile en el recurso: perfil de instancias AWSCloud9SSMInstanceProfile” al crear un entorno de EC2 mediante AWS CLI

Problema: cuando se utiliza la AWS CLI para crear un entorno de EC2, los usuarios reciben AccessDeniedException y se les informa de que su entorno de AWS Cloud9 no está autorizado "para ejecutar iam:GetInstanceProfile en el recurso: perfil de instancias AWSCloud9SSMInstanceProfile".

Causa: AWS Cloud9 carece del permiso para llamar a la API de StartSession que se requiere como parte de la configuración para los entornos de EC2 que utilizan Systems Manager para las instancias sin entrada.

Solución recomendada: para obtener información sobre cómo agregar el rol de servicio AWSCloud9SSMAccessRole requerido y AWSCloud9SSMInstanceProfile al entorno de AWS Cloud9, consulte Administrar perfiles de instancias para Systems Manager con AWS CLI.

Error al crear un entorno cuando se aplica el cifrado predeterminado a volúmenes de Amazon EBS

Problema: se devuelve el error Failed to create environments. The development environment '[environment-ID]' failed to create al intentar crear un entorno de Amazon EC2.

Causas posibles: si el IDE de AWS Cloud9 utiliza volúmenes de Amazon EBS cifrados de forma predeterminada, el rol vinculado al servicio de AWS Identity and Access Management para AWS Cloud9 requiere acceso a las AWS KMS keys para estos volúmenes de EBS. Si no se proporciona acceso, es posible que el IDE de AWS Cloud9 produzca un error al lanzarse y sea difícil depurar el problema.

Soluciones recomendadas: para proporcionar acceso, agregue el rol vinculado al servicio para AWS Cloud9, AWSServiceRoleForAWSCloud9, a la clave administrada por el cliente que utilizan sus volúmenes de Amazon EBS.

Para obtener más información sobre esta tarea, consulte Crear un AWS Cloud9 que utiliza volúmenes de Amazon EBS con cifrado predeterminado en Patrones de orientación prescriptiva de AWS.

Error de VPC para cuentas de EC2-Classic: “No se puede acceder a su entorno”

Problema: EC2-Classic se introdujo en la versión original de Amazon EC2. Si utiliza una Cuenta de AWS que se configuró antes del 4 de diciembre de 2013, es posible que este error se produzca si no configura una VPC y una subred de Amazon al crear un entorno de desarrollo de EC2 de AWS Cloud9.

Si acepta la configuración predeterminada de VPC, la instancia de Amazon EC2 se lanza en la red EC2-Classic. La instancia no se lanza en una subred de la VPC predeterminada. El siguiente mensaje se muestra cuando el entorno produce un error para crear:

Error de entorno

No se puede acceder a su entorno

Error al crear el entorno: error al crear los siguientes recursos: [Instancia]. . Restauración solicitada por el usuario.

Puede confirmar que el error se debe a que la instancia de EC2 no se encuentra en la VPC predeterminada. Utilice AWS CloudFormation para consultar el historial de eventos de pila para el entorno de desarrollo.

  1. Abra la consola de AWS CloudFormation. Para obtener más información, consulte Registro en la consola de AWS CloudFormation.

  2. En la consola de AWS CloudFormation, elija Pilas.

  3. En la página Pilas, elija el nombre del entorno de desarrollo que no se pudo crear.

  4. En la página Stack details (Detalles de la pila), elija la pestaña Events (Eventos) y verifique la siguiente entrada:

    Estado: CREATE_FAILED

    Motivo del estado: el parámetro AssociatePublicIpAddress solo es compatible con los lanzamientos de la VPC. [...]

Causa: un entorno de desarrollo de AWS Cloud9 debe asociarse a una instancia de Amazon VPC que cumpla con los requisitos de VPC específicos. Para cuentas con EC2-Classic habilitado, aceptar la configuración de red predeterminada al crear un entorno de EC2 significa que la instancia de EC2 requerida no se ha lanzado en la VPC. En su lugar, la instancia se ha lanzado en la red EC2-Classic.

Solución recomendada: con una cuenta de EC2-Classic, debe seleccionar una VPC y una subred al crear un entorno de EC2. En la página Configurar ajustes, en la sección Configuración de red (avanzada), seleccione la VPC y la subred en la que puede lanzar la instancia de EC2.

Otros servicios de AWS

La siguiente sección describe la solución de problemas relacionados con otros servicios de AWS.

No se puede crear la estructura de subcarpetas /projects/projects en el explorador de archivos del IDE de AWS Cloud9 para CodeCatalyst.

Problema: al crear la estructura de subcarpetas /projects/projects en el explorador de archivos del IDE de AWS Cloud9 de CodeCatalyst, aparece un mensaje de error que indica que no es posible abrir este directorio.

Posibles causas: actualmente no es posible crear una estructura de subcarpetas /projects dentro de una carpeta del mismo nombre mediante el explorador de archivos del IDE de AWS Cloud9 para CodeCatalyst. No podrá acceder a ningún archivo de este directorio desde el explorador de archivos del IDE de AWS Cloud9, pero podrá acceder a ellos mediante la línea de comandos. Este problema solo afecta a la ruta de archivos /projects/projects, las rutas de archivos como /test/projects y /projects/test deberían funcionar. Es un error conocido que solo afecta al explorador de archivos del IDE de AWS Cloud9 para CodeCatalyst.

Soluciones recomendadas: utilice otro nombre y estructura de archivos.

No se puede mostrar la aplicación en ejecución fuera del IDE

Problema: cuando usted u otros usuarios intentan mostrar la aplicación en ejecución en una pestaña del navegador web fuera del IDE, la pestaña de este navegador web muestra un mensaje de error o aparece en blanco.

Causas posibles:

  • La aplicación no se está ejecutando en el IDE.

  • La aplicación se está ejecutando con una dirección IP distinta de 127.0.0.1 o localhost.

  • La aplicación se ejecuta en un entorno de desarrollo de AWS Cloud9 EC2. Además, uno o varios grupos de seguridad que están asociados a la instancia de Amazon EC2 correspondiente no permiten el tráfico de entrada a través de los protocolos, los puertos o las direcciones IP que necesita la aplicación.

  • La aplicación se ejecuta en un entorno de desarrollo de AWS Cloud9 SSH para una instancia de computación en la nube de AWS (por ejemplo, una instancia de Amazon EC2). Además, la ACL de red de la subred en la nube privada virtual (VPC) que está asociada a la correspondiente instancia no permite el tráfico de entrada a través de los protocolos, los puertos o las direcciones IP que necesita la aplicación.

  • La URL es incorrecta.

  • Se solicita la URL en la pestaña de vista previa de la aplicación en lugar de la dirección IP pública de la instancia.

  • Está intentando ir a una dirección que contiene una IP de 127.0.0.1 o localhost. Estas direcciones IP intentan acceder a los recursos del equipo local en lugar de a los recursos del entorno.

  • Ha cambiado la dirección IP pública de la instancia.

  • La solicitud web proviene de una red privada virtual (VPN) que bloquea el tráfico a través de los protocolos, los puertos o las direcciones IP que la aplicación necesita.

  • La aplicación se ejecuta en un entorno de SSH. Sin embargo, el servidor o la red asociada no permiten el tráfico a través de los protocolos, los puertos o las direcciones IP que la aplicación necesita.

Soluciones recomendadas:

  • Asegúrese de que la aplicación se está ejecutando en el IDE.

  • Asegúrese de que la aplicación no se está ejecutando con una dirección IP 127.0.0.1 o localhost. Para ver algunos ejemplos en Node.js y Python, consulte Ejecutar una aplicación.

  • Supongamos que la aplicación se está ejecutando en una instancia de computación en la nube de AWS (por ejemplo, una instancia de Amazon EC2). A continuación, asegúrese de que todos los grupos de seguridad que están asociados a la instancia correspondiente permiten el tráfico de entrada a través de los protocolos, los puertos y las direcciones IP que necesita la aplicación. Para obtener instrucciones, consulte Paso 2: configurar el grupo de seguridad para la instancia en Compartir una aplicación en ejecución a través de internet. Consulte también Grupos de seguridad de su VPC en la Guía del usuario de Amazon VPC.

  • Supongamos que la aplicación se está ejecutando en una instancia de computación en la nube de AWS. Además, existe una ACL de red para la subred de la VPC que está asociada a la instancia correspondiente. A continuación, asegúrese de que la ACL de red permite el tráfico entrante a través de los protocolos, los puertos y las direcciones IP que la aplicación necesita. Para obtener instrucciones, consulte Paso 3: configurar la subred para la instancia en Compartir una aplicación en ejecución a través de internet. Consulte también ACL de red en la Guía del usuario de Amazon VPC.

  • Asegúrese de que la URL de solicitud, incluido el protocolo (y el puerto, si debe especificarse) es correcta. Para obtener más información, consulte Paso 4: Compartir la URL de la aplicación en ejecución en Compartir una aplicación en ejecución a través de internet.

  • No se recomienda solicitar una URL con el formato https://12a34567b8cd9012345ef67abcd890e1.vfs.cloud9.us-east-2.amazonaws.com/ (donde 12a34567b8cd9012345ef67abcd890e1 es el ID que AWS Cloud9 asigna al entorno y us-east-2 es el ID de la región de AWS del entorno). Esta URL solo funciona cuando el IDE del entorno está abierto y la aplicación se está ejecutando en el mismo navegador web.

  • Suponga que intenta ir a una dirección que contiene una IP de 127.0.0.1 o localhost. En su lugar, intente ir a la dirección no local correcta para la aplicación en ejecución. Para obtener más información, consulte Compartir una aplicación en ejecución a través de internet.

  • Supongamos que la aplicación se está ejecutando en una instancia de computación en la nube de AWS. Determine si ha cambiado la dirección IP pública de la instancia. La dirección IP pública de la instancia podría cambiar en cualquier momento que la instancia se reinicie. Para evitar que cambie esta dirección IP, puede asignar una dirección IP elástica y asignarla a la instancia en ejecución. Para obtener más información, consulte Paso 4: Compartir la URL de la aplicación en ejecución en Compartir una aplicación en ejecución a través de internet.

  • Si la solicitud web proviene de una VPN, asegúrese de que la VPN permite el tráfico a través de los protocolos, los puertos y las direcciones IP que la aplicación necesita. Si no puede realizar cambios en la VPN, consulte con el administrador de red. Otra opción es realizar la solicitud web desde otra red, si es posible.

  • Supongamos que la aplicación se está ejecutando en un entorno de SSH para el servidor propio. Asegúrese de que el servidor y la red asociada permiten el tráfico a través de los protocolos, los puertos y las direcciones IP que la aplicación necesita. Si no puede realizar cambios en el servidor o la red asociada, consulte con el administrador del servidor o de red.

  • Intente ejecutar la aplicación desde un terminal en el entorno ejecutando el comando curl, seguido de la URL. Si este comando muestra un mensaje de error, es posible que haya algún otro problema que no está relacionado con AWS Cloud9.

Error al ejecutar AWS Toolkit, que indica que el entorno se está quedando sin inodes y que se debe aumentar el límite de “fs.inotify.max_user_watches”.

Problema: una utilidad de monitor de archivos que AWS Toolkit utiliza se acerca al límite o cuota actual de archivos que puede ver.

Causa: AWS Toolkit utiliza una utilidad de monitor de archivos que monitorea los cambios en archivos y directorios. Cuando la utilidad está casi en la cuota actual de archivos que puede ver, aparece un mensaje de advertencia.

Solución recomendada: para aumentar el número máximo de archivos que puede administrar el monitor de archivos, haga lo siguiente:

  1. Inicie una sesión de terminal con las opciones Window (Ventana), New Terminal (Nuevo terminal) en la barra de menús.

  2. Escriba el siguiente comando.

    sudo bash -c 'echo "fs.inotify.max_user_watches=524288" >> /etc/sysctl.conf' && sudo sysctl -p

Error de ejecución de la función local Lambda: no se puede instalar SAM Local

Problema: tras intentar ejecutar la versión local de una función de AWS Lambda en el IDE de AWS Cloud9, se muestra un cuadro de diálogo. El cuadro de diálogo indica que AWS Cloud9 tiene problemas para instalar SAM Local. AWS Cloud9 necesita que SAM Local ejecute versiones locales de funciones AWS Lambda en el IDE. Hasta que no se instala SAM Local, no se pueden ejecutar las versiones locales de las funciones Lambda en el IDE.

Causa: AWS Cloud9 no encuentra SAM Local en la ruta prevista en el entorno, que es ~/.c9/bin/sam. Esto se debe a que SAM Local no está instalado aún o, si lo está, AWS Cloud9 no lo encuentra en dicha ubicación.

Soluciones recomendadas: Puede esperar a que AWS Cloud9 intente finalizar la instalación de SAM Local o puede instalarlo usted mismo.

Para ver el progreso de AWS Cloud9 mientras intenta instalar SAM Local, seleccione Window, Installer (Ventana, Instalador) en la barra de menús.

Para instalar SAM Local usted mismo, siga las instrucciones en Instalación de AWS SAM CLI en Linux en la Guía para desarrolladores de AWS Serverless Application Model.

Error AWS Control Tower al intentar crear un entorno Amazon EC2 usando AWS Cloud9: «La creación del entorno falló con el error: fallaron los siguientes enlaces: [ControlTower::Guard::Hook]».

Problema: hay un problema de compatibilidad con AWS Cloud9 y el control proactivo AWS Control Tower CT.EC2.PR.8. Si este control está activado, no podrá crear un entorno EC2 en AWS Cloud9.

Causa: AWS Control Tower espera que el parámetro AssociatePublicipAddress esté en la plantilla AWS CloudFormation. No se puede añadir este parámetro en este momento.

Solución recomendada: desactive el control CT.EC2.PR.8 de la consola AWS Control Tower y vuelva a crear el entorno en AWS Cloud9.

Error al crear un entorno cuando se aplica el cifrado predeterminado a volúmenes de Amazon EBS

Problema: se devuelve el error Failed to create environments. The development environment '[environment-ID]' failed to create al intentar crear un entorno de Amazon EC2.

Causas posibles: si el IDE de AWS Cloud9 utiliza volúmenes de Amazon EBS cifrados de forma predeterminada, el rol vinculado al servicio de AWS Identity and Access Management para AWS Cloud9 requiere acceso a las AWS KMS keys para estos volúmenes de EBS. Si no se proporciona acceso, es posible que el IDE de AWS Cloud9 produzca un error al lanzarse y sea difícil depurar el problema.

Soluciones recomendadas: para proporcionar acceso, agregue el rol vinculado al servicio para AWS Cloud9, AWSServiceRoleForAWSCloud9, a la clave administrada por el cliente que utilizan sus volúmenes de Amazon EBS.

Para obtener más información sobre esta tarea, consulte Crear un AWS Cloud9 que utiliza volúmenes de Amazon EBS con cifrado predeterminado en Patrones de orientación prescriptiva de AWS.

(Volver arriba)

No se puede lanzar AWS Cloud9 desde la consola cuando una configuración de licencias de AWS License Manager está asociada a instancias de Amazon EC2

Problema: cuando intenta lanzar un entorno de EC2 de AWS Cloud9 desde la consola, se devuelve un mensaje de error unable to access your environment.

Causas posibles: AWS License Manager agiliza la administración de licencias de proveedores de software en toda Nube de AWS. Al configurar License Manager, puede crear configuraciones de licencias, que son conjuntos de reglas de asignación de licencias que se basan en los términos de los contratos de su empresa. Estas configuraciones de licencias se pueden conectar a un mecanismo, como una imagen de máquina de Amazon (AMI) o AWS CloudFormation. Puede utilizar uno de estos mecanismos para lanzar instancias EC2.

Las versiones anteriores de AWSCloud9ServiceRolePolicy para el rol vinculado a servicios (SLR) de AWSServiceRoleForAWSCloud9 no incluyen actualmente la condición de recurso license-configuration. Debido a esto, AWS Cloud9 no tiene permitido iniciar y detener su instancia. Por lo tanto, se le niega el acceso a AWS Cloud9 a su instancia de Amazon EC2 y se devuelve un error.

Soluciones recomendadas: si no puede acceder a un entorno de AWS Cloud9 existente y usa License Manager, reemplace el rol vinculado a servicios AWSCloud9ServiceRolePolicy por la versión del SLR que permita explícitamente acciones de EC2 cuando se aplique license-configuration a la instancia. Para reemplazar el rol antiguo, elimínelo. A continuación, se crea el rol actualizado de forma automática.

(Volver arriba)

Vista previa de la aplicación

La siguiente sección describe la solución de problemas relacionados con la vista previa de la aplicación.

Después de volver a cargar un entorno, es necesario actualizar la vista previa de la aplicación

Problema: después de volver a cargar un entorno que muestra una pestaña de vista previa de la aplicación, la pestaña no muestra la vista previa de la aplicación.

Causa: a veces, los usuarios escriben código que puede ejecutar un bucle infinito. O el código puede usar tanta memoria que es posible que el IDE de AWS Cloud9 pueda pausar o detenerse cuando se ejecuta la vista previa de la aplicación. Para evitar que esto ocurra, AWS Cloud9 no vuelve a cargar las pestañas de vista previa de la aplicación cuando se vuelve a cargar un entorno.

Solución: después de volver a cargar un entorno que muestra una pestaña de vista previa de la aplicación, para mostrar la vista previa de la aplicación, elija el botón Click to load the page (Hacer clic para cargar la página) en la pestaña.

Aviso de vista previa de aplicaciones o vista previa de archivo: “Cookies de terceros desactivadas”

Problema: Cuando intenta obtener una vista previa de una aplicación o un archivo, aparece un aviso con el siguiente mensaje: “La funcionalidad de vista previa está deshabilitada porque su navegador tiene cookies de terceros deshabilitadas”.

Causa: las cookies de terceros no son necesarias para abrir el IDE de AWS Cloud9. Sin embargo, debe habilitar las cookies de terceros para utilizar las características de Vista previa de la aplicación o Vista previa de archivo.

Solución: habilite las cookies de terceros en su navegador web, vuelva a cargar su IDE y, a continuación, intente abrir la vista previa de nuevo.

Si el navegador web permite este grado de detalle, puede habilitar las cookies de terceros solo para AWS Cloud9. Para ello, especifique los siguientes dominios, en función de las Regiones de AWS admitidas donde quiere usar AWS Cloud9.

Región de AWS Dominios

Este de EE. UU. (Norte de Virginia)

*.vfs.cloud9.us-east-1.amazonaws.com

vfs.cloud9.us-east-1.amazonaws.com

Este de EE. UU. (Ohio)

*.vfs.cloud9.us-east-2.amazonaws.com

vfs.cloud9.us-east-2.amazonaws.com

Oeste de EE.UU. (Norte de California)

*.vfs.cloud9.us-west-1.amazonaws.com

vfs.cloud9.us-west-1.amazonaws.com

Oeste de EE. UU. (Oregón)

*.vfs.cloud9.us-west-2.amazonaws.com

vfs.cloud9.us-west-2.amazonaws.com

África (Ciudad del Cabo)

*.vfs.cloud9.af-south-1.amazonaws.com

vfs.cloud9.af-south-1.amazonaws.com

Asia-Pacífico (Hong Kong)

*.vfs.cloud9.ap-east-1.amazonaws.com

vfs.cloud9.ap-east-1.amazonaws.com

Asia-Pacífico (Bombay)

*.vfs.cloud9.ap-south-1.amazonaws.com

vfs.cloud9.ap-south-1.amazonaws.com

Asia-Pacífico (Osaka)

*.vfs.cloud9.ap-northeast-3.amazonaws.com

vfs.cloud9.ap-northeast-3.amazonaws.com

Asia-Pacífico (Seúl)

*.vfs.cloud9.ap-northeast-2.amazonaws.com

vfs.cloud9.ap-northeast-2.amazonaws.com

Asia-Pacífico (Singapur)

*.vfs.cloud9.ap-southeast-1.amazonaws.com

vfs.cloud9.ap-southeast-1.amazonaws.com

Asia-Pacífico (Sídney)

*.vfs.cloud9.ap-southeast-2.amazonaws.com

vfs.cloud9.ap-southeast-2.amazonaws.com

Asia-Pacífico (Tokio)

*.vfs.cloud9.ap-northeast-1.amazonaws.com

vfs.cloud9.ap-northeast-1.amazonaws.com

Canadá (Centro)

*.vfs.cloud9.ca-central-1.amazonaws.com

vfs.cloud9.ca-central-1.amazonaws.com

Europa (Fráncfort)

*.vfs.cloud9.eu-central-1.amazonaws.com

vfs.cloud9.eu-central-1.amazonaws.com

Europa (Irlanda)

*.vfs.cloud9.eu-west-1.amazonaws.com

vfs.cloud9.eu-west-1.amazonaws.com

Europa (Londres)

*.vfs.cloud9.eu-west-2.amazonaws.com

vfs.cloud9.eu-west-2.amazonaws.com

Europa (Milán)

*.vfs.cloud9.eu-south-1.amazonaws.com

vfs.cloud9.eu-south-1.amazonaws.com

Europa (París)

*.vfs.cloud9.eu-west-3.amazonaws.com

vfs.cloud9.eu-west-3.amazonaws.com

Europe (Stockholm)

*.vfs.cloud9.eu-north-1.amazonaws.com

vfs.cloud9.eu-north-1.amazonaws.com

Middle East (Bahrain)

*.vfs.cloud9.me-south-1.amazonaws.com

vfs.cloud9.me-south-1.amazonaws.com

América del Sur (São Paulo)

*.vfs.cloud9.sa-east-1.amazonaws.com

vfs.cloud9.sa-east-1.amazonaws.com

La pestaña de vista previa de la aplicación muestra un mensaje de error o está en blanco

Problema: en la barra de menús del IDE, cuando elige Preview, Preview Running Application (Vista previa, Vista previa de la aplicación en ejecución) o Tools, Preview, Preview Running Application (Herramientas, Vista previa, Vista previa de la aplicación en ejecución) para intentar mostrar la aplicación en una pestaña de vista previa en el IDE, la pestaña muestra un mensaje de error o aparece en blanco.

Causas posibles:

  • La aplicación no se está ejecutando en el IDE.

  • La aplicación no se está ejecutando mediante HTTP.

  • La aplicación se está ejecutando a través de más de un puerto.

  • La aplicación se está ejecutando a través de un puerto distinto de 8080, 8081 o 8082.

  • La aplicación se está ejecutando con una dirección IP distinta de 127.0.0.1, localhost o 0.0.0.0.

  • El puerto (8080, 8081 o 8082) no está especificado en la URL de la pestaña de vista previa.

  • La red bloquea el tráfico de entrada a los puertos 8080, 8081 o 8082.

  • Está intentando ir a una dirección que contiene una IP de 127.0.0.1, localhost o 0.0.0.0. De forma predeterminada, el IDE de AWS Cloud9 intenta ir al equipo local. No intenta ir a la instancia ni al propio servidor que está conectado al entorno.

Soluciones recomendadas:

  • Asegúrese de que la aplicación se está ejecutando en el IDE.

  • Asegúrese de que la aplicación se está ejecutando mediante HTTP. Para ver algunos ejemplos en Node.js y Python, consulte Ejecutar una aplicación.

  • Asegúrese de que la aplicación se está ejecutando solo a través de un puerto. Para ver algunos ejemplos en Node.js y Python, consulte Ejecutar una aplicación.

  • Asegúrese de que la aplicación se está ejecutando a través del puerto 8080, 8081 o 8082. Para ver algunos ejemplos en Node.js y Python, consulte Ejecutar una aplicación.

  • Asegúrese de que la aplicación se está ejecutando con una dirección IP de 127.0.0.1, localhost o 0.0.0.0. Para ver algunos ejemplos en Node.js y Python, consulte Ejecutar una aplicación.

  • Añada :8080, :8081 o :8082 a la URL de la pestaña de vista previa.

  • Asegúrese de que su red permite el tráfico de entrada a través de los puertos 8080, 8081 o 8082. Si no puede realizar cambios en la red, consulte con el administrador de red.

  • Si intenta ir a una dirección que contiene una IP de 127.0.0.1, localhost, o 0.0.0.0, intente ir a la siguiente dirección en su lugar: https://12a34567b8cd9012345ef67abcd890e1.vfs.cloud9.us-east-2.amazonaws.com/. En esta dirección, 12a34567b8cd9012345ef67abcd890e1 es el ID que AWS Cloud9 asigna al entorno. us-east-2 es el ID de la Región de AWS para el entorno. También puede intentar ir a esta dirección fuera del IDE. Sin embargo, esta solo funciona cuando el IDE del entorno está abierto y la aplicación se está ejecutando en el mismo navegador web.

  • Cuando esté seguro de que se cumplen todas estas condiciones, intente detener la aplicación y, a continuación, iníciela de nuevo.

  • Si detuvo la aplicación y la inició de nuevo, intente elegir otra vez Preview, Preview Running Application (Vista previa, Vista previa de la aplicación en ejecución) o Tools, Preview, Preview Running Application (Herramientas, Vista previa, Vista previa de la aplicación en ejecución) en la barra de menús. O bien intente elegir el botón Refresh (Actualizar) (flecha circular) en la correspondiente pestaña de vista previa de la aplicación, si la pestaña ya está visible.

No se puede obtener una vista previa del contenido web en el IDE porque la conexión al sitio no es segura

Problema: al intentar acceder a contenido web como un sitio de WordPress que está alojado en un entorno de EC2 de AWS Cloud9, la ventana de vista previa del IDE no puede mostrarlo.

Causas posibles: de forma predeterminada, todas las páginas web a las que accede en la pestaña de vista previa de la aplicación del IDE de AWS Cloud9 utilizan automáticamente el protocolo HTTPS. Si el URI de una página presenta el protocolo no seguro http, se reemplaza automáticamente por https. Para acceder al contenido no seguro, tampoco puede restablecer https a http manualmente.

Soluciones recomendadas: quite los scripts HTTP no seguros o el contenido del sitio web del que intenta obtener una vista previa en el IDE. Siga las instrucciones de su servidor web o sistema de administración de contenido para obtener instrucciones sobre cómo implementar HTTPS.

La vista previa de un archivo devuelve un error 499

Problema: cuando intenta utilizar el IDE de AWS Cloud9 para obtener una vista previa de un archivo que contiene un elemento <script> que incluye el atributo src y con el atributo type establecido en module, se produce un error 499 y el script no se ejecuta según lo previsto.

Causa: las solicitudes para obtener una vista previa de archivos en el IDE de AWS Cloud9 requieren que el navegador web envíe cookies para autenticarse. De forma predeterminada, los navegadores web envían cookies para las solicitudes de scripts habituales. No envían cookies para las solicitudes de scripts del módulo a menos que agregue el atributo crossorigin.

Solución: añada el atributo crossorigin en el elemento <script>. Por ejemplo, <script type="module" src="index.js" crossorigin></script>. A continuación, guarde el archivo modificado y vuelva a intentar obtener la vista previa.

Rendimiento

La siguiente sección describe la solución de problemas relacionados con el rendimiento.

El IDE de AWS Cloud9 se congela durante un período de tiempo significativo

Problema: durante el arranque, y al realizar una actualización, el terminal del IDE de AWS Cloud9 se congela durante un período de tiempo considerable y queda inutilizable.

Causa: es posible que tenga una gran cantidad de archivos en su entorno que estén siendo visualizados repetidamente por el módulo de visualización de AWS Cloud9.

Soluciones recomendadas: puede reducir la profundidad de visualización de los archivos (el valor mínimo es 1) y considerar la posibilidad de añadir carpetas grandes o carpetas que no estén relacionadas con el código fuente (productos o artefactos de compilación, paquetes de terceros) a los patrones ignorados. Para ello, vaya a Preferencias > Configuración de usuario > Visualización de archivos. Tenga en cuenta que esto provocará que los CodeLenses del AWS Toolkit no funcionen correctamente.

Otra posible solución es considerar la posibilidad de ignorar los archivos y carpetas grandes que no estén relacionados con el código fuente reduciendo el número máximo de archivos a buscar. Para ello, vaya a Preferencias > Configuración de proyecto > Buscar en archivos. Tenga en cuenta que esto provocará que las carpetas que se omitan no aparecerán en una búsqueda de archivos.

Advertencia de la consola: “Cambio al motor de finalización de código mínimo...”

Problema: al trabajar en la consola de AWS Cloud9 (por ejemplo, al abrir el IDE o actualizar la página web del IDE), verá este mensaje: “One or more sessions or collaborators are active on this environment. Switching to the minimal code completion engine to conserve memory”. En correlación con este mensaje, el comportamiento de finalización de código podría ser lento o intermitente.

Causa: la ejecución del motor de finalización de código requiere memoria y ciclos de CPU del entorno. Además, se requiere un motor de finalización de código independiente para cada colaborador y cada sesión adicional. Para evitar utilizar demasiados recursos, especialmente en tamaños de instancias pequeñas como t2.nano y t2.micro, AWS Cloud9 cambia al motor de finalización de código mínimo.

Solución recomendada: si va a colaborar con frecuencia y durante largos periodos de tiempo, elija una instancia de Amazon EC2 más grande al crear el entorno de EC2. O, como alternativa, conecte el entorno de SSH a una instancia con más capacidad.

nota

Es posible que elegir una instancia de Amazon EC2 más grande genere cargos adicionales para la Cuenta de AWS. Para obtener más información, consulte Precios de Amazon EC2.

Advertencia del IDE: “Este entorno se está quedando sin memoria” o “Este entorno tiene una elevada carga de CPU”

Problema: mientras se está ejecutando el IDE, aparece un mensaje que contiene la frase “este entorno se está quedando sin memoria” o “este entorno tiene una elevada carga de CPU”.

Causa: es posible que el IDE no disponga de los recursos informáticos suficientes para seguir funcionando sin retrasos o bloqueos.

Soluciones recomendadas:

  • Detenga uno o más procesos en ejecución para liberar la memoria disponible. Para ello, en la barra de menús del IDE correspondiente al entorno, elija Tools, Process List (Herramientas, Lista de procesos). Por cada proceso que desee detener, selecciónelo y, a continuación, elija Force Kill (Forzar terminación).

  • Cree un archivo de intercambio en el entorno. Un archivo de intercambio es un archivo en el entorno que el sistema operativo puede utilizar como memoria virtual.

    Para confirmar que el entorno está utilizando la memoria de intercambio, ejecute el comando top en una sesión del terminal en el entorno. Si se está utilizando memoria de intercambio, la salida muestra estadísticas de memoria Swap distintas de cero (por ejemplo, Swap: 499996k total, 1280k used, 498716 free, 110672k cached). Para dejar de mostrar la información de la memoria en tiempo real, pulse Ctrl + C.

    Para crear un archivo de intercambio, ejecute un comando como el siguiente en el entorno.

    sudo fallocate --length 512MB /var/swapfile && sudo chmod 600 /var/swapfile && sudo mkswap /var/swapfile && echo '/var/swapfile swap swap defaults 0 0' | sudo tee -a /etc/fstab > /dev/null

    El comando anterior hace lo siguiente:

    1. Crea un archivo de 512 MB denominado swapfile en el directorio /var.

    2. Cambia los permisos de acceso del archivo swapfile a lectura y escritura solo para el propietario.

    3. Configura el archivo swapfile como un archivo de intercambio.

    4. Escribe información en el /etc/fstab file. Esto hace que este archivo de intercambio esté disponible siempre que se reinicie el sistema.

    Después de ejecutar el comando anterior, para que este archivo de intercambio esté disponible inmediatamente, ejecute el comando siguiente.

    sudo swapon /var/swapfile

  • Mueva o cambie el tamaño del entorno a una instancia o un servidor con más recursos informáticos. Para mover o cambiar el tamaño de instancias de Amazon EC2, consulte Mover un entorno y cambiar el tamaño de volúmenes de Amazon EBS o cifrarlos. Para otros tipos de instancia o servidor, consulte la documentación correspondiente.

No se pueden cargar archivos en el IDE de AWS Cloud9

Problema: los usuarios no pueden cargar un archivo grande en el IDE de AWS Cloud9. Estas cargas están fallando.

Causa: AWS Cloud9 reduce la velocidad de carga al IDE de AWS Cloud9 y, como resultado, se agota el tiempo de espera de la solicitud de carga de archivos.

Solución recomendada: se recomienda cargar el archivo en Amazon S3 y, a continuación, utilizar Amazon S3 para descargar el archivo al entorno con la CLI en el IDE de AWS Cloud9. Para obtener información sobre cómo cargar archivos en Amazon S3, consulte Carga de objetos en la Guía de usuario de Amazon S3.

Velocidad de descarga lenta en el IDE de AWS Cloud9

Problema: los usuarios se enfrentan a velocidades de descarga lentas cuando intentan descargar archivos desde el IDE de AWS Cloud9.

Causa: al descargar archivos del IDE al sistema de archivos local, la velocidad de transferencia se limitará a una velocidad de 0,1 megabytes por segundo.

Solución recomendada: para aumentar la velocidad de transferencia de archivos, utilice la CLI del IDE de AWS Cloud9 para cargar los archivos en Amazon S3 y, a continuación, utilice Amazon S3 para descargar los archivos desde allí.

No se puede obtener una vista previa del contenido web en el IDE porque la conexión al sitio no es segura

Problema: al intentar acceder a contenido web como un sitio de WordPress que está alojado en un entorno de EC2 de AWS Cloud9, la ventana de vista previa del IDE no puede mostrarlo.

Causas posibles: de forma predeterminada, todas las páginas web a las que accede en la pestaña de vista previa de la aplicación del IDE de AWS Cloud9 utilizan automáticamente el protocolo HTTPS. Si el URI de una página presenta el protocolo no seguro http, se reemplaza automáticamente por https. Para acceder al contenido no seguro, tampoco puede restablecer https a http manualmente.

Soluciones recomendadas: quite los scripts HTTP no seguros o el contenido del sitio web del que intenta obtener una vista previa en el IDE. Siga las instrucciones de su servidor web o sistema de administración de contenido para obtener instrucciones sobre cómo implementar HTTPS.

(Volver arriba)

Aplicaciones y servicios de terceros

La siguiente sección describe la solución de problemas relacionados con aplicaciones y servicios de terceros.

No se puede interactuar con la ventana de terminal en AWS Cloud9 debido a errores de sesión de tmux

Problema: Cuando intenta lanzar una nueva ventana de terminal en AWS Cloud9, la interfaz de línea de comandos esperada no está disponible. No hay símbolo del sistema y no puede ingresar texto. Se devuelven mensajes de error como tmux: need UTF-8 locale (LC_CTYPE) y invalid LC_ALL, LC_CTYPE or LANG.

Posibles causas: un terminal que no responde puede deberse a un error de tmux. AWS Cloud9 emplea la utilidad tmux. De esta forma, la información que se muestra en el terminal persiste incluso cuando la página se recarga o se reconecta al entorno de desarrollo.

En una sesión tmux, lo que se muestra en la ventana del terminal lo administra un cliente. El cliente se comunica con un servidor que puede administrar varias sesiones. El servidor y el cliente se comunican a través de un socket ubicado en la carpeta tmp. Si la carpeta tmp falta en el entorno de desarrollo o se le aplican permisos demasiado restrictivos, las sesiones tmux no pueden ejecutarse. Si esto ocurre, la ventana de terminal del IDE deja de responder.

Soluciones recomendadas: si los errores de tmux le impiden interactuar con la ventana de terminal, use una forma alternativa para crear una carpeta tmp con los permisos adecuados. De esa manera, se pueden ejecutar sesiones tmux. Una solución consiste en exportar LC_CTYPE en .bash_profile o en el archivo .bashrc. Otra solución que se recomienda es usar AWS Systems Manager para establecer una configuración de administración de host. Esto permite el acceso a la instancia correspondiente a través de la consola de Amazon EC2.

Configuración de la administración de host

  1. En primer lugar, en la consola de AWS Cloud9, busque el nombre de la instancia del entorno. Para realizar la prueba, puede elegir el panel correspondiente en la página Your environments (Sus entornos) y elegir View details (Ver detalles). En la página de Environment details (Detalles del Entorno), elija Go to Instance (Ir a la Instancia). En la consola de Amazon EC2, confirme el nombre de la instancia a la que necesita acceder.

  2. Ahora vaya a la consola AWS Systems Manager, y en el panel de navegación, elija Quick Setup (Configuración Rápida).

  3. En la página de Quick Setup (Configuración Rápida), elija Create (Crear).

  4. Para los tipos de configuración, vaya a Host Management (Administración de hosts) y elija Create (Crear).

  5. Para personalizar las opciones de configuración de Host Management, en la sección Targets (Objetivos), elija Manual.

  6. Seleccione la instancia de EC2 a la que desea acceder y, a continuación, elija Create (Crear).

Conexión a la instancia y ejecución de comandos

nota

Los pasos que se indican a continuación corresponden a la nueva consola de EC2.

  1. En el panel de navegación de la consola de Amazon EC2, elija Instances (Instancias) y seleccione la instancia a la que desea conectarse.

  2. Elija Conectar.

    Si Connect (Conectar) no está activado, es posible que tenga que iniciar la instancia en primer lugar.

  3. En el panel Connect to your instance (Conectar con la instancia), en Connection method (Método de conexión), elija Session Manager (Administrador de sesiones) y luego elija Connect (Conectar).

  4. En la ventana de sesión de terminal que se muestra, escriba los siguientes comandos. Estos comandos crean la carpeta tmp con los permisos correctos para que el socket tmux esté disponible.

    sudo mkdir /tmp
sudo chmod 777 /tmp
sudo rmdir /tmp/tmux-*

No se puede cargar el IDE con versiones anteriores del navegador Microsoft Edge

Problema: se devuelve el error HTTP403: FORBIDDEN al intentar cargar el IDE de AWS Cloud9 mediante el navegador web Microsoft Edge.

Causas posibles: el IDE de AWS Cloud9 no admite ciertas versiones anteriores de Microsoft Edge.

Soluciones recomendadas: para actualizar el navegador, elija el botón de puntos suspensivos (...) en la barra de herramientas de Microsoft Edge. En el menú, elija Settings (Configuración) y, a continuación, About Microsoft Edge (Acerca de Microsoft Edge). Si se requiere una actualización, esta se descarga e instala automáticamente.

Error con gdb al depurar proyectos de C++

Problema: error reportado para el depurador de gdb al intentar depurar el proyecto de C++ en el IDE.

Causas posibles: Supongamos que el entorno de AWS Cloud9 utiliza determinados tipos de instancias de EC2 (por ejemplo, t3.small o m5.large). A continuación, es posible que se produzca un error de depuración al intentar ejecutar y depurar un proyecto de C++ con el ejecutor integrado del IDE. Este error puede ocurrir porque la versión de gdb (depurador de proyectos GNU) preinstalado para su entorno no funciona en determinadas plataformas de procesador. Es posible que vea el código de error siguiente.

GDB server terminated with code 1

Soluciones recomendadas: el problema de la incompatibilidad de gdb con determinadas plataformas de procesador se corrigió de la versión 3.0 en adelante. Desinstale la versión anterior del depurador y actualice a una versión más reciente de gdb:

  1. Para eliminar la versión existente del depurador, ejecute el siguiente comando en el terminal de AWS Cloud9.

    sudo yum -y remove gdb

  2. Recupere el archivo para gdb, descomprímalo y vaya al directorio que contiene los archivos extraídos. Para ello, ejecute los siguientes comandos.

    wget "http://ftp.gnu.org/gnu/gdb/gdb-8.3.tar.gz"
tar xzf gdb-8.3.tar.gz
cd gdb-8.3

  3. Cree el depurador ejecutando el siguiente comando. Para ello, copie y pegue el siguiente texto como un solo bloque y presione Devolución para ejecutar make.

    ./configure --prefix=/usr \
            --with-system-readline \
            --with-python=/usr/bin/python3 &&
make

  4. Instale el depurador.

    sudo make -C gdb install

  5. Confirme que la versión actualizada del depurador está instalada.

     gdb --version

Problemas con el ejecutor PHP en AWS Cloud9

Problema: los usuarios no pueden ver ningún resultado en el terminal de ejecución CLI de PHP.

Causa: el ejecutor de CLI debe estar configurado en PHP y el modo de depuración debe estar habilitado.

Solución recomendada: configure el ejecutor de CLI en PHP y asegúrese de que el modo de depuración esté habilitado.

Errores de GLIBC relacionados con Node.js

Problema: los usuarios no pueden ejecutar Node.js y reciben errores de GLIBC. A continuación, se muestra un ejemplo de estos mensajes de error:

node: /lib64/libm.so.6: version `GLIBC_2.27' not found (required by node)
node: /lib64/libc.so.6: version `GLIBC_2.28' not found (required by node)

Causa: es posible que se trate de problemas con la versión de Node.js relacionados con la instancia que se está utilizando.

Solución recomendada: consulte la sección Paso 1: Instalar las herramientas necesarias para obtener información sobre cómo instalar Node.js para AWS Cloud9.