AWS Cloud9 - Guía del usuario · AWS Cloud9 Guía del usuario Amazon's trademarks and trade dress...

AWS Cloud9Guía del usuario

AWS Cloud9: Guía del usuarioCopyright © 2020 Amazon Web Services, Inc. and/or its affiliates. All rights reserved.

AWS Cloud9 Guía del usuario

Amazon's trademarks and trade dress may not be used in connection with any product or service that is not Amazon's,in any manner that is likely to cause confusion among customers, or in any manner that disparages or discreditsAmazon. All other trademarks not owned by Amazon are the property of their respective owners, who may or may notbe affiliated with, connected to, or sponsored by Amazon.


Table of Contents¿Qué es AWS Cloud9? ....................................................................................................................... 1

¿Cómo funciona AWS Cloud9? .................................................................................................... 1entornos de AWS Cloud9 .................................................................................................... 1entornos y recursos informáticos ........................................................................................... 1

¿Qué puedo hacer con AWS Cloud9? (Resumen) ........................................................................... 2¿Cómo puedo comenzar? ............................................................................................................ 2Temas adicionales ...................................................................................................................... 2¿Qué puedo hacer con ella? ........................................................................................................ 2Información adicional .................................................................................................................. 4

Vídeos relacionados ............................................................................................................ 4Temas relacionados en el sitio de AWS ................................................................................. 4Precios .............................................................................................................................. 5Acerca de las versiones de Cloud9 ....................................................................................... 5Tengo más preguntas o necesito ayuda ................................................................................. 5

Configuración ..................................................................................................................................... 6Configuración de usuario individual ............................................................................................... 6

Paso 1: Crear una cuenta de AWS ....................................................................................... 6Paso 2: Iniciar sesión en la consola de AWS Cloud9 con el usuario raíz de la cuenta de AWS ......... 7Pasos siguientes ................................................................................................................ 7

Configuración de equipo .............................................................................................................. 8Paso 1: Crear una cuenta de AWS ....................................................................................... 9Paso 2: Crear un grupo y un usuario de IAM y añadir el usuario al grupo .................................... 9Paso 3: Añadir permisos de acceso para AWS Cloud9 al grupo ............................................... 13Paso 4: Iniciar sesión en la consola de AWS Cloud9 .............................................................. 16Pasos siguientes ............................................................................................................... 16

Configuración de empresa ......................................................................................................... 17Paso 1: Crear una cuenta maestra para la organización ......................................................... 18Paso 2: Crear una organización para la cuenta maestra ......................................................... 19Paso 3: Añadir cuentas de miembros a la organización .......................................................... 19Paso 4: Habilitar AWS SSO en la organización ..................................................................... 20Paso 5. Configurar usuarios y grupos dentro de la organización ............................................... 20Paso 6. Habilitar usuarios y grupos dentro de la organización para utilizar AWS Cloud9 ................ 21Paso 7: Comenzar a usar AWS Cloud9 ............................................................................... 22Pasos siguientes ............................................................................................................... 23

Opciones de configuración adicionales (Team y Enterprise) ............................................................. 23Paso 1: Crear una política administrada por el cliente ............................................................ 24Paso 2: Añadir políticas administradas por el cliente a un grupo ............................................... 25Ejemplos de políticas administradas por el cliente para equipos que utilizan AWS Cloud9 ............. 26Pasos siguientes ............................................................................................................... 30

Configuración individual de estudiante ......................................................................................... 30Paso 1: Crear una cuenta con AWS .................................................................................... 31Paso 2: Iniciar sesión en la consola de AWS Cloud9 .............................................................. 33Pasos siguientes ............................................................................................................... 35

Configuración de aula ................................................................................................................ 35Paso 1: Crear una cuenta de AWS y solicitar AWS Educate .................................................... 35Paso 2: Configurar su aula virtual para AWS Cloud9 .............................................................. 37Paso 3: Entrar en el aula virtual .......................................................................................... 38Pasos siguientes ............................................................................................................... 40

Introducción: tutoriales básicos ........................................................................................................... 41Primer vistazo a AWS Cloud9 (consola) ....................................................................................... 41

Requisitos previos ............................................................................................................. 41Pasos .............................................................................................................................. 41Paso 1: Crear un entorno .................................................................................................. 42Paso 2: Recorrido básico ................................................................................................... 44

iii


Paso 3: Eliminación .......................................................................................................... 49Información relacionada ..................................................................................................... 50

Primer vistazo a AWS Cloud9 (CLI) ............................................................................................. 52Requisitos previos ............................................................................................................. 52Pasos .............................................................................................................................. 52Paso 1: Crear un entorno .................................................................................................. 52Paso 2: Recorrido básico ................................................................................................... 54Paso 3: Eliminación .......................................................................................................... 58Información relacionada ..................................................................................................... 59

Uso de entornos ............................................................................................................................... 61Creación de un entorno ............................................................................................................. 61

Creación de un entorno de EC2 .......................................................................................... 62Creación de un entorno de SSH ......................................................................................... 71

Apertura de un entorno ............................................................................................................ 74Llamar a los servicios de AWS desde un entorno ......................................................................... 76

Creación y uso de un perfil de instancia para administrar credenciales temporales ....................... 78Crear y almacenar las credenciales de acceso permanente en un entorno ................................. 82

Modificación de la configuración del entorno ................................................................................ 84Cambiar las preferencias de entorno ................................................................................... 84Cambiar la configuración del entorno con la consola .............................................................. 84Cambiar la configuración del entorno mediante código ............................................................ 87

Trabajo con entornos compartidos ............................................................................................... 88Contenido ........................................................................................................................ 88Escenarios de uso de entorno compartido ............................................................................ 88Acerca de los roles de acceso de miembro del entorno .......................................................... 89Invitar a un usuario en la misma cuenta que el entorno .......................................................... 91Hacer que un administrador de AWS Cloud9 en la misma cuenta que la del entorno se invite a símismo o a otros usuarios ................................................................................................... 92Abrir un entorno compartido ............................................................................................... 93Ver una lista de miembros del entorno ................................................................................. 94Abrir el archivo activo de un miembro del entorno .................................................................. 95Abrir el comando Abrir archivo de un miembro del entorno ...................................................... 95Vaya al Cursor activo de un miembro del entorno .................................................................. 95Conversar con otros miembros del entorno ........................................................................... 95Ver mensajes de chat en un entorno compartido ................................................................... 96Eliminar un mensaje de chat de un entorno compartido .......................................................... 96Eliminar todos los mensaje de chat de un entorno compartido ................................................. 96Cambiar el rol de acceso de un miembro del entorno ............................................................. 96Eliminar su usuario de un entorno compartido ....................................................................... 97Eliminar otro miembro del entorno ....................................................................................... 98Prácticas recomendadas para compartir entorno .................................................................... 99

Mover o cambiar el tamaño de un entorno .................................................................................. 99Movimiento de un entorno ................................................................................................ 100Redimensionamiento de un entorno ................................................................................... 101

Eliminación de entornos ........................................................................................................... 103Eliminación de un entorno con la consola ........................................................................... 103Eliminación de un entorno con código ................................................................................ 105

Uso del IDE ................................................................................................................................... 107Recorrido del IDE ................................................................................................................... 108

Requisitos previos ........................................................................................................... 108Paso 1: Barra de menús .................................................................................................. 109Paso 2: Panel ................................................................................................................. 110Paso 3: Ventana entorno .................................................................................................. 111Paso 4: Editor, pestañas y paneles .................................................................................... 111Paso 5: Consola ............................................................................................................. 113Paso 6: Sección Open Files (Abrir archivos) ........................................................................ 114Paso 7: Margen interior .................................................................................................... 114

iv


Paso 8: Barra de estado .................................................................................................. 115Paso 9: Ventana Outline (Esquema) .................................................................................. 116Paso 10: Ventana Go (Ir) ................................................................................................. 117Paso 11: Pestaña Immediate (Inmediato) ............................................................................ 119Paso 12: Lista de procesos .............................................................................................. 120Paso 13: Preferencias ...................................................................................................... 121Paso 14: Terminal ........................................................................................................... 122Paso 15: Ventana Debugger (Depurador) ........................................................................... 123Conclusiones .................................................................................................................. 128

Lenguajes compatibles ............................................................................................................. 128Referencia de los comandos de menú ....................................................................................... 130

Menú de AWS Cloud9 ..................................................................................................... 130Menú File ....................................................................................................................... 131Menú Edit ...................................................................................................................... 132Menú Find (Buscar) ......................................................................................................... 134Menú View ..................................................................................................................... 135Menú Go (Ir) .................................................................................................................. 136Menú Run (Ejecutar) ....................................................................................................... 137Menú de herramientas ..................................................................................................... 138Menú Window (Ventana) .................................................................................................. 138Menú Support (Soporte) ................................................................................................... 140Menú Preview (Vista previa) ............................................................................................. 141Otros comandos de la barra de menús ............................................................................... 141

Búsqueda y reemplazo de texto ................................................................................................ 141Búsqueda de texto en un único archivo .............................................................................. 141Reemplazo de texto en un único archivo ............................................................................ 142Búsqueda de texto en varios archivos ................................................................................ 142Reemplazo de texto en varios archivos .............................................................................. 143Opciones de búsqueda y reemplazo .................................................................................. 144

Vista previa de archivos ........................................................................................................... 145Abrir un archivo para vista previa ...................................................................................... 145Volver a cargar la vista previa de un archivo ....................................................................... 146Cambiar el tipo de vista previa del archivo .......................................................................... 146Abrir una vista previa de un archivo en una pestaña independiente del navegador web ............... 146Cambiar a una vista previa de archivo distinta ..................................................................... 147

Vista previa de aplicaciones en ejecución ................................................................................... 147Ejecutar una aplicación .................................................................................................... 147Vista previa de una aplicación en ejecución ........................................................................ 148Volver a cargar la vista previa de una aplicación .................................................................. 149Cambiar el tipo de vista previa de la aplicación ................................................................... 149Abrir la vista previa de una aplicación en una pestaña independiente del navegador web ............ 150Cambiar a una URL de vista previa distinta ........................................................................ 150Compartir una aplicación en ejecución a través de Internet .................................................... 150

Trabajo con revisiones de archivo ............................................................................................. 154Trabajo con archivos de imagen ................................................................................................ 156

Ver o editar una imagen .................................................................................................. 156Cambiar de tamaño una imagen ....................................................................................... 156Recortar una imagen ....................................................................................................... 157Rotar una imagen ........................................................................................................... 157Invertir una imagen ......................................................................................................... 157Acercar o alejar una imagen ............................................................................................. 157Suavizar una imagen ....................................................................................................... 158

Trabajo con compiladores, ejecutores y depuradores .................................................................... 158Soporte integrado de compilación, ejecución y depuración ..................................................... 158Compilar los archivos del proyecto .................................................................................... 159Ejecutar el código ........................................................................................................... 159Depurar el código ........................................................................................................... 159

v


Cambiar un ejecutor integrado .......................................................................................... 162Crear una configuración de ejecución ................................................................................. 162Crear un compilador o ejecutor ......................................................................................... 163Definir un compilador o ejecutor ........................................................................................ 164

Trabajar con proyectos de lenguaje ........................................................................................... 166Características disponibles de productividad de proyectos ..................................................... 167Creación de un proyecto de lenguaje ................................................................................. 169

Trabajo con variables de entorno personalizadas ......................................................................... 170Establecer variables de entorno personalizadas en el nivel de comando .................................. 170Establecer variables de entorno de usuario personalizadas en ~/.bash_profile ........................... 170Establecer variables de entorno personalizadas locales ......................................................... 171Establecer variables de entorno de usuario personalizadas en ~/.bashrc .................................. 171Establecer variables de entorno personalizadas en la lista ENV .............................................. 171

Trabajar con la configuración de los proyectos ............................................................................ 172Ver o cambiar la configuración de proyectos ....................................................................... 172Aplicar la configuración del proyecto actual de un entorno a otro entorno ................................. 173Project Setting Changes You Can Make ............................................................................. 173

Trabajo con la configuración de usuario ..................................................................................... 178Visualización o cambio de la configuración de usuario .......................................................... 179Cómo compartir la configuración de usuario con otro usuario ................................................. 179User Setting Changes You Can Make ................................................................................ 179

Trabajar con la configuración de usuarios y de proyectos de AWS .................................................. 187Configuración de nivel de proyecto .................................................................................... 187Configuración de nivel de usuario ...................................................................................... 187

Trabajo con enlaces de teclado ................................................................................................. 187Visualización o cambio de los enlaces de teclado ................................................................ 188Uso compartido de sus enlaces de teclado con otro usuario .................................................. 188Cambio del modo de teclado ............................................................................................ 188Cambio de los enlaces de teclado de su sistema operativo .................................................... 189Cambio de enlaces de teclado específicos .......................................................................... 189Eliminación de todos los enlaces de teclado personalizados .................................................. 190

Trabajar con temas ................................................................................................................. 190Ver o cambiar temas ....................................................................................................... 191Valores generales de configuración de temas que puede cambiar ........................................... 191Reemplazos de temas que puede definir con código ............................................................ 191Compartir reemplazos de temas con otro usuario ................................................................. 192

Trabajo con scripts de inicialización ........................................................................................... 192Ver o cambiar el script de inicialización .............................................................................. 193Compartir el script de inicialización con otro usuario ............................................................. 193

Referencia de enlaces de teclado predeterminados para MacOS .................................................... 193General ......................................................................................................................... 194Pestañas ........................................................................................................................ 196Paneles ......................................................................................................................... 197Editor de código .............................................................................................................. 198emmet ........................................................................................................................... 203Terminal ........................................................................................................................ 204Ejecución y depuración .................................................................................................... 204

Referencia de enlaces de teclado Vim para MacOS ..................................................................... 204General ......................................................................................................................... 205Pestañas ........................................................................................................................ 207Paneles ......................................................................................................................... 209Editor de código .............................................................................................................. 209emmet ........................................................................................................................... 214Terminal ........................................................................................................................ 215Ejecución y depuración .................................................................................................... 215

Referencia de enlaces de teclado Emacs para MacOS ................................................................. 216General ......................................................................................................................... 216

vi


Pestañas ........................................................................................................................ 219Paneles ......................................................................................................................... 220Editor de código .............................................................................................................. 221emmet ........................................................................................................................... 226Terminal ........................................................................................................................ 226Ejecución y depuración .................................................................................................... 226

Referencia de enlaces de teclado Sublime para MacOS ................................................................ 227General ......................................................................................................................... 228Pestañas ........................................................................................................................ 231Paneles ......................................................................................................................... 232Editor de código .............................................................................................................. 233emmet ........................................................................................................................... 238Terminal ........................................................................................................................ 239Ejecución y depuración .................................................................................................... 239

Referencia de enlaces de teclado predeterminados para Windows/Linux .......................................... 239General ......................................................................................................................... 240Pestañas ........................................................................................................................ 242Paneles ......................................................................................................................... 244Editor de código .............................................................................................................. 244emmet ........................................................................................................................... 249Terminal ........................................................................................................................ 250Ejecución y depuración .................................................................................................... 250

Referencia de enlaces de teclado Vim para Windows/Linux ........................................................... 251General ......................................................................................................................... 251Pestañas ........................................................................................................................ 254Paneles ......................................................................................................................... 255Editor de código .............................................................................................................. 256emmet ........................................................................................................................... 261Terminal ........................................................................................................................ 261Ejecución y depuración .................................................................................................... 261

Referencia de enlaces de teclado Emacs para Windows/Linux ....................................................... 262General ......................................................................................................................... 263Pestañas ........................................................................................................................ 265Paneles ......................................................................................................................... 266Editor de código .............................................................................................................. 267emmet ........................................................................................................................... 272Terminal ........................................................................................................................ 273Ejecución y depuración .................................................................................................... 273

Referencia de enlaces de teclado Sublime para Windows/Linux ..................................................... 273General ......................................................................................................................... 274Pestañas ........................................................................................................................ 277Paneles ......................................................................................................................... 278Editor de código .............................................................................................................. 279emmet ........................................................................................................................... 284Terminal ........................................................................................................................ 285Ejecución y depuración .................................................................................................... 285

Referencia de comandos .......................................................................................................... 286Trabajar con otros servicios de AWS ................................................................................................. 299

Trabajo con instancias de Amazon Lightsail ................................................................................ 299Paso 1: Crear una instancia de Lightsail basada en Linux ..................................................... 300Paso 2: Configurar la instancia para utilizarla con AWS Cloud9 .............................................. 301Paso 3: Crear un entorno de desarrollo de SSH de AWS Cloud9 y conectarse a él .................... 303Paso 4: Utilizar el AWS Cloud9 IDE para cambiar el código en la instancia ............................... 306

Trabajo con proyectos de AWS CodeStar ................................................................................... 306Paso 1: Prepararse para trabajar con proyectos de AWS CodeStar ......................................... 307Paso 2: Crear un proyecto en AWS CodeStar ..................................................................... 307Paso 3: Crear un entorno de desarrollo de AWS Cloud9 y conectarlo al proyecto ....................... 307

vii


Trabajo con funciones de AWS Lambda ..................................................................................... 308Prepararse para trabajar con funciones Lambda .................................................................. 309Crear una función Lambda con el asistente de creación de aplicaciones sin servidor .................. 312Crear e implementar funciones Lambda con AWS Serverless Application Repository .................. 317Importar una función Lambda ........................................................................................... 319Llamar a una función Lambda. .......................................................................................... 321Invocar una función de Lambda que utiliza variables de entorno ............................................. 323Uso de las funciones de Lambda que utilizan versiones, alias o capas ..................................... 326Llamar a una API de API Gateway para una función Lambda relacionada ................................ 327Diferencias de respuesta al llamar a una función Lambda desde API Gateway .......................... 329Añadir código dependiente a una función Lambda ................................................................ 330Depurar la versión local de una función Lambda o su API de API Gateway relacionada ............... 333Cambiar el código en una función Lambda ......................................................................... 336Cargar código para una función Lambda ............................................................................ 337Convertir una función Lambda en una aplicación sin servidor ................................................. 341Actualizar los ajustes de configuración de una función Lambda .............................................. 343Eliminar una función Lambda ............................................................................................ 344

Trabajo con AWS CodePipeline ................................................................................................ 347Paso 1: Crear o identificar el repositorio del código fuente ..................................................... 347Paso 2: Crear un entorno de desarrollo de AWS Cloud9, conectarlo al repositorio de código ycargar el código .............................................................................................................. 348Paso 3: Prepararse para trabajar con AWS CodePipeline ...................................................... 349Paso 4: Crear una canalización en AWS CodePipeline ......................................................... 349

Tutoriales y ejemplos ....................................................................................................................... 350Tutorial sobre AWS Lambda ..................................................................................................... 350

Requisitos previos ........................................................................................................... 351Pasos ............................................................................................................................ 351Paso 1: Crear y abrir el entorno ........................................................................................ 351Paso 2: Crear la función de Lambda y la API ...................................................................... 353Paso 3: Añadir código a la función .................................................................................... 356Paso 4: Ejecutar o depurar la función localmente ................................................................. 358Paso 5: Ejecutar o depurar la API localmente ...................................................................... 361Paso 6: Ejecutar la función en producción .......................................................................... 363Paso 7: Ejecutar la API en producción ............................................................................... 364Paso 8: Cambiar la función e implementar el cambio ............................................................ 364Paso 9: Eliminación ......................................................................................................... 365Información relacionada ................................................................................................... 367

Tutorial avanzado de AWS Lambda ........................................................................................... 368Requisitos previos ........................................................................................................... 369Paso 1: Crear la función de Lambda y la API ...................................................................... 369Paso 2: Configurar Amazon SNS ...................................................................................... 370Paso 3: Ejecutar la función localmente ............................................................................... 372Paso 4: Depurar la función localmente ............................................................................... 373Paso 5: Ejecutar la API localmente .................................................................................... 374Paso 6: Depurar la API localmente .................................................................................... 375Paso 7: Implementar y ejecutar la función modificada en producción ....................................... 375Paso 8: Eliminación ......................................................................................................... 376Pasos siguientes ............................................................................................................. 378

Muestra de AWS CLI y el aws-shell ........................................................................................... 379Requisitos previos ........................................................................................................... 379Paso 1: Instalar la AWS CLI, el aws-shell o ambos en el entorno ............................................ 380Paso 2: Configurar la administración de credenciales en su entorno ........................................ 381Paso 3: Ejecutar algunos comandos básicos con la AWS CLI o el aws-shell en su entorno .......... 381Paso 4: Limpieza ............................................................................................................ 382

Ejemplo de AWS CodeCommit .................................................................................................. 382Requisitos previos ........................................................................................................... 383Paso 1: Configurar el grupo de IAM con los permisos de acceso necesarios ............................. 383

viii


Paso 2: Crear un repositorio en CodeCommit ...................................................................... 384Paso 3: Conectar el entorno con el repositorio remoto .......................................................... 385Paso 4: Clonar el repositorio remoto en su entorno .............................................................. 386Paso 5: Añadir archivos al repositorio ................................................................................ 386Paso 6: Eliminación ......................................................................................................... 388

Ejemplo de GitHub .................................................................................................................. 388Requisitos previos ........................................................................................................... 388Paso 1: Crear una cuenta de GitHub ................................................................................. 389Paso 2: Crear un repositorio de GitHub .............................................................................. 389Paso 3: Instalación de Git en su entorno ............................................................................ 389Paso 4: Clonar el repositorio remoto en su entorno .............................................................. 390Paso 5: Adición de archivos al repositorio ........................................................................... 390Paso 6: Seguir trabajando con el IDE y GitHub ................................................................... 392Paso 7: Eliminación ......................................................................................................... 392

Ejemplo de Amazon DynamoDB ................................................................................................ 392Requisitos previos ........................................................................................................... 393Paso 1: Instalar y configurar la AWS CLI, el shell de AWS o ambos en el entorno ...................... 393Paso 2: Crear una tabla ................................................................................................... 394Paso 3: Añadir un elemento a la tabla ............................................................................... 395Paso 4: Añadir varios elementos a la tabla ......................................................................... 396Paso 5: Crear un índice secundario global .......................................................................... 399Paso 6: Obtener elementos de la tabla ............................................................................... 401Paso 7: Eliminación ......................................................................................................... 404

Ejemplo de AWS CDK ............................................................................................................. 404Requisitos previos ........................................................................................................... 405Paso 1: Instalar las herramientas necesarias ....................................................................... 405Paso 2: Añadir el código .................................................................................................. 407Paso 3: Ejecutar el código ................................................................................................ 409Paso 4: Limpieza ............................................................................................................ 411

Ejemplo de LAMP ................................................................................................................... 411Requisitos previos ........................................................................................................... 411Paso 1: Instalar las herramientas ...................................................................................... 412Paso 2: Configurar MySQL ............................................................................................... 413Paso 3: Configurar un sitio web ........................................................................................ 414Paso 4: Limpieza ............................................................................................................ 417

Ejemplo de WordPress ............................................................................................................ 418Requisitos previos ........................................................................................................... 418Paso 1: instalar las herramientas necesarias ....................................................................... 419Paso 2: Configurar MySQL ............................................................................................... 421Paso 3: Configurar el sitio web de WordPress ..................................................................... 422Paso 4: Compartir el sitio web de WordPress a través de Internet ........................................... 424Paso 5: Limpieza ............................................................................................................ 428

Ejemplo de Java ..................................................................................................................... 429Requisitos previos ........................................................................................................... 429Paso 1: Instalar las herramientas necesarias ....................................................................... 430Paso 2: Añadir el código .................................................................................................. 431Paso 3: Compilar y ejecutar el código ................................................................................ 431Paso 4: Configurar el uso del AWS SDK for Java ................................................................ 432Paso 5: Configurar la administración de credenciales de AWS en su entorno ............................ 437Paso 6: Añadir el código del SDK de AWS ......................................................................... 437Paso 7: Compilar y ejecutar el código del SDK de AWS ........................................................ 438Paso 8: Eliminación ......................................................................................................... 439

Ejemplo de C++ ...................................................................................................................... 439Requisitos previos ........................................................................................................... 439Paso 1: Instalar las herramientas necesarias ....................................................................... 440Paso 2: Añadir el código .................................................................................................. 440Paso 3: Ejecutar el código ................................................................................................ 441

ix


Paso 4: Instalar y configurar el AWS SDK para C++ ............................................................. 442Paso 5: Añadir el código del SDK de AWS ......................................................................... 444Paso 6: Compilar y ejecutar el código del SDK de AWS ........................................................ 447Paso 7: Eliminación ......................................................................................................... 448

Tutorial de Python ................................................................................................................... 448Requisitos previos ........................................................................................................... 448Paso 1: Instalar Python 3.6 .............................................................................................. 449Paso 2: Añadir el código .................................................................................................. 449Paso 3: Ejecutar el código ................................................................................................ 449Paso 4: Instalar y configurar AWS SDK para Python (Boto 3) ................................................. 450Paso 5: Añadir el código del SDK de AWS ......................................................................... 451Paso 6: Ejecutar código del SDK de AWS .......................................................................... 452Paso 7: Eliminación ......................................................................................................... 452

Muestra de .NET Core ............................................................................................................. 452Requisitos previos ........................................................................................................... 453Paso 1: Instalar las herramientas necesarias ....................................................................... 453Paso 2: Crear un proyecto de aplicación de consola de .NET Core ......................................... 455Paso 3: Añadir el código .................................................................................................. 455Paso 4: Compilar y ejecutar el código ................................................................................ 456Paso 5: Crear y configurar el proyecto de aplicación de consola de .NET Core que usa AWSSDK para .NET ............................................................................................................... 457Paso 6: Añadir el código del SDK de AWS ......................................................................... 458Paso 7: Compilar y ejecutar el código del SDK de AWS ........................................................ 460Paso 8: Eliminación ......................................................................................................... 460

Ejemplo de Node.js ................................................................................................................. 460Requisitos previos ........................................................................................................... 461Paso 1: Instalar las herramientas necesarias ....................................................................... 461Paso 2: Añadir el código .................................................................................................. 462Paso 3: Ejecutar el código ................................................................................................ 462Paso 4: Instalar y configurar el AWS SDK for JavaScript in Node.js ......................................... 463Paso 5: Añadir el código del SDK de AWS ......................................................................... 463Paso 6: Ejecutar código del SDK de AWS .......................................................................... 465Paso 7: Eliminación ......................................................................................................... 465

Ejemplo de PHP ..................................................................................................................... 465Requisitos previos ........................................................................................................... 466Paso 1: Instalar las herramientas necesarias ....................................................................... 466Paso 2: Añadir el código .................................................................................................. 467Paso 3: Ejecutar el código ................................................................................................ 467Paso 4: Instalar y configurar el AWS SDK para PHP ............................................................ 468Paso 5: Añadir el código del SDK de AWS ......................................................................... 469Paso 6: Ejecutar código del SDK de AWS .......................................................................... 470Paso 7: Eliminación ......................................................................................................... 471

Tutorial: Ruby ......................................................................................................................... 471Requisitos previos ........................................................................................................... 471Pasos ............................................................................................................................ 471Paso 1: Instalar las herramientas necesarias ....................................................................... 472Paso 2: Añadir el código .................................................................................................. 472Paso 3: Ejecutar el código ................................................................................................ 473Paso 4: Instalar y configurar el AWS SDK parar Ruby .......................................................... 473Paso 5: Añadir el código del SDK de AWS ......................................................................... 475Paso 6: Ejecutar código del SDK de AWS .......................................................................... 476Paso 7: Eliminación ......................................................................................................... 477

Ejemplo de Go ....................................................................................................................... 477Requisitos previos ........................................................................................................... 477Paso 1: Instalar las herramientas necesarias ....................................................................... 477Paso 2: Añadir el código .................................................................................................. 478Paso 3: Ejecutar el código ................................................................................................ 479

x


Paso 4: Instalar y configurar el AWS SDK for Go ................................................................. 480Paso 5: Añadir el código del SDK de AWS ......................................................................... 481Paso 6: Ejecutar código del SDK de AWS .......................................................................... 483Paso 7: Eliminación ......................................................................................................... 483

Muestra de TypeScript ............................................................................................................. 483Requisitos previos ........................................................................................................... 484Paso 1: Instalar las herramientas necesarias ....................................................................... 484Paso 2: Añadir el código .................................................................................................. 485Paso 3: Ejecutar el código ................................................................................................ 486Paso 4: Instalar y configurar el AWS SDK for JavaScript in Node.js ......................................... 487Paso 5: Añadir el código del SDK de AWS ......................................................................... 488Paso 6: Ejecutar código del SDK de AWS .......................................................................... 489Paso 7: Eliminación ......................................................................................................... 490

Ejemplo de Docker .................................................................................................................. 490Requisitos previos ........................................................................................................... 490Paso 1: instalar y ejecutar Docker ..................................................................................... 491Paso 2: Crear la imagen .................................................................................................. 492Paso 3: Ejecutar el contenedor ......................................................................................... 495Paso 4: Crear el entorno .................................................................................................. 496Paso 5: Ejecutar el código ................................................................................................ 497Paso 6: Eliminación ......................................................................................................... 497

Ejemplos relacionados ............................................................................................................. 499Temas avanzados ........................................................................................................................... 500

entornos de EC2 frente a entornos de SSH ................................................................................ 500Configuración de Amazon VPC ................................................................................................. 501

Requisitos de Amazon VPC para AWS Cloud9 .................................................................... 501Crear una Amazon VPC para AWS Cloud9 ......................................................................... 511Crear una subred para AWS Cloud9 .................................................................................. 513

Requisitos de host de entorno de SSH ....................................................................................... 514Cuando y cómo crear un entorno de SSH .......................................................................... 514Requisitos del host SSH .................................................................................................. 515

Instalador de AWS Cloud9 ....................................................................................................... 516Descargue y ejecute el instalador de AWS Cloud9 ............................................................... 517Solución de problemas del instalador de AWS Cloud9 .......................................................... 517

Rangos de direcciones IP de entrada con SSH ........................................................................... 518Contenido de AMI ................................................................................................................... 519

Amazon Linux ................................................................................................................. 519Servidor Ubuntu .............................................................................................................. 520

Autenticación y control de acceso .............................................................................................. 521Información general ......................................................................................................... 521Políticas administradas (predefinidas) por AWS para AWS Cloud9 .......................................... 525Creación de políticas administradas por el cliente para AWS Cloud9 ....................................... 528credenciales temporales administradas de AWS .................................................................. 537

Uso de funciones vinculadas a servicios ..................................................................................... 540Permisos de roles vinculados a servicios para AWS Cloud9 ................................................... 540Creación de una función vinculada a servicios para AWS Cloud9 ........................................... 542Edición de un rol vinculado a servicio para AWS Cloud9 ....................................................... 542Eliminación de una función vinculada a un servicio para AWS Cloud9 ..................................... 542Regiones admitidas para los roles vinculados al servicio de AWS Cloud9 ................................. 543

Registro de llamadas a la API con CloudTrail .............................................................................. 543Información de AWS Cloud9 en CloudTrail ......................................................................... 543Descripción de las entradas de archivos de registro de AWS Cloud9 ....................................... 544

Etiquetas ................................................................................................................................ 552Propagación de actualizaciones de etiquetas a los recursos subyacentes ................................. 552

Solución del problemas .................................................................................................................... 554Error de creación de entorno: "No hemos podido crear las instancias EC2..." .................................... 554Error al crear el entorno: no dispone de autorización para sts: AssumeRole ...................................... 555

xi


Error de consola: el usuario no está autorizado para realizar la acción en el recurso .......................... 555Las identidades federadas no pueden crear entornos ................................................................... 556No se puede abrir un entorno ................................................................................................... 556El instalador de AWS Cloud9 se bloquea o falla .......................................................................... 558Error de entorno de SSH: se precisa la versión 2.7 de Python para instalar pty.js .............................. 558Aviso de vista previa de aplicaciones o vista previa de archivos: «Cookies de terceros desactivadas» .... 558La pestaña de vista previa de la aplicación muestra un mensaje de error o está en blanco .................. 560No se puede mostrar la aplicación en ejecución fuera del IDE ........................................................ 561Después de volver a cargar un entorno, es necesario actualizar la vista previa de la aplicación ............ 563No se puede previsualizar la aplicación en el AWS Cloud9 IDE con HTTP ....................................... 563No se pueden ejecutar algunos comandos o scripts en un entorno de EC2 ...................................... 563Error de la AWS CLI/aws-shell: "The security token included in the request is invalid" (El token deseguridad incluido en la solicitud no es válido) en un entorno de EC2 .............................................. 564Las instancias de Amazon EC2 no se actualizan automáticamente ................................................. 564Error de ejecución de la función local Lambda: no se puede instalar SAM Local ................................ 565Advertencia del IDE: "Este entorno se está quedando sin memoria" o "Este entorno tiene una elevadacarga de CPU" ....................................................................................................................... 566La vista previa de un archivo devuelve un error 499 ..................................................................... 567Error de eliminación del entorno: "One or more entornos failed to delete" (No se han podido eliminaruno o más entornos) ............................................................................................................... 567Advertencia de la consola: "Cambio al motor de finalización de código mínimo..." .............................. 568

Navegadores compatibles ................................................................................................................. 569Límites ........................................................................................................................................... 570

Límites de AWS Cloud9 ........................................................................................................... 570Límites de los servicios de AWS relacionados ............................................................................. 571

Historial de revisión ......................................................................................................................... 572

xii

AWS Cloud9 Guía del usuario¿Cómo funciona AWS Cloud9?

¿Qué es AWS Cloud9?AWS Cloud9 es un entorno de desarrollo integrado, o IDE.

El IDE de AWS Cloud9 ofrece una completa experiencia de edición de código, con soporte para varioslenguajes de programación y depuradores de tiempo de ejecución y un terminal integrado. Contiene unacolección de herramientas que se utilizan para codificar, compilar, ejecutar, probar y depurar software, y leayuda a lanzar software en la nube.

Es posible acceder a AWS Cloud9 IDE a través de un navegador web. Puede configurar el IDE según suspreferencias. Puede cambiar temas de color, enlazar claves de acceso directo, habilitar la sintaxis de colorpara lenguajes de programación y el formato del código, y mucho más.

(Ya lo tengo. Estoy listo para probar AWS Cloud9. ¿Cómo puedo comenzar? (p. 2))

¿Cómo funciona AWS Cloud9?En el siguiente diagrama se muestra información general sobre el funcionamiento de AWS Cloud9:

En el diagrama (a partir de la parte inferior), utilice el AWS Cloud9 IDE, ejecutándose en un navegadorweb en su equipo local, para interactuar con su entorno de AWS Cloud9. Un recurso informático (porejemplo, una instancia Amazon EC2 o su propio servidor) se conecta a ese entorno. Por último, el trabajose almacena en un repositorio de AWS CodeCommit u otro tipo de repositorio remoto.

entornos de AWS Cloud9Un entorno de AWS Cloud9 es un lugar en el que se almacenan los archivos del proyecto y donde seejecutan las herramientas para desarrollar aplicaciones.

Con el AWS Cloud9 IDE, puede hacer lo siguiente:

• Almacenar los archivos del proyecto localmente en la instancia o el servidor.• Clone un repositorio de código remoto, como un repositorio en AWS CodeCommit, en el entorno.• Trabaje con una combinación de archivos locales y clonados en el entorno.

Puede crear y cambiar entre varias entornos, con cada entorno configurado para un proyecto de desarrolloespecífico. Al almacenar el entorno en la nube, los proyectos ya no tienen por qué estar asociado a unasola configuración del servidor o equipo. Esto permite hacer cosas como cambiar fácilmente entre equipose incluir con mayor rapidez a los desarrolladores en el equipo.

entornos y recursos informáticosEn segundo plano, existen varias formas en las que puede conectar los entornos a los recursosinformáticos.

1

AWS Cloud9 Guía del usuario¿Qué puedo hacer con AWS Cloud9? (Resumen)

• Puede indicar a AWS Cloud9 que cree una instancia Amazon EC2 y, a continuación, conectar el entornoa esa instancia EC2 recién creada. Este tipo de configuración se denomina entorno de EC2.

• También puede indicar a AWS Cloud9 que conecte un entorno a una instancia informática en la nubeexistente o a su propio servidor. Este tipo de configuración se denomina entorno de SSH.

entornos de EC2 y entornos de SSH tienen algunas similitudes y algunas diferencias. Si es nuevo enAWS Cloud9, le recomendamos que utilice un entorno de EC2 porque AWS Cloud9 se encargará de granparte de la configuración de forma automática. A medida que aprenda más sobre AWS Cloud9 y deseeentender mejor estas similitudes y diferencias, consulte entornos de EC2 frente a entornos de SSH enAWS Cloud9 (p. 500).

Para obtener más información sobre cómo funciona AWS Cloud9, consulte estos vídeos (p. 4) ypáginas web (p. 4)relacionados.

¿Qué puedo hacer con AWS Cloud9? (Resumen)Con AWS Cloud9, puede codificar, compilar, ejecutar, probar, depurar y publicar software en muchassituaciones y variaciones interesantes. Incluyen (entre otros):

• Trabajar con código en varios lenguajes de programación y el Kit de desarrollo de la nube de AWS (AWSCDK).

• Trabajar con código en un contenedor Docker en ejecución.• Utilizar repositorios de código online.• Colaborar con otros usuarios en tiempo real.• Interactuar con varias tecnologías de bases de datos y sitios web.• Destinarse a aplicaciones sin servidor de AWS, Amazon API Gateway y AWS Lambda.• Beneficiarse de otros productos de AWS como Amazon Lightsail, AWS CodeStar y AWS CodePipeline.

Para obtener una lista más detallada, consulte ¿Qué puedo hacer con AWS Cloud9? (p. 2)

¿Cómo puedo comenzar?Para comenzar a utilizar AWS Cloud9, siga los pasos que se indican en Configuración de AWSCloud9 (p. 6) y, a continuación, siga el tutorial básico (p. 41).

Temas adicionales• ¿Qué puedo hacer con AWS Cloud9? (p. 2)• Información adicional sobre AWS Cloud9 (p. 4)

¿Qué puedo hacer con AWS Cloud9?Explore los siguientes recursos para obtener información acerca de cómo utilizar AWS Cloud9 en algunosescenarios comunes.

2

AWS Cloud9 Guía del usuario¿Qué puedo hacer con ella?

Escenarios clave

Escenario Recursos

Crear, ejecutar y depurar código en funciones deAWS Lambda, API de Amazon API Gateway yaplicaciones sin servidor.

Tutorial de AWS Lambda para AWSCloud9 (p. 350), Tutorial avanzado de AWSLambda para AWS Cloud9 (p. 368) y Trabajocon funciones AWS Lambda en el AWSCloud9 Integrated Development Environment(IDE) (p. 308)

Trabaje con instancias de Amazon Lightsailpreconfiguradas con conocidas aplicaciones ymarcos de trabajo como WordPress, LAMP (Linux,Apache, MySQL y PHP), Node.js, Nginx, Drupaly Joomla, además de con distribuciones Linuxcomo Amazon Linux, Ubuntu, Debian, FreeBSD yopenSUSE.

Trabajo con instancias de Amazon Lightsail en elAWS Cloud9 Integrated Development Environment(IDE) (p. 299)

Trabajo con código en proyectos de desarrollo desoftware de AWS y cadenas de herramientas deAWS CodeStar.

Trabajo con proyectos de AWS CodeStar en elAWS Cloud9 Integrated Development Environment(IDE) (p. 306)

Trabajo con código en soluciones de entregacontinua de AWS CodePipeline.

Trabajar con AWS CodePipeline en el AWSCloud9 Integrated Development Environment(IDE) (p. 347)

Automatizar los servicios de AWS mediante laAWS CLI y el aws-shell.

Muestra de AWS Command Line Interface y elaws-shell para AWS Cloud9 (p. 379)

Trabajo con repositorios de código fuente en AWSCodeCommit.

Ejemplo de AWS CodeCommit para AWSCloud9 (p. 382)

Trabajo con repositorios de código fuente enGitHub.

Ejemplo de GitHub para AWS Cloud9 (p. 388)

Trabajo con bases de datos de NoSQL en AmazonDynamoDB.

Ejemplo de Amazon DynamoDB para AWSCloud9 (p. 392)

Trabajar con las pilas de LAMP (Linux, ApacheHTTP Server, MySQL y PHP).

Ejemplo de LAMP para AWS Cloud9 (p. 411)

Trabaje con sitios web de WordPress. Ejemplo de WordPress para AWSCloud9 (p. 418)

Trabajo con código para Java y AWS SDK forJava.

Muestra de Java para AWS Cloud9 (p. 429)

Trabajo con código para C++ y AWS SDK para C++.

Demostración de C++ para AWS Cloud9 (p. 439)

Trabajo con código para Python y AWS SDK forPython (Boto).

Tutorial de Python para AWS Cloud9 (p. 448)

Trabajo con código para .NET Core y AWS SDKpara .NET.

Muestra de .NET Core para AWS Cloud9 (p. 452)

Trabajo con código para Node.js y AWS SDK forJavaScript.

Ejemplo de Node.js para AWS Cloud9 (p. 460)

3

AWS Cloud9 Guía del usuarioInformación adicional

Escenario Recursos

Trabajo con código para PHP y AWS SDK paraPHP.

Ejemplo de PHP para AWS Cloud9 (p. 465)

Trabajo con código para Ruby y AWS SDK pararRuby.

Tutorial: Ruby en AWS Cloud9 (p. 471)

Trabajo con código para Go y AWS SDK for Go. Ejemplo de Go para AWS Cloud9 (p. 477)

Trabajo con código para TypeScript y AWS SDKfor JavaScript.

Muestra de TypeScript para AWS Cloud9 (p. 483)

Trabaje con código para el Kit de desarrollo de lanube de AWS (AWS CDK).

Ejemplo de AWS CDK para AWS Cloud9 (p. 404)

Trabajo con el código en un contenedor Docker enejecución.

Ejemplo de Docker para AWS Cloud9 (p. 490)

Invite a que otras personas usen un entorno conusted, en tiempo real y con soporte de chat detexto

Trabajo con entornos compartidos en AWSCloud9 (p. 88)

Trabaje con código para aplicaciones de robóticainteligentes en AWS.

Desarrollo con AWS Cloud9 en la Guía paradesarrolladores de AWS RoboMaker

Información adicional sobre AWS Cloud9En este tema se proporciona más información para ayudarle a conocer mejor AWS Cloud9.

Temas• Vídeos relacionados (p. 4)• Temas relacionados en el sitio de AWS (p. 4)• Precios (p. 5)• Acerca de las versiones de Cloud9 (p. 5)• Tengo más preguntas o necesito ayuda (p. 5)

Vídeos relacionados• AWS re:Invent 2017 - Introducing AWS Cloud9: Werner Vogels Keynote (9 minutos, sitio web de

YouTube)• AWS re:Invent Launchpad 2017 - AWS Cloud9, (15 minutos, sitio web de YouTube)• Introducing AWS Cloud9 - AWS Online Tech Talks (33 minutos, sitio web de YouTube)• AWS Sydney Summit 2018: AWS Cloud9 and AWS CodeStar (25 minutos, sitio web de YouTube)

Temas relacionados en el sitio de AWS• Presentación de AWS Cloud9• AWS Cloud9: entornos para desarrolladores en la nube• Información general de AWS Cloud9• Características de AWS Cloud9

4

https://docs.aws.amazon.com/robomaker/latest/dg/cloud9.html

https://www.youtube.com/watch?v=fwFoU_Wb-fU

https://www.youtube.com/watch?v=NNqVBo9k8n4

https://www.youtube.com/watch?v=FvclLeg2vEQ

https://www.youtube.com/watch?v=B-nbl0qYsQg

https://aws.amazon.com/about-aws/whats-new/2017/11/introducing-aws-cloud9/

http://aws.amazon.com/blogs/aws/aws-cloud9-cloud-developer-environments/

https://aws.amazon.com/cloud9/

https://aws.amazon.com/cloud9/details/

AWS Cloud9 Guía del usuarioPrecios

• Preguntas frecuentes sobre AWS Cloud9

PreciosNo se aplican cargos adicionales por AWS Cloud9. Si utiliza una instancia de Amazon EC2 con el entornode desarrollo de AWS Cloud9, solo pagará por los recursos de cómputo y almacenamiento (por ejemplo,una instancia de Amazon EC2 y un volumen de Amazon EBS) que se utilicen para ejecutar y almacenar elcódigo. También puede conectar su entorno a un servidor Linux existente (por ejemplo, un servidor local)mediante SSH sin cargos adicionales.

Solo pagará por lo que consuma y a medida que lo haga: no se requieren pagos mínimos ni compromisosiniciales. Se le aplicarán las tarifas de AWS normales de cualquier recurso de AWS (por ejemplo, funcionesde AWS Lambda) que cree o utilice en el entorno.

Los clientes nuevos de AWS que reúnan los requisitos para la capa gratuita de AWS pueden usar AWSCloud9 gratis. Si el entorno utiliza otros recursos que no están en la capa gratuita de AWS, se le cobraránlas tarifas de AWS normales por estos recursos.

Para obtener más información, consulte los siguientes temas.

• Precios de AWS Cloud9: consulte Precios de AWS Cloud9.• Precios del servicio AWS: consulte Precios de Amazon EC2, Precios de Amazon EBS, Precios de AWS

Lambda y Precios de AWS.• La capa gratuita de AWS: consulte Uso de la capa gratuita de AWS y Seguimiento de su uso de la capa

gratuita en la Guía del usuario de AWS Billing and Cost Management.• Precios de formación académica: consulte el programa AWS Educate.

Acerca de las versiones de Cloud9Existen dos versiones de Cloud9: c9.io y AWS Cloud9. Esta Guía del usuario de AWS Cloud9 cubre soloAWS Cloud9.

c9.io solo está disponible para los usuarios de c9.io existentes, con funcionalidad limitada y solo duranteun periodo de tiempo limitado. Para obtener información sobre el estado actual y futuro de c9.io, consulteCloud9 now runs on and integrates with AWS en el sitio web de c9.io.

c9.io y AWS Cloud9 no son interoperables. No se puede utilizar una cuenta ni un workspace en c9.io conuna cuenta o entorno en AWS Cloud9.

Tengo más preguntas o necesito ayudaPara formular preguntas o buscar ayuda de la comunidad de AWS Cloud9, consulte el foro de debate deAWS Cloud9. (Cuando entre en este foro, es posible que AWS requiera que inicie sesión).

Consulte también nuestras preguntas frecuentes o contacte con nosotros directamente.

5

https://aws.amazon.com/cloud9/faqs/

https://aws.amazon.com/cloud9/pricing/

https://aws.amazon.com/ec2/pricing/

https://aws.amazon.com/ebs/pricing/

https://aws.amazon.com/lambda/pricing/


https://aws.amazon.com/pricing/

https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/billing-free-tier.html

https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/tracking-free-tier-usage.html

https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/tracking-free-tier-usage.html

https://aws.amazon.com/education/awseducate/

https://c9.io/announcement

https://forums.aws.amazon.com/forum.jspa?forumID=268


https://aws.amazon.com/cloud9/faqs/

https://aws.amazon.com/contact-us/

AWS Cloud9 Guía del usuarioConfiguración de usuario individual

Configuración de AWS Cloud9Para comenzar a utilizar AWS Cloud9, siga uno de estos conjuntos de procedimientos, en función de cómotenga previsto utilizar AWS Cloud9.

Patrón de uso Siga estos procedimientos

Soy la única persona que utiliza la cuenta de AWSy no soy un estudiante.

Configuración de usuario individual (p. 6)

Pertenezco a un equipo que tiene varios usuariosdentro de una cuenta de AWS.

Configuración de equipo (p. 8)

Pertenezco a una empresa que tiene una o variascuentas de AWS dentro de una única organización.

Configuración de empresa (p. 17)

Soy un estudiante1 y soy la única persona queutiliza la cuenta de AWS.

Configuración individual de estudiante (p. 30)

Soy un profesor2 y quiero que mis estudiantestrabajen en colaboración en un aula virtual.

Configuración de aula (p. 35)

1 Para obtener más información acerca de quiénes son "estudiantes" o "profesores", consulte ¿Quiénpuede unirse a AWS Educate? en el sitio web de Preguntas frecuentes de AWS Educate.

Para obtener información general sobre AWS Cloud9, consulte ¿Qué es AWS Cloud9? (p. 1)

Temas• Configuración de usuario individual para AWS Cloud9 (p. 6)• Configuración de equipos para AWS Cloud9 (p. 8)• Configuración de empresa para AWS Cloud9 (p. 17)• Opciones de configuración adicionales para AWS Cloud9 (Team y Enterprise) (p. 23)• Configuración individual de estudiante para AWS Cloud9 (p. 30)• Configuración de aula para AWS Cloud9 (p. 35)

Configuración de usuario individual para AWSCloud9

En este tema se explica cómo realizar la configuración para utilizar AWS Cloud9 como un único individuo(no estudiante) en la cuenta de AWS. Si va a configurar AWS Cloud9 para seguir cualquier otro patrónde uso, consulte Configuración de AWS Cloud9 (p. 6) para obtener las instrucciones correctas. Paraobtener más información sobre a quiénes se considera estudiantes, consulte ¿Quién puede unirse a AWSEducate? en el sitio web de Preguntas frecuentes de AWS Educate.

Para utilizar AWS Cloud9 como el único individuo en la cuenta de AWS, cree una cuenta de AWS, sitodavía no tiene una y, a continuación, inicie sesión en la consola de AWS Cloud9.

Paso 1: Crear una cuenta de AWSSi ya tiene una cuenta de AWS, vaya al Paso 2: Iniciar sesión en la consola de AWS Cloud9 con el usuarioraíz de la cuenta de AWS (p. 7).

6

https://www.awseducate.com/faqs#fa0Po00000043dVcEAI




AWS Cloud9 Guía del usuarioPaso 2: Iniciar sesión en la consola de AWS

Cloud9 con el usuario raíz de la cuenta de AWS

Para ver un vídeo de 4 minutos sobre el siguiente procedimiento, consulte el vídeo sobre cómo crear unacuenta de Amazon Web Services en el sitio web YouTube.

Para crear una cuenta de AWS

1. Vaya a https://aws.amazon.com.2. Elija Sign In to the Console (Iniciar sesión en la consola).3. Elija Create a new AWS account (Crear una nueva cuenta de AWS).4. Complete el proceso siguiendo las instrucciones que aparecen en pantalla. Esto incluye dar a AWS

su dirección de correo electrónico y los datos de la tarjeta de crédito. También debe utilizar el teléfonopara introducir un código que AWS le ofrece.

Una vez que haya terminado de crear la cuenta, AWS le enviará un correo electrónico de confirmación. Novaya al siguiente paso hasta que aparezca esta confirmación.

Paso 2: Iniciar sesión en la consola de AWS Cloud9con el usuario raíz de la cuenta de AWSUna vez completado el paso anterior, estará listo para iniciar sesión en la consola de AWS Cloud9 con unusuario raíz de la cuenta de AWS y comenzar a utilizar AWS Cloud9.

1. Abra la consola de AWS Cloud9 en https://console.aws.amazon.com/cloud9/.2. Escriba la dirección de correo electrónico de su cuenta de AWS y, a continuación, elija Next (Siguiente).

Note

Si ya se muestra una dirección de correo electrónico y no es la correcta, elija Sign in to adifferent account (Iniciar sesión con una cuenta diferente). Escriba la dirección de correoelectrónico correcta y, a continuación, elija Next (Siguiente).

3. Escriba la contraseña de la cuenta de AWS y seleccione Sign In (Iniciar sesión).

Se abre la consola de AWS Cloud9. Ahora puede comenzar a utilizar AWS Cloud9.

Important

Aunque puede iniciar sesión en la consola de AWS Cloud9 con la dirección de correo electrónicoy la contraseña que utilizó al crear su cuenta de AWS (llamamos a esto usuario raíz de lacuenta de AWS), no se trata de una práctica recomendada de seguridad de AWS. En el futuro,le recomendamos que inicie sesión como usuario administrador de AWS Identity and AccessManagement (IAM) en su cuenta de AWS. Para obtener más información, consulte Creación delprimer grupo y usuario administrador de IAM en la Guía del usuario de IAM y Tareas de AWS queexigen credenciales de usuario raíz de la cuenta de AWS en la Referencia general de AmazonWeb Services.

Pasos siguientes

Tarea de aprendizaje Consulte este tema

Obtenga información sobre cómo usar AWSCloud9 IDE.

Introducción: tutoriales básicos (p. 41) y Uso delIDE (p. 107)

7

https://www.youtube.com/watch?v=WviHsoz8yHk


https://aws.amazon.com

https://console.aws.amazon.com/cloud9/

https://docs.aws.amazon.com/IAM/latest/UserGuide/getting-started_create-admin-group.html


https://docs.aws.amazon.com/general/latest/gr/aws_tasks-that-require-root.html


AWS Cloud9 Guía del usuarioConfiguración de equipo

Tarea más avanzada Consulte este tema

Cree un entorno de desarrollo de AWS Cloud9 y, acontinuación, use el AWS Cloud9 IDE para trabajarcon el código en su nuevo entorno.

Creación de un entorno (p. 61)

Invite a que otras personas usen el nuevo entornocon usted, en tiempo real y con soporte de chat detexto.

Trabajo con entornos compartidos (p. 88)

Configuración de equipos para AWS Cloud9En este tema se explica cómo utilizar AWS Identity and Access Management (IAM) para permitir que variosusuarios dentro de una única cuenta de AWS utilicen AWS Cloud9. Si va a configurar AWS Cloud9 paraseguir cualquier otro patrón de uso, consulte Configuración de AWS Cloud9 (p. 6) para obtener lasinstrucciones correctas.

Estas instrucciones suponen que ya tiene (o tendrá) acceso administrativo a una única cuenta de AWS.Para obtener más información, consulte El usuario raíz de la cuenta de AWS y Creación del primer grupo yusuario administrador de IAM en la Guía del usuario de IAM. Si ya tiene una cuenta de AWS pero no tieneacceso administrativo a ella, consulte al administrador de su cuenta de AWS.

Note

Puede utilizar AWS Single Sign-On (SSO) en lugar de IAM para permitir que varios usuariosdentro de una única cuenta de AWS utilicen AWS Cloud9. En este patrón de uso, la únicacuenta de AWS sirve como la cuenta maestra de una organización en AWS Organizations; dichaorganización no tiene cuentas de miembros. Para utilizar AWS SSO, omita este tema y sigaen cambio las instrucciones de Configuración de empresa (p. 17). Para obtener informaciónrelacionada, consulte los recursos siguientes:

• ¿Qué es AWS Organizations? en la Guía del usuario de AWS Organization (AWS SSO requiereel uso de AWS Organizations)

• ¿Qué es AWS Single Sign-On? en la Guía del usuario de AWS Single Sign-On• El vídeo de 4 minutos Vídeos de AWS Knowledge Center: Cómo empezar con AWS

Organizations en el sitio web de YouTube• El vídeo de 7 minutos Administrar el acceso de usuarios a varias cuentas de AWS con AWS

Single Sign-on en el sitio web de YouTube• El vídeo de 9 minutos Cómo configurar AWS Single Sign On para usuarios de Active Directory

locales en el sitio web de YouTube

Para permitir que varios usuarios de una única cuenta de AWS comiencen a utilizar AWS Cloud9,comience con uno de los siguientes pasos, en función de los recursos de AWS de los que ya disponga.

¿Tiene una cuenta de AWS? ¿Tiene al menos un grupo y unusuario de IAM en esa cuenta?

Comience por este paso

No — Paso 1: Crear una cuenta deAWS (p. 9)

Sí No Paso 2: Crear un grupo y unusuario de IAM y añadir elusuario al grupo (p. 9)

8

https://aws.amazon.com/iam/

https://docs.aws.amazon.com/IAM/latest/UserGuide/id_root-user.html



https://aws.amazon.com/single-sign-on/

https://docs.aws.amazon.com/organizations/latest/userguide/orgs_introduction.html

https://docs.aws.amazon.com/singlesignon/latest/userguide/what-is.html

https://www.youtube.com/watch?v=mScBPL8VV48


https://www.youtube.com/watch?v=bXrsUEI1V38


https://www.youtube.com/watch?v=nuPjljOVZmU


AWS Cloud9 Guía del usuarioPaso 1: Crear una cuenta de AWS

¿Tiene una cuenta de AWS? ¿Tiene al menos un grupo y unusuario de IAM en esa cuenta?

Comience por este paso

Sí Sí Paso 3: Añadir permisos deacceso de AWS Cloud9 algrupo (p. 13)

Paso 1: Crear una cuenta de AWSNote

Es posible que su organización ya tenga una cuenta de AWS configurada. Si su organizacióntiene un administrador de cuenta de AWS, compruebe con esa persona antes de comenzar elprocedimiento siguiente. Si ya tiene una cuenta de AWS, vaya al Paso 2: Crear un grupo y unusuario de IAM y añadir el usuario al grupo (p. 9).


Para crear una cuenta de AWS




Paso 2: Crear un grupo y un usuario de IAM y añadirel usuario al grupoEn este paso, creará un grupo y un usuario de AWS Identity and Access Management (IAM), añadiráel usuario al grupo y, a continuación, empleará el usuario para obtener acceso a AWS Cloud9. Esta esuna práctica recomendada de seguridad de AWS. Para obtener más información, consulte Prácticasrecomendadas de IAM en la Guía del usuario de IAM.

Si ya tiene todos los grupos y usuarios de IAM que necesita, vaya al Paso 3: Añadir permisos de acceso deAWS Cloud9 al grupo (p. 13).

Note

Es posible que su organización ya tenga un grupo y un usuario de IAM configurados. Si suorganización tiene un administrador de cuenta de AWS, consulte con esa persona antes decomenzar los procedimientos siguientes.

Puede completar estas tareas con la consola de administración de AWS (p. 10) o la interfaz de línea decomandos de AWS (CLI de AWS) (p. 10).

Para ver un vídeo de 9 minutos relacionado con los siguientes procedimientos de la consola, consulte Howdo I set up an IAM user and sign in to the AWS Management Console using IAM credentials en el sitio webde YouTube.

9




https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html

https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html

https://www.youtube.com/watch?v=XMi5fXL2Hes

https://www.youtube.com/watch?v=XMi5fXL2Hes

AWS Cloud9 Guía del usuarioPaso 2: Crear un grupo y un usuariode IAM y añadir el usuario al grupo

Paso 2.1: Crear un grupo de IAM con la consola1. Inicie sesión en la consola de administración de AWS, si todavía no lo ha hecho, https://

console.aws.amazon.com.

Note

Aunque puede iniciar sesión en la consola de administración de AWS con la dirección decorreo electrónico y la contraseña que se proporcionó cuando se creó la cuenta de AWS(llamamos a esto usuario raíz de la cuenta de AWS), esta no es una práctica recomendadade seguridad de AWS. En el futuro, le recomendamos que inicie sesión con las credencialesde un usuario administrador de IAM en la cuenta de AWS. Un usuario administrador de IAMtiene permisos de acceso a AWS similares a un usuario raíz de cuenta de AWS y evita algunosde los riesgos de seguridad asociados. Si no puede iniciar sesión como usuario administradorde IAM, consulte con el administrador de su cuenta de AWS. Para obtener más información,consulte Creación del primer grupo y usuario administrador de IAM en la Guía del usuario deIAM.

2. Abra la consola de IAM. Para ello, en la barra de navegación de AWS, elija Services (Servicios). Acontinuación, elija IAM.

3. En el panel de navegación de la consola de IAM, elija Groups (Grupos).4. Elija Create New Group (Crear nuevo grupo).5. En la página Set Group Name (Establecer nombre de grupo), en Group Name (Nombre de grupo),

escriba un nombre para el nuevo grupo.6. Seleccione Next Step.7. En la página Attach Policy (Adjuntar política), seleccione Next Step (Paso siguiente) sin adjuntar

ninguna política. (Es preciso adjuntar una política en el Paso 3: Añadir permisos de acceso de AWSCloud9 al Grupo) (p. 13).

8. Elija Create Group.

Note

Le recomendamos que repita este procedimiento para crear al menos dos grupos: unopara usuarios de AWS Cloud9 y otro para administradores de AWS Cloud9. Esta prácticarecomendada de seguridad de AWS puede ayudarle a controlar, realizar un seguimiento ysolucionar mejor los problemas de acceso a los recursos de AWS.

Avance hasta llegar al Paso 2.2: Crear un usuario de IAM y añadir el usuario el grupo con laconsola (p. 11).

Paso 2.1: Crear una pila de IAM con la AWS CLINote

Si usa credenciales temporales administradas de AWS (p. 537), no puede usar una sesión determinal en el AWS Cloud9 IDE para ejecutar algunos o todos los comandos de esta sección.Para abordar las prácticas recomendadas de seguridad de AWS, credenciales temporalesadministradas de AWS no permiten que se ejecuten algunos comandos. En su lugar, puedeejecutar esos comandos desde una instalación independiente de la AWS Command Line Interface(AWS CLI).

1. Si todavía no lo ha hecho, instale y configure la AWS CLI en su equipo. Para ello, consulte lo siguienteen la AWS Command Line Interface Guía del usuario:• Instalación de la interfaz de línea de comandos de AWS• Configuración rápida

10

https://console.aws.amazon.com



https://docs.aws.amazon.com/cli/latest/userguide/installing.html

https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html#cli-quick-configuration


Note

Aunque puede configurar la AWS CLI mediante las credenciales asociadas con la direcciónde correo electrónico y la contraseña que se proporcionó cuando se creó la cuenta deAWS (llamamos a esto usuario raíz de una cuenta de AWS), esta no es una prácticarecomendada de seguridad de AWS. En cambio, le recomendamos que configure la AWS CLIcon las credenciales de un usuario administrador de IAM de la cuenta de AWS. Un usuarioadministrador de IAM tiene permisos de acceso a AWS similares a un usuario raíz de cuentade AWS y evita algunos de los riesgos de seguridad asociados. Si no puede configurar la AWSCLI como usuario administrador de IAM, consulte con el administrador de su cuenta de AWS.Para obtener más información, consulte Creación del primer grupo y usuario administrador deIAM en la Guía del usuario de IAM.

2. Ejecute el comando create-group de IAM, especificando el nombre del nuevo grupo (por ejemplo,MyCloud9Group).

aws iam create-group --group-name MyCloud9Group

Note

Le recomendamos que repita este procedimiento para crear al menos dos grupos: unopara usuarios de AWS Cloud9 y otro para administradores de AWS Cloud9. Esta prácticarecomendada de seguridad de AWS puede ayudarle a controlar, realizar un seguimiento ysolucionar mejor los problemas de acceso a los recursos de AWS.

Avance hasta llegar al Paso 2.2: Crear un usuario de IAM y añadir el usuario el grupo con la CLI deAWS (p. 12).

Paso 2.2: Crear un usuario de IAM y añadirlo el grupo con laconsola1. Con la consola de IAM abierta del procedimiento anterior, en el panel de navegación, elija Users

(Usuarios).2. Elija Add user.3. En User name (Nombre de usuario), escriba un nombre para el usuario nuevo.

Note

Puede crear varios usuarios al mismo tiempo. Para ello, elija Add another user (Agregar otrousuario). El resto de la configuración de este procedimiento se aplican a cada uno de estosnuevos usuarios.

4. Marque las casillas Programmatic access (Acceso mediante programa) y AWS Management Consoleaccess (Acceso a la consola de administración de AWS). Esto permite al nuevo usuario utilizar variasherramientas para desarrolladores y consolas de servicio de AWS.

5. Deje la opción predeterminada de Autogenerated password (Contraseña autogenerada). Esto crea unacontraseña aleatoria para que el nuevo usuario inicie sesión en la consola. O elija Custom password(Contraseña personalizada) y escriba una contraseña específica para el nuevo usuario.

6. Deje la opción predeterminada de Require password reset (Pedir restablecimiento de contraseña). Deeste modo, se solicitará al usuario nuevo que cambie la contraseña después de iniciar sesión en laconsola por primera vez.

7. Elija Next: Permissions.8. Deje la opción predeterminada Add user to group (Añadir usuario al grupo) (o Add users to group

(Añadir usuarios al grupo) para varios usuarios).

11




9. En la lista de grupos, marque la casilla (no el nombre) situada junto al grupo al que desea añadir elusuario.

10.Elija Next: Review.11.Elija Create user (Crear usuario) (o Create users (Crear usuarios) para varios usuarios).12.En la última página del asistente, realice una de las siguientes acciones:

• Junto a cada usuario nuevo, elija Send email (Enviar un correo electrónico) y siga las instruccionesen pantalla para enviar un correo electrónico al usuario nuevo con el nombre de usuario y la URL deinicio de sesión en la consola. A continuación, comunique a cada usuario nuevo la contraseña deinicio sesión en la consola, el ID de la clave de acceso de AWS y la clave de acceso secreta de AWSpor separado.

• Seleccione Download.csv. A continuación, comunique a cada usuario nuevo la URL de inicio sesiónen la consola, la contraseña de inicio de sesión en la consola, el ID de clave de acceso de AWS y laclave de acceso secreta de AWS que encuentra en el archivo descargado.

• Junto a cada usuario nuevo, elija Show (Mostrar) para Secret access key (Clave de acceso secreta)y Password (Contraseña). A continuación, comunique a cada usuario nuevo la URL de inicio sesiónen la consola, la contraseña de inicio de sesión en la consola, el ID de clave de acceso de AWS y laclave de acceso secreta de AWS.

Note

Si no elige Download.csv, esta es la única vez que puede ver la nueva clave de acceso secretade AWS y la contraseña de inicio sesión en la consola del usuario. Para generar una nuevaclave de acceso secreta de AWS o una contraseña de inicio de sesión en la consola para elnuevo usuario, consulte lo siguiente en la Guía del usuario de IAM.• Creación, modificación y visualización de claves de acceso (consola)• Creación, cambio o eliminación de la contraseña de un usuario de IAM (consola)

13.Repita este procedimiento para cada usuario de IAM adicional que desee crear y, a continuación, vayaal Paso 3: Añadir permisos de acceso de AWS Cloud9 al grupo (p. 13).

Paso 2.2: Crear un usuario de IAM y añadirlo el grupo con laAWS CLI

Note


1. Ejecute el comando create-user de IAM para crear el usuario, especificando su nombre (por ejemplo,MyCloud9User).

aws iam create-user --user-name MyCloud9User

2. Ejecute el comando create-login-profile de IAM para crear una nueva contraseña de iniciode sesión en la consola para el usuario, especificando el nombre y la contraseña de inicio de sesióninicial del usuario (por ejemplo, MyC10ud9Us3r!). Una vez que el usuario inicia sesión, AWS solicita alusuario que cambie la contraseña de inicio de sesión.

aws iam create-login-profile --user-name MyCloud9User --password MyC10ud9Us3r! --password-reset-required

12

https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html#Using_CreateAccessKey

https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_passwords_admin-change-user.html#id_credentials_passwords_admin-change-user_console

AWS Cloud9 Guía del usuarioPaso 3: Añadir permisos de

acceso para AWS Cloud9 al grupo

Si más adelante tienen necesidad de generar una contraseña de sustitución de inicio de sesión en laconsola para el usuario, consulte Creación, cambio o eliminación de la contraseña de un usuario de IAM(API, CLI, PowerShell) en la Guía del usuario de IAM.

3. Ejecute el comando create-access-key de IAM para crear una clave de acceso de AWS nueva y lacorrespondiente clave de acceso secreta de AWS para el usuario.

aws iam create-access-key --user-name MyCloud9User

Apunte los valores AccessKeyId y SecretAccessKey que se muestran. Después de ejecutar elcomando create-access-key de IAM, esta es la única vez puede ver la clave de acceso secretade AWS del usuario. Si más adelante tiene necesidad de generar una nueva clave de acceso secretade AWS para el usuario, consulte Creación, cambio y visualización de claves de acceso (API, CLI,PowerShell) en la Guía del usuario de IAM.

4. Ejecute el comando add-user-to-group de IAM para añadir el usuario al grupo, especificando losnombres del usuario y del grupo.

aws iam add-user-to-group --group-name MyCloud9Group --user-name MyCloud9User

5. Comunique al usuario la URL de inicio sesión en la consola, la contraseña de inicio de sesión inicial enla consola, el ID de clave de acceso de AWS y la clave de acceso secreta de AWS.

6. Repita este procedimiento para cada usuario de IAM adicional que desea crear.

Paso 3: Añadir permisos de acceso para AWS Cloud9al grupoDe forma predeterminada, la mayoría de los grupos y usuarios de IAM no tienen acceso a los serviciosde AWS, entre los que se incluye AWS Cloud9. (Una excepción son los grupos de administrador de IAM yusuarios administradores de IAM, que tienen acceso a todos los servicios de AWS en su cuenta de AWSde forma predeterminada). En este paso, utilizará IAM para añadir permisos de acceso de AWS Cloud9directamente a un grupo IAM al que pertenecen uno o varios usuarios, de modo que se asegure de quedichos usuarios tienen acceso a AWS Cloud9.

Note

Es posible que su organización ya disponga de un grupo creado con los permisos de accesoadecuados. Si su organización tiene un administrador de cuenta de AWS, compruebe con esapersona antes de comenzar el procedimiento siguiente.

Puede completar esta tarea utilizando la consola de administración de AWS (p. 13) o la CLI deAWS (p. 15).

Añadir permisos de AWS Cloud9 al grupo con la consola1. Inicie sesión en la consola de administración de AWS, si todavía no lo ha hecho, https://

console.aws.amazon.com/.

Note

Aunque puede iniciar sesión en la consola de administración de AWS con la dirección decorreo electrónico y la contraseña que se proporcionó cuando se creó la cuenta de AWS(llamamos a esto usuario raíz de la cuenta de AWS), esta no es una práctica recomendadade seguridad de AWS. En el futuro, le recomendamos que inicie sesión con las credencialesde un usuario administrador de IAM en la cuenta de AWS. Un usuario administrador de IAM

13

https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_passwords_admin-change-user.html#Using_ManagingPasswordsCLIAPI

https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_passwords_admin-change-user.html#Using_ManagingPasswordsCLIAPI

https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html#Using_CreateAccessKey_CLIAPI


https://console.aws.amazon.com/

https://console.aws.amazon.com/



tiene permisos de acceso a AWS similares a un usuario raíz de cuenta de AWS y evita algunosde los riesgos de seguridad asociados. Si no puede iniciar sesión como usuario administradorde IAM, consulte con el administrador de su cuenta de AWS. Para obtener más información,consulte Creación del primer grupo y usuario administrador de IAM en la Guía del usuario deIAM.

2. Abra la consola de IAM. Para ello, en la barra de navegación de AWS, elija Services (Servicios). Acontinuación, elija IAM.

3. Seleccione Groups (Grupos).4. Elija el nombre del grupo.5. Decida si desea añadir permisos de acceso de usuario de AWS Cloud9 o de administrador de AWS

Cloud9 al grupo. Estos permisos se aplicarán a cada usuario del grupo.

Los permisos de acceso de los usuarios de AWS Cloud9 permiten que cada usuario del grupo haga lassiguientes cosas en la cuenta de AWS:• Crear entornos de desarrollo de AWS Cloud9.• Obtener información acerca de sus entornos.• Cambiar la configuración para sus entornos.

Los permisos de acceso de administrador de AWS Cloud9 permiten que cada usuario del grupo hagacosas adicionales en la cuenta de AWS:• Crear entornos propios o para otros.• Obtener información acerca de entornos para sí mismos o para otros.• Eliminar entornos propios o de otros.• Cambiar la configuración de entornos propios o de otros.

Note

Le recomendamos que añada un número limitado de usuarios al grupo de administradores deAWS Cloud9. Esta práctica recomendada de seguridad de AWS puede ayudarle a controlar,realizar un seguimiento y solucionar mejor los problemas de acceso a los recursos de AWS.

6. En la pestaña Permissions (Permisos), en Managed Policies (Políticas administradas), seleccione AttachPolicy (Adjuntar política).

7. En la lista con los nombres de las políticas, active la casilla situada junto a AWSCloud9User para lospermisos de acceso de los usuarios de AWS Cloud9 o AWSCloud9Administrator para los permisosde acceso de administrador de AWS Cloud9. (Si no ve ninguno de los nombres de política en la lista,escriba el nombre de la política en el cuadro Filter [Filtrar] para mostrarlo).

8. Elija Attach Policy.

Note

Si tiene más de un grupo al que desea añadir permisos de acceso de AWS Cloud9, repita esteprocedimiento para cada uno de esos grupos.

Para ver la lista de los permisos de acceso que estas políticas administradas de AWS dan a un grupo,consulte Políticas administradas (predefinidas) de AWS (p. 525).

Para obtener más información acerca de los permisos de acceso de AWS que puede añadir a un grupoademás de los permisos de acceso que exige AWS Cloud9, consulte Políticas administradas y políticasinsertadas y Permisos concedidos por una política en la Guía del usuario de IAM.

Avance hasta el Paso 4: Iniciar sesión en la consola de AWS Cloud9 (p. 16).

14


https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html


https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_understand.html



Añadir permisos de AWS Cloud9 al grupo con la AWS CLINote


1. Si todavía no lo ha hecho, instale y configure la AWS CLI en su equipo. Para ello, consulte lo siguienteen la AWS Command Line Interface Guía del usuario:• Instalación de la interfaz de línea de comandos de AWS• Configuración rápida

Note

Aunque puede configurar la AWS CLI mediante las credenciales asociadas con la direcciónde correo electrónico y la contraseña que se proporcionó cuando se creó la cuenta deAWS (llamamos a esto usuario raíz de una cuenta de AWS), esta no es una prácticarecomendada de seguridad de AWS. En cambio, le recomendamos que configure la AWS CLIcon las credenciales de un usuario administrador de IAM de la cuenta de AWS. Un usuarioadministrador de IAM tiene permisos de acceso a AWS similares a un usuario raíz de cuentade AWS y evita algunos de los riesgos de seguridad asociados. Si no puede configurar la AWSCLI como usuario administrador de IAM, consulte con el administrador de su cuenta de AWS.Para obtener más información, consulte Creación del primer grupo y usuario administrador deIAM en la Guía del usuario de IAM.

2. Decida si desea añadir permisos de acceso de usuario de AWS Cloud9 o de administrador de AWSCloud9 al grupo. Estos permisos se aplicarán a cada usuario del grupo.

Los permisos de acceso de los usuarios de AWS Cloud9 permiten que cada usuario del grupo haga lassiguientes cosas en la cuenta de AWS:• Crear entornos de desarrollo de AWS Cloud9.• Obtener información acerca de sus entornos.• Cambiar la configuración para sus entornos.

Los permisos de acceso de administrador de AWS Cloud9 permiten que cada usuario del grupo hagacosas adicionales en la cuenta de AWS, como las siguientes:• Crear entornos propios o para otros.• Obtener información acerca de entornos para sí mismos o para otros.• Eliminar entornos propios o de otros.• Cambiar la configuración de entornos propios o de otros.

Note

Le recomendamos que añada un número limitado de usuarios al grupo de administradores deAWS Cloud9. Esta práctica recomendada de seguridad de AWS puede ayudarle a controlar,realizar un seguimiento y solucionar mejor los problemas de acceso a los recursos de AWS.

3. Ejecute el comando attach-group-policy de IAM especificando el nombre del grupo y el nombre derecurso de Amazon (ARN) de la política de permisos de acceso de AWS Cloud9 que se agregarán.

Para los permisos de acceso de usuario de AWS Cloud9, especifique el siguiente ARN.

aws iam attach-group-policy --group-name MyCloud9Group --policy-arn arn:aws:iam::aws:policy/AWSCloud9User

15





AWS Cloud9 Guía del usuarioPaso 4: Iniciar sesión en la consola de AWS Cloud9

Para los permisos de acceso de administrador de AWS Cloud9, especifique el siguiente ARN.

aws iam attach-group-policy --group-name MyCloud9Group --policy-arn arn:aws:iam::aws:policy/AWSCloud9Administrator

Note

Si tiene más de un grupo al que desea añadir permisos de acceso de AWS Cloud9, repita esteprocedimiento para cada uno de esos grupos.

Para ver la lista de los permisos de acceso que estas políticas administradas de AWS dan a un grupo,consulte Políticas administradas (predefinidas) de AWS (p. 525).

Para obtener más información acerca de los permisos de acceso de AWS que puede añadir a un grupoademás de los permisos de acceso que exige AWS Cloud9, consulte Políticas administradas y políticasinsertadas y Permisos concedidos por una política en la Guía del usuario de IAM.

Paso 4: Iniciar sesión en la consola de AWS Cloud9Una vez completados los pasos anteriores de este tema, usted y sus usuarios pueden iniciar sesión en laconsola de AWS Cloud9 y comenzar a utilizarla.

1. Si ya ha iniciado sesión en la Consola de administración de AWS como usuario raíz de una cuenta deAWS, cierre la sesión de la consola.

2. Abra la consola de AWS Cloud9, en https://console.aws.amazon.com/cloud9/.3. Escriba el número de cuenta de AWS para el usuario de IAM que ha creado o identificado anteriormente

y, a continuación, haga clic en Next (Siguiente).

Note

Si no ve una opción para escribir el número de cuenta de AWS, elija Sign in to a differentaccount (Iniciar sesión con una cuenta diferente). Escriba el número de cuenta de AWS en lapágina siguiente y, a continuación, seleccione Next (Siguiente).

4. Escriba el nombre y la contraseña del usuario de IAM que ha creado o identificado anteriormente y, acontinuación, elija Sign In (Iniciar sesión).

5. Si se le solicita, siga las instrucciones que aparecen en pantalla para cambiar su contraseña de inicio desesión inicial de usuario. Guarde la nueva contraseña de inicio de sesión en un lugar seguro.

Se muestra la consola de AWS Cloud9 y puede empezar a usar AWS Cloud9.

Pasos siguientes

Tarea Consulte este tema

Restrinja el uso de AWS Cloud9 para otrosusuarios en su cuenta de AWS, para controlarcostos.

Opciones de configuración adicionales (p. 23)



16





AWS Cloud9 Guía del usuarioConfiguración de empresa






Configuración de empresa para AWS Cloud9En este tema se explica cómo utilizar AWS Single Sign-On (SSO) para permitir que una o varias cuentasde AWS utilicen AWS Cloud9 dentro de una empresa. Si va a configurar AWS Cloud9 para seguir cualquierotro patrón de uso, consulte Configuración de AWS Cloud9 (p. 6) para obtener las instruccionescorrectas.

Estas instrucciones suponen que tiene (o tendrá) acceso administrativo a la organización en AWSOrganizations. Si aún no tiene acceso administrativo a la organización en AWS Organizations, consulte aladministrador de su cuenta de AWS. Para obtener más información, consulte los recursos siguientes:

• Administración de permisos en su organización de AWS en la Guía del usuario de AWS Organizations(AWS SSO requiere el uso de AWS Organizations)

• Introducción a la administración de permisos de acceso para los recursos de AWS SSO en la Guía delusuario de AWS Single Sign-On

Para obtener información básica relacionada con este tema, consulte los siguientes recursos:

• ¿Qué es AWS Organizations? en la Guía del usuario de AWS Organization (AWS SSO requiere el usode AWS Organizations)

• ¿Qué es AWS Single Sign-On? en la Guía del usuario de AWS Single Sign-On• El vídeo de 4 minutos Vídeos de AWS Knowledge Center: Cómo empezar con AWS Organizations en el

sitio web de YouTube• El vídeo de 7 minutos Administrar el acceso de usuarios a varias cuentas de AWS con AWS Single Sign-

on en el sitio web de YouTube• El vídeo de 9 minutos Cómo configurar AWS Single Sign On para usuarios de Active Directory locales en

el sitio web de YouTube

El siguiente diagrama conceptual muestra lo que obtendrá.

Para permitir que una o más cuentas de AWS comiencen a utilizar AWS Cloud9 dentro de la empresa,comience con uno de los siguientes pasos, en función de los recursos de AWS que ya tenga.

17

https://aws.amazon.com/single-sign-on/

https://docs.aws.amazon.com/organizations/latest/userguide/orgs_permissions_overview.html

https://docs.aws.amazon.com/singlesignon/latest/userguide/iam-auth-access-overview.html

https://docs.aws.amazon.com/organizations/latest/userguide/orgs_introduction.html

https://docs.aws.amazon.com/singlesignon/latest/userguide/what-is.html





AWS Cloud9 Guía del usuarioPaso 1: Crear una cuenta maestra para la organización

¿Tiene unacuenta de AWSque sirve opuede servircomo la cuentamaestra parala organizaciónen AWSOrganizations?

¿Tiene unaorganizaciónen AWSOrganizationspara esacuentamaestra?

¿Son todaslas cuentas deAWS deseadasmiembrosde esaorganización?

¿Está laorganizaciónconfiguradapara utilizarAWS SSO?

¿Está laorganizaciónconfiguradacon todoslos usuarioso gruposdeseados quequieren usarAWS Cloud9?

Comience poreste paso

No — — — — Paso 1: Crearuna cuentamaestra para laorganización (p. 18)

Sí No — — — Paso 2:Crear unaorganizaciónpara la cuentamaestra (p. 19)

Sí Sí No — — Paso 3: Añadircuentas demiembros a laorganización (p. 19)

Sí Sí Sí No — Paso 4:Activar AWSSSO en laorganización (p. 20)

Sí Sí Sí Sí No Paso 5.Configurarusuariosy gruposdentro de laorganización (p. 20)

Sí Sí Sí Sí Sí Paso 6.Habilitarusuariosy gruposdentro de laorganizaciónpara utilizarAWSCloud9 (p. 21)

Paso 1: Crear una cuenta maestra para laorganización

Note

Es posible que su empresa ya tenga una cuenta maestra configurada. Si su empresa tiene unadministrador de cuenta de AWS, consulte a esa persona antes de comenzar el procedimiento

18

AWS Cloud9 Guía del usuarioPaso 2: Crear una organización para la cuenta maestra

siguiente. Si ya tiene una cuenta maestra, vaya al Paso 2: Crear una organización para la cuentamaestra (p. 19).

Para usar Inicio de sesión único de AWS (AWS SSO), debe tener una cuenta de AWS que servirá comocuenta maestra para la organización en AWS Organizations. Para obtener más información, consulte laexplicación sobre las cuentas maestras en Conceptos y terminología de AWS Organizations en la Guía delusuario de AWS Organizations.


Para crear una cuenta maestra:




Paso 2: Crear una organización para la cuentamaestra

Note

Es posible que su empresa ya tenga AWS Organizations configurado para usar la cuenta maestra.Si su empresa tiene un administrador de cuenta de AWS, consulte a esa persona antes decomenzar el procedimiento siguiente. Si ya tiene AWS Organizations configurado para utilizar lacuenta maestra, vaya al Paso 3: Añadir cuentas de miembros a la organización (p. 19).

Para utilizar AWS SSO, debe disponer de una organización en AWS Organizations que utiliza la cuentamaestra. Para obtener más información, consulte el debate sobre organizaciones en Conceptos yterminología de AWS Organizations en la Guía del usuario de AWS Organizations.

Para crear una organización en AWS Organizations para la cuenta maestra de AWS, siga estasinstrucciones en la Guía de usuario de AWS Organizations:

1. Crear una organización2. Habilitar todas las características en la organización

Para ver el vídeo de 4 minutos relacionado con estos procedimientos, consulte Vídeos de AWS KnowledgeCenter: Cómo comenzar con AWS Organizations en el sitio web de YouTube.

Paso 3: Añadir cuentas de miembros a la organizaciónNote

Es posible que su empresa ya tenga AWS Organizations configurado para usar las cuentas delos miembros deseados. Si su empresa tiene un administrador de cuenta de AWS, consultea esa persona antes de comenzar el procedimiento siguiente. Si ya tiene AWS Organizations

19

https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html






https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_create.html

https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_support-all-features.html



AWS Cloud9 Guía del usuarioPaso 4: Habilitar AWS SSO en la organización

configurado con las cuentas de los miembros deseados, vaya al Paso 4: Habilitar AWS SSO en laorganización (p. 20).

En este paso, añada las cuentas de AWS que servirán de cuentas de miembros para la organización enAWS Organizations. Para obtener más información, consulte la explicación sobre las cuentas de miembrosen Conceptos y terminología de AWS Organizations en la Guía del usuario de AWS Organizations.

Note

No es necesario añadir cuentas de miembros a la organización. Puede utilizar AWS SSO con solola única cuenta maestra de la organización. Posteriormente, puede agregar cuentas de miembrosa la organización, si lo desea. Si no desea añadir cuentas de miembros ahora, vaya al Paso 4:Habilitar AWS SSO en la organización (p. 20).

Para añadir cuentas miembro a la organización en AWS Organizations, siga uno o ambos de los siguientesconjuntos de instrucciones en la Guía del usuario de AWS Organizations. Repita estas instrucciones tantasveces como sea necesario hasta que tenga todas las cuentas de AWS que desee como miembros de laorganización:

• Creación de una cuenta de AWS en la organización• Invitar una cuenta de AWS a unirse a su organización

Paso 4: Habilitar AWS SSO en la organizaciónNote

Es posible que su empresa ya tenga AWS Organizations configurado para usar AWS SSO. Si suempresa tiene un administrador de cuenta de AWS, consulte a esa persona antes de comenzar elprocedimiento siguiente. Si ya tiene AWS Organizations configurado para utilizar AWS SSO, vayaal Paso 5. Configurar usuarios y grupos dentro de la organización (p. 20).

En este paso, habilitará la organización en AWS Organizations que va a utilizar AWS SSO. Para ello, sigaestos conjuntos de instrucciones en la Guía del usuario de AWS Single Sign-On:

1. Requisitos previos de AWS SSO2. Habilitar AWS SSO

Paso 5. Configurar usuarios y grupos dentro de laorganización

Note

Es posible que su empresa ya tenga AWS Organizations configurado con grupos y usuarios deun directorio de AWS SSO o de un directorio de AWS Managed Microsoft AD o AD Connectorque se administra en AWS Directory Service. Si su empresa tiene un administrador de cuenta deAWS, consulte a esa persona antes de comenzar el procedimiento siguiente. Si ya tiene AWSOrganizations configurado con grupos y usuarios de un directorio de AWS SSO o de un directoriode AWS Directory Service, vaya al Paso 6. Habilitar usuarios y grupos dentro de la organizaciónpara utilizar AWS Cloud9 (p. 21).

En este paso, creará grupos y usuarios en un directorio de AWS SSO para la organización o se conectaráa un directorio de AWS Managed Microsoft AD o AD Connector que se administra en AWS DirectoryService para la organización. En un paso posterior, dará a los grupos los permisos de acceso necesariospara utilizar AWS Cloud9.

20


https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_accounts_create.html

https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_accounts_invites.html

https://docs.aws.amazon.com/singlesignon/latest/userguide/prereqs.html

https://docs.aws.amazon.com/singlesignon/latest/userguide/step1.html

AWS Cloud9 Guía del usuarioPaso 6. Habilitar usuarios y grupos dentro

de la organización para utilizar AWS Cloud9

• Si ya utiliza un directorio de AWS SSO para la organización, siga estos conjuntos de instrucciones en laGuía del usuario de AWS Single Sign-On. Repita estos pasos tantas veces como sea necesario hastaque tenga todos los grupos y usuarios que desea:1. Añadir grupos. Le recomendamos que cree al menos un grupo para los administradores de AWS

Cloud9 en toda la organización y, a continuación, repita este paso para crear otro grupo para todoslos usuarios de AWS Cloud9 en toda la organización. Si lo prefiere, también puede repetir este pasopara crear un tercer grupo para todos los usuarios en la organización con quienes desee compartir losentornos de desarrollo de AWS Cloud9 existentes, pero sin permitirles crear entornos por sí mismos.Para facilitar el uso, le recomendamos que llame a estos grupos AWSCloud9Administrators,AWSCloud9Users y AWSCloud9EnvironmentMembers, respectivamente. Para obtener másinformación, consulte Políticas administradas (predefinidas) de AWS para AWS Cloud9 (p. 525).

2. Añadir usuarios.3. Añadir usuarios a grupos. Agregue administradores de AWS Cloud9 al grupo

AWSCloud9Administrators, repita este paso para añadir usuarios de AWS Cloud9 al grupoAWSCloud9Users y, opcionalmente, repita este paso para añadir los usuarios restantes al grupoAWSCloud9EnvironmentMembers. Añadir usuarios a grupos es una práctica recomendada deseguridad de AWS que puede ayudarle a controlar, realizar un seguimiento y solucionar mejor losproblemas de acceso a los recursos de AWS.

• Si utiliza un directorio de AWS Managed Microsoft AD o AD Connector que se administra en AWSDirectory Service para la organización, siga las instrucciones en Conectarse a un directorio de MicrosoftAD en la Guía del usuario de AWS Single Sign-On.

Paso 6. Habilitar usuarios y grupos dentro de laorganización para utilizar AWS Cloud9De forma predeterminada, la mayoría de los usuarios y grupos en una organización de AWS Organizationsno tiene acceso a los servicios de AWS, entre los que se incluye AWS Cloud9. En este paso, utilizaráAWS SSO para permitir a grupos y usuarios en una organización en AWS Organizations que utilicen AWSCloud9 en cualquier combinación de cuentas de participantes.

1. En la consola de AWS SSO, elija AWS accounts (Cuentas de AWS) en el panel de navegación delservicio.

2. Elija la pestaña Permission sets (Conjuntos de permisos).3. Elija Create permission set (Crear conjunto de permisos).4. Seleccione Create a custom permission set (Crear un conjunto de permisos personalizado).5. Escriba un Name (Nombre) para este conjunto de permisos. Le recomendamos que cree al menos

un permiso para los administradores de AWS Cloud9 en toda la organización y, a continuación,repita los pasos 3 a 10 de este procedimiento para crear otro conjunto de permisos para todos losusuarios de AWS Cloud9 en toda la organización. Si lo prefiere, también puede repetir los pasos 3a 10 de este procedimiento para crear un tercer conjunto de permisos para todos los usuarios en laorganización con quienes desee compartir los entornos de desarrollo de AWS Cloud9 existentes,sin permitirles crear entornos por sí mismos. Para facilitar el uso, le recomendamos que llame aestos conjuntos de permisos AWSCloud9AdministratorsPerms, AWSCloud9UsersPerms yAWSCloud9EnvironmentMembersPerms, respectivamente. Para obtener más información, consultePolíticas administradas (predefinidas) de AWS para AWS Cloud9 (p. 525).

6. Introduzca una Description (Descripción) opcional para el conjunto de permisos.7. Elija la Session duration (Duración de la sesión) para el conjunto de permisos o deje la duración de la

sesión predeterminada de 1 hour (1 hora).8. Seleccione Attach AWS managed policies (Asociar políticas administradas de AWS).9. En la lista de políticas, seleccione una de las siguientes casillas al lado del Policy name (Nombre de

política) correcto. (No elija el nombre de la política. (Si no ve un nombre de política específico en la lista,escriba el nombre en el cuadro Search [Buscar] para mostrarla).

21

https://docs.aws.amazon.com/singlesignon/latest/userguide/addgroups.html

https://docs.aws.amazon.com/singlesignon/latest/userguide/addusers.html

https://docs.aws.amazon.com/singlesignon/latest/userguide/adduserstogroups.html

https://docs.aws.amazon.com/singlesignon/latest/userguide/manage-your-directory-connected.html

https://docs.aws.amazon.com/singlesignon/latest/userguide/manage-your-directory-connected.html

https://console.aws.amazon.com/singlesignon

AWS Cloud9 Guía del usuarioPaso 7: Comenzar a usar AWS Cloud9

• Para el conjunto de permisos AWSCloud9AdministratorsPerms, seleccioneAWSCloud9Administrator.

• Para el conjunto de permisos AWSCloud9UsersPerms, seleccione AWSCloud9User.• Opcionalmente, para el conjunto de permisos AWSCloud9EnvironmentMembersPerms, seleccione

AWSCloud9EnvironmentMember.

Note

Para obtener más información sobre las políticas que puede añadir además de las políticasexigidas por AWS Cloud9, consulte Políticas administradas y políticas insertadas y Permisosconcedidos por una política en la Guía del usuario de IAM.

10.Seleccione Create.11.Una vez que haya terminado de crear todos los conjuntos de permisos que desee, en la pestaña AWS

organization (Organización de AWS), elija la cuenta de AWS a la que desea asignar permisos deacceso a AWS Cloud9. (Si no ve la pestaña AWS organization (Organización de AWS), entonces, en elpanel de navegación del servicio, elija AWS accounts (Cuentas de AWS). Se muestra la pestaña AWSorganization (Organización de AWS)).

12.Elija Assign users (Asignar usuarios).13.En la pestaña Groups (Grupos), seleccione la casilla al lado del nombre del grupo al que desea asignar

permisos de acceso de AWS Cloud9, como sigue. (No elija el nombre del grupo).• Si utiliza un directorio de AWS SSO para la organización, es posible que haya creado un grupo

denominado AWSCloud9Administrators para los administradores de AWS Cloud9.• Si utiliza un directorio de AWS Managed Microsoft AD o AD Connector que se administra en AWS

Directory Service para la organización, elija el ID del directorio, escriba parte o la totalidad delnombre del grupo y, a continuación, elija Search connected directory (Buscar directorio conectado).A continuación, seleccione la casilla al lado del nombre del grupo al que desea asignar permisos deacceso a AWS Cloud9.

Note

Le recomendamos que asigne permisos de acceso a AWS Cloud9 a grupos, en lugar de ausuarios individuales. Esta práctica recomendada de seguridad de AWS puede ayudarle acontrolar, realizar un seguimiento y solucionar mejor los problemas de acceso a los recursos deAWS.

14.Elija Next: Permissions sets (Siguiente: conjuntos de permisos).15.Seleccione la casilla junto al nombre del conjunto de permisos que desea asignar a este grupo, por

ejemplo, AWSCloud9AdministratorsPerms para un grupo de administradores de AWS Cloud9. (No elijael nombre del conjunto de permisos).

16.Elija Finalizar.17.Elija Proceed to AWS accounts (Continuar a las cuentas de AWS).18.Repita los pasos 11 a 17 de este procedimiento para todos los permisos de acceso a AWS Cloud9

adicionales que desea asignar a cuentas de AWS en toda la organización.

Paso 7: Comenzar a usar AWS Cloud9Una vez completados los pasos anteriores de este tema, usted y sus usuarios pueden iniciar sesión enAWS SSO y comenzar a utilizar AWS Cloud9.

1. Si ya ha iniciado sesión en una cuenta de AWS o AWS SSO, cierre la sesión. Para ello, consulte Cómocerrar sesión en mi cuenta de AWS en el sitio web de AWS Support o Cómo cerrar sesión del portal deusuario en la Guía del usuario de AWS Single Sign-On.

2. Para iniciar sesión en AWS SSO, siga las instrucciones que se describen en Cómo aceptar la invitaciónpara unirse a AWS SSO en la Guía del usuario de AWS Single Sign-On. Esto incluye ir a una URL de

22




https://aws.amazon.com/premiumsupport/knowledge-center/sign-out-account/

https://aws.amazon.com/premiumsupport/knowledge-center/sign-out-account/

https://docs.aws.amazon.com/singlesignon/latest/userguide/howtosignout.html

https://docs.aws.amazon.com/singlesignon/latest/userguide/howtosignout.html

https://docs.aws.amazon.com/singlesignon/latest/userguide/howtoactivateaccount.html

https://docs.aws.amazon.com/singlesignon/latest/userguide/howtoactivateaccount.html

AWS Cloud9 Guía del usuarioPasos siguientes

inicio de sesión única e iniciar sesión con un nombre de usuario y contraseña únicos. Su administradorde cuenta de AWS le enviará un correo electrónico con esta información o se la proporcionará de otramanera.

Note

Asegúrese de marcar la URL de inicio de sesión única que se le proporcionó, para que puedavolver a ella más tarde fácilmente. También asegúrese de guardar el nombre de usuario y lacontraseña únicos para esta URL en un lugar seguro.Esta combinación de URL, nombre de usuario y contraseña podría cambiar en función de losdiferentes niveles de permisos de acceso a AWS Cloud9 que le ofrece el administrador de sucuenta de AWS. Por ejemplo, puede utilizar una URL, nombre de usuario y contraseña paraobtener acceso de administrador a AWS Cloud9 para una cuenta y puede utilizar una URL,nombre de usuario y contraseña diferentes que únicamente permiten acceso de usuario a AWSCloud9 para una cuenta diferente.

3. Después de iniciar sesión en AWS SSO, seleccione el icono de AWS Account (Cuenta de AWS).4. Elija el nombre para mostrar del usuario en la lista desplegable que se abre. Si se muestra más de un

nombre, seleccione el nombre que desea comenzar a utilizar en AWS Cloud9. Si no está seguro de quénombre elegir, consulte al administrador de su cuenta de AWS.

5. Elija el enlace Management console (Consola de administración) al lado del nombre para mostrardel usuario. Si se ve más de un enlace Management console (Consola de administración), elija elenlace junto al conjunto de permisos correctos. Si no está seguro de qué enlace elegir, consulte aladministrador de su cuenta de AWS.

6. Desde la Consola de administración de AWS, realice una de las siguientes operaciones:• Elija Cloud9, si ya aparece.• Amplíe All services (Todos los servicios) y, a continuación, elija Cloud9.• En el cuadro Find services (Buscar servicios), escriba Cloud9 y pulse Enter.• En la barra de navegación de AWS, elija Services (Servicios) y, a continuación, elija Cloud9.

Se muestra la consola de AWS Cloud9 y puede empezar a usar AWS Cloud9.

Pasos siguientes








Opciones de configuración adicionales para AWSCloud9 (Team y Enterprise)

En este tema, se parte de la base de que ya han completado los pasos de configuración de Configuraciónde equipo (p. 8) o Configuración de empresa (p. 17).

23

AWS Cloud9 Guía del usuarioPaso 1: Crear una política administrada por el cliente

En Configuración de equipo (p. 8) o Configuración de empresa (p. 17), ha creado grupos y añadidopermisos de acceso de AWS Cloud9 directamente a dichos grupos, para garantizar que los usuariosde esos grupos puedan acceder a AWS Cloud9. En este tema, añadirá más permisos de acceso pararestringir los tipos de entornos que los usuarios de dichos grupos pueden crear. Esto puede ayudar acontrolar los gastos relacionados con AWS Cloud9 en las organizaciones y cuentas de AWS.

Para agregar estos permisos de acceso, debe crear su propio conjunto de políticas que definan lospermisos de acceso de AWS que desea aplicar. (Se denominan políticas administradas por el cliente).Luego, debe asociar esas políticas administradas por el cliente a los grupos a los que pertenecen losusuarios. (En algunos casos, también debe separar las políticas administradas por AWS existentes que yaestán asociadas a dichos grupos). Para realizar esta configuración, siga los procedimientos que se indicanen este tema.

Note

Los siguientes procedimientos cubren las políticas de asociación y desasociación solo parausuarios de AWS Cloud9. En estos procedimientos, se presupone que ya tiene un grupo deusuarios de AWS Cloud9 y un grupo de administradores de AWS Cloud9 independientes y quesolo tiene un número limitado de usuarios en el grupo de administradores de AWS Cloud9. Estapráctica recomendada de seguridad de AWS puede ayudarle a controlar, realizar un seguimientoy solucionar mejor los problemas de acceso a los recursos de AWS.

• Paso 1: Crear una política administrada por el cliente (p. 24)• Paso 2: Añadir políticas administradas por el cliente a un grupo (p. 25)• Ejemplos de políticas administradas por el cliente para equipos que utilizan AWS Cloud9 (p. 26)

Paso 1: Crear una política administrada por el clientePuede crear una política administrada por el cliente con la consola de administración de AWS (p. 24) ola interfaz de línea de comandos de AWS (CLI de AWS) (p. 25).

Note

Este paso cubre la creación de una política administrada por el cliente solo para grupos de IAM.Para crear un conjunto de permisos personalizados para grupos en AWS Single Sign-On (SSO),omita este paso y siga las instrucciones de Crear un conjunto de permisos en la Guía del usuariode AWS Single Sign-On. En este tema, siga las instrucciones para crear un conjunto de permisospersonalizados. Para ver políticas de permisos personalizados relacionadas, consulte Ejemplosde políticas administradas por el cliente para equipos que usan AWS Cloud9 (p. 26) másadelante en este tema.

Crear una política administrada por el cliente con la consola1. Si todavía no ha iniciado sesión en la consola de administración de AWS, hágalo.

Le recomendamos que inicie sesión con las credenciales de un usuario administrador de IAM en sucuenta de AWS. Si no puede hacerlo, consulte con el administrador de su cuenta de AWS.

2. Abra la consola de IAM. Para ello, en la barra de navegación de la consola, elija Services (Servicios). Acontinuación, elija IAM.

3. En el panel de navegación del servicio, elija Policies (Políticas).4. Elija Create Policy.5. En la pestaña JSON, pegue uno de nuestros Ejemplos de políticas administradas por el

cliente (p. 26) sugeridos.

24

https://docs.aws.amazon.com/singlesignon/latest/userguide/permissionsets.html#howtocreatepermissionset

AWS Cloud9 Guía del usuarioPaso 2: Añadir políticas administradas

por el cliente a un grupo

Note

También puede crear sus propias políticas administradas por el cliente. Para obtener másinformación, consulte la Referencia de políticas JSON de IAM en la Guía del usuario de IAM yla documentación de los servicios de AWS.

6. Elija Review policy.7. En la página Review policy (Revisar política), escriba un nombre y una descripción opcional de la

política y, a continuación, elija Create policy (Crear política).

Repita este paso para cada política administrada por el cliente adicional que desee crear, luego vaya a lasección Agregar políticas administradas por el cliente a un grupo con la consola (p. 26).

Crear una política administrada por el cliente con la AWS CLI1. En el equipo donde ejecuta la AWS CLI, cree un archivo para describir la política (por ejemplo,

policy.json).

Si crea el archivo con otro nombre de archivo, sustitúyalo en todo este procedimiento.2. Pegue uno de nuestros Ejemplos de políticas administradas por el cliente (p. 26) sugeridos en el

archivo policy.json.

Note

También puede crear sus propias políticas administradas por el cliente. Para obtener másinformación, consulte la Referencia de políticas JSON de IAM en la Guía del usuario de IAM yla documentación de los servicios de AWS.

3. Desde el terminal o el símbolo del sistema, cambie al directorio que contiene el archivo policy.json.4. Ejecute el comando create-policy de IAM, especificando un nombre de la política y el archivo

policy.json.

aws iam create-policy --policy-document file://policy.json --policy-name MyPolicy

En el comando anterior, reemplace MyPolicy por el nombre de la política.

Vaya directamente a Agregar políticas administradas por el cliente a un grupo con la CLI deAWS (p. 26).

Paso 2: Añadir políticas administradas por el cliente aun grupoPuede añadir políticas administradas por el cliente a un grupo con la consola de administración deAWS (p. 26) o la interfaz de línea de comandos de AWS (CLI de AWS) (p. 26).

Note

Este paso cubre la adición de políticas administradas por el cliente solo para grupos de IAM. Paraañadir conjuntos de permisos personalizados a grupos en AWS Single Sign-On (SSO), omita estepaso y siga las instrucciones de Asignar acceso a usuarios en la Guía del usuario de AWS SingleSign-On.

25

https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies.html

https://aws.amazon.com/documentation/



https://docs.aws.amazon.com/singlesignon/latest/userguide/useraccess.html#assignusers

AWS Cloud9 Guía del usuarioEjemplos de políticas administradas por el

cliente para equipos que utilizan AWS Cloud9

Agregar políticas administradas por el cliente a un grupo con laconsola1. Con la consola de IAM abierta del procedimiento anterior, en el panel de navegación del servicio, elija

Groups (Grupos).2. Elija el nombre del grupo.3. En la pestaña Permissions (Permisos), en Managed Policies (Políticas administradas), seleccione Attach

Policy (Adjuntar política).4. En la lista con los nombres de las políticas, active la casilla junto a cada política administrada por el

cliente que desea asociar al grupo. (Si no ve un nombre de política específico en la lista, escríbalo en elcuadro Filter (Filtrar) para mostrarlo).


Agregar políticas administradas por el cliente a un grupo con laAWS CLI

Note


Ejecute el comando attach-group-policy de IAM, especificando el nombre del grupo y, acontinuación, el nombre de recurso de Amazon (ARN) de la política.

aws iam attach-group-policy --group-name MyGroup --policy-arn arn:aws:iam::123456789012:policy/MyPolicy

En el comando anterior, reemplace MyGroup por el nombre del grupo. Reemplace 123456789012 por elID de cuenta de AWS y reemplace MyPolicy por el nombre de la política administrada por el cliente.

Ejemplos de políticas administradas por el cliente paraequipos que utilizan AWS Cloud9A continuación, se muestran algunos ejemplos de políticas que puede utilizar para restringir los tipos deentornos que los usuarios de un grupo pueden crear en una cuenta de AWS.

• Evitar que los usuarios de un grupo creen entornos (p. 26)• Evitar que los usuarios de un grupo creen entornos de EC2 (p. 27)• Permitir que los usuarios de un grupo creen entornos de EC2 solo con tipos de instancias específicas de

Amazon EC2 (p. 27)• Permitir que los usuarios de un grupo creen un único entorno de EC2 solo por región de AWS (p. 29)

Evitar que los usuarios de un grupo creen entornosEn la siguiente política administrada por el cliente, cuando se asocia a un grupo de usuarios de AWSCloud9, se impide que esos usuarios creen entornos en una cuenta de AWS. Esto resulta útil si desea que

26



un usuario administrador de IAM de su cuenta de AWS administre la creación de entornos en lugar de losusuarios de un grupo de usuarios de AWS Cloud9.

{ "Version": "2012-10-17", "Statement": [ { "Effect": "Deny", "Action": [ "cloud9:CreateEnvironmentEC2", "cloud9:CreateEnvironmentSSH" ], "Resource": "*" } ]}

Tenga en cuenta que la política administrada por el cliente anterior anula "Effect":"Allow" explícitamente para "Action": "cloud9:CreateEnvironmentEC2" y"cloud9:CreateEnvironmentSSH" en "Resource": "*" en la política administradaAWSCloud9User que ya está asociada al grupo de usuarios de AWS Cloud9.

Evitar que los usuarios de un grupo creen entornos de EC2En la siguiente política administrada por el cliente, cuando se asocia a un grupo de usuarios de AWSCloud9, se impide que esos usuarios creen entornos de EC2 en una cuenta de AWS. Esto resulta útil sidesea que un usuario administrador de IAM de su cuenta de AWS administre la creación de entornos deEC2 en lugar de los usuarios de un grupo de usuarios de AWS Cloud9. Aquí se da también por hechoque no ha asociado una política que impida que los usuarios de ese grupo creen entornos de SSH. De locontrario, los usuarios no podrán crear entornos.

{ "Version": "2012-10-17", "Statement": [ { "Effect": "Deny", "Action": "cloud9:CreateEnvironmentEC2", "Resource": "*" } ]}

Tenga en cuenta que la política administrada por el cliente anterior anula "Effect": "Allow" para"Action": "cloud9:CreateEnvironmentEC2" en "Resource": "*" en la política administrada deAWSCloud9User que ya está asociada al grupo de usuarios de AWS Cloud9.

Permitir que los usuarios de un grupo creen entornos de EC2solo con tipos de instancias específicas de Amazon EC2En la siguiente política administrada por el cliente, si se asocia a un grupo de usuarios de AWS Cloud9,permite a esos usuarios crear entornos de EC2 que solo utilizan tipos de instancias que comienzan port2 en una cuenta de AWS. En esta política, se da por hecho que tampoco ha asociado una política queimpida que los usuarios de ese grupo creen entornos de EC2. De lo contrario, los usuarios no podrán crearentornos de EC2.

Puede sustituir "t2.*" en la siguiente política por una clase de instancia distinta (por ejemplo, "m4.*").También puede restringirla a varias clases o tipos de instancias (por ejemplo, [ "t2.*", "m4.*" ] o[ "t2.micro", "m4.large" ]).

27



Para un grupo de usuarios de AWS Cloud9, desasocie la política administrada AWSCloud9User del grupoy luego añada en su lugar la siguiente política administrada por el cliente. (Si no desasocia la políticaadministrada AWSCloud9User, la siguiente política administrada por el cliente no se aplicará).

{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "cloud9:CreateEnvironmentSSH", "cloud9:ValidateEnvironmentName", "cloud9:GetUserPublicKey", "cloud9:UpdateUserSettings", "cloud9:GetUserSettings", "iam:GetUser", "iam:ListUsers", "ec2:DescribeVpcs", "ec2:DescribeSubnets" ], "Resource": "*" }, { "Effect": "Allow", "Action": "cloud9:CreateEnvironmentEC2", "Resource": "*", "Condition": { "StringLike": { "cloud9:InstanceType": "t2.*" } } }, { "Effect": "Allow", "Action": [ "cloud9:DescribeEnvironmentMemberships" ], "Resource": [ "*" ], "Condition": { "Null": { "cloud9:UserArn": "true", "cloud9:EnvironmentId": "true" } } }, { "Effect": "Allow", "Action": [ "iam:CreateServiceLinkedRole" ], "Resource": "*", "Condition": { "StringLike": { "iam:AWSServiceName": "cloud9.amazonaws.com" } } } ]}

28



Tenga en cuenta que la anterior política administrada por el cliente también permite a esosusuarios crear entornos de SSH. Para evitar que esos usuarios creen entornos de SSH, elimine"cloud9:CreateEnvironmentSSH", de la política administrada por el cliente anterior.

Permitir que los usuarios de un grupo creen un único entorno deEC2 por región de AWSEn la siguiente política administrada por el cliente, cuando se asocia a grupos de usuarios de AWS Cloud9,se permite que cada uno de esos usuarios cree un máximo de un entorno de EC2 por región de AWS en laque AWS Cloud9 está disponible. Para ello, se restringe el nombre del entorno a un nombre específico deesa región de AWS (en este ejemplo, my-demo-environment).

Note

AWS Cloud9 no permite restringir la creación de entornos a determinadas regiones de AWS.Tampoco permite restringir el número total de entornos que se pueden crear (distinto a los límitesde servicio (p. 570) publicados).

Para un grupo de usuarios de AWS Cloud9, desasocie la política administrada AWSCloud9User del grupoy luego añada en su lugar la siguiente política administrada por el cliente. (Si no desasocia la políticaadministrada AWSCloud9User, la siguiente política administrada por el cliente no se aplicará).

{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "cloud9:CreateEnvironmentSSH", "cloud9:ValidateEnvironmentName", "cloud9:GetUserPublicKey", "cloud9:UpdateUserSettings", "cloud9:GetUserSettings", "iam:GetUser", "iam:ListUsers", "ec2:DescribeVpcs", "ec2:DescribeSubnets" ], "Resource": "*" }, { "Effect": "Allow", "Action": [ "cloud9:CreateEnvironmentEC2" ], "Resource": "*", "Condition": { "StringEquals": { "cloud9:EnvironmentName": "my-demo-environment" } } }, { "Effect": "Allow", "Action": [ "cloud9:DescribeEnvironmentMemberships" ], "Resource": [ "*" ], "Condition": { "Null": {

29


"cloud9:UserArn": "true", "cloud9:EnvironmentId": "true" } } }, { "Effect": "Allow", "Action": [ "iam:CreateServiceLinkedRole" ], "Resource": "*", "Condition": { "StringLike": { "iam:AWSServiceName": "cloud9.amazonaws.com" } } } ]}

Tenga en cuenta que la anterior política administrada por el cliente permite a esos usuarioscrear entornos de SSH. Para evitar que esos usuarios creen entornos de SSH, elimine"cloud9:CreateEnvironmentSSH", de la política administrada por el cliente anterior.

Para ver otros ejemplos, consulte Ejemplos de políticas administradas por los clientes (p. 528) enAutenticación y control de acceso (p. 521).

Pasos siguientes








Configuración individual de estudiante para AWSCloud9

En este tema se explica cómo realizar una configuración para utilizar AWS Cloud9 como estudiante,con usted como la única persona que usa la cuenta de AWS. Si va a configurar AWS Cloud9 paraseguir cualquier otro patrón de uso, consulte Configuración de AWS Cloud9 (p. 6) para obtener lasinstrucciones correctas. Para obtener más información sobre a quiénes se considera estudiantes, consulte¿Quién puede unirse a AWS Educate? en el sitio web de Preguntas frecuentes de AWS Educate.

• Paso 1: Crear una cuenta con AWS (p. 31)• Paso 2: Iniciar sesión en la consola de AWS Cloud9 (p. 33)• Pasos siguientes (p. 35)

30


AWS Cloud9 Guía del usuarioPaso 1: Crear una cuenta con AWS

Paso 1: Crear una cuenta con AWSEn este paso, se crea una cuenta de AWS Educate Starter (p. 31) o una cuenta de AWSnormal (p. 32), que se podrá utilizar para acceder a AWS Cloud9.

Si se trata de una cuenta de AWS Educate Starter, tenga en cuenta lo siguiente:

• Debe reunir los requisitos de estudiante.• No se necesita una tarjeta de crédito.• Existen algunas restricciones en el uso de AWS en la cuenta.• La cuenta no es elegible para la capa gratuita de AWS.• Después de su graduación, ya no podrá mantener con la cuenta.• No es posible vincular la cuenta a otra cuenta.• No puede aplicar créditos promocionales de AWS adicionales a la cuenta.• Los recursos de AWS que cree en la cuenta dejarán de funcionar después de que se utilicen todos los

créditos promocionales de AWS.• Si la cuenta se queda sin créditos promocionales de AWS, se desactivará.• No es posible convertir la cuenta en una cuenta de AWS normal.

Para obtener más información, consulte ¿Cuál es la diferencia entre una cuenta de AWS y una cuenta deAWS Educate Starter en el sitio web de Preguntas frecuentes de AWS Educate.

• Crear una cuenta de AWS Educate Starter (p. 31)• Crear una cuenta de AWS normal y solicitar AWS Educate (p. 32)

Crear una cuenta de AWS Educate StarterSi ya tiene una cuenta de AWS Educate Starter, vaya al Paso 2: Iniciar sesión en la consola de AWSCloud9 (p. 33).

1. Vaya al sitio web Apply for AWS Educate en https://aws.amazon.com/education/awseducate/apply/.2. Elija Apply for AWS Educate for Students (Solicitar AWS Educate para estudiantes).3. En la página Tell us about yourself (Háblenos de usted), siga las instrucciones que aparecen en

pantalla. Deberá proporcionar determinada información a AWS Educate como la institución educativaa la que asiste y su dirección de correo electrónico de estudiante en dicha institución. Deje en blancoPromo Code (Código promocional).

4. Rellene el desafío de seguridad y, a continuación, haga clic en Next (Siguiente).5. En la página Choose one of the following (Elegir uno de lo siguiente), seleccione Click here to select an

AWS Educate Starter Account (Haga clic aquí para seleccionar una cuenta de AWS Educate Starter) y,a continuación, elija Next (Siguiente).

6. AWS le enviará un correo electrónico con el título Email Verification - AWS Educate Application(Verificación de correo electrónico: solicitud de AWS Educate). Elija el enlace en ese correo electrónicopara confirmar su dirección de correo electrónico, revise los términos y condiciones del programa AWSEducate y complete el proceso de solicitud.

7. Después de completar el proceso de solicitud, AWS le enviará un correo electrónico con el título ThankYou for Applying for AWS Educate (Gracias por solicitar AWS Educate). Este correo electrónico incluyedetalles como, por ejemplo, cómo comprobar el estado de su solicitud y cómo ponerse en contacto conel equipo de soporte de AWS Educate con cualquier pregunta.

Después de que AWS Educate apruebe la solicitud, AWS le enviará un correo electrónico con eltítulo AWS Educate Application Approved (Solicitud de AWS Educate aprobada). Tenga en cuenta

31

https://aws.amazon.com/free/

https://www.awseducate.com/faqs#fa0Po000000C0eH1EAJ

https://www.awseducate.com/faqs#fa0Po000000C0eH1EAJ

https://aws.amazon.com/education/awseducate/apply/

AWS Cloud9 Guía del usuarioPaso 1: Crear una cuenta con AWS

que el proceso de aprobación puede tardar un día o más. No vaya más allá de este paso en esteprocedimiento hasta que reciba esta aprobación.

8. Después de recibir el correo electrónico de aprobación, siga las instrucciones del correo electrónico paraconfigurar su contraseña del portal para estudiantes de AWS Educate y, a continuación, inicie sesión enel portal para estudiantes de AWS Educate. Una vez que haya definido su contraseña del portal paraestudiantes de AWS Educate, guarde la contraseña en un lugar seguro.

9. Vaya al Paso 2: Iniciar sesión en la consola de AWS Cloud9 (p. 33).

Crear una cuenta de AWS normal y solicitar AWS EducateSi ya tiene una cuenta de AWS normal, vaya al paso 6 de este procedimiento para solicitar AWS Educate.

1. Vaya a https://aws.amazon.com.2. Elija Sign In to the Console (Iniciar sesión en la consola).3. Elija Create a new AWS account (Crear una nueva cuenta de AWS).4. Complete el proceso siguiendo las instrucciones que aparecen en pantalla. Esto incluye dar a AWS su

dirección de correo electrónico y los datos de la tarjeta de crédito. También debe utilizar el teléfono paraintroducir un código que AWS le ofrece.

5. Una vez que haya terminado de crear la cuenta, AWS le enviará un correo electrónico de confirmación.No vaya más allá de este paso en este procedimiento hasta que reciba esta confirmación.

6. Vaya al sitio web Apply for AWS Educate en https://aws.amazon.com/education/awseducate/apply/.7. Elija Apply for AWS Educate for Students (Solicitar AWS Educate para estudiantes).8. En la página Tell us about yourself (Háblenos de usted), siga las instrucciones que aparecen en

pantalla. Deberá proporcionar determinada información a AWS Educate como la institución educativaa la que asiste y su dirección de correo electrónico de estudiante en dicha institución. Deje en blancoPromo Code (Código promocional).

9. Rellene el desafío de seguridad y, a continuación, haga clic en Next (Siguiente).10.En la página Choose one of the following (Solicitar uno de lo siguiente), seleccione Click here to enter an

AWS Account ID (Haga clic aquí para escribir el ID de cuenta de AWS).11.En el cuadro de texto que aparece junto a Click here to enter an AWS Account ID (Haga clic aquí para

introducir el ID de cuenta de AWS), escriba su ID de cuenta de AWS y, a continuación, seleccione Next(Siguiente). (Para obtener un ID de cuenta de AWS, consulte Buscar su ID de cuenta de AWS en laReferencia general de Amazon Web Services.)

12.AWS le enviará un correo electrónico con el título Email Verification - AWS Educate Application(Verificación de correo electrónico: solicitud de AWS Educate). Elija el enlace en ese correo electrónicopara confirmar su dirección de correo electrónico, revise los términos y condiciones del programa AWSEducate y complete el proceso de solicitud.

13.Después de completar el proceso de solicitud, AWS le enviará un correo electrónico con el título ThankYou for Applying for AWS Educate (Gracias por solicitar AWS Educate). Este correo electrónico incluyedetalles como, por ejemplo, cómo comprobar el estado de su solicitud y cómo ponerse en contacto conel equipo de soporte de AWS Educate con cualquier pregunta.

Después de que AWS Educate apruebe la solicitud, AWS le enviará un correo electrónico con eltítulo AWS Educate Application Approved (Solicitud de AWS Educate aprobada). Tenga en cuentaque el proceso de aprobación puede tardar un día o más. Puede empezar a usar AWS Cloud9 sintener que esperar por esta aprobación. Para ello, vaya al Paso 2: Iniciar sesión en la consola de AWSCloud9 (p. 33).

14.Después de recibir el correo electrónico de aprobación, siga las instrucciones del correo electrónico paraconfigurar su contraseña del portal para estudiantes de AWS Educate y, a continuación, inicie sesión enel portal para estudiantes de AWS Educate. Una vez que haya definido su contraseña del portal paraestudiantes de AWS Educate, guarde la contraseña en un lugar seguro.

32



https://docs.aws.amazon.com/general/latest/gr/acct-identifiers.html#FindingYourAccountIdentifiers


15.El correo electrónico de aprobación contiene información acerca de créditos promocionales de AWS quepuede aplicar a su cuenta de AWS. Los créditos promocionales de AWS pueden ayudar a compensarel costo de usar determinados servicios de AWS, algunos de ellos se pueden utilizar en o con AWSCloud9. Para aplicar los créditos promocionales de AWS a su cuenta de AWS, haga lo siguiente:a. Con el portal para estudiantes de AWS Educate abierto, elija Sign In to the Console (Iniciar sesión en

la consola).

Note

Para volver al portal para estudiantes de AWS Educate, vaya al sitio web de inicio de sesiónde AWS Educate Site en https://www.awseducate.com/signin/. Escriba la dirección de correoelectrónico y la contraseña que utilizó cuando inició sesión por primera vez en el portal paraestudiantes de AWS Educate y, a continuación, elija Sign In (Iniciar sesión).

b. Escriba la dirección de correo electrónico de su cuenta de AWS y, a continuación, elija Next(Siguiente).

Note


c. Escriba la contraseña de la cuenta de AWS y seleccione Sign in (Iniciar sesión).

Important

Escriba la contraseña de su cuenta de AWS, no la contraseña del portal para estudiantes deAWS Educate.

d. En la barra de navegación de AWS, elija la dirección de correo electrónico o el nombre para mostrary, a continuación, elija My Account (Mi cuenta).

e. Elija Credits (Créditos).f. En Promo Code (Código promocional), escriba el Credit Code (Código del crédito) del correo

electrónico de aprobación.g. Complete la Security Check (Comprobación de seguridad) y, a continuación, elija Redeem (Canjear).h. Para ver la lista de los servicios de AWS que cumplen los requisitos para este crédito, seleccione See

complete list (Ver la lista completa).

Note

AWS Cloud9 no se encuentra en esta lista de servicios de AWS que reúnen los requisitos,ya que no existe ningún cargo adicional por AWS Cloud9. En cambio, AWS aplicaautomáticamente este crédito para su uso en servicios de AWS que reúnen los requisitos,algunos de ellos se utilizan con o en AWS Cloud9. Para obtener más información, consultelos precios de AWS Cloud9.

Paso 2: Iniciar sesión en la consola de AWS Cloud9Ya está preparado para utilizar una cuenta de AWS Educate Starter (p. 34) o una cuenta de AWSnormal (p. 34) para iniciar sesión en la consola de AWS Cloud9 y comenzar a utilizar AWS Cloud9.

• Utilizar una cuenta de AWS Educate Starter para iniciar sesión en la consola de AWS Cloud9 (p. 34)• Utilizar una cuenta de AWS Educate normal para iniciar sesión en la consola de AWS Cloud9 (p. 34)

33

https://www.awseducate.com/signin/



Utilizar una cuenta de AWS Educate Starter para iniciar sesión enla consola de AWS Cloud91. Vaya al sitio web de inicio de sesión de AWS Educate en https://www.awseducate.com/signin/.2. Escriba la dirección de correo electrónico y la contraseña que utilizó para iniciar sesión en el portal para

estudiantes de AWS Educate y, a continuación, elija Sign In (Iniciar sesión).3. Elija AWS Account (Cuenta de AWS).4. Elija Go to your AWS Educate Starter Account (Ir a la cuenta de AWS Educate Starter).5. Elija AWS Console (Consola de AWS).6. Aplique alguna de las siguientes acciones:

• Elija Cloud9, si ya aparece.• Amplíe All services (Todos los servicios) y, a continuación, elija Cloud9.• En el cuadro Find services (Buscar servicios), escriba Cloud9 y, a continuación, pulse Enter (Intro).• En la barra de navegación de AWS, elija Services (Servicios) y, a continuación, elija Cloud9.

Ya puede comenzar a utilizar AWS Cloud9. Vaya directamente a Next Steps (Pasos siguientes) (p. 35).

Utilizar una cuenta de AWS Educate normal para iniciar sesiónen la consola de AWS Cloud91. Aplique alguna de las siguientes acciones:

• Abra la consola de AWS Cloud9 en https://console.aws.amazon.com/cloud9/.• Vaya al sitio web de inicio de sesión de miembros de AWS Educate en https://aws.amazon.com/

education/awseducate/members/ y, a continuación, elija Sign In to the Console (Iniciar sesión en laconsola). (No elija Students Login Here [Inicio de sesión de estudiante aquí].)

2. Escriba la dirección de correo electrónico de su cuenta de AWS y, a continuación, elija Next (Siguiente).

Note


3. Escriba la contraseña de la cuenta de AWS y seleccione Sign in (Iniciar sesión).

Important

Escriba la contraseña de su cuenta de AWS, no la contraseña del portal para estudiantes deAWS Educate.

4. Si se muestra la Consola de administración de AWS en lugar de la consola de AWS Cloud9, realice unade las siguientes operaciones:• Elija Cloud9, si ya aparece.• Amplíe All services (Todos los servicios) y, a continuación, elija Cloud9.• En el cuadro Find services (Buscar servicios), escriba Cloud9 y, a continuación, pulse Enter (Intro).• En la barra de navegación de AWS, elija Services (Servicios) y, a continuación, elija Cloud9.

Ya puede comenzar a utilizar AWS Cloud9.

Important

Aunque puede iniciar sesión en la consola de AWS Cloud9 con la dirección de correo electrónicoy la contraseña que utilizó al crear su cuenta de AWS (llamamos a esto usuario raíz de la cuenta

34



https://aws.amazon.com/education/awseducate/members/

https://aws.amazon.com/education/awseducate/members/


de AWS), no se trata de una práctica recomendada de seguridad de AWS. En el futuro, lerecomendamos que inicie sesión en la consola de AWS Cloud9 como un usuario administradorde AWS Identity and Access Management (IAM) en su cuenta de AWS. Para obtener másinformación, consulte Creación del primer grupo y usuario administrador de IAM en la Guía delusuario de IAM y Tareas de AWS que exigen credenciales de usuario raíz de la cuenta de AWSen la Referencia general de Amazon Web Services.

Pasos siguientes









Configuración de aula para AWS Cloud9En este tema se explica cómo un educador puede realizar una configuración para que los estudiantesutilicen AWS Cloud9 en un aula virtual. Si va a configurar AWS Cloud9 para seguir cualquier otro patrónde uso, consulte Configuración de AWS Cloud9 (p. 6) para obtener las instrucciones correctas. Paraobtener más información sobre a quién se considera un educador, consulte ¿Quién puede unirse a AWSEducate? en el sitio web de Preguntas frecuentes de AWS Educate.

• Paso 1: Crear una cuenta de AWS y solicitar AWS Educate (p. 35)• Paso 2: Configurar su aula virtual para AWS Cloud9 (p. 37)• Paso 3: Entrar en el aula virtual (p. 38)• Pasos siguientes (p. 40)

Paso 1: Crear una cuenta de AWS y solicitar AWSEducateEn este paso, creará una cuenta de AWS. A continuación, solicitará AWS Educate. Durante el proceso desolicitud, debe proporcionar su ID de cuenta de AWS a AWS Educate.

Si ya tiene una cuenta de AWS, vaya al paso 6 de este procedimiento para solicitar AWS Educate. Sino está seguro de si su departamento o institución ya tiene una cuenta de AWS para usted o si debecrear una nueva cuenta propia, consulte al administrador de la cuenta de AWS del departamento o de lainstitución.

Si ya es miembro de AWS Educate, vaya al Paso 2: Configurar su aula virtual para AWS Cloud9 (p. 37).

35





AWS Cloud9 Guía del usuarioPaso 1: Crear una cuenta de AWS y solicitar AWS Educate

1. Vaya a https://aws.amazon.com.2. Elija Sign In to the Console (Iniciar sesión en la consola).3. Elija Create a new AWS account (Crear una nueva cuenta de AWS).4. Complete el proceso siguiendo las instrucciones que aparecen en pantalla. Esto incluye dar a AWS su

dirección de correo electrónico y los datos de la tarjeta de crédito. También debe utilizar el teléfono paraintroducir un código que AWS le ofrece.

Una vez que haya terminado de crear la cuenta, AWS le enviará un email de confirmación. No vaya másallá de este paso en este procedimiento hasta que reciba esta confirmación.

5. Vaya al sitio web Apply for AWS Educate en https://aws.amazon.com/education/awseducate/apply/.6. Elija Apply for AWS Educate for Educators (Solicitar AWS Educate para educadores).7. En la página Tell us about yourself (Háblenos de usted), siga las instrucciones que aparecen en

pantalla. Tendrá que proporcionar determinada información a AWS Educate como la institucióneducativa para la que trabaja así como su dirección de correo electrónico en dicha institución. Deje enblanco Promo Code (Código promocional).

8. Rellene el desafío de seguridad y, a continuación, haga clic en Next (Siguiente).9. En la página Choose one of the following (Elegir uno de lo siguiente), seleccione Click here to enter an

AWS Account ID (Haga clic aquí para introducir el ID de cuenta de AWS) y, a continuación, elija Next(Siguiente).

10.En el cuadro de texto que aparece junto a Click here to enter an AWS Account ID (Haga clic aquí paraintroducir el ID de cuenta de AWS), escriba su ID de cuenta de AWS y, a continuación, seleccione Next(Siguiente). (Para obtener un ID de cuenta de AWS, consulte Buscar su ID de cuenta de AWS en laReferencia general de Amazon Web Services.)

11.AWS le enviará un correo electrónico con el título Email Verification - AWS Educate Application(Verificación de correo electrónico: solicitud de AWS Educate). Elija el enlace en ese correo electrónicopara confirmar su dirección de correo electrónico, revise los términos y condiciones del programa AWSEducate y complete el proceso de solicitud.

12.Después de completar el proceso de solicitud, AWS le enviará un correo electrónico con el título ThankYou for Applying for AWS Educate (Gracias por solicitar AWS Educate). Este correo electrónico incluyedetalles como, por ejemplo, cómo comprobar el estado de su solicitud y cómo ponerse en contacto conel equipo de soporte de AWS Educate con cualquier pregunta.

Después de que AWS Educate apruebe la solicitud, AWS le enviará un correo electrónico con el títuloAWS Educate Application Approved (Solicitud de AWS Educate aprobada). Tenga en cuenta que elproceso de aprobación puede tardar unos días. No vaya más allá de este paso en este procedimientohasta que reciba esta aprobación.

Después de recibir el correo electrónico de aprobación, siga las instrucciones del correo electrónicopara configurar su contraseña del portal de colaboración para educadores (ECP) de AWS Educate y,a continuación, inicie sesión en ECP de AWS Educate. Una vez que haya definido su contraseña delECP de AWS Educate, guarde la contraseña en un lugar seguro. El correo electrónico de aprobacióncontiene información acerca de créditos promocionales de AWS que puede aplicar a su cuenta de AWS.Los créditos promocionales de AWS pueden ayudar a compensar el costo del uso individual de losservicios de AWS que reúnan los requisitos, algunos de ellos se utilizan con o en AWS Cloud9. Paraaplicar los créditos promocionales de AWS a su cuenta de AWS, haga lo siguiente:a. Con el ECP de AWS Educate abierto, elija AWS Account (Cuenta de AWS).

Note

Para volver al ECP de AWS Educate, vaya al sitio web de inicio de sesión de AWS Educateen https://www.awseducate.com/signin/. Escriba la dirección de correo electrónico y lacontraseña que utilizó para iniciar sesión en ECP de AWS Educate y, a continuación, elijaSign In (Iniciar sesión).

b. En la barra de navegación de AWS, seleccione My Account, Billing & Cost Management (Mi cuenta,gestión de costos y facturación).

36



https://docs.aws.amazon.com/general/latest/gr/acct-identifiers.html#FindingYourAccountIdentifiers


AWS Cloud9 Guía del usuarioPaso 2: Configurar su aula virtual para AWS Cloud9

c. Escriba la dirección de correo electrónico de su cuenta de AWS y, a continuación, elija Next(Siguiente).

Note


d. Escriba la contraseña de la cuenta de AWS y seleccione Sign in (Iniciar sesión).Important

Introduzca la contraseña de su cuenta de AWS, no la contraseña del ECP de AWS Educate.e. Elija Credits (Créditos).f. En Promo Code (Código promocional), escriba el Credit Code (Código del crédito) del correo

electrónico de aprobación.g. Complete la Security Check (Comprobación de seguridad) y, a continuación, elija Redeem (Canjear).h. Para ver la lista de los servicios de AWS que cumplen los requisitos para este crédito, seleccione See

complete list (Ver la lista completa).Note

AWS Cloud9 no está en la lista de los servicios de AWS que reúnen los requisitos, ya queno existe ningún cargo adicional por AWS Cloud9. En cambio, AWS aplica automáticamenteeste crédito para su uso en servicios de AWS que reúnen los requisitos, algunos de ellos seutilizan con o en AWS Cloud9. Para obtener más información, consulte los precios de AWSCloud9.

Paso 2: Configurar su aula virtual para AWS Cloud9En este paso, utilice el portal de colaboración para educadores (ECP) de AWS Educate para configurar unaula virtual para que sus estudiantes usen AWS Cloud9.

1. Con el ECP de AWS Educate abierto, elija Classrooms & Credits (Aulas y créditos).Note

Para abrir o volver al ECP de AWS Educate, vaya al sitio web de inicio de sesión de AWSEducate en https://www.awseducate.com/signin/. Escriba la dirección de correo electrónico y lacontraseña que utilizó para iniciar sesión en ECP de AWS Educate y, a continuación, elija SignIn (Iniciar sesión).

2. Elija Request or go to an AWS Educate Classroom (Solicitar o ir a un aula de AWS Educate).3. En Select Classroom Template (Seleccionar plantilla de aula), elija el mosaico Cloud9.4. En Enter Classroom Details (Introducir detalles del aula), elija Next (Siguiente).5. Proporcione información acerca de su clase, como las fechas de inicio y finalización de la clase y el

número estimado de estudiantes.6. En Credit Amount Requested Per Student (Cantidad de créditos solicitada por estudiante), escriba la

cantidad de créditos promocionales de AWS que desea que cada estudiante tenga a su disposiciónpara usarlos en la clase. Si solicita una cantidad superior al máximo de créditos promocionales de AWSpredeterminados por estudiante, proporcione detalles adicionales en apoyo de su solicitud.

7. En Upload a List of Email Addresses (Cargar una lista de direcciones de correo electrónico), elija Next(Siguiente).

8. Siga las instrucciones que aparecen en pantalla para descargar la plantilla de carga de direcciones decorreo electrónico, rellene la plantilla y, a continuación, cargue la plantilla rellenada.

9. Después de cargarla, elija Submit (Enviar).

37




AWS Cloud9 Guía del usuarioPaso 3: Entrar en el aula virtual

Una vez que AWS Educate apruebe su solicitud, AWS le enviará un correo electrónico con el títuloYour AWS Educate Classroom has been created (Se ha creado su aula de AWS Educate). Tenga encuenta que el proceso de aprobación puede tardar unos días. No vaya más allá de este paso en esteprocedimiento hasta que reciba esta aprobación. Después de recibir el correo electrónico de aprobación,AWS Educate comenzará a enviar invitaciones de correo electrónico a cada una de las direcciones decorreo electrónico que ha proporcionado antes en el paso 8 de este procedimiento.

Paso 3: Entrar en el aula virtualUna vez completados los pasos anteriores de este tema, usted y sus estudiantes pueden entrar en el aulavirtual y comenzar a usar AWS Cloud9.

• Entrar en el aula virtual como estudiante (p. 38)• Volver al aula virtual como estudiante (p. 39)• Entrar en el aula virtual como instructor (p. 39)

Entrar en el aula virtual como estudiante1. AWS Educate le enviará un correo electrónico con el título Your AWS Educate Application (Su solicitud

para AWS Educate). En ese correo electrónico, elija el enlace para completar el proceso de solicitud deAWS Educate y aceptar la invitación del aula virtual del instructor.

2. En la página Tell us about yourself (Háblenos de usted), siga las instrucciones que aparecen enpantalla. Tendrá que proporcionar determinada información a AWS Educate, como la ciudad donde seencuentra su institución educativa y cuando espera graduarse. Deje en blanco Promo Code (Códigopromocional).

3. Rellene el desafío de seguridad y, a continuación, haga clic en Next (Siguiente).4. En la página Choose one of the following (Elegir uno de lo siguiente), seleccione Click here to select an

AWS Educate Starter Account (Haga clic aquí para seleccionar una cuenta de AWS Educate Starter) y,a continuación, elija Next (Siguiente).

5. AWS le enviará un correo electrónico con el título Email Verification - AWS Educate Application(Verificación de correo electrónico: solicitud de AWS Educate). Elija el enlace en ese correo electrónicopara confirmar su dirección de correo electrónico, revise los términos y condiciones del programa AWSEducate y complete el proceso de solicitud.

6. Después de completar el proceso de solicitud, AWS le enviará un correo electrónico con el título ThankYou for Applying for AWS Educate (Gracias por solicitar AWS Educate). Este correo electrónico incluyedetalles acerca de cómo ponerse en contacto con el equipo de soporte de AWS Educate con cualquierpregunta.

Después de que AWS Educate apruebe la solicitud, AWS le enviará un correo electrónico con eltítulo AWS Educate Application Approved (Solicitud de AWS Educate aprobada). Tenga en cuentaque el proceso de aprobación puede tardar un día o más. No vaya más allá de este paso en esteprocedimiento hasta que reciba esta aprobación.

Cuando reciba el correo electrónico de aprobación, siga las instrucciones del mismo para configurar sucontraseña del portal para estudiantes de AWS Educate y, a continuación, inicie sesión en el portal paraestudiantes de AWS Educate. Una vez que haya definido su contraseña del portal para estudiantes deAWS Educate, guarde la contraseña en un lugar seguro.

7. Con el portal para estudiantes de AWS Educate abierto, elija My Classrooms (Mis aulas).8. Junto al nombre del curso al que desea acceder, elija Go to classroom (Ir al aula).9. Elija Continue.10.Si se muestran los términos y condiciones, léalos y, a continuación, seleccione I Agree (Acepto).

38

AWS Cloud9 Guía del usuarioPaso 3: Entrar en el aula virtual

11.Elija AWS Console (Consola de AWS).12.Aplique alguna de las siguientes acciones:


Ya puede comenzar a utilizar AWS Cloud9. Vaya directamente a Next Steps (Pasos siguientes) (p. 35).

Volver al aula virtual como estudiante1. Vaya al sitio web de inicio de sesión de AWS Educate en https://www.awseducate.com/signin/.2. Escriba la dirección de correo electrónico y la contraseña que utilizó para iniciar sesión en el portal para

estudiantes de AWS Educate y, a continuación, elija Sign In (Iniciar sesión).3. Elija My Classrooms (Mis aulas).4. Junto al nombre del curso al que desea volver, vuelva a elegir Go to classroom (Ir al aula).5. Elija Continue.6. Elija AWS Console (Consola de AWS).7. Aplique alguna de las siguientes acciones:


Puede continuar utilizando AWS Cloud9. Vaya directamente a Next Steps (Pasos siguientes) (p. 35).

Entrar en el aula virtual como instructor1. Con el ECP de AWS Educate abierto, elija Classrooms & Credits (Aulas y créditos).

Note

Para volver al ECP de AWS Educate, vaya al sitio web de inicio de sesión de AWS Educate enhttps://www.awseducate.com/signin/. Escriba la dirección de correo electrónico y la contraseñaque utilizó para iniciar sesión en ECP de AWS Educate y, a continuación, elija Sign In (Iniciarsesión).

2. Elija Request or go to an AWS Educate Classroom (Solicitar o ir a un aula de AWS Educate).3. Elija Go to my Classrooms (Ir a mis aulas).4. Junto al nombre del curso, elija Go to classroom (Ir al aula).5. Elija Continue.6. Si se muestran los términos y condiciones, léalos y, a continuación, seleccione I Agree (Acepto).7. Si no se muestra el nombre del curso, en la barra de navegación, seleccione My Classes (Mis clases) y,

a continuación, elija el nombre del curso.8. Para comenzar o seguir utilizando AWS Cloud9, en la lista Select Student (Seleccionar estudiante) del

nombre del curso, elija la dirección de correo electrónico del instructor.9. En View (Ver), elija Workarea (Área de trabajo).10.Elija AWS Console (Consola de AWS).11.Aplique alguna de las siguientes acciones:

• Elija Cloud9, si ya aparece.

39




• Amplíe All services (Todos los servicios) y, a continuación, elija Cloud9.• En el cuadro Find services (Buscar servicios), escriba Cloud9 y pulse Enter.• En la barra de navegación de AWS, elija Services (Servicios) y, a continuación, elija Cloud9.

Pasos siguientes









40

AWS Cloud9 Guía del usuarioPrimer vistazo a AWS Cloud9 (consola)

Introducción: tutoriales básicos paraAWS Cloud9

¿Es la primera vez que utiliza AWS Cloud9? Si aún no lo ha hecho, eche un vistazo a la informacióngeneral sobre AWS Cloud9 en ¿Qué es AWS Cloud9? (p. 1)

En los siguientes tutoriales, creará un entorno en AWS Cloud9 y, a continuación, utilizará dicho entornopara crear una aplicación sencilla. Ambos tutoriales tienen los mismos datos y resultados, pero en uno seutiliza la consola de AWS Cloud9 y en el otro la AWS Command Line Interface(AWS CLI). Puede optar porhacer uno de ellos o ambos.

Cuando haya terminado con estos tutoriales, puede obtener más información sobre el IDE de AWS Cloud9en Recorrido del AWS Cloud9 IDE (p. 108).

Temas• Tutorial: Primer vistazo a AWS Cloud9 (consola) (p. 41)• Tutorial: Primer vistazo a AWS Cloud9 (CLI) (p. 52)

Tutorial: Primer vistazo a AWS Cloud9 (consola)En este tutorial se proporciona un primer vistazo a AWS Cloud9. Utiliza la consola de AWS Cloud9, que lepermite realizar los pasos del tutorial en una interfaz gráfica de usuario en lugar de en una herramienta delínea de comandos (p. 52).

En este tutorial, configurará un entorno de desarrollo de AWS Cloud9 y, a continuación, utilizará el AWSCloud9 IDE para codificar, ejecutar y depurar su primera aplicación.

Para este tutorial se necesita aproximadamente 1 hora.

Warning

El uso de este tutorial puede producir cargos en su cuenta de AWS. Entre ellos, se incluyenposibles cargos por Amazon EC2. Para obtener más información, consulte Precios de AmazonEC2.

Requisitos previosPara completar este tutorial correctamente, primero debe completar los pasos de Configuración de AWSCloud9 (p. 6).

Pasos• Paso 1: Crear un entorno (p. 42)• Paso 2: Recorrido básico del IDE (p. 44)

41

https://docs.aws.amazon.com/cli/latest/userguide/



AWS Cloud9 Guía del usuarioPaso 1: Crear un entorno

• Paso 3: Eliminación (p. 49)• Información relacionada (p. 50)

Paso 1: Crear un entorno(Primer paso del Tutorial: Primer vistazo a AWS Cloud9 (consola) (p. 41))

En este paso va a utilizar la consola de AWS Cloud9 para crear un entorno de desarrollo de AWS Cloud9 ydespués abrirlo.

Note

Si ya ha creado el entorno que desea utilizar en este tutorial, abra el entorno y vaya a Paso 2:Recorrido básico del IDE (p. 44).

En AWS Cloud9, un entorno de desarrollo (o simplemente entorno) es el lugar en el que se almacenan losarchivos del proyecto de desarrollo y donde se ejecutan las herramientas para desarrollar aplicaciones. Eneste tutorial, creará un tipo especial de entorno llamado entorno de EC2 y, a continuación, trabajará con losarchivos y las herramientas de ese entorno.

Crear un entorno de EC2 con la consola1. Inicie sesión en la consola de AWS Cloud9 como sigue:

• Si es usted la única persona que utiliza la cuenta de AWS o es un usuario de IAM en una únicacuenta de AWS, vaya a https://console.aws.amazon.com/cloud9/.

• Si su organización utiliza Inicio de sesión único de AWS (AWS SSO), solicite instrucciones de iniciode sesión al administrador de la cuenta de AWS.

• Si utiliza una cuenta AWS Educate Starter, consulte Paso 2: Iniciar sesión en la consola de AWSCloud9 (p. 33) en la inscripción de estudiante individual.

• Si es un estudiante en un aula, pide a su instructor las instrucciones de inicio de sesión.2. Después de iniciar sesión en la consola de AWS Cloud9, en la barra de navegación superior, elija

una región de AWS en la que crear el entorno. Para ver una lista de las regiones de AWS disponibles,consulte AWS Cloud9 en la AWS General Reference.

3. Elija el botón Create entorno (Crear entorno) grande en una de las ubicaciones que se muestran acontinuación.

Si aún no tiene ningún entornos de AWS Cloud9, el botón se muestra en una página de bienvenida.

42


https://docs.aws.amazon.com/general/latest/gr/rande.html#cloud9_region


Si ya tiene entornos de AWS Cloud9, el botón se muestra como se indica a continuación.

4. En la página Name entorno (Asignar nombre al entorno), en Name (Nombre), escriba un nombre parael entorno. Para este tutorial, escriba my-demo-entorno.

5. En Description (Descripción), escriba algo acerca de su entorno. Para este tutorial, utilice Thisenvironment is for the AWS Cloud9 tutorial.

6. Elija Next Step.7. En la página Configure settings (Configurar ajustes), en entorno type (Tipo de entorno), elija Create a

new instance for entorno (EC2) (Crear una nueva instancia para el entorno (EC2)).

Warning

Si elige Create a new instance for entorno (EC2) (Crear una nueva instancia para el entorno[EC2]) podría incurrir en cargos en la cuenta de AWS para Amazon EC2.

8. En Instance type (Tipo de instancia), deje la opción predeterminada. Esta opción tiene RAM y vCPUrelativamente bajos, lo que es suficiente para este tutorial.

Warning

Si elige tipos de instancias con más RAM y CPU virtuales, podría incurrir en cargosadicionales en su cuenta de AWS para Amazon EC2.

9. En Platform (Plataforma), elija el tipo de instancia Amazon EC2 que desea: Amazon Linux o Ubuntu.AWS Cloud9 crea la instancia y, a continuación, conecta el entorno a esta.

10. Elija un valor para Cost-saving setting (Configuración de ahorro). Una vez que todas las instancias delnavegador web conectadas al IDE del entorno estén cerradas, AWS Cloud9 espera el tiempo indicadoy, a continuación, cierra la instancia Amazon EC2 del entorno.

Warning

Si elige un periodo de tiempo mayor, podría generar cargos adicionales en su cuenta deAWS.

11. Expanda Network settings (advanced) (Ajustes de red (Avanzado)).

AWS Cloud9 utiliza Amazon Virtual Private Cloud (Amazon VPC) para comunicarse con la instanciaAmazon EC2 recién creada. En este tutorial, le recomendamos que no cambie la configuraciónpredeterminada preseleccionada. Con la configuración predeterminada, AWS Cloud9 intenta utilizar

43

AWS Cloud9 Guía del usuarioPaso 2: Recorrido básico

automáticamente la VPC predeterminada con su única subred en la misma cuenta de AWS y regiónde AWS que el nuevo entorno.

Puede encontrar más información sobre las opciones de Amazon VPC en Crear un entorno deEC2 con la consola (p. 64) y en Configuración de VPC para entornos de desarrollo de AWSCloud9 (p. 501).

12. Añada hasta 50 etiquetas suministrando los valores de Key (Clave) y Value (Valor) para cada etiqueta.Las etiquetas se asociarán al entorno de AWS Cloud9 como etiquetas de recursos y se propagarán alos siguientes recursos subyacentes: la pila de AWS CloudFormation, la instancia Amazon EC2 y losgrupos de seguridad de Amazon EC2. Puede encontrar información sobre las etiquetas en Controlarel acceso con etiquetas de recursos de AWS en la Guía del usuario de IAM. Consulte también lainformación avanzada (p. 552) sobre las etiquetas.

Warning

Si actualiza estas etiquetas después de crearlas, los cambios NO se propaganautomáticamente a los recursos subyacentes. Para obtener más información, consultePropagación de actualizaciones de etiquetas a los recursos subyacentes (p. 552) en lainformación avanzada acerca de las etiquetas (p. 552).

13. Elija Next Step.14. En la página Review (Revisión), elija Create environment (Crear entorno). Espere mientras AWS

Cloud9 crea su entorno. Esto puede tardar varios minutos.

Note

Si se produce un error en la creación de la cuenta, se muestra un banner en la parte superiorde la página de la consola. Además, la tarjeta del entorno, si existe, indica que se haproducido un error en la creación del entorno.

Una vez AWS Cloud9 haya creado su entorno, se mostrará el AWS Cloud9 IDE para el entorno.

Si AWS Cloud9 no muestra el IDE transcurridos al menos cinco minutos, puede que haya un problema consu navegador web, los permisos de acceso de AWS, la instancia o la nube virtual privada (VPC) asociada.Para obtener información sobre posibles soluciones, consulte No se puede abrir un entorno (p. 556) enSolución de problemas.

Paso siguientePaso 2: Recorrido básico del IDE (p. 44)

Paso 2: Recorrido básico del IDE(Paso anterior: Paso 1: Crear un entorno (p. 42))

En esta parte del tutorial se presentan algunas de las formas en las que puede utilizar el IDE de AWSCloud9 para crear y probar aplicaciones.

• Puede utilizar una ventana del editor para crear y editar código.• Puede utilizar una ventana de terminal o una ventana Run Configuration (Configuración de ejecución)

para ejecutar el código sin depurarlo.• Puede utilizar la ventana Debugger (Depurador) para depurar el código.

Estas tres tareas se realizan con el motor de Node.js y JavaScript. Consulte Tutoriales yejemplos (p. 350) para ver otros lenguajes de programación.

44

https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html


https://docs.aws.amazon.com/IAM/latest/UserGuide/


Temas• Preparar el entorno (p. 45)• Escribir código (p. 45)• Ejecutar el código (p. 46)• Depurar el código (p. 47)• Paso siguiente (p. 49)

Preparar el entornoLa mayoría de las herramientas que necesita para ejecutar y depurar código JavaScript ya estáninstaladas. Sin embargo, necesita un paquete adicional de Node.js para este tutorial. Instálelo como seindica a continuación.

1. En la barra de menús (en la parte superior del AWS Cloud9 IDE), elija Window (Ventana), NewTerminal (Nuevo terminal) o utilice una ventana de terminal existente.

2. En la ventana de terminal (una de las pestañas de la parte inferior del IDE), escriba lo siguiente.

npm install readline-sync

Compruebe que el resultado es similar al siguiente.

+ [email protected] 1 package from 1 contributor and audited 5 packages in 0.565sfound 0 vulnerabilities

Escribir códigoComience por escribir código.

1. En la barra de menús, elija File (Archivo), New File (Archivo nuevo).2. Añada el siguiente código JavaScript al nuevo archivo.

var readline = require('readline-sync');var i = 10;var input;

console.log("Hello Cloud9!");console.log("i is " + i);

do { input = readline.question("Enter a number (or 'q' to quit): "); if (input === 'q') { console.log('OK, exiting.') } else{ i += Number(input); console.log("i is now " + i); }} while (input != 'q');

console.log("Goodbye!");

3. Elija File (Archivo), Save (Guardar) y, a continuación, guarde el archivo como hello-cloud9.js.

45


Ejecutar el códigoA continuación, puede ejecutar su código.

En función del lenguaje de programación que utilice, puede haber varias formas en las que se puedaejecutar el código. En este tutorial utilizamos JavaScript, que se puede ejecutar mediante una ventana determinal o una ventana Run Configuration (Configuración de ejecución).

Para ejecutar el código utilizando una ventana de configuración de ejecución

1. En la barra de menús, elija Run (Ejecutar), Run Configurations (Configuraciones de ejecución), NewRun Configuration (Nueva configuración de ejecución).

2. En la nueva ventana Run Configuration (Configuración de ejecución), una de las pestañas de la parteinferior del IDE, escriba hello-cloud9.js en el campo Command (Comando) y, a continuación,elija Run (Ejecutar).

3. Asegúrese de que se haya activado Run Configuration (Configuración de ejecución) y, a continuación,escriba un número en el símbolo del sistema para interactuar con la aplicación.

4. Vea la salida del código en la ventana Run Configuration (Configuración de ejecución). Debería sersimilar a lo siguiente.

Para ejecutar el código utilizando una ventana de terminal

1. Vaya a la ventana de terminal que ha utilizado anteriormente (o abra una nueva).2. En la ventana de terminal, escriba ls en el símbolo del terminal y compruebe que el archivo de código

está en la lista de archivos.3. Escriba node hello-cloud9.js en el símbolo del sistema para iniciar la aplicación.4. Escriba un número en el símbolo del sistema para interactuar con la aplicación.5. Vea la salida del código en la ventana de terminal. Debería ser similar a lo siguiente.

46


Depurar el códigoPor último, puede depurar el código utilizando la ventana Debugger (Depurador).

1. Elija el margen junto a la línea 10 para añadir un punto de interrupción al código en dicha línea (if(input === 'q')). Aparece un círculo rojo junto a ese número de línea, tal y como se indica acontinuación.

2. Elija el botón Debugger (Depurador) en el lado derecho del IDE para abrir la ventana Debugger(Depurador). También puede elegir Window (Ventana), Debugger (Depurador) en la barra de menús.

A continuación, coloque una inspección en la variable input; para ello, elija Type an expression here(Escriba una expresión aquí) en la sección Watch Expressions (Expresiones de inspección) de laventana Debugger (Depurador) .

47


3. Vaya a la ventana Run Configuration (Configuración de ejecución) que ha utilizado anteriormente paraejecutar el código. Elija Run (Ejecutar).

También puede abrir una nueva ventana Run Configuration (Configuración de ejecución) y empezara ejecutar el código; para ello, elija Run (Ejecutar), Run With (Ejecutar con), Node.js en la barra demenús.

4. Escriba un número en el símbolo del sistema de Run Configuration (Configuración de ejecución) ycompruebe que el código se detiene en la línea 10. La ventana Debugger (Depurador) muestra elvalor que ha especificado en Watch Expressions (Expresiones de inspección).

5. En la ventana Debugger (Depurador), elija Resume (Reanudar), que es el icono de flecha azulresaltado en la captura de pantalla anterior.

6. Seleccione Stop (Detener) en la ventana Run Configuration (Configuración de ejecución) para detenerel depurador.

48

AWS Cloud9 Guía del usuarioPaso 3: Eliminación

Paso siguientePaso 3: Eliminación (p. 49)

Paso 3: Eliminación(Paso anterior: Paso 2: Recorrido básico del IDE (p. 44))

Para evitar que se realicen cargos continuos en su cuenta de AWS en relación con este tutorial, deberíaeliminar el entorno.

Warning

La eliminación de un entorno no se puede deshacer.

Eliminar el entorno mediante la consola de AWS Cloud91. Para abrir el panel, en la barra de menús del IDE, elija AWS Cloud9, Go To Your Dashboard (Ir al

panel).2. Aplique alguna de las siguientes acciones:

• Elija el título dentro de la tarjeta my-demo-entornoy, a continuación, seleccione Delete (Eliminar).

• Seleccione la tarjeta my-demo-entorno y, a continuación, seleccione Delete (Eliminar).

49

AWS Cloud9 Guía del usuarioInformación relacionada

3. En el cuadro de diálogo Delete (Eliminar), escriba Delete y, a continuación, elija Delete (Eliminar). Laoperación de eliminación tardará unos minutos.

Note

Si ha seguido este tutorial exactamente, entonces el entorno era un entorno de EC2 y AWSCloud9 también termina la instancia Amazon EC2 que estaba conectada a ese entorno.Sin embargo, si utilizó un entorno de SSH en lugar de seguir el tutorial y que entorno estabaconectado a una instancia Amazon EC2, AWS Cloud9 no termina dicha instancia. Si no terminadicha instancia más tarde, en su cuenta de AWS le pueden seguir cobrando cargos continuos porAmazon EC2 en relación con esa instancia.

Paso siguienteInformación relacionada (p. 50)

Información relacionadaA continuación se ofrece información adicional sobre Tutorial: Primer vistazo a AWS Cloud9(consola) (p. 41).

• En el momento de crear un entorno de EC2, el entorno no contiene ningún código de muestra de formapredeterminada. Para crear un entorno con el código de muestra, consulte uno de los siguientes temas:• Trabajo con instancias de Amazon Lightsail en el AWS Cloud9 Integrated Development Environment

(IDE) (p. 299)• Trabajo con proyectos de AWS CodeStar en el AWS Cloud9 Integrated Development Environment

(IDE) (p. 306)• Durante la creación del entorno de desarrollo de AWS Cloud9, indicó a AWS Cloud9 que creara una

instancia Amazon EC2. AWS Cloud9 creó la instancia y, a continuación, conectó el entorno a esta.Como alternativa, puede utilizar una instancia de computación en la nube existente o su propio servidor(lo que se denomina un entorno de SSH). Para obtener más información, consulte Creación de unentorno en AWS Cloud9 (p. 61).

Siguientes pasos opcionales

Examine todos o algunos de los siguientes temas para continuar familiarizándose con AWS Cloud9.

50



Obtenga más información acerca de lo que puedehacer con un entorno.

Uso de entornos en AWS Cloud9 (p. 61)

Pruebe otros lenguajes informáticos. Tutoriales y ejemplos para AWS Cloud9 (p. 350)

Más información sobre el AWS Cloud9 IDE. Recorrido del AWS Cloud9 IDE (p. 108) en Usodel IDE (p. 107)



Cree entornos de SSH (entornos que usaninstancias o servidores de informática en lanube que ha creado, en lugar de una instanciaAmazon EC2 que AWS Cloud9 ha creadoautomáticamente).

Creación de un entorno en AWS Cloud9 (p. 61)y Requisitos de host de entorno de desarrollo deSSH de AWS Cloud9 (p. 514)

Utilizar AWS Cloud9 con Lambda. Tutorial de AWS Lambda para AWSCloud9 (p. 350), Tutorial avanzado de AWSLambda para AWS Cloud9 (p. 368) y Trabajocon funciones AWS Lambda en el AWSCloud9 Integrated Development Environment(IDE) (p. 308)

Utilizar AWS Cloud9 con Amazon Lightsail. Trabajo con instancias de Amazon Lightsail en elAWS Cloud9 Integrated Development Environment(IDE) (p. 299)

Utilizar AWS Cloud9 con AWS CodeStar. Trabajo con proyectos de AWS CodeStar en elAWS Cloud9 Integrated Development Environment(IDE) (p. 306)

Utilizar AWS Cloud9 con AWS CodePipeline. Trabajar con AWS CodePipeline en el AWSCloud9 Integrated Development Environment(IDE) (p. 347)

Usar AWS Cloud9 con la AWS CLI, el aws-shell,AWS CodeCommit, el kit de desarrollo en lanube de AWS (CDK de AWS), GitHub o AmazonDynamoDB, así como Node.js, Python u otroslenguajes de programación.

Tutoriales y ejemplos (p. 350)



Para obtener ayuda de la comunidad sobre AWS Cloud9, consulte el foro de debate de AWS Cloud9.(Cuando entre en este foro, es posible que AWS requiera que inicie sesión).

Para obtener ayuda sobre AWS Cloud9 directamente de AWS, consulte las distintas opciones de soporteque se ofrecen en la página de AWS Support.

51



https://aws.amazon.com/premiumsupport

AWS Cloud9 Guía del usuarioPrimer vistazo a AWS Cloud9 (CLI)

Tutorial: Primer vistazo a AWS Cloud9 (CLI)En este tutorial se proporciona un primer vistazo a AWS Cloud9. Utiliza la AWS Command Line Interface(AWS CLI), que le permite configurar y colgar los recursos que necesita utilizando una línea de comandosen lugar de una interfaz gráfica de usuario (p. 41).

En este tutorial, configurará un entorno de desarrollo de AWS Cloud9 y, a continuación, utilizará el AWSCloud9 IDE para codificar, ejecutar y depurar su primera aplicación.

Para este tutorial se necesita aproximadamente 1 hora.

Warning

El uso de este tutorial puede producir cargos en su cuenta de AWS. Entre ellos, se incluyenposibles cargos por Amazon EC2. Para obtener más información, consulte Precios de AmazonEC2.


Pasos• Paso 1: Crear un entorno (p. 52)• Paso 2: Recorrido básico del IDE (p. 54)• Paso 3: Eliminación (p. 58)• Información relacionada (p. 59)

Paso 1: Crear un entorno(Primer paso de Tutorial: Primer vistazo a AWS Cloud9 (CLI) (p. 52))

En este paso, utilice la AWS CLI para crear un entorno de desarrollo de AWS Cloud9.

En AWS Cloud9, un entorno de desarrollo (o simplemente entorno) es el lugar en el que se almacenan losarchivos del proyecto de desarrollo y donde se ejecutan las herramientas para desarrollar aplicaciones. Eneste tutorial, creará un tipo especial de entorno llamado entorno de EC2 y, a continuación, trabajará con losarchivos y las herramientas de ese entorno.

Crear un entorno de EC2 con la AWS CLINote

En la actualidad, no puede utilizar la AWS CLI para crear un entorno de EC2 basado en UbuntuServer, solo Amazon Linux. Se espera ofrecer compatibilidad con Ubuntu Server en el futuro.

1. Si aún no lo ha hecho, instale y configure la AWS CLI. Para ello, consulte lo siguiente en la AWSCommand Line Interface Guía del usuario:

• Instalación de la interfaz de línea de comandos de AWS• Configuración rápida

52








Le recomendamos que configure la AWS CLI utilizando las credenciales de uno de lo siguiente:

• El usuario de IAM que creó en Configuración de equipos para AWS Cloud9 (p. 8).• Un usuario administrador de IAM en su cuenta de AWS, si va a trabajar periódicamente con

recursos de AWS Cloud9 para varios usuarios en la cuenta. Si no puede configurar la AWS CLIcomo usuario administrador de IAM, consulte con el administrador de su cuenta de AWS. Paraobtener más información, consulte Creación del primer grupo y usuario administrador de IAM en laGuía del usuario de IAM.

• Un usuario raíz de la cuenta de AWS, pero solo si usted será siempre el único que utilice supropia cuenta de AWS y si no necesita compartir sus entornos con nadie más. Para obtener másinformación, consulte Creación, desactivación y eliminación de claves de acceso para su usuarioraíz de la cuenta de AWS en la Referencia general de Amazon Web Services.

• Para otras opciones, consulte al administrador de la cuenta de AWS o al instructor del aula.2. En el siguiente comando de AWS Cloud9, proporcione un valor para --region y --subnet-id. A

continuación, ejecute el comando y anote el valor "environmentId" para la limpieza posterior.

aws cloud9 create-environment-ec2 --name my-demo-entorno --description "This entorno is for the AWS Cloud9 tutorial." --instance-type t2.micro --region MY-REGION --subnet-id subnet-12a3456b

En el comando anterior:

• --name representa el nombre del entorno. En este tutorial, usamos el nombre my-demo-entorno.• --description representa una descripción opcional del entorno.• --instance-type representa el tipo de instancia de Amazon EC2 que lanzará AWS Cloud9

y conectará al nuevo entorno. Este ejemplo especifica t2.micro, que tiene RAM y vCPUsrelativamente bajos, pero que son suficientes para este tutorial. Si especifica tipos de instancias conmás RAM y CPU virtuales, podría incurrir en cargos adicionales en su cuenta de AWS para AmazonEC2. Para obtener una lista de tipos de instancias disponibles, consulte el asistente de creación deentornos en la consola de AWS Cloud9.

• --region representa el ID de la región de AWS en la que AWS Cloud9 creará el entorno. Para veruna lista de las regiones de AWS disponibles, consulte AWS Cloud9 en la Referencia general deAmazon Web Services.

• --subnet-id representa la subred que desea que utilice AWS Cloud9. Sustituyasubnet-12a3456b por el ID de la subred de una Amazon Virtual Private Cloud (VPC), que debeser compatible con AWS Cloud9. Para obtener más información, consulte Crear una AmazonVPC para AWS Cloud9 (p. 511) en Configuración de VPC para entornos de desarrollo de AWSCloud9 (p. 501).

• De manera predeterminada, AWS Cloud9 cierra la instancia de Amazon EC2 para el entorno 30minutos después de cerrarse todas las instancias del navegador web que están conectadas al IDEvinculado al entorno. Para cambiarlo, añada --automatic-stop-time-minutes y el número deminutos. Si elige un periodo de tiempo más corto, podría generar menos cargos en su cuenta deAWS. Del mismo modo, un tiempo superior podría dar lugar a cargos adicionales.

• De forma predeterminada, la entidad que llame a este comando es la propietaria del entorno. Paracambiarlo, añada --owner-id y el nombre de recurso de Amazon (ARN) de la entidad propietaria.

3. Después de ejecutar correctamente este comando, abra el AWS Cloud9 IDE del entorno reciéncreado. Para hacer esto, consulte Apertura de un entorno en AWS Cloud9 (p. 74). A continuación,vuelva a este tema y continúe en el Paso 2: Recorrido básico del IDE (p. 44) para aprender autilizar el AWS Cloud9 IDE para trabajar con su nuevo entorno.

Si intenta abrir el entorno pero AWS Cloud9 no muestra el IDE transcurridos al menos cinco minutos,puede que haya un problema con su navegador web, los permisos de acceso de AWS, la instancia o

53


https://docs.aws.amazon.com/general/latest/gr/managing-aws-access-keys.html#create-aws-access-key

https://docs.aws.amazon.com/general/latest/gr/managing-aws-access-keys.html#create-aws-access-key



la nube virtual privada (VPC) asociada. Para obtener información sobre posibles soluciones, consulteNo se puede abrir un entorno (p. 556) en Solución de problemas.

Paso siguientePaso 2: Recorrido básico del IDE (p. 54)

Paso 2: Recorrido básico del IDE(Paso anterior: Paso 1: Crear un entorno (p. 52))

En esta parte del tutorial se presentan algunas de las formas en las que puede utilizar el IDE de AWSCloud9 para crear y probar aplicaciones.

• Puede utilizar una ventana del editor para crear y editar código.• Puede utilizar una ventana de terminal o una ventana Run Configuration (Configuración de ejecución)

para ejecutar el código sin depurarlo.• Puede utilizar la ventana Debugger (Depurador) para depurar el código.

Estas tres tareas se realizan con el motor de Node.js y JavaScript. Consulte Tutoriales yejemplos (p. 350) para ver otros lenguajes de programación.

Temas• Preparar el entorno (p. 54)• Escribir código (p. 54)• Ejecutar el código (p. 55)• Depurar el código (p. 56)• Paso siguiente (p. 58)

Preparar el entornoLa mayoría de las herramientas que necesita para ejecutar y depurar código JavaScript ya estáninstaladas. Sin embargo, necesita un paquete adicional de Node.js para este tutorial. Instálelo como seindica a continuación.

1. En la barra de menús (en la parte superior del AWS Cloud9 IDE), elija Window (Ventana), NewTerminal (Nuevo terminal) o utilice una ventana de terminal existente.

2. En la ventana de terminal (una de las pestañas de la parte inferior del IDE), escriba lo siguiente.

npm install readline-sync

Compruebe que el resultado es similar al siguiente.

+ [email protected] 1 package from 1 contributor and audited 5 packages in 0.565sfound 0 vulnerabilities

Escribir códigoComience por escribir código.

54


1. En la barra de menús, elija File (Archivo), New File (Archivo nuevo).2. Añada el siguiente código JavaScript al nuevo archivo.

var readline = require('readline-sync');var i = 10;var input;

console.log("Hello Cloud9!");console.log("i is " + i);

do { input = readline.question("Enter a number (or 'q' to quit): "); if (input === 'q') { console.log('OK, exiting.') } else{ i += Number(input); console.log("i is now " + i); }} while (input != 'q');

console.log("Goodbye!");

3. Elija File (Archivo), Save (Guardar) y, a continuación, guarde el archivo como hello-cloud9.js.

Ejecutar el códigoA continuación, puede ejecutar su código.

En función del lenguaje de programación que utilice, puede haber varias formas en las que se puedaejecutar el código. En este tutorial utilizamos JavaScript, que se puede ejecutar mediante una ventana determinal o una ventana Run Configuration (Configuración de ejecución).

Para ejecutar el código utilizando una ventana de configuración de ejecución


2. En la nueva ventana Run Configuration (Configuración de ejecución), una de las pestañas de la parteinferior del IDE, escriba hello-cloud9.js en el campo Command (Comando) y, a continuación,elija Run (Ejecutar).

3. Asegúrese de que se haya activado Run Configuration (Configuración de ejecución) y, a continuación,escriba un número en el símbolo del sistema para interactuar con la aplicación.

4. Vea la salida del código en la ventana Run Configuration (Configuración de ejecución). Debería sersimilar a lo siguiente.

55


Para ejecutar el código utilizando una ventana de terminal

1. Vaya a la ventana de terminal que ha utilizado anteriormente (o abra una nueva).2. En la ventana de terminal, escriba ls en el símbolo del terminal y compruebe que el archivo de código

está en la lista de archivos.3. Escriba node hello-cloud9.js en el símbolo del sistema para iniciar la aplicación.4. Escriba un número en el símbolo del sistema para interactuar con la aplicación.5. Vea la salida del código en la ventana de terminal. Debería ser similar a lo siguiente.

Depurar el códigoPor último, puede depurar el código utilizando la ventana Debugger (Depurador).

56


1. Elija el margen junto a la línea 10 para añadir un punto de interrupción al código en dicha línea (if(input === 'q')). Aparece un círculo rojo junto a ese número de línea, tal y como se indica acontinuación.

2. Elija el botón Debugger (Depurador) en el lado derecho del IDE para abrir la ventana Debugger(Depurador). También puede elegir Window (Ventana), Debugger (Depurador) en la barra de menús.

A continuación, coloque una inspección en la variable input; para ello, elija Type an expression here(Escriba una expresión aquí) en la sección Watch Expressions (Expresiones de inspección) de laventana Debugger (Depurador) .

57


3. Vaya a la ventana Run Configuration (Configuración de ejecución) que ha utilizado anteriormente paraejecutar el código. Elija Run (Ejecutar).

También puede abrir una nueva ventana Run Configuration (Configuración de ejecución) y empezara ejecutar el código; para ello, elija Run (Ejecutar), Run With (Ejecutar con), Node.js en la barra demenús.

4. Escriba un número en el símbolo del sistema de Run Configuration (Configuración de ejecución) ycompruebe que el código se detiene en la línea 10. La ventana Debugger (Depurador) muestra elvalor que ha especificado en Watch Expressions (Expresiones de inspección).

5. En la ventana Debugger (Depurador), elija Resume (Reanudar), que es el icono de flecha azulresaltado en la captura de pantalla anterior.

6. Seleccione Stop (Detener) en la ventana Run Configuration (Configuración de ejecución) para detenerel depurador.


Paso 3: Eliminación(Paso anterior: Paso 2: Recorrido básico del IDE (p. 54))

58


Para evitar que se realicen cargos continuos en su cuenta de AWS en relación con este tutorial, deberíaeliminar el entorno.

Warning

La eliminación de un entorno no se puede deshacer.

Eliminar el entorno con la AWS CLI1. Ejecute el comando delete-environment de AWS Cloud9, especificando el ID del entorno que

desea eliminar.

aws cloud9 delete-environment --region MY-REGION --environment-id 12a34567b8cd9012345ef67abcd890e1

En el comando anterior, sustituya MY-REGION por la región de AWS en la que se creó el entorno y12a34567b8cd9012345ef67abcd890e1 por el ID del entorno que se va a eliminar.

Si no guardó el ID al crear el entorno, utilice la consola de AWS Cloud9 para encontrarlo. Seleccioneel nombre del entorno en la consola y, a continuación, busque la última parte de Environment ARN(ARN del entorno).

2. Si creó una Amazon VPC para este tutorial y ya no la necesita, elimínela mediante la consola deAmazon VPC en https://console.aws.amazon.com/vpc.


Información relacionadaA continuación se ofrece información adicional para el Tutorial: Primer vistazo a AWS Cloud9(CLI) (p. 52).

• En el momento de crear un entorno de EC2, el entorno no contiene ningún código de muestra de formapredeterminada. Para crear un entorno con el código de muestra, consulte uno de los siguientes temas:• Trabajo con instancias de Amazon Lightsail en el AWS Cloud9 Integrated Development Environment


(IDE) (p. 306)• Durante la creación del entorno de desarrollo de AWS Cloud9, indicó a AWS Cloud9 que creara una

instancia Amazon EC2. AWS Cloud9 creó la instancia y, a continuación, conectó el entorno a esta.Como alternativa, puede utilizar una instancia de computación en la nube existente o su propio servidor(lo que se denomina un entorno de SSH). Para obtener más información, consulte Creación de unentorno en AWS Cloud9 (p. 61).

Siguientes pasos opcionales



Obtenga más información acerca de lo que puedehacer con un entorno.

Uso de entornos en AWS Cloud9 (p. 61)

59

https://console.aws.amazon.com/vpc



Pruebe otros lenguajes informáticos. Tutoriales y ejemplos para AWS Cloud9 (p. 350)

Más información sobre el AWS Cloud9 IDE. Recorrido del AWS Cloud9 IDE (p. 108) en Usodel IDE (p. 107)





Utilizar AWS Cloud9 con Lambda. Tutorial de AWS Lambda para AWSCloud9 (p. 350), Tutorial avanzado de AWSLambda para AWS Cloud9 (p. 368) y Trabajocon funciones AWS Lambda en el AWSCloud9 Integrated Development Environment(IDE) (p. 308)

Utilizar AWS Cloud9 con Amazon Lightsail. Trabajo con instancias de Amazon Lightsail en elAWS Cloud9 Integrated Development Environment(IDE) (p. 299)

Utilizar AWS Cloud9 con AWS CodeStar. Trabajo con proyectos de AWS CodeStar en elAWS Cloud9 Integrated Development Environment(IDE) (p. 306)

Utilizar AWS Cloud9 con AWS CodePipeline. Trabajar con AWS CodePipeline en el AWSCloud9 Integrated Development Environment(IDE) (p. 347)

Usar AWS Cloud9 con la AWS CLI, el aws-shell,AWS CodeCommit, el kit de desarrollo en lanube de AWS (CDK de AWS), GitHub o AmazonDynamoDB, así como Node.js, Python u otroslenguajes de programación.






60




AWS Cloud9 Guía del usuarioCreación de un entorno

Uso de entornos en AWS Cloud9Un entorno de desarrollo es un lugar de AWS Cloud9 en el que almacena los archivos del proyecto yejecuta las herramientas para desarrollar aplicaciones.

AWS Cloud9 proporciona dos tipos de desarrollo de entornos: entornos de EC2 y entornos de SSH. Paracomprender las principales similitudes y diferencias entre estos desarrollos entornos, consulte entornos deEC2 frente a entornos de SSH en AWS Cloud9 (p. 500).

Lea uno o varios de los siguientes temas para aprender a trabajar con un entorno en AWS Cloud9.

Temas• Creación de un entorno en AWS Cloud9 (p. 61)• Apertura de un entorno en AWS Cloud9 (p. 74)• Llamar a los servicios de AWS desde un entorno en AWS Cloud9 (p. 76)• Modificación de la configuración del entorno en AWS Cloud9 (p. 84)• Trabajo con entornos compartidos en AWS Cloud9 (p. 88)• Mover o cambiar el tamaño de un entorno en AWS Cloud9 (p. 99)• Eliminación de un entorno en AWS Cloud9 (p. 103)

Creación de un entorno en AWS Cloud9Para crear un entorno de desarrollo de AWS Cloud9, siga uno de estos conjuntos de procedimientos, enfunción de cómo tenga previsto utilizar AWS Cloud9.

Si no está seguro de qué elegir, le recomendamos que utilice Creación de un entorno de EC2 (p. 62).

Crear un entorno de EC2 es la opción más sencilla. AWS Cloud9 crea y configura automáticamenteuna nueva instancia Amazon EC2 en su cuenta de AWS. A continuación, AWS Cloud9 conectaautomáticamente esa nueva instancia a entorno.

Para comprender las principales similitudes y diferencias entre el desarrollo entornos, consulte entornosde EC2 frente a entornos de SSH en AWS Cloud9 (p. 500).

Código fuente proporcionado por Host de entorno de desarrolloproporcionado por

Siga estos procedimientos

Usted AWS Cloud9 Este tema (crear un entorno deEC2 (p. 62))

Usted Usted Este tema (crear un entorno deSSH (p. 71))

Amazon Lightsail o usted Usted, mediante Lightsail Trabajo con instancias deAmazon Lightsail en el AWSCloud9 Integrated DevelopmentEnvironment (IDE) (p. 299)

AWS CodeStar o usted AWS Cloud9, mediante AWSCodeStar

Trabajo con proyectos deAWS CodeStar en el AWS

61

https://aws.amazon.com/lightsail

https://aws.amazon.com/codestar

AWS Cloud9 Guía del usuarioCreación de un entorno de EC2

Código fuente proporcionado por Host de entorno de desarrolloproporcionado por

Siga estos procedimientos

Cloud9 Integrated DevelopmentEnvironment (IDE) (p. 306)

Usted, mediante AWSCodePipeline

AWS Cloud9 o usted Este tema (crear un entorno deEC2 (p. 62) o SSH (p. 71))y, a continuación, consulteTrabajar con AWS CodePipelineen el AWS Cloud9 IntegratedDevelopment Environment(IDE) (p. 347)

Usted, mediante AWSCodeCommit

AWS Cloud9 o usted Ejemplo de AWS CodeCommitpara AWS Cloud9 (p. 382)

Usted, mediante GitHub AWS Cloud9 o usted Este tema (crear un entorno deEC2 (p. 62) o SSH (p. 71))y, a continuación, consulte laEjemplo de GitHub para AWSCloud9 (p. 388)

Temas• Creación de un entorno de EC2 (p. 62)• Creación de un entorno de SSH (p. 71)

Creación de un entorno de EC2Note

El uso de este procedimiento puede producir cargos en su cuenta de AWS. Entre ellos, seincluyen posibles cargos por Amazon EC2. Para obtener más información, consulte Precios deAmazon EC2.

En este procedimiento, AWS Cloud9 crea un entorno de EC2, crea una nueva instancia Amazon EC2 y,a continuación, conecta el entorno con esta instancia recién creada. AWS Cloud9 administra el ciclo devida de esta instancia, incluyendo el inicio, la detención y el reinicio de la instancia según sea necesario. Sialguna vez elimina este entorno, AWS Cloud9 termina esta instancia automáticamente.

Puede crear un entorno de desarrollo de EC2 de AWS Cloud9 con la consola de AWS Cloud9 (p. 62) ocon código (p. 70).

Requisitos previosComplete los pasos de Configuración de AWS Cloud9 (p. 6) para poder iniciar sesión en la consola deAWS Cloud9 y crear entornos.

Crear un entorno de EC2 con la consola1. Inicie sesión en la consola de AWS Cloud9 como sigue:



62

https://aws.amazon.com/codepipeline

https://aws.amazon.com/codepipeline

https://aws.amazon.com/codecommit

https://aws.amazon.com/codecommit

https://github.com/











4. En la página Name entorno (Asignar nombre al entorno), en Name (Nombre), escriba un nombre parael entorno.

5. Para añadir una descripción del entorno, escríbala en Description (Descripción).6. Elija Next Step.7. En la página Configure settings (Configurar ajustes), en entorno type (Tipo de entorno), elija Create a


63



Warning


8. En Instance type (Tipo de instancia), elija un tipo de instancia con la cantidad de RAM y vCPU quecrea que necesita para el tipo de tareas que desea realizar.

Warning




Warning


11. Expanda Network settings (advanced) (Ajustes de red (Avanzado)).12. AWS Cloud9 utiliza Amazon Virtual Private Cloud (Amazon VPC) para comunicarse con la instancia

Amazon EC2 recién creada. En función de cómo esté configurada la Amazon VPC, realice una de lassiguientes operaciones.

Si no está seguro de qué elegir, le recomendamos que vaya al paso siguiente de esteprocedimiento.

Cuando pasa Network settings (advanced) (Configuración de red [avanzada]) y deja la configuraciónpredeterminada preseleccionada, AWS Cloud9 intenta utilizar automáticamente la VPCpredeterminada con una sola subred en la misma cuenta de AWS y región de AWS que el nuevoentorno.

¿La cuenta deAWS tiene accesoo a una AmazonVPC?

¿La VPC seencuentra en lamisma cuentade AWS y regiónde AWS que elnuevo entorno?

¿Esa VPC es lapredeterminadapara su cuenta deAWS?

¿La VPC contieneuna únicasubred?

Haga lo siguiente

No — — — Si no existe unaVPC, créela.

Para crear unaVPC en la mismacuenta de AWSy región deAWS que elnuevo entorno,seleccione Createnew VPC (Crearnueva VPC) y, acontinuación, siga

64






Haga lo siguiente

las instruccionesque aparecen enpantalla. Paraobtener másinformación,consulte Crearuna AmazonVPC para AWSCloud9 (p. 511).

Para crear unaVPC en unacuenta de AWSdistinta del nuevoentorno, consulteTrabajar con VPCcompartidas en laGuía del usuariode Amazon VPC.

Sí Sí Sí Sí Vayadirectamenteal siguientepaso de esteprocedimiento.

Cuando paseNetwork settings(advanced)(Configuración dered (avanzada))y deje laconfiguraciónpredeterminadapreseleccionada,AWS Cloud9intenta utilizarautomáticamentela VPCpredeterminadacon una solasubred en lamisma cuentay región que elnuevo entorno.

65

https://docs.aws.amazon.com/vpc/latest/userguide/vpc-sharing.html







Haga lo siguiente

Sí Sí Sí No Si la VPCpredeterminadatiene variassubredes,expandaNetwork settings(advanced)(Ajustes de red(Avanzado)). EnSubnet (Subred),elija la subredque desee queAWS Cloud9utilice en la VPCpredeterminadapreviamenteseleccionada.

Si la VPCpredeterminadano tienesubredes,deberá crearuna. Para ello,seleccione Createnew subnet(Crear nuevasubred) y sigalas instruccionesen pantalla. Paraobtener másinformación,consulte Crearuna subredpara AWSCloud9 (p. 513).

Sí Sí No Sí Expanda Networksettings (Ajustesde red). EnNetwork (VPC)(Red (VPC)), elijala VPC que deseeque AWS Cloud9utilice.

66






Haga lo siguiente

Sí Sí No No Expanda Networksettings (Ajustesde red). EnNetwork (VPC)(Red (VPC)), elijala VPC que deseeque AWS Cloud9utilice.

Si la VPCelegida tienevarias subredes,expandaNetwork settings(advanced)(Ajustes de red(Avanzado)). EnSubnet (Subred),elija la subred quedesea que AWSCloud9 utilice enla VPC elegida.

Si la VPCelegida notiene subredes,deberá crearuna. Para ello,seleccione Createnew subnet(Crear nuevasubred) y sigalas instruccionesen pantalla. Paraobtener másinformación,consulte Crearuna subredpara AWSCloud9 (p. 513).

67






Haga lo siguiente

Sí No Sí — AWS Cloud9no puedeusar una VPCpredeterminadaen una cuentade AWS que seadiferente a lacuenta de AWSpara el nuevoentorno. Elija unaopción diferentede esta lista.

Sí No No Sí Expanda Networksettings (Ajustesde red). EnNetwork (VPC)(Red (VPC)), elijala VPC que deseeque AWS Cloud9utilice.

Note

La VPCdebeestar enla mismaregión deAWS queel nuevoentorno,inclusosi la VPCestáen otracuentade AWS.

68






Haga lo siguiente

Sí No No No Expanda Networksettings (Ajustesde red). EnNetwork (VPC)(Red (VPC)), elijala VPC que deseeque AWS Cloud9utilice.

En Subnet(Subred), elija lasubred que deseaque AWS Cloud9utilice en la VPCelegida.

Si la VPCelegida no tienesubredes, paracrear una subredpara una VPC enuna cuenta deAWS diferentedel nuevoentorno, consulteTrabajar con VPCcompartidas en laGuía del usuariode Amazon VPC.

Note

La VPC yla subreddebenestar enla mismaregión deAWS queel nuevoentorno,incluso sila VPC yla subredseencuentranen otracuentade AWS.

69




Para obtener más información sobre estas opciones, consulte Configuración de VPC para entornos dedesarrollo de AWS Cloud9 (p. 501).


Warning



Cloud9 crea su entorno. Esto puede tardar varios minutos.Note




Creación de un entorno de EC2 con códigoPara usar el código para crear un entorno de EC2 en AWS Cloud9, llame a la operación para crear unAWS Cloud9 de entorno de EC2, tal y como se indica a continuación.

Note

En estos momentos, no es posible utilizar código para crear un entorno de EC2 basado enUbuntu Server, por ejemplo, mediante la AWS CLI, AWS CloudFormation, los SDK de AWS, lasHerramientas para Windows PowerShell o la API de AWS Cloud9. Por ahora, solo puede utilizarcódigo para crear un entorno de EC2 que está conectado a Amazon Linux. Se espera que en unfuturo se pueda utilizar código para crear un entorno de EC2 basado en Ubuntu Server.

AWS CLI create-environment-ec2

AWS SDK para C++ CreateEnvironmentEC2Request,CreateEnvironmentEC2Result

AWS SDK for Go CreateEnvironmentEC2,CreateEnvironmentEC2Request,CreateEnvironmentEC2WithContext

AWS SDK for Java CreateEnvironmentEC2Request,CreateEnvironmentEC2Result

70




https://docs.aws.amazon.com/cli/latest/reference/cloud9/create-environment-ec2.html

https://sdk.amazonaws.com/cpp/api/LATEST/class_aws_1_1_cloud9_1_1_model_1_1_create_environment_e_c2_request.html

https://sdk.amazonaws.com/cpp/api/LATEST/class_aws_1_1_cloud9_1_1_model_1_1_create_environment_e_c2_result.html

https://docs.aws.amazon.com/sdk-for-go/api/service/cloud9/#Cloud9.CreateEnvironmentEC2

https://docs.aws.amazon.com/sdk-for-go/api/service/cloud9/#Cloud9.CreateEnvironmentEC2Request

https://docs.aws.amazon.com/sdk-for-go/api/service/cloud9/#Cloud9.CreateEnvironmentEC2WithContext

https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/cloud9/model/CreateEnvironmentEC2Request.html

https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/cloud9/model/CreateEnvironmentEC2Result.html

AWS Cloud9 Guía del usuarioCreación de un entorno de SSH

AWS SDK for JavaScript createEnvironmentEC2

AWS SDK para .NET CreateEnvironmentEC2Request,CreateEnvironmentEC2Response

AWS SDK para PHP createEnvironmentEC2

AWS SDK for Python (Boto) create_environment_ec2

AWS SDK parar Ruby create_environment_ec2

Herramientas de AWS para Windows PowerShell New-C9EnvironmentEC2

API de AWS Cloud9 CreateEnvironmentEC2

Creación de un entorno de SSHUn entorno de desarrollo de SSH de AWS Cloud9 se crea con la consola de AWS Cloud9. (No se puedecrear un entorno de SSH con código.)

Requisitos previos• Asegúrese de haber completado los pasos de Configuración de AWS Cloud9 (p. 6) en primer lugar, para

que pueda iniciar sesión en la consola de AWS Cloud9 y crear entornos.• Identifique una instancia de informática en la nube existente (por ejemplo, una instancia Amazon EC2 en

su cuenta de AWS), o su propio servidor, que desee que AWS Cloud9 conecte al entorno.• Asegúrese de que la instancia existente o su propio servidor cumpla todos los Requisitos del host

SSH (p. 515). Esto incluye tener versiones específicas de Python, Node.js y otros componentesinstalados; configurar permisos específicos en el directorio desde el que desea que AWS Cloud9 seejecute después del inicio de sesión y configurar cualquier Amazon Virtual Private Cloud asociada.

Cree el entorno de SSH1. Asegúrese de haber completado los requisitos anteriores.2. Si no se ha conectado a su instancia existente o a su propio servidor, utilice un cliente SSH. Debe

hacerlo para poder añadir el valor de la clave SSH pública necesario para la instancia o servidor, tal ycomo se describe más adelante en este procedimiento.

Note

Para conectarse a una instancia de informática en la nube de AWS existente, consulte uno omás de los siguientes recursos:

• Para Amazon EC2, consulte Conexión con la instancia de Linux en la Guía del usuario deAmazon EC2 para instancias de Linux.

• Para Amazon Lightsail, consulte Conectarse a su instancia de Linux o Unix en Lightsail enla documentación de Amazon Lightsail.

• Para AWS Elastic Beanstalk, consulte Listado y conexión a instancias de servidor en laGuía para desarrolladores de AWS Elastic Beanstalk.

• Para AWS OpsWorks, consulte Uso de SSH para iniciar sesión en una instancia de Linuxen la AWS OpsWorks User Guide.

• Para otros servicios de AWS, consulte la documentación del servicio.

71

https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/Cloud9.html#createEnvironmentEC2-property

https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/Cloud9/TCreateEnvironmentEC2Request.html

https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/Cloud9/TCreateEnvironmentEC2Response.html

https://docs.aws.amazon.com/aws-sdk-php/v3/api/api-cloud9-2017-09-23.html#createenvironmentec2

http://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/cloud9.html#Cloud9.Client.create_environment_ec2

https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/Cloud9/Client.html#create_environment_ec2-instance_method

https://docs.aws.amazon.com/powershell/latest/reference/items/New-C9EnvironmentEC2.html

https://docs.aws.amazon.com/cloud9/latest/APIReference/API_CreateEnvironmentEC2.html

https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/AccessingInstances.html

https://lightsail.aws.amazon.com/ls/docs/how-to/article/lightsail-how-to-connect-to-your-instance-virtual-private-server

https://docs.aws.amazon.com/elasticbeanstalk/latest/dg/using-features.ec2connect.html

https://docs.aws.amazon.com/opsworks/latest/userguide/workinginstances-ssh.html

https://docs.aws.amazon.com/


Para conectarse a su propio servidor, puede buscar en Internet usando una frase como"conectarse a un servidor con el comando ssh" (desde macOS o Linux) o "conectarse a unservidor con PuTTY" (desde Windows).

3. Inicie sesión en la consola de AWS Cloud9, en https://console.aws.amazon.com/cloud9/.4. Después de iniciar sesión en la consola de AWS Cloud9, en la barra de navegación superior, elija


5. Si aparece una página de bienvenida, en New AWS Cloud9 entorno (Nuevo entorno de AWS Cloud9),elija Create entorno (Crear entorno). De no ser así, elija Create entorno (Crear entorno).

O bien:

6. En la página Name entorno (Asignar nombre a entorno), en Name (Nombre), escriba un nombre parael entorno.

7. Para añadir una descripción del entorno, escríbala en Description (Descripción).8. Elija Next Step.

72




9. En Environment type (Tipo de entorno), elija Connect and run in remote server (SSH) (Conectar yejecutar en un servidor remoto (SSH)).

10. En Usuario, escriba el nombre de inicio de sesión que utilizó para conectarse a la instancia o alservidor al principio de este procedimiento. Por ejemplo, en el caso de una instancia de informática enla nube de AWS, podría ser ec2-user, ubuntu o root.

Note

Para obtener resultados óptimos, le recomendamos que el nombre de inicio de sesión estéasociado a los privilegios de administrador o a un usuario administrador en la instancia oservidor. En concreto, este nombre de inicio de sesión debe tener la instalación de Node.jsen la instancia o servidor. Para comprobarlo, ejecute el comando ls -l $(which node) desde el terminal de la instancia o el servidor (o ls -l $(nvm which node) si utilizanvm). Este comando muestra el nombre del propietario de la instalación de Node.js (junto conlos permisos de instalación, el nombre del grupo y la ubicación).

11. En Host, escriba la dirección IP pública (preferida) o el nombre de host de la instancia o el servidor.12. En Port (Puerto), escriba el puerto que desea que AWS Cloud9 utilice para intentar conectarse a la

instancia o servidor o deje el puerto predeterminado.13. Para especificar la ruta del directorio de la instancia o el servidor que desea que AWS Cloud9

utilice como punto de partida después del inicio de sesión, que identificó anteriormente en losrequisitos previos de este procedimiento, expanda Advanced settings (Configuración avanzada) y, acontinuación, escriba la ruta en entorno path (Ruta del entorno). Si deja este campo en blanco, AWSCloud9 utiliza el directorio que su instancia o servidor utiliza normalmente para comenzar después deiniciar sesión. Normalmente, es un directorio raíz o predeterminado.

14. Para especificar la ruta al archivo binario Node.js en la instancia o el servidor, expanda Advancedsettings (Configuración avanzada) y, a continuación, escriba la ruta en Node.js binary path (Rutabinaria de Node.js). Para obtener la ruta, puede ejecutar el comando which node (o nvm whichnode si está utilizando nvm) en su instancia o servidor. Por ejemplo, la ruta puede ser /usr/bin/node. Si deja este campo en blanco, AWS Cloud9 intentará adivinar dónde se encuentra el archivobinario Node.js cuando intenta conectarse.

15. Para especificar un host de salto que utiliza la instancia o servidor, expanda Advanced settings(Configuración avanzada) y escriba información sobre el host de salto en SSH jump host (Hostde salto SSH), utilizando el formato USER_NAME@HOSTNAME:PORT_NUMBER (por ejemplo, ec2-user@:ip-192-0-2-0:22)

El host de salto debe cumplir los siguientes requisitos.

• Debe ser accesible a través de la red de Internet pública utilizando SSH.• Debe permitir el acceso de entrada desde cualquier dirección IP a través del puerto especificado.• El valor de clave pública de SSH que se ha copiado en el archivo ~/.ssh/authorized_keys que

se encuentra en el servidor o instancia existente también se debe copiar en el archivo ~/.ssh/authorized_keys que se encuentra en el host de salto.

• Netcat debe estar instalado.16. Elija Copy key to clipboard (Copiar clave en portapapeles). (Está entre View public SSH key (Ver clave

pública SSH) y Advanced settings (Configuración avanzada).) Pegue el valor de la clave SSH públicaque se copió en el archivo ~/.ssh/authorized_keys en la instancia o servidor existente al que seconectó anteriormente en este procedimiento. (~ representa el directorio de inicio del nombre de iniciode sesión del usuario que ha especificado anteriormente en este procedimiento).

Note

Para ver el valor de la clave SSH pública que se ha copiado, amplíe View public SSH key(Ver clave pública SSH).

17. Elija Next Step.

73

AWS Cloud9 Guía del usuarioApertura de un entorno

18. En la página Review (Revisar), elija Create entorno (Crear entorno). Espere mientras AWS Cloud9crea su entorno. Esto puede tardar varios minutos.

Si AWS Cloud9 no muestra el IDE transcurridos al menos cinco minutos, puede que haya un problemacon su navegador web, los permisos de acceso de AWS, la instancia o la red asociada. Para obtenerinformación sobre posibles soluciones, consulte No se puede abrir un entorno (p. 556) en Solución deproblemas.

Apertura de un entorno en AWS Cloud9Este procedimiento describe cómo abrir un entorno en AWS Cloud9.

Note

En este procedimiento, se asume que ya ha creado un entorno de desarrollo de AWS Cloud9.Para crear un entorno, consulte Creación de un entorno (p. 61).

1. Inicie sesión en la consola de AWS Cloud9 como sigue:• Si es usted la única persona que utiliza la cuenta de AWS o es un usuario de IAM en una única

cuenta de AWS, vaya a https://console.aws.amazon.com/cloud9/.• Si su organización utiliza AWS Single Sign-On (SSO), solicite instrucciones de inicio de sesión al

administrador de la cuenta de AWS.• Si utiliza una cuenta AWS Educate Starter, consulte Paso 2: Inicio de sesión en la consola de AWS

Cloud9 (p. 33) en la inscripción de estudiante individual.• Si es un estudiante en un aula, pide a su instructor las instrucciones de inicio de sesión.

2. En la barra de navegación superior, seleccione la región de AWS en la que se encuentra el entorno.

3. En la lista de entornos, para el entorno que desea abrir, realice una de las siguientes operaciones.• Dentro de la tarjeta, elija el enlace Open IDE (Abrir IDE).

74


AWS Cloud9 Guía del usuarioApertura de un entorno

• Seleccione la tarjeta y, a continuación, elija el botón Open IDE (Abrir IDE).

Si su entorno no aparece en la consola, intente realizar una o varias de las siguientes acciones paraintentar que aparezca.

• En la barra de navegación lateral, elija una o varias de las siguientes acciones.• Elija Your entornos (Sus entornos) para mostrar todos los entornos que son propiedad de su entidad

de AWS dentro de la cuenta de AWS y la región de AWS seleccionadas.• Elija Shared with you (Compartido con usted) para mostrar todos los entornos a los que se ha invitado

a su entidad de AWS dentro de la cuenta de AWS y la región de AWS seleccionadas.• Elija Account entornos (entornos de cuenta) para mostrar todos los entornos dentro de la cuenta

de AWS y la región de AWS seleccionadas para las que su entidad de AWS tiene permisos devisualización.

75

AWS Cloud9 Guía del usuarioLlamar a los servicios de AWS desde un entorno

• Elija la flecha anterior, la flecha siguiente o el botón de número de página para mostrar más entornos enel ámbito actual.

• Si cree que debería ser miembro de un entorno, pero el entorno no se muestra en la lista Shared withyou (Compartido con usted), consulte con el propietario del entorno.

• En la barra de navegación superior, elija una región de AWS diferente.

Llamar a los servicios de AWS desde un entorno enAWS Cloud9

Puede llamar a los servicios de AWS desde un entorno de desarrollo de AWS Cloud9. Por ejemplo, puedehacer lo siguiente:

• Cargar y descargar datos en buckets de Amazon Simple Storage Service (Amazon S3).• Enviar notificaciones a través de temas de Amazon Simple Notification Service (Amazon SNS).• Leer y escribir datos en bases de datos de Amazon DynamoDB (DynamoDB).

Puede llamar a los servicios de AWS desde su entorno de varias maneras. Por ejemplo, puede utilizarla AWS Command Line Interface (AWS CLI) o el shell de AWS para ejecutar comandos desde una

76

AWS Cloud9 Guía del usuarioLlamar a los servicios de AWS desde un entorno

sesión de terminal. También puede llamar a los servicios de AWS desde código que se ejecute dentro delentorno, mediante el uso de los SDK de AWS para lenguajes de programación como JavaScript, Python,Ruby, PHP, Go y C++. Para obtener más información, consulte Ejemplo de la CLI de AWS y el shell deAWS (p. 379), la AWS Command Line Interface Guía del usuario y los SDK de AWS.

Cada vez que la AWS CLI, el shell de AWS o su código llaman a un servicio de AWS, la AWS CLI, elshell o el código deben proporcionar un conjunto de credenciales de acceso a AWS junto con la llamada.Estas credenciales determinan si el llamador tiene los permisos adecuados para realizar la llamada. Si lascredenciales no cubren los permisos adecuados, la llamada no se realizará correctamente.

Hay varias formas para proporcionar credenciales a un entorno. En la tabla siguiente se describen algunosenfoques.

entorno type Enfoque

EC2 Use credenciales temporales administradas deAWS.

Recomendamos este enfoque para un entornode EC2. credenciales temporales administradasde AWS administran las credenciales de accesoa AWS en un entorno de EC2 en su nombre, altiempo que aplican las prácticas recomendadas deseguridad de AWS.

Si utiliza un entorno EC2, puede omitir el restode este tema porque las credenciales temporalesadministradas de AWS ya están configuradas en elentorno.

Para obtener más información, consulteCredenciales temporales administradas deAWS (p. 537).

EC2 Asociar un perfil de instancia de IAM a la instancia

Solo debe usar este enfoque si por algunarazón no puede utilizar credenciales temporalesadministradas de AWS. Al igual que credencialestemporales administradas de AWS, un perfil deinstancia administra las credenciales de accesode AWS en su nombre. Sin embargo, debe crear,administrar y adjuntar el perfil de instancia a lainstancia Amazon EC2 manualmente.

Para ver instrucciones, consulte la sección sobrela creación y uso de un perfil de instancia paraadministrar credenciales temporales (p. 78).

EC2 o SSH Almacene las credenciales de acceso de AWSpermanente dentro del entorno.

Este enfoque es menos seguro que el uso decredenciales temporales de acceso a AWS. Sinembargo, es el único enfoque admitido para unentorno de SSH.

77


https://aws.amazon.com/tools/#sdk

AWS Cloud9 Guía del usuarioCreación y uso de un perfil de instancia

para administrar credenciales temporales

entorno type EnfoquePara ver instrucciones, consulte la sección sobrecreación y almacenamiento de credenciales deacceso permanentes en un entorno (p. 82).

EC2 o SSH Inserte las credenciales de acceso de AWSpermanentes directamente en el código.

No aconsejamos este enfoque, ya que no respetalas prácticas recomendadas de seguridad de AWS.

Dado que no se aconseja, no se cubre en estetema.

Creación y uso de un perfil de instancia paraadministrar credenciales temporales

Note

No puede utilizar este procedimiento con un entorno de desarrollo de SSH de AWS Cloud9. Ensu lugar, pase a la sección Crear y almacenar las credenciales de acceso permanentes en unentorno (p. 82).Recomendamos que utilice credenciales temporales administradas de AWS en lugar de un perfilde instancia. Siga estas instrucciones solo si por alguna razón no puede utilizar credencialestemporales administradas de AWS. Para obtener más información, consulte Credencialestemporales administradas de AWS (p. 537).

En este procedimiento usará IAM y Amazon EC2 para crear y adjuntar un perfil de instancia de IAM a lainstancia Amazon EC2 que se conecta a su entorno. Este perfil de instancia administrará las credencialestemporales en su nombre. En este procedimiento, se presupone que ya ha creado un entorno en AWSCloud9. Para crear un entorno, consulte Creación de un entorno (p. 61).

Puede completar estas tareas con las consolas de IAM y de Amazon EC2 (p. 78) o la interfaz de líneade comandos de AWS (CLI de AWS) (p. 79).

Crear un perfil de instancia con la consola de IAMNote

Si ya tiene un rol de IAM que contiene un perfil de instancia, vaya a Asociar un perfil de instanciaa una instancia con la consola de Amazon EC2 (p. 80).

1. Inicie sesión en la consola de IAM en https://console.aws.amazon.com/iam/.

En este paso, le recomendamos que inicie sesión con las credenciales de un usuario administrador deIAM en la cuenta de AWS. Si no puede hacerlo, consulte con el administrador de su cuenta de AWS.

2. En la barra de navegación, seleccione Roles.

Note

No puede utilizar la consola de IAM para crear un perfil de instancia por sí sola. Debe crear unrol de IAM que tenga un perfil de instancia.

3. Elija Create role.4. En la página Select type of trusted entity (Seleccionar tipo de entidad de confianza), con AWS service ya

elegido, en Choose the service that will use this role (Elegir el servicio que usará esa función), elija EC2.

78

https://console.aws.amazon.com/iam



5. En Select your use case (Seleccionar su caso de uso), elija EC2.6. Elija Next: Permissions.7. En la página Attach permissions policies (Adjuntar políticas de permisos), en la lista de políticas,

seleccione la casilla junto a AdministratorAccess y, a continuación, elija Next: Review (Siguiente:Revisión).

Note

La política AdministratorAccess permite el acceso sin restricciones a todas las acciones yrecursos de AWS de su cuenta AWS. Utilícelo solo con fines de experimentación. Para obtenermás información, consulte Políticas de IAM en la Guía del usuario de IAM.

8. En la página Review (Revisar), en Role Name (Nombre de rol), escriba un nombre para el rol (porejemplo, my-demo-cloud9-instance-profile).

9. Elija Create Role.

Avance hasta llegar a Asociar un perfil de instancia a una instancia con la consola de AmazonEC2 (p. 80).

Crear un perfil de instancia con la AWS CLINote

Si ya tiene un rol de IAM que contiene un perfil de instancia, vaya a Asociar un perfil de instanciaa una instancia con la CLI de AWS (p. 81).Para este tema le recomendamos que configure la AWS CLI con las credenciales de usuarioadministrador de IAM de su cuenta de AWS. Si no puede hacerlo, consulte con el administradorde su cuenta de AWS.Note


1. Defina una relación de confianza en AWS para el rol de IAM que requiere el perfil de instancia. Parahacerlo, cree y guarde un archivo con el contenido siguiente (por ejemplo, my-demo-cloud9-instance-profile-role-trust.json).

{ "Version": "2012-10-17", "Statement": [ { "Sid": "", "Effect": "Allow", "Principal": { "Service": "ec2.amazonaws.com" }, "Action": "sts:AssumeRole" } ]}

2. Usando la línea de comandos o terminal, cambie al directorio en el que acaba de guardar este archivo.3. Cree un rol de IAM para perfil de instancia. Para ello, ejecute el comando create-role de IAM,

especificando un nombre para el nuevo rol de IAM (por ejemplo, my-demo-cloud9-instance-profile-role) y el nombre del archivo que acaba de guardar.

79

https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html



aws iam create-role --role-name my-demo-cloud9-instance-profile-role --assume-role-policy-document file://my-demo-cloud9-instance-profile-role-trust.json

4. Adjunte los permisos de acceso de AWS al rol de IAM del perfil de instancia. Para ello, ejecute elcomando attach-role-policy de IAM, especificando el nombre del rol existente de IAM y el nombrede recurso de Amazon (ARN) de la política administrada de AWS llamado AdministratorAccess.

aws iam attach-role-policy --role-name my-demo-cloud9-instance-profile-role --policy-arn arn:aws:iam::aws:policy/AdministratorAccess

Note

La política AdministratorAccess permite el acceso sin restricciones a todas las acciones yrecursos de AWS de su cuenta AWS. Utilícelo solo con fines de experimentación. Para obtenermás información, consulte Políticas de IAM en la Guía del usuario de IAM.

5. Cree el perfil de instancia. Para ello, ejecute el comando create-instance-profile de IAM,especificando un nombre para el nuevo perfil de instancia (por ejemplo, my-demo-cloud9-instance-profile).

aws iam create-instance-profile --instance-profile-name my-demo-cloud9-instance-profile

6. Adjunte el rol de IAM al perfil de instancia. Para ello, ejecute el add-role-to-instance-profile deIAM, especificando los nombres del rol de IAM existente y el perfil de instancia.

aws iam add-role-to-instance-profile --role-name my-demo-cloud9-instance-profile-role --instance-profile-name my-demo-cloud9-instance-profile

Avance hasta llegar a Crear un perfil de instancia con la CLI de AWS (p. 79).

Asociar un perfil de instancia a una instancia con la consola deAmazon EC21. Inicie sesión en la consola de Amazon EC2 en https://console.aws.amazon.com/ec2.


2. En la barra de navegación, asegúrese de que el selector de regiones muestra la región de AWS quecoincide con la de su entorno. Por ejemplo, si creó el entorno en la región EE. UU. Este (Ohio), elija USEast (Ohio) [EE. UU. Este (Ohio)] en el selector de regiones también.

3. Elija el enlace Running Instances (Ejecutar instancias) o, en el panel de navegación, expanda Instances(Instancias) y, a continuación, elija Instances (Instancias).

4. En la lista de instancias, elija la instancia con el Name (Nombre) que incluya el nombre de su entorno.Por ejemplo, si el nombre del entorno es my-demo-environment, elija la instancia con el Name(Nombre) que incluya my-demo-environment.

5. Seleccione Actions (Acciones), Instance Settings (Configuración de instancia), Attach/Replace IAM Role(Asociar o reemplazar rol de IAM).

Note

Aunque está adjuntando un rol a la instancia, el rol contiene un perfil de instancia.6. En la página Attach/Replace IAM Role (Asociar o reemplazar rol de IAM), en IAM role (Rol de IAM),

seleccione el nombre del rol que identifica o que creó en el procedimiento anterior y haga clic en Apply(Aplicar).

80

https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html

https://console.aws.amazon.com/ec2



7. De vuelta en el entorno, use la AWS CLI para ejecutar el comando aws configure o el shell de AWSpara ejecutar el comando configure. No especifique ningún valor para AWS Access Key ID o AWSSecret Access Key (presione Enter después de cada indicación). En Default region name (Nombre deregión predeterminada), especifique la región de AWS más cercana a la región en la que se encuentralos recursos de AWS. Por ejemplo, us-east-2 para la región EE. UU. Este (Ohio). Para ver una listade las regiones, consulte Regiones y puntos de enlace de AWS en la Referencia general de AmazonWeb Services. Opcionalmente, especifique un valor para Default output format (Formato de salidapredeterminado) (por ejemplo, json).

Ya puede comenzar a llamar a los servicios de AWS desde su entorno. Para usar la AWS CLI, el shellde AWS o ambos para llamar a los servicios de AWS, consulte Ejemplo de la CLI de AWS y el shell deAWS (p. 379). Para llamar a los servicios de AWS desde su código, consulte los demás tutoriales yejemplos (p. 350).

Asociar un perfil de instancia a una instancia con la AWS CLINote


1. Ejecute el comando associate-iam-instance-profile de Amazon EC2, especificando el nombredel perfil de instancia y el ID, y el ID de región de AWS de la instancia Amazon EC2 para el entorno.

aws ec2 associate-iam-instance-profile --iam-instance-profile Name=my-demo-cloud9-instance-profile --region us-east-2 --instance-id i-12a3b45678cdef9a0

En el comando anterior, sustituya us-east-2 por el ID de la región de AWS de la instancia y sustituyai-12a3b45678cdef9a0 por el ID de la instancia.

Para obtener el ID de la instancia, podría por ejemplo ejecutar el comando describe-instances deAmazon EC2, especificando el nombre y el ID de la región de AWS ID del entorno.

aws ec2 describe-instances --region us-east-2 --filters Name=tag:Name,Values=*my-environment* --query "Reservations[*].Instances[*].InstanceId" --output text

En el comando anterior, sustituya us-east-2 por el ID de la región de AWS de la instancia y sustituyamy-environment por el nombre del entorno.

2. De vuelta en el entorno, use la AWS CLI para ejecutar el comando aws configure o el shell de AWSpara ejecutar el comando configure. No especifique ningún valor para AWS Access Key ID o AWSSecret Access Key (presione Enter después de cada indicación). En Default region name (Nombre deregión predeterminada), especifique la región de AWS más cercana a la región en la que se encuentralos recursos de AWS. Por ejemplo, us-east-2 para la región EE. UU. Este (Ohio). Para ver una listade las regiones, consulte Regiones y puntos de enlace de AWS en la Referencia general de AmazonWeb Services. Opcionalmente, especifique un valor para Default output format (Formato de salidapredeterminado) (por ejemplo, json).

Ya puede comenzar a llamar a los servicios de AWS desde su entorno. Para usar la AWS CLI, el shellde AWS o ambos para llamar a los servicios de AWS, consulte Ejemplo de la CLI de AWS y el shell deAWS (p. 379). Para llamar a los servicios de AWS desde su código, consulte los demás tutoriales yejemplos (p. 350).

81

https://docs.aws.amazon.com/general/latest/gr/rande.html


AWS Cloud9 Guía del usuarioCrear y almacenar las credenciales

de acceso permanente en un entorno

Crear y almacenar las credenciales de accesopermanente en un entorno

Note

Si utiliza un entorno de desarrollo de EC2 de AWS Cloud9, recomendamos que utilicecredenciales temporales administradas de AWS en lugar de las credenciales de accesopermanente de AWS. Para trabajar con credenciales temporales administradas de AWS, consulteCredenciales temporales administradas de AWS (p. 537).

En esta sección, se utiliza de AWS Identity and Access Management (IAM) para generar un conjunto decredenciales permanentes que la AWS CLI, el shell de AWS o su código pueden utilizar para llamar aservicios de AWS. Este conjunto incluye un ID de clave de acceso de AWS y una clave de acceso secretade AWS, que son únicos de su usuario en su cuenta de AWS. Si ya tiene un ID de clave de acceso deAWS y una clave de acceso secreta de AWS, anote esas credenciales y pase directamente a Crear yalmacenar las credenciales de acceso permanentes en un entorno (p. 83).

Puede crear un conjunto de credenciales permanentes con la consola de IAM (p. 82) o la CLI deAWS (p. 82).

Crear credenciales de acceso permanente con la consola1. Inicie sesión en la consola de IAM en https://console.aws.amazon.com/iam/.


2. En la barra de navegación, seleccione Users (Usuarios).3. En la lista de usuarios, elija el nombre del usuario que ha creado o identificado en Team Setup

(Configuración de equipo) (p. 8).4. Seleccione la pestaña de credenciales de seguridad.5. En Access keys (Clave de acceso), elija Create access key (Crear clave de acceso).6. En la página Create access key (Crear clave de acceso), elija Show (Mostrar) y tome nota de los valores

de ID de clave de acceso y clave de acceso secreta. Le recomendamos también que elija Download.csvfile (Descargar archivo .csv) y que guarde estas credenciales en un lugar seguro.

Pase a la sección Almacenar las credenciales de acceso permanentes en un entorno (p. 83).

Crear credenciales de acceso permanentes con la AWS CLINote

En esta sección, le recomendamos que configure la AWS CLI con las credenciales de un usuarioadministrador de IAM de su cuenta de AWS. Si no puede hacerlo, consulte con el administradorde su cuenta de AWS.Note


Ejecute el comando create-access-key de IAM para crear una clave de acceso de AWS nueva y lacorrespondiente clave de acceso secreta de AWS para el usuario.

82

https://console.aws.amazon.com/iam

AWS Cloud9 Guía del usuarioCrear y almacenar las credenciales

de acceso permanente en un entorno

aws iam create-access-key --user-name MyUser

En el comando anterior, reemplace MyUser por el nombre del usuario.

Guarde los valores AccessKeyId y SecretAccessKey que se muestran en un lugar seguro. Después deejecutar el comando create-access-key de IAM, esta es la única vez que puede usar la AWS CLI paraver la clave de acceso secreta de AWS del usuario. Para generar una nueva clave de acceso secreta deAWS para que el usuario la use más adelante si es necesario, consulte Creación, modificación o consultade las claves de acceso (API, CLI, PowerShell) en la Guía del usuario de IAM.

Almacenar las credenciales de acceso permanentes en unentornoEn este procedimiento, se utiliza el AWS Cloud9 IDE para almacenar la credenciales de accesopermanentes de AWS en su entorno. En este procedimiento se presupone que ya ha creado un entorno enAWS Cloud9, que ha abierto el entorno y que se muestra el AWS Cloud9 IDE en su navegador web. Paraobtener más información, consulte Creación de un entorno (p. 61) y Apertura de un entorno (p. 74).

Note

El siguiente procedimiento muestra cómo almacenar las credenciales de acceso permanentesmediante las variables de entorno. Si tiene la AWS CLI o el shell de AWS instalado en elentorno, puede utilizar el comando aws configure para que la AWS CLI o el comando configure del shell de AWS almacenen las credenciales de acceso permanentes. Para obtenerinstrucciones, consulte Configuración rápida en la AWS Command Line Interface Guía delusuario.

1. Con el entorno abierto, en el AWS Cloud9 IDE, comience una nueva sesión de terminal si no hayninguna iniciada. Para iniciar una nueva sesión del terminal, en la barra de menús, seleccione Window(Ventana), New Terminal (Nuevo terminal).

2. Ejecute cada uno de los siguientes comandos, uno por uno, para definir las variables deentorno locales que representan las credenciales de acceso permanentes. En estos comandos,después de AWS_ACCESS_KEY_ID:, escriba el ID de clave de acceso de AWS. Despuésde AWS_SECRET_ACCESS_KEY, escriba la clave de acceso secreta de AWS. Después deAWS_DEFAULT_REGION_ID, escriba el identificador de la región de AWS asociada a la región de AWSmás cercana (o su región de AWS preferida). Para ver una lista de los identificadores disponibles,consulte Regiones y puntos de enlace de AWS en la Referencia general de Amazon Web Services. Porejemplo, para la región EE. UU. Este (Ohio), usaría us-east-2.

export AWS_ACCESS_KEY_ID=export AWS_SECRET_ACCESS_KEY=export AWS_DEFAULT_REGION=

3. Tenga en cuenta que las variables de entorno anteriores solo son válidas para la sesión de terminalactual. Para que estas variables de entorno estén disponibles en todas las sesiones de terminal, debeañadirlas al archivo de perfil de usuario de shell como variables de entorno de usuario, tal y como seindica a continuación.a. En la ventana Environment (Entorno) del IDE, elija el icono del engranaje y, a continuación,

seleccione Show Home in Favorites (Mostrar inicio en favoritos). Repita este paso y elija tambiénShow Hidden Files (Mostrar archivos ocultos).

b. Abra el archivo ~/.bashrc.c. Escriba o pegue el siguiente código al final del archivo. En estos comandos, después

de AWS_ACCESS_KEY_ID:, escriba el ID de clave de acceso de AWS. Después deAWS_SECRET_ACCESS_KEY, escriba la clave de acceso secreta de AWS. Después deAWS_DEFAULT_REGION_ID, escriba el identificador de la región de AWS asociada a la regiónde AWS más cercana (o su región de AWS preferida). Para ver una lista de los identificadores

83





AWS Cloud9 Guía del usuarioModificación de la configuración del entorno

disponibles, consulte Regiones y puntos de enlace de AWS en la Referencia general de AmazonWeb Services. Por ejemplo, para la región EE. UU. Este (Ohio), usaría us-east-2.

export AWS_ACCESS_KEY_ID=export AWS_SECRET_ACCESS_KEY=export AWS_DEFAULT_REGION=

d. Guarde el archivo.e. Dé el origen del ~/.bashrc archivo para cargar estas nuevas variables de entorno.

. ~/.bashrc

Ya puede comenzar a llamar a los servicios de AWS desde su entorno. Para usar la AWS CLI o el shell deAWS para llamar a los servicios de AWS, consulte Ejemplo de la CLI de AWS y el shell de AWS (p. 379).Para llamar a los servicios de AWS desde su código, consulte los demás tutoriales y ejemplos (p. 350).

Modificación de la configuración del entorno enAWS Cloud9

Puede cambiar las preferencias o la configuración de un entorno de desarrollo de AWS Cloud9.

• Cambiar las preferencias del entorno (p. 84)• Cambiar la configuración del entorno con la consola (p. 84)• Cambiar la configuración del entorno mediante código (p. 87)

Cambiar las preferencias de entorno1. Abra el entorno cuya configuración desea cambiar. Para abrir un entorno, consulte Abrir un

entorno (p. 74).2. En el AWS Cloud9 IDE, en la barra de menús, elija AWS Cloud9, Preferences (Preferencias).3. En la ventana Preferences (Preferencias), elija Project Settings (Configuración del proyecto).4. Cambie los valores de configuración disponibles según desee. Entre estos se incluyen valores como

Code Editor (Ace) (Editor de código (Ace)) y Find in Files (Buscar en archivos).

Note

Para obtener más información, consulte Project Setting Changes You Can Make (p. 173).

Cambiar la configuración del entorno con la consola1. Inicie sesión en la consola de AWS Cloud9 como sigue:


• Si su organización utiliza AWS Single Sign-On (SSO), solicite instrucciones de inicio de sesión aladministrador de la cuenta de AWS.

• Si utiliza una cuenta AWS Educate Starter, consulte Paso 2: Inicio de sesión en la consola de AWSCloud9 (p. 33) en la inscripción de estudiante individual.

• Si es un estudiante en un aula, pide a su instructor las instrucciones de inicio de sesión.

84



AWS Cloud9 Guía del usuarioCambiar la configuración del entorno con la consola


3. En la lista de entornos, en el entorno cuya configuración desea cambiar, realice una de las siguientesoperaciones.• Elija el título de la tarjeta del entorno. Después, en la página siguiente, elija Edit (Editar).

• Seleccione la tarjeta del entorno y, a continuación, elija el botón Edit (Editar).

85

AWS Cloud9 Guía del usuarioCambiar la configuración del entorno con la consola

4. Realice sus cambios y elija Save changes (Guardar cambios).

Puede usar la consola de AWS Cloud9 para cambiar los valores de configuración siguientes.• Para entornos de EC2, Name (Nombre) y Description (Descripción).• Para entornos de SSH: Name (Nombre), Description (Descripción), User (Usuario), Host (Host), Port

(Puerto), Environment path (Ruta del entorno), Node.js binary path (Ruta binario Node.js) y SSH jumphost (Host de salto de SSH).

Para cambiar otros valores de configuración, haga lo siguiente.• Para entornos de EC2, haga lo siguiente.

• No puede cambiar Type (Tipo), Security groups (Grupos de seguridad), VPC, Subnet (Subred),Environment path (Ruta de entorno) ni Environment ARN (ARN del entorno).

• Para Permissions (Permisos) o Number of members (Número de miembros), consulte Cambiarel rol de acceso de un miembro del entorno (p. 96), Quitar a su usuario (p. 96), Invitar a unusuario de IAM (p. 91) y Quitar a otro miembro del entorno (p. 98).

• Para EC2 instance type (Tipo de instancia EC2), Memory (Memoria) o vCPU, consulte Mover ocambiar el tamaño de un entorno (p. 99).

• Para entornos de SSH, haga lo siguiente.• No puede cambiar Type (Tipo) ni Environment ARN (ARN del entorno).• Para Permissions (Permisos) o Number of members (Número de miembros), consulte Cambiar

el rol de acceso de un miembro del entorno (p. 96), Quitar a su usuario (p. 96), Invitar a unusuario de IAM (p. 91) y Quitar a otro miembro del entorno (p. 98).


• En la barra de navegación lateral, elija una o varias de las siguientes acciones.• Elija Your entornos (Sus entornos) para mostrar todos los entornos que son propiedad de su entidad

de AWS dentro de la cuenta de AWS y la región de AWS seleccionadas.• Elija Shared with you (Compartido con usted) para mostrar todos los entornos a los que se ha invitado

a su entidad de AWS dentro de la cuenta de AWS y la región de AWS seleccionadas.• Elija Account entornos (entornos de cuenta) para mostrar todos los entornos dentro de la cuenta


• Elija la flecha anterior, la flecha siguiente o el botón de número de página para mostrar más entornos enel ámbito actual.

86

AWS Cloud9 Guía del usuarioCambiar la configuración del entorno mediante código



Cambiar la configuración del entorno mediante códigoPara cambiar la configuración de un entorno mediante código, en AWS Cloud9, llame a la operación deAWS Cloud9 para actualizar la pertenencia a entorno, tal y como se indica a continuación.

AWS CLI update-environment

AWS SDK para C++ UpdateEnvironmentRequest,UpdateEnvironmentResult

AWS SDK for Go UpdateEnvironment, UpdateEnvironmentRequest,UpdateEnvironmentWithContext

AWS SDK for Java UpdateEnvironmentRequest,UpdateEnvironmentResult

AWS SDK for JavaScript updateEnvironment

AWS SDK para .NET UpdateEnvironmentRequest,UpdateEnvironmentResponse

AWS SDK para PHP updateEnvironment

AWS SDK for Python (Boto) update_environment

AWS SDK parar Ruby update_environment

Herramientas de AWS para Windows PowerShell Update-C9Environment

API de AWS Cloud9 UpdateEnvironment

87

https://docs.aws.amazon.com/cli/latest/reference/cloud9/update-environment.html

https://sdk.amazonaws.com/cpp/api/LATEST/class_aws_1_1_cloud9_1_1_model_1_1_update_environment_request.html

https://sdk.amazonaws.com/cpp/api/LATEST/class_aws_1_1_cloud9_1_1_model_1_1_update_environment_result.html

https://docs.aws.amazon.com/sdk-for-go/api/service/cloud9/#Cloud9.UpdateEnvironment

https://docs.aws.amazon.com/sdk-for-go/api/service/cloud9/#Cloud9.UpdateEnvironmentRequest

https://docs.aws.amazon.com/sdk-for-go/api/service/cloud9/#Cloud9.UpdateEnvironmentWithContext

https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/cloud9/model/UpdateEnvironmentRequest.html

https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/cloud9/model/UpdateEnvironmentResult.html

https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/Cloud9.html#updateEnvironment-property

https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/Cloud9/TUpdateEnvironmentRequest.html

https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/Cloud9/TUpdateEnvironmentResponse.html

https://docs.aws.amazon.com/aws-sdk-php/v3/api/api-cloud9-2017-09-23.html#updateenvironment

https://boto3.readthedocs.io/en/latest/reference/services/cloud9.html#Cloud9.Client.update_environment

https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/Cloud9/Client.html#update_environment-instance_method

https://docs.aws.amazon.com/powershell/latest/reference/items/Update-C9Environment.html

https://docs.aws.amazon.com/cloud9/latest/APIReference/API_UpdateEnvironment.html

AWS Cloud9 Guía del usuarioTrabajo con entornos compartidos

Trabajo con entornos compartidos en AWS Cloud9Un entorno compartido es un entorno de desarrollo de AWS Cloud9 al que se ha invitado a participar avarios usuarios. En este tema se ofrecen instrucciones para compartir un entorno en AWS Cloud9 y cómoparticipar en un entorno compartido.

Para invitar a un usuario a que participe en un entorno de su propiedad, siga uno de estos procedimientos,dependiendo del tipo de usuario al que desee invitar.

Tipo de usuario Siga estos procedimientos

Un usuario en la misma cuenta de AWS que elentorno.

Invitar a un usuario en la misma cuenta que elentorno (p. 91)

Un administrador de AWS Cloud9 en la mismacuenta de AWS que el entorno, específicamente:

• El usuario raíz de la cuenta de AWS.• Un usuario administrador de IAM.• Un usuario con la política administrada de AWSAWSCloud9Administrator adjunta.

Para invitar al administrador de AWS Cloud9,consulte Invitar a un usuario en la misma cuentaque el entorno (p. 91).

Para que el administrador de AWS Cloud9 se invitea sí mismo (o a otros usuarios de la misma cuentade AWS), consulte Hacer que un administrador deAWS Cloud9 en la misma cuenta que el entorno seinvite a sí mismo o a otros usuarios (p. 92).

Contenido• Escenarios de uso de entornos compartidos (p. 88)• Acerca de los roles de acceso de los miembros del entorno (p. 89)• Invitar a un usuario en la misma cuenta que el entorno (p. 91)• Hacer que un administrador de AWS Cloud9 en la misma cuenta que la del entorno se invite a sí mismo

o a otros usuarios (p. 92)• Abrir un entorno compartido (p. 93)• Ver una lista de miembros del entorno (p. 94)• Abrir el archivo activo de un miembro del entorno (p. 95)• Abrir el menú Abrir archivo de un miembro del entorno (p. 95)• Ir al cursor activo de un miembro del entorno (p. 95)• Conversar con otros miembros del entorno (p. 95)• Ver mensajes de chat en un entorno compartido (p. 96)• Eliminar un mensaje de chat de un entorno compartido (p. 96)• Eliminar todos los mensaje de chat de un entorno compartido (p. 96)• Cambiar el rol de acceso de un miembro del entorno (p. 96)• Quitar un usuario de un entorno compartido (p. 97)• Quitar otro miembro del entorno (p. 98)• Prácticas recomendadas para compartir entornos (p. 99)

Escenarios de uso de entorno compartidoUn entorno compartido es bueno para lo siguiente.

88

AWS Cloud9 Guía del usuarioAcerca de los roles de acceso de miembro del entorno

• Programación en parejas (también conocido como programación de homólogos). Es cuando dosusuarios trabajan juntos en el mismo código en un único entorno. En la programación en parejas,normalmente un usuario escribe código de programación mientras que el otro observa el código quese escribe. El observador ofrece información y comentarios inmediatos al escritor del código. Estasposiciones cambian frecuentemente durante un proyecto. Sin un entorno compartido, los equipos deprogramación en parejas se sientan frente a una sola máquina y únicamente uno de ellos puede escribircódigo. Con un entorno compartido, ambos usuarios se sientan ante la máquina y escriben código almismo tiempo, incluso si se encuentran en oficinas físicas diferentes.

• Clases de informática. Resulta útil cuando los profesores o los ayudantes de enseñanza quieren obteneracceso al entorno de un alumno para corregir deberes o resolver problemas con los entorno en tiemporeal. Los alumnos pueden trabajar con sus compañeros en deberes de proyectos compartidos, escribircódigo juntos en un único entorno en tiempo real. Pueden hacerlo a pesar de estar en diferentesubicaciones con sistemas operativos y tipos de navegador web diferentes.

• Cualquier otra situación en la que varios usuarios necesiten colaborar en el mismo código en tiemporeal.

Acerca de los roles de acceso de miembro del entornoAntes de compartir un entorno o de participar en un entorno compartido en AWS Cloud9, es precisocomprender los niveles de los permisos de acceso a un entorno compartido. Estos niveles de permisos sedenominan roles de acceso de los miembros del entorno.

Un entorno compartido en AWS Cloud9 ofrece tres roles de acceso miembro del entorno: propietario,lectura/escritura y solo lectura.

• Un propietario tiene control total sobre un entorno. Cada entorno tiene un único propietario, que es elcreador del entorno. Un propietario puede hacer lo siguiente.• Añadir, modificar y eliminar miembros del entorno• Abrir, ver y modificar archivos• Ejecutar código• Cambiar la configuración del entorno.• Conversar con otros miembros• Eliminar mensajes de chat

En el AWS Cloud9 IDE, un propietario de entorno se muestra con acceso de lectura y escritura.• Un miembro lectura/escritura puede hacer lo siguiente.

• Abrir, ver y modificar archivos• Ejecutar código• Cambiar varios valores de configuración del entorno dentro del AWS Cloud9 IDE• Conversar con otros miembros• Eliminar mensajes de chat

En el AWS Cloud9 IDE, los miembros lectura/escritura se muestran con acceso de lectura y escritura.• Un miembro solo lectura puede hacer lo siguiente.

• Abrir y ver archivos• Conversar con otros miembros• Eliminar mensajes de chat

En el AWS Cloud9 IDE, los miembros solo lectura se muestran con acceso de Solo lectura.

89

AWS Cloud9 Guía del usuarioAcerca de los roles de acceso de miembro del entorno

Para que un usuario pueda convertirse en propietario o miembro de entorno, debe cumplir alguno de lossiguientes criterios.

• Es un usuario raíz de la cuenta de AWS.• Es un usuario administrador de IAM. Para obtener más información, consulte Creación del primer grupo

y usuario administrador de IAM en la Guía del usuario de IAM.• Es un usuario que pertenece a un grupo de IAM, un usuario que asume un rol o un usuario federado que

asume un rol, y ese grupo o rol tiene la política administrada por AWS AWSCloud9Administrator oAWSCloud9User (o AWSCloud9EnvironmentMember, para ser un miembro solamente) adjunta. Paraobtener más información, consulte Políticas administradas (predefinidas) de AWS (p. 525).• Para adjuntar una de las políticas administradas anteriores a un grupo de IAM, puede utilizar la

consola de administración de AWS (p. 90) o la interfaz de la línea de comandos de AWS (AWSCLI) (p. 90) como se describe en los siguientes procedimientos.

• Para crear un rol en IAM con una de las políticas administradas anteriores para que la asuma unusuario o un usuario federado, consulte Creación de roles en la Guía del usuario de IAM. Para hacerque un usuario o un usuario federado asuma el rol, consulte la cobertura de la asunción de roles enUso de los roles de IAM en la Guía del usuario de IAM.

Adjuntar una política administrada de AWS para AWS Cloud9 aun grupo mediante la consola1. Si todavía no ha iniciado sesión en la consola de administración de AWS, hágalo.



3. Seleccione Groups (Grupos).4. Elija el nombre del grupo.5. En la pestaña Permissions (Permisos), en Managed Policies (Políticas administradas), seleccione Attach

Policy (Adjuntar política).6. En la lista con los nombres de las políticas, seleccione una de las siguientes casillas.

• AWSCloud9User (preferida) o AWSCloud9Administrator para habilitar a cada usuario del grupo comoun propietario del entorno

• AWSCloud9EnvironmentMember para habilitar a cada usuario del grupo como miembro únicamente

(Si no ve uno de estos nombres de política en la lista, escríbalo en el cuadro Search (Búsqueda) paramostrarlo).

7. Elija Attach policy.

Asociar una política administrada de AWS para AWS Cloud9 a ungrupo mediante la AWS CLI

Note


90



https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create.html

https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_use.html

AWS Cloud9 Guía del usuarioInvitar a un usuario en la misma cuenta que el entorno

Ejecute el comando attach-group-policy de IAM para adjuntar la política administrada de AWS paraAWS Cloud9 al grupo, especificando el nombre del grupo y después el nombre de recurso de Amazon(ARN) de la política, por ejemplo:

aws iam attach-group-policy --group-name MyGroup --policy-arn arn:aws:iam::aws:policy/POLICY_NAME

En el comando anterior, reemplace MyGroup por el nombre del grupo. Reemplace POLICY_NAME por elnombre de una de las siguientes políticas administradas de AWS.

• AWSCloud9User (preferida) o AWSCloud9Administrator para habilitar a cada usuario del grupocomo un propietario del entorno

• AWSCloud9EnvironmentMember para habilitar a cada usuario del grupo como miembro únicamente

Invitar a un usuario en la misma cuenta que el entornoSiga las instrucciones de esta sección para compartir un entorno de desarrollo de AWS Cloud9 que poseaen la cuenta de AWS con un usuario que está en la misma cuenta.

1. Si el usuario al que desea invitar no es uno de los siguientes tipos de usuarios, asegúrese de que yatenga el rol de acceso de miembro de entorno correspondiente. Para obtener instrucciones, consulteAcerca de los roles de acceso de los miembros del entorno (p. 89).• El usuario raíz de la cuenta de AWS.• Un usuario administrador de IAM.• Un usuario que pertenece a un grupo de IAM, un usuario que asume un rol o un usuario federado que

asume un rol, y ese grupo o rol tiene la política administrada por AWS AWSCloud9Administratoradjunta.

2. Abra el entorno de su propiedad al que desea invitar al usuario, si el entorno aún no está abierto.3. En la barra de menús del AWS Cloud9 IDE, realice una de las siguientes operaciones.

• Elija Window, Share (Ventana, Compartir).• Elija Share (Compartir), situado junto al icono de engranaje Preferences (Preferencias).

4. En el cuadro de diálogo Share this environment (Compartir este entorno), en Invite Members (Invitar amiembros), escriba uno de los siguientes datos• Para invitar a un usuario de IAM, escriba el nombre del usuario.• Para invitar al usuario raíz de la cuenta de AWS, escriba arn:aws:iam::123456789012:root,

reemplazando 123456789012 por su ID de cuenta de AWS.• Para invitar a un usuario con un rol asumido o a un usuario federado con un rol asumido, escribaarn:aws:sts::123456789012:assumed-role/MyAssumedRole/MyAssumedRoleSession,

91

AWS Cloud9 Guía del usuarioHacer que un administrador de AWS Cloud9

en la misma cuenta que la del entornose invite a sí mismo o a otros usuarios

reemplazando 123456789012 por su ID de cuenta de AWS, MyAssumedRole por el nombre del rolasumido y MyAssumedRoleSession por el nombre de la sesión del rol asumido.

5. Para que este usuario sea un miembro solo lectura, elija R. Para que este usuario sea lectura/escritura,elija RW.

6. Elija Invite.

Note

Si hace que este usuario sea miembro de lectura/escritura, se muestra un cuadro de diálogocon información sobre la posibilidad de que se pongan en peligro las credenciales de seguridadde AWS. La información siguiente proporciona más datos sobre este problema.Comparta un entorno solo con personas de confianza.Un miembro de lectura/escritura podría utilizar el código de la AWS CLI, el shell de AWS oel SDK de AWS en el entorno para emprender acciones de AWS en su nombre. Además, sialmacena las credenciales permanentes de acceso de AWS dentro del entorno, dicho miembropodría copiarlas y utilizarlas fuera del entorno.Para solucionar este problema no basta con eliminar las credenciales permanentes de accesode AWS del entorno y usar credenciales temporales de AWS en lugar. Disminuye la posibilidadde que el miembro copie esas credenciales temporales y las use fuera del entorno (puestoque esas credenciales temporales funcionarán durante un tiempo limitado). Sin embargo, lascredenciales temporales siguen habilitando a un miembro de lectura/escritura para emprenderacciones en AWS desde el entorno en su nombre.

7. Póngase en contacto con el usuario para informarle de que puede abrir este entorno y comenzar autilizarlo.

Hacer que un administrador de AWS Cloud9 en lamisma cuenta que la del entorno se invite a sí mismoo a otros usuarios

Note


Los siguientes tipos de usuarios pueden invitarse a sí mismos (o a otros usuarios de la misma cuenta deAWS) a cualquier entorno en la misma cuenta.

• El usuario raíz de la cuenta de AWS.• Un usuario administrador de IAM.• Un usuario que pertenece a un grupo de IAM, un usuario que asume un rol o un usuario federado que

asume un rol, y ese grupo o rol tiene la política administrada por AWS AWSCloud9Administratoradjunta.

Si el usuario invitado no es uno de los tipos de usuarios anteriores, asegúrese de que ya tenga el rol deacceso de miembro de entorno correspondiente. Para obtener instrucciones, consulte Acerca de los rolesde acceso de los miembros del entorno (p. 89).

Para invitar al usuario, use la AWS CLI o el shell de AWS para ejecutar el comando create-environment-membership de AWS Cloud9, tal como se indica a continuación.

92

AWS Cloud9 Guía del usuarioAbrir un entorno compartido

aws cloud9 create-environment-membership --environment-id 12a34567b8cd9012345ef67abcd890e1 --user-arn USER_ARN --permissions PERMISSION_LEVEL

En el comando anterior, reemplace 12a34567b8cd9012345ef67abcd890e1 por el ID del entorno yPERMISSION_LEVEL por read-write o read-only. Reemplace USER_ARN por uno de los siguientes:

• Para invitar a un usuario de IAM, escriba arn:aws:iam::123456789012:user/MyUser,reemplazando 123456789012 por su ID de cuenta de AWS y MyUser por el nombre del usuario.

• Para invitar al usuario raíz de la cuenta de AWS, escriba arn:aws:iam::123456789012:root,reemplazando 123456789012 por su ID de cuenta de AWS.

• Para invitar a un usuario con un rol asumido o a un usuario federado con un rol asumido, escribaarn:aws:sts::123456789012:assumed-role/MyAssumedRole/MyAssumedRoleSession,reemplazando 123456789012 por su ID de cuenta de AWS, MyAssumedRole por el nombre del rolasumido y MyAssumedRoleSession por el nombre de la sesión del rol asumido.

Por ejemplo, para invitar al usuario raíz de la cuenta de AWS para el ID de cuenta 123456789012 a unentorno con ID 12a34567b8cd9012345ef67abcd890e1 como miembro lectura/escritura, ejecute elsiguiente comando.

aws cloud9 create-environment-membership --environment-id 12a34567b8cd9012345ef67abcd890e1 --user-arn arn:aws:iam::123456789012:root --permissions read-write

Note

Si utiliza el shell de AWS, omita el prefijo aws de los comandos anteriores.

Abrir un entorno compartidoPara abrir un entorno compartido, utilice el panel de AWS Cloud9. A continuación, utilice el AWS Cloud9IDE para hacer cosas en un entorno compartido, por ejemplo, trabajar con archivos y conversar con otrosmiembros.

1. Asegúrese de que la política de acceso correspondiente se adjunta al grupo o el rol de su usuario.Para obtener más información, consulte Acerca de los roles de acceso de los miembros delentorno (p. 89).



administrador de la cuenta de AWS.• Si es un estudiante en un aula, pide a su instructor las instrucciones de inicio de sesión.

3. Abra el entorno compartido desde el panel de AWS Cloud9. Para obtener más información, consulteApertura de un entorno en AWS Cloud9 (p. 74).

Puede utilizar la ventana Collaborate (Colaborar) para interactuar con otros miembros, tal y como sedescribe en el resto de este tema.

Note

Si la ventana Collaborate (Colaborar) no está visible, elija el botón Collaborate (Colaborar). Si elbotón Collaborate (Colaborar) no está visible, elija Window, Collaborate (Ventana, Colaborar) enla barra de menús.

93


AWS Cloud9 Guía del usuarioVer una lista de miembros del entorno

Ver una lista de miembros del entornoCon el entorno compartido abierto, en la ventana Collaborate (Colaborar), expanda Environment Members(Miembros del entorno), si la lista de miembros no está visible.

Un círculo junto a cada miembro indica su estado online, tal y como se indica a continuación.

• Los miembros activos tienen un círculo verde.• Los miembros sin conexión tienen un círculo gris.• Los miembros inactivos tienen un círculo naranja.

Para utilizar código para obtener una lista de miembros del entorno, llame a la operación de AWS Cloud9para describir suscripciones de entorno, tal y como se indica a continuación.

AWS CLI describe-environment-memberships

AWS SDK para C++ DescribeEnvironmentMembershipsRequest,DescribeEnvironmentMembershipsResult

AWS SDK for Go DescribeEnvironmentMemberships,DescribeEnvironmentMembershipsRequest,DescribeEnvironmentMembershipsWithContext

AWS SDK for Java DescribeEnvironmentMembershipsRequest,DescribeEnvironmentMembershipsResult

AWS SDK for JavaScript describeEnvironmentMemberships

AWS SDK para .NET DescribeEnvironmentMembershipsRequest,DescribeEnvironmentMembershipsResponse

AWS SDK para PHP describeEnvironmentMemberships

94

https://docs.aws.amazon.com/cli/latest/reference/cloud9/describe-environment-memberships.html

https://sdk.amazonaws.com/cpp/api/LATEST/class_aws_1_1_cloud9_1_1_model_1_1_describe_environment_memberships_request.html

https://sdk.amazonaws.com/cpp/api/LATEST/class_aws_1_1_cloud9_1_1_model_1_1_describe_environment_memberships_result.html

https://docs.aws.amazon.com/sdk-for-go/api/service/cloud9/#Cloud9.DescribeEnvironmentMemberships

https://docs.aws.amazon.com/sdk-for-go/api/service/cloud9/#Cloud9.DescribeEnvironmentMembershipsRequest

https://docs.aws.amazon.com/sdk-for-go/api/service/cloud9/#Cloud9.DescribeEnvironmentMembershipsWithContext

https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/cloud9/model/DescribeEnvironmentMembershipsRequest.html

https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/cloud9/model/DescribeEnvironmentMembershipsResult.html

https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/Cloud9.html#describeEnvironmentMemberships-property

https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/Cloud9/TDescribeEnvironmentMembershipsRequest.html

https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/Cloud9/TDescribeEnvironmentMembershipsResponse.html

https://docs.aws.amazon.com/aws-sdk-php/v3/api/api-cloud9-2017-09-23.html#describeenvironmentmemberships

AWS Cloud9 Guía del usuarioAbrir el archivo activo de un miembro del entorno

AWS SDK for Python (Boto) describe_environment_memberships

AWS SDK parar Ruby describe_environment_memberships

Herramientas de AWS para Windows PowerShell Get-C9EnvironmentMembershipList

API de AWS Cloud9 DescribeEnvironmentMemberships

Abrir el archivo activo de un miembro del entornoCon el entorno compartido abierto, en la barra de menús, elija el nombre del miembro. A continuación, elijaOpen Active File (Abrir archivo activo).

Abrir el comando Abrir archivo de un miembro delentorno1. Con el entorno compartido abierto, en la ventana Collaborate (Colaborar), expanda Environment

Members (Miembros del entorno), si la lista de miembros no está visible.2. Expanda el nombre del usuario cuyo abrir archivo desea abrir en el entorno.3. Haga doble clic en el nombre del archivo que desea abrir.

Vaya al Cursor activo de un miembro del entorno1. Con el entorno compartido abierto, en la ventana Collaborate (Colaborar), expanda Environment

Members (Miembros del entorno), si la lista de miembros no está visible.2. Haga clic con el botón derecho en el nombre del miembro y, a continuación, elija Show Location

(Mostrar ubicación).

Conversar con otros miembros del entornoCon el entorno compartido abierto, en la parte inferior de la ventana Collaborate (Colaborar), en Enter yourmessage here (Escriba su mensaje aquí), escriba el mensaje y, a continuación, presione Enter.

95

https://boto3.readthedocs.io/en/latest/reference/services/cloud9.html#Cloud9.Client.describe_environment_memberships

https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/Cloud9/Client.html#describe_environment_memberships-instance_method

https://docs.aws.amazon.com/powershell/latest/reference/items/Get-C9EnvironmentMembershipList.html

https://docs.aws.amazon.com/cloud9/latest/APIReference/API_DescribeEnvironmentMemberships.html

AWS Cloud9 Guía del usuarioVer mensajes de chat en un entorno compartido

Ver mensajes de chat en un entorno compartidoCon el entorno compartido abierto, en la ventana Collaborate (Colaborar), expanda Group Chat (Chat degrupo), si la lista de los mensajes de chat no está visible.

Eliminar un mensaje de chat de un entorno compartidoCon el entorno compartido abierto, en la ventana Collaborate (Colaborar), haga clic con el botón derechoen Group Chat (Chat de grupo) y, después, elija Delete Message (Eliminar mensaje).

Note

Cuando elimina un mensaje de chat, se elimina del entorno para todos los miembros.

Eliminar todos los mensaje de chat de un entornocompartidoCon el entorno compartido abierto, en la ventana Collaborate (Colaborar), haga clic con el botón derechoen cualquier parte de Group Chat (Chat de grupo) y después elija Clear history (Limpiar historial).

Note

Cuando elimina todos los mensajes de chat, se eliminan del entorno para todos los miembros.

Cambiar el rol de acceso de un miembro del entorno1. Abra el entorno de su propiedad que contiene el miembro cuyo rol de acceso desea cambiar, si el

entorno aún no está abierto. Para obtener más información, consulte Apertura de un entorno en AWSCloud9 (p. 74).

2. En la ventana Collaborate (Colaborar), expanda Environment Members (Miembros del entorno), si lalista de miembros no está visible.

3. Aplique alguna de las siguientes acciones:• Junto al nombre de miembro cuyo rol de acceso desea cambiar, seleccione R o RW para crear este

miembro propietario o lectura/escritura, respectivamente.• Para cambiar un miembro lectura/escritura por solo lectura, haga clic con el botón derecho en el

nombre del miembro y, a continuación, elija Revoke Write Access (Revocar acceso de escritura).

96

AWS Cloud9 Guía del usuarioEliminar su usuario de un entorno compartido

• Para cambiar un miembro solo lectura por lectura/escritura, haga clic con el botón derecho en elnombre del miembro y, a continuación, elija Grant Read+Write Access (Conceder acceso de lectura +escritura).

Note

Si hace que este usuario sea miembro de lectura/escritura, se muestra un cuadro dediálogo con información sobre la posibilidad de que se pongan en peligro las credencialesde seguridad de AWS. No convierta un usuario en un miembro lectura/escritura a menosque confíe en él para emprender acciones en AWS en su nombre. Para obtener másinformación, consulte la nota relacionada en Invitar a un usuario en la misma cuenta que elentorno (p. 91).

Para utilizar el código para cambiar el rol de acceso de un miembro del entorno, llame a la operación deAWS Cloud9 para actualizar la pertenencia a entorno, tal y como se indica a continuación.

AWS CLI update-environment-membership

AWS SDK para C++ UpdateEnvironmentMembershipRequest,UpdateEnvironmentMembershipResult

AWS SDK for Go UpdateEnvironmentMembership,UpdateEnvironmentMembershipRequest,UpdateEnvironmentMembershipWithContext

AWS SDK for Java UpdateEnvironmentMembershipRequest,UpdateEnvironmentMembershipResult

AWS SDK for JavaScript updateEnvironmentMembership

AWS SDK para .NET UpdateEnvironmentMembershipRequest,UpdateEnvironmentMembershipResponse

AWS SDK para PHP updateEnvironmentMembership

AWS SDK for Python (Boto) update_environment_membership

AWS SDK parar Ruby update_environment_membership

Herramientas de AWS para Windows PowerShell Update-C9EnvironmentMembership

API de AWS Cloud9 UpdateEnvironmentMembership

Eliminar su usuario de un entorno compartidoNote

No puede quitar su usuario de un entorno si usted es el propietario del entorno.La eliminación de su usuario de un entorno no lo elimina de IAM.

1. Con el entorno compartido abierto, en la ventana Collaborate (Colaborar), expanda EnvironmentMembers (Miembros del entorno), si la lista de miembros no está visible.

2. Aplique alguna de las siguientes acciones.• Junto a You (Usted), seleccione el icono de papelera.• Haga clic con el botón derecho en You (Usted) y, a continuación, elija Leave environment (Abandonar

entorno).3. Cuando se le solicite, elija Leave (Abandonar).

97

https://docs.aws.amazon.com/cli/latest/reference/cloud9/update-environment-membership.html

https://sdk.amazonaws.com/cpp/api/LATEST/class_aws_1_1_cloud9_1_1_model_1_1_update_environment_membership_request.html

https://sdk.amazonaws.com/cpp/api/LATEST/class_aws_1_1_cloud9_1_1_model_1_1_update_environment_membership_result.html

https://docs.aws.amazon.com/sdk-for-go/api/service/cloud9/#Cloud9.UpdateEnvironmentMembership

https://docs.aws.amazon.com/sdk-for-go/api/service/cloud9/#Cloud9.UpdateEnvironmentMembershipRequest

https://docs.aws.amazon.com/sdk-for-go/api/service/cloud9/#Cloud9.UpdateEnvironmentMembershipWithContext

https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/cloud9/model/UpdateEnvironmentMembershipRequest.html

https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/cloud9/model/UpdateEnvironmentMembershipResult.html

https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/Cloud9.html#updateEnvironmentMembership-property

https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/Cloud9/TUpdateEnvironmentMembershipRequest.html

https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/Cloud9/TUpdateEnvironmentMembershipResponse.html

https://docs.aws.amazon.com/aws-sdk-php/v3/api/api-cloud9-2017-09-23.html#updateenvironmentmembership

https://boto3.readthedocs.io/en/latest/reference/services/cloud9.html#Cloud9.Client.update_environment_membership

https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/Cloud9/Client.html#update_environment_membership-instance_method

https://docs.aws.amazon.com/powershell/latest/reference/items/Update-C9EnvironmentMembership.html

https://docs.aws.amazon.com/cloud9/latest/APIReference/API_UpdateEnvironmentMembership.html

AWS Cloud9 Guía del usuarioEliminar otro miembro del entorno

Para utilizar código para eliminar el usuario de un entorno compartido, llame a la operación de AWSCloud9 eliminar pertenencia a entorno, tal y como se indica a continuación.

AWS CLI delete-environment-membership

AWS SDK para C++ DeleteEnvironmentMembershipRequest,DeleteEnvironmentMembershipResult

AWS SDK for Go DeleteEnvironmentMembership,DeleteEnvironmentMembershipRequest,DeleteEnvironmentMembershipWithContext

AWS SDK for Java DeleteEnvironmentMembershipRequest,DeleteEnvironmentMembershipResult

AWS SDK for JavaScript deleteEnvironmentMembership

AWS SDK para .NET DeleteEnvironmentMembershipRequest,DeleteEnvironmentMembershipResponse

AWS SDK para PHP deleteEnvironmentMembership

AWS SDK for Python (Boto) delete_environment_membership

AWS SDK parar Ruby delete_environment_membership

Herramientas de AWS para Windows PowerShell Remove-C9EnvironmentMembership

API de AWS Cloud9 DeleteEnvironmentMembership

Eliminar otro miembro del entornoNote

Para eliminar un miembro que no sea su usuario de un entorno, debe haber iniciado sesión enAWS Cloud9 con las credenciales del propietario del entorno.La eliminación de un miembro no elimina el usuario de IAM.

1. Abra el entorno que contiene el miembro que desea eliminar, si el entorno aún no está abierto. Paraobtener más información, consulte Apertura de un entorno en AWS Cloud9 (p. 74).

2. En la ventana Collaborate (Colaborar), expanda Environment Members (Miembros del entorno), si lalista de miembros no está visible.

3. Aplique alguna de las siguientes acciones.• Junto al nombre del miembro que desea eliminar, seleccione el icono de la papelera.• Haga clic con el botón derecho en el nombre del miembro que desea eliminar y, a continuación, elija

Revoke Access (Revocar acceso).4. Cuando se le solicite, elija Remove Member (Quitar miembro).

Para utilizar código para quitar un miembro de un entorno, llame a la operación de AWS Cloud9 eliminarpertenencia a entorno, tal y como se indica a continuación.

AWS CLI delete-environment-membership

AWS SDK para C++ DeleteEnvironmentMembershipRequest,DeleteEnvironmentMembershipResult

98

https://docs.aws.amazon.com/cli/latest/reference/cloud9/delete-environment-membership.html

https://sdk.amazonaws.com/cpp/api/LATEST/class_aws_1_1_cloud9_1_1_model_1_1_delete_environment_membership_request.html

https://sdk.amazonaws.com/cpp/api/LATEST/class_aws_1_1_cloud9_1_1_model_1_1_delete_environment_membership_result.html

https://docs.aws.amazon.com/sdk-for-go/api/service/cloud9/#Cloud9.DeleteEnvironmentMembership

https://docs.aws.amazon.com/sdk-for-go/api/service/cloud9/#Cloud9.DeleteEnvironmentMembershipRequest

https://docs.aws.amazon.com/sdk-for-go/api/service/cloud9/#Cloud9.DeleteEnvironmentMembershipWithContext

https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/cloud9/model/DeleteEnvironmentMembershipRequest.html

https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/cloud9/model/DeleteEnvironmentMembershipResult.html

https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/Cloud9.html#deleteEnvironmentMembership-property

https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/Cloud9/TDeleteEnvironmentMembershipRequest.html

https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/Cloud9/TDeleteEnvironmentMembershipResponse.html

https://docs.aws.amazon.com/aws-sdk-php/v3/api/api-cloud9-2017-09-23.html#deleteenvironmentmembership

https://boto3.readthedocs.io/en/latest/reference/services/cloud9.html#Cloud9.Client.delete_environment_membership

https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/Cloud9/Client.html#delete_environment_membership-instance_method

https://docs.aws.amazon.com/powershell/latest/reference/items/Remove-C9EnvironmentMembership.html

https://docs.aws.amazon.com/cloud9/latest/APIReference/API_DeleteEnvironmentMembership.html

https://docs.aws.amazon.com/cli/latest/reference/cloud9/delete-environment-membership.html

https://sdk.amazonaws.com/cpp/api/LATEST/class_aws_1_1_cloud9_1_1_model_1_1_delete_environment_membership_request.html

https://sdk.amazonaws.com/cpp/api/LATEST/class_aws_1_1_cloud9_1_1_model_1_1_delete_environment_membership_result.html

AWS Cloud9 Guía del usuarioPrácticas recomendadas para compartir entorno

AWS SDK for Go DeleteEnvironmentMembership,DeleteEnvironmentMembershipRequest,DeleteEnvironmentMembershipWithContext

AWS SDK for Java DeleteEnvironmentMembershipRequest,DeleteEnvironmentMembershipResult

AWS SDK for JavaScript deleteEnvironmentMembership

AWS SDK para .NET DeleteEnvironmentMembershipRequest,DeleteEnvironmentMembershipResponse

AWS SDK para PHP deleteEnvironmentMembership

AWS SDK for Python (Boto) delete_environment_membership

AWS SDK parar Ruby delete_environment_membership

Herramientas de AWS para Windows PowerShell Remove-C9EnvironmentMembership

API de AWS Cloud9 DeleteEnvironmentMembership

Prácticas recomendadas para compartir entornoLe recomendamos las siguientes prácticas al compartir entornos.

• Invite únicamente a los miembros con acceso de lectura/escritura en los que confíe a su entornos.• Con los miembros de lectura/escritura de entornos de EC2, puede utilizar las credenciales de acceso

a AWS del propietario del entorno, en lugar de sus propias credenciales, para hacer llamadas desdeel entorno a los servicios de AWS. Para evitar esto, el propietario del entorno pueden deshabilitar lascredenciales temporales administradas de AWS del entorno. Sin embargo, esto también impide que elpropietario del entorno haga llamadas. Para obtener más información, consulte Credenciales temporalesadministradas de AWS (p. 537).

• Active AWS CloudTrail para hacer un seguimiento de la actividad de su entornos. Para obtener másinformación, consulte la AWS CloudTrail User Guide.

• No utilice el usuario raíz de su cuenta de AWS para crear y compartir entornos. Utilice los usuarios deIAM de su cuenta en su lugar. Para obtener más información, consulte Solo para el primer acceso: suscredenciales de usuario raíz y Usuarios de IAM en la Guía del usuario de IAM.

Mover o cambiar el tamaño de un entorno en AWSCloud9

Puede mover un entorno de desarrollo de AWS Cloud9 de una instancia Amazon EC2 a otra. Por ejemplo,le conviene seguir uno de estos pasos.

• Transferir un entorno de una instancia Amazon EC2 dañada, o que se comporta de forma inesperada, auna instancia en buen estado.

• Transferir un entorno de una instancia más antigua a una instancia que tiene las últimas actualizacionesdel sistema.

• Aumente los recursos de computación de una instancia, ya que el entorno está sobreutilizado en lainstancia actual.

• Reduzca los recursos de computación de una instancia, ya que el entorno está infrautilizado en lainstancia actual.

99

https://docs.aws.amazon.com/sdk-for-go/api/service/cloud9/#Cloud9.DeleteEnvironmentMembership

https://docs.aws.amazon.com/sdk-for-go/api/service/cloud9/#Cloud9.DeleteEnvironmentMembershipRequest

https://docs.aws.amazon.com/sdk-for-go/api/service/cloud9/#Cloud9.DeleteEnvironmentMembershipWithContext

https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/cloud9/model/DeleteEnvironmentMembershipRequest.html

https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/cloud9/model/DeleteEnvironmentMembershipResult.html

https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/Cloud9.html#deleteEnvironmentMembership-property

https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/Cloud9/TDeleteEnvironmentMembershipRequest.html

https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/Cloud9/TDeleteEnvironmentMembershipResponse.html

https://docs.aws.amazon.com/aws-sdk-php/v3/api/api-cloud9-2017-09-23.html#deleteenvironmentmembership

https://boto3.readthedocs.io/en/latest/reference/services/cloud9.html#Cloud9.Client.delete_environment_membership

https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/Cloud9/Client.html#delete_environment_membership-instance_method

https://docs.aws.amazon.com/powershell/latest/reference/items/Remove-C9EnvironmentMembership.html

https://docs.aws.amazon.com/cloud9/latest/APIReference/API_DeleteEnvironmentMembership.html

https://docs.aws.amazon.com/awscloudtrail/latest/userguide/

https://docs.aws.amazon.com/IAM/latest/UserGuide/introduction_identity-management.html#intro-identity-first-time-access

https://docs.aws.amazon.com/IAM/latest/UserGuide/introduction_identity-management.html#intro-identity-first-time-access

https://docs.aws.amazon.com/IAM/latest/UserGuide/introduction_identity-management.html#intro-identity-users

AWS Cloud9 Guía del usuarioMovimiento de un entorno

También puede cambiar el tamaño del volumen de Amazon Elastic Block Store (Amazon EBS) asociadocon una instancia Amazon EC2 para un entorno. Por ejemplo, le conviene seguir uno de estos pasos.

• Aumente el tamaño de un volumen porque se queda sin espacio de almacenamiento en la instancia.• Reduzca el tamaño de un volumen porque no desea pagar por espacio de almacenamiento adicional

que no esté utilizando.

Antes de mover o cambiar el tamaño de un entorno, puede que desee intentar detener algunos procesosen ejecución en el entorno o añadir un archivo de intercambio al entorno. Para obtener más información,consulte Advertencia del IDE: "Este entorno se está quedando sin memoria" o "Este entorno tiene unaelevada carga de CPU" (p. 566) en Solución de problemas.

En este tema solo se cubre el desplazamiento de un entorno de una instancia Amazon EC2 a otra o elcambio de tamaño de un volumen de Amazon EBS. Para cambiar el tamaño de un entorno de uno desus servidores a otro o para cambiar el espacio de almacenamiento de uno de sus servidores, consulte ladocumentación del servidor.

Temas• Movimiento de un entorno (p. 100)• Redimensionamiento de un entorno (p. 101)

Movimiento de un entornoAntes de comenzar el proceso de desplazamiento, tenga en cuenta lo siguiente.

• No se puede mover un entorno a una instancia Amazon EC2 del mismo tipo. Al mover, debe elegir untipo de instancia Amazon EC2 diferente para la nueva instancia.

• Debe detener la instancia Amazon EC2 que está asociada con un entorno para poder cambiar el tipo deinstancia. Mientras la instancia esté detenida, ni usted ni ninguno de los miembros podrá usar el entornoque está asociado con la instancia detenida.

• La instancia se mueve a un nuevo hardware, pero el ID de la instancia no cambia.• Si la instancia se está ejecutando en una Amazon VPC y tiene una dirección IPv4 pública, liberamos la

dirección y le asignamos una nueva dirección IPv4 pública. La instancia conserva sus direcciones IPv4privadas, las direcciones IP elásticas y las direcciones IPv6.

• Asegúrese de tener previsto un tiempo de inactividad mientras la instancia está detenida. El procesopodría tardar varios minutos.

Para mover un entorno haga lo siguiente.

1. (Opcional) Si el nuevo tipo de instancia requiere controladores que no están instalados en la instanciaexistente, debe conectarse a la instancia e instalar primero los controladores. Para obtener másinformación, consulte Compatibilidad con el redimensionamiento de instancias en la Guía del usuariode Amazon EC2 para instancias de Linux.

2. Cierre todas las pestañas del navegador web que muestren el entorno.Important

Si no cierra todas las pestañas del explorador web que muestran actualmente el entorno,AWS Cloud9 podría interferir en finalizar completamente el procedimiento. Específicamente,AWS Cloud9 podría intentar en un momento no adecuado durante este procedimientoreiniciar la instancia Amazon EC2 que está asociada con el entorno. La instancia debepermanecer detenida hasta el último paso de este procedimiento.

3. Inicie sesión en la Consola de administración de AWS, si todavía no lo ha hecho, en https://console.aws.amazon.com.

100

https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-resize.html#resize-limitations



AWS Cloud9 Guía del usuarioRedimensionamiento de un entorno

Le recomendamos que inicie sesión con las credenciales de un usuario administrador de IAM en sucuenta de AWS. Si no puede hacerlo, consulte con el administrador de su cuenta de AWS.

4. Abra la consola de Amazon EC2. Para ello, en la lista Services (Servicios), seleccione EC2.5. En la barra de navegación de AWS, elija la región de AWS que contiene el entorno que desea mover

(por ejemplo, EE.UU. Este (Ohio)).6. En el panel de navegación del servicio, expanda Instances (Instancias) si aún no está ampliado y elija

Instances (Instancias).7. En la lista de instancias, elija la que está asociada con el entorno que desea mover. Para un entorno

de EC2, el nombre de instancia comienza por aws-cloud9- seguido del nombre de entorno. Porejemplo, si el entorno se llama my-demo-entorno, el nombre de la instancia comenzará por aws-cloud9-my-demo-entorno.

8. Si el valor de Instance State (Estado de Instancia) no es stopped (detenido), elija Actions, InstanceState, Stop (Acciones, Estado de instancia, Detener). Cuando se le pregunte, elija Yes, Stop (Sí,Detener). Puede que transcurran unos minutos hasta que la instancia se detenga.

9. Después de que el valor de Instance State (Estado de instancia) sea stopped (detenido), con lainstancia aún seleccionada, elija Actions, Instance Settings, Change Instance Type (Acciones,Configuración de instancia, Cambiar tipo de instancia).

10. En el cuadro de diálogo Change Instance Type (Cambiar tipo de instancia), en Instance Type (Tipo deinstancia), seleccione el nuevo tipo de instancia que desea que utilice el entorno.

Note

Si el tipo de instancia que desea no aparece en la lista, eso significa que no es compatiblecon la configuración de la instancia (por ejemplo, debido a su tipo de virtualización).

11. (Opcional) Si el tipo de instancia que ha elegido admite la optimización de EBS, seleccione EBS-optimized para habilitar la optimización de EBS o desmarque EBS-optimized para deshabilitarla.

Note

Si el tipo de instancia que ha elegido está optimizado para EBS de manera predeterminada,EBS-optimized está seleccionado y no puede desmarcarlo.

12. Elija Apply (Aplicar) para aceptar la nueva configuración.

Note

Si no ha elegido otro tipo de instancia en Instance Type (Tipo de instancia) anteriormente eneste procedimiento, no sucede nada después de elegir Apply (Aplicar).

13. Vuelva a abrir el entorno. Para obtener más información, consulte Apertura de un entorno en AWSCloud9 (p. 74).

Para obtener más información sobre el procedimiento anterior, consulte Cambio del tipo de instancia en laGuía del usuario de Amazon EC2 para instancias de Linux.

Redimensionamiento de un entorno1. Abra el entorno asociado con la instancia Amazon EC2 para el volumen de Amazon EBS cuyo tamaño

desea cambiar.2. En AWS Cloud9 IDE para el entorno, cree un archivo con el siguiente contenido y, a continuación,

guarde el archivo con la extensión .sh, por ejemplo, resize.sh.

En Amazon Linux:

#!/bin/bash

101

https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-resize.html

AWS Cloud9 Guía del usuarioRedimensionamiento de un entorno

# Specify the desired volume size in GiB as a command-line argument. If not specified, default to 20 GiB.SIZE=${1:-20}

# Install the jq command-line JSON processor.sudo yum -y install jq

# Get the ID of the envrionment host Amazon EC2 instance.INSTANCEID=$(curl http://169.254.169.254/latest/meta-data//instance-id)

# Get the ID of the Amazon EBS volume associated with the instance.VOLUMEID=$(aws ec2 describe-instances --instance-id $INSTANCEID | jq -r .Reservations[0].Instances[0].BlockDeviceMappings[0].Ebs.VolumeId)

# Resize the EBS volume.aws ec2 modify-volume --volume-id $VOLUMEID --size $SIZE

# Wait for the resize to finish.while [ "$(aws ec2 describe-volumes-modifications --volume-id $VOLUMEID --filters Name=modification-state,Values="optimizing","completed" | jq '.VolumesModifications | length')" != "1" ]; do sleep 1done

# Rewrite the partition table so that the partition takes up all the space that it can.sudo growpart /dev/xvda 1

# Expand the size of the file system.sudo resize2fs /dev/xvda1

Para Ubuntu Server:

#!/bin/bash

# Specify the desired volume size in GiB as a command-line argument. If not specified, default to 20 GiB.SIZE=${1:-20}

# Install the jq command-line JSON processor.sudo apt install -y jq

# Get the ID of the envrionment host Amazon EC2 instance.INSTANCEID=$(curl http://169.254.169.254/latest/meta-data//instance-id)

# Get the ID of the Amazon EBS volume associated with the instance.VOLUMEID=$(aws ec2 describe-instances --instance-id $INSTANCEID | jq -r .Reservations[0].Instances[0].BlockDeviceMappings[0].Ebs.VolumeId)

# Resize the EBS volume.aws ec2 modify-volume --volume-id $VOLUMEID --size $SIZE

# Wait for the resize to finish.while [ "$(aws ec2 describe-volumes-modifications --volume-id $VOLUMEID --filters Name=modification-state,Values="optimizing","completed" | jq '.VolumesModifications | length')" != "1" ]; do sleep 1done

# Rewrite the partition table so that the partition takes up all the space that it can.sudo growpart /dev/xvda 1

# Expand the size of the file system.sudo resize2fs /dev/xvda1

102

AWS Cloud9 Guía del usuarioEliminación de entornos

3. Desde una sesión de terminal en IDE, cambie el directorio que contiene el archivo resize.sh. Acontinuación, ejecute el siguiente comando, sustituyendo el valor 20 con el tamaño deseado en GiBpara cambiar el tamaño del volumen de Amazon EBS.

sh resize.sh 20

Eliminación de un entorno en AWS Cloud9Para evitar que se realicen cargos continuos en su cuenta de AWS relacionados con un entorno dedesarrollo de AWS Cloud9 que haya dejado de utilizar, elimine el entorno.

• Eliminación de un entorno con la consola (p. 103)• Eliminación de un entorno con código (p. 105)

Eliminación de un entorno con la consolaWarning

Cuando elimina un entorno, AWS Cloud9 elimina el entorno permanentemente. Esto incluye laeliminación permanente de todos los ajustes relacionados, los datos de usuario y el código noconfirmado. Los entornos eliminados no se pueden recuperar.






3. En la lista de entornos, en el entorno que desea eliminar, realice una de las siguientes operaciones.• Elija el título de la tarjeta del entorno. Después, en la página siguiente, elija Delete (Eliminar).

103


AWS Cloud9 Guía del usuarioEliminación de un entorno con la consola

• Seleccione la tarjeta del entorno y, a continuación, elija el botón Delete (Eliminar).

4. En el cuadro de diálogo Delete (Eliminar), escriba Delete y, a continuación, elija Delete (Eliminar).• entorno de EC2

Además, AWS Cloud9 finaliza la instancia de Amazon EC2 que estaba conectada al entorno.

Note

Si se produce un error en la eliminación de la cuenta, se muestra un banner en la partesuperior de la página web de la consola. Además, la tarjeta del entorno, si existe, indica quese ha producido un error en la eliminación del entorno.

• entorno de SSH

Si el entorno estaba conectado a una instancia de Amazon EC2, AWS Cloud9 no finaliza esainstancia. Si no termina dicha instancia más tarde, en su cuenta de AWS le pueden seguir cobrandocargos continuos por Amazon EC2 en relación con esa instancia.

5. Si el entorno era un entorno de SSH, AWS Cloud9 deja un subdirectorio oculto en la instancia deinformática en la nube o en el servidor que se conectó a dicho entorno. Ya puede eliminar de formasegura dicho subdirectorio si lo desea. El subdirectorio se llama .c9. Se encuentra en el directorioEnvironment path (Ruta del entorno), que especificó al crear el entorno.


104

AWS Cloud9 Guía del usuarioEliminación de un entorno con código

• En la barra de navegación lateral, elija una o varias de las siguientes acciones.• Elija Your entornos (Sus entornos) para mostrar todos los entornos que son propiedad de su

entidad de AWS dentro de la cuenta de AWS y la región de AWS seleccionadas.• Elija Shared with you (Compartido con usted) para mostrar todos los entornos a los que se ha

invitado a su entidad de AWS dentro de la cuenta de AWS y la región de AWS seleccionadas.• Elija Account entornos (entornos de cuenta) para mostrar todos los entornos dentro de la cuenta


• Elija la flecha anterior, la flecha siguiente o el botón de número de página para mostrar más entornosen el ámbito actual.



Eliminación de un entorno con códigoWarning

Cuando elimina un entorno, AWS Cloud9 elimina el entorno permanentemente. Esto incluye laeliminación permanente de todos los ajustes relacionados, los datos de usuario y el código noconfirmado. Los entornos eliminados no se pueden recuperar.

105

AWS Cloud9 Guía del usuarioEliminación de un entorno con código

Para eliminar un entorno mediante código, en AWS Cloud9, llame a la operación de AWS Cloud9 paraeliminar un entorno, tal y como se indica seguidamente.

AWS CLI delete-environment

AWS SDK para C++ DeleteEnvironmentRequest,DeleteEnvironmentResult

AWS SDK for Go DeleteEnvironment, DeleteEnvironmentRequest,DeleteEnvironmentWithContext

AWS SDK for Java DeleteEnvironmentRequest,DeleteEnvironmentResult

AWS SDK for JavaScript deleteEnvironment

AWS SDK para .NET DeleteEnvironmentRequest,DeleteEnvironmentResponse

AWS SDK para PHP deleteEnvironment

AWS SDK for Python (Boto) delete_environment

AWS SDK parar Ruby delete_environment

Herramientas de AWS para Windows PowerShell Remove-C9Environment

API de AWS Cloud9 DeleteEnvironment

106

https://docs.aws.amazon.com/cli/latest/reference/cloud9/delete-environment.html

https://sdk.amazonaws.com/cpp/api/LATEST/class_aws_1_1_cloud9_1_1_model_1_1_delete_environment_request.html

https://sdk.amazonaws.com/cpp/api/LATEST/class_aws_1_1_cloud9_1_1_model_1_1_delete_environment_result.html

https://docs.aws.amazon.com/sdk-for-go/api/service/cloud9/#Cloud9.DeleteEnvironment

https://docs.aws.amazon.com/sdk-for-go/api/service/cloud9/#Cloud9.DeleteEnvironmentRequest

https://docs.aws.amazon.com/sdk-for-go/api/service/cloud9/#Cloud9.DeleteEnvironmentWithContext

https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/cloud9/model/DeleteEnvironmentRequest.html

https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/cloud9/model/DeleteEnvironmentResult.html

https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/Cloud9.html#deleteEnvironment-property

https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/Cloud9/TDeleteEnvironmentRequest.html

https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/Cloud9/TDeleteEnvironmentResponse.html

https://docs.aws.amazon.com/aws-sdk-php/v3/api/api-cloud9-2017-09-23.html#deleteenvironment

https://boto3.readthedocs.io/en/latest/reference/services/cloud9.html#Cloud9.Client.delete_environment

https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/Cloud9/Client.html#delete_environment-instance_method

https://docs.aws.amazon.com/powershell/latest/reference/items/Remove-C9Environment.html

https://docs.aws.amazon.com/cloud9/latest/APIReference/API_DeleteEnvironment.html


Uso del AWS Cloud9 IntegratedDevelopment Environment (IDE)

El entorno de desarrollo integrado (IDE) proporciona un conjunto de herramientas de productividad paracodificar integrado por un editor de código fuente, un depurador y herramientas de compilación.

Lea uno o varios de los siguientes temas para aprender a trabajar con el AWS Cloud9 IDE.

Temas• Recorrido del AWS Cloud9 IDE (p. 108)• Lenguajes compatibles en el AWS Cloud9 Integrated Development Environment (IDE) (p. 128)• Referencia de comandos de la barra de menús del AWS Cloud9 Integrated Development Environment

(IDE) (p. 130)• Búsqueda y reemplazo de texto en el AWS Cloud9 Integrated Development Environment

(IDE) (p. 141)• Vista previa de archivos en AWS Cloud9 Integrated Development Environment (IDE) (p. 145)• Vista previa de aplicaciones en ejecución en el AWS Cloud9 Integrated Development Environment

(IDE) (p. 147)• Trabajo con revisiones de archivo en el AWS Cloud9 Integrated Development Environment

(IDE) (p. 154)• Trabajo con archivos de imagen en el AWS Cloud9 Integrated Development Environment

(IDE) (p. 156)• Trabajo con compiladores, ejecutores y depuradores en el AWS Cloud9 Integrated Development

Environment (IDE) (p. 158)• Trabajar con proyectos de lenguaje en el AWS Cloud9 Integrated Development Environment

(IDE) (p. 166)• Trabajo con variables de entorno personalizadas en el AWS Cloud9 Integrated Development

Environment (IDE) (p. 170)• Trabajar con la configuración de usuarios en el AWS Cloud9 Integrated Development Environment

(IDE) (p. 172)• Uso de la configuración de usuario en AWS Cloud9 IDE (p. 178)• Trabajar con la configuración de usuarios y proyectos de AWS en el AWS Cloud9 Integrated

Development Environment (IDE) (p. 187)• Trabajo con enlaces de teclado en el AWS Cloud9 Integrated Development Environment

(IDE) (p. 187)• Trabajar con temas en el AWS Cloud9 Integrated Development Environment (IDE) (p. 190)• Trabajo con scripts de inicialización en el AWS Cloud9 Integrated Development Environment

(IDE) (p. 192)• Referencia de enlaces de teclado predeterminados para MacOS para el AWS Cloud9 Integrated

Development Environment (IDE) (p. 193)• Referencia de enlaces de teclado Vim para MacOS para el AWS Cloud9 Integrated Development

Environment (IDE) (p. 204)• Referencia de enlaces de teclado Emacs para MacOS para el AWS Cloud9 Integrated Development

Environment (IDE) (p. 216)

107

AWS Cloud9 Guía del usuarioRecorrido del IDE

• Referencia de enlaces de teclado Sublime para MacOS para el AWS Cloud9 Integrated DevelopmentEnvironment (IDE) (p. 227)

• Referencia de enlaces de teclado predeterminados para Windows / Linux en el AWS Cloud9 IntegratedDevelopment Environment (IDE) (p. 239)

• Referencia de enlaces de teclado Vim para Windows / Linux en el AWS Cloud9 IntegratedDevelopment Environment (IDE) (p. 251)

• Referencia de enlaces de teclado Emacs para Windows / Linux en el AWS Cloud9 IntegratedDevelopment Environment (IDE) (p. 262)

• Referencia de enlaces de teclado Sublime para Windows / Linux en el AWS Cloud9 IntegratedDevelopment Environment (IDE) (p. 273)

• Referencia de comandos del AWS Cloud9 Integrated Development Environment (IDE) (p. 286)

Recorrido del AWS Cloud9 IDEEn este tema se ofrece un recorrido básico del entorno de desarrollo integrado (IDE) de AWS Cloud9.Para sacar el máximo provecho de este recorrido, siga los pasos que se muestran a continuación de formasecuencial.

Temas• Requisitos previos (p. 108)• Paso 1: Barra de menús (p. 109)• Paso 2: Panel (p. 110)• Paso 3: Ventana entorno (p. 111)• Paso 4: Editor, pestañas y paneles (p. 111)• Paso 5: Consola (p. 113)• Paso 6: Sección Open Files (Abrir archivos) (p. 114)• Paso 7: Margen interior (p. 114)• Paso 8: Barra de estado (p. 115)• Paso 9: Ventana Outline (Esquema) (p. 116)• Paso 10: Ventana Go (Ir) (p. 117)• Paso 11: Pestaña Immediate (Inmediato) (p. 119)• Paso 12: Lista de procesos (p. 120)• Paso 13: Preferencias (p. 121)• Paso 14: Terminal (p. 122)• Paso 15: Ventana Debugger (Depurador) (p. 123)• Conclusiones (p. 128)

Requisitos previosPara realizar este recorrido, debe disponer de una cuenta de AWS y de un entorno de desarrollo deAWS Cloud9 abierto. Para obtener información sobre cómo hacerlo, puede seguir los pasos que seindican en Introducción: tutoriales básicos para AWS Cloud9 (p. 41). También puede explorar otros temasrelacionados, como Configuración de AWS Cloud9 (p. 6) y Uso de entornos en AWS Cloud9 (p. 61).

Warning

Tener un entorno de desarrollo de AWS Cloud9 puede generar cargos en su cuenta de AWS.Entre ellos se incluyen posibles cargos por Amazon EC2 si utiliza un entorno de EC2. Paraobtener más información, consulte Precios de Amazon EC2.

108


AWS Cloud9 Guía del usuarioPaso 1: Barra de menús

Paso 1: Barra de menúsLa barra de menús, en el borde superior del IDE, contiene comandos comunes para trabajar con archivosy código y cambiar la configuración del IDE. También puede obtener una vista previa y ejecutar códigodesde la barra de menús.

Para ocultar la barra de menús, elija la flecha en el borde, tal y como se indica a continuación.

Para volver a ver la barra de menús, elija la flecha en el centro del lugar en el que se encontraba antes labarra de menús, tal y como se indica a continuación.

Compare sus resultados con los siguientes.

Puede utilizar el IDE para trabajar con un conjunto de archivos en las siguientes secciones de este tutorial.Para configurar estos archivos, elija File (Archivo) y, a continuación, New File (Nuevo archivo).

A continuación, copie el siguiente texto en la pestaña del editor Untitled1.

fish.txt--------A fish is any member of a group of organisms that consist ofall gill-bearing aquatic craniate animals that lack limbs with

109

AWS Cloud9 Guía del usuarioPaso 2: Panel

digits. They form a sister group to the tunicates, togetherforming the olfactores. Included in this definition arelampreys and cartilaginous and bony fish as well as variousextinct related groups.

Para guardar el archivo, elija File (Archivo), Save (Guardar). Denomine al archivo fish.txt y, acontinuación, elija Save (Guardar).

Repita estas instrucciones para guardar el segundo archivo como cat.txt, con el contenido siguiente.

cat.txt-------The domestic cat is a small, typically furry, carnivorous mammal.They are often called house cats when kept as indoor pets orsimply cats when there is no need to distinguish them fromother felids and felines. Cats are often valued by humans forcompanionship and for their ability to hunt.

En ocasiones, existen varias formas de hacer las cosas en el IDE. Por ejemplo, para ocultar la barra demenús, en lugar de elegir la flecha del borde, puede elegir View (Ver), Menu Bar (Barra de menú). Paracrear un nuevo archivo, en lugar de elegirFile, New File (Archivo, Nuevo archivo) puede pulsar Alt-N(en Windows/Linux) o Control-N (en MacOS). Para reducir la extensión de este tutorial, solo vamos aexplicar una forma de hacer las cosas. Cuando se sienta más cómodo con el IDE, no dude en probar yaveriguar el método que mejor se adapte a sus necesidades.

Paso 2: PanelEl panel le ofrece acceso rápido a cada uno de sus entornos. En el panel, puede crear, abrir y cambiar laconfiguración de un entorno.

Para abrir el panel, en la barra de menús, elija AWS Cloud9, Go To Your Dashboard (Ir al panel).

Para ver la configuración de su entorno, elija el título dentro de la tarjeta my-demo-entorno. Para volver alpanel, utilice el botón Atrás del navegador web o la ruta de navegación denominada entornos.

Para abrir en el IDE para su entorno, elija Open IDE (Abrir IDE) dentro de la tarjeta my-demo-entorno.

Note

El IDE puede tardar unos momentos en volver a aparecer.

110

AWS Cloud9 Guía del usuarioPaso 3: Ventana entorno

Paso 3: Ventana entornoLa ventana entorno muestra una lista de las carpetas y archivos del entorno. También puede ver diferentestipos de archivos, como, por ejemplo, los archivos ocultos.

Para mostrar u ocultar el contenido de la ventana entorno, elija el botón entorno.

Para mostrar u ocultar la ventana entorno y el botón entorno, elija Window (Ventana), entorno en la barrade menús.

Para mostrar u ocultar archivos ocultos, en la ventana entorno, elija el icono del engranaje y luego ShowHidden Files (Mostrar archivos ocultos).

Paso 4: Editor, pestañas y panelesEl editor es donde puede hacer cosas como escribir código, ejecutar una sesión de terminal y cambiar laconfiguración del IDE. Cada instancia de un archivo abierto, sesión de terminal, etc. está representada poruna pestaña. Las pestañas pueden agruparse en paneles. Las pestañas aparecen en el borde de su panel.

111

AWS Cloud9 Guía del usuarioPaso 4: Editor, pestañas y paneles

Para ocultar pestañas, elija View (Ver), Tab Buttons (Botones de pestañas) en la barra de menús.

Para abrir una nueva pestaña, elija el icono + en el borde de la fila de pestañas. A continuación, elija unode los comandos disponibles, por ejemplo, New File (Nuevo archivo), tal y como se indica a continuación.

Para ver dos paneles, seleccione el icono que parece un menú desplegable, que está en el borde de la filade pestañas. A continuación, elija Split Pane in Two Rows (Dividir panel en dos filas), tal y como se indicaa continuación.

Para volver a un único panel, elija de nuevo el icono del menú desplegable y, a continuación, seleccione elicono del cuadrado único, tal y como se indica a continuación.

112

AWS Cloud9 Guía del usuarioPaso 5: Consola

Paso 5: ConsolaLa consola es un lugar alternativo para crear y administrar pestañas. De forma predeterminada, contieneuna pestaña Terminal, pero también puede contener otros tipos de pestañas.

Para mostrar u ocultar la consola, elija View (Ver), Console (Consola) en la barra de menús.

Para ampliar o contraer la consola, elija el icono de cambio de tamaño, que está en el borde de la consola,tal y como se indica a continuación.

113

AWS Cloud9 Guía del usuarioPaso 6: Sección Open Files (Abrir archivos)

Paso 6: Sección Open Files (Abrir archivos)La sección Open Files (Abrir archivos) muestra una lista de todos los archivos que se encuentran abiertosactualmente en el editor. Open Files (Abrir archivos) forma parte de la ventana entorno.

Para mostrar u ocultar la sección Open Files (Abrir archivos), seleccione View (Ver), Open Files (Abrirarchivos) en la barra de menús.

Para cambiar entre archivos abiertos, elija el archivo de interés de la lista.

Paso 7: Margen interiorEl margen interior, en el borde de cada archivo del editor, muestra cosas como números de líneas ysímbolos contextuales cuando trabaja con archivos.

Para mostrar u ocultar el margen interior, elija View (Ver), Gutter (Margen interior) en la barra de menús.

114

AWS Cloud9 Guía del usuarioPaso 8: Barra de estado

Paso 8: Barra de estadoLa barra de estado, situada en el borde de cada archivo del editor, muestra cosas como números decarácter y línea, preferencia de tipo de archivo, configuración de espacio y pestaña y configuración deleditor relacionada.

Para mostrar u ocultar la barra de estado, elija View (Ver), Status Bar (Barra de estado) en la barra demenús.

Para ir a un número de línea específico, elija una pestaña con el archivo que le interese. A continuación, enla barra de estado, elija el número de línea y carácter (debería ser algo como 7:45). Escriba un número delínea (como 4) y, a continuación, presione Enter, tal y como se indica a continuación.

Para cambiar la preferencia del tipo de archivo, en la barra de estado, elija otro tipo de archivo. Porejemplo, en el caso de cat.txt, elija Ruby para ver el cambio de colores de la sintaxis. Para volver a loscolores de texto sin formato, elija Plain Text (Texto sin formato), tal y como se indica a continuación.

115

AWS Cloud9 Guía del usuarioPaso 9: Ventana Outline (Esquema)

Paso 9: Ventana Outline (Esquema)Puede utilizar la ventana Outline (Esquema) para ir rápidamente a la ubicación de un archivo específico.

Para mostrar u ocultar la ventana Outline (Esquema) y el botón Outline (Esquema), elija Window(Ventana), Outline (Esquema) en la barra de menús.

Para ver cómo funciona la ventana Outline (Esquema), cree un archivo con el nombre hello.rb. Copie elcódigo siguiente en el archivo y guárdelo.

def say_hello(i) puts "Hello!" puts "i is #{i}"end

def say_goodbye(i) puts "i is now #{i}" puts "Goodbye!"end

i = 1say_hello(i)i += 1say_goodbye(i)

Para mostrar u ocultar el contenido de la ventana Outline (Esquema), elija el botón Outline (Esquema).

A continuación, en la ventana Outline (Esquema), elija say_hello(i) y luego elija say_goodbye(i), tal y comose indica a continuación.

116

AWS Cloud9 Guía del usuarioPaso 10: Ventana Go (Ir)

Paso 10: Ventana Go (Ir)Puede utilizar la ventana Go (Ir) para abrir un archivo en el editor, ir a una definición de símbolo, ejecutarun comando o ir a una línea del archivo activo en el editor.

117

AWS Cloud9 Guía del usuarioPaso 10: Ventana Go (Ir)

Para mostrar el contenido de la ventana Go (Ir), seleccione el botón Go (Ir) (el icono de lupa).

Para mostrar u ocultar la ventana Go (Ir) y el botón Go (Ir), elija Window (Ventana), Go (Ir) en la barra demenús.

Con la ventana Go (Ir) abierta, puede:

• Introduzca un signo de barra inclinada (/) seguido de parte o la totalidad de un nombre de archivo. Enla lista de archivos coincidentes que aparecerá, elija un archivo para abrirlo en el editor. Por ejemplo, alescribir /fish se muestra fish.txt, mientras que al escribir /.txt se muestra tanto fish.txt comocat.txt.

Note

La búsqueda de archivos se limita solo a los archivos y las carpetas no ocultos de la ventanaEnvironment (Entorno).

• Escriba una arroba (@) seguida del nombre de un símbolo. En la lista de símbolos coincidentes queaparecerá, elija un símbolo para abrirlo en el editor. Por ejemplo, con el archivo hello.rb abiertoy activo en el editor, escriba @hello para mostrar say_hello(i), o escriba @say para mostrarsay_hello(i) y say_goodbye(i).

Note

Si el archivo activo en el editor forma parte de un proyecto con idiomas admitidos, la búsquedade símbolos se limita al proyecto actual. De lo contrario, la búsqueda de símbolos se limitaúnicamente al archivo activo en el editor. Para obtener más información, consulte Trabajar conproyectos de lenguaje en el AWS Cloud9 Integrated Development Environment (IDE) (p. 166).

• Escriba un punto (.) seguido del nombre de un comando. En la lista de comandos que aparecerá, elijaun comando para ejecutarlo. Por ejemplo, escribir .closetab y, a continuación, pulsar Enter cierra lapestaña actual del editor. Para obtener una lista de los comandos disponibles, consulte el Referencia decomandos del AWS Cloud9 Integrated Development Environment (IDE) (p. 286).

• Escriba un signo de dos puntos (:) seguido de un número para ir a ese número de línea en el archivoactivo en el editor. Por ejemplo, con el archivo hello.rb abierto y activo en el editor, escriba :11 parair a la línea 11 de ese archivo.

118

AWS Cloud9 Guía del usuarioPaso 11: Pestaña Immediate (Inmediato)

Para ver los enlaces de teclado de cada una de estas acciones según el modo de teclado y el sistemaoperativo actuales, consulte cada uno de los comandos Go To (Ir a) disponibles en el menú Go (Ir) de labarra de menú.

Paso 11: Pestaña Immediate (Inmediato)La pestaña Immediate (Inmediato) permite probar pequeños fragmentos de código JavaScript. Para vercómo funciona la pestaña Immediate (Inmediato), haga lo siguiente.

1. Abra una pestaña Immediate (Inmediato) eligiendo Window (Ventana), New Immediate Window(Nueva ventana inmediata) en la barra de menús.

2. Ejecute código en la pestaña Immediate (Inmediato). Para probarlo, escriba el siguiente código enla ventana, pulse Shift-Enter después de escribir la línea 1 y de nuevo después de la línea 2.Presione Enter después de la línea 3. (Si presiona Enter en lugar de Shift-Enter después deescribir la línea 1 o la línea 2, el código se ejecutará antes de lo que desea).

for (i = 0; i <= 10; i++) { // Press Shift-Enter after typing this line. console.log(i) // Press Shift-Enter after typing this line.} // Press Enter after typing this line. The numbers 0 to 10 will be printed.

119

AWS Cloud9 Guía del usuarioPaso 12: Lista de procesos

Paso 12: Lista de procesosEn Process List (Lista de procesos) se muestran todos los procesos en ejecución. Puede detener o inclusoforzar la detención de procesos que no desea que se ejecuten más. Para ver cómo funciona la ventanaProcess List (Lista de procesos), haga lo siguiente.

1. Para abrir Process List (Lista de procesos), elija Tools (Herramientas), Process List (Lista deprocesos) en la barra de menús.

2. Busque un proceso. En Process List (Lista de procesos), escriba el nombre del proceso.3. Detenga o fuerce la detención de un proceso. En la lista de procesos, elija el proceso y, a

continuación, elija Kill (Terminar) o Force Kill (Forzar terminación), tal y como se indica a continuación.

120

AWS Cloud9 Guía del usuarioPaso 13: Preferencias

Paso 13: PreferenciasEn las preferencias, se incluyen los siguientes ajustes de configuración.

• Solo la configuración del entorno actual, como, por ejemplo, si debe utilizar tabuladores suaves en eleditor, los tipos de archivos que se deben omitir y los comportamientos de finalización de código delenguajes como PHP y Python.

• Su configuración de usuario en cada uno de sus entornos, como, por ejemplo, colores, fuentes ycomportamientos del editor.

• Su enlaces de teclado, como, por ejemplo, las combinaciones de teclas de acceso directo que prefiereutilizar para trabajar con archivos y el editor.

• El tema general del IDE.

Para ver las preferencias, elija AWS Cloud9, Preferences (Preferencias) en la barra de menús. Se muestraalgo similar a lo siguiente.

121

AWS Cloud9 Guía del usuarioPaso 14: Terminal

Paso 14: TerminalPuede ejecutar una o varias sesiones de terminal en el IDE. Para iniciar una sesión de terminal, elijaWindow (Ventana), New Terminal (Nuevo terminal) en la barra de menús. O bien, elija el icono "más"situado junto a las pestañas Console (Consola) y elija New Terminal (Nuevo terminal).

Puede probar ejecutar un comando en el terminal. Por ejemplo, en el terminal, escriba echo $PATH y, acontinuación, pulse Enter para imprimir el valor de la variable de entorno PATH.

También puede probar a ejecutar otros comandos. Por ejemplo, pruebe comandos como los siguientes.

• pwd para imprimir la ruta al directorio actual.• aws --version para imprimir información de versión de la AWS CLI.• ls -l para imprimir información del directorio actual.

122

AWS Cloud9 Guía del usuarioPaso 15: Ventana Debugger (Depurador)

Paso 15: Ventana Debugger (Depurador)Puede utilizar la ventana Debugger (Depurador) para depurar el código. Por ejemplo, puede recorrer elcódigo en ejecución por partes, observar los valores de las variables a lo largo del tiempo y examinar lapila de llamadas.

Note

Este procedimiento es similar al Paso 2: Recorrido básico del IDE (p. 44) de cualquiera de lostutoriales básicos del IDE (p. 41).

Para mostrar u ocultar la ventana Debugger (Depurador) y el botón Debugger (Depurador), elija Window(Ventana), Debugger (Depurador) en la barra de menús.

En este tutorial, puede experimentar con la ventana Debugger (Depurador) y algunos códigos JavaScripthaciendo lo siguiente.

1. Compruebe la instalación de Node.js en su entorno ejecutando el siguiente comando en una sesiónde terminal: node --version. Si Node.js está instalado, se genera el número de versión deNode.js en la salida y puede ir directamente al paso 3 de este procedimiento («Escribir algún códigoJavaScript...»).

2. Si necesita instalar Node.js, haga lo siguiente.

123


a. Ejecute los dos comandos siguientes, de uno en uno, para asegurarse de que su entorno tengalas actualizaciones más recientes y, a continuación, descargue Node Version Manager (nvm).(nvm es un sencillo script de shell Bash que resulta útil para instalar y administrar versiones deNode.js. Para obtener más información, consulte Node Version Manager en GitHub).

En Amazon Linux:

sudo yum -y updatecurl -o- https://raw.githubusercontent.com/creationix/nvm/v0.33.0/install.sh | bash

Para Ubuntu Server:

sudo apt updatecurl -o- https://raw.githubusercontent.com/creationix/nvm/v0.33.0/install.sh | bash

b. Utilice un editor de texto para actualizar el archivo de perfil de shell (por ejemplo, ~/.bashrc)para permitir que nvm se cargue. Por ejemplo, en la ventana Environment (Entorno) del IDE, elijael icono del engranaje y, a continuación, seleccione Show Home in Favorites (Mostrar inicio enfavoritos). Repita este paso y elija también Show Hidden Files (Mostrar archivos ocultos).

c. Abra el archivo ~/.bashrc.d. Escriba o pegue el código siguiente al final del archivo para permitir que nvm se cargue.

En Amazon Linux:

export NVM_DIR="/home/ec2-user/.nvm"[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh" # This loads nvm.

Para Ubuntu Server:

export NVM_DIR="/home/ubuntu/.nvm"[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh" # This loads nvm.

e. Guarde el archivo.f. Cierre esa sesión de terminal e inicie una nueva. A continuación, ejecute el siguiente comando

para instalar la última versión de Node.js.

nvm install node

3. Escriba algún código JavaScript para depurarlo. Por ejemplo, cree un archivo, añada el siguientecódigo en él y, a continuación, guárdelo como hello.js.

var i;

i = 10;

console.log("Hello!");console.log("i is " + i);

i += 1;

console.log("i is now " + i);console.log("Goodbye!");

4. Añada algunos puntos de interrupción en el código. Por ejemplo, en el margen interior, haga clic en elmargen junto a las líneas 6 y 10. Aparece un círculo rojo junto a cada uno de estos números de línea,tal y como se indica a continuación.

124

https://github.com/creationix/nvm/blob/master/README.md


5. Ya está listo para depurar el código JavaScript. Para probarlo, haga lo siguiente.

a. Para mostrar u ocultar el contenido de la ventana Debugger (Depurador), elija el botón Debugger(Depurador), tal y como se muestra en el siguiente paso.

b. Observe el valor de la variable denominada i mientras se está ejecutando el código. En laventana Debugger (Depurador), en Watch Expressions (Expresiones de inspección), elija Typean expression here (Escriba una expresión aquí). Escriba la letra i y, a continuación, presioneEnter, tal y como se indica a continuación.

c. Comience a ejecutar el código. Seleccione Run (Ejecutar), Run With (Ejecutar con), Node.js, tal ycomo se indica a continuación.

125


d. El código realiza una pausa en la ejecución en la línea 6. La ventana Debugger (Depurador)muestra el valor i en Watch Expressions (Expresiones de inspección), que actualmente es 10.

e. En la ventana Debugger (Depurador), seleccione Resume (Reanudar), que es el icono de flechaazul, tal y como se indica a continuación.

126


f. El código realiza una pausa en la ejecución en la línea 10. En la ventana Debugger (Depurador)ahora aparece el nuevo valor de i, que en la actualidad es 11.

g. Seleccione Resume (Reanudar) de nuevo. El código se ejecuta hasta el final. El resultado seimprime en la pestaña hello.js de la consola, tal y como se indica a continuación.


127

AWS Cloud9 Guía del usuarioConclusiones

ConclusionesWarning

Recuerde que tener un entorno de desarrollo de AWS Cloud9 puede generar cargos en su cuentade AWS. Entre ellos se incluyen posibles cargos por Amazon EC2 si utiliza un entorno de EC2.Para obtener más información, consulte Precios de Amazon EC2.En la sección principal (Uso del IDE (p. 107)) se incluyen temas adicionales que pueden serde su interés. Sin embargo, cuando haya terminado de recorrer el IDE de AWS Cloud9 y ya nonecesite el entorno, asegúrese de eliminarlo junto con sus recursos asociados, tal y como sedescribe en Eliminación de entornos (p. 103).

Lenguajes compatibles en el AWS Cloud9Integrated Development Environment (IDE)

El AWS Cloud9 IDE es compatible con varios lenguajes de programación. En la tabla siguiente semuestran los lenguajes que son compatibles y en qué grado.

Idioma Resaltadode sintaxis1

IU2 deejecución

Vista deesquema

Sugerenciasde código ylint

Finalizaciónde código

Depuración3

C++ X X X X5 X4

128


AWS Cloud9 Guía del usuarioLenguajes compatibles

Idioma Resaltadode sintaxis1

IU2 deejecución

Vista deesquema

Sugerenciasde código ylint

Finalizaciónde código

Depuración3

C# X X X5

CoffeeScript X X

CSS X X

Dart X

Go X X X X X4 X4

Haskell X

HTML X X X X

Java X X X5

JavaScript X X X X X

Node.js X X X X X X6

PHP X X X X X7 X

Python X X X X X8 X

Ruby X X X X X5

Script deshell

X X X X X5

El AWS Cloud9 IDE proporciona soporte adicional para algunos lenguajes de programación, como, porejemplo, TypeScript, en el contexto de un proyecto de lenguaje. Para obtener más información, consulteWorking with Language Projects (p. 166).

Notas1 El AWS Cloud9 IDE proporciona resaltado de sintaxis para muchos más lenguajes. Para ver una listacompleta, en la barra de menús del IDE, elija View, Syntax (Ver, Sintaxis).2 Puede ejecutar programas o scripts con un solo clic para lenguajes marcados con X, sin utilizar la líneade comandos. Para los lenguajes que no están marcados con X o que no aparecen en la barra de menúsRun, Run With (Ejecutar, Ejecutar con) del IDE, puede crear un ejecutor específico para dicho lenguaje.Para ver instrucciones, consulte la sección sobre creación de un generador o ejecutor (p. 163).3 Puede utilizar las herramientas integradas del IDE para depurar programas o scripts para lenguajesmarcados con X. Para ver instrucciones, consulte la sección sobre depuración del código (p. 159).4 Esta característica se encuentra en estado experimental para este lenguaje. No se ha aplicadoplenamente y no está documentada o no es compatible.5 Esta característica solo es compatible con las funciones locales para este lenguaje.6 Esta característica no es compatible con las versiones de Node.js 7.7.0 y posteriores.7 Para especificar las rutas de AWS Cloud9 que deben utilizarse para finalizar el código de PHPpersonalizado, en el AWS Cloud9 IDE active la configuración Project, PHP Support, Enable PHP codecompletion (Proyecto, Compatibilidad con PHP, Permitir finalización de código PHP) en Preferences

129

AWS Cloud9 Guía del usuarioReferencia de los comandos de menú

(Preferencias) y, a continuación, añada las rutas al código personalizado a la configuración Project, PHPSupport, PHP Completion Include Paths (Proyecto, Compatibilidad con PHP, Rutas de inclusión parafinalización de PHP).

8 Para especificar las rutas de AWS Cloud9 que deben utilizarse para finalizar el código de Pythonpersonalizado, en el AWS Cloud9 IDE active la configuración Project, Python Support, Enable Pythoncode completion (Proyecto, Compatibilidad con Python, Permitir finalización de código de Python) enPreferences (Preferencias) y, a continuación, añada las rutas al código personalizado a la configuraciónProject, Python Support, PYTHONPATH (Proyecto, Compatibilidad con Python, PYTHONPATH).

Referencia de comandos de la barra de menús delAWS Cloud9 Integrated Development Environment(IDE)

En la lista siguiente se describen los comando de la barra de menús predeterminados en el AWS Cloud9IDE. Si la barra de menús no está visible, elija la barra fina del borde superior del IDE para mostrarla.

• Menú de AWS Cloud9 (p. 130)• Menú File (p. 131)• Menú Edit (p. 132)• Menú Find (Buscar) (p. 134)• Menú View (p. 135)• Menú Go (Ir) (p. 136)• Menú Run (Ejecutar) (p. 137)• Menú de herramientas (p. 138)• Menú Window (Ventana) (p. 138)• Menú Support (Soporte) (p. 140)• Menú Preview (Vista previa) (p. 141)• Otros comandos de la barra de menús (p. 141)

Menú de AWS Cloud9

Comando Descripción

Preferencias Aplique alguna de las siguientes acciones:

• Abra la pestaña Preferences (Preferencias) si noestá abierta.

• Haga que Preferences (Preferencias) sea lapestaña activa si está abierta pero no activa.

• Oculte la pestaña Preferences (Preferencias) siestá activa.

Consulte Trabajar con la configuración de losproyectos (p. 172), Trabajar con la configuraciónde los usuarios (p. 178), Trabajar con los enlaces

130

AWS Cloud9 Guía del usuarioMenú File

Comando Descripciónde teclado (p. 187), Trabajar con temas (p. 190)y Trabajo con scripts de inicialización (p. 192).

Go To Your Dashboard (Ir a su panel) Abra la consola de AWS Cloud9 en una pestañaindependiente del navegador web. ConsulteCreación de un entorno (p. 61), Abrir unentorno (p. 74), Modificación de la configuracióndel entorno (p. 84) y la sección sobre eliminaciónde entornos (p. 103).

Welcome Page (Página de bienvenida) Abre la pestaña Welcome (Bienvenida).

Open Your Project Settings (Abrir la configuracióndel proyecto)

Abra el archivo project.settings del entornoactual. Consulte Trabajar con la configuración delos proyectos (p. 172).

Open Your User Settings (Abrir su configuración deusuario)

Abra el archivo user.settings del usuarioactual. Consulte Trabajar con la configuración delos usuarios (p. 178).

Open Your Keymap (Abrir su Keymap) Abra el archivo keybindings.settings delusuario actual. Consulte Trabajar con enlaces deteclado (p. 187).

Open Your Init Script (Abrir su script Init) Abra el archivo init.js del usuarioactual. Consulte Trabajar con scripts deinicialización (p. 192).

Open Your Stylesheet (Abrir su hoja de estilos) Abra el archivo styles.css del usuario actual.Consulte Trabajar con temas (p. 190).

Menú File


New File (Archivo nuevo) Cree un archivo nuevo.

New From Template (Nuevo desde plantilla) Crear un nuevo archivo, basado en la plantilla dearchivo elegida.

Open Mostrar y va a la ventana Navigate (Navegar).

Open Recent (Abrir últimos) Abre el archivo elegido.

Save (Guardar) Guarda el archivo actual.

Save As (Guardar como) Guarda el archivo actual con otro nombre oubicación, o ambos.

Save All (Guardar todo) Guarda todos los archivos sin guardar.

Revert to Saved (Volver sin guardar) Descarta los cambios hechos en el archivo desdela última vez que se guardó.

Revert All to Saved (Descartar todos los cambios) Descarta cambios de todos los archivos singuardar desde que se guardaron por última vez.

131

AWS Cloud9 Guía del usuarioMenú Edit


Show File Revision History (Ver historial derevisiones de archivo)

Ver y administrar los cambios en el archivo actualen el editor. Consulte Uso de revisiones dearchivo (p. 154).

Upload Local Files (Cargar archivos locales) Mostrar el cuadro de diálogo Upload Files (Cargararchivos), que permite arrastrar archivos del equipolocal al entorno.

Download Project (Descargar proyecto) Combina los archivos del entorno en unarchivo .zip que se puede descargar en el equipolocal.

Line Endings (Finales de línea) Utiliza los finales de línea de Windows (retorno decarro además de salto de línea) o de Unix (solosalto de línea).

Close File (Cerrar archivo) Cierra el archivo actual.

Close All Files (Cerrar todos los archivos) Cierra todos los archivos abiertos.

Menú Edit


Deshacer Deshacer la última acción.

Rehacer Rehace la última acción deshecha.

Cortar Mueve la selección al portapapeles.

Copiar Copiar la selección en el portapapeles.

Pegar Copia el contenido del portapapeles en el punto deselección.

Keyboard Mode (Modo teclado) El conjunto de enlaces de teclado que se va autilizar, por ejemplo Default, Vim, Emacs oSublime. Consulte Trabajar con enlaces deteclado (p. 187).

Selection, Select All (Selección, Seleccionar todo) Seleccionar todo el contenido seleccionable.

Selection, Split Into Lines (Selección, Dividir en doslíneas)

Añadir un cursor al final de la línea actual.

Selection, Single Selection (Selección, Selecciónúnica)

Borrar todas las selecciones anteriores.

Selection, Multiple Selections, Add Cursor Up(Selección, Selección múltiple, Añadir cursorarriba)

Añadir un cursor una línea por encima del cursoractivo. Si ya hay un cursor, añade otro por encimade ese cursor.

Selection, Multiple Selections, Add Cursor Down(Selección, Selección múltiple, Añadir cursor abajo)

Añadir un cursor una línea por debajo del cursoractivo. Si ya hay un cursor añadido, añade otro pordebajo de ese cursor.

132

AWS Cloud9 Guía del usuarioMenú Edit


Selection, Multiple Selections, Move Active CursorUp (Selección, Selección múltiple, Añadir cursorabajo)

Añade un segundo cursor una línea por encimadel cursor activo. Si ya se ha añadido un segundocursor, lo mueve hacia arriba una línea.

Selection, Multiple Selections, Move Active CursorDown (Selección, Selección múltiple, Mover cursoractivo abajo)

Añade un segundo cursor una línea por debajodel cursor activo. Si ya se ha añadido un segundocursor, lo mueve hacia abajo una línea.

Selection, Multiple Selections, Add Next SelectionMatch (Selección, Selección múltiple, Añadircoincidencia próxima selección)

Incluir más selecciones coincidentes que estándespués de la selección.

Selection, Multiple Selections, Add PreviousSelection Match (Selección, Selección múltiple,Añadir coincidencia selección anterior)

Incluir más selecciones coincidentes que estánantes de la selección.

Selection, Multiple Selections, Merge SelectionRange (Selección, Selección múltiple, Combinarrango de selección)

Añadir un cursor al final de la línea actual.

Selection, Select Word Right (Selección,Seleccionar palabra a la derecha)

Incluir la siguiente palabra a la derecha del cursoren la selección.

Selection, Select Word Left (Selección, Seleccionarpalabra a la izquierda)

Incluir la siguiente palabra a la izquierda del cursoren la selección.

Selection, Select to Line End (Selección,Seleccionar hasta final de línea)

Incluir desde el cursor hasta el final de la líneaactual en la selección

Selection, Select to Line Start (Selección,Seleccionar hasta inicio de línea)

Incluir desde el comienzo de la línea actual hastael cursor en la selección.

Selection, Select to Document End (Selección,Seleccionar hasta el final del documento)

Incluir desde el cursor hasta el final del archivoactual en la selección.

Selection, Select to Document Start (Selección,Seleccionar hasta inicio de documento)

Incluir desde el cursor hasta el comienzo delarchivo actual en la selección.

Line, Indent (Línea, Aplicar sangría) Aplicar sangría de un tabulador a la selección.

Line, Outdent (Línea, Quitar sangría) Quitar la sangría de la selección un tabulador.

Line, Move Line Up (Línea, Mover una línea arriba) Mover la selección una línea hacia arriba.

Line, Move Line Down (Línea, Mover una líneaabajo)

Mover la selección una línea hacia abajo.

Line, Copy Lines Up (Línea, Copiar líneas arriba) Copiar el contenido de la línea y pegarlo una líneapor encima.

Line, Copy Lines Down (Línea, Copiar líneasabajo)

Copiar el contenido de la línea y pegarlo una líneapor debajo.

Line, Remove Line (Línea, Quitar línea) Eliminar el contenido de la línea actual.

Line, Remove to Line End (Línea, Borrar hasta finalde línea)

Eliminar desde el cursor hasta el final de la líneaactual.

133

AWS Cloud9 Guía del usuarioMenú Find (Buscar)


Line, Remove to Line Start (Línea, Borrar hastacomienzo de línea)

Eliminar desde el comienzo de la línea actual hastael cursor.

Line, Split Line (Línea, Dividir línea) Mover el contenido del cursor al final de la línea, auna línea propia.

Text, Remove Word Right (Texto, Borrar palabraderecha)

Eliminar la palabra situada a la derecha del cursor.

Text, Remove Word Left (Texto, Borrar palabraizquierda)

Eliminar la palabra situada a la izquierda delcursor.

Text, Align (Texto, Alinear) Mover todos los cursores al mismo espacio queel cursor activo en cada una de sus líneas, si noestán alineados.

Text, Transpose Letters (Texto, Transponer letras) Transponer la selección.

Text, To Upper Case (Texto, En mayúsculas) Poner la selección completa en mayúsculas.

Text, To Lower Case (Texto, En minúsculas) Poner la selección completa en minúsculas.

Comment, Toggle Comment (Comentario, Cambiarcomentario)

Añadir caracteres de comentario de línea alprincipio de cada línea seleccionada o eliminarlossi ya están.

Code Folding, Toggle Fold (Plegado de código,Cambiar plegado)

Plegar código o quitar el plegado de código si estáplegado.

Code Folding, Unfold (Plegado de código,Desplegar)

Desplegar el código seleccionado.

Code Folding, Fold Other (Plegado de código,Plegar otro)

Plegar todos los elementos plegables, excepto elámbito actual de selección.

Code Folding, Fold All (Plegado de código, Plegartodo)

Plegar todos los elementos plegables.

Code Folding, Unfold All (Plegado de código,Desplegar todo)

Desplegar el plegado de código en todo el archivo.

Code Formatting, Apply Code Formatting (Formatode código, Aplicar formato de código)

Volver a formatear el código JavaScriptseleccionado.

Code Formatting, Open Language & FormattingPreferences (Formato de código, Abrir lenguaje ypreferencias de formato)

Abrir la sección Project Settings (Configuración delproyecto) de la pestaña Preferences (Preferencias)para configurar el lenguaje de programación.

Menú Find (Buscar)Para obtener más información, consulte Búsqueda y reemplazo de texto (p. 141).

134

AWS Cloud9 Guía del usuarioMenú View


Buscar Abrir la barra de búsqueda y reemplazo en eldocumento actual centrándose en la expresiónFind (Buscar).

Find Next (Buscar siguiente) Ir a la siguiente coincidencia en el documentoactual de la consulta de búsqueda introducida enúltimo lugar.

Find Previous (Buscar anterior) Ir a la coincidencia anterior en el documento actualde la consulta de búsqueda que se ha introducidoen último lugar.

Reemplazar Abrir la barra de búsqueda y reemplazo en eldocumento actual centrándose en la expresiónReplace With (Reemplazar por).

Replace Next (Buscar siguiente) Sustituir la siguiente coincidencia de Find (Buscar)por Replace With (Reemplazar por) en la barra debúsqueda y reemplazo del documento actual.

Replace Previous (Buscar anterior) Sustituir la coincidencia anterior de Find (Buscar)por Replace With (Reemplazar por) en la barra debúsqueda y reemplazo del documento actual.

Replace All (Reemplazar todo) Sustituir todas las coincidencias de Find (Buscar)por Replace With (Reemplazar por) en la barra debúsqueda y reemplazo del documento actual.

Buscar en archivos Mostrar la barra de buscar y reemplazar paravarios archivos

Menú View


Editores Mostrar el editor elegido.

Open Files (Archivos abiertos) Mostrar la lista Open Files (Archivos abiertos) dela ventana Environment (Entorno) u ocultarla si semuestra.

Menu Bar (Barra) Mostrar la barra de menús u ocultarla si semuestra.

Tab Buttons (Botones de pestañas) Mostrar las pestañas u ocultarlas si se muestran.

Gutter (Margen interior) Mostrar el margen izquierdo o lo oculta si semuestra.

Status Bar (barra de estado) Mostrar la barra de estado u ocultarla si semuestra.

Consola Mostrar la ventana Console (Consola) u ocultarla sise muestra.

135

AWS Cloud9 Guía del usuarioMenú Go (Ir)


Layout, Single (Panel, Único) Mostrar un solo panel.

Layout, Vertical Split (Panel, División vertical) Mostrar dos paneles, superior e inferior.

Layout, Horizontal Split (Panel, División horizontal) Mostrar dos paneles, uno junto a otro.

Layout, Cross Split (Panel, División cruzada) Mostrar cuatro paneles de igual tamaño.

Layout, Split 1:2 (Panel, División 1:2) Mostrar un panel a la izquierda y dos paneles a laderecha.

Layout, Split 2:1 (Panel, División 2:1) Mostrar dos paneles a la izquierda y un panel a laderecha.

Font Size, Increase Font Size (Tamaño de fuente,Aumentar)

Aumentar el tamaño de la fuente.

Font Size, Decrease Font Size (Tamaño de fuente,Disminuir)

Disminuir el tamaño de la fuente.

Sintaxis Mostrar el tipo de sintaxis del documento actual.

Themes (Temas) Mostrar el tipo de tema del IDE.

Wrap Lines (Ajuste de línea) Ajusta las palabras en el borde del panel actual odeja de ajustarlas si ya lo están.

Wrap To Print Margin (Ajustar al margen deimpresión)

Ajusta las palabras en el borde del margen deimpresión actual o deja de ajustarlas si ya lo están.

Menú Go (Ir)


Go to Anything (Ir a cualquier punto) Mostrar la ventana Go (Ir) en el modo Go toAnything (Ir a cualquier punto).

Go to Symbol (Ir a símbolo) Mostrar la ventana Go (Ir) en el modo Go toSymbol (Ir a símbolo).

Go to File (Ir a archivo) Mostrar la ventana Go (Ir) en el modo Go to File (Ira archivo).

Go to Command (Ir a comando) Mostrar la ventana Go (Ir) en el modo Go toCommand (Ir a comando).

Go to Line (Ir a línea) Mostrar la ventana Go (Ir) en el modo Go to Line (Ira línea).

Next Error (Siguiente error) Ir al siguiente error.

Previous Error (Error anterior) Ir al error anterior.

Word Right (Palabra a la derecha) Ir una palabra a la derecha.

Word Left (Palabra a la izquierda) Ir una palabra a la izquierda.

136

AWS Cloud9 Guía del usuarioMenú Run (Ejecutar)


Line End (Final de línea) Ir al final de la línea actual.

Line Start (Inicio de línea) Ir al comienzo de la línea actual.

Jump to Definition (Saltar a la definición) Ir a la definición de la variable o función en elcursor.

Jump to Matching Brace (Saltar a símbolocoincidente)

Ir al símbolo coincidente en el ámbito actual.

Scroll to Selection (Desplazar a selección) Desplazar la selección a una vista mejor.

Menú Run (Ejecutar)


Ejecute Ejecutar o depurar la aplicación actual.

Run Last (Ejecutar último) Ejecutar o depurar el último archivo ejecutado.

Run With (Ejecutar con) Ejecutar o depurar el ejecutor elegido. ConsulteTrabajo con compiladores, ejecutores ydepuradores (p. 158).

Run History (Ejecutar historial) Ver el historial de ejecución.

Run Configurations (Configuraciones de ejecución) Elija una configuración de ejecución con laque ejecutar o depurar, o creer o administrarconfiguraciones de ejecución. ConsulteTrabajo con compiladores, ejecutores ydepuradores (p. 158).

Show Debugger at Break (Mostrar depurador endescanso)

Cuando la ejecución de código alcanza un puntode interrupción, muestra la ventana Debugger(Depurador).

Build Compilar el archivo actual.

Cancel Build (Cancelar compilación) Detener la compilación del archivo actual.

Build System (Compilar sistema) Compilar usando el sistema de compilaciónelegido.

Show Build Result (Mostrar resultado decompilación)

Mostrar el resultado de la compilación relacionada.

Automatically Build Supported Files (Compilarautomáticamente archivos compatibles)

Compilar automáticamente archivos compatibles.

Save All on Build (Guardar todo en compilación) Cuando se compila, guarda todos los archivos singuardar relacionados.

137

AWS Cloud9 Guía del usuarioMenú de herramientas

Menú de herramientas


Strip Trailing Space (Suprimir espacio final) Suprimir los espacios en blanco al final de laslíneas.

Preview, Preview File (Vista previa, Vista previa dearchivo)

Mostrar una vista previa del documento actual enuna pestaña de vista previa.

Preview, Preview Running Application (Vistaprevia, Vista previa de una aplicación en ejecución)

Mostrar la vista previa de la aplicación en unapestaña independiente del navegador web.

Preview, Configure Preview URL (Vista previa,Configurar URL de vista previa)

Abrir la sección Project Settings (Configuración delproyecto) de la pestaña Preferences (Preferencias)en el cuadro Run & Debug, Preview URL (Ejecutary depurar, URL vista previa).

Preview, Show Active Servers (Vista previa,Mostrar servidores activos)

Mostrar una lista de direcciones de servidoresactivos disponibles en el cuadro de diálogoProcess List (Lista de procesos).

Process List (Lista de procesos) Mostrar el cuadro de diálogo Process List (Lista deprocesos).

Show Autocomplete (Mostrar autocompletar) Mostrar el menú contextual de finalización de uncódigo.

Rename Variable (Renombrar variable) Iniciar una refactorización de cambio de nombrepara la selección.

Toggle Macro Recording (Alternar grabación demacro)

Comienza la grabación de la combinación de teclaso la detiene si ya se está grabando.

Play Macro (Reproducir macro) Reproduce pulsaciones del teclado previamenteregistradas.

Menú Window (Ventana)


Go Mostrar la ventana Go (Ir) u ocultarla si se muestra.

New Terminal (Nuevo terminal) Abrir una nueva pestaña Terminal.

New Immediate Window (Nueva ventanainmediata)

Abrir una nueva pestaña Immediate (Inmediata).

Share Mostrar el cuadro de diálogo Share thisenvironment (Compartir este entorno).

Installer (Instalador) Mostrar el cuadro de diálogo AWS Cloud9 Installer(Instalador de AWS Cloud9).

Colaborar Mostrar la ventana Collaborate (Colaborar) uocultarla si se muestra

138

AWS Cloud9 Guía del usuarioMenú Window (Ventana)


Outline (Esquema) Mostrar la ventana Outline (Esquema) u ocultarla sise muestra.

AWS Resources (Recursos de AWS) Mostrar la ventana AWS Resources (Recursos deAWS) u ocultarla si se muestra

Entorno Mostrar la ventana Environment (Entorno) uocultarla si se muestra.

Debugger (Depurador) Mostrar la ventana Debugger (Depurador) uocultarla si se muestra.

Navigation, Tab to the Right (Navegación, Pestañaa la derecha)

Ir una pestaña a la derecha.

Navigation, Tab to the Left (Navegación, Pestaña ala izquierda)

Ir una pestaña a la izquierda.

Navigation, Next Tab in History (Navegación,Siguiente pestaña en el historial)

Ir a la siguiente pestaña.

Navigation, Previous Tab in History (Navegación,Pestaña anterior en el historial)

Ir a la pestaña anterior.

Navigation, Move Tab to Right (Navegación, Moverpestaña a la derecha)

Mueve la pestaña actual a la derecha. Si lapestaña ya está en la parte derecha, crea allí unapestaña de división.

Navigation, Move Tab to Left (Navegación, Moverpestaña a la izquierda)

Mueve la pestaña actual a la izquierda. Si lapestaña ya está en la parte izquierda, crea allí unapestaña de división.

Navigation, Move Tab to Up (Navegación, Moverpestaña a la izquierda)

Mueve la pestaña actual un panel hacia arriba. Sila pestaña ya está en la parte superior, crea allíuna pestaña de división.

Navigation, Move Tab to Down (Navegación,Mover pestaña hacia abajo)

Mueve la pestaña actual un panel hacia abajo. Sila pestaña ya está en la parte inferior, crea allí unapestaña de división.

Navigation, Go to Pane to Right (Navegación, Ir unpanel a la derecha)

Ir un panel a la derecha.

Navigation, Go to Pane to Left (Navegación, Ir unpanel a la izquierda)

Ir un panel a la izquierda.

Navigation, Go to Pane to Up (Navegación, Ir unpanel hacia arriba)

Ir un panel hacia arriba.

Navigation, Go to Pane to Down (Navegación, Ir unpanel hacia abajo)

Bajar un panel.

Navigation, Switch Between Editor and Terminal(Navegación, Cambiar entre editor y terminal)

Cambiar entre el editor y la pestaña Terminal.

Navigation, Next Pane in History (Navegación,Siguiente panel en el historial)

Ir al siguiente panel.

139

AWS Cloud9 Guía del usuarioMenú Support (Soporte)


Navigation, Previous Pane in History (Navegación,Panel anterior en el historial)

Ir al panel anterior.

Saved Layouts, Save (Diseños guardados,Guardar)

Guardar el diseño actual. Para cambiar a estediseño más tarde, elija Saved Layouts, LAYOUT-ID.

Saved Layouts, Save and Close All (Diseñosguardados, Guardar y cerrar todo)

Guarda el diseño actual y, a continuación, cierratodas las pestañas y paneles.

Saved Layouts, Show Saved Layouts in File Tree(Diseños guardados, Mostrar diseños guardadosen árbol de archivos)

Mostrar todos los diseños guardados en la ventanaEnvironment (Entorno).

Tabs, Close Pane (Pestañas, Cerrar panel) Cerrar el panel actual.

Tabs, Close All Tabs In All Panes (Pestañas,Cerrar todas las pestañas en todos los paneles)

Cerrar todas las pestañas abiertas en todos lospaneles.

Tabs, Close All But Current Tab (Pestañas, Cerrartodas las pestañas menos la actual)

Cerrar todas las pestañas abiertas en el panelactual, excepto la pestaña actual.

Tabs, Split Pane in Two Rows (Pestañas, Dividirpanel en dos filas)

Divide el panel actual en dos, superior e inferior.

Tabs, Split Pane in Two Columns (Pestañas, Dividirpanel en dos columnas)

Divide el panel actual en dos, izquierda y derecha.

Presets, Full IDE (Preestablecidos, IDE completo) Cambia al modo IDE completo.

Presets, Minimal Editor (Preestablecidos, Editormínimo)

Cambia al modo de editor mínimo.

Presets, Sublime Mode (Preestablecidos, ModoSublime)

Cambia al modo Sublime.

Menú Support (Soporte)


Welcome Page (Página de bienvenida) Abre la pestaña Welcome (Bienvenida).

Get Help (Community) [Obtener ayuda(Comunidad)]

Abre el sitio web de la comunidad en línea de AWSCloud9 en una nueva pestaña del navegador web.

Read Documentation (Leer documentación) Abre la Guía de usuario de AWS Cloud9 en unanueva pestaña del navegador web.

140

AWS Cloud9 Guía del usuarioMenú Preview (Vista previa)

Menú Preview (Vista previa)


Preview File (Vista previa de archivo) Mostrar una vista previa del documento actual enuna pestaña de vista previa.

Preview Running Application (Vista previa deaplicación en ejecución)

Mostrar la vista previa de la aplicación en unapestaña independiente del navegador web.

Configure Preview URL (Configurar URL de vistaprevia)

Abrir la sección Project Settings (Configuración delproyecto) de la pestaña Preferences (Preferencias)en el cuadro Run & Debug, Preview URL (Ejecutary depurar, URL vista previa).

Show Active Servers (Mostrar servidores activos) Mostrar una lista de direcciones de servidoresactivos disponibles en el cuadro de diálogoProcess List (Lista de procesos).

Otros comandos de la barra de menús


Ejecute Ejecutar o depurar la aplicación actual.

Share Abre el cuadro de diálogo Share this environment(Compartir este entorno).

Preferences (Preferencias) (icono de engranaje) Abre la pestaña Preferences (Preferencias).

Búsqueda y reemplazo de texto en el AWS Cloud9Integrated Development Environment (IDE)

Puede utilizar la barra de búsqueda y reemplazo del AWS Cloud9 IDE para encontrar y reemplazar textoen un único archivo o en varios archivos.

• Búsqueda de texto en un único archivo (p. 141)• Reemplazo de texto en un único archivo (p. 142)• Búsqueda de texto en varios archivos (p. 142)• Reemplazo de texto en varios archivos (p. 143)• Opciones de búsqueda y reemplazo (p. 144)

Búsqueda de texto en un único archivo1. Abra el archivo en el que desea encontrar texto. Si el archivo ya está abierto, elija la pestaña del archivo

para activarlo.2. En la barra de menús, elija Find, Find (Buscar, Buscar).

141

AWS Cloud9 Guía del usuarioReemplazo de texto en un único archivo

3. En la barra de búsqueda y reemplazo, en Find (Buscar), escriba el texto que desea encontrar.4. Para especificar opciones de búsqueda adicionales, consulte Opciones de búsqueda y

reemplazo (p. 144).5. Si hay coincidencias, el valor 0 of 0 (0 de 0) en el cuadro Find (Buscar) cambiará a un número distinto

de cero. En tal caso, el editor se dirige a la primera coincidencia. En caso de que haya más de unacoincidencia, para pasar a la siguiente, elija la flecha derecha del cuadro Find (Buscar) o elija Find,Find Next (Buscar, Buscar siguiente) en la barra de menús. Para pasar a la coincidencia anterior, elijala flecha izquierda del cuadro Find (Buscar) o elija Find, Find Previous (Buscar, Buscar anterior) en labarra de menús.

Reemplazo de texto en un único archivo1. Abra el archivo en el que desea reemplazar texto. Si el archivo ya está abierto, elija la pestaña del

archivo para activarlo.2. En la barra de menús, elija Find, Replace (Buscar, Reemplazar).3. En la barra de búsqueda y reemplazo, en Find (Buscar), escriba el texto que desea encontrar.4. En Replace With (Reemplazar por), escriba el texto por el que desea reemplazar el texto de Find

(Buscar).5. Para especificar opciones de búsqueda y reemplazo adicionales, consulte la sección Opciones de

búsqueda y reemplazo (p. 144).6. Si hay coincidencias, el valor 0 of 0 (0 de 0) en el cuadro Find (Buscar) cambiará a un número distinto

de cero. En tal caso, el editor se dirige a la primera coincidencia. En caso de que haya más de unacoincidencia, para pasar a la siguiente, elija la flecha derecha del cuadro Find (Buscar) o elija Find,Find Next (Buscar, Buscar siguiente) en la barra de menús. Para pasar a la coincidencia anterior, elijala flecha izquierda del cuadro Find (Buscar) o elija Find, Find Previous (Buscar, Buscar anterior) en labarra de menús.

7. Para reemplazar la coincidencia actual con el texto de Replace With (Reemplazar por) y, a continuación,pasar a la siguiente coincidencia, elija Replace (Reemplazar). Para reemplazar todas las coincidenciascon el texto de Replace With (Reemplazar por), elija Replace All (Reemplazar todo).

Búsqueda de texto en varios archivos1. En la barra de menús, elija Find, Find in Files (Buscar, Buscar en archivos).2. En la barra de búsqueda y reemplazo, en Find (Buscar), escriba el texto que desea encontrar.3. Para especificar opciones de búsqueda adicionales, consulte Opciones de búsqueda y

reemplazo (p. 144).4. En el cuadro que aparece a la derecha del botón Find (Buscar) (el cuadro con *.*, -.*), escriba

cualquier conjunto de archivos para incluirlos o excluirlos de la búsqueda. Por ejemplo:• En blanco * o *.*: buscar todos los archivos.• my-file.txt: buscar solo el archivo llamado my-file.txt.• my*: buscar solo los archivos con nombres de archivo que comiencen por my.• my*.txt: buscar solo los archivos cuyos nombres comiencen por my y que tengan la extensión de

archivo .txt.• my*.htm*: buscar solo los archivos cuyos nombres comiencen por my y que tengan una extensión de

archivo que comience por .htm.• my*.htm, my*.html: buscar los archivos cuyos nombres comiencen por my y que tengan una

extensión de archivo .htm o .html.• -my-file.txt: no buscar el archivo llamado my-file.txt.• -my*: no buscar los archivos que comiencen por my.

142

AWS Cloud9 Guía del usuarioReemplazo de texto en varios archivos

• -my*.htm*: no buscar los archivos cuyos nombres comiencen por my y que tengan una extensión dearchivo que comience por .htm.

• my*.htm*, -my*.html: buscar todos los archivos cuyos nombres comiencen por my y que tenganuna extensión de archivo que comience por .htm. Pero no buscar los archivos cuyos nombrescomiencen por my y que tengan una extensión de archivo que comience por .html.

5. En la lista desplegable que aparece junto a la casilla anterior, seleccione una de las siguientes opcionespara restringir aún más la búsqueda solo a ubicaciones específicas:• Environment (Entorno): buscar solo archivos en la ventana Environment (Entorno).• Project (excludes .gitignore'd) [Proyecto (se excluye .gitignore'd)]: buscar cualquier archivo del

entorno, excepto los archivos o tipos de archivo que se incluyen en el archivo .gitignore delentorno, si existiese un archivo .gitignore.

• Selection (Selección): buscar solo los archivos que se haya seleccionado actualmente en la ventanaEnvironment (Entorno).

Note

Para restringir aún más la búsqueda a solo una sola carpeta, elija una carpeta en la ventanaEnvironment (Entorno) y, a continuación, elija Selection (Selección). También puede hacerclic con el botón derecho del ratón en la ventana Environment (Entorno) y, a continuación,elegir Search In This Folder (Buscar en esta carpeta) en el menú contextual.

• Favorites (Favoritos): buscar solo archivos en la lista Favorites (Favoritos) de la ventana Environment(Entorno).

• Active File (Archivo activo): buscar solo el archivo activo.• Open Files (Archivos abiertos): buscar solo archivos en la lista Open Files (Archivos abiertos) de la

ventana Environment (Entorno).6. Elija Find (Buscar).7. Para ir a un archivo que contenga coincidencias, haga doble clic en el nombre de archivo en la pestaña

Search Results (Resultados de búsqueda). Para ir a una coincidencia específica, haga doble clic en lacoincidencia que desee de la pestaña Search Results (Resultados de búsqueda).

Reemplazo de texto en varios archivos1. En la barra de menús, elija Find, Find in Files (Buscar, Buscar en archivos).2. En la barra de búsqueda y reemplazo, en Find (Buscar), escriba el texto que desea encontrar.3. Para especificar opciones de búsqueda adicionales, consulte Opciones de búsqueda y

reemplazo (p. 144).4. En el cuadro que aparece a la derecha del botón Find (Buscar) (el cuadro con *.*, -.*), escriba

cualquier conjunto de archivos para incluirlos o excluirlos de la búsqueda. Por ejemplo:• En blanco * o *.*: todos los archivos.• my-file.txt: solo el archivo llamado my-file.txt.• my*: solo los archivos cuyos nombres comiencen por my.• my*.txt: solo los archivos cuyos nombres comiencen por my y que tengan la extensión de archivo.txt.

• my*.htm*: todos los archivos cuyos nombres comiencen por my y que tengan una extensión dearchivo que comience por .htm.

• my*.htm, my*.html: todos los archivos cuyos nombres comiencen por my y que tengan unaextensión de archivo .htm o .html.

• -my-file.txt: no buscar el archivo llamado my-file.txt.• -my*: no buscar los archivos que comiencen por my.

143

AWS Cloud9 Guía del usuarioOpciones de búsqueda y reemplazo

• -my*.htm*: no buscar los archivos cuyos nombres comiencen por my y que tengan una extensión dearchivo que comience por .htm.

• my*.htm*, -my*.html: buscar todos los archivos cuyos nombres comiencen por my y que tenganuna extensión de archivo que comience por .htm. Pero no buscar los archivos cuyos nombrescomiencen por my y que tengan una extensión de archivo que comience por .html.

5. En la lista desplegable que aparece junto a la casilla anterior, seleccione una de las siguientes opcionespara restringir aún más la búsqueda solo a ubicaciones específicas:• Environment (Entorno): solo archivos en la ventana Environment (Entorno).• Project (excludes .gitignore'd) [Proyecto (se excluye .gitignore'd)]: cualquier archivo del entorno,

excepto los archivos o tipos de archivo que se incluyen en el archivo .gitignore del entorno, siexistiese un archivo .gitignore.

• Selection:/ (Selección:/): solo los archivos que estén seleccionados actualmente.• Favorites (Favoritos): solo los archivos de la lista Favorites (Favoritos) de la ventana Environment

(Entorno).• Active File (Archivo activo): solo el archivo activo.• Open Files (Archivos abiertos): solo los archivos de la lista Open Files (Archivos abiertos) en la

ventana Environment (Entorno).6. En Replace With (Reemplazar por), escriba el texto por el que desea reemplazar el texto de Find

(Buscar).7. Elija Replace (Reemplazar).

Note

La operación de reemplazo se realiza inmediatamente en todos los archivos dentro del ámbito.Esta operación no se puede deshacer fácilmente. Si desea ver qué se va a modificar antes decomenzar la operación de reemplazo, elija Find (Buscar).

8. Para ir a un archivo que contenga reemplazos, haga doble clic en el nombre de archivo en la pestañaSearch Results (Resultados de búsqueda). Para ir a un reemplazo específico, haga doble clic en elreemplazo que desee en la pestaña Search Results (Resultados de búsqueda).

Opciones de búsqueda y reemplazoElija cualquiera de los siguientes botones de la barra de búsqueda y reemplazo para modificar lasoperaciones de búsqueda y reemplazo.

• Regular Expressions (Expresiones regulares): buscar texto que coincide con la expresión regularespecificada en Find (Buscar) o Find in Files (Buscar en archivos). Consulte Escribiendo un patrón deexpresión regular en tema Expresiones regulares de JavaScript en Mozilla Developer Network.

144

https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Regular_Expressions#Writing_a_regular_expression_pattern


AWS Cloud9 Guía del usuarioVista previa de archivos

• Match Case (Coincidir mayúsculas y minúsculas): buscar texto que coincide con el uso de mayúsculas yminúsculas especificado en Find (Buscar) o Find in Files (Buscar en archivos).

• Whole Words (Palabras completas): utilizar las reglas de carácter de palabra estándar para buscar textoen Find (Buscar) o Find in Files (Buscar en archivos).

• Wrap Around (Ajuste automático): solo para un único archivo, no parar al final o al comienzo del archivoal pasar a la coincidencia siguiente o anterior.

• Search Selection (Buscar en la selección): solo para un único archivo, buscar únicamente en laselección.

• Show in Console (Mostrar en la consola): para varios archivos, mostrar la pestaña Search Results(Resultados de búsqueda) en Console (Consola) en lugar del panel activo.

• Preserve Case (Conservar mayúsculas y minúsculas): solo para un único archivo, conservar el uso demayúsculas y minúsculas según corresponda al reemplazar el texto.

Vista previa de archivos en AWS Cloud9 IntegratedDevelopment Environment (IDE)

Puede utilizar el AWS Cloud9 IDE para obtener una vista previa de los archivos en un entorno dedesarrollo de AWS Cloud9 desde el IDE.

• Abrir un archivo para vista previa (p. 145)• Volver a cargar la vista previa de un archivo (p. 146)• Cambiar el tipo de vista previa del archivo (p. 146)• Abrir una vista previa de un archivo en una pestaña independiente del navegador web (p. 146)• Cambiar a una vista previa de archivo distinta (p. 147)

Abrir un archivo para vista previaLleve a cabo una de las siguientes operaciones en el AWS Cloud9 IDE para abrir una pestaña de vistaprevia de un archivo en entorno:

• En la ventana Environment (Entorno), haga clic con el botón derecho en el archivo del que deseaobtener una vista previa y, a continuación, elija Preview (Vista previa).

Note

Aunque puede emplear este enfoque para obtener una vista previa de cualquier archivo,funciona mejor con los archivos que tienen las siguientes extensiones de archivo:• .htm

• .html

• .pdf

• .svg

• .xhtml

• Cualquier archivo que tenga contenido en formato Markdown.• Abra un archivo con una de las siguientes extensiones de archivo:

• .pdf

• .svg

• Con el archivo del que desea obtener una vista previa ya abierto y activo, en la barra de menús, elijaPreview, Preview File FILE_NAME (Vista previa, Vista previa de archivo, NOMBRE_ARCHIVO). O bien,

145

AWS Cloud9 Guía del usuarioVolver a cargar la vista previa de un archivo

seleccione Tools, Preview, Preview File FILE_NAME, donde FILE_NAME es el nombre del archivo delque desea obtener una vista previa.

Note

Estos comandos funcionan solo con los siguientes tipos de archivo:• .htm

• .html

• .markdown

• .md

• .pdf

• .svg

• .txt: la vista previa funciona mejor si el contenido del archivo está en formato Markdown.• .xhtml: la vista previa funciona mejor si el archivo contiene o hace referencia a información

de presentación de contenido.

Note

El menú Preview Settings (Configuración de vista previa) de la pestaña de vista previa de archivosno está operativo y elegir cualquiera de sus comandos de menú no tendrá ningún efecto.

Volver a cargar la vista previa de un archivoEn la pestaña de vista previa de archivos, elija el botón Refresh (Actualizar) (flecha circular).

Cambiar el tipo de vista previa del archivoEn la pestaña de vista previa de archivos, elija una de las siguientes opciones en la lista de tipos de vistaprevia:

• Browser (Navegador): muestra la vista previa del archivo en un formato de navegador web, solo para lossiguientes tipos de archivo:• .htm

• .html

• .pdf

• .svg

• .xhtml: la vista previa funciona mejor si el archivo contiene o hace referencia a información depresentación de contenido.

• Raw Content (UTF-8) (Contenido raw (UTF-8): muestra la vista previa del contenido del archivo originalen Formato de Transformación Unicode de 8 bits (UTF-8). Esto puede mostrar contenido inesperadopara algunos tipos de archivos.

• Markdown (Marcado): muestra la vista previa de cualquier archivo con formato Markdown. Los intentosde obtener una vista previa de cualquier otro tipo de archivo pueden mostrar contenido inesperado.

Abrir una vista previa de un archivo en una pestañaindependiente del navegador webEn la pestaña de vista previa de archivos, elija Pop Out Into New Window (Mostrar en nueva ventana).

146

AWS Cloud9 Guía del usuarioCambiar a una vista previa de archivo distinta

Cambiar a una vista previa de archivo distintaEn la pestaña de vista previa de archivos, escriba la ruta de una ruta de archivo diferente en la barra dedirecciones. La barra de dirección se encuentra entre el botón Refresh (Actualizar) y la lista de tipos devista previa.

Vista previa de aplicaciones en ejecución en elAWS Cloud9 Integrated Development Environment(IDE)

Puede utilizar el AWS Cloud9 IDE para obtener una vista previa de una aplicación en ejecución desde elIDE.

Temas• Ejecutar una aplicación (p. 147)• Vista previa de una aplicación en ejecución (p. 148)• Volver a cargar la vista previa de una aplicación (p. 149)• Cambiar el tipo de vista previa de la aplicación (p. 149)• Abrir la vista previa de una aplicación en una pestaña independiente del navegador web (p. 150)• Cambiar a una URL de vista previa distinta (p. 150)• Compartir una aplicación en ejecución a través de Internet (p. 150)

Ejecutar una aplicaciónPara poder ver la vista previa de una aplicación desde el IDE, debe estar ejecutándose en el entorno dedesarrollo de AWS Cloud9 usando HTTP en los puertos 8080, 8081 o 8082 con dirección IP 127.0.0.1,localhost o 0.0.0.0.

Note

No es necesario ejecutar con HTTP a través de los puertos 8080, 8081 o 8082 con dirección IPde 127.0.0.1, localhost o 0.0.0.0. Sin embargo, no tendrá una vista previa de la aplicaciónen ejecución desde el IDE.Si ejecuta con la IP 0.0.0.0, cualquiera puede potencialmente tener acceso a la aplicación enejecución. Para ver posibles soluciones a este problema, consulte lo siguiente:

• Paso 2: configurar el grupo de seguridad para la instancia (p. 151), en Compartir unaaplicación en ejecución a través de Internet

• Paso 3: configurar la subred para la instancia (p. 152), en Compartir una aplicación enejecución a través de Internet

Para escribir código para ejecutar la aplicación en un puerto e IP específicos, consulte la documentaciónde la aplicación.

Para ejecutar su aplicación, consulte Run Your Code (p. 159).

Para probar este comportamiento, podría agregar, por ejemplo, el siguiente código de JavaScript a unarchivo con un nombre como server.js en la raíz de su entorno. Este código ejecuta un servidormediante Node.js, como se indica a continuación.

147

AWS Cloud9 Guía del usuarioVista previa de una aplicación en ejecución

var http = require('http');var fs = require('fs');var url = require('url');

http.createServer( function (request, response) { var pathname = url.parse(request.url).pathname; console.log("Trying to find '" + pathname.substr(1) + "'...");

fs.readFile(pathname.substr(1), function (err, data) { if (err) { response.writeHead(404, {'Content-Type': 'text/html'}); response.write("ERROR: Cannot find '" + pathname.substr(1) + "'."); console.log("ERROR: Cannot find '" + pathname.substr(1) + "'."); } else { console.log("Found '" + pathname.substr(1) + "'."); response.writeHead(200, {'Content-Type': 'text/html'}); response.write(data.toString()); } response.end(); });}).listen(8080, 'localhost'); // Or 8081 or 8082 instead of 8080. Or '127.0.0.1' instead of 'localhost'.

O bien, podría agregar, por ejemplo, el siguiente código de Python a un archivo con un nombre comoserver.py en la raíz de su entorno. Este código ejecuta un servidor mediante Python, como se indica acontinuación.

import osimport SimpleHTTPServerimport SocketServer

ip = 'localhost' # Or '127.0.0.1' instead of 'localhost'.port = '8080' # Or '8081' or '8082' instead of '8080'.Handler = SimpleHTTPServer.SimpleHTTPRequestHandlerhttpd = SocketServer.TCPServer((ip, int(port)), Handler)httpd.serve_forever()

Después, agregue el siguiente código HTML a un archivo con un nombre como index.html en la raíz desu entorno.

<html> <head> <title>Hello Home Page</title> </head> <body> <p style="font-family:Arial;color:blue">Hello, World!</p> </body></html>

Para ver la salida HTML de este archivo en la pestaña de vista previa de la aplicación, ejecute server.jscon el archivo Node.js o server.py con Python. A continuación, siga las instrucciones del siguienteprocedimiento para obtener una vista previa. En la pestaña de vista previa de la aplicación, añada /index.html al final de la URL y, a continuación, pulse Enter.

Vista previa de una aplicación en ejecuciónCon la aplicación en ejecución utilizando HTTP a través de los puertos 8080, 8081 o 8082 conla IP 127.0.0.1, localhost o 0.0.0.0 en el entorno y con archivo de código de la aplicacióncorrespondiente abierto y activo en el AWS Cloud9 IDE, seleccione una de las siguientes opciones en labarra de menús:

148

AWS Cloud9 Guía del usuarioVolver a cargar la vista previa de una aplicación

• Preview, Preview Running Application (Vista previa, Vista previa de una aplicación en ejecución)• Tools, Preview, Preview Running Application (Herramientas, Vista previa, Vista previa de una aplicación

en ejecución)

Esto abre una aplicación dentro de la pestaña de vista previa del entorno y, a continuación, muestra elresultado de la aplicación en la pestaña.

Si la pestaña de vista previa de la aplicación muestra un error o está en blanco, pruebe los siguientespasos de solución de problemas La pestaña de vista previa de la aplicación muestra un mensaje de error oestá en blanco (p. 560).

Para permitir que otras personas obtengan una vista previa de la aplicación en ejecución fuera del IDE,consulte Compartir una aplicación en ejecución a través de Internet (p. 150).

Note

Si la aplicación aún no está en ejecución, verá un error en la pestaña de vista previa. Ejecute oreinicie la aplicación y, a continuación, seleccione el comando de la barra de menús de nuevo.Si la aplicación no se puede ejecutar en cualquiera de los puertos o direcciones IP anteriores, osi la aplicación debe ejecutarse en más de uno de estos puertos al mismo tiempo (por ejemplo,su aplicación debe ejecutarse en los puertos 8080 y 3000 al mismo tiempo), la pestaña de vistaprevia puede mostrar un error o estar en blanco. Esto se debe a que la pestaña de vista previa dela aplicación dentro del entorno solo funciona con los puertos y direcciones IP anteriores. Además,funciona con un solo puerto a la vez.No recomendamos compartir la URL en la pestaña de vista previa dela aplicación con otros usuarios. (La URL se muestra con el formatohttps://12a34567b8cd9012345ef67abcd890e1.vfs.cloud9.us-east-2.amazonaws.com/, donde 12a34567b8cd9012345ef67abcd890e1 es el ID queAWS Cloud9 asigna al entorno y us-east-2 es el ID de la región de AWS para el entorno). EstaURL solo funciona cuando el IDE del entorno está abierto y la aplicación se está ejecutando en elmismo navegador web.Si intenta ir a la IP de 127.0.0.1, localhost o 0.0.0.0 usando la pestaña de vista previade la aplicación en el IDE o en una pestaña independiente del navegador web fuera del IDE, elcomportamiento incorporado predeterminado de AWS Cloud9 IDE es que intentará ir a su equipolocal, en lugar de intentar ir a la instancia o a su propio servidor que está conectado a entorno.

Volver a cargar la vista previa de una aplicaciónEn la pestaña de vista previa de la aplicación, elija el botón Refresh (Actualizar) (flecha circular).

Note

Este comando no reinicia el servidor. Simplemente actualiza el contenido de la aplicación en lapestaña de vista previa.

Cambiar el tipo de vista previa de la aplicaciónEn la pestaña de vista previa de la aplicación, elija una de las siguientes opciones en la lista de tipos devista previa:

• Browser (Navegador): ofrece la vista previa del resultado en un formato de navegador web.• Raw Content (UTF-8) (Contenido raw ([UTF-8]): intenta obtener una vista previa del resultado en

Formato de Transformación Unicode de 8 bits (UTF-8), si procede.• Markdown (Marcado): intenta obtener una vista previa del resultado con formato de marcado, si procede.

149

AWS Cloud9 Guía del usuarioAbrir la vista previa de una aplicación en unapestaña independiente del navegador web

Abrir la vista previa de una aplicación en una pestañaindependiente del navegador webEn la pestaña de vista previa de la aplicación, elija Pop Out Into New Window (Mostrar en nueva ventana).

Note

La vista previa de la aplicación no se mostrará en una nueva pestaña del navegador salvo si elAWS Cloud9 IDE también se ejecuta en otra pestaña, por lo menos, del mismo navegador.

Cambiar a una URL de vista previa distintaEn la pestaña de vista previa de la aplicación, escriba la ruta de una URL diferente en la barra dedirecciones. La barra de dirección se encuentra entre el botón Refresh (Actualizar) y la lista de tipos devista previa.

Compartir una aplicación en ejecución a través deInternetTras obtener una vista previa de la aplicación en ejecución, puede ponerla a disposición de otros usuariosa través de Internet.

Para ello, si tiene una instancia Amazon EC2 conectada a su entorno, siga los pasos que se indican acontinuación. De lo contrario, consulte la documentación de su servidor.

Temas• Paso 1: obtener la dirección IP y el ID de la instancia (p. 150)• Paso 2: configurar el grupo de seguridad para la instancia (p. 151)• Paso 3: configurar la subred para la instancia (p. 152)• Paso 4: cambiar la IP de la aplicación en ejecución (p. 153)• Paso 5: compartir la URL de la aplicación en ejecución (p. 154)

Paso 1: obtener la dirección IP y el ID de la instanciaEn este paso, anote el ID de instancia y la dirección IP pública de la instancia Amazon EC2 que estéconectada a entorno. Necesitará el ID de la instancia en un paso posterior para permitir solicitudes deaplicaciones entrantes. A continuación, puede dar la dirección IP pública a otros usuarios para queobtengan acceso a la aplicación en ejecución.

1. Obtenga el ID de la instancia Amazon EC2. Para ello, siga uno de estos pasos:

• En una sesión de terminal en el AWS Cloud9 IDE del entorno, ejecute el siguiente comando paraobtener el ID de la instancia Amazon EC2.

curl http://169.254.169.254/latest/meta-data/instance-id

El ID de la instancia tendrá un aspecto similar al siguiente: i-12a3b456c789d0123. Anote el ID deesta instancia.

• En el IDE del entorno, en la barra de menús, elija el icono de usuario y elija Manage EC2 Instance(Administrar instancia EC2).

150

AWS Cloud9 Guía del usuarioCompartir una aplicación en ejecución a través de Internet

En la consola de Amazon EC2 que se muestra, anote el ID de la instancia que aparece en lacolumna Instance ID (ID de instancia). El ID de la instancia tendrá un aspecto similar al siguiente:i-12a3b456c789d0123.

2. Obtenga la dirección IP pública de la instancia Amazon EC2. Para ello, siga uno de estos pasos:

• En el IDE para el entorno, en la barra de menús, elija Share (Compartir). En el cuadro de diálogoShare this environment (Compartir este entorno), anote la dirección IP pública del cuadro Application(Aplicación). La dirección IP pública tendrá un aspecto similar al siguiente: 192.0.2.0.

• En una sesión de terminal en el IDE del entorno, ejecute el siguiente comando para obtener ladirección IP pública de la instancia Amazon EC2.

curl http://169.254.169.254/latest/meta-data/public-ipv4

La dirección IP pública tendrá un aspecto similar al siguiente: 192.0.2.0. Anote esta dirección IPpública.

• En el IDE del entorno, en la barra de menús, elija el icono de usuario y elija Manage EC2 Instance(Administrar instancia EC2). En la consola de Amazon EC2 que se muestra, en la pestañaDescription (Descripción), anote la dirección IP pública para el campo IPv4 Public IP (IP públicaIPv4). La dirección IP pública tendrá un aspecto similar al siguiente: 192.0.2.0.

Note

La dirección IP pública de la instancia podría cambiar en cualquier momento que la instanciase reinicie. Para evitar que cambie esta dirección IP, una solución es asignar una direcciónIP elástica y asignarla después a la instancia en ejecución. Para obtener instrucciones,consulte Asignación de una dirección IP elástica y Asociación de una dirección IP elásticaa una instancia en ejecución en la Guía del usuario de Amazon EC2 para instancias deLinux. Tenga en cuenta también que la posibilidad de asignar una dirección IP elástica puedesuponer que se hagan cargos en su cuenta de AWS. Para obtener más información, consultePrecios de Amazon EC2.

Paso 2: configurar el grupo de seguridad para la instanciaEn este paso, la consola de Amazon EC2 se utiliza para configurar el grupo de seguridad de Amazon EC2para la instancia que esté conectada al entorno, para permitir la entrada de las solicitudes HTTP a travésde los puertos 8080, 8081 o 8082.

Note

No es necesario ejecutar con HTTP a través de los puertos 8080, 8081 o 8082. Si ejecuta enotro protocolo o puerto, sustitúyalo en todo este paso. No podrá obtener una vista previa dela aplicación en ejecución desde el IDE hasta que vuelva a ejecutar mediante HTTP a travésde uno de los puertos y direcciones IP, como se describe en Vista previa de una aplicación enejecución (p. 148).Para tener una capa adicional de seguridad, puede configurar una lista de control de acceso(ACL) de red para una subred de una nube privada virtual (VPC) que la instancia pueda utilizar.

151

https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/elastic-ip-addresses-eip.html#using-instance-addressing-eips-allocating

https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/elastic-ip-addresses-eip.html#using-instance-addressing-eips-associating




Para obtener más información acerca de los grupos de seguridad y las ACL de red, consulte losiguiente:

• Paso 3: configurar la subred para la instancia (p. 152)• Seguridad en la Guía del usuario de Amazon VPC• Grupos de seguridad de su VPC en la Guía del usuario de Amazon VPC• ACL de red en la Guía del usuario de Amazon VPC

1. En el IDE del entorno, en la barra de menús, elija el icono de usuario y elija Manage EC2 Instance(Administrar instancia EC2). A continuación, vaya al paso 3 en este procedimiento.

2. Si la elección de Manage EC2 Instance (Administrar instancia EC2) o de otros pasos de esteprocedimiento da error, recomendamos que inicie sesión en la consola de Amazon EC2 utilizandolas credenciales de un usuario administrador de IAM en su cuenta de AWS y después complete lassiguientes instrucciones. Si no puede hacerlo, consulte con el administrador de su cuenta de AWS.

a. Inicie sesión en la Consola de administración de AWS, si todavía no lo ha hecho, en https://console.aws.amazon.com.

b. Abra la consola de Amazon EC2. Para ello, en la barra de navegación de AWS, elija Services(Servicios). A continuación, elija EC2.

c. En la barra de navegación de AWS, seleccione la región de AWS en la que se encuentra elentorno.

d. Si se muestra EC2 Dashboard (Panel de EC2), elija Running Instances (Ejecutar instancias).También puede en el panel de navegación del servicio, expandir Instances (Instancias) si aún noestá ampliado y elegir Instances (Instancias).

e. En la lista de instancias, seleccione la instancia cuyo Instance ID (ID de instancia) coincida con elID de instancia que anotó anteriormente.

3. En la pestaña Description (Descripción) de la instancia, elija el vínculo del grupo de seguridad junto aSecurity groups (Grupos de seguridad).

4. Con el grupo de seguridad a la vista, busque en la pestaña Inbound (Entrada). Si ya existe una regladonde Type (Tipo) se establece en Custom TCP Rule (Regla de TCP personalizada) y Port Range(Rango de puerto) en 8080, 8081 u 8082, elija Cancel (Cancelar) y vaya al Paso 3: configurar lasubred para la instancia (p. 152). De lo contrario, seleccione Edit (Editar).

5. En el cuadro de diálogo Edit inbound rules (Modificar reglas de entrada), elija Add tag (Agregaretiqueta).

6. En Type, elija Custom TCP Rule.7. En Port Range (Rango de puerto), escriba 8080, 8081 o 8082.8. En Source (Fuente), elija Anywhere (Cualquiera).

Note

La elección de Anywhere (Cualquiera) en Source (Fuente) permite las solicitudes entrantesdesde cualquier dirección IP. Para restringirlo a determinadas direcciones IP, seleccioneCustom (Personalizado) y, a continuación, escriba el rango de direcciones IP o elija My IP (MiIP) para restringirlo a las solicitudes de la dirección IP únicamente

9. Seleccione Save.

Paso 3: configurar la subred para la instanciaEn este paso, las consolas de Amazon EC2 y Amazon Virtual Private Cloud (Amazon VPC) se utilizanpara configurar la subred de Amazon EC2 para la instancia que esté conectada al entorno, para permitirtambién la entrada de las solicitudes HTTP a través de los puertos 8080, 8081 o 8082.

152

https://docs.aws.amazon.com/vpc/latest/userguide/VPC_Security.html

https://docs.aws.amazon.com/vpc/latest/userguide/VPC_SecurityGroups.html

https://docs.aws.amazon.com/vpc/latest/userguide/VPC_ACLs.html




Note

No es necesario ejecutar con HTTP a través de los puertos 8080, 8081 o 8082. Si ejecutaen otro protocolo o puerto, sustitúyalo en todo este paso. No podrá obtener una vista previade la aplicación en ejecución desde el IDE hasta que vuelva a ejecutar mediante HTTP através de los puertos y direcciones IP, como se describe en Vista previa de una aplicación enejecución (p. 148).En este paso se describe cómo configurar una ACL de red para una subred en una AmazonVPC que la instancia puede utilizar. Este paso no es necesario. Sin embargo, agrega una capade seguridad adicional en comparación con usar solo grupos de seguridad. Para obtener másinformación acerca de las ACL de red, consulte lo siguiente:

• Seguridad en la Guía del usuario de Amazon VPC• ACL de red en la Guía del usuario de Amazon VPC

1. Con la consola de Amazon EC2 ya abierta del paso anterior, en el panel de navegación del servicio,expanda Instances (Instancias) si aún no está ampliado y, a continuación, elija Instances (Instancias).

2. En la lista de instancias, seleccione la instancia cuyo Instance ID (ID de instancia) coincida con el IDde instancia que anotó anteriormente.

3. En la pestaña Description (Descripción) de la instancia, anote el valor de Subnet ID (ID de subred).Debería ser similar a: subnet-1fab8aEX).

4. Abra la consola de Amazon VPC. Para ello, en la barra de navegación de AWS, elija Services(Servicios). A continuación, elija VPC.

En este paso, le recomendamos que inicie sesión en la consola de Amazon VPC con las credencialesde un usuario administrador de IAM en la cuenta de AWS. Si no puede hacerlo, consulte con eladministrador de su cuenta de AWS.

5. Si se muestra VPC Dashboard (Panel de VPC), elija Subnets (Subredes). También puede seleccionarSubnets (Subredes) en el panel de navegación.

6. En la lista de subnets, seleccione la subnets cuyo valor de Subnet ID (ID de subred) coincida con elque anotó anteriormente.

7. En la pestaña Summary (Resumen), elija el enlace ACL de red junto a Network ACL (ACL de red).8. En la lista de ACL de red, seleccione la ACL de red. (Solo hay una ACL de red).9. Busque en la pestaña Inbound Rules (Reglas de entrada) la ACL de red. Si una regla ya existe donde

Type (Tipo) se establece en HTTP* (8080), HTTP* (8081) o HTTP* (8082), continúe en Paso 4:cambiar la IP de la aplicación en ejecución (p. 153). De lo contrario, seleccione Edit (Editar).

10. Elija Add another rule.11. En Rule # (N.º de regla), escriba un número para la regla (por ejemplo, 200).12. En Type, elija Custom TCP Rule.13. En Port Range (Rango de puerto), escriba 8080, 8081 o 8082.14. En Source (Fuente), escriba el rango de las direcciones IP de las que se permitirán solicitudes

entrantes. Por ejemplo, para permitir las solicitudes entrantes de cualquier dirección IP, escriba0.0.0.0/0.

15. Con Allow / Deny (Permitir/Denegar) establecido en ALLOW, elija Save (Guardar).

Paso 4: cambiar la IP de la aplicación en ejecuciónEn el código, pase de usar IP 127.0.0.1, localhost o 0.0.0.0 a utilizar la dirección o direcciones IPque especificó en los pasos anteriores de esta sección. Para utilizar estas nuevas direcciones IP, detengala aplicación si ya se está ejecutando y ejecute la aplicación de nuevo.

153



AWS Cloud9 Guía del usuarioTrabajo con revisiones de archivo

Note

No podrá obtener una vista previa de la aplicación en ejecución desde el IDE hasta que vuelvaa ejecutar mediante HTTP a través de uno de los puertos y direcciones IP, como se describe enVista previa de una aplicación en ejecución (p. 148).

Paso 5: compartir la URL de la aplicación en ejecuciónCon la aplicación en ejecución, de a los otros usuarios la dirección IP pública antes anotada. Asegúrese deiniciar la URL con el protocolo correcto y añada el número de puerto si no es el valor predeterminado deese protocolo (por ejemplo, http://192.0.2.0:8080/index.html usando HTTP a través del puerto8080).

Si la pestaña del navegador web resultante muestra un error o está en blanco, pruebe los siguientes pasosde solución de problemas No se puede mostrar la aplicación en ejecución fuera del IDE (p. 561).

Note

La dirección IP pública de la instancia podría cambiar en cualquier momento que la instanciase reinicie. Para evitar que cambie esta dirección IP, una solución es asignar una dirección IPelástica y asignarla después a la instancia en ejecución. Para obtener instrucciones, consulteAsignación de una dirección IP elástica y Asociación de una dirección IP elástica a una instanciaen ejecución en la Guía del usuario de Amazon EC2 para instancias de Linux. Tenga en cuentatambién que la posibilidad de asignar una dirección IP elástica puede suponer que se hagancargos en su cuenta de AWS. Para obtener más información, consulte la página Precios deAmazon EC2.No es necesario ejecutar con HTTP a través de los puertos 8080, 8081 o 8082. Sin embargo,no podrá obtener una vista previa de la aplicación en ejecución desde el IDE hasta que vuelvaa ejecutar mediante HTTP a través de uno de los puertos y direcciones IP, como se describe enVista previa de una aplicación en ejecución (p. 148).Si los usuarios realizan solicitudes a la URL anterior y dichas solicitudes provienen de una redprivada virtual (VPN) que bloquea el tráfico en el protocolo o el puerto solicitado, esas solicitudespodría dar error. Estos usuarios deben utilizar una red diferente que permita el tráfico a través delprotocolo y el puerto solicitados. Para obtener más información, consulte con el administrador dered.No recomendamos compartir la URL en la pestaña de vista previa de laaplicación en el IDE con otros usuarios. (La URL se muestra con el formatohttps://12a34567b8cd9012345ef67abcd890e1.vfs.cloud9.us-east-2.amazonaws.com/, donde 12a34567b8cd9012345ef67abcd890e1 es el ID queAWS Cloud9 asigna al entorno y us-east-2 es el ID de la región de AWS para el entorno). EstaURL solo funciona cuando el IDE del entorno está abierto y la aplicación se está ejecutando en elmismo navegador web.

Trabajo con revisiones de archivo en el AWSCloud9 Integrated Development Environment (IDE)

Puede utilizar el panel File Revision History (Historial de revisiones de archivo) del AWS Cloud9 IDEpara ver y administrar los cambios realizados en un archivo en un entorno de desarrollo de EC2 de AWSCloud9. El panel File Revision History (Historial de revisiones de archivo) no está disponible para archivosde un entorno de desarrollo de SSH de AWS Cloud9.

154

https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/elastic-ip-addresses-eip.html#using-instance-addressing-eips-allocating





AWS Cloud9 Guía del usuarioTrabajo con revisiones de archivo

Para ver el panel File Revision History (Historial de revisiones de archivo) de un archivo, abra ese archivoen el editor. A continuación, en la barra de menús, elija File, Show File Revision History (Archivo, Verhistorial de revisiones de archivo).

El panel File Revision History (Historial de revisiones de archivo) comienza el seguimiento del historialde revisiones de un archivo en el IDE después de abrir por primera vez el archivo en el editor en unentorno y solo para ese entorno. El panel File Revision History (Historial de revisiones de archivo) realizael seguimiento de las revisiones de un archivo desde el propio editor. No realiza el seguimiento de lasrevisiones de un archivo que se han realizado de cualquier otra forma (por ejemplo por medio del terminal,Git u otras herramientas de revisión de archivo).

No se puede editar un archivo mientras esté abierto el panel File Revision History (Historial de revisionesde archivo). Para ocultar el panel, elija de nuevo File, Show Revision History (Archivo, Mostrar historial derevisiones) o elija la X (Cerrar control deslizante de tiempo) en la esquina del panel.

Para ir a una versión del archivo que esté asociada a una acción de guardado de archivo, elija un puntoFile Saved on (Archivo guardado en) por encima del control deslizante de revisiones.

Para avanzar o retroceder una versión a partir de la versión del archivo seleccionada actualmente en elcontrol deslizante de revisiones, elija una de las flechas de pasos (Step revision forward (Avanzar revisión)o Step revision backward (Retroceder revisión).

155

AWS Cloud9 Guía del usuarioTrabajo con archivos de imagen

Para avanzar automáticamente en las versiones del archivo de una en una desde el principio hasta el finaldel historial de revisiones, seleccione el botón de reproducción (Playback file history (Reproducir historialde archivo)).

Para que la versión del archivo seleccionado actualmente sea la versión más reciente del historial derevisiones, seleccione Revert (Revertir).

Trabajo con archivos de imagen en el AWS Cloud9Integrated Development Environment (IDE)

Puede usar el AWS Cloud9 IDE para ver y editar archivos de imagen.

• Ver o editar una imagen (p. 156)• Cambiar de tamaño una imagen (p. 156)• Recortar una imagen (p. 157)• Rotar una imagen (p. 157)• Invertir una imagen (p. 157)• Acercar o alejar una imagen (p. 157)• Suavizar una imagen (p. 158)

Ver o editar una imagenEn el AWS Cloud9 IDE, abra el archivo de la imagen que desea ver o editar. Estos son los tipos dearchivos de imagen que se admiten:

• .bmp

• .gif (solo visualización)• .ico (solo visualización)• .jpeg

• .jpg

• .png

• .tiff

Cambiar de tamaño una imagen1. Abra el archivo de imagen en el IDE.2. En la barra de edición de imágenes, seleccione Resize (Cambiar tamaño).3. Para cambiar el ancho de la imagen, escriba un nuevo valor de Width (Ancho) en píxeles. O elija "-" o

"+" junto a Width (Ancho) para cambiar el ancho actual de píxel en píxel.4. Para cambiar la altura de la imagen, escriba un nuevo valor de Height (Altura) en píxeles. O elija "-" o

"+" junto a Height (Altura) para cambiar la altura actual de píxel en píxel.

156

AWS Cloud9 Guía del usuarioRecortar una imagen

5. Para mantener la proporción de ancho/altura de la imagen, deje marcado Maintain Aspect Ratio(Mantener relación de aspecto).

6. Para confirmar la nuevo tamaño de la imagen, en la barra de edición de imágenes, observe las medidasdel ancho (W) y la altura (H) en píxeles.

7. Elija Resize (Cambiar tamaño).8. Para descartar el cambio de tamaño, en la barra de menús, elija Edit (Editar), Undo (Deshacer). Para

mantener el nuevo tamaño, elija File (Archivo) y Save (Guardar).

Recortar una imagen1. Abra el archivo de imagen en el IDE.2. Arrastre el puntero del ratón por encima de la parte de la imagen que desea conservar.3. Para confirmar las dimensiones de la selección, en la barra de edición de imágenes, consulte las

dimensiones Selection (Selección), tal y como se indica a continuación:• La distancia en píxeles desde el borde izquierdo de la imagen original al borde izquierdo de la

selección (L)• La distancia en píxeles desde el borde superior de la imagen original al borde superior de la selección

(T)• El ancho de la selección en píxeles (W)• La altura de la selección en píxeles (H)

4. En la barra de edición de imágenes, seleccione Crop (Recortar).5. Para descartar el recorte, en la barra de menús, elija Edit (Editar), Undo (Deshacer). Para mantener la

nueva imagen recortada, elija File (Archivo) y Save (Guardar).

Rotar una imagen1. Abra el archivo de imagen en el IDE.2. Para rotar la imagen hacia la izquierda, en la barra de edición de imágenes, elija Rotate 90 Degrees Left

(Rotar 90 grados a la izquierda).3. Para rotar la imagen hacia la derecha, en la barra de edición de imágenes, elija Rotate 90 Degrees

Right (Rotar 90 grados a la derecha).4. Para descartar la rotación, en la barra de menús, elija Edit (Editar), Undo (Deshacer). Para mantener la

nueva imagen rotada, elija File (Archivo) y Save (Guardar).

Invertir una imagen1. Abra el archivo de imagen en el IDE.2. Para invertir la imagen horizontalmente, en la barra de edición de imágenes, elija FlipH (Invertir H).3. Para invertir la imagen verticalmente, en la barra de edición de imágenes, elija FlipV (Invertir V).4. Para descartar la inversión, en la barra de menús, elija Edit (Editar), Undo (Deshacer). Para mantener la

nueva imagen invertida, elija File (Archivo) y Save (Guardar).

Acercar o alejar una imagen1. Abra el archivo de imagen en el IDE.2. En la barra de edición de imágenes, elija uno de los factores de zoom disponibles (por ejemplo, 75%,

100% o 200%).

157

AWS Cloud9 Guía del usuarioSuavizar una imagen

Suavizar una imagen1. Abra el archivo de imagen en el IDE.2. En la barra de edición de imágenes, seleccione Smooth (Suavizar) para reducir la cantidad de pixelación

de la imagen. Para descartar el suavizado, anule la selección de Smooth (Suavizar).3. En la barra de menús, elija File (Archivo), Save (Guardar).

Trabajo con compiladores, ejecutores ydepuradores en el AWS Cloud9 IntegratedDevelopment Environment (IDE)

Un compilador indica al AWS Cloud9 IDE cómo compilar los archivos de un proyecto. Un ejecutor indicaal AWS Cloud9 IDE cómo ejecutar archivos de un tipo específico. Un ejecutor puede utilizar un depuradorpara ayudar a encontrar cualquier problema en el código fuente de los archivos.

Puede utilizar el AWS Cloud9 IDE para compilar, ejecutar y depurar el código de las siguientes formas:

• Utilice un compilador para compilar los archivos del proyecto. Consulte Compilar los archivos delproyecto (p. 159).

• Utilice a un ejecutor para ejecutar (y, de forma opcional, depurar) el código. Consulte Soporte integradode compilación, ejecución y depuración (p. 158) y Ejecutar el código (p. 159).

• Cambie un ejecutor integrado que ejecute (y, de forma opcional, depure) el código de una formadiferente a la que se ha definido originalmente. Consulte Cambiar un ejecutor integrado (p. 162).

• Utilice un ejecutor que ejecute (y, de forma opcional, depure) el código con una combinaciónpersonalizada de nombre de archivo, opciones de línea de comandos, modo de depuración, directorio detrabajo actual y variables de entorno. Consulte Crear una configuración de ejecución (p. 162).

• Cree su propio compilador o ejecutor. Consulte Crear un compilador o ejecutor (p. 163).

Soporte integrado de compilación, ejecución ydepuraciónEl AWS Cloud9 IDE proporciona soporte integrado para compilar, ejecutar y depurar código en varioslenguajes. Para obtener una lista completa, consulte Lenguajes compatibles (p. 128).

El soporte integrado se encuentra disponible en la barra de menús con los comandos de menú Run(Ejecutar), Build System (Sistema de compilación) y Run (Ejecutar), Build (Compilar). Para añadircompatibilidad con un lenguaje de programación o una herramienta que no se encuentren en la lista,consulte la sección Crear un compilador o ejecutor (p. 163).

El soporte integrado se encuentra disponible con el botón Run (Ejecutar) y en la barra de menús conlos comandos de menú Run (Ejecutar), Run With (Ejecutar con) y Run (Ejecutar), Run Configurations(Configuraciones de ejecución). Para añadir compatibilidad con un lenguaje de programación o unaherramienta que no se encuentren en la lista, consulte Crear un compilador o ejecutor (p. 163) y Crearuna configuración de ejecución (p. 162).

El soporte de depuración integrado se encuentra disponible a través de la ventana Debugger (Depurador).Para ver la ventana Debugger (Depurador), elija el botón Debugger (Depurador). Si el botón Debugger(Depurador) no es visible, elija Window (Ventana), Debugger (Depurador) en la barra de menús.

158

AWS Cloud9 Guía del usuarioCompilar los archivos del proyecto

Compilar los archivos del proyecto1. Abra un archivo que se corresponda con el código que desea compilar.2. En la barra de menús, elija Run, Build System (Ejecutar, Sistema de compilación) y, a continuación, elija

el nombre del compilador que va a utilizar si aún no lo ha elegido. Si el compilador que desea utilizarno se encuentra en la lista, detenga este procedimiento, realice los pasos que se indican en Crear uncompilador o ejecutor (p. 163) y, a continuación, vuelva a este procedimiento.

3. Elija Run, Build (Ejecutar, Compilar).

Ejecutar el código1. Abra un archivo que se corresponda con el código que desea ejecutar, si el archivo aún no está abierto

y seleccionado.2. En la barra de menús, realice una de las siguientes operaciones:

• Para ejecutar el código con el ejecutor integrado de mayor coincidencia, elija Run, Run (Ejecutar,Ejecutar). Si AWS Cloud9 no encuentra ninguno, este comando está deshabilitado.

• Para ejecutar el código con la configuración de ejecución que AWS Cloud9 utilizó por última vez, elijaRun, Run Last (Ejecutar, Ejecutar última).

• Para ejecutar el código con un ejecutor específico, elija Run, Run With (Ejecutar, Ejecutar con) y,a continuación, elija el nombre del ejecutor. Si el ejecutor que desea utilizar no se encuentra enla lista, detenga este procedimiento, realice los pasos que se indican en Crear un compilador oejecutor (p. 163) y, a continuación, vuelva a este procedimiento.

• Para ejecutar el código con un ejecutor específico con una combinación personalizada de nombre dearchivo, opciones de línea de comandos, modo de depuración, directorio de trabajo actual y variablesde entorno, elija Run, Run Configurations (Ejecutar, Configuraciones de ejecución) y, a continuación,elija el nombre de la configuración de ejecución. Si se abre la pestaña de la configuración deejecución, elija Runner: Auto (Ejecutor: Auto), elija el ejecutor que desea utilizar y, a continuación,seleccione Run (Ejecutar). Si el ejecutor que desea utilizar no se encuentra en la lista, detenga esteprocedimiento, realice los pasos que se indican en Crear un compilador o ejecutor (p. 163) y, acontinuación, vuelva a este procedimiento.

Depurar el código1. En la pestaña de configuración de ejecución del código, elija Run in Debug Mode (Ejecutar en modo de

depuración). El icono de error cambia a verde sobre un fondo blanco. Para obtener más información,consulte Ejecutar el código (p. 159) y Crear una configuración de ejecución (p. 162).

2. Establezca los puntos de interrupción en el código que desee para realizar pausas durante la ejecución,tal y como se indica a continuación:a. Abra cada archivo en el que desea establecer un punto de interrupción.b. En cada punto de un archivo en el que desea establecer un punto de interrupción, elija el área en

blanco del margen interior situado a la izquierda del número de línea. Aparece un círculo rojo.

Para eliminar un punto de interrupción, elija el punto de interrupción existente en el margen interior.

Para deshabilitar un punto de interrupción en lugar de eliminarlo, en la ventana Debugger(Depurador), en Breakpoints (Puntos de interrupción), desactive la casilla que se corresponde conpunto de interrupción que desea deshabilitar. Para habilitar el punto de interrupción de nuevo,seleccione la casilla que ha desactivado.

Para deshabilitar todos los puntos de interrupción a la vez, en la ventana Debugger (Depurador),elija Deactivate All Breakpoints (Desactivar todos los puntos de interrupción). Para habilitar de

159

AWS Cloud9 Guía del usuarioDepurar el código

nuevo todos los puntos de interrupción, elija Activate All Breakpoints (Activar todos los puntos deinterrupción).

Si la ventana Debugger (Depurador) no es visible, elija el botón Debugger (Depurador). Si el botónDebugger (Depurador) no es visible, en la barra de menús, elija Window (Ventana), Debugger(Depurador).

3. Establezca cualquier expresión de inspección para la que desea obtener el valor en el punto en que sepone en pausa la ejecución, tal y como se indica a continuación:a. En la ventana Debugger (Depurador), en Watch Expressions (Expresiones de inspección), elija Type

an expression here (Escriba una expresión aquí).b. Escriba la expresión que desea inspeccionar y, a continuación, presione Enter.

Para cambiar una expresión de observación existente, haga clic con el botón derecho del ratón endicha expresión y, a continuación, elija Edit Watch Expression (Editar expresión de inspección).Escriba el cambio y, a continuación, presione Enter.

Para eliminar una expresión de inspección existente, haga clic con el botón derecho del ratónen dicha expresión y, a continuación, elija Remove Watch Expression (Eliminar expresión deinspección).

4. Ejecute el código tal y como se describe en Ejecutar el código (p. 159).

Cada vez que ponga en pausa una ejecución, puede hacer lo siguiente en la ventana Debugger(Depurador), tal y como se muestra.

160

AWS Cloud9 Guía del usuarioDepurar el código

• Ejecute el código hasta el siguiente punto de interrupción (o hasta el siguiente punto de parada lógico sino hay más puntos de interrupción): elija Resume (Reanudar).

• Omita las instrucciones en ejecución una por una hasta la siguiente llamada al método o función: elijaStep Over (Saltar).

• Ejecute el código hasta la siguiente instrucción y vuelva a hacer una pausa: elija Step Into (Paso a paso).• Detenga las instrucciones en ejecución una por una en la llamada al método o función actual: elija Step

Out (Salir).• Deshabilite todos los puntos de interrupción existentes: elija Deactivate All Breakpoints (Desactivar

todos los puntos de interrupción). Habilite de nuevo todos los puntos de interrupción: Elija Activate AllBreakpoints (Activar todos los puntos de interrupción).

161

AWS Cloud9 Guía del usuarioCambiar un ejecutor integrado

• No realice una pausa cuando el código genere una excepción: siga haciendo clic en el botón decomportamiento de las excepciones hasta que la ayuda contextual indique Don't pause on exceptions(No hacer pausa en excepciones) (gris).

• Realice una pausa cuando el código genere una excepción: siga haciendo clic en el botón decomportamiento de las excepciones hasta que la ayuda contextual indique Pause on all exceptions(Hacer pausa en todas las excepciones) (rojo).

• Haga una pausa únicamente cuando el código genere una excepción no detectada: siga haciendo clicen el botón de comportamiento de las excepciones hasta que la ayuda contextual indique Pause onuncaught exceptions (Hacer pausa en excepciones no detectadas) (azul).

• Abra un script disponible: elija Available internal and external scripts (Scripts internos y externosdisponibles) y, a continuación, elija el script.

• Consulte la lista de expresiones de inspección actuales: consulte el área Watch Expressions(Expresiones de inspección).

• Consulte la ruta de ejecución que ha llevado el código hasta el punto de interrupción actual: consulte elárea Call Stack (Pila de llamadas).

• Vea la lista de variables locales: consulte el área Local Variables (Variables locales).• Deshabilite puntos de interrupción individuales: en Breakpoints (Puntos de interrupción), desactive las

casillas correspondientes a los puntos de interrupción que desea deshabilitar. Para habilitar los puntosde interrupción de nuevo, seleccione las casillas que ha desactivado anteriormente.

Cada vez que una ejecución se ponga en pausa, también puede poner en pausa el puntero del ratón sobrecualquier fragmento de código mostrado (por ejemplo, una variable) para ver la información disponiblesobre él en una información sobre herramientas.

Cambiar un ejecutor integrado1. En la barra de menús, elija Run, Run With (Ejecutar, Ejecutar con) y, a continuación, elija el ejecutor

integrado que desea cambiar.2. Para detener el ejecutor para que no intente ejecutar el código, elija Stop (Detener) en la pestaña de

configuración de ejecución que se abre.3. Elija Runner: My Runner (Ejecutor: Mi ejecutor), donde My Runner (Mi ejecutor) es el nombre del

ejecutor que desea cambiar y, a continuación, elija Edit Runner (Editar ejecutor).4. En la pestaña My Runner.run (Mi Runner.run) que se abre, cambie la definición actual del ejecutor.

Consulte Definir un compilador o ejecutor (p. 164).5. Elija File, Save As (Archivo, Guardar como). Guarde el archivo con el mismo nombre (My Runner.run)

en el directorio my-environment/.c9/runners, donde my-environment es el nombre de suentorno de desarrollo de AWS Cloud9.

Note

Los cambios que realice en un ejecutor integrado se aplican únicamente al entorno en el queha realizado esos cambios. Para aplicar los cambios en otro entorno, abra el otro entorno y, acontinuación, siga los pasos anteriores para abrir, editar y guardar esos mismos cambios de eseejecutor integrado.

Crear una configuración de ejecuciónEn la barra de menús, elija Run, Run Configurations, New Run Configuration (Ejecutar, Configuraciones deejecución, Nueva configuración de ejecución). En la pestaña de la configuración de ejecución que se abre,haga lo siguiente:

162

AWS Cloud9 Guía del usuarioCrear un compilador o ejecutor

1. En el cuadro que aparece junto a Run (Ejecutar) y Restart (Reiniciar), escriba el nombre que semostrará en el menú Run, Run Configurations (Ejecutar, Configuraciones de ejecución) para estaconfiguración.

2. En el cuadro Command (Comando), escriba las opciones de línea de comandos personalizadas quedesee utilizar.

3. Para que esta configuración de ejecución utilice la configuración de depuración predefinida del ejecutor,elija Run in Debug Mode (Ejecutar en modo de depuración). El icono de error cambiará a verde sobre unfondo blanco.

4. Para que esta configuración use un directorio de trabajo específico, elija CWD, elija el directorio que seva a usar y, a continuación, elija Select (Seleccionar).

5. Para que esta configuración de ejecución utilice variables de entorno específicas, seleccione ENV y, acontinuación, escriba el nombre y el valor de cada variable de entorno.

Para utilizar esta configuración de ejecución, abra el archivo que se corresponde con el código que deseaejecutar. Elija Run, Run Configurations (Ejecutar, Configuraciones de ejecución) en la barra de menús yluego elija el nombre de esta configuración de ejecución. En la pestaña de la configuración de ejecuciónque se abre, elija Runner: Auto (Ejecutor: Auto), elija el ejecutor que desea utilizar y, a continuación,seleccione Run (Ejecutar).

Note

Cualquier configuración de ejecución que cree se aplica únicamente al entorno en el que creóesa configuración de ejecución. Para añadir esa configuración de ejecución a otro entorno abrael otro entorno y, a continuación, siga los pasos anteriores para crear la misma configuración deejecución en ese entorno.

Crear un compilador o ejecutor1. Para crear un compilador, en la barra de menús, elija Run, Build System, New Build System (Ejecutar,

Sistema de compilación, Nuevo sistema de compilación). Para crear un ejecutor, en la barra de menús,elija Run, Run With, New Runner (Ejecutar, Ejecutar con, Nuevo ejecutor).

2. En la pestaña del compilador (con la etiqueta My Builder.build [Mi Builder.build]) o la pestaña delejecutor (con la etiqueta My Runner.run [Mi Runner.run]) que aparece, defina el compilador o ejecutor.Consulte Definir un compilador o ejecutor (p. 164).

3. Después de definir el compilador o ejecutor, elija File, Save As (Archivo, Guardar como). En el casodel compilador, guarde el archivo con la extensión .build en el directorio my-environment/.c9/builders, donde my-environment es el nombre del entorno. En el caso del ejecutor, guardeel archivo con la extensión .run en el directorio my-environment/.c9/runnders, donde my-environment es el nombre del entorno. El nombre del archivo que especifique será el nombre queaparece en el menú Run, Build System (Ejecutar, Sistema de compilación) o el menú Run, Run With(Ejecutar, Ejecutar con). Por lo tanto, a menos que especifique otro nombre de archivo, de formapredeterminada el nombre de visualización será My Builder (Mi ejecutor) (para un compilador) o MyRunner (Mi ejecutor) (para un ejecutor).

Para utilizar este compilador o ejecutor, consulte Compilar los archivos del proyecto (p. 159) o Ejecutar elcódigo (p. 159).

Note

Cualquier compilador o ejecutor que cree se aplica únicamente al entorno en el que ha creado esecompilador o ejecutor. Para añadir ese compilador o ejecutor a otro entorno abra el otro entornoy, a continuación, siga los pasos anteriores para crear el mismo compilador o ejecutor en eseentorno.

163

AWS Cloud9 Guía del usuarioDefinir un compilador o ejecutor

Definir un compilador o ejecutorEn este procedimiento, se da por hecho que ya ha comenzado a crear un compilador o un ejecutoreligiendo Run, Build System, New Build System (Ejecutar, Sistema de compilación, Nuevo sistema decompilación) (para un compilador) o Run, Run With, New Runner (Ejecutar, Ejecutar con, Nuevo ejecutor)(para un ejecutor).

En la pestaña del compilador o ejecutor que se muestra, utilice JSON para definir el ejecutor o compilador.Comience con el siguiente código como plantilla.

Para un compilador, comience con este código.

{ "cmd": [], "info": "", "env": {}, "selector": ""}

Para un ejecutor, comience con este código.

{ "cmd": [], "script": "", "working_dir": "", "info": "", "env": {}, "selector": "", "debugger": "", "debugport": ""}

En el código anterior:

• cmd: representa una lista separada por comas de cadenas para AWS Cloud9 que se ejecutan como unúnico comando.

Cuando AWS Cloud9 ejecuta este comando, cada cadena de la lista se separará por un solo espacio.Por ejemplo, AWS Cloud9 ejecutará "cmd": [ "ls", "$file", "$args"] como ls $file$args, donde AWS Cloud9 reemplazará a $file por la ruta completa del archivo actual y $argspor cualquier argumento introducido después del nombre de archivo. Para obtener más información,consulte la lista de variables admitidas más adelante en esta sección.

• script: representa un script bash (que también puede especificarse como una matriz de líneas si esnecesario para facilitar la lectura) que ejecuta el ejecutor en el terminal.

• working_dir: representa el directorio desde el que se ejecutará el ejecutor.• info: representa cualquier cadena de texto que desee mostrar al usuario al principio de la ejecución.

Esta cadena puede contener variables, por ejemplo Running $project_path$file_name...,donde AWS Cloud9 reemplazará $project_path por la ruta del directorio del archivo actual y$file_name por la parte del nombre del archivo actual. Consulte la lista de variables admitidas másadelante en esta sección.

• env: representa cualquier matriz de argumentos de línea de comandos que utiliza AWS Cloud9, porejemplo:

"env": { "LANG": "en_US.UTF-8", "SHLVL": "1"

164

AWS Cloud9 Guía del usuarioDefinir un compilador o ejecutor

}

• selector: representa cualquier expresión regular que desea que use AWS Cloud9 para identificar losnombres de archivo que se aplican a este ejecutor. Por ejemplo, puede especificar source.py para losarchivos de Python.

• debugger: representa el nombre de cualquier depurador disponible que desea que utilice AWS Cloud9que sea compatible con este ejecutor. Por ejemplo, podría especificar v8 para el depurador de V8.

• debugport: representa el número de puerto que desea que utilice AWS Cloud9 durante la depuración.Por ejemplo, podría especificar 15454 para el número de puerto que se va a utilizar.

En la siguiente tabla, se muestran las variables que se pueden utilizar.

Variable Descripción

$file_path El directorio del archivo actual, por ejemplo, /home/ec2-user/environment o /home/ubuntu/environment.

$file La ruta completa al archivo actual, por ejemplo, /home/ec2-user/environment/hello.py o /home/ubuntu/environment/hello.py.

$args Cualquier argumento introducido después elnombre de archivo, por ejemplo, "5" "9".

$file_name La parte del nombre del archivo actual, porejemplo, hello.py.

$file_extension La extensión del archivo actual, por ejemplo, py.

$file_base_name El nombre del archivo actual sin la extensión dearchivo, por ejemplo, hello.

$packages La ruta completa a la carpeta de los paquetes.

$project La ruta completa a la carpeta del proyecto actual.

$project_path El directorio del archivo del proyecto actual, porejemplo, /home/ec2-user/environment/ o /home/ubuntu/environment/.

$project_name El nombre del archivo del proyecto actual sin laextensión de archivo, por ejemplo, my-demo-environment.

$project_extension La extensión del archivo del proyecto actual.

$project_base_name El nombre del archivo del proyecto actual sin laextensión.

$hostname El nombre de host del entorno, por ejemplo192.0.2.0.

$hostname_path El nombre de host del entorno con la rutarelativa al archivo del proyecto, por ejemplo,https://192.0.2.0/hello.js.

$url La URL completa para obtener acceso al entorno,por ejemplo, https://192.0.2.0.

165

AWS Cloud9 Guía del usuarioTrabajar con proyectos de lenguaje

Variable Descripción

$port El puerto asignado al entorno, por ejemplo, 8080.

$ip La dirección IP para ejecutar un proceso en elentorno, por ejemplo, 0.0.0.0.

Por ejemplo, el siguiente archivo del compilador denominado G++.build define un compilador de GCCque ejecuta el comando g++ con la opción -o para compilar el archivo actual (por ejemplo, hello.cpp)en un módulo de objetos. A continuación, vincula el módulo de objetos a un programa con el mismonombre que el archivo actual (por ejemplo, hello). Aquí, el comando equivalente es g++ -o hellohello.cpp.

{ "cmd": [ "g++", "-o", "$file_base_name", "$file_name" ], "info": "Compiling $file_name and linking to $file_base_name...", "selector": "source.cpp"}

Como otro ejemplo, el siguiente archivo del ejecutor denominado Python.run define un ejecutor queutiliza Python para ejecutar el archivo actual con los argumentos que se han proporcionado. Por ejemplo,si el nombre del archivo actual es hello.py y se han proporcionado los argumentos 5 y 9 , el comandoequivalente es python hello.py 5 9.

{ "cmd": [ "python", "$file_name", "$args" ], "info": "Running $file_name...", "selector": "source.py"}

Por último, el siguiente archivo del ejecutor denominado Print Run Variables.run define un ejecutorque simplemente genera el valor de cada variable disponible y, a continuación, se detiene.

{ "info": "file_path = $file_path, file = $file, args = $args, file_name = $file_name, file_extension = $file_extension, file_base_name = $file_base_name, packages = $packages, project = $project, project_path = $project_path, project_name = $project_name, project_extension = $project_extension, project_base_name = $project_base_name, hostname = $hostname, hostname_path = $hostname_path, url = $url, port = $port, ip = $ip"}

Trabajar con proyectos de lenguaje en el AWSCloud9 Integrated Development Environment (IDE)

El AWS Cloud9 IDE proporciona características de productividad del proyecto para algunos lenguajesademás de los lenguajes enumerados en Lenguajes compatibles en el AWS Cloud9 IntegratedDevelopment Environment (IDE) (p. 128). Para usar estas características, se utiliza el IDE para crear oidentificar un proyecto de lenguaje (o proyecto) basado en ese lenguaje. Un proyecto es un conjunto dearchivos relacionados, carpetas y opciones de configuración en el IDE de un entorno de desarrollo de AWSCloud9.

Para utilizar el IDE para crear un proyecto de lenguaje en su entorno, consulte Creación de un proyecto delenguaje (p. 169).

166

AWS Cloud9 Guía del usuarioCaracterísticas disponibles de productividad de proyectos

Características disponibles de productividad deproyectosAWS Cloud9 IDE proporciona las siguientes características de productividad de proyectos por lenguaje deprogramación.

Lenguaje Autocompletar (p. 167)Iconos demargeninterior (p. 167)

Solucionesrápidas (p. 167)

Buscarreferencias (p. 167)

Ir adefinición (p. 168)

Ir asímbolo (p. 168)

TypeScript X X X X X X

AutocompletarA medida que escribe en un archivo en el editor, se muestra una lista de símbolos en el punto de inserciónpara ese contexto, si hay símbolos disponibles.

Para insertar un símbolo de la lista en el punto de inserción, si aún no se ha elegido un símbolo, use laflecha arriba o abajo para seleccionarlo y, a continuación, pulse Tab.

Antes de pulsar Tab, puede que vea una sugerencia en pantalla con información acerca del símboloelegido, si hay información disponible.

Para cerrar la lista sin insertar un símbolo, pulse Esc.

Iconos de margen interiorPodrían aparecer iconos en el margen interior del archivo activo. Estos iconos resaltan posibles problemascomo advertencias y errores en el código antes de ejecutarlo.

Para obtener más información acerca de un problema, detenga el puntero del ratón sobre el icono delproblema.

Soluciones rápidasEn el archivo activo en el editor, puede mostrar información sobre errores y advertencias de codificación,con posibles correcciones que se aplicará automáticamente a dicho código. Para mostrar información deerrores o advertencias y sus posibles correcciones, elija cualquier parte del código subrayado con unalínea roja discontinua (para errores) o una línea gris discontinua (para advertencias). O bien, con el cursorsobre el código que tiene una línea roja o gris discontinua, pulse Option-Enter (para macOS) o Alt-Enter (para Linux o Windows). Para aplicar una solución propuesta, elija la solución en la lista o utilice lasteclas de flecha para seleccionar la solución y, a continuación, pulse Enter. Para activar o desactivar laselección de soluciones rápidas mediante clics en el ratón, elija AWS Cloud9, Preferences (Preferencias),User Settings (Ajustes del usuario), Language (Lenguaje), Hints & Warnings (Consejos y advertencias),Show Available Quick Fixes on Click (Mostrar las soluciones rápidas disponibles al hacer clic).

Buscar referenciasEn el archivo activo en el editor, puede mostrar todas las referencias al símbolo en el punto de inserción, siel IDE tiene acceso a dichas referencias.

Para ello, en el punto de inserción en cualquier lugar dentro del símbolo, ejecute el comando FindReferences (Buscar referencias). Por ejemplo:

167

AWS Cloud9 Guía del usuarioCaracterísticas disponibles de productividad de proyectos

• Haga clic con el botón derecho en el punto de inserción y, a continuación, elija Find References (Buscarreferencias).

• En la barra de menús, elija Go, Find References (Ir, Buscar referencias).• De forma predeterminada, pulse Shift-F3 para macOS, Windows o Linux.

Si hay referencias disponibles, se abrirá un panel en la parte superior del archivo activo, junto a esesímbolo. El panel contiene una lista de archivos en los que se hace referencia al símbolo. El panel muestrala primera referencia de la lista. Para mostrar otra referencia, elija esa referencia de la lista.

Para cerrar el panel, elija el icono de cierre (X) en el panel o pulse Esc.

El comando Find References (Buscar referencias) podría estar deshabilitado, o podría no funcionarsegún lo previsto, bajo las siguientes condiciones:

• No hay ninguna referencia a ese símbolo en el proyecto del archivo activo.• El IDE no puede encontrar algunas o todas las referencias a ese símbolo en el proyecto del archivo

activo.• El IDE no tiene acceso a una o más ubicaciones donde se hace referencia al símbolo en el proyecto del

archivo activo.

Ir a definiciónEn el archivo activo en el editor, puede ir de un símbolo al lugar donde se define el símbolo, si el IDE tieneacceso a dicha definición.

Para ello, en el punto de inserción en cualquier lugar dentro del símbolo, ejecute el comando Jump toDefinition (Buscar referencias). Por ejemplo:

• Haga clic con el botón derecho en el punto de inserción y, a continuación, elija Jump to Definition (Saltara la definición).

• En la barra de menús, elija Go, Jump to Definition (Ir, Saltar a la definición).• De forma predeterminada, pulse F3 para macOS, Windows o Linux.

Si la definición está disponible, el punto de inserción cambia a esa definición, incluso aunque la definiciónesté en un archivo independiente.

El comando Jump to Definition (Buscar referencias) podría estar deshabilitado, o podría no funcionarsegún lo previsto, bajo las siguientes condiciones:

• El símbolo es un símbolo primitivo para ese lenguaje.• El IDE no puede encontrar la ubicación de la definición en el proyecto del archivo activo.• El IDE no tiene acceso a la ubicación de la definición en el proyecto del archivo activo.

Ir a símboloPuede ir a un símbolo específico dentro de un proyecto, de la siguiente manera.

1. Para activar uno de los archivos del proyecto, ábralo en el editor. Si el archivo ya está abierto, elija supestaña en el editor para activarlo.

2. Ejecute el comando Go to Symbol (Ir a símbolo). Por ejemplo:

• Elija el botón de ventana Go (Ir) (icono de lupa). En el cuadro Goto Anything (Ir a cualquier punto),escriba @ y, a continuación, comience a escribir el símbolo.

168

AWS Cloud9 Guía del usuarioCreación de un proyecto de lenguaje

• En la barra de menús, elija Go, Go To Symbol (Ir, Ir a símbolo). En la ventana Go (Ir), empiece aescribir el símbolo después de @.

• Pulse Command-2 o, de forma predeterminada, Command-Shift-O para sistemas operativosmacOS o, de forma predeterminada, Ctrl-Shift-O para Windows o Linux. En la ventana Go (Ir),empiece a escribir el símbolo después de @.

Por ejemplo, para buscar todos los símbolos en el proyecto llamados toString, comience a escribir@toString (o comience a escribir toString después de @, si @ ya se muestra).

3. Si ve el símbolo que desea en la lista Symbols (Símbolos), haga clic en él para seleccionarlo. Obien use las flechas arriba o abajo para seleccionarlo y, a continuación, pulse Enter (Entrar). Acontinuación, el punto de inserción cambia a ese símbolo.

Si el símbolo al que desea ir no está en el proyecto del archivo activo, es posible que este procedimientono funcione correctamente.

Creación de un proyecto de lenguajeUtilice el siguiente procedimiento para crear un proyecto de lenguaje que funcionará con las característicascompatibles de productividad de proyecto en el AWS Cloud9 IDE.

Note

Le recomendamos que utilice características compatibles de productividad del proyecto enlos archivos que forman parte de un proyecto de lenguaje. Aunque puede utilizar algunascaracterísticas de productividad de proyecto en un archivo que no forma parte de un proyecto, lascaracterísticas podrían tener un comportamiento actuar con resultados inesperados.Por ejemplo, puede utilizar el IDE para buscar las referencias y definiciones en un archivo enel nivel raíz de un entorno que no forma parte de un proyecto. El IDE solo podría buscar en losarchivos situados en ese mismo nivel raíz. Esto podría dar como resultado que no se encuentreninguna referencia o definición, aunque esas referencias o definiciones existan realmente enproyectos de lenguaje en otros lugares del mismo entorno.

Creación de un proyecto de lenguaje de TypeScript1. Asegúrese de que TypeScript esté instalado en entorno. Para obtener más información, consulte

Paso 1: Instalar las herramientas necesarias (p. 484) en la Muestra de TypeScript para AWSCloud9 (p. 483).

2. Desde una sesión de terminal en el IDE para el entorno, cambie al directorio en el que desea crearel proyecto. Si el directorio no existe, créelo y acceda a él. Por ejemplo, los siguientes comandoscrean un directorio llamado my-demo-project en la raíz del entorno (en ~/environment) y, acontinuación, cambia a dicho directorio.

mkdir ~/environment/my-demo-projectcd ~/environment/my-demo-project

3. En la raíz del directorio en el que desea crear el proyecto, ejecute el compilador TypeScript con laopción --init.

tsc --init

Si este comando se realiza correctamente, el compilador TypeScript crea un archivo tsconfig.jsonen la raíz del directorio para el proyecto. Puede utilizar este archivo para definir varias configuracióndel proyecto, como, por ejemplo, las opciones del compilador TypeScript y archivos específicos queincluir o excluir del proyecto.

169

AWS Cloud9 Guía del usuarioTrabajo con variables de entorno personalizadas

Para obtener más información sobre el archivo tsconfig.json, consulte los siguientes temas:

• Información general de tsconfig.json en el sitio web de TypeScript.• Esquema de tsconfig.json en el sitio web json.schemastore.org.

Trabajo con variables de entorno personalizadasen el AWS Cloud9 Integrated DevelopmentEnvironment (IDE)

El AWS Cloud9 IDE permite obtener y configurar variables de entorno personalizadas. Puede obtener yconfigurar variables de entorno personalizadas en el AWS Cloud9 IDE de las siguientes maneras.

• Establecer variables de entorno personalizadas en el nivel de comando (p. 170)• Establecer variables de entorno de usuario personalizadas en ~/.bash_profile (p. 170)• Establecer variables de entorno personalizadas locales (p. 171)• Establecer variables de entorno de usuario personalizadas en ~/.bashrc (p. 171)• Establecer variables de entorno personalizadas en la lista ENV (p. 171)

Establecer variables de entorno personalizadas en elnivel de comandoPuede establecer las variables de entorno personalizadas en el nivel del comando al ejecutar un comandoen su entorno de desarrollo de AWS Cloud9. Para probar este comportamiento, cree un archivo llamadoscript.sh con el código siguiente:

#!/bin/bash

echo $MY_ENV_VAR

Si ejecuta el siguiente comando, el terminal muestra Terminal session:

MY_ENV_VAR='Terminal session' sh ./script.sh

Si establece la variable de entorno personalizada utilizando los diversos enfoques que se describen eneste tema, al intentar obtener el valor de la variable de entorno personalizada, este ajuste tendrá prioridadcon respecto a todos los demás.

Establecer variables de entorno de usuariopersonalizadas en ~/.bash_profilePuede establecer variables de entorno de usuario personalizadas en el archivo ~/.bash_profile de suentorno. Para probar este comportamiento, añada el siguiente código al archivo ~/.bash_profile en suentorno:

export MY_ENV_VAR='.bash_profile file'

170

https://www.typescriptlang.org/docs/handbook/tsconfig-json.html

http://json.schemastore.org/tsconfig

AWS Cloud9 Guía del usuarioEstablecer variables de entorno personalizadas locales

Si luego elige el comando Run (Ejecutar), Run With (Ejecutar con), Shell script (Script de shell) en la barrade menús, escriba ./script.sh en el recuadro Command (Comando) de la pestaña del ejecutador yluego elija Run (Ejecutar). En la pestaña del ejecutador se muestra .bash_profile file. (En estecaso, se da por hecho que ha creado el archivo script.sh tal y como se ha descrito anteriormente).

Establecer variables de entorno personalizadaslocalesPuede establecer variables de entorno personalizadas locales en una sesión de terminal ejecutando elcomando export . Para probar este comportamiento, ejecute el comando siguiente en una sesión determinal:

export MY_ENV_VAR='Command line export'

Si luego elige el comando Run (Ejecutar), Run With (Ejecutar con), Shell script (Script de shell) en la barrade menús, escriba ./script.sh en el recuadro Command (Comando) de la pestaña del ejecutador yluego elija Run (Ejecutar). En la pestaña del ejecutador se muestra Command line export. (En estecaso, se da por hecho que ha creado el archivo script.sh tal y como se ha descrito anteriormente).

Si establece la misma variable de entorno personalizada en su archivo ~/.bash_profile con elcomando export , al intentar obtener el valor de la variable de entorno del cliente, el ajuste del archivo~/.bash_profile tiene prioridad.

Establecer variables de entorno de usuariopersonalizadas en ~/.bashrcPuede establecer variables de entorno de usuario personalizadas en el archivo ~/.bashrc de su entorno.Para probar este comportamiento, añada el siguiente código al archivo ~/.bashrc en su entorno:

export MY_ENV_VAR='.bashrc file'

Si luego elige el comando Run (Ejecutar), Run With (Ejecutar con), Shell script (Script de shell) en la barrade menús, escriba ./script.sh en el recuadro Command (Comando) de la pestaña del ejecutador yluego elija Run (Ejecutar). En la pestaña del ejecutador se muestra .bashrc file. (En este caso, se dapor hecho que ha creado el archivo script.sh tal y como se ha descrito anteriormente).

Si establece la misma variable de entorno personalizada con el comando export en el archivo~/.bashrc, al intentar obtener el valor de la variable de entorno personalizada, el ajuste del comando export tiene prioridad.

Establecer variables de entorno personalizadas en lalista ENVPuede establecer variables de entorno personalizadas en la lista ENV de la pestaña Run (Ejecutar).

Para probar este comportamiento, haga lo siguiente:


2. En la pestaña [New] - Idle (Nuevo - Inactivo), elija Runner: Auto (Ejecutor: automático) y, a continuación,elija Shell script (Script de shell).

171

AWS Cloud9 Guía del usuarioTrabajar con la configuración de los proyectos

3. Elija ENV y luego escriba MY_ENV_VAR en Name (Nombre) y ENV list en Value (Valor).4. En Command (Comando), escriba ./script.sh.5. Elija el botón Run (Ejecutar). La pestaña del ejecutor muestra ENV list. (En este caso, se da por

hecho que ha creado el archivo script.sh tal y como se ha descrito anteriormente).

Si establece la misma variable de entorno personalizada en el archivo ~/.bash_profile con el comandoexport en el archivo ~/.bashrc y en la lista ENV, cuando intente obtener el valor de la variable deentorno personalizada, el ajuste del archivo ~/.bash_profile tendrá prioridad, seguido del ajuste delcomando export , el ajuste del archivo ~/.bashrc y el ajuste de la lista ENV.

Note

La lista ENV es el único enfoque para obtener y configurar variables de entorno personalizadasmediante código, de manera independiente de un script de shell.

Trabajar con la configuración de usuarios en elAWS Cloud9 Integrated Development Environment(IDE)

Los valores de Project settings, (Configuración de proyecto) que se aplican únicamente al entorno dedesarrollo de AWS Cloud9 actual, incluyen los siguientes valores de configuración:

• Comportamientos del editor de código, por ejemplo, si debe utilizar tabuladores y nuevo final de línea dearchivo

• Tipos de archivo que se ignoran• Los tipos de sugerencias y advertencias que se muestran o suprimen• Comportamientos del formato y el código de lenguajes de programación como JavaScript, PHP, Python

y Go• Tipos de configuraciones que se usan cuando se ejecuta y compila código

Aunque la configuración de proyectos se aplica a un único entorno, puede aplicar la configuración de unentorno a cualquier otro entorno.

• Ver o cambiar la configuración de proyectos (p. 172)• Aplicar la configuración del proyecto actual de un entorno a otro (p. 173)• Project Setting Changes You Can Make (p. 173)

Ver o cambiar la configuración de proyectos1. En la barra de menús, elija AWS Cloud9 y, a continuación, Preferences (Preferencias).2. Para ver la configuración de proyecto del entorno actual, en la pestaña Preferences (Preferencias), en el

panel de navegación lateral, seleccione Project Settings (Configuración de proyecto).3. Para cambiar la configuración del proyecto del entorno, hágalo en el panel Project Settings.

(Configuración de proyecto).

Consulte Project Setting Changes You Can Make (p. 173)

172

AWS Cloud9 Guía del usuarioAplicar la configuración del proyectoactual de un entorno a otro entorno

Aplicar la configuración del proyecto actual de unentorno a otro entorno1. En el entorno de origen y de destino, en la barra de menús de AWS Cloud9 IDE, elija AWS Cloud9,

Open Your User Project (Abrir proyecto de usuario).2. En el entorno de origen, copie el contenido de la pestaña project.settings que se muestra.3. En el entorno de destino, sobrescriba el contenido de la pestaña project.settings con el contenido

copiado del entorno de origen.4. En el entorno de destino, guarde la pestaña project.settings.

Project Setting Changes You Can MakeEn estas secciones se describen los valores de configuración de proyecto que puede cambiar en lapestaña Preferences (Preferencias) del panel Project Settings (Configuración de proyecto).

• Instancia de EC2 (p. 173)• Editor de código (Ace) (p. 173)• Buscar en archivos (p. 174)• Consejos y advertencias (p. 174)• Soporte de JavaScript (p. 174)• Compilación (p. 175)• Ejecución y depuración (p. 175)• Run Configurations (Configuraciones de ejecución) (p. 175)• Formateadores de código (p. 175)• Soporte de TypeScript (p. 177)• Soporte de PHP (p. 177)• Soporte de Python (p. 178)• Soporte de Go (p. 178)

Instancia EC2Stop my environment (Detener mi entorno)

Si el entorno es un entorno de EC2, una vez que todas las instancias del explorador conectadas al IDEdel entorno estén cerradas, la cantidad de tiempo hasta que AWS Cloud9 cierra la instancia AmazonEC2 del entorno.

Editor de código (Ace)Soft Tabs (Tabuladores suaves)

Si se selecciona, se inserta el número especificado de espacios en lugar de un tabulador cada vez quepulse Tab.

Autodetect Tab Size on Load (Detectar automáticamente el tamaño de la pestaña al cargar)

Si se selecciona, AWS Cloud9 intenta adivinar el tamaño de la pestaña.New File Line Ending (Nuevo final de línea de archivos)

El tipo de finales de línea que se va a utilizar en los archivos nuevos.

173

AWS Cloud9 Guía del usuarioProject Setting Changes You Can Make

Entre las opciones válidas se incluyen:• Windows (CRLF) para finalizar las líneas con un retorno de carro y un salto de línea.• Unix (LF) para finalizar líneas con un salto de línea únicamente.

On Save, Strip Whitespace (Quitar espacios al guardar)

Si se selecciona, AWS Cloud9 intenta quitar lo que considera tabuladores y espacios innecesarios deun archivo cada vez que ese archivo se guarda.

Buscar en archivosIgnore these Files (Ignorar estos archivos)

Cuando se buscan archivos, los tipos de archivos que AWS Cloud9 ignorará.Maximum number of files to search (in 1000) [Número máximo de archivos para buscar (en 1000)]

Cuando se buscan archivos, el número máximo de archivos, en múltiplos de 1.000, que AWS Cloud9encontrará en el ámbito actual.

Consejos y advertenciasNivel de advertencia

El nivel mínimo de los mensajes que se van a habilitar.

Los valores válidos son:• Info (Información) para habilitar mensajes de error informativos y de advertencia.• Warning (Aviso) para habilitar solo mensajes de error y de advertencia.• Error para permitir solo los mensajes de error.

Mark Missing Opcional Semicolons (Marcar punto y coma opcionales que faltan)

Si está habilitada, AWS Cloud9 marca en archivo cada vez que se detecta un punto y coma que puedeutilizarse en el código, pero que no se utiliza.

Mark Undeclared Variables (Marcar variables no declaradas)

Si está habilitada, AWS Cloud9 marca en un archivo cada vez que se detecta una variable nodeclarada en el código.

Mark Unused Function Arguments (Marcar argumentos de función no usados)

Si está habilitada, AWS Cloud9 marca en un archivo cada vez que se detecta un argumento noutilizado en una función.

Ignore Messages Matching Regex (Omitir mensajes que coinciden con Regex)

AWS Cloud9 no mostrará ningún mensaje que coincida con la expresión regular especificada.Para obtener más información, consulte Writing a regular expression pattern en JavaScript RegularExpressions en Mozilla Developer Network.

Soporte de JavaScriptCustomize JavaScript Warnings With .eslintrc (Personalizar advertencias de JavaScript con .eslintrc)

Si está habilitada, AWS Cloud9 utiliza un archivo .eslintrc con el fin de determinar quéadvertencias de JavaScript se habilitan o deshabilitan. Para obtener más información, consulteConfiguration File Formats en el sitio web de ESLint.

174


http://eslint.org/docs/user-guide/configuring#configuration-file-formats


Bibliotecas JavaScript Finalización de código

Las bibliotecas de JavaScript que AWS Cloud9 utiliza para intentar sugerir o finalizar el código deforma automática.

Format Code on Save (Formatear código al guardar)

Si está habilitada, AWS Cloud9 intenta formatear el código en un archivo JavaScript cada vez que esearchivo se guarda.

Use Builtin JSBeautify as Code Formatter (Usar Builtin JSBeautify como formateador de código)

Si está habilitada, AWS Cloud9 utiliza su implementación interna de JSBeautify para intentar aumentarla legibilidad del código en los archivos.

Custom Code Formatter (Formateador de código personalizado)

El comando de AWS Cloud9 que se intentar ejecutar al formatear código en un archivo JavaScript.

CompilaciónBuilder Path in environment (Ruta del compilador en el entorno)

La ruta a cualquier configuración de compilación personalizada.

Ejecución y depuraciónRunner Path in Environment (Ruta de ejecutor en entorno)

La ruta a configuraciones de ejecución personalizadas.Preview URL (URL de vista previa)

La dirección URL que se debe utilizar para obtener una vista previa de aplicaciones para el entorno.

Run Configurations (Configuraciones de ejecución)La configuración de ejecución personalizada para este entorno.

Remove Selected Configs (Eliminar configuraciones seleccionadas)

Elimina las configuraciones de ejecución seleccionadas.Add New Config (Agregar nueva configuración)

Crea una nueva configuración de ejecución.Set As Default (Establecer como predeterminado)

Establece la configuración de ejecución seleccionada como la predeterminada.

Formateadores de códigoJSBeautify settings (Configuración JSBeautify)

Configuración para aumentar la legibilidad del código en los archivos.Format Code on Save (Formatear código al guardar)

Si está habilitada, AWS Cloud9 intenta aplicar la configuración JSBeautify cada vez que seguardan los archivos de código.

175


Use JSBeautify for JavaScript (Usar JSBeautify para JavaScript)

Si está habilitada, AWS Cloud9 intenta aplicar la configuración JSBeautify cada vez que seguardan los archivos JavaScript.

Preserve Empty Lines (Mantener líneas vacías)

Si está habilitada, AWS Cloud9 no elimina líneas vacías en el código.Keep Array Indentation (Mantener sangría en matrices)

Si está habilitada, AWS Cloud9 conserva la sangría en las declaraciones de elementos enmatrices en los archivos de código.

JSLint Strict Whitespace (Espacio en blanco de JSLint)

Si está habilitada, AWS Cloud9 intenta aplicar las reglas sobre espacios en blanco de JSLint enlos archivos de código. Para obtener más información, consulte "Espacios en blanco" en JSLintHelp.

Braces (Llaves)

Especifica la alineación de las llaves en el código.

Los valores válidos son:• Braces with control statement (Llaves con declaración de control) para mover cada llave de

inicio y final y alinearla con su declaración de control relacionada, según sea necesario.

Por ejemplo, este código:

for (var i = 0; i < 10; i++) { if (i == 5) { console.log("Halfway done.") }}

se convierte en este código cuando se guarda el archivo:


• Braces on own line (Llaves en línea propia) para mover cada llave a su línea, según seanecesario.




for (var i = 0; i < 10; i++) {if (i == 5) { console.log("Halfway done.") } }

• End braces on own line (Terminar llaves en línea propia) para mover cada llave de cierre a sulínea, según sea necesario.


for (var i = 0; i < 10; i++) {

176

http://jslint.com/help.html

http://jslint.com/help.html


if (i == 5) { console.log("Halfway done.") }}



Conservar bloques en línea

Si está habilitada, AWS Cloud9 no intenta mover las llaves de apertura y cierre de los bloques enlínea a líneas separadas, si estas llaves están en la misma línea.

Space Before Conditionals (Espacio antes de condicional)

Si está habilitada, AWS Cloud9 añade un espacio antes de cada declaración condicional, segúnsea necesario.

Unescape Strings (Cadenas sin escape)

Si está habilitada, AWS Cloud9 convierte las cadenas de escape en sus equivalentes sin escape.Por ejemplo, convierte \n en un carácter de nueva línea y convierte \r en un retorno de carro.

Indent Inner Html (Aplicar sangría HTML)

Si está habilitada, AWS Cloud9 aplica sangría a las secciones <head> y <body> en códigoHTML.

Soporte de TypeScriptFormat Code on Save (Formatear código al guardar)

Si está habilitada, AWS Cloud9 intenta dar formato al código TypeScript cada vez que se guardan losarchivos TypeScript.


La ruta de cualquier configuración de código personalizada para código TypeScript.

Soporte de PHPEnable PHP code Completion (Habilitar completar código PHP)

Si está habilitada, AWS Cloud9 intenta completar el código PHP.PHP Completion Include Paths (Rutas completar código PHP)

Ubicaciones que AWS Cloud9 utiliza para intentar ayudar a completar el código de PHP. Por ejemplo,si tiene archivos PHP personalizados que desea que AWS Cloud9 use para la finalización y seencuentran en algún lugar del directorio ~/environment, añada ~/environment a esta ruta.


Si está habilitada, AWS Cloud9 intenta dar formato al código PHP cada vez que se guardan losarchivos PHP.


La ruta de cualquier configuración de código personalizada para código PHP.

177

AWS Cloud9 Guía del usuarioTrabajo con la configuración de usuario

Soporte de PythonEnable Python code completion (Habilitar completar código Python)

Si está habilitada, AWS Cloud9 intenta completar el código Python. Para definir las rutas que AWSCloud9 va a utilizar para completar el código Python, utilice la configuración PYTHONPATH.

Python Version (Versión de Python)

Especifica la versión de Python que se va a utilizar.Opciones de la línea de comandos de Pylint

Opciones que AWS Cloud9 va a utilizar para Pylint con código de Python. Para obtener másinformación, consulte el manual del usuario de Pylint en el sitio web de Pylint.

PYTHONPATH

Las rutas de las bibliotecas y los paquetes de Python que AWS Cloud9 va a utilizar. Por ejemplo, sitiene bibliotecas y paquetes de Python personalizados en el directorio ~/environment, añada ~/environment a esta ruta.


Si está habilitada, AWS Cloud9 intenta dar formato al código Python cada vez que se guardan losarchivos Python.


La ruta de cualquier configuración de código personalizada para código Python.

Soporte de GoHabilitar completar código Go

Si está habilitada, AWS Cloud9 intenta completar el código Go.Format Code on Save (Formatear código al guardar)

Si está habilitada, AWS Cloud9 intenta dar formato al código Go cada vez que se guardan los archivosGo.


La ruta de cualquier configuración de código personalizada para código Go.

Uso de la configuración de usuario en AWS Cloud9IDE

La configuración de usuario es una configuración que se aplica en cada uno de los entorno de desarrollode AWS Cloud9 asociados al usuario de AWS Identity and Access Management (IAM). Incluyen lossiguientes tipos de configuraciones:

• Comportamientos generales de la interfaz de usuario, como habilitar animaciones y marcar pestañascambiadas

• Comportamientos de navegación del sistema de archivos• Comportamientos de búsqueda de archivos

178

https://pylint.readthedocs.io/en/latest/

AWS Cloud9 Guía del usuarioVisualización o cambio de la configuración de usuario

• Esquemas de color para las sesiones de terminal y salida• Comportamientos adicionales del editor de código como, por ejemplo, plegado de código, selección de

líneas completas, desplazamiento de animaciones y tamaños de fuente

A medida que modifica la configuración de usuario, AWS Cloud9 los envía a la nube y los asocia a suusuario de IAM. AWS Cloud9 también examina constantemente la nube para comprobar si hay cambiosen la configuración de usuario asociada a su usuario de IAM y aplica esta configuración al entorno actual.Este comportamiento le permite disfrutar del mismo aspecto independientemente del entorno de AWSCloud9 en el que trabaja.

Note

AWS Cloud9 utiliza las API internas GetUserSettings y UpdateUserSettings paraalmacenar y recuperar la configuración de IDE.

Puede compartir la configuración de usuario con otros usuarios de la siguiente manera:

• Visualización o cambio de la configuración de usuario (p. 179)• Cómo compartir la configuración de usuario con otro usuario (p. 179)• User Setting Changes You Can Make (p. 179)

Visualización o cambio de la configuración de usuario1. En la barra de menús, elija AWS Cloud9 y, a continuación, Preferences (Preferencias).2. Para ver la configuración de usuario de cada uno de los entornos, en la pestaña Preferences

(Preferencias), en el panel de navegación lateral, seleccione User Settings (Configuración de usuario).3. En el panel User Settings (Configuración de usuario), cambie la configuración de usuario de cada uno

de los entornos.4. Para aplicar los cambios a otro de los entornos, solo tiene que abrir el entorno. Si ese entorno ya está

abierto, actualice la pestaña del navegador web para ese entorno.

Para obtener más información, consulte el tema sobre cambios de la configuración de usuario que puederealizar (p. 179).

Cómo compartir la configuración de usuario con otrousuario1. En el entorno de origen y de destino, en la barra de menús de AWS Cloud9 IDE, elija AWS Cloud9,

Open Your User Settings (Abrir su configuración de usuario).2. En el entorno de origen, copie el contenido de la pestaña user.settings que se muestra.3. En el entorno de destino, sobrescriba el contenido de la pestaña user.settings (Configuración de

usuario) con el contenido copiado del entorno de origen.4. En el entorno de destino, guarde la pestaña user.settings.

User Setting Changes You Can MakeEn estas secciones se describen los tipos de configuración de usuario que puede cambiar en el panel UserSettings (Configuración de usuario) de la pestaña Preferences (Preferencias):

179

AWS Cloud9 Guía del usuarioUser Setting Changes You Can Make

• General (p. 180)• Interfaz de usuario (p. 180)• Colaboración (p. 181)• Panel Tree y Go (p. 181)• Buscar en archivos (p. 182)• Metadatos (p. 182)• Monitores (p. 182)• Terminal (p. 182)• Salida (p. 183)• Editor de código (Ace) (p. 183)• Entrada (p. 185)• Consejos y advertencias (p. 186)• Ejecución y depuración (p. 186)• Vista previa (p. 186)• Build (p. 186)

GeneralReset to Factory Settings (Restablecer la configuración de fábrica)

Si selecciona el botón Reset to Default (Restablecer configuración predeterminada), AWS Cloud9restablece todas las configuraciones de usuario a la configuración de usuario predeterminada de AWSCloud9. Para confirmarlo, elija Reset settings (Restablecer configuración).

Warning

Esta acción no se puede deshacer.Warn Before Exiting (Avisar antes de salir)

Cada vez que intente salir de IDE, AWS Cloud9 le pedirá que confirme si desea salir.

Interfaz de usuarioEnable UI Animations (Habilitar animaciones de IU)

AWS Cloud9 utiliza animaciones en IDE.Use an Asterisk (*) to Mark Changed Tabs (Utilizar un asterisco (*) para marcar las pestañas cambiadas)

AWS Cloud9 añade un asterisco (*) a las pestañas que tienen cambios, pero en las que aún no se haguardado el contenido.

Display Title of Active Tab as Browser Title (Mostrar título de pestaña activa como título del navegador)

AWS Cloud9 cambia el título de la pestaña del navegador web asociada por el título de la pestañaactiva (por ejemplo, Untitled1 (Sintítulo1), hello.js, Terminal, Preferences (Preferencias), etc.).

Automatically Close Empty Panes (Cerrar automáticamente los paneles vacíos)

Siempre que recargue un entorno, AWS Cloud9 cerrará automáticamente cualquier panel queconsidere que está vacío.

180


Environment Files Icon and Selection Style (Icono de archivos de entorno y estilo de selección)

El icono que utiliza AWS Cloud9 para los archivos de entorno y los comportamientos de selección dearchivos que utiliza AWS Cloud9.

Los valores válidos son:• Default (Predeterminado): AWS Cloud9 utiliza los iconos predeterminados y los comportamientos de

selección de archivos predeterminados.• Alternative (Alternativo): AWS Cloud9 utiliza iconos alternativos y comportamientos de selección de

archivos alternativos.

ColaboraciónShow Notification Bubbles (Mostrar burbujas de notificación)

AWS Cloud9 muestra las notificaciones si el entorno es un entorno compartido y hay varios usuariosque colaboran activamente en ese entorno compartido.

Disable collaboration security warning (Deshabilitar advertencia de seguridad de colaboración)

Cuando se añade un miembro de lectura/escritura a un entorno, AWS Cloud9 no muestra el cuadro dediálogo de advertencia de seguridad.

Show Authorship Info (Mostrar información de autor)

AWS Cloud9 subraya el texto introducido por otros miembros del entorno con resaltados relacionadosen el margen interno.

Panel Tree y GoÁmbito de Go to Anything (Ir a cualquier punto) a Favoritos

Go to File (Ir a archivo) en la ventana Go (Ir) muestra solo los resultados de Favorites (Favoritos) en laventana Environment (Entorno).

Habilitar Vista previa en Go to Anything (Ir a cualquier punto)

Go to File (Ir a archivo) en la ventana Go (Ir) muestra el contenido del archivo que coincide a medidaque escribe.

Enable Preview on Tree Selection (Habilitar vista previa al seleccionar árbol)

AWS Cloud9 muestra el archivo elegido con un solo clic en lugar de con un doble clic.Hidden File Pattern (Patrón de archivos ocultos)

Los tipos de archivos que AWS Cloud9 va a tratar como ocultos.Reveal Active File in Project Tree (Revelar archivo activo en árbol de proyecto)

AWS Cloud9 resalta el archivo activo en la ventana Environment (Entorno).Download Files As (Descargar archivos como)

El comportamiento que debe utilizar AWS Cloud9 para descargar archivos.

Los valores válidos son:• auto (automático): AWS Cloud9 descarga los archivos sin modificaciones.• tar.gz: AWS Cloud9 descarga los archivos como archivos TAR comprimidos.

181


• auto (automático): AWS Cloud9 descarga los archivos como archivos .zip.

Buscar en archivosSearch In This Path When 'Project' Is Selected (Buscar en esta ruta cuando el "Proyecto" estáseleccionado)

En la barra de búsqueda en los archivos, cuando Project (Proyecto) está seleccionado en el ámbito debúsqueda, la ruta en la que se debe buscar.

Show Full Path in Results (Mostrar ruta completa en los resultados)

Muestra la ruta completa a cada archivo coincidente en la pestaña Search Results (Resultados debúsqueda).

Clear Results Before Each Search (Borrar resultados antes de cada búsqueda)

Borra la pestaña Search Results (Resultados de búsqueda) de los resultados de las búsquedasanteriores antes de que empiece la búsqueda actual.

Scroll Down as Search Results Come In (Desplazarse hacia abajo a medida que se muestran losresultados de la búsqueda)

Desplaza la pestaña Search Results (Resultados de búsqueda) hasta la parte inferior de la lista deresultados a medida que se identifican los resultados de la búsqueda.

Open Files when Navigating Results with (Up and Down) (Abrir archivos al navegar por los resultados con(Arriba y Abajo))

Al presionar las teclas de flecha arriba y abajo en la pestaña Search Results (Resultados debúsqueda), en la lista de resultados, se abre cada archivo coincidente.

MetadatosMaximum of Undo Stack Items in Meta Data (Número máximo de elementos de la pila de deshacer enmetadatos)

El número máximo de elementos que AWS Cloud9 mantiene en su lista de acciones que se puedendeshacer.

MonitoresAuto-Merge Files When a Conflict Occurs (Fusionar archivos automáticamente cuando se produce unconflicto)

AWS Cloud9 intenta fusionar automáticamente los archivos siempre que se produce un conflicto defusión.

TerminalColor del texto

El color del texto en las pestañas Terminal.Background Color (Color de fondo)

El color de fondo en las pestañas Terminal.

182


Selection Color (Color de selección)

El color del texto seleccionado en las pestañas Terminal.Font Family (Familia de fuentes)

El estilo de fuente en las pestañas Terminal.Tamaño de fuente

El tamaño del texto en las pestañas Terminal.Antialiased Fonts (Fuentes suavizadas)

AWS Cloud9 intenta suavizar la visualización de texto en las pestañas Terminal.Blinking Cursor (Cursor parpadeante)

AWS Cloud9 hace parpadear continuamente el cursor en las pestañas Terminal.Scrollback (Desplazamiento hacia atrás)

El número de líneas que puede desplazarse hacia delante o hacia atrás en las pestañas Terminal.Use AWS Cloud9 as the Default Editor (Utilizar AWS Cloud9 como editor predeterminado)

Utiliza AWS Cloud9 como el editor de texto predeterminado.

SalidaColor del texto

El color del texto de las pestañas que muestra la salida.Background Color (Color de fondo)

El color de fondo del texto de las pestañas que muestra la salida.Selection Color (Color de selección)

El color del texto seleccionado de las pestañas que muestra la salida.Warn Before Closing Unnamed Configuration (Avisar antes de cerrar una configuración sin nombre)

AWS Cloud9 le pedirá que guarde cualquier pestaña de configuración que no esté guardada antes deque se cierre.

Preserve log between runs (Conservar registro entre ejecuciones)

AWS Cloud9 mantiene un registro de todos los intentos de ejecución.

Editor de código (Ace)Auto-pair Brackets, Quotes, etc. (Emparejamiento automático de corchetes o comillas)

AWS Cloud9 intenta añadir un carácter de cierre que coincida a cada carácter de inicio relacionadoque se escriba en las pestañas del editor, como, por ejemplo, para corchetes, comillas y llaves.

Wrap Selection with Brackets, Quote, etc. (Incluir selección entre corchetes, comillas, etc.)

AWS Cloud9 intenta insertar un carácter de cierre que coincida al final del texto en las pestañas deleditor después de que se seleccione el texto y se escriba un carácter relacionado con el inicial, como,por ejemplo, para corchetes, comillas y llaves.

183


Code Folding (Plegado de código)

AWS Cloud9 intenta mostrar, expandir, ocultar o contraer secciones de código en las pestañas deleditor de acuerdo con las reglas de sintaxis del código relacionado.

Fade Fold Widgets (Widgets de pliegue de desvanecimiento)

AWS Cloud9 muestra los controles de plegado del código en el margen interior siempre que el ratónse detenga sobre esos controles en las pestañas del editor.

Full Line Selection (Selección de línea completa)

AWS Cloud9 selecciona una línea completa a la que se hace triple clic en las pestañas del editor.Highlight Active Line (Resaltar línea activa)

AWS Cloud9 resalta toda la línea activa en las pestañas del editor.Highlight Gutter Line (Resaltar línea de margen interior)

AWS Cloud9 resalta la ubicación del margen interior junto a la línea activa en las pestañas del editor.Show Invisible Characters (Mostrar caracteres invisibles)

AWS Cloud9 muestra lo que considera que son caracteres invisibles en las pestañas del editor; porejemplo, retornos de carro y saltos de línea, espacios y tabulaciones.

Show Gutter (Mostrar margen interior)

AWS Cloud9 muestra el margen interior.Show Line Numbers (Mostrar números de línea)

El comportamiento para mostrar números de líneas en el margen interior.

Los valores válidos son:• Normal: para mostrar números de línea.• Relative (Relativo): para mostrar números de línea relativos a la línea activa.• None (Ninguno): para ocultar números de línea.

Show Indent Guides (Mostrar guías de sangrado)

AWS Cloud9 muestra guías para visualizar más fácilmente el texto con sangría en las pestañas deleditor.

Highlight Selected Word (Resaltar palabra seleccionada)

AWS Cloud9 selecciona una palabra completa en la que se hace doble clic en una pestaña del editor.Scroll Past the End of the Document (Desplazarse hasta después del final del documento)

El comportamiento para permitir que el usuario se desplace más allá del final del archivo actual en laspestañas del editor.

Los valores válidos son:• Off (Desactivado): para no permitir ningún desplazamiento más allá del final del archivo actual.• Half Editor Height (Mitad de altura del editor): para permitir el desplazamiento más allá del final del

archivo actual hasta la mitad de la altura de la pantalla del editor.• Full Editor Height (Altura del editor completa): para permitir el desplazamiento más allá del final del

archivo actual hasta la altura completa de la pantalla del editor.Animate Scrolling (Animar desplazamiento)

AWS Cloud9 aplica comportamientos de animación durante las acciones de desplazamiento en laspestañas del editor.

184


Font Family (Familia de fuentes)

El estilo de la fuente que se va a utilizar en las pestañas del editor.Tamaño de fuente

El tamaño de la fuente que se va a utilizar en las pestañas del editor.Antialiased Fonts (Fuentes suavizadas)

AWS Cloud9 intenta suavizar la visualización de texto en las pestañas del editor.Show Print Margin (Mostrar margen de impresión)

Mostrar una línea vertical en las pestañas del editor después de la posición especificada del carácter.Mouse Scroll Speed (Velocidad de desplazamiento del ratón)

La velocidad relativa del desplazamiento del ratón en las pestañas del editor. Los valores más altosproducen un desplazamiento más rápido.

Cursor Style (Estilo del cursor)

El estilo y el comportamiento del cursor en las pestañas del editor.

Los valores válidos son:• Ace (As): para mostrar el cursor como una barra vertical que es relativamente más ancha que Slim

(Fina).• Slim (Fina): para mostrar el cursor como una barra vertical relativamente fina.• Smooth (Suave): para mostrar el cursor como una barra vertical que es relativamente más ancha

que Slim (Fina) y que parpadea más suavemente que Slim (Fina).• Smooth and Slim (Suave y fina): para mostrar el cursor como una barra vertical que es

relativamente fina y que parpadea más suavemente que la de Slim (Fina).• Wide (Ancha): para mostrar el cursor como una barra vertical relativamente ancha.

Merge Undo Deltas (Combinar deltas de deshacer)

• Always (Siempre): para permitir que se reviertan los conflictos de fusiones.• Never (Nunca): para no permitir nunca que se reviertan los conflictos de fusiones.• Timed (Con tiempo): para permitir que los conflictos de fusiones se reviertan después de un periodo de

tiempo determinado.

Enable Wrapping For New Documents (Habilitar el ajuste de documentos nuevos)

AWS Cloud9 ajusta el código en los archivos nuevos.

InputComplete As You Type (Completar al escribir)

AWS Cloud9 intenta completar el texto si es posible a medida que lo escribe.Complete On Enter (Completar al pulsar Intro)

AWS Cloud9 intenta completar el texto a medida que lo escribe después de presionar Enter (Intro).Highlight Variable Under Cursor (Resaltar variable bajo cursor)

AWS Cloud9 resalta todas las referencias en el código a la variable seleccionada.

185


Use Cmd-Click for Jump to Definition (Utilizar Cmd-clic para ir a definición)

AWS Cloud9 va a cualquier definición original de código en la que se haga clic mientras se mantienepulsada la tecla Command en Mac o Ctrl en Windows.

Consejos y advertenciasEnable Hints and Warnings (Habilitar consejos y advertencias)

AWS Cloud9 muestra mensajes de consejos y advertencias aplicables.Ignore Messages Matching Regex (Omitir mensajes que coinciden con Regex)

AWS Cloud9 no muestra ningún mensaje que coincida con la expresión regular especificada. Paraobtener más información, consulte Writing a regular expression pattern en JavaScript RegularExpressions en Mozilla Developer Network.

Ejecución y depuraciónSave All Unsaved Tabs Before Running (Guardar todas las pestañas no guardadas antes de ejecutar)

Antes de ejecutar el código asociado, AWS Cloud9 intenta guardar todos los archivos sin guardar conpestañas abiertas.

Vista previaPreview Running Apps (Vista previa de aplicaciones en ejecución)

AWS Cloud9 intenta mostrar una vista previa de la salida del código en la pestaña activa cuando seselecciona el botón Preview (Vista previa).

Default Previewer (Visor de vista previa predeterminado)

El formato que utiliza AWS Cloud9 para obtener una vista previa de la salida de código.

Los valores válidos son:• Raw (Sin formato): para intentar ver la salida del código en un formato plano.• Browser (Navegador): para intentar ver la salida del código en un formato que es el preferido de los

navegadores web.When Saving Reload Previewer (Recargar el visor de vista previa al guardar)

El comportamiento que utiliza AWS Cloud9 para la vista previa de la salida de código cuando seguarda un archivo de código.

Los valores válidos son:• Only on Ctrl-Enter (Solo con Ctrl-Intro): para intentar obtener una vista previa de la salida del código

cada vez que se pulsa Ctrl+Enter (Ctrl+Intro) en la pestaña de código actual.• Always (Siempre): para intentar obtener una vista previa de la salida del código cuando se guarda

un archivo de código.

CompilaciónAutomatically Build Supported Files (Compilar automáticamente archivos compatibles)

AWS Cloud9 intenta compilar automáticamente el código actual si se activa una acción de compilacióny el código está en un formato compatible.

186


AWS Cloud9 Guía del usuarioTrabajar con la configuración deusuarios y de proyectos de AWS

Trabajar con la configuración de usuarios yproyectos de AWS en el AWS Cloud9 IntegratedDevelopment Environment (IDE)

La configuración de los servicios de AWS, ubicada en el panel AWS Settings (Configuración de AWS) de lapestaña Preferences (Preferencias), incluye los siguientes tipos de configuración:

• Qué región de AWS utilizar en la ventana AWS Resources (Recursos de AWS)• usar o no credenciales temporales administradas de AWS• si se muestra el editor de plantillas del modelo de aplicaciones sin servidor de AWS (AWS SAM) en texto

sin formato o modo visual

Para ver o cambiar esta configuración, elija AWS Cloud9, Preferences (AWS Cloud9, Preferencias) en labarra de menús de un IDE para un entorno.

En la siguiente lista, la configuración de nivel de proyecto se aplica únicamente al entorno de desarrollo deAWS Cloud9 actual, mientras que la configuración de nivel de usuario se aplica a cada entorno asociadocon su usuario de IAM. Para obtener más información, consulte Aplicar la configuración del proyecto actualde un entorno a otro (p. 173) y Compartir la configuración de usuario con otro usuario (p. 179).

• Configuración de nivel de proyecto (p. 187)• Configuración de nivel de usuario (p. 187)

Configuración de nivel de proyectoRegión de AWS

Qué región de AWS se va a utilizar en la sección Lambda de los recursos de AWS.AWS managed temporary credentials (Credenciales temporales administradas de AWS)

Si está habilitada, utiliza credenciales temporales administradas de AWS al llamar a los servicios deAWS desde la AWS CLI, el shell de AWS o código del SDK de AWS desde un entorno. Para obtenermás información, consulte Credenciales temporales administradas de AWS (p. 537).

Configuración de nivel de usuarioUso del editor visual AWS SAM

Si está activada, muestra el editor de plantillas del modelo de aplicaciones sin servidor de AWS (AWSSAM) en modo visual al utilizar la sección Lambda de la ventana AWS Resources (Recursos de AWS).Si está desactivada, muestra el editor en modo de texto.

Trabajo con enlaces de teclado en el AWS Cloud9Integrated Development Environment (IDE)

Los enlaces de teclado definen sus combinaciones de teclas de acceso directo. Los enlaces de teclado seaplican en todos los entorno de desarrollo de AWS Cloud9 asociados a su usuario de IAM. A medida querealiza cambios en los enlaces de teclado, AWS Cloud9 los envía a la nube y los asocia con su usuario

187

AWS Cloud9 Guía del usuarioVisualización o cambio de los enlaces de teclado

de IAM. AWS Cloud9 también examina constantemente la nube para comprobar si hay cambios en losenlaces de teclado asociados a su usuario de IAM y aplica estos cambios en el entorno actual.

Puede compartir sus enlaces de teclado con otros usuarios.

• Visualización o cambio de los enlaces de teclado (p. 188)• Uso compartido de sus enlaces de teclado con otro usuario (p. 188)• Cambio del modo de teclado (p. 188)• Cambio de los enlaces de teclado de su sistema operativo (p. 189)• Cambio de enlaces de teclado específicos (p. 189)• Eliminación de todos los enlaces de teclado personalizados (p. 190)

Visualización o cambio de los enlaces de teclado1. En la barra de menús, elija AWS Cloud9 y, a continuación, Preferences (Preferencias).2. Para ver los enlaces de teclado en todos sus entorno, en la pestaña Preferences (Preferencias), en el

panel de navegación lateral, elija Keybindings (Enlaces de teclado).3. Para cambiar sus enlaces de teclado en todos sus entorno, en el panel Keybindings (Enlaces de

teclado), cambie la configuración que desee.4. Para aplicar los cambios a cualquier entorno, simplemente abra ese entorno. Si ese entorno ya está


Para obtener más información, consulte los siguientes temas:

• Referencia de enlaces de teclado predeterminados para MacOS (p. 193)• Referencia de enlaces de teclado Vim para MacOS (p. 204)• Referencia de enlaces de teclado Emacs para MacOS (p. 216)• Referencia de enlaces de teclado Sublime para MacOS (p. 227)• Referencia de enlaces de teclado predeterminados para Windows/Linux (p. 239)• Referencia de enlaces de teclado Vim para Windows/Linux (p. 251)• Referencia de enlaces de teclado Emacs para Windows/Linux (p. 262)• Referencia de enlaces de teclado Sublime para Windows/Linux (p. 273)

Uso compartido de sus enlaces de teclado con otrousuario1. En el entorno de origen y de destino, en la barra de menús del AWS Cloud9 IDE, elija AWS Cloud9,

Open Your Keymap (AWS Cloud9, Abrir su Keymap).2. En el entorno de origen, copie el contenido de la pestaña keybindings.settings que se muestra.3. En el entorno de destino, sobrescriba el contenido de la pestaña keybindings.settings con el contenido

copiado del entorno de origen.4. En el entorno de destino, guarde la pestaña keybindings.settings.

Cambio del modo de tecladoPuede cambiar el modo de teclado que utiliza el AWS Cloud9 IDE para interactuar con el texto en el editoren todos los entorno asociados a su usuario de IAM.

188

AWS Cloud9 Guía del usuarioCambio de los enlaces de teclado de su sistema operativo

1. En la barra de menús, elija AWS Cloud9 y, a continuación, Preferences (Preferencias).2. En el panel de navegación lateral, en la pestaña Preferences (Preferencias), elija Keybindings (Enlaces

de teclado).3. En Keyboard Mode (Modo de teclado), elija uno de los siguientes modos de teclado:

• Default (Predeterminado) para utilizar un conjunto de enlaces de teclado predeterminados.• Vim para utilizar el modo Vim. Para obtener más información, consulte el sitio web de archivos de

ayuda de Vim.• Emacs, para utilizar el modo Emacs. Para obtener más información, consulte The Emacs Editor en el

sitio web del sistema operativo GNU.• Sublime para utilizar el modo Sublime. Para obtener más información, consulte el sitio web de la

documentación de texto Sublime.

Cambio de los enlaces de teclado de su sistemaoperativoPuede cambiar el conjunto de enlaces de teclado del sistema operativo que el AWS Cloud9 IDE reconoceen todos los entorno asociados a su usuario de IAM.


de teclado).3. En Operating System (Sistema operativo), elija uno de los siguientes sistemas operativos:

• Auto (Automático) para que el AWS Cloud9 IDE intente detectar qué conjunto de enlaces de tecladodel sistema operativo se va a utilizar.

• MacOS para que el AWS Cloud9 IDE utilice los enlaces de teclado enumerados con formato de Mac.• Windows/Linux para que el AWS Cloud9 IDE utilice los enlaces de teclado enumerados con formatos

de Windows y Linux.

Cambio de enlaces de teclado específicosPuede cambiar los enlaces de teclado individuales en todos los entorno asociados a su usuario de IAM.

Para cambiar los enlaces de teclado de uno en uno

1. En la barra de menús, elija AWS Cloud9 y, a continuación, Preferences (Preferencias).2. En el panel de navegación lateral, en la pestaña Preferences (Preferencias), elija Keybindings

(Enlaces de teclado).3. En la lista de enlaces de teclado, haga doble clic en el enlace de teclado de la columna Keystroke

(Combinación de teclas) que desea cambiar.4. Utilice el teclado para especificar la combinación de teclas de sustitución y, a continuación, pulse

Enter.

Note

Para eliminar completamente la combinación de teclas actual, pulse Backspace paraWindows o Linux o pulse Delete para Mac.

Para cambiar varios enlaces de teclado a la vez

1. En la barra de menús, elija AWS Cloud9 y, a continuación, Open Your Keymap (Abrir su Keymap).

189

https://vimhelp.appspot.com/

https://vimhelp.appspot.com/

https://www.gnu.org/software/emacs/manual/html_node/emacs/index.html

https://www.sublimetext.com/docs/3/

AWS Cloud9 Guía del usuarioEliminación de todos los enlaces de teclado personalizados

2. En el archivo keybindings.settings, defina los enlaces de teclado que desea cambiar, porejemplo:

[ { "command": "addfavorite", "keys": { "win": ["Ctrl-Alt-F"], "mac": ["Ctrl-Option-F"] } }, { "command": "copyFilePath", "keys": { "win": ["Ctrl-Shift-F"], "mac": ["Alt-Shift-F"] } }]

En el ejemplo, addFavorite y copyFilePath son los nombres de los enlaces de teclado incluidosen la columna Keystroke (Combinación de teclas) del panel Keybindings (Enlaces de teclado) en lapestaña Preferences (Preferencias). Los enlaces de teclado le que interesan son win y mac paraWindows o Linux y Mac, respectivamente.

Para aplicar los cambios, guarde el archivo keybindings.settings. Los cambios deberíanaparecer en el panel Keybindings (Enlaces de teclado) tras un breve retraso.

Eliminación de todos los enlaces de tecladopersonalizadosPuede eliminar todos los enlaces de teclado personalizados y restaurarlos a sus valores predeterminados,en todos los entorno asociados a su usuario de IAM.

Warning

Esta acción no se puede deshacer.


de teclado).3. Elija Reset to Defaults (Restablecer valores predeterminados).

Trabajar con temas en el AWS Cloud9 IntegratedDevelopment Environment (IDE)

Un tema define los colores generales del IDE. Esto se aplica en todos los entorno de desarrollo de AWSCloud9 asociados a su usuario de IAM. A medida que realiza cambios en el tema, AWS Cloud9 los envíaa la nube y los asocia con su usuario de IAM. AWS Cloud9 también examina constantemente la nube paracomprobar si hay cambios en el tema asociado a su usuario de IAM y aplica estos cambios en el entornoactual.

Puede compartir cualquier anulación de tema personalizado que defina con otros usuarios.

190

AWS Cloud9 Guía del usuarioVer o cambiar temas

• Ver o cambiar temas (p. 191)• Valores generales de configuración de temas que puede cambiar (p. 191)• Reemplazos de temas que puede definir con código (p. 191)• Compartir reemplazos de temas con otro usuario (p. 192)

Ver o cambiar temas1. En la barra de menús, elija AWS Cloud9 y, a continuación, Preferences (Preferencias).2. Para ver los temas de todos sus entorno, en la pestaña Preferences (Preferencias), en el panel de

navegación lateral, elija Themes (Temas).3. Para cambiar los temas en todos sus entorno, en el panel Themes (Temas), cambie la configuración

que desee. Para cambiar partes del tema mediante código, elija el enlace de la hoja de estilos.4. Para aplicar los cambios a otro de sus entorno, simplemente abra dicho entorno. Si ese entorno ya está


Valores generales de configuración de temas quepuede cambiarPuede cambiar los siguientes tipos generales de configuración de temas en la pestaña Preferences(Preferencias) del panel Themes (Temas).

Tema Flat

Aplica el tema flat integrado en todo el AWS Cloud9 IDE.Tema Classic

Aplica el tema classic integrado en todo el AWS Cloud9 IDE.Tema Syntax

Aplica el tema seleccionado a los archivos de código de todo el AWS Cloud9 IDE.

Reemplazos de temas que puede definir con códigoPuede reemplazar partes del tema general en el AWS Cloud9 IDE. Estos reemplazos persistirán incluso sicambia el tema general propiamente en el AWS Cloud9 IDE.

Por ejemplo, supongamos que desea cambiar el color de fondo de los títulos al abrir pestañas por amarillo,independientemente de la configuración relacionada para el tema general actual que se aplica en el AWSCloud9 IDE.

En primer lugar, utilice las herramientas para desarrolladores del navegador web para determinar la claseCSS para la parte del tema que desea cambiar. Por ejemplo, haga lo siguiente para Google Chrome.

1. Elija Customize and control Google Chrome (Personalizar y controlar Google Chrome), More tools (Másherramientas), Developer tools (Herramientas para desarrolladores).

2. En el panel Developer tools (Herramientas para desarrolladores), elija Select an element in the page toinspect it (Seleccionar un elemento en la página para examinarlo).

3. Detenga el ratón sobre la parte del IDE que desea cambiar. En este ejemplo, detenga el ratón sobre eltítulo de una pestaña abierta.

191

AWS Cloud9 Guía del usuarioCompartir reemplazos de temas con otro usuario

4. Anote el nombre de la clase CSS. En este ejemplo, el nombre de la clase CSS para el título de unapestaña abierta es sessiontab_title.

A continuación, añada un selector de clases CSS correspondiente a su archivo styles.css.

1. En la barra de menús, elija AWS Cloud9 y, a continuación, Preferences (Preferencias). En el panel denavegación lateral, seleccione Themes (Temas). A continuación, elija el enlace a su hoja de estilos.

2. En el archivo styles.css, agregue el selector de clases CSS. En este ejemplo, va a utilizar el selector.sessiontab_title para establecer background-color en yellow.

.sessiontab_title { background-color: yellow;}

Por último, guarde el archivo styles.css y observe el cambio en el tema. En este ejemplo, el color defondo de los títulos de las pestañas abiertas cambia a amarillo. Incluso si cambia el tema general en elAWS Cloud9 IDE, prevalecerán los reemplazos de CSS del archivo styles.css.

Note

Para revertir este reemplazo de tema, elimine el código anterior del archivo styles.css y, acontinuación, guarde el archivo de nuevo.

Compartir reemplazos de temas con otro usuario1. En el entorno de origen y de destino, en la barra de menús del AWS Cloud9 IDE, elija AWS Cloud9,

Open Your Stylesheet (AWS Cloud9, Abrir su hoja de estilos).2. En el entorno de origen, copie el contenido de la pestaña styles.css que se muestra.3. En el entorno de destino, sobrescriba el contenido de la pestaña styles.css por el contenido copiado del

entorno de origen.4. En el entorno de destino, guarde la pestaña styles.css.

Trabajo con scripts de inicialización en el AWSCloud9 Integrated Development Environment (IDE)

Warning

Actualmente, la capacidad para añadir código a un script del IDE es una característicaexperimental y no es totalmente compatible. Si decide añadir código a un script de inicialización,lo hará por su cuenta y riesgo. AWS Cloud9 se reserva el derecho a cambiar esta funcionalidaden cualquier momento.

Un script de inicialización define el código de inicialización personalizado para ejecutar en su IDE despuésde que se carguen todos los complementos. Esto se aplica en todos los entorno de desarrollo de AWSCloud9 asociados a su usuario de IAM. A medida que realiza cambios en el script de inicialización,AWS Cloud9 los envía a la nube y los asocia con su usuario de IAM. AWS Cloud9 también examinaconstantemente la nube para comprobar si hay cambios en el script de inicialización asociado a su usuariode IAM y aplica estos cambios en el entorno actual.

192

AWS Cloud9 Guía del usuarioVer o cambiar el script de inicialización

Puede compartir el script de inicialización con otros usuarios.

• Ver o cambiar el script de inicialización (p. 193)• Compartir el script de inicialización con otro usuario (p. 193)

Ver o cambiar el script de inicialización1. Para ver el script de inicialización, en la barra de menús, elija AWS Cloud9, Open Your Init Script (Abrir

script de inicialización).2. Para cambiar el script de inicialización, en la pestaña init.js, utilice un código para cambiar el

comportamiento del script de inicialización.3. Para aplicar los cambios a otro entorno, solo tiene que abrir el entorno al que desea aplicarlos. Si ese

entorno ya está abierto, actualice la pestaña del navegador web para ese entorno.

Compartir el script de inicialización con otro usuario1. En el entorno de origen y de destino, en la barra de menús de AWS Cloud9 IDE, elija AWS Cloud9,

Open Your Init Script (Abrir script de inicialización).2. En el entorno de origen, copie el contenido de la pestaña init.js que se muestra.3. En el entorno de destino, sobrescriba el contenido de la pestaña init.js por el contenido copiado del

entorno de origen.4. En el entorno de destino, guarde la pestaña init.js.

Referencia de enlaces de teclado predeterminadospara MacOS para el AWS Cloud9 IntegratedDevelopment Environment (IDE)

A continuación, se ofrece una lista de los enlaces de teclado del modo de teclado predeterminado para lossistemas operativos MacOS en el AWS Cloud9 IDE.

Para obtener más información, en el AWS Cloud9 IDE:

1. En la barra de menús, elija AWS Cloud9 y, a continuación, Preferences (Preferencias).2. En la pestaña Preferences (Preferencias), elija Keybindings (Enlaces de teclado).3. En Keyboard Mode (Modo de teclado), elija Default (Predeterminado).4. En Operating System (Sistema operativo), elija MacOS.

Consulte también Trabajo con enlaces de teclado (p. 187).

• General (p. 194)• Pestañas (p. 196)• Paneles (p. 197)• Editor de código (p. 198)• emmet (p. 203)

193

AWS Cloud9 Guía del usuarioGeneral

• Terminal (p. 204)• Ejecución y depuración (p. 204)

General

Descripción Enlace de teclado Comando

Añadir la selección como unaexpresión de inspección

Command-Shift-C addwatchfromselection

Eliminar la selección de corte delportapapeles

Esc clearcut

Mostrar el menú contextual definalización de un código

Control-Space | Option-Space

complete

Completar el código y luegosobrescribir

Control-Shift-Space |Option-Shift-Space

completeoverwrite

Copiar la selección en elportapapeles

Command-C copy

Cortar la selección en elportapapeles

Command-X cut

Expandir el código siempre quesea necesario

Tab expandSnippet

Mostrar la barra para buscar yreemplazar en el documentoactual

Command-F find

Seleccionar todas lascoincidencias en el documentoactual

Control-Option-G findAll

Ir a la siguiente coincidenciaen el documento actual dela consulta de búsquedaintroducida en último lugar

Command-G findnext

Ir a la coincidencia anterioren el documento actual de laconsulta de búsqueda que se haintroducido en último lugar

Command-Shift-G findprevious

Mostrar todas las referencias alsímbolo conocidas en el punto deinserción en el archivo activo enel editor

Shift-F3 findReferences

Abrir la ventana Environment(Entorno) y, a continuación, crearla lista de los archivos activos

Shift-Esc focusTree

Volver a formatear el códigoJavaScript seleccionado

Command-Shift-B formatcode

194



Abrir el recuadro go to line (ir alínea)

Command-L gotoline

Ocultar la barra de buscar yreemplazar, si se muestra

Esc hidesearchreplace

Ir a la definición de la variable ofunción en el cursor

F3 jumptodef

Si hay una función de Lambdalocal seleccionada en la secciónLambda de AWS Resources(Recursos de AWS), intentacargar la función en Lambdacomo una función remota

Command-Shift-U lambdaUploadFunction

Crear un archivo nuevo Control-N newfile

Mostrar la pestaña Preferences(Preferencias)

Command-, openpreferences

Abrir una pestaña Terminaly, a continuación, ir a lacarpeta principal del archivoseleccionado en la lista dearchivos

Command-Option-L opentermhere

Pegar el contenido actual delportapapeles en el cursor

Command-V paste

Mostrar sugerencias paracorregir errores

Command-F3 quickfix

Rehacer la última acción Command-Shift-Z | Command-Y

redo

Actualizar el panel de vista previa Command-Enter reloadpreview

Iniciar una refactorización decambio de nombre para laselección

Option-Command-R renameVar

Abrir la barra de búsqueda yreemplazo en el documentoactual centrándose en laexpresión replace with(Reemplazar por)

Option-Command-F replace

Volver a ejecutar el script deinicialización

Command-Enter rerunInitScript

Restablecer el entorno Command-R restartc9

Restablecer la última versiónguardada del archivo actual

Control-Shift-Q reverttosaved

Restablecer la versión guardadade cada archivo abierto

Option-Shift-Q reverttosavedall

195

AWS Cloud9 Guía del usuarioPestañas


Guardar el archivo actual en eldisco

Command-S save

Guardar el archivo actual en eldisco con otro nombre

Command-Shift-S saveas

Mostrar la barra de buscar yreemplazar para varios archivos

Shift-Command-F searchinfiles

Mostrar el cuadro de diálogoProcess List (Lista de procesos)

Command-Option-P showprocesslist

Deshacer la última acción Command-Z undo

Pestañas


Cerrar todas las pestañasabiertas en el panel actual,excepto la pestaña actual

Option-Control-W closeallbutme

Cerrar todas las pestañasabiertas en todos los paneles

Option-Shift-W closealltabs

Cerrar el panel actual Command-Control-W closepane

Cerrar la pestaña actual Option-W closetab

Bajar un panel Control-Command-Down gotopanedown

Ir un panel a la izquierda Control-Command-Left gotopaneleft

Ir un panel a la derecha Control-Command-Right gotopaneright

Ir un panel hacia arriba Control-Command-Up gottopaneup

Ir una pestaña a la izquierda Command-[ gototableft

Ir una pestaña a la derecha Command-] gototabright

Mover la pestaña actual un panelhacia abajo o, si la pestaña yaestá en la parte inferior, crear allíuna pestaña dividida

Command-Option-Shift-Down

movetabdown

Mover la pestaña actual a laizquierda o, si la pestaña ya estáen la parte izquierda, crear allíuna pestaña dividida

Command-Option-Shift-Left

movetableft

Mover la pestaña actual a laderecha o, si la pestaña ya estáen la parte derecha, crear allí unapestaña dividida

Command-Option-Shift-Right

movetabright

196

AWS Cloud9 Guía del usuarioPaneles


Mover la pestaña actual un panelhacia arriba o, si la pestaña yaestá en la parte superior, crearallí una pestaña dividida

Command-Option-Shift-Up movetabup

Ir al siguiente panel Option-Esc nextpane

Ir a la siguiente pestaña Option-Tab nexttab

Ir al panel anterior Option-Shift-Esc previouspane

Ir a la pestaña anterior Option-Shift-Tab previoustab

Volver a la última pestaña Esc refocusTab

Abrir de nuevo la última pestaña Option-Shift-T reopenLastTab

Mostrar la pestaña actual en elárbol de archivos

Command-Shift-L revealtab

Ir a la décima pestaña Command-0 tab0

Ir a la primera pestaña Command-1 tab1

Ir a la segunda pestaña Command-2 tab2

Ir a la tercera pestaña Command-3 tab3

Ir a la cuarta pestaña Command-4 tab4

Ir a la quinta pestaña Command-5 tab5

Ir a la sexta pestaña Command-6 tab6

Ir a la séptima pestaña Command-7 tab7

Ir a la octava pestaña Command-8 tab8

Ir a la novena pestaña Command tab9

Paneles


Mostrar la ventana Go (Ir) enel modo Go to Anything (Ir acualquier punto)

Command-E|Command-P gotoanything

Mostrar la ventana Go (Ir) enel modo Go to Command (Ir acomando)

Command-. gotocommand

Mostrar la ventana Go (Ir) en elmodo Go to File (Ir a archivo).

Command-O gotofile

197

AWS Cloud9 Guía del usuarioEditor de código


Mostrar la ventana Go (Ir) enel modo Go to Symbol (Ir asímbolo).

Command-Shift-O gotosymbol

Mostrar la ventana Outline(Esquema)

Command-Shift-E outline

Mostrar la ventana Console(Consola) si está oculta uocultarla si se muestra

Control-Esc toggleconsole

Mostrar la ventana Environment(Entorno) si está oculta uocultarla si se muestra

Command-U toggletree

Editor de código


Añadir un cursor una línea porencima del cursor activo, o si yase ha añadido un cursor, agregarotro cursor por encima de ese

Control-Option-Up addCursorAbove

Añadir un segundo cursor unalínea por encima del cursoractivo, o si ya se ha añadidoun segundo cursor, mover elsegundo cursor una línea porencima

Control-Option-Shift-Up addCursorAboveSkipCurrent

Añadir un cursor una línea pordebajo del cursor activo, o si yase ha añadido un cursor, añadirotro cursor por debajo de ese

Control-Option-Down addCursorBelow

Añadir un segundo cursor unalínea por debajo del cursoractivo, o si ya se ha añadidoun segundo cursor, mover elsegundo cursor una línea pordebajo

Control-Option-Shift-Down

addCursorBelowSkipCurrent

Mover todos los cursores almismo espacio que el cursoractivo en cada una de sus líneassi no están alineados

Control-Option-A alignCursors

Retroceder un espacio Control-Backspace| Shift-Backspace |Backspace

backspace

Aplicar sangría de un tabulador ala selección

Control-] blockindent

198



Quitar la sangría de la selecciónun tabulador

Control-[ blockoutdent

Controlar si el foco se puedecambiar desde el editor a otraparte en el IDE

Command-Z | Command-Shift-Z | Command-Y

cancelBrowserUndoInAce

Centrarse en la selección Control-L centerselection

Copiar el contenido de la línea ypegarlo una línea por debajo

Command-Option-Down copylinesdown

Copiar el contenido de la línea ypegarlo una línea por encima

Command-Option-Up copylinesup

Eliminar un espacio Delete | Control-Delete| Shift-Delete

del

Copiar el contenido de laselección y pegar el contenidocopiado inmediatamentedespués de la selección

Command-Shift-D duplicateSelection

Incluir el contenido de la líneaactual en la selección

Command-Shift-L expandtoline

Incluir hasta el siguiente símbolocoincidente en la selección

Control-Shift-M expandToMatching

Plegar el código seleccionado o,si hay seleccionada una unidadplegada, desplegarla

Command-Option-L |Command-F1

fold

Plegar todos los elementosplegables

Control-Command-Option-0 foldall

Plegar todos los elementosplegables, excepto el ámbitoactual de selección

Command-Option-0 foldOther

Bajar una línea Down | Control-N golinedown

Subir una línea Up | Control-P golineup

Ir al final del archivo Command-End | Command-Down

gotoend

Ir un espacio a la izquierda Left | Control-B gotoleft

Ir al final de la línea actual Command-Right | End |Control-E

gotolineend

Ir al comienzo de la línea actual Command-Left | Home |Control-A

gotolinestart

Ir al siguiente error F4 goToNextError

Bajar una página Page Down | Control-V gotopagedown

199



Subir una página Page Up gotopageup

Ir al error anterior Shift-F4 goToPreviousError

Ir un espacio a la derecha Right | Control-F gotoright

Ir al principio del archivo Command-Home | Command-Up

gotostart

Ir una palabra a la izquierda Option-Left gotowordleft

Ir una palabra a la derecha Option-Right gotowordright


Tab indent

Ir al símbolo coincidente en elámbito actual

Control-P jumptomatching

Aumentar el tamaño de la fuente Command-+ | Command-= largerfont

Reducir el número a la izquierdadel cursor en 1, si se trata de unnúmero

Option-Shift-Down modifyNumberDown

Aumentar el número a laizquierda del cursor en 1, si setrata de un número

Option-Shift-Up modifyNumberUp

Mover la selección una líneahacia abajo

Option-Down movelinesdown

Mover la selección una líneahacia arriba

Option-Up movelinesup


Shift-Tab outdent

Activar el modo de sobrescriturao desactivarlo si está activado

Insert overwrite

Bajar una página Option-Page Down pagedown

Subir una página Option-Page Up pageup

Eliminar la línea actual Command-D removeline

Eliminar desde el cursor hasta elfinal de la línea actual

Control-K removetolineend

Eliminar desde el comienzo de lalínea actual hasta el cursor

Command-Backspace removetolinestart

Eliminar la palabra situada a laizquierda del cursor

Option-Backspace |Control-Option-Backspace

removewordleft

Eliminar la palabra situada a laderecha del cursor

Option-Delete removewordright

200



Reproducir pulsaciones delteclado previamente registradas

Command-Shift-E replaymacro

Seleccionar todo el contenidoseleccionable

Command-A selectall

Incluir la línea siguiente abajo enla selección

Shift-Down | Control-Shift-N

selectdown

Incluir el siguiente espacio ala izquierda del cursor en laselección

Shift-Left | Control-Shift-B

selectleft

Incluir el resto de la línea actualen la selección, comenzandodesde el cursor

Shift-End selectlineend

Incluir desde el comienzo de lalínea actual en la selección hastael cursor

Shift-Home selectlinestart

Incluir más seleccionescoincidentes que están despuésde la selección

Control-Option-Right selectMoreAfter

Incluir más seleccionescoincidentes que están antes dela selección

Control-Option-Left selectMoreBefore

Incluir la siguiente seleccióncoincidente que está después dela selección

Control-Option-Shift-Right

selectNextAfter

Incluir la siguiente seleccióncoincidente que está antes de laselección

Control-Option-Shift-Left

selectNextBefore

Seleccionar o buscar la siguienteselección coincidente

Control-G selectOrFindNext

Seleccionar o buscar la seleccióncoincidente anterior

Control-Shift-G selectOrFindPrevious

Incluir desde el cursor hasta elfinal de la página actual en laselección

Shift-Page Down selectpagedown

Incluir desde el cursor hasta elcomienzo de la página actual enla selección

Shift-Page Up selectpageup

Incluir el siguiente espacio ala derecha del cursor en laselección

Shift-Right selectright

Incluir desde el cursor hastael final del archivo actual en laselección

Command-Shift-End |Command-Shift-Down

selecttoend

201



Incluir desde el cursor hastael final de la línea actual en laselección

Command-Shift-Right |Shift-End | Control-Shift-E

selecttolineend

Incluir desde el comienzo de lalínea actual hasta el cursor en laselección

Command-Shift-Left |Control-Shift-A

selecttolinestart

Incluir desde el cursor hasta elsiguiente símbolo coincidente enel ámbito actual

Control-Shift-P selecttomatching

Incluir desde el cursor hasta elcomienzo del archivo actual en laselección

Command-Shift-Home |Command-Shift-Up

selecttostart

Incluir la línea siguiente arriba enla selección

Shift-Up | Control-Shift-Up

selectup

Incluir la siguiente palabra ala izquierda del cursor en laselección

Option-Shift-Left selectwordleft

Incluir la siguiente palabra ala derecha del cursor en laselección

Option-Shift-Right selectwordright


Command-, showSettingsMenu

Borrar todas las seleccionesanteriores

Esc singleSelection

Disminuir el tamaño de la fuente Command-- smallerfont

Si se seleccionan varias líneas,reorganizarlas de una formaordenada

Command-Option-S sortlines

Añadir un cursor al final de lalínea actual

Control-Option-L splitIntoLines

Mover el contenido del cursoral final de la línea, a una líneapropia

Control-O splitline

Rodear la selección concaracteres de comentariode bloques o, si los hubiese,eliminarlos

Command-Shift-/ toggleBlockComment

Añadir caracteres de comentariode línea al principio de cada líneaseleccionada o eliminarlos si yaestán

Command-/ togglecomment

Plegar código o quitar el plegadode código si está plegado

F2 toggleFoldWidget

202

AWS Cloud9 Guía del usuarioemmet


Plegar código principal o quitar elplegado si lo está

Option-F2 toggleParentFoldWidget

Comenzar la grabación de lacombinación de teclas o detenersi ya se está grabando

Command-Option-E togglerecording

Ajustar las palabras o detener elajuste de palabras si ya se estánajustando

Control-W toggleWordWrap

Poner la selección completa enminúsculas

Control-Shift-U tolowercase

Poner la selección completa enmayúsculas

Control-U touppercase

Transponer la selección Control-T transposeletters

Desplegar el códigoseleccionado

Command-Option-Shift-L |Command-Shift-F1

unfold

Desplegar el plegado de códigoen todo el archivo

Command-Option-Shift-0 unfoldall

emmet


Evaluar una expresiónmatemática simple (como 2*4 o10/2) y mostrar su resultado

Shift-Command-Y emmet_evaluate_math_expression

Expandir abreviaturas de tipoCSS en el código HTML, XML oCSS, en función de la sintaxis delarchivo actual

Control-Option-E emmet_expand_abbreviation

Atravesar las abreviaturas de tipoCSS expandidas, deteniéndosecon el tabulador

Tab emmet_expand_abbreviation_with_tab

Ir a la siguiente parte del códigoeditable

Shift-Command-. emmet_select_next_item

Ir a la parte del código editableanterior

Shift-Command-, emmet_select_previous_item

Expandir una abreviatura y, acontinuación, colocar la selecciónactual en el último elemento delfragmento generado

Shift-Control-A emmet_wrap_with_abbreviation

203

AWS Cloud9 Guía del usuarioTerminal

Terminal


Abrir una nueva pestañaTerminal

Option-T openterminal

Cambiar entre el editor y lapestaña Terminal

Option-S switchterminal

Ejecución y depuración


Compilar el archivo actual Command-B build

Reanudar el proceso actual enpausa

F8 | Command-\ resume

Ejecutar o depurar la aplicaciónactual

Option-F5 run

Ejecutar o depurar el últimoarchivo ejecutado

F5 runlast

Pasar a la función que está juntoa la pila

F11 | Command-; stepinto

Salir del ámbito de la funciónactual

Shift-F11 | Command-Shift-'

stepout

Saltar la expresión actual en lapila

F10 | Command-' stepover

Parar la ejecución o ladepuración de la aplicaciónactual

Shift-F5 stop

Detener la compilación delarchivo actual

Control-Shift-C stopbuild

Referencia de enlaces de teclado Vim para MacOSpara el AWS Cloud9 Integrated DevelopmentEnvironment (IDE)

A continuación, se ofrece una lista de los enlaces de teclado del modo de teclado Vim para los sistemasoperativos MacOS en el AWS Cloud9 IDE.


1. En la barra de menús, elija AWS Cloud9 y, a continuación, Preferences (Preferencias).

204


2. En la pestaña Preferences (Preferencias), elija Keybindings (Enlaces de teclado).3. En Keyboard Mode (Modo de teclado), elija Vim.4. En Operating System (Sistema operativo), elija MacOS.


• General (p. 205)• Pestañas (p. 207)• Paneles (p. 209)• Editor de código (p. 209)• emmet (p. 214)• Terminal (p. 215)• Ejecución y depuración (p. 215)

General





Esc clearcut



complete



completeoverwrite


Command-C copy


Command-X cut


Tab expandSnippet


Command-F find




Command-G findnext

Ir a la coincidencia anterioren el documento actual de la


205


Descripción Enlace de teclado Comandoconsulta de búsqueda que se haintroducido en último lugar




Shift-Esc focusTree




Command-L gotoline




F3 jumptodef









Command-V paste


Command-F3 quickfix


redo




206













Command-S save








Pestañas













207






movetabdown



movetableft



movetabright





















208


Paneles







Command-O gotofile









Editor de código








Añadir un segundo cursor unalínea por debajo del cursoractivo, o si ya se ha añadidoun segundo cursor, mover el



209


Descripción Enlace de teclado Comandosegundo cursor una línea pordebajo




backspace

Sangrar la selección un tabulador Control-] blockindent












del







Plegar el código seleccionado o,si hay seleccionada una unidadplegada, desplegarla


fold







210




gotoend



gotolineend


gotolinestart







gotostart




Tab indent













Shift-Tab outdent


Insert overwrite



211










removewordleft






Command-A selectall



selectdown



selectleft











selectNextAfter



selectNextBefore





212











selecttoend



selecttolineend



selecttolinestart





selecttostart


Shift-Up | Control-Shift-P

selectup








Esc singleSelection






213




Control-O splitline






F2 toggleFoldWidget














unfold



emmet






214











Terminal












Option-F5 run


F5 runlast





stepout




Shift-F5 stop

215

AWS Cloud9 Guía del usuarioReferencia de enlaces de teclado Emacs para MacOS




Referencia de enlaces de teclado Emacspara MacOS para el AWS Cloud9 IntegratedDevelopment Environment (IDE)

A continuación, se ofrece una lista de los enlaces de teclado del modo de teclado Emacs para los sistemasoperativos MacOS en el AWS Cloud9 IDE.


1. En la barra de menús, elija AWS Cloud9 y, a continuación, Preferences (Preferencias).2. En la pestaña Preferences (Preferencias), elija Keybindings (Enlaces de teclado).3. En Keyboard Mode (Modo de teclado), elija Emacs.4. En Operating System (Sistema operativo), elija MacOS.



General





Esc clearcut



complete



completeoverwrite


Command-C copy

216




Command-X cut


Tab expandSnippet


Command-F find




Command-G findnext






Shift-Esc focusTree




Command-L gotoline




F3 jumptodef






217






Command-V paste


Command-F3 quickfix


redo














Command-S save








218


Pestañas
















movetabdown



movetableft



movetabright









219















Paneles







Command-O gotofile









220


Editor de código














backspace

Sangrar la selección un tabulador Control-] blockindent












del

Copiar el contenido de laselección y pegar el contenido


221


Descripción Enlace de teclado Comandocopiado inmediatamentedespués de la selección





Plegar el código seleccionado;si hay seleccionada una unidadplegada, desplegarla


fold








gotoend



gotolineend


gotolinestart







gotostart




Tab indent




222












Shift-Tab outdent


Insert overwrite










removewordleft






Command-A selectall



selectdown



selectleft





223









selectNextAfter



selectNextBefore













selecttoend



selecttolineend



selecttolinestart





selecttostart


Shift-Up | Control-Shift-Up

selectup

224










Esc singleSelection







Control-O splitline






F2 toggleFoldWidget







Poner toda la selección enminúsculas


Poner toda la selección enmayúsculas


Transponer selección Control-T transposeletters

225





unfold



emmet














Terminal









226

AWS Cloud9 Guía del usuarioReferencia de enlaces de teclado Sublime para MacOS





Option-F5 run


F5 runlast





stepout




Shift-F5 stop



Referencia de enlaces de teclado Sublimepara MacOS para el AWS Cloud9 IntegratedDevelopment Environment (IDE)

A continuación, se ofrece una lista de los enlaces de teclado del modo de teclado Sublime para lossistemas operativos MacOS en el AWS Cloud9 IDE.


1. En la barra de menús, elija AWS Cloud9 y, a continuación, Preferences (Preferencias).2. En la pestaña Preferences (Preferencias), elija Keybindings (Enlaces de teclado).3. En Keyboard Mode (Modo de teclado), elija Sublime.4. En Operating System (Sistema operativo), elija MacOS.



227


General





Esc clearcut



complete



completeoverwrite


Command-C copy


Command-X cut

Eliminar desde el cursor hasta elinicio de la línea

Command-K Command-Backspace | Command-Backspace

delete_to_hard_bol

Eliminar desde el cursor hasta elfinal de la línea

Command-K Command-K | Command-Delete |Control-K

delete_to_hard_eol


Tab expandSnippet


Command-F find

Resaltar todas las coincidenciasde la selección

Control-Command-G find_all_under

Resaltar la siguiente coincidenciade la selección

Option-Command-G find_under

Resaltar alrededor del cursor ytodas las correspondencias delresaltado

Command-D find_under_expand

Resaltar alrededor del cursor ycrear un contorno de todas lascorrespondencias del resaltado

Command-K Command-D find_under_expand_skip

Resaltar la correspondenciaanterior de la selección

Shift-Option-Command-G find_under_previous



228




Command-G findnext


Shift-Command-G findprevious




Shift-Esc focusTree


Control-Option-F formatcode


Control-G gotoline




F12 | Command-Option-Down

jumptodef



Ir al final de la palabra actual Option-Right moveToWordEndRight

Ir al comienzo de la palabraactual

Option-Left moveToWordStartLeft







Command-V paste

229




Command-F3 quickfix


redo





Command-Option-F replace

Reemplazar todas lascoincidencias de expresionesencontradas por la expresiónindicada en la barra de buscar yreemplazar

Control-Option-Enter replaceall

Reemplazar la siguientecoincidencia de expresión debúsqueda por la expresiónindicada en la barra de buscar yreemplazar

Command-Option-E replacenext









Command-S save




Command-Shift-F searchinfiles

Incluir desde el cursor hasta elfinal de la palabra en la selección

Option-Shift-Right selectToWordEndRight

Incluir desde el cursor hastael principio de la palabra en laselección

Option-Shift-Left selectToWordStartLeft

230






Pestañas












Ir una pestaña a la izquierda Command-Shift-[ |Command-Option-Left

gototableft

Ir una pestaña a la derecha Command-Shift-] |Command-Option-Right

gototabright



movetabdown



movetableft



movetabright



Ir a la siguiente pestaña Control-Tab nexttab

231




Ir a la pestaña anterior Control-Shift-Tab previoustab


Abrir de nuevo la última pestaña Command-Shift-T reopenLastTab


Command-E revealtab











Paneles







Command-O gotofile




Command-Shift-R outline


Control-` toggleconsole

232




Command-K Command-B toggletree

Editor de código



Control-Shift-Up addCursorAbove




Control-Shift-Down addCursorBelow







backspace


Control-] blockindent






Centrarse en la selección Command-K Command-C |Control-L

centerselection

233








del




Command-L expandtoline





fold




Command-K Command-1 foldOther




gotoend



gotolineend


gotolinestart

Ir al siguiente error Control-F6 goToNextError



Ir al error anterior Control-Shift-F6 goToPreviousError



gotostart

234






Tab indent

Combinar las líneasseleccionadas en una sola línea

Command-J joinlines


Control-M jumptomatching

Aumentar el tamaño de la fuente Command-= | Command-+ largerfont


Option-Down modifyNumberDown


Option-Up modifyNumberUp


Control-Command-Down movelinesdown


Control-Command-Up movelinesup


Shift-Tab outdent


Insert overwrite



Eliminar el contenido de la líneaactual

Control-Shift-K removeline







removewordleft




Control-Shift-Q replaymacro


Command-A selectall

235





selectdown



selectleft











selectNextAfter



selectNextBefore













selecttoend



selecttolineend

236





selecttolinestart





selecttostart


Shift-Up | Control-Shift-P

selectup








Esc singleSelection



F5 sortlines


Command-Shift-L splitIntoLines


Control-O splitline


Command-Option-/ toggleBlockComment




Command-Option-[ toggleFoldWidget



237




Control-Q togglerecording




Command-K Command-L tolowercase


Command-K Command-U touppercase



Command-Option-] unfold


Command-K Command-0 |Command-K Command-J

unfoldall

emmet














238


Terminal








Compilar el archivo actual F7 | Command-B build




Command-Shift-B run


F5 runlast





stepout




Shift-F5 stop


Control-Break stopbuild

Referencia de enlaces de teclado predeterminadospara Windows / Linux en el AWS Cloud9 IntegratedDevelopment Environment (IDE)

A continuación, se ofrece una lista de los enlaces de teclado del modo de teclado predeterminado para lossistemas operativos Windows/Linux en el AWS Cloud9 IDE.


1. En la barra de menús, elija AWS Cloud9, Preferences (Preferencias).

239


2. En la pestaña Preferences (Preferencias), elija Keybindings (Enlaces de teclado).3. En Keyboard Mode (Modo de teclado), elija Default (Predeterminado).4. En Operating System (Sistema operativo), elija Windows / Linux.



General



Ctrl-Shift-C addwatchfromselection


Esc clearcut


Ctrl-Space | Alt-Space complete


Ctrl-Shift-Space | Alt-Shift-Space

completeoverwrite


Ctrl-C copy


Ctrl-X cut


Tab expandSnippet


Ctrl-F find


Ctrl-Alt-K findall


Ctrl-K findnext

Ir a la coincidencia anterioren el documento actual de la

Ctrl-Shift-K findprevious

240


Descripción Enlace de teclado Comandoconsulta de búsqueda que se haintroducido en último lugar




Shift-Esc focusTree


Ctrl-Shift-B formatcode


Ctrl-G gotoline




F3 jumptodef


Ctrl-Shift-U lambdaUploadFunction

Crear un archivo nuevo Alt-N newfile


Ctrl-, openpreferences


Alt-L opentermhere


Ctrl-V paste


Ctrl-F3 quickfix

Rehacer la última acción Ctrl-Shift-Z | Ctrl-Y redo

Actualizar el panel de vista previa Ctrl-Enter reloadpreview


Ctrl-Alt-R renameVar

241




Alt-Shift-F | Ctrl-H replace


Ctrl-Enter rerunInitScript

Restablecer el entorno Ctrl-R restartc9


Ctrl-Shift-Q reverttosaved


Alt-Shift-Q reverttosavedall


Ctrl-S save


Ctrl-Shift-S saveas


Ctrl-Shift-F searchinfiles


Ctrl-Alt-P showprocesslist

Deshacer la última acción Ctrl-Z undo

Pestañas



Ctrl-Alt-W closeallbutme


Alt-Shift-W closealltabs

Cerrar el panel actual Ctrl-W closepane

Cerrar la pestaña actual Alt-W closetab

Bajar un panel Ctrl-Meta-Down gotopanedown

Ir un panel a la izquierda Ctrl-Meta-Left gotopaneleft

Ir un panel a la derecha Ctrl-Meta-Right gotopaneright

Ir un panel hacia arriba Ctrl-Meta-Up gottopaneup

Ir una pestaña a la izquierda Ctrl-[ gototableft

242



Ir una pestaña a la derecha Ctrl-] gototabright


Ctrl-Meta-Down movetabdown


Ctrl-Meta-Left movetableft


Ctrl-Meta-Right movetabright


Ctrl-Meta-Up movetabup

Ir al siguiente panel Ctrl-` nextpane

Ir a la siguiente pestaña Ctrl-Tab | Alt-` nexttab

Ir al panel anterior Ctrl-Shift-` previouspane

Ir a la pestaña anterior Ctrl-Shift-Tab | Alt-Shift-`

previoustab


Abrir de nuevo la última pestaña Alt-Shift-T reopenLastTab


Ctrl-Shift-L revealtab

Ir a la décima pestaña Ctrl-0 tab0

Ir a la primera pestaña Ctrl-1 tab1

Ir a la segunda pestaña Ctrl-2 tab2

Ir a la tercera pestaña Ctrl-3 tab3

Ir a la cuarta pestaña Ctrl-4 tab4

Ir a la quinta pestaña Ctrl-5 tab5

Ir a la sexta pestaña Ctrl-6 tab6

Ir a la séptima pestaña Ctrl-7 tab7

Ir a la octava pestaña Ctrl-8 tab8

Ir a la novena pestaña Ctrl-9 tab9

243


Paneles



Ctrl-E|Ctrl-P gotoanything


Ctrl-. gotocommand


Ctrl-O gotofile


Ctrl-Shift-O gotosymbol


Ctrl-Shift-E outline


F6 toggleconsole


Ctrl-I toggletree

Editor de código



Ctrl-Alt-Up addCursorAbove


Ctrl-Alt-Shift-Up addCursorAboveSkipCurrent


Ctrl-Alt-Down addCursorBelow

Añadir un segundo cursor unalínea por debajo del cursoractivo, o si ya se ha añadidoun segundo cursor, mover el

Ctrl-Alt-Shift-Down addCursorBelowSkipCurrent

244


Descripción Enlace de teclado Comandosegundo cursor una línea pordebajo


Ctrl-Alt-A alignCursors

Retroceder un espacio Shift-Backspace |Backspace

backspace


Ctrl-] blockindent


Ctrl-[ blockoutdent


Ctrl-Z | Ctrl-Shift-Z |Ctrl-Y


Centrarse en la selección Ctrl-L centerselection


Alt-Shift-Down copylinesdown


Alt-Shift-Up copylinesup

Cortar la selección, o si no hayninguna selección, eliminar unespacio

Shift-Delete cut_or_delete

Eliminar un espacio Delete del


Ctrl-Shift-D duplicateSelection


Ctrl-Shift-L expandtoline


Ctrl-Shift-M expandToMatching


Alt-L | Ctrl-F1 fold


Ctrl-Command-Option-0 foldall


Alt-0 foldOther

Bajar una línea Down golinedown

245



Subir una línea Up golineup

Ir al final del archivo Ctrl-End gotoend

Ir un espacio a la izquierda Left gotoleft

Ir al final de la línea actual Alt-Right | End gotolineend

Ir al comienzo de la línea actual Alt-Left | Home gotolinestart

Ir al siguiente error Alt-E goToNextError

Bajar una página Page Down gotopagedown


Ir al error anterior Alt-Shift-E goToPreviousError

Ir un espacio a la derecha Right gotoright

Ir al principio del archivo Ctrl-Home gotostart

Ir una palabra a la izquierda Ctrl-Left gotowordleft

Ir una palabra a la derecha Ctrl-Right gotowordright


Tab indent


Ctrl-P jumptomatching

Aumentar el tamaño de la fuente Ctrl-+ | Ctrl-= largerfont


Ctrl-Shift-Down modifyNumberDown


Ctrl-Shift-Up modifyNumberUp


Alt-Down movelinesdown


Alt-Up movelinesup


Shift-Tab outdent


Insert overwrite




Ctrl-D removeline

246




Alt-Delete removetolineend


Alt-Backspace removetolinestart


Ctrl-Backspace removewordleft


Ctrl-Delete removewordright


Ctrl-Shift-E replaymacro

Desplazarse hacia abajo en elarchivo actual una línea

Ctrl-Down scrolldown

Desplazarse hacia arriba en elarchivo actual una línea

Ctrl-Up scrollup


Ctrl-A selectall


Shift-Down selectdown


Shift-Left selectleft






Ctrl-Alt-Right selectMoreAfter


Ctrl-Alt-Left selectMoreBefore


Ctrl-Alt-Shift-Right selectNextAfter


Ctrl-Alt-Shift-Left selectNextBefore


Alt-K selectOrFindNext

247




Alt-Shift-K selectOrFindPrevious








Ctrl-Shift-End selecttoend


Alt-Shift-Right selecttolineend


Alt-Shift-Left selecttolinestart


Ctrl-Shift-P selecttomatching


Ctrl-Shift-Home selecttostart


Shift-Up selectup


Ctrl-Shift-Left selectwordleft


Ctrl-Shift-Right selectwordright


Ctrl-, showSettingsMenu


Esc singleSelection

Disminuir el tamaño de la fuente Ctrl-- smallerfont


Ctrl-Alt-S sortlines

248




Ctrl-Alt-L splitIntoLines


Ctrl-O splitline


Ctrl-Shift-/ toggleBlockComment


Ctrl-/ togglecomment


F2 toggleFoldWidget


Alt-F2 toggleParentFoldWidget


Ctrl-Alt-E togglerecording


Ctrl-Q toggleWordWrap


Ctrl-Shift-U tolowercase


Ctrl-U touppercase

Transponer la selección Alt-X transposeletters


Alt-Shift-L | Ctrl-Shift-F1

unfold


Alt-Shift-0 unfoldall

emmet



Shift-Ctrl-Y emmet_evaluate_math_expression

Expandir abreviaturas de tipoCSS en el código HTML, XML o

Ctrl-Alt-E emmet_expand_abbreviation

249


Descripción Enlace de teclado ComandoCSS, en función de la sintaxis delarchivo actual




Shift-Ctrl-. emmet_select_next_item


Shift-Ctrl-, emmet_select_previous_item


Shift-Ctrl-A emmet_wrap_with_abbreviation

Terminal



Alt-T openterminal


Alt-S switchterminal



Compilar el archivo actual Ctrl-B build


F8 resume


Alt-F5 run


F5 runlast


F11 stepinto


Shift-F11 stepout


F10 stepover

250

AWS Cloud9 Guía del usuarioReferencia de enlaces de teclado Vim para Windows/Linux



Shift-F5 stop


Ctrl-Shift-C stopbuild

Referencia de enlaces de teclado Vim paraWindows / Linux en el AWS Cloud9 IntegratedDevelopment Environment (IDE)

A continuación se ofrece una lista de los enlaces de teclado del modo de teclado Vim para los sistemasoperativos Windows/Linux en el AWS Cloud9 IDE.


1. En la barra de menús, elija AWS Cloud9 y, a continuación, Preferences (Preferencias).2. En la pestaña Preferences (Preferencias), elija Keybindings (Enlaces de teclado).3. En Keyboard Mode (Modo de teclado), elija Vim.4. En Operating System (Sistema operativo), elija Windows / Linux.



General





Esc clearcut





completeoverwrite

251




Ctrl-C copy


Ctrl-X cut


Tab expandSnippet


Ctrl-F find


Ctrl-Alt-K findall


Ctrl-K findnext






Shift-Esc focusTree




Ctrl-G gotoline




F3 jumptodef




252






Alt-L opentermhere


Ctrl-V paste


Ctrl-F3 quickfix















Ctrl-S save


Ctrl-Shift-S saveas






253


Pestañas


























previoustab



254















Paneles





Ctrl-. gotocommand


Ctrl-O gotofile






F6 toggleconsole


Ctrl-I toggletree

255


Editor de código








Añadir un segundo cursor unalínea por debajo del cursoractivo, o, si ya se ha añadidoun segundo cursor, mover elsegundo cursor una línea pordebajo





backspace


Ctrl-] blockindent


Ctrl-[ blockoutdent








Corte la selección. Si no hayninguna selección, elimine unespacio



256












Alt-0 foldOther
















Tab indent






257








Alt-Up movelinesup


Shift-Tab outdent


Insert overwrite


Ctrl-D removeline














Ctrl-Up scrollup


Ctrl-A selectall









258
































Shift-Up selectup

259










Esc singleSelection











F2 toggleFoldWidget










Ctrl-U touppercase




unfold

260





emmet














Terminal



Alt-T openterminal







F8 resume

261

AWS Cloud9 Guía del usuarioReferencia de enlaces de teclado

Emacs para Windows/Linux



Alt-F5 run


F5 runlast


F11 stepinto


Shift-F11 stepout


F10 stepover


Shift-F5 stop



Referencia de enlaces de teclado Emacs paraWindows / Linux en el AWS Cloud9 IntegratedDevelopment Environment (IDE)

A continuación se ofrece una lista de los enlaces de teclado del modo de teclado Emacs para los sistemasoperativos Windows/Linux en el AWS Cloud9 IDE.


1. En la barra de menús, elija AWS Cloud9 y, a continuación, Preferences (Preferencias).2. En la pestaña Preferences (Preferencias), elija Keybindings (Enlaces de teclado).3. En Keyboard Mode (Modo de teclado), elija Emacs.4. En Operating System (Sistema operativo), elija Windows / Linux.



262


General





Esc clearcut





completeoverwrite


Ctrl-C copy


Ctrl-X cut


Tab expandSnippet


Ctrl-F find


Ctrl-Alt-K findall


Ctrl-K findnext






Shift-Esc focusTree




Ctrl-G gotoline

263






F3 jumptodef







Alt-L opentermhere


Ctrl-V paste


Ctrl-F3 quickfix















Ctrl-S save

264




Ctrl-Shift-S saveas






Pestañas




















Mover la pestaña actual un panelhacia arriba o, si la pestaña ya


265


Descripción Enlace de teclado Comandoestá en la parte superior, crearallí una pestaña dividida





previoustab















Paneles





Ctrl-. gotocommand


Ctrl-O gotofile



266






F6 toggleconsole


Ctrl-I toggletree

Editor de código













backspace


Ctrl-] blockindent


Ctrl-[ blockoutdent

267






















Alt-0 foldOther













268






Tab indent











Alt-Up movelinesup


Shift-Tab outdent


Insert overwrite


Ctrl-D removeline














Ctrl-Up scrollup


Ctrl-A selectall

269





Incluir el siguiente espacio a laizquierda en la selección




























270










Shift-Up selectup








Esc singleSelection







Ctrl-O splitline






F2 toggleFoldWidget



271










Ctrl-U touppercase




unfold



emmet














272


Terminal



Alt-T openterminal







F8 resume


Alt-F5 run


F5 runlast


F11 stepinto


Shift-F11 stepout


F10 stepover


Shift-F5 stop



Referencia de enlaces de teclado Sublime paraWindows / Linux en el AWS Cloud9 IntegratedDevelopment Environment (IDE)

A continuación, se ofrece una lista de los enlaces de teclado del modo de teclado Sublime para lossistemas operativos Windows/Linux en el AWS Cloud9 IDE.


1. En la barra de menús, elija AWS Cloud9 y, a continuación, Preferences (Preferencias).

273


2. En la pestaña Preferences (Preferencias), elija Keybindings (Enlaces de teclado).3. En Keyboard Mode (Modo de teclado), elija Sublime.4. En Operating System (Sistema operativo), elija Windows / Linux.



General





Esc clearcut


Ctrl-Space complete



completeoverwrite


Ctrl-C copy


Ctrl-X cut

Eliminar desde el cursor hasta elinicio de la línea

Ctrl-Shift-Backspace |Ctrl-K Ctrl-Backspace

delete_to_hard_bol

Eliminar desde el cursor hasta elfinal de la línea

Ctrl-Shift-Delete |Ctrl-K Ctrl-K

delete_to_hard_eol


Tab expandSnippet


Ctrl-F find

Resaltar todas las coincidenciasde la selección

Alt-F3 find_all_under

Resaltar la siguiente coincidenciade la selección

Ctrl-F3 find_under

274



Resaltar alrededor del cursor ytodas las correspondencias parael resaltado

Ctrl-D find_under_expand

Resaltar alrededor delcursor y marcar todas lascorrespondencias para elresaltado

Ctrl-K Ctrl-D find_under_expand_skip

Resaltar la coincidencia anteriorde la selección

Ctrl-Shift-F3 find_under_prev


Ctrl-Alt-K findAll


F3 findnext


Shift-F3 findprevious




Shift-Esc focusTree


Ctrl-Alt-F formatcode


Ctrl-G gotoline




F12 jumptodef



Ir al final de la palabra actual Ctrl-Right moveToWordEndRight

Ir al comienzo de la palabraactual

Ctrl-Left moveToWordStartLeft

275







Alt-L opentermhere


Ctrl-V paste


Ctrl-F3 quickfix






Ctrl-H replace

Reemplazar todas lascoincidencias de expresionesencontradas por la expresiónindicada en la barra de buscar yreemplazar

Ctrl-Alt-Enter replaceall

Reemplazar la siguientecoincidencia de expresión debúsqueda por la expresiónindicada en la barra de buscar yreemplazar

Ctrl-Shift-H replacenext









Ctrl-S save

276




Ctrl-Shift-S saveas



Incluir desde el cursor hasta elfinal de la palabra en la selección

Ctrl-Shift-Right selectToWordEndRight


Ctrl-Shift-Left selectToWordStartLeft




Pestañas












Ir una pestaña a la izquierda Ctrl-Page Up gototableft

Ir una pestaña a la derecha Ctrl-Page Down gototabright





277







Ir a la siguiente pestaña Ctrl-Tab nexttab


Ir a la pestaña anterior Ctrl-Shift-Tab previoustab


Abrir de nuevo la última pestaña Ctrl-Shift-T reopenLastTab


Ctrl-E revealtab











Paneles





Ctrl-. gotocommand

278




Ctrl-O gotofile




Ctrl-R|Ctrl-Shift-R outline


Ctrl-` toggleconsole


Ctrl-K Ctrl-B toggletree

Editor de código













backspace

279




Ctrl-] blockindent


Ctrl-[ blockoutdent




Centrarse en la selección Ctrl-K Ctrl-C centerselection

















Ctrl-K Ctrl-1 foldOther







Ir al siguiente error Ctrl-F6 goToNextError


280




Ir al error anterior Ctrl-Shift-F6 goToPreviousError






Tab indent


Ctrl-J joinlines


Ctrl-M jumptomatching

Aumentar el tamaño de la fuente Ctrl-- | Ctrl-= | Ctrl-+ largerfont


Alt-Down modifyNumberDown


Alt-Up modifyNumberUp


Ctrl-Shift-Down movelinesdown


Ctrl-Shift-Up movelinesup


Shift-Tab outdent


Insert overwrite


Ctrl-Shift-K removeline









281




Ctrl-Shift-Q replaymacro




Ctrl-Up scrollup


Ctrl-A selectall



Incluir el siguiente espacio a laizquierda en la selección






















282
















Shift-Up selectup








Esc singleSelection

Disminuir el tamaño de la fuente Ctrl-- | Ctrl-Shift-= |Ctrl-Shift-+

smallerfont


F9 sortlines


Ctrl-Shift-L splitIntoLines



283






Ctrl-Shift-[ toggleFoldWidget




Ctrl-Q togglerecording




Ctrl-K Ctrl-L tolowercase


Ctrl-K Ctrl-U touppercase



Ctrl-Shift-] unfold


Ctrl-K Ctrl-0 | Ctrl-KCtrl-J

unfoldall

emmet












284





Terminal



Alt-T openterminal





Compilar el archivo actual F7 | Ctrl-B build


F8 resume


Ctrl-Shift-B run


F5 runlast


F11 stepinto


Shift-F11 stepout


F10 stepover


Shift-F5 stop


Ctrl-Break stopbuild

285

AWS Cloud9 Guía del usuarioReferencia de comandos

Referencia de comandos del AWS Cloud9Integrated Development Environment (IDE)

A continuación se ofrece una lista de los comandos predeterminados en el AWS Cloud9 IDE.

Para ejecutar un comando en el AWS Cloud9 IDE:

1. Para mostrar la ventana Go (Ir), seleccione el botón Go (Ir) (el icono de lupa). Si la ventana Go (Ir) noestá visible, elija Window, Go (Ventana, Ir) en la barra de menús.

2. En el cuadro Go to Anything (Ir a cualquier punto), escriba un punto (.) seguido del nombre delcomando.

3. En la lista de comandos coincidentes, realice una de las siguientes acciones:• Elija el comando que se va a ejecutar.• Utilice las teclas de flecha arriba y abajo para elegir un comando y, a continuación, pulse Enter para

ejecutar el comando elegido.


addCursorAbove Añadir un cursor una línea por encima del cursoractivo, o si ya se ha añadido un cursor, agregarotro cursor por encima de ese

addCursorAboveSkipCurrent Añadir un segundo cursor una línea por encima delcursor activo, o si ya se ha añadido un segundocursor, mover el segundo cursor una línea porencima

addCursorBelow Añadir un cursor una línea por debajo del cursoractivo, o si ya se ha añadido un cursor, añadir otrocursor por debajo de ese

addCursorBelowSkipCurrent Añadir un segundo cursor una línea por debajo delcursor activo, o si ya se ha añadido un segundocursor, mover el segundo cursor una línea pordebajo

addfavorite Añadir la carpeta o el archivo seleccionadoa la lista Favorites (Favoritos) de la ventanaEnvironment (Entorno)

addwatchfromselection Añadir la selección como una expresión deinspección

alignCursors Mover todos los cursores al mismo espacio que elcursor activo en cada una de sus líneas si no estánalineados

aws-panel Mostrar la ventana AWS Resources (Recursos deAWS)

backspace Retroceder un espacio

blockindent Aplicar sangría de un tabulador a la selección

blockoutdent Quitar la sangría de la selección un tabulador

286



build Compilar el archivo actual

cancelBrowserAction Cancelar varios enlaces de teclados del navegadorweb integrado que pueden resultar molestos si seactivan por error

cancelBrowserUndoInAce Controlar si el foco se puede cambiar desde eleditor a otra parte en el IDE

centerselection Centrarse en la selección

clearcut Eliminar la selección de corte del portapapeles

clearterm Borrar el búfer en el panel Terminal

clonetab Crear una copia de la pestaña actual en una nuevapestaña

closeallbutme Cerrar todas las pestañas abiertas en el panelactual, excepto la pestaña actual

closealltabs Cerrar todas las pestañas abiertas en todos lospaneles

closealltotheleft Cerrar todas las pestañas a la izquierda de lapestaña actual

closealltotheright Cerrar todas las pestañas a la derecha de lapestaña actual

closepane Cerrar el panel actual

closetab Cerrar la pestaña actual

complete Mostrar el menú contextual de finalización de uncódigo

completeoverwrite Completar el código y luego sobrescribir

convertIndentation Convertir entre pestañas y espacios en el editor

copy Copiar la selección en el portapapeles

copyFilePath Copiar la ruta completa del archivo actual en elportapapeles

copylinesdown Copiar el contenido de la línea y pegarlo una líneapor debajo

copylinesup Copiar el contenido de la línea y pegarlo una líneapor encima

cut Cortar la selección en el portapapeles

cut_or_delete Cortar la selección y pegarla en el portapapeles osi la selección está vacía, eliminar hacia la derecha

del Eliminar un espacio

287



detectIndentation Detectar el tipo de sangría (espacios o pestañas) yla longitud en función del contenido del documento

duplicateSelection Copiar el contenido de la selección y pegar elcontenido copiado inmediatamente después de laselección

emmet_decrement_number_by_01 Reducir el número seleccionado en 0,1 si se tratade un número

emmet_decrement_number_by_1 Reducir el número seleccionado en 1 si se trata deun número

emmet_decrement_number_by_10 Reducir el número seleccionado en 10 si se tratade un número

emmet_evaluate_math_expression Evaluar una expresión matemática simple (como2*4 o 10/2) y mostrar su resultado

emmet_expand_abbreviation Expandir abreviaturas de tipo CSS en el códigoHTML, XML o CSS, en función de la sintaxis delarchivo actual

emmet_expand_abbreviation_with_tab Atravesar las abreviaturas de tipo CSSexpandidas, deteniéndose con el tabulador

emmet_increment_number_by_01 Aumentar el número seleccionado en 0,1 si se tratade un número

emmet_increment_number_by_1 Aumentar el número seleccionado en 1 si se tratade un número

emmet_increment_number_by_10 Aumentar el número seleccionado en 10 si se tratade un número

emmet_match_pair_inward Reducir la selección al siguiente conjunto internode etiquetas coincidentes

emmet_match_pair_outward Ampliar la selección para incluir el siguienteconjunto externo de etiquetas coincidentes

emmet_matching_pair Desplazarse entre la etiqueta de apertura y la decierre si la selección es una etiqueta

emmet_next_edit_point Ir a la siguiente etiqueta, atributo vacío o nuevalínea con sangría

emmet_prev_edit_point Ir a la anterior etiqueta, atributo vacío o nueva líneacon sangría

emmet_reflect_css_value Copiar la propiedad CSS seleccionada en todaslas variaciones coincidentes si la selección es unapropiedad CSS

emmet_remove_tag Eliminar la etiqueta seleccionada si la selección esuna etiqueta

emmet_select_next_item Ir a la siguiente parte del código editable

288



emmet_select_previous_item Ir a la parte del código editable anterior

emmet_split_join_tag Si la selección es una etiqueta vacía, sustituirpor un par de etiquetas de apertura y cierre. Si laetiqueta tiene un par de etiquetas de apertura ycierre, sustituir por una etiqueta vacía

emmet_toggle_comment Añadir caracteres de comentario a la línea actual o,si los hubiese, eliminarlos

emmet_wrap_with_abbreviation Ampliar una abreviatura y, a continuación, colocarla selección en el último elemento del fragmentogenerado

expandSnippet Expandir el código siempre que sea necesario

expandtoline Incluir el contenido de la línea actual en laselección

expandToMatching Incluir hasta el siguiente símbolo coincidente en laselección

find Mostrar la barra para buscar y reemplazar en eldocumento actual

findAll Seleccionar todas las coincidencias en eldocumento actual

findnext Ir a la siguiente coincidencia en el documentoactual de la consulta de búsqueda introducida enúltimo lugar

findprevious Ir a la coincidencia anterior en el documento actualde la consulta de búsqueda que se ha introducidoen último lugar

findReferences Mostrar todas las referencias al símbolo conocidasen el punto de inserción en el archivo activo en eleditor

focusTree Abrir la ventana Environment (Entorno) y, acontinuación, crear la lista de los archivos activos

fold Plegar el código seleccionado; si hay seleccionadauna unidad plegada, desplegarla

foldall Plegar todos los elementos plegables

foldOther Plegar todos los elementos plegables, excepto elámbito de selección

forceToggleTimeslider Mostrar el panel File Revision History (Ver historialde revisiones de archivo) u ocultarlo si está visible

formatcode Volver a formatear el código JavaScriptseleccionado

289



formatprefs Abrir la sección Project Settings (Configuración delproyecto) de la pestaña Preferences (Preferencias)para configurar el lenguaje de programación

foursplit Mostrar un diseño de cuatro paneles

gethelp Mostrar el foro de debate de AWS para AWSCloud9

gitcloneterminal Ejecutar el comando git clone en una nuevasesión de terminal

golinedown Bajar una línea

golineup Subir una línea

gotoanything Mostrar la ventana Go (Ir) en el modo Go toAnything (Ir a cualquier punto)

gotocommand Mostrar la ventana Go (Ir) en el modo Go toCommand (Ir a comando)

gotoend Ir al final del archivo

gotofile Mostrar la ventana Go (Ir) en el modo Go to File (Ira archivo).

gotoleft Ir un espacio a la izquierda

gotoline Abrir el recuadro go to line (ir a línea)

gotolineend Ir al final de la línea actual

gotolinestart Ir al comienzo de la línea actual

goToNextError Ir al siguiente error

gotopagedown Bajar una página

gotopageup Subir una página

gotopanedown Bajar un panel

gotopaneleft Ir un panel a la izquierda

gotopaneright Ir un panel a la derecha

gotopaneup Ir un panel hacia arriba

goToPreviousError Ir al error anterior

gotoright Ir un espacio a la derecha

gotostart Ir al principio del archivo

gotosymbol Mostrar la ventana Go (Ir) en el modo Go toSymbol (Ir a símbolo).

gototableft Ir una pestaña a la izquierda

290



gototabright Ir una pestaña a la derecha

gotowordleft Ir una palabra a la izquierda

gotowordright Ir una palabra a la derecha

hideGotoLine Ocultar el cuadro para ir a una línea, si se muestra

hidesearchreplace Ocultar la barra de buscar y reemplazar, si semuestra

hsplit Dividir el panel actual en dos columnas y, acontinuación, mover la pestaña actual a la nuevacolumna

indent Aplicar sangría de un tabulador a la selección

insertstring Insertar una cadena de texto al escribir o pegar

inserttext Insertar texto al escribir o pegar

invertSelection Seleccionar todo lo que no sea la selección

joinlines Eliminar todos los saltos de línea de la selecciónactual

jumptodef Ir a la definición de la variable o función en elcursor

jumptomatching Ir al símbolo coincidente en el ámbito actual

lambdaConvertFunction Mostrar el cuadro de diálogo Convert to SAM(Convertir a SAM)

lambdaCreateFunction Mostrar el cuadro de diálogo Create serverlessapplication (Crear aplicación sin servidor)

lambdaImportFunction Si hay una función de AWS Lambda remotaseleccionada en la sección Lambda de AWSResources (Recursos de AWS), intenta importar lafunción en IDE como una función local

lambdaLinkToCFStack Mostrar el cuadro de diálogo Link toCloudFormation Stack (Enlace a pila deCloudFormation)

lambdaRefreshFunctionsList Actualiza la sección Lambda de la ventana AWSResources (Recursos de AWS) si se muestra

lambdaUploadFunction Si hay una función de Lambda local seleccionadaen la sección Lambda de AWS Resources(Recursos de AWS), intenta cargar la función enLambda como una función remota

largerfont Aumentar el tamaño de la fuente

maximizeconsole Ampliar la consola para cubrir todo el IDE

291



modifyNumberDown Reducir el número a la izquierda del cursor en 1, sise trata de un número

modifyNumberUp Aumentar el número a la izquierda del cursor en 1,si se trata de un número

movelinesdown Mover la selección una línea hacia abajo

movelinesup Mover la selección una línea hacia arriba

movetabdown Mover la pestaña actual un panel hacia abajo o, sila pestaña ya está en la parte inferior, crear allí unapestaña dividida

movetableft Mover la pestaña actual a la izquierda o, si lapestaña ya está en la parte izquierda, crear allí unapestaña dividida

movetabright Mover la pestaña actual a la derecha o, si lapestaña ya está en la parte derecha, crear allí unapestaña dividida

movetabup Mover la pestaña actual un panel hacia arriba o, sila pestaña ya está en la parte superior, crear allíuna pestaña dividida

newEnvironment Mostrar el asistente Create new environment(Crear nuevo entorno) en la consola de AWSCloud9

newfile Crear un archivo nuevo

newfolder Crear una nueva carpeta para la selección en laventana Environment (Entorno)

nextpane Ir al siguiente panel

nexttab Ir a la siguiente pestaña

nosplit Combinar todos los paneles divididos en un solopanel

opencoverageview Mostrar la pestaña Code Coverage (Cobertura decódigo)

openpreferences Mostrar la pestaña Preferences (Preferencias)

opentermhere Abrir una pestaña Terminal y, a continuación, ir ala carpeta principal del archivo seleccionado en lalista de archivos

openterminal Abrir una nueva pestaña Terminal

outdent Quitar la sangría de la selección un tabulador

outline Mostrar la ventana Outline (Esquema)

overwrite Activar el modo de sobrescritura o desactivarlo siestá activado

292



pagedown Bajar una página

pageup Subir una página

passKeysToBrowser Habilitar las claves que debe gestionar elnavegador web

paste Pegar el contenido actual del portapapeles en elcursor

preview Mostrar el panel de vista previa

previouspane Ir al panel anterior

previoustab Ir a la pestaña anterior

quickfix Mostrar sugerencias para corregir errores

redo Rehacer la última acción

refocusTab Volver a la última pestaña

reloadpreview Actualizar el panel de vista previa

removefavorite Eliminar el elemento de la lista Favorites(Favoritos) si la selección es un favorito

removeline Eliminar el contenido de la línea actual

removetolineend Eliminar desde el cursor hasta el final de la líneaactual

removetolinestart Eliminar desde el comienzo de la línea actual hastael cursor

removewordleft Eliminar la palabra situada a la izquierda del cursor

removewordright Eliminar la palabra situada a la derecha del cursor

renameVar Iniciar una refactorización de cambio de nombrepara la selección

reopenLastTab Abrir de nuevo la última pestaña

replace Abrir la barra de búsqueda y reemplazo en eldocumento actual centrándose en la expresiónreplace with (Reemplazar por)

replaceall Sustituir todas las coincidencias de Find (Buscar)por Replace With (Reemplazar por) en la barra debúsqueda y reemplazo del documento actual

replacenext Sustituir la siguiente coincidencia de Find (Buscar)por Replace With (Reemplazar por) en la barra debúsqueda y reemplazo del documento actual

replaceprevious Sustituir la coincidencia anterior de Find (Buscar)por Replace With (Reemplazar por) en la barra debúsqueda y reemplazo del documento actual

293



replaymacro Reproducir pulsaciones del teclado previamenteregistradas

rerunInitScript Volver a ejecutar el script de inicialización

restartc9 Restablecer el entorno

resume Reanudar el proceso actual en pausa

revealtab Mostrar la pestaña actual en el árbol de archivos

reverttosaved Restablecer la última versión guardada del archivoactual

reverttosavedall Restablecer la versión guardada de cada archivoabierto

run Ejecutar o depurar la aplicación actual

runlast Ejecutar o depurar el último archivo ejecutado

save Guardar el archivo actual en el disco

saveall Guardar en el disco todos los archivos sin guardar

saveas Guardar el archivo actual en el disco con otronombre

savePaneLayout Guardar el diseño de panel actual en el menúWindow, Saved Layouts (Ventana, Diseñosguardados)

savePaneLayoutAndCloseTabs Guardar el diseño de panel actual en el menúWindow, Saved Layouts (Ventana, Diseñosguardados) y, a continuación, cerrar todas laspestañas abiertas

scrolldown Desplazarse hacia abajo en el documento actual

scrollup Desplazarse hacia arriba en el documento actual

searchinfiles Mostrar la barra de buscar y reemplazar paravarios archivos

selectall Seleccionar todo el contenido seleccionable

selectdown Incluir la línea siguiente abajo en la selección

selectleft Incluir el siguiente espacio a la izquierda del cursoren la selección

selectlineend Incluir el resto de la línea actual en la selección,comenzando desde el cursor

selectlinestart Incluir desde el comienzo de la línea actual en laselección hasta el cursor

selectMoreAfter Incluir más selecciones coincidentes que estándespués de la selección

294



selectMoreBefore Incluir más selecciones coincidentes que estánantes de la selección

selectNextAfter Incluir la siguiente selección coincidente que estádespués de la selección

selectNextBefore Incluir la siguiente selección coincidente que estáantes de la selección

selectOrFindNext Seleccionar o buscar la siguiente seleccióncoincidente

selectOrFindPrevious Seleccionar o buscar la selección coincidenteanterior

selectpagedown Incluir desde el cursor hasta el final de la páginaactual en la selección

selectpageup Incluir desde el cursor hasta el comienzo de lapágina actual en la selección

selectright Incluir el siguiente espacio a la derecha del cursoren la selección

selecttoend Incluir desde el cursor hasta el final del archivoactual en la selección

selecttolineend Incluir desde el cursor hasta el final de la líneaactual en la selección

selecttolinestart Incluir desde el comienzo de la línea actual hastael cursor en la selección

selecttomatching Incluir desde el cursor hasta el siguiente símbolocoincidente en el ámbito actual

selecttostart Incluir desde el cursor hasta el comienzo delarchivo actual en la selección

selectup Incluir la línea siguiente arriba en la selección

selectVar Seleccionar todas las instancias de la variable si laselección es una variable

selectwordleft Incluir la siguiente palabra a la izquierda del cursoren la selección

selectwordright Incluir la siguiente palabra a la derecha del cursoren la selección

setIndentation Establecer el tipo de sangría (espacios o pestañas)y la longitud

sharedialog Mostrar el cuadro de diálogo Share thisenvironment (Compartir este entorno)

showimmediate Mostrar la pestaña Immediate (Inmediato)

295



showinstaller Mostrar el cuadro de diálogo AWS Cloud9 Installer(Instalador de AWS Cloud9)

showoutput Mostrar la pestaña Output (Salida)

showprocesslist Mostrar el cuadro de diálogo Process List (Lista deprocesos)

showSettingsMenu Mostrar la pestaña Preferences (Preferencias)

singleSelection Borrar todas las selecciones anteriores

smallerfont Disminuir el tamaño de la fuente

sortlines Si se seleccionan varias líneas, reorganizarlas deuna forma ordenada

splitIntoLines Añadir un cursor al final de la línea actual

splitline Mover el contenido del cursor al final de la línea, auna línea propia

stepinto Pasar a la función que está junto a la pila

stepout Salir del ámbito de la función actual

stepover Saltar la expresión actual en la pila

stop Parar la ejecución o la depuración de la aplicaciónactual

stopbuild Detener la compilación del archivo actual

stripws Eliminar todos los espacios en blanco del final decada línea

suspend Suspender la ejecución o la depuración de laaplicación actual

switchterminal Cambiar entre el editor y la pestaña Terminal

syntax Establecer el tipo de sintaxis

tab0 Ir a la décima pestaña

tab1 Ir a la primera pestaña

tab2 Ir a la segunda pestaña

tab3 Ir a la tercera pestaña

tab4 Ir a la cuarta pestaña

tab5 Ir a la quinta pestaña

tab6 Ir a la sexta pestaña

tab7 Ir a la séptima pestaña

tab8 Ir a la octava pestaña

296



tab9 Ir a la novena pestaña

term_detach Separe los clientes asociados al panel Terminal

term_help Mostrar ayuda para el panel Terminal

term_restart Reiniciar el panel Terminal

threeleft Crear un diseño de tres paneles con dos paneles ala izquierda y un panel a la derecha

threeright Crear un diseño de tres paneles con dos paneles ala derecha y un panel a la izquierda

toggle_term_status Mostrar el estado del panel Terminal u ocultarlo sise muestra

toggleBlockComment Rodear la selección con caracteres de comentariode bloques o, si los hubiese, eliminarlos

toggleButtons Mostrar las pestañas u ocultarlas si se muestran

togglecomment Añadir caracteres de comentario de línea alprincipio de cada línea seleccionada o eliminarlossi ya están

toggleconsole Mostrar la ventana Console (Consola) si estáoculta u ocultarla si se muestra

toggledebugger Mostrar la ventana Debugger (Depurador) uocultarla si se muestra

toggleFoldWidget Plegar código o quitar el plegado de código si estáplegado

toggleMenubar Mostrar la barra de menús u ocultarla si se muestra

toggleOpenfiles Mostrar la lista Open Files (Archivos abiertos) dela ventana Environment (Entorno) u ocultarla si semuestra

toggleParentFoldWidget Plegar código principal o quitar el plegado si lo está

togglerecording Comenzar la grabación de la combinación deteclas o detener si ya se está grabando

toggletree Mostrar la ventana Environment (Entorno) si estáoculta u ocultarla si se muestra

toggleWordWrap Ajustar las palabras o detener el ajuste de palabrassi ya se están ajustando

tolowercase Poner la selección completa en minúsculas

touppercase Poner la selección completa en mayúsculas

transposeletters Transponer la selección

297



trimTrailingSpace Suprimir los espacios en blanco al final de laslíneas

twohsplit Crear un diseño de dos paneles, con los panelesen paralelo

twovsplit Crear un diseño de dos paneles, con un panelarriba y otro abajo

undo Deshacer la última acción

unfold Desplegar el código seleccionado

unfoldall Desplegar el plegado de código en todo el archivo

uploadLocalFiles Mostrar el cuadro de diálogo Upload Files (Cargararchivos)

vsplit Dividir el panel actual en dos paneles, uno arribay otro abajo, y mover la pestaña actual al panelsuperior

298

AWS Cloud9 Guía del usuarioTrabajo con instancias de Amazon Lightsail

Trabajar con otros servicios de AWSCuando se utiliza AWS Cloud9, puede trabajar estrechamente con Amazon Lightsail, AWS CodeStar, AWSLambda y AWS CodePipeline. Los siguientes temas describen cómo hacerlo.

Temas• Trabajo con instancias de Amazon Lightsail en el AWS Cloud9 Integrated Development Environment


(IDE) (p. 306)• Trabajo con funciones AWS Lambda en el AWS Cloud9 Integrated Development Environment

(IDE) (p. 308)• Trabajar con AWS CodePipeline en el AWS Cloud9 Integrated Development Environment

(IDE) (p. 347)

Trabajo con instancias de Amazon Lightsail en elAWS Cloud9 Integrated Development Environment(IDE)

Puede utilizar el AWS Cloud9 IDE para trabajar con instancias de Amazon Lightsail preconfiguradas conaplicaciones y marcos de trabajo muy utilizados, como WordPress, LAMP (Linux, Apache, MySQL y PHP),Node.js, Nginx, Drupal y Joomla, así como con distribuciones Linux como Amazon Linux, Ubuntu, Debian,FreeBSD y openSUSE.

Lightsail es la manera más sencilla de dar los primeros pasos en AWS para desarrolladores, pequeñosnegocios, estudiantes y otros usuarios que necesitan una solución de servidor privado virtual(VPS) sencilla. Lightsail proporciona a los desarrolladores capacidad y funciones informáticas, dealmacenamiento y de red para implementar y administrar sitios y aplicaciones web en la nube. Lightsailincluye todo lo que necesita para lanzar rápidamente su proyecto (una máquina virtual, almacenamientobasado en SSD, transferencia de datos, administración de DNS y una dirección IP estática), a un preciomensual bajo y predecible. Para obtener más información, consulte Características de Amazon Lightsail.

En este tema va a crear y configurar una instancia de Lightsail basada en Linux que sea compatible conAWS Cloud9. A continuación creará un entorno de desarrollo de SSH de AWS Cloud9 y lo conectará a lainstancia de Lightsail.

Note

El uso de estos procedimientos puede producir cargos en su cuenta de AWS. Entre ellos, seincluyen posibles cargos por servicios como Lightsail. Para obtener más información, consultePrecios de Amazon Lightsail.Para crear y configurar una solución más avanzada que incluya una cadena de herramientascon el AWS Cloud9 IDE, control de origen, compilación, implementación, servidores virtuales orecursos sin servidor, y mucho más, omita el resto de este tema y consulte Trabajo con proyectosde AWS CodeStar (p. 306).Para utilizar el AWS Cloud9 IDE y trabajar con una instancia Amazon EC2 que se ejecute enAmazon Linux o Ubuntu Server y que no contenga código de muestra, omita el resto de este temay consulte Introducción: tutoriales básicos (p. 41) en su lugar.

299

https://amazonlightsail.com/features/

https://aws.amazon.com/lightsail/pricing/

AWS Cloud9 Guía del usuarioPaso 1: Crear una instancia de Lightsail basada en Linux

• Paso 1: Crear una instancia de Lightsail basada en Linux (p. 300)• Paso 2: Configurar la instancia para utilizarla con AWS Cloud9 (p. 301)• Paso 3: Crear y conectar con un entorno de desarrollo SSH de AWS Cloud9 (p. 303)• Paso 4: Utilizar el IDE de AWS Cloud9 para cambiar el código en la instancia (p. 306)

Paso 1: Crear una instancia de Lightsail basada enLinuxEn este paso va a utilizar la consola de Lightsail para crear una instancia Amazon EC2 que ejecuta unaaplicación en una distribución basada en Linux. Esta instancia automáticamente incluye:

• Una dirección IP pública y privada. (Puede crear una IP pública estática más adelante).• Acceso a la instancia mediante SSH a través del puerto 22, HTTP a través del puerto 80 y HTTPS a

través del puerto 443. (Puede cambiar estos valores).• Un disco de almacenamiento en bloque. (Puede adjuntar discos adicionales más adelante).• Informes de sistema integrados.

La consola de Lightsail le permite realizar copias de seguridad, reiniciar, detener o eliminar la instancia conposterioridad.

1. Abra la consola de Lightsail e inicie sesión en https://lightsail.aws.amazon.com.

Le recomendamos que inicie sesión con las credenciales de un usuario administrador de IAM ensu cuenta de AWS. Si no puede iniciar sesión como usuario administrador de IAM, consulte con eladministrador de su cuenta de AWS.

2. Si se le solicita, elija el idioma que desea utilizar en la consola y, a continuación, seleccione Save(Guardar).

3. Si se le solicita, elija Let's get started (Comencemos).4. En la página de inicio, con la pestaña Instances (Instancias) ya seleccionada, elija Create instance

(Crear instancia).

5. En Instance location (Ubicación de la instancia), asegúrese de que la ubicación coincida con unaregión de AWS en la que desea crear la instancia y dónde AWS Cloud9 esté disponible. Para obtenermás información, consulte AWS Cloud9 en la Referencia general de Amazon Web Services. Paracambiar la región de AWS, la zona de disponibilidad o ambas, elija Change AWS Region and AvailabilityZone (Cambiar región de AWS y zona de disponibilidad) y, a continuación, siga las instrucciones queaparecen en pantalla.

6. En Pick your instance image (Elija su imagen de instancia), una vez que haya elegido Linux/Unix paraSelect a platform (Seleccione una plataforma) y Apps + OS (Aplicaciones + SO) para Select a blueprint(Seleccione un proyecto), seleccione un proyecto.

300

https://lightsail.aws.amazon.com


AWS Cloud9 Guía del usuarioPaso 2: Configurar la instanciapara utilizarla con AWS Cloud9

Note

Si desea crear una instancia sin aplicación, elija OS Only (Solo SO) en lugar de Apps + OS(Aplicaciones + SO) y, a continuación, seleccione una distribución.Para obtener más información acerca de las opciones disponibles, consulte la secciónrelacionada con la selección de una imagen de instancia de Amazon Lightsail en el sitio web deLightsail.

7. En Choose your instance plan (Seleccione su plan de instancia), elija un plan o deje el planseleccionado de manera predeterminada.

8. En Name your instance (Asignar nombre a la instancia), escriba un nombre para la instancia o deje elnombre propuesto de manera predeterminada.

9. Para el número de instancias, escriba el número de instancias que desea crear o deje el valorpredeterminado de una sola instancia (x 1).

10.Seleccione Create.

Paso 2: Configurar la instancia para utilizarla con AWSCloud9En este paso se conectará a la instancia en ejecución y, a continuación, la configurará para que AWSCloud9 pueda utilizarla más adelante.

301

https://lightsail.aws.amazon.com/ls/docs/getting-started/article/compare-options-choose-lightsail-instance-image

AWS Cloud9 Guía del usuarioPaso 2: Configurar la instanciapara utilizarla con AWS Cloud9

Note

En las siguientes instrucciones se presupone que ha elegido Apps + OS (Aplicaciones + SO) enel paso anterior. Si ha elegido OS Only (Solo SO) y una distribución distinta de Ubuntu, es posibleque tenga que adaptar las siguientes instrucciones según corresponda.

1. Con la consola de Lightsail abierta desde el paso anterior, en la pestaña Instances (Instancias), en latarjeta de la instancia, elija el nombre de la instancia.

2. En la pestaña Connect (Conectar), en Connect using your own SSH client (Conectarse a través de supropio cliente SSH), apunte los valores Public IP (IP pública) y User name (Nombre de usuario), puestoque los necesitará más adelante.

3. Elija Conectarse a través de SSH.4. Asegúrese de que la instancia incluya las últimas actualizaciones del sistema. Para ello, en la sesión de

terminal que aparece, ejecute el comando sudo apt update.

302

AWS Cloud9 Guía del usuarioPaso 3: Crear un entorno de desarrollo

de SSH de AWS Cloud9 y conectarse a él

5. Compruebe si se ha instalado Python y, si es así, asegúrese de que la versión sea la 2.7. Paracomprobar la versión, ejecute el comando python --version y anote el número de versión queaparece. Si no aparece ningún número de versión o si la versión no es 2.7, instale Python 2.7 en lainstancia ejecutando el comando sudo apt install -y python-minimal.

6. Compruebe si se ha instalado Node.js y, si es así, compruebe que la versión sea 0.6.16 o una versiónposterior. Para comprobar la versión, ejecute el comando node --version y anote el número deversión que aparece. Si no aparece ningún número de versión o si la versión no es 0.6.16 o posterior, lerecomendamos que utilice Node Version Manager (nvm) para instalar Node.js en la instancia.

Para ello, ejecute los siguientes comandos de uno en uno, en el orden que se indica a continuación,para actualizar la instancia, instale Node Version Manager (nvm) en la instancia, active nvm en lainstancia y, a continuación, instale la versión más reciente de Node.js en la instancia.

sudo apt updatecurl -o- https://raw.githubusercontent.com/creationix/nvm/v0.33.0/install.sh | bash. ~/.bashrcnvm install node

7. Ejecute el comando which node y anote el valor que aparece. La necesitará más adelante.

Note

Si el resultado del comando which node se parece a /usr/sbin/node, AWS Cloud9 nopodrá encontrar Node.js en esa ruta. En su lugar, utilice nvm para instalar Node.js, tal y comose describe en el paso anterior de este procedimiento. A continuación, ejecute de nuevo elcomando which node y anote el nuevo valor que aparece.

8. Descargue y ejecute el instalador de AWS Cloud9 (p. 517) en la instancia.

Paso 3: Crear un entorno de desarrollo de SSH deAWS Cloud9 y conectarse a élEn este paso va a utilizar la consola de AWS Cloud9 y el terminal de la instancia para crear un entorno deSSH y, a continuación, conectar el entorno a la instancia en ejecución.

1. Con la sesión de terminal abierta desde el paso anterior, inicie sesión en la consola de AWS Cloud9,como sigue:• Si es usted la única persona que utiliza la cuenta de AWS o es un usuario de IAM en una única




Note

En este paso trabajará con dos servicios de AWS diferentes al mismo tiempo. Si inició sesiónen la consola de Lightsail como usuario administrador de IAM, pero desea que otra entidad seala propietaria del nuevo entorno de SSH le sugerimos que abra otro navegador web e iniciesesión en la consola de AWS Cloud9 como dicha entidad.

2. En la consola de AWS Cloud9, elija la región de AWS que coincida con la región en la que ha creado lainstancia.

303




3. Si aparece una página de bienvenida, en New AWS Cloud9 environment (Nuevo entorno de AWSCloud9), elija Create environment (Crear entorno). De lo contrario, elija Create environment (Crearentorno).

O bien:

4. En la página Name environment (Asignar nombre al entorno), en Name (Nombre), escriba un nombrepara su entorno.

5. Para añadir una descripción del entorno, escríbala en Description (Descripción).6. Elija Next Step.7. En la página Configure settings (Configurar ajustes), en Environment type (Tipo de entorno), elija

Connect and run in remote server (SSH) [Conectar y ejecutar en servidor remoto (SSH)].8. En User (Usuario), escriba el valor de User name (Nombre de usuario) que había anotado antes.9. En Host, escriba el valor de Public IP (IP pública) que había anotado antes.10.En Port (Puerto), deje el valor predeterminado, 22.11.Amplíe Advanced settings (Configuración avanzada).12.En Environment path (Ruta del entorno), escriba la ruta desde la que AWS Cloud9 empezará después

de iniciar sesión, que es ~/ (la raíz del directorio de inicio del usuario).

304



13.En Node.js binary path (Ruta binaria de Node.js), escriba el valor del comando which node que habíaanotado antes.

14.Deje SSH jump host (Host de salto de SSH) en blanco.15.Almacene la clave SSH pública que crea AWS Cloud9 para este entorno en el portapapeles del sistema.

Para ello, elija Copy key to clipboard (Copiar clave en portapapeles).

Note

Para ver el valor de la clave SSH pública que se ha copiado, amplíe View public SSH key (Verclave pública SSH).

16.Guarde el valor de la clave SSH pública que acaba de copiar en la instancia. Para ello, utilice vi, unconocido editor de texto que ya está instalado en la instancia:a. En la sesión de terminal de la instancia, ejecute el comando vi ~/.ssh/authorized_keys.b. En el editor vi que aparece, vaya al final del archivo y cambie al modo de inserción. Para ello, pulse G

y, a continuación, A. (- INSERT: aparece en la parte inferior del editor vi).c. Añada dos retornos de carro al final del archivo pulsando Enter dos veces.d. Pegue el contenido del portapapeles del sistema, que contiene el valor de la clave SSH pública que

acaba de copiar, en el portapapeles de la sesión de terminal. Para ello, en la esquina inferior de laventana de la sesión de terminal, elija el botón de portapapeles y, a continuación, pegue el contenidodel portapapeles del sistema en el cuadro.

e. Pegue el contenido del portapapeles de la sesión de terminal en el editor vi. Para ello, en el punto deinserción del editor vi, pulse Ctrl + Shift + V.

f. Guarde el archivo. Para ello, pulse Esc para entrar en modo de comando. (- INSERT: desaparece dela parte inferior del editor vi). Escriba :wq (para write (escribir) el archivo y, a continuación, quitpara salir del editor vi); a continuación, pulse Enter.

17.En la consola de AWS Cloud9, elija Next step (Paso siguiente).18.En la página Review choices (Revisar opciones), elija Create environment (Crear entorno). Espere

mientras AWS Cloud9 crea su entorno y muestra después el AWS Cloud9 IDE para el entorno. Estopuede tardar varios minutos.


Si AWS Cloud9 no muestra el IDE transcurridos al menos cinco minutos, puede que haya un problema consu navegador web, los permisos de acceso de AWS, la instancia o la nube virtual privada (VPC) asociada.Para ver posibles soluciones, consulte No se puede abrir un entorno (p. 556) en Solución de problemas.

305

AWS Cloud9 Guía del usuarioPaso 4: Utilizar el AWS Cloud9 IDE

para cambiar el código en la instancia

Paso 4: Utilizar el AWS Cloud9 IDE para cambiar elcódigo en la instanciaAhora que el IDE aparece para el nuevo entorno, puede utilizar la sesión de terminal en el IDE en lugarde la sesión de terminal de Lightsail. El IDE ofrece una rica experiencia de edición de código, con soportepara varios lenguajes de programación y depuradores de tiempo de ejecución, así como temas de color,enlaces de teclado, colores de sintaxis específicos para los lenguajes de programación, formato de código,etc.

Para obtener información sobre cómo utilizar el IDE, consulte Recorrido del AWS Cloud9 IDE (p. 108).

Para obtener información sobre cómo cambiar el código en la instancia, le recomendamos los siguientesrecursos.

• La sección completa Obtención de la contraseña de aplicación para la imagen de Lightsail "basada enBitnami" del sitio web de Lightsail.

• Drupal: Bitnami Drupal For AWS Cloud en el sitio web de Bitnami y Tutorials and site recipes en el sitioweb de Drupal.

• GitLab CE: Bitnami GitLab CE for AWS Cloud en el sitio web de Bitnami y GitLab Documentation en elsitio web de GitLab.

• Joomla: Bitnami Joomla! For AWS Cloud en el sitio web de Bitnami y Getting Started with Joomla! en elsitio web de Joomla!

• LAMP Stack: Bitnami LAMP for AWS Cloud en el sitio web de Bitnami.• Magento: Bitnami Magento For AWS Cloud en el sitio web de Bitnami y la guía del usuario de Magento

en el sitio web de Magento.• MEAN: Bitnami MEAN For AWS Cloud en el sitio web de Bitnami.• Nginx: Bitnami Nginx For AWS Cloud en el sitio web de Bitnami y NGINX Wiki en el sitio web de NGINX.• Node.js: Bitnami Node.Js For AWS Cloud en el sitio web de Bitnami y la guía de introducción en el sitio

web de Node.js.• Plesk Hosting Stack on Ubuntu: Instalar y configurar Plesk en Lightsail en el sitio web de Lightsail.• Redmine: Bitnami Redmine For AWS Cloud en el sitio web de Bitnami y Getting Started en el sitio web

de Redmine.• WordPress: Introducción al uso de WordPress desde la instancia de Amazon Lightsail en el sitio web de

Lightsail y Bitnami WordPress For AWS Cloud en el sitio web de Bitnami.

Trabajo con proyectos de AWS CodeStar en elAWS Cloud9 Integrated Development Environment(IDE)

Puede utilizar el AWS Cloud9 IDE para trabajar con código en los proyectos de AWS CodeStar.

AWS CodeStar es un servicio basado en la nube para crear, administrar y trabajar con proyectos dedesarrollo de software en AWS. Puede desarrollar, compilar e implementar aplicaciones rápidamente enAWS con un proyecto de AWS CodeStar. Los proyectos de AWS CodeStar crean e integran los serviciosde AWS para sus cadenas de herramientas de proyecto. Según la plantilla de proyecto de AWS CodeStarque seleccione, esa cadena de herramientas puede incluir control de origen, compilación, implementación,servidores virtuales o recursos sin servidor, y mucho más. Para obtener más información, consulte la Guíadel usuario de AWS CodeStar.

306

https://lightsail.aws.amazon.com/ls/docs/how-to/article/log-in-to-your-bitnami-application-running-on-amazon-lightsail

https://lightsail.aws.amazon.com/ls/docs/how-to/article/log-in-to-your-bitnami-application-running-on-amazon-lightsail

https://docs.bitnami.com/aws/apps/drupal/

https://www.drupal.org/node/627198

https://docs.bitnami.com/aws/apps/gitlab/

https://docs.gitlab.com/ce/

https://docs.bitnami.com/aws/apps/joomla/

https://www.joomla.org/about-joomla/getting-started.html

https://docs.bitnami.com/aws/infrastructure/lamp/

https://docs.bitnami.com/aws/apps/magento/

http://docs.magento.com/m1/ce/user_guide/getting-started.html

https://docs.bitnami.com/aws/infrastructure/mean/

https://docs.bitnami.com/aws/infrastructure/nginx/

https://www.nginx.com/resources/wiki/

https://docs.bitnami.com/aws/infrastructure/nodejs/

https://nodejs.org/en/docs/guides/getting-started-guide/

https://lightsail.aws.amazon.com/ls/docs/how-to/article/set-up-and-configure-plesk-stack-on-lightsail

https://docs.bitnami.com/aws/apps/redmine/

http://www.redmine.org/projects/redmine/wiki/Getting_Started

https://lightsail.aws.amazon.com/ls/docs/getting-started/article/getting-started-with-wordpress-and-lightsail

https://docs.bitnami.com/aws/apps/wordpress/

https://docs.aws.amazon.com/codestar/latest/userguide/welcome.html

https://docs.aws.amazon.com/codestar/latest/userguide/welcome.html

AWS Cloud9 Guía del usuarioPaso 1: Prepararse para trabajarcon proyectos de AWS CodeStar

Note

El uso de estos procedimientos puede producir cargos en su cuenta de AWS. Entre estos seincluyen posibles cargos por servicios como Amazon EC2, AWS CodeStar y los servicios de AWScompatibles con AWS CodeStar. Para obtener más información, consulte Precios de AmazonEC2, Precios de AWS CodeStar y los precios de los servicios en la nube.Para utilizar el AWS Cloud9 IDE para trabajar con una instancia de Amazon EC2 recién lanzadaque se haya preconfigurado con una aplicación o marco de trabajo muy conocidos, comoWordPress, MySQL, PHP, Node.js, Nginx, Drupal o Joomla, así como con una distribución Linuxcomo Ubuntu, Debian, FreeBSD u openSUSE, puede usar Amazon Lightsail junto con AWSCloud9. Para ello, omita el resto de este tema y consulte Trabajo con instancias de AmazonLightsail (p. 299).Para utilizar el AWS Cloud9 IDE para trabajar con una instancia Amazon EC2 recién lanzadaque ejecute Amazon Linux y que no contenga código de muestra, omita el resto de este tema yconsulte Introducción: tutoriales básicos (p. 41) en su lugar.

• Paso 1: Prepararse para trabajar con proyectos de AWS CodeStar (p. 307)• Paso 2: Crear un proyecto en AWS CodeStar (p. 307)• Paso 3: Crear un entorno de desarrollo de AWS Cloud9 y conectarlo con el proyecto (p. 307)

Paso 1: Prepararse para trabajar con proyectos deAWS CodeStarEn este paso va a crear un rol de servicio de AWS CodeStar y un par de claves de Amazon EC2 parapoder comenzar a crear proyectos de AWS CodeStar y trabajar con ellos.

Si ha utilizado AWS CodeStar antes, vaya a Paso 2: Crear un proyecto en AWS CodeStar (p. 307).

En este paso, siga las instrucciones que se describen en Configuración de AWS CodeStar en la Guía delusuario de AWS CodeStar. No cree una cuenta de AWS, un usuario de IAM ni un grupo de IAM nuevosiguiendo esas instrucciones. Utilice los que haya creado o identificado en Configuración de equipos paraAWS Cloud9 (p. 8). Cuando termine de seguir esas instrucciones, vuelva a este tema.

Paso 2: Crear un proyecto en AWS CodeStarEn este paso va a crear un proyecto en AWS CodeStar.

Si ya tiene un proyecto en AWS CodeStar que desee utilizar, vaya a Paso 3: Crear un entorno dedesarrollo de AWS Cloud9 y conectarlo al proyecto (p. 307).

En este paso, siga las instrucciones que se describen en Crear un proyecto en AWS CodeStar de la Guíadel usuario de AWS CodeStar. En el asistente para crear proyectos de AWS CodeStar, cuando acceda alas páginas Set up tools (Configurar herramientas) o Connect to your source repository (Conectarse a surepositorio de código fuente), elija Skip (Omitir) y, a continuación, vuelva a este tema.

Paso 3: Crear un entorno de desarrollo de AWSCloud9 y conectarlo al proyectoEn este paso va a crear un entorno de desarrollo de AWS Cloud9 en las consolas de AWS CodeStar oAWS Cloud9. A continuación va a conectar nuevo entorno a un proyecto de AWS CodeStar.

En este paso, siga uno de los siguientes conjuntos de instrucciones, en función del tipo de entorno dedesarrollo de AWS Cloud9 que desee utilizar y el tipo de repositorio donde el proyecto AWS CodeStaralmacene su código.

307



https://aws.amazon.com/codestar/pricing/

https://aws.amazon.com/pricing/services/

https://docs.aws.amazon.com/codestar/latest/userguide/setting-up.html

https://docs.aws.amazon.com/codestar/latest/userguide/how-to-create-project.html

AWS Cloud9 Guía del usuarioTrabajo con funciones de AWS Lambda

Tipo de entorno Repository type Instrucciones

entorno de EC2 CodeCommit Crear un entorno de AWS Cloud9para un proyecto en la Guía delusuario de AWS CodeStar

entorno de SSH CodeCommit Ejemplo de AWSCodeCommit (p. 382)

EC2 o entorno de SSH GitHub Usar GitHub con AWS Cloud9en la Guía del usuario de AWSCodeStar

Trabajo con funciones AWS Lambda en el AWSCloud9 Integrated Development Environment (IDE)

Puede utilizar el AWS Cloud9 IDE para trabajar con funciones AWS Lambda y sus API de Amazon APIGateway relacionadas en un entorno de desarrollo de AWS Cloud9. Por ejemplo, puede hacer lo siguiente:

• Cree una nueva función desde su entorno, cargando la versión local de la función en Lambda y, deforma opcional, creando recursos de AWS adicionales para admitir la nueva función al mismo tiempo.

• Ejecute y depure una función y su API relacionada en su entorno, ejecutando la función y la APIcompletamente desde el interior del entorno.

• Ejecute la versión remota de una función y su API relacionada en su entorno, ejecutando la versiónremota completamente desde el interior de Lambda y API Gateway.

• Importe una función existente de Lambda en su entorno, de modo que pueda ejecutar y depurar lafunción y su API relacionada, editar el código o ambos.

• Cargue los cambios que realice en la versión local del código de la función en la versión remota deLambda.

En este tema, se da por hecho que ya conoce Lambda. Para obtener más información, consulte la AWSLambda Developer Guide.

Note

El uso de estos procedimientos puede producir cargos en su cuenta de AWS. Entre estos seincluyen posibles cargos por servicios como Lambda, API Gateway y AWS compatibles conModelo de aplicación sin servidor de AWS (AWS SAM). Para obtener más información, consultePrecios de AWS Lambda, Precios de Amazon API Gateway y Precios de los servicios en la nube.

Temas• Prepararse para trabajar con funciones Lambda (p. 309)• Crear una función Lambda con el asistente de creación de aplicaciones sin servidor (p. 312)• Crear e implementar funciones Lambda con AWS Serverless Application Repository (p. 317)• Importar una función Lambda (p. 319)• Llamar a una función Lambda. (p. 321)• Invocar una función de Lambda que utiliza variables de entorno (p. 323)• Uso de las funciones de Lambda que utilizan versiones, alias o capas (p. 326)• Llamar a una API de API Gateway para una función Lambda relacionada (p. 327)• Diferencias de respuesta al llamar a una función Lambda desde API Gateway (p. 329)

308

https://docs.aws.amazon.com/codestar/latest/userguide/setting-up-ide-cloud9.html#setting-up-ide-cloud9-create

https://docs.aws.amazon.com/codestar/latest/userguide/setting-up-ide-cloud9.html#setting-up-ide-cloud9-create

https://docs.aws.amazon.com/codestar/latest/userguide/setting-up-ide-cloud9.html#setting-up-ide-cloud9-github

https://docs.aws.amazon.com/lambda/latest/dg/

https://docs.aws.amazon.com/lambda/latest/dg/


https://aws.amazon.com/api-gateway/pricing/


AWS Cloud9 Guía del usuarioPrepararse para trabajar con funciones Lambda

• Añadir código dependiente a una función Lambda (p. 330)• Depurar la versión local de una función Lambda o su API de API Gateway relacionada (p. 333)• Cambiar el código en una función Lambda (p. 336)• Cargar código para una función Lambda (p. 337)• Convertir una función Lambda en una aplicación sin servidor (p. 341)• Actualizar los ajustes de configuración de una función Lambda (p. 343)• Eliminar una función Lambda (p. 344)

Prepararse para trabajar con funciones LambdaAntes de trabajar con funciones Lambda en el AWS Cloud9 IDE, debe completar los siguientes pasos:

Temas• Paso 1: Configurar el grupo de IAM con los permisos de acceso necesarios (p. 309)• Paso 2: Configurar el entorno con sus credenciales de acceso de AWS (p. 311)• Paso 3: Crear un rol de ejecución para sus funciones Lambda (p. 311)• Paso 4: Establecer el entorno en la región de AWS correcta (p. 311)• Paso 5: Abrir la sección Lambda de la ventana de recursos de AWS (p. 312)

Paso 1: Configurar el grupo de IAM con los permisos de accesonecesariosSi sus credenciales de acceso de AWS están asociadas a un usuario administrador de IAM en su cuentade AWS y desea utilizarlo para trabajar con funciones Lambda, vaya al Paso 2: Configurar el entorno consus credenciales de acceso de AWS (p. 311).

De lo contrario, siga estas instrucciones para utilizar la consola de IAM con el fin de asociar las políticasadministradas por AWS llamadas AWSLambdaFullAccess, AmazonAPIGatewayAdministrator,AmazonAPIGatewayInvokeFullAccess y una política insertada adicional, a un grupo de IAM al quepertenezca el usuario.

1. Si todavía no ha iniciado sesión en la Consola de administración de AWS, hágalo ahora.

En este paso, le recomendamos que inicie sesión con las credenciales de un administrador de IAM ensu cuenta de AWS. Si no puede hacerlo, consulte con el administrador de su cuenta de AWS.



Policy (Adjuntar política).6. En la lista de nombres de políticas, seleccione las casillas junto a AWSLambdaFullAccess,

AmazonAPIGatewayAdministrator y AmazonAPIGatewayInvokeFullAccess. (Si no ve alguno de estosnombres de políticas en la lista, escríbalos en el cuadro Search (Búsqueda) para verlos).

7. Elija Attach Policy.8. Descargue el siguiente archivo ZIP en su equipo local: Cloud9LambdaAccessGroup.zip. A continuación,

extraiga el archivo de plantilla de AWS CloudFormation llamado Cloud9LambdaAccessGroup.yamldel archivo ZIP descargado.

9. Abra la consola de AWS CloudFormation. Para ello, en la barra de navegación de la consola, elijaServices (Servicios). A continuación, elija CloudFormation.

309

samples/Cloud9LambdaAccessGroup.zip


10.Elija Create Stack.11.En la página Select Template (Seleccionar plantilla), en Choose a template (Elegir una plantilla),

seleccione Upload a template to Amazon S3 (Cargar una plantilla en Amazon S3). Elija Browse(Explorar) y, a continuación, seleccione el archivo de plantilla de AWS CloudFormation que ha extraído.

12.Seleccione Next (Siguiente).13.En la página Specify Details (Especificar detalles), en Stack name (Nombre de pila), escriba un nombre

para la pila. Por ejemplo, AWSCloud9LambdaAccessStack. Si escribe otro nombre, sustitúyalo en todoeste procedimiento.

14.Para Parameters (Parámetros), en GroupName (Nombre de grupo), escriba el nombre del grupoexistente en su cuenta de AWS al que desea asociar la política de acceso.

15.Seleccione Next (Siguiente).16.En la página Options, seleccione Next. (No cambie ninguno de los valores predeterminados de la página

Options (Opciones)).17.En la página Review (Revisar), elija I acknowledge that AWS CloudFormation might create IAM

resources (Confirmo que AWS CloudFormation puede crear recursos de IAM).18.Seleccione Create.

Espere hasta que la pila AWSCloud9LambdaAccessStack muestre CREATE_COMPLETE. Este procesopuede tardar unos momentos. Tenga paciencia.

Note

La política de acceso que AWS CloudFormation asocia al grupo se llamaAWSCloud9LambdaGroupAccess y tiene la siguiente definición, donde ACCOUNT_ID es su IDde cuenta de AWS.

{ "Version": "2012-10-17", "Statement": [ { "Action": [ "cloudformation:CreateChangeSet", "cloudformation:CreateStack", "cloudformation:DescribeChangeSet", "cloudformation:DescribeStackEvents", "cloudformation:DescribeStacks", "cloudformation:ExecuteChangeSet", "cloudformation:ListStackResources", "cloudformation:UpdateStack", "iam:AttachRolePolicy", "iam:DetachRolePolicy", "iam:GetRole", "iam:GetUser", "iam:PassRole" ], "Resource": "*", "Effect": "Allow" }, { "Action": [ "iam:CreateRole", "iam:DeleteRole" ], "Resource": "arn:aws:iam::ACCOUNT_ID:role/cloud9-*", "Effect": "Allow" } ]}

310


Paso 2: Configurar el entorno con sus credenciales de acceso deAWSEl AWS Cloud9 IDE utiliza la AWS Command Line Interface (AWS CLI) de su entorno de desarrollo deAWS Cloud9 para interactuar con Lambda y otros servicios de AWS compatibles. Por lo tanto, la AWS CLIde su entorno necesita obtener acceso a las credenciales de acceso de AWS.

Lleve a cabo una de las siguientes acciones para configurar la AWS CLI en su entorno:

• Si tiene un entorno de EC2, credenciales temporales administradas de AWS ya estará configurado ensu entorno para la AWS CLI que se va a utilizar, en cuyo caso puede ir directamente al Paso 3: Crear unrol de ejecución para sus funciones Lambda (p. 311). credenciales temporales administradas de AWStiene permiso para interactuar con la mayoría de los servicios de AWS desde su entorno (siempre quela entidad de AWS que utilice el entorno también tenga esos permisos). Para obtener más información,consulte credenciales temporales administradas de AWS (p. 537).

• Si tiene un entorno de EC2, pero las credenciales temporales administradas de AWS no satisfacen susnecesidades, puede asociar un perfil de instancia de IAM a la instancia de Amazon EC2 que se conectaa su entorno. También puede almacenar las credenciales de acceso de AWS permanentes dentro delentorno. Para obtener instrucciones, consulte Creación y uso de un perfil de instancia para administrarcredenciales temporales (p. 78) o Crear y almacenar las credenciales de acceso permanente en unentorno (p. 82).

• Si tiene un entorno de SSH, puede almacenar las credenciales de acceso de AWS permanentesdentro del entorno. Para obtener instrucciones, consulte Crear y almacenar las credenciales de accesopermanente en un entorno (p. 82).

Paso 3: Crear un rol de ejecución para sus funciones LambdaSi desea que las funciones de Lambda hagan cosas utilizando los recursos de AWS, debe especificar unrol de IAM (rol de ejecución) que contenga los permisos de acceso necesarios para que los utilicen lasfunciones.

Al crear una función Lambda, AWS Cloud9 puede crear un rol de ejecución automáticamente. Este rol deejecución contiene los permisos que se describen en Permisos básicos de Lambda en la AWS LambdaDeveloper Guide.

Si este rol de ejecución no cumple sus necesidades, debe crear un rol de ejecución usted mismo antes decrear la función Lambda. Para obtener más información, consulte los siguientes temas:

• Modelo de permisos de AWS Lambda en la AWS Lambda Developer Guide• Creación de un rol para delegar permisos a un servicio de AWS en la Guía del usuario de IAM

Paso 4: Establecer el entorno en la región de AWS correctaDebe establecer su entorno de desarrollo de AWS Cloud9 para que utilice la región de AWS en la quedesea crear nuevas funciones de Lambda en su cuenta de AWS o donde desee importar las funciones deLambda existentes desde su cuenta de AWS a su entorno de desarrollo de AWS Cloud9.

Para ello:

1. En el AWS Cloud9 IDE, en la barra de menús, elija AWS Cloud9, Preferences (AWS Cloud9,Preferencias).

2. En el panel de navegación de la pestaña Preferences (Preferencias), elija AWS Settings (Configuraciónde AWS).

3. En AWS Region (Región de AWS), seleccione la región de AWS que desea utilizar.

311

https://docs.aws.amazon.com/lambda/latest/dg/policy-templates.html#basic-execution

https://docs.aws.amazon.com/lambda/latest/dg/intro-permission-model.html

https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-service.html

AWS Cloud9 Guía del usuarioCrear una función Lambda con el asistente

de creación de aplicaciones sin servidor

Paso 5: Abrir la sección Lambda de la ventana de recursos deAWSYa está listo para empezar a usar el AWS Cloud9 IDE para trabajar con funciones Lambda. Para ello,expanda la sección Lambda de la ventana AWS Resources (Recursos de AWS), si todavía no lo habíahecho.

Si la ventana AWS Resources (Recursos de AWS) no es visible, elija el botón AWS Resources (Recursosde AWS).

Si no ve el botón AWS Resources (Recursos de AWS), elija Window, AWS Resources (Ventana, Recursosde AWS) en la barra de menús para mostrarlo.

Crear una función Lambda con el asistente decreación de aplicaciones sin servidorPuede utilizar el AWS Cloud9 IDE para crear una nueva función Lambda. Si ya tiene funciones deLambda en su cuenta de AWS para la región de AWS que configuró antes, vaya a Importar una funciónLambda (p. 319).

Note

En este procedimiento, se describe cómo utilizar el asistente Create serverless application (Crearaplicaciones sin servidor) para crear una única función de Lambda basada en proyectos defunciones que son propiedad de AWS. Para crear varias funciones de Lambda al mismo tiempo,crear funciones de Lambda junto con los componentes de apoyo al mismo tiempo o funcionesde Lambda que son propiedad de entidades distintas a AWS, vaya directamente a Crear eimplementar funciones Lambda con AWS Serverless Application Repository (p. 317).

312



1. En la sección Lambda de la ventana AWS Resources (Recursos de Lambda), elija dónde desea crear lafunción:• Para crear una sola función, elija el encabezado Local Functions (Funciones locales).• Para crear una función y, a continuación, añadirla a un grupo existente de una o varias funciones y

recursos de AWS relacionados (que se denomina aplicación sin servidor), en la lista Local Functions(Funciones locales), elija la aplicación sin servidor para el grupo (que está representada por el iconode Lambda dentro de una carpeta).

2. Aplique alguna de las siguientes acciones:• Elija Create a new LambdaLambda function (Crear una nueva función Lambda) (el botón con el icono

de Lambda).• Haga clic con el botón derecho del ratón en el encabezado Local Functions (Funciones locales) o

la carpeta de la aplicación sin servidor que ha elegido anteriormente y, a continuación, seleccioneCreate Here (Crear aquí).

3. En el cuadro de diálogo Create serverless application (Crear aplicación sin servidor), especifique lasopciones siguientes para la función:• Function Name (Nombre de función): un nombre para la función.• Application Name (Nombre de aplicación): el nombre de la nueva aplicación sin servidor que se va a

asociar a la nueva función.

Important

Ambos nombres solo deben incluir caracteres alfanuméricos y guiones. Cada nombre debecomenzar por un carácter alfabético y no debe superar los 128 caracteres.

4. Seleccione Next (Siguiente).5. Elija el proyecto de la función con el que desea empezar. (Actualmente, solo están disponibles

proyectos de funciones Node.js y Python).

Para ver los proyectos de un tiempo de ejecución específico, en Select Runtime (Seleccionar tiempo deejecución), elija el tiempo de ejecución. Por ejemplo, para utilizar el proyecto de función hello-worldpara Node.js 6.10, elija Node.js 6.10 en Select Runtime y, a continuación, seleccione el proyecto hello-world para Select Blueprint (Seleccionar proyecto).

6. Seleccione Next (Siguiente).7. Aplique alguna de las siguientes acciones:

• Para evitar que un servicio de AWS active automáticamente esta función, deje Function Trigger(Desencadenador de función) establecido en none (ninguno), elija Next (Siguiente) y, a continuación,vaya al paso 9 de este procedimiento.

313



• Para que un recurso de AWS de su cuenta active automáticamente su función, en Function Trigger(Desencadenador de función), seleccione el nombre del servicio de AWS que contendrá el recurso.(Actualmente, solo está disponible API Gateway).

8. Si ha elegido API Gateway en Function Trigger (Desencadenador de función), especifique lo siguientepara Trigger Settings (Configuración de desencadenador):• En Resource Path (Ruta de recursos), escriba la parte de la URL de la API que se va a utilizar para

llamar a la función. Por ejemplo, escriba / para especificar la raíz del recurso.• En Security (Seguridad), elija el mecanismo de seguridad para el punto de enlace de la API:

• AWS_IAM: exige que los intermediarios proporcionen credenciales de acceso de IAM paraautenticarlas. Consulte Control del acceso a una API Gateway con permisos de IAM en la Guíapara desarrolladores de API Gateway.

• NONE: habilita el acceso abierto.• NONE_KEY: exige que los intermediarios proporcionen una clave de API para autenticarla.

Consulte Configurar claves de API mediante la consola de API Gateway en la Guía paradesarrolladores de API Gateway.

9. Seleccione Next (Siguiente).10.En Memory (MB) (Memoria (MB)), elija la cantidad de memoria, en megabytes, que utilizará esta

función.11.Aplique alguna de las siguientes acciones:

• Para que AWS Cloud9 cree un nuevo rol de IAM básico (rol de ejecución) para que lo utiliceesta función, en Role (Rol), elija Automatically generate role (Generar rol automáticamente). Acontinuación, elija Next.

• Para que Lambda utilice un rol de IAM existente (rol de ejecución) en su cuenta de AWS, enRole (Rol), elija Choose an existing role (Elegir un rol existente). En Existing Role (Rol existente),seleccione el nombre del rol y, a continuación, haga clic en Next (Siguiente).

12.Seleccione Next (Siguiente).13.Elija Finalizar.

Compare sus resultados con los siguientes:

En la sección Lambda de la ventana AWS Resources (Recursos de AWS), AWS Cloud9 hace lo siguiente:

314

https://docs.aws.amazon.com/apigateway/latest/developerguide/permissions.html

https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-setup-api-key-with-console.html



• Si ha decidido crear una sola función:1. AWS Cloud9 crea una aplicación sin servidor con el nombre que ha especificado anteriormente. A

continuación, añade una aplicación sin servidor (representada por un icono de Lambda dentro deuna carpeta) a la lista Local Functions (Funciones locales). A continuación, añade la función Lambda(representada por un icono de Lambda), a esta aplicación sin servidor.

2. AWS Cloud9 crea una versión remota de la función en Lambda y la añade a la lista Remote Functions(Funciones remotas). AWS Cloud9 proporciona a la versión remota un nombre diferente. Porejemplo, si el nombre de la aplicación sin servidor es myDemoServerlessApplication y el dela función es myDemoFunction, el nombre de la versión remota de su función sería cloud9-myDemoServerlessApplication-myDemoFunction-RANDOM_ID, donde RANDOM_ID es un IDdeterminado de forma aleatoria.

3. Si ha decidido que API Gateway active automáticamente la función, AWS Cloud9 crea una API enAPI Gateway con un nombre que se corresponde con la función. Por ejemplo, si ha denominado ala función myDemoFunction, el nombre de la API sería cloud9-myDemoFunction. AWS Cloud9utiliza el valor especificado en Resource Path (Ruta de recurso) para asignar la función a la API queutiliza el método ANY.

• Si ha decidido crear una sola función y, a continuación, añadirla a una aplicación sin servidor existente:1. AWS Cloud9 añade la función Lambda (representada por un icono de Lambda solo) a la aplicación sin

servidor existente (representada por un icono de Lambda dentro de una carpeta).2. AWS Cloud9 crea una versión remota de la función en Lambda y la añade a la lista Remote Functions

(Funciones remotas). AWS Cloud9 proporciona a la versión remota un nombre diferente. Por ejemplo,si el nombre de la función es myDemoFunction y la ha añadido a una aplicación sin servidordenominada myDemoServerlessApplication, el nombre de la versión remota de su función seríacloud9-myDemoServerlessApplication-myDemoFunction-RANDOM_ID, donde RANDOM_IDes un ID determinado de forma aleatoria.

3. Si ha decidido que API Gateway active automáticamente la función, AWS Cloud9 creauna API en API Gateway con un nombre que se corresponde con la aplicación sinservidor relacionada, si no existe todavía. Por ejemplo, si ha denominado a la aplicaciónsin servidor myDemoServerlessApplication, el nombre de la API sería cloud9-myDemoServerlessApplication. AWS Cloud9 utiliza el valor especificado en Resource Path(Ruta de recurso) para asignar la función a la API que utiliza el método ANY.

En la ventana Entorno, AWS Cloud9 hace lo siguiente:

315



• Si ha decidido crear una sola función, AWS Cloud9 crea una carpeta con el mismo nombre que laaplicación sin servidor y coloca esta carpeta en el directorio principal del entorno de desarrollo de AWSCloud9. A continuación, AWS Cloud9 añade los siguientes archivos a la carpeta:• .application.json: un archivo oculto usado por AWS Cloud9 que contiene una configuración con

formato JSON específica de la aplicación sin servidor.• .gitignore: un archivo oculto que contiene una lista de los archivos que omite Git, si desea utilizar

Git para administrar el código fuente para esta función.• template.yaml: un archivo de plantilla AWS SAM que contiene información acerca de la función

de Lambda y cualquier otro recurso de AWS compatible relacionado. Cada vez que se actualice laversión local de su función y luego se cargue en Lambda, AWS Cloud9 llama a AWS SAM para utilizareste archivo de plantilla para realizar la carga. Para obtener más información, consulte Uso de Modelode aplicación sin servidor de AWS (AWS SAM) en la AWS Lambda Developer Guide.

Note

Puede editar este archivo para crear recursos de AWS de apoyo adicionales para su función.Para obtener más información, consulte el repositorio del Modelo de aplicación sin servidorde AWS (AWS SAM) en GitHub.

• Una subcarpeta con el mismo nombre que la función, que contiene un archivo de código querepresenta la lógica de la función.

• Si la función utiliza Python, se añaden subcarpetas y archivos adicionales a la subcarpeta anteriorpara habilitar la depuración de Python:• .debug: una subcarpeta que contiene módulos de Python para fines de depuración.• venv: una carpeta virtualenv de Python estándar. Esto incluye un módulo denominado ikpdb, que

AWS Cloud9 utiliza para depurar aplicaciones Python.• __init__.py: un archivo de inicialización de paquetes Python estándar.• requirements.txt: un archivo estándar para instalar módulos de Python.• AWS Cloud9 también añade una propiedad CodeUri al archivo template.yaml y establece esta

propiedad para que haga referencia a la carpeta .debug/.• Si decide crear una sola función y, a continuación, añadirla a una aplicación sin servidor existente, AWS

Cloud9 hace lo siguiente en la carpeta que representa la aplicación sin servidor:• Actualiza el archivo template.yaml que se ha descrito anteriormente a fin de incluir información

sobre la función de Lambda y cualquier otro recurso de AWS de apoyo relacionado.• Una subcarpeta con el mismo nombre que la función, que contiene un archivo de código que

representa la lógica de la función.• Si la función utiliza Python, se añaden subcarpetas y archivos adicionales a la subcarpeta anterior

para habilitar la depuración de Python:• .debug: una subcarpeta que contiene módulos de Python para fines de depuración.• venv: una carpeta virtualenv de Python estándar. Esto incluye un módulo denominado ikpdb, que

AWS Cloud9 utiliza para depurar aplicaciones Python.• __init__.py: un archivo de inicialización de paquetes Python estándar.• requirements.txt: un archivo estándar para instalar módulos de Python.• AWS Cloud9 también añade una propiedad CodeUri al archivo template.yaml y establece esta

propiedad para que haga referencia a la carpeta .debug/.

Los archivos .application.json y .gitignore (y la carpeta .debug para Python) están ocultos. Paramostrar los archivos ocultos o para ocultarlos si están a la vista, en la ventana Entorno, elija el icono delengranaje y luego Show Hidden Files (Mostrar archivos ocultos).

316

https://docs.aws.amazon.com/lambda/latest/dg/deploying-lambda-apps.html#serverless_app


https://github.com/awslabs/serverless-application-model


AWS Cloud9 Guía del usuarioCrear e implementar funciones Lambda

con AWS Serverless Application Repository

Para invocar la función, consulte Llamar a una función Lambda. (p. 321). Si la función tiene una APIrelacionada en API Gateway, para invocar la API, consulte Llamar a una API de API Gateway para unafunción Lambda relacionada (p. 327).

Crear e implementar funciones Lambda con AWSServerless Application RepositoryPuede utilizar el AWS Cloud9 IDE y el AWS Serverless Application Repository para crear varias funcionesde Lambda al mismo tiempo, para crear funciones de Lambda junto con componentes de apoyo al mismotiempo o para crear funciones de Lambda que son propiedad de entidades distintas de AWS. Si ya tienefunciones de Lambda en su cuenta de AWS para la región de AWS que configuró antes, vaya a Importaruna función Lambda (p. 319).

1. En una pestaña distinta del navegador web, abra AWS Serverless Application Repository.2. Busque la aplicación sin servidor que desea crear y, a continuación, elija el título de la aplicación

sin servidor que desea que esté dentro de su tarjeta. (Si la tarjeta no es visible, comience a escribirinformación acerca de la aplicación sin servidor que desea en el recuadro Search applications by name,description, or labels (Buscar aplicaciones por nombre, descripción o etiquetas) para mostrarlo).

3. En la página Application details (Detalles de aplicación) que aparece, si se muestra una URL para unrepositorio basado en Git, copie esa dirección URL (por ejemplo, https://github.com/USER_NAME/REPOSITORY_NAME).

Note

Ni no aparece una URL, intente elegir el botón Deploy (Implementar) en la página Applicationdetails (Detalles de aplicación) y, a continuación, busque el valor Source code URL (URL decódigo fuente).

4. Otra vez en el AWS Cloud9 IDE, abra un terminal si no hay ninguno abierto ya. (Para abrir un terminal,en la barra de menús, seleccione Window, New Terminal [Ventana, Nuevo terminal]).

5. En el terminal, cambie al directorio de su entorno en el que desea copiar los archivos del iniciador de laaplicación sin servidor (por ejemplo, ejecutando el comando cd ~/environment).

6. Ejecute el comando git clone, seguido de la URL de Git que copió previamente (por ejemplo, gitclone https://github.com/USER_NAME/REPOSITORY_NAME). El IDE añade a continuación lasfunciones de la aplicación sin servidor a la sección Lambda de la ventana AWS Resources (Recursos deAWS).

Note

Si se ejecuta el comando git clone con algunas de las direcciones URL de las páginasde Application details (Detalles de aplicación) o los valores de Source code URL (URL decódigo fuente), es posible que no funcione según lo previsto o que se produzcan resultados

317

https://aws.amazon.com/serverless/serverlessrepo/

https://serverlessrepo.aws.amazon.com

AWS Cloud9 Guía del usuarioCrear e implementar funciones Lambda

con AWS Serverless Application Repository

inesperados. Como alternativa, puede descargar manualmente los archivos que desea desdeel repositorio deseado a su estación de trabajo local. A continuación, cargue manualmenteesos archivos en el IDE ejecutando File, Upload Local Files (Archivo, Cargar archivos locales)en la barra de menús.Al clonar el repositorio de GitHub, el IDE utiliza el archivo de plantilla del Modelo de aplicaciónsin servidor de AWS (AWS SAM) en el repositorio para determinar cuál de las funciones dela aplicación sin servidor se muestra en la sección Lambda de la ventana AWS Resources(Recursos de AWS). El archivo de plantilla de AWS SAM debe seguir el formato de archivo delModelo de aplicación sin servidor de AWS (AWS SAM). Si el repositorio no contiene un archivode plantilla de AWS SAM o si el archivo no sigue el formato de archivo de AWS SAM, el IDE nomostrará estas funciones. Tampoco podrá ejecutar, depurar o implementar dichas funcioneso cualquiera de sus recursos de API Gateway desde la sección Lambda de la ventana AWSResources (Recursos).

7. Es posible que necesite realizar determinada configuración para poder ejecutar, depurar o implementarla aplicación sin servidor desde el IDE según lo previsto. Para obtener instrucciones de configuración,consulte la página Application details (Detalles de aplicación) que abrió anteriormente. También puedebuscar las instrucciones de configuración en los archivos de la aplicación sin servidor que ha clonado ensu IDE.

Para invocar las funciones, consulte Llamar a una función Lambda. (p. 321). Si las funciones tienenAPI relacionadas en API Gateway, para invocar las API, consulte Llamar a una API de API Gateway parauna función Lambda relacionada (p. 327). Al llamar a una función o API de esta manera por primeravez, AWS Cloud9 añade un archivo .application.json oculto a los archivos de componentes de laaplicación sin servidor. Este archivo lo usa AWS Cloud9 y contiene una configuración con formato JSONque es específica de la aplicación sin servidor.

Si la aplicación sin servidor requiere que se especifiquen parámetros durante la implementación, puedeimplementarlo desde el IDE solo mediante el terminal. Para ver si los parámetros son necesarios, enla página Application details (Detalles de aplicación) que abrió anteriormente, elija el botón Deploy(Implementar) y, a continuación, consulte la tarjeta Configure application parameters (Configurarparámetros de aplicación) para comprobar si hay algún parámetro. Si hay parámetros, implementela aplicación sin servidor desde el terminal en el IDE ejecutando el comando deploy de AWSCloudFormation, por ejemplo:

aws cloudformation deploy --template-file TEMPLATE_FILE_PATH --parameter-overrides "PARAMETER_KEY_1=PARAMETER_VALUE_1" "PARAMETER_KEY_N=PARAMETER_VALUE_N" --region REGION_ID

En el comando anterior:

• TEMPLATE_FILE_PATH representa la ruta al archivo de plantilla de AWS SAM.• PARAMETER_KEY_1 representa el nombre del primer parámetro.• PARAMETER_VALUE_1 representa el valor del primer parámetro.• PARAMETER_KEY_N representa el nombre de un parámetro adicional, y así sucesivamente.• PARAMETER_VALUE_N representa el valor de un parámetro adicional, y así sucesivamente.• REGION_ID representa el ID de la región de AWS en la que desea implementar la aplicación sin servidor

(por ejemplo, us-east-2).• Es posible que haya que especificar opciones adicionales, en función de los requisitos de la aplicación

sin servidor. Para obtener más información, consulte la página Application details (Detalles deaplicación) que abrió anteriormente o busque las instrucciones de configuración en los archivos de laaplicación sin servidor que ha clonado en su IDE.

Si intenta utilizar la sección Lambda de la ventana AWS Resources (Recursos de AWS) para implementaruna aplicación sin servidor que requiere parámetros, aparece un mensaje que indica que faltan parámetrosobligatorios y la aplicación sin servidor no se ha implementado.

318


AWS Cloud9 Guía del usuarioImportar una función Lambda

Importar una función LambdaSi ya posee una función de Lambda en su cuenta de AWS, pero no en su entorno de desarrollo de AWSCloud9, debe importarla antes de trabajar con ella en el entorno.

Note

Si función Lambda forma parte de un proyecto de AWS CodeStar existente y el entorno se creódesde el proyecto en la consola de AWS CodeStar, la función ya está importada, por lo que notiene que importarla de nuevo.Para confirmar este comportamiento, busque en la lista Local Functions (Funciones locales) dela sección Lambda de la ventana AWS Resources (Recursos de AWS) para una aplicación sinservidor (representada por un icono de Lambda dentro de una carpeta) con el mismo nombreque el proyecto de AWS CodeStar, que contiene una función de Lambda (representada porun icono de Lambda solo) con el nombre básico de la función. Busque también en la listaRemote Functions (Funciones remotas) una función Lambda con un nombre con el formatoawscodestar-PROJECT_NAME-lambda-BASE_FUNCTION_NAME-RANDOM_ID, dondePROJECT_NAME es el nombre de proyecto de AWS CodeStar, BASE_FUNCTION_NAME es elnombre básico de la función y RANDOM_ID es un ID determinado de forma aleatoria.

Dado que la función ya está importada, no recomendamos importar la versión remota de lafunción en el proyecto de AWS CodeStar. De lo contrario, tendrá dos versiones del mismo códigode función en la ventana Entorno, pero con diferentes nombres de carpetas, lo que puede darlugar a confusión.

Para importar una función Lambda, haga lo siguiente:

1. En la ventana entorno, elija dónde desea importar la función.2. En la sección Lambda de la ventana AWS Resources (Recursos de AWS), seleccione el nombre de la

función en la lista Remote Functions (Funciones remotas).

Note

Si no ve la función en la lista Remote Functions (Funciones remotas), haga clic en el botónRefresh functions List (Actualizar lista de funciones) (el botón con el icono de flecha circular).

3. Aplique alguna de las siguientes acciones:• Haga doble clic en la función que acababa de elegir.• En la barra de menús, en la sección Lambda, elija el botón Import the selected Lambda function

(Importar la función Lambda que ha seleccionado) (el botón con la flecha hacia abajo).• Haga clic con el botón derecho en la función que acaba de elegir y, a continuación, elija Import

(Importar).

319

AWS Cloud9 Guía del usuarioImportar una función Lambda

Note

No puede importar una función Lambda a una carpeta que representa una aplicación sinservidor o una función Lambda. Si intenta hacerlo, AWS Cloud9 mostrará un mensaje en elque se indica que la función Lambda se va a importar a la ubicación principal del entorno en sulugar. Para permitir que AWS Cloud9 haga esto, seleccione Import (Importar). De lo contrario,seleccione Cancel (Cancelar), elija otra carpeta para importar la función (o cree una nuevacarpeta vacía a la que importar la función) y, a continuación, reinicie este procedimiento desdeel principio.

4. Cuando se le pida que finalice la importación de la función, elija OK (Aceptar).

AWS Cloud9 importa su función en una nueva carpeta de la raíz de su entorno. AWS Cloud9 tambiénañade la función a la lista Local Functions (Funciones locales) de la sección Lambda de la ventana AWSResources (Recursos de AWS). Esta carpeta tiene el mismo nombre que la función. AWS Cloud9 añadelos siguientes archivos a esta carpeta:

• .application.json: un archivo oculto usado por AWS Cloud9 que contiene una configuración conformato JSON específica de la función.

• .gitignore: un archivo oculto que contiene una lista de los archivos que omite Git, si desea utilizar Gitpara administrar el código fuente para esta función.

• template.yaml: un archivo de uso interno de AWS Cloud9.

Note

Aunque el archivo template.yaml se expresa en el formato AWS SAM, AWS SAM nolo utiliza. Por lo tanto, no puede editar este archivo para crear recursos de AWS de apoyoadicionales para su función. No modifique este archivo.

• Uno o varios archivos de código que contienen la lógica de la función.

320

AWS Cloud9 Guía del usuarioLlamar a una función Lambda.

Los campos .application.json y .gitignore están ocultos. Para mostrar u ocultar archivos, en laventana entorno, elija el icono del engranaje y luego Show Hidden Files (Mostrar archivos ocultos).

Para invocar la función, consulte Llamar a una función Lambda. (p. 321).

Llamar a una función Lambda.Para llamar a una función Lambda existente, primero debe importar la versión remota de la función a suentorno de desarrollo de AWS Cloud9, si la función aún no está allí. Para hacer esto, consulte Importar unafunción Lambda (p. 319).

1. En la sección Lambda de la ventana AWS Resources (Recursos de AWS), expanda la lista LocalFunctions (Funciones locales) si aún no está expandida.

2. Expanda la carpeta de la aplicación sin servidor que contiene la función a la que desea llamar.3. Elija la función a la que desea llamar, haga clic con el botón derecho en ella y, a continuación, elija Run

(Ejecutar).4. Aplique alguna de las siguientes acciones:

• Para ejecutar la versión local de la función en su entorno, elija Run Local (Ejecutar local).• Para ejecutar la versión remota de la función en Lambda, elija Run Remote (Ejecutar remota).

Note

Si no parece que ocurra nada, es posible que ya haya abierta una pestaña para la función.Si es así, elija Lambda (local) o Lambda (remote) (Lambda [remoto]) en la pestaña invoke(invocar).

5. En el panel Test payload (Carga de prueba) de la pestaña Invoke (Llamar) que se muestra, confirmelos datos de entrada personalizados que desea que utilice la función cuando la pruebe. Para obtenerinformación acerca del formato de los datos de entrada, consulte el Paso 2.2: invocación manual dela función de Lambda y verificación de los resultados, los registros y las métricas en la AWS LambdaDeveloper Guide.

6. En la pestaña Invoke (Llamar), elija el botón Run (Ejecutar).

321

https://docs.aws.amazon.com/lambda/latest/dg/get-started-invoke-manually.html


AWS Cloud9 Guía del usuarioLlamar a una función Lambda.

Note

Después de ejecutar la función por primera vez, se añade un archivo lambda-payloads.json a la carpeta de la aplicación sin servidor relacionada con la función en laventana entorno. Este archivo incluye el contenido de los datos de entrada personalizados.Si llama a una función Lambda existente y, a continuación, trata de llamar al mismo códigode función para su API relacionada en API Gateway con los mismos datos de entradapersonalizados, es posible que obtenga un error o el código no se ejecute según lo previsto.Para obtener más información, consulte Diferencias de respuesta al llamar a una funciónLambda desde API Gateway (p. 329).

La pestaña Invoke (Llamar) consta de dos paneles:

• El panel Test payload (Carga de prueba) muestra los datos de entrada personalizados que se hanproporcionado para la función.

• El panel Execution results (Resultados de ejecución) muestra la salida de la función e información delAmazon CloudWatch Logs relacionado para la función.


322

AWS Cloud9 Guía del usuarioInvocar una función de Lambdaque utiliza variables de entorno

Para obtener información, consulte el Paso 2.2: invocación manual de la función de Lambda y verificaciónde los resultados, los registros y las métricas en la AWS Lambda Developer Guide.

Para cargar los cambios que realice en la versión local del código de la función en la versión remotarelacionada de Lambda, consulte Cargar código para una función Lambda (p. 337).

Invocar una función de Lambda que utiliza variablesde entornoPara invocar una función de Lambda local o remota que utiliza variables de entorno, realice una de lassiguientes operaciones.

Invoque una función de Lambda localmente con las variables de entorno y sus valores predefinidos

Añada las definiciones de variables de entorno predefinidas al archivo template.yaml de la funciónsi aún no están ahí y ejecute el comando Run Local (Ejecutar localmente) para esa función en lasección Lambda de la ventana AWS Resources (Recursos de AWS).

Por ejemplo, en el caso de la siguiente definición de función de Node.js en un archivo llamadoindex.js:

exports.handler = (event, context, callback) => { var result = { MY_ENV_VAR_1: process.env.MY_ENV_VAR_1, MY_ENV_VAR_2: process.env.MY_ENV_VAR_2 }; const response = { statusCode: 200, headers: { "Content-type": "application/json" }, body: result }; callback(null, response); };

323




Y en el caso de la siguiente adición al archivo template.yaml de la función un directorio anteriorindex.js:

...Resources: MyEnvVarsFunction: Type: 'AWS::Serverless::Function' Properties: ... Environment: Variables: MY_ENV_VAR_1: "This is my environment variable 1 value from the template.yaml file." MY_ENV_VAR_2: "This is my environment variable 2 value from the template.yaml file."

Y al ejecutar el comando Run Local (Ejecutar localmente) para esa función en la sección Lambda de laventana AWS Resources (Recursos de AWS), el resultado es el siguiente:

{ "statusCode": 200, "headers": { "Content-type": "application/json" }, "body": { "MY_ENV_VAR_1": "This is my environment variable 1 value from the template.yaml file.", "MY_ENV_VAR_2": "This is my environment variable 2 value from the template.yaml file." }}

Invocar una función de Lambda localmente con las variables de entorno y sus valores que el intermediarioproporciona de forma dinámica en el tiempo de ejecución

No puede utilizar el comando Run Local (Ejecutar localmente) para este tipo de función en la secciónLambda de la ventana AWS Resources (Recursos de AWS).

En su lugar, añada las definiciones de variables de entorno predefinidas al archivo template.yamlde la función si aún no están ahí. A continuación, utilice el terminal en el IDE para ejecutar la CLI deAWS SAM con el comando invoke junto con el argumento --env-vars y un archivo JSON independienteque contiene las definiciones de variables de entorno y sus valores.

Por ejemplo, en el caso de la función de Node.js llamada MyEnvVarsFunction con su definición enun archivo llamado index.js:

exports.handler = (event, context, callback) => { var result = { MY_ENV_VAR_1: process.env.MY_ENV_VAR_1, MY_ENV_VAR_2: process.env.MY_ENV_VAR_2 }; const response = { statusCode: 200, headers: { "Content-type": "application/json" }, body: result }; callback(null, response);

324


};

Y en el caso de la siguiente adición al archivo template.yaml de la función un directorio anteriorindex.js:

...Resources: MyEnvVarsFunction: Type: 'AWS::Serverless::Function' Properties: ... Environment: Variables: MY_ENV_VAR_1: "This is my environment variable 1 value from the template.yaml file." MY_ENV_VAR_2: "This is my environment variable 2 value from the template.yaml file."

Y en el caso del siguiente archivo denominado MyEnvVars.json en el mismo directorio queindex.js:

{ "MyEnvVarsFunction": { "MY_ENV_VAR_1": "This is my environment variable 1 value from the JSON file.", "MY_ENV_VAR_2": "This is my environment variable 2 value from the JSON file." }}

Y al ejecutar el siguiente comando de la CLI de AWS SAM desde el mismo directorio que index.js:

sam local invoke --event lambda-payloads.json --template ../template.yaml --env-vars MyEnvVars.json

Se genera lo siguiente:

{ "statusCode": 200, "headers": { "Content-type": "application/json" }, "body": { "MY_ENV_VAR_1": "This is my environment variable 1 value from the JSON file.", "MY_ENV_VAR_2": "This is my environment variable 2 value from the JSON file." }}

Invocar una función de Lambda remotamente que ya tiene variables de entorno y sus valores predefinidos

Ejecute el comando Run Local (Ejecutar localmente) para este tipo de función en la sección Lambdade la ventana AWS Resources (Recursos de AWS).

Para ver o cambiar los valores de variables de entorno predefinidos para una función remota existenteantes de invocarla de forma remota, consulte Variables de entorno de AWS Lambda en la AWSLambda Developer Guide.

Invocar una función de Lambda remotamente con las variables de entorno y sus valores que elintermediario proporciona de forma dinámica en el tiempo de ejecución

No puede utilizar el comando Run Remote (Ejecutar remotamente) para este tipo de función en lasección Lambda de la ventana AWS Resources (Recursos de AWS).

325

https://docs.aws.amazon.com/lambda/latest/dg/env_variables.html

AWS Cloud9 Guía del usuarioUso de las funciones de Lambda

que utilizan versiones, alias o capas

En cambio, debe usar el terminal en el IDE para ejecutar la AWS CLI con el argumento --environmenty la acción update-function-configuration del comando de lambda con las definiciones de variables deentorno y sus valores. A continuación, ejecute la acción invoke del comando de lambda.

Por ejemplo, en el caso de la siguiente función de Node.js llamada MyEnvVarsFunction con lasiguiente definición y variables de entorno predefinidas llamadas MY_ENV_VAR_1 y MY_ENV_VAR_2:

exports.handler = (event, context, callback) => { var result = { MY_ENV_VAR_1: process.env.MY_ENV_VAR_1, MY_ENV_VAR_2: process.env.MY_ENV_VAR_2 }; const response = { statusCode: 200, headers: { "Content-type": "application/json" }, body: result }; callback(null, response); };

Y al ejecutar los siguientes comando de la AWS CLI, de uno en uno en el orden que se indica acontinuación:

aws lambda update-function-configuration --function-name MyEnvVarsFunction --environment '{"Variables":{"MY_ENV_VAR_1":"This is my environment variable 1 value from the AWS CLI.","MY_ENV_VAR_2":"This is my environment variable 2 value from the AWS CLI."}}'

aws lambda invoke --function-name MyEnvVarsFunction results.json

Lo siguiente es el resultado en un archivo llamado results.json:

{ "statusCode": 200, "headers": { "Content-type": "application/json" }, "body": { "MY_ENV_VAR_1": "This is my environment variable 1 value from the AWS CLI.", "MY_ENV_VAR_2": "This is my environment variable 2 value from the AWS CLI." }}

Para obtener más información, consulte el debate update-function-configuration y invoke en Creacióny prueba de la función de Lambda en la AWS Lambda Developer Guide.

Uso de las funciones de Lambda que utilizanversiones, alias o capasLa sección Lambda de la ventana AWS Resources (Recursos de AWS) actualmente no proporcionacaracterísticas para trabajar con versiones, alias o capas para funciones Lambda. En cambio, puede usarel terminal en el IDE para ejecutar la AWS CLI y la CLI de AWS SAM con los correspondientes comandos,acciones y argumentos. Para obtener más información, consulte los siguientes temas.

326

https://docs.aws.amazon.com/lambda/latest/dg/tutorial-env_cli.html#with-env-create-function

https://docs.aws.amazon.com/lambda/latest/dg/tutorial-env_cli.html#with-env-create-function

AWS Cloud9 Guía del usuarioLlamar a una API de API Gateway

para una función Lambda relacionada

• Introducción al control de versiones de AWS Lambda en la AWS Lambda Developer Guide• Introducción a los alias de AWS Lambda en la AWS Lambda Developer Guide• Administración del control de versiones mediante la Consola de administración de AWS, la AWS CLI o

las operaciones API de Lambda en la AWS Lambda Developer Guide• Capas de AWS Lambda en la AWS Lambda Developer Guide• Uso de capas en la Guía para desarrolladores de modelos de aplicación sin servidor de AWS• AWS::Serverless::LayerVersion en la Guía para desarrolladores de modelos de aplicación sin servidor

de AWS

Llamar a una API de API Gateway para una funciónLambda relacionadaPara llamar a una API en API Gateway que esté relacionada con una función Lambda existente, primerodebe importar la versión remota de la función a su entorno de desarrollo de AWS Cloud9, si la función aúnno está allí. Para hacer esto, consulte Importar una función Lambda (p. 319).

Note

No se puede depurar la versión remota de la API de API Gateway en su entorno. Solo puedellamarla. Para depurar la versión local, consulte Depurar la versión local de una función Lambda osu API de API Gateway relacionada (p. 333).


2. Expanda la carpeta de la aplicación sin servidor que contiene la función cuya API desea llamar.3. Elija la función, haga clic con el botón derecho en ella y, a continuación, elija Run (Ejecutar).4. Aplique alguna de las siguientes acciones:

• Para ejecutar la versión local de la API en su entorno, elija Run API Gateway Local (Ejecutar APIGateway localmente).

• Para ejecutar la versión remota de la función en Lambda, elija Run API Gateway Remote (EjecutarAPI Gateway remotamente).

Note

Si no parece que ocurra nada, es posible que ya haya abierta una pestaña para la función. Sies así, elija API Gateway (local) o API Gateway (remote) (API Gateway [remoto]) en la pestañainvoke (invocar).

5. En el panel Test payload (Carga de prueba) de la pestaña Invoke (Llamar) que aparece, confirme losvalores de Function (Función), Path (Ruta), Method (Método), Query String (Cadena de consulta), Body(Cuerpo) que desea que utilice la API cuando la pruebe.

Note

Es posible que algunas API no admitan configuraciones como la de Body (Cuerpo). Paraobtener más información, consulte al propietario de la API.

6. En la pestaña Invoke (Llamar), elija el botón Run (Ejecutar).

327

https://docs.aws.amazon.com/lambda/latest/dg/versioning-intro.html

https://docs.aws.amazon.com/lambda/latest/dg/aliases-intro.html

https://docs.aws.amazon.com/lambda/latest/dg/how-to-manage-versioning.html

https://docs.aws.amazon.com/lambda/latest/dg/how-to-manage-versioning.html

https://docs.aws.amazon.com/lambda/latest/dg/configuration-layers.html

https://docs.aws.amazon.com/serverless-application-model/latest/developerguide/serverless-sam-cli-layers.html

https://docs.aws.amazon.com/serverless-application-model/latest/developerguide/serverless-sam-template.html#serverless-sam-template-layerversion

AWS Cloud9 Guía del usuarioLlamar a una API de API Gateway

para una función Lambda relacionada

Note

Si la API no está conectada a la función, aparece un mensaje que indica que no se encuentraun desencadenador de API Gateway en el archivo de AWS SAM de la función. Para utilizareste archivo de AWS SAM para conectar una API en API Gateway a la función, consulte elrepositorio del Modelo de aplicación sin servidor de AWS (AWS SAM) de GitHub.Si llama a una API en API Gateway y, a continuación, trata de llamar al mismo códigode función para su función relacionada en Lambda con los mismos datos de entradapersonalizados, es posible que obtenga un error o el código no se ejecute según lo previsto.Para obtener más información, consulte Diferencias de respuesta al llamar a una funciónLambda desde API Gateway (p. 329).

La pestaña Invoke (Llamar) consta de dos paneles:

• El panel Test payload (Carga de prueba) muestra la configuración y los datos de entrada personalizadosque se han proporcionado para la API.

• El panel Execution results (Resultados de ejecución) muestra información como el cuerpo, losencabezados y los registros de la respuesta de la API.


328


AWS Cloud9 Guía del usuarioDiferencias de respuesta al llamar a una

función Lambda desde API Gateway

Diferencias de respuesta al llamar a una funciónLambda desde API GatewayAl llamar a una función Lambda desde una API en API Gateway y luego volver a analizar la respuesta,es posible que obtenga un error o el código podría no ejecutarse según lo previsto. Esto se debe a queLambda y API Gateway utilizan formatos de respuesta ligeramente diferentes. En concreto, API Gatewayajusta su respuesta a un objeto body principal. Para solucionar este problema, puede añadir código a unafunción que compruebe si existe un body principal en la respuesta. Si es así, puede extraer los datos deese objeto body.

Por ejemplo, en el siguiente código de función de Node.js:

'use strict';

exports.handler = function(event, context, callback) {

if (event.body) { event = JSON.parse(event.body); }

const message = "Your favorite fruit is " + event.fruit + ". " + "Your favorite vegetable is " + event.vegetable + ".";

const response = { statusCode: 200, headers: { "Content-type": "application/json" }, body: JSON.stringify( { "message": message } ) };

callback(null, response);};

Y en el siguiente código de función de Python equivalente:

import json

def lambda_handler(event, context):

329

AWS Cloud9 Guía del usuarioAñadir código dependiente a una función Lambda

if 'body' in event: event = json.loads(event["body"])

message = ("Your favorite fruit is " + event["fruit"] + ". " + "Your favorite vegetable is " + event["vegetable"] + ".")

response = { "statusCode": "200", "headers": { "Content-type": "application/json" }, "body": json.dumps({"message": message}) }

return response

Para llamar al código anterior, utilice la siguiente carga de entrada (para Lambda) o cuerpo de entrada(para API Gateway):

{ "fruit": "apple", "vegetable": "carrot"}

Que devuelve la siguiente respuesta para Lambda:

{ "statusCode": 200, "headers": { "Content-type": "application/json" }, "body": "{\"message\":\"Your favorite fruit is apple. Your favorite vegetable is carrot.\"}"}

Y devuelve la siguiente respuesta para API Gateway (suponiendo que Path (Ruta) sea / y Method (Método)sea POST):

{ "message": "Your favorite fruit is apple. Your favorite vegetable is carrot."}

Si no incluye la comprobación if (event.body) para Node.js o la comprobación if 'body' inevent para Python, al llamar a esta función desde API Gateway, se podría devolver un error o la APIpodría no ejecutarse según lo previsto.

Añadir código dependiente a una función LambdaPara Node.js, se admite el uso de Node Package Manager (npm) para añadir paquetes dependientes a lasfunciones Lambda en su entorno. Para Python, se admite pip. Para obtener información general sobre npmy pip, consulte los sitios web de npm y pip.

Para depender de un paquete npm desde una función Lambda de Node.js, utilice, por ejemplo, lainstrucción require de Node.js. A continuación, utilice npm para instalar el paquete npm relacionado enel entorno en el mismo directorio que el código de la función. Al implementar la función de Lambda tal ycomo se describe en Cargar código para una función Lambda (p. 337), AWS Cloud9 implementa tanto lafunción de Lambda como los paquetes relacionados.

Para demostrarlo, el siguiente código de ejemplo de la función Lambda de Node.js depende del paquetelodash para ordenar la carga de entrada JSON especificada.

330

https://www.npmjs.com/

https://pip.pypa.io


'use strict';

/*Assume the following payload is input:

[ { "firstName": "Shirley", "lastName": "Rodriguez" }, { "firstName": "Jane", "lastName": "Doe" }, { "firstName": "Arnav", "lastName": "Desai" }]

The expected response is:

{ "statusCode": 200, "headers": { "Content-type": "application/json" }, "body": { "result": [ { "firstName": "Arnav", "lastName": "Desai" }, { "firstName": "Jane", "lastName": "Doe" }, { "firstName": "Shirley", "lastName": "Rodriguez" } ] }}*/

exports.handler = (event, context, callback) => {

var lodash = require('lodash'); var result = lodash.orderBy(event, ['firstName'], ['asc']);

const response = { statusCode: 200, headers: { "Content-type": "application/json" }, body: JSON.stringify( { "result": result } ) };

callback(null, response);};

Para instalar el paquete lodash en el entorno, utilice una sesión de terminal en el IDE para cambiar aldirectorio que contiene el código de la función. A continuación, ejecute los dos comandos siguientes, enel orden que se indica a continuación. El primer comando crea y configura un archivo package.json endicho directorio para asegurarse de que, al implementar la función en Lambda, el paquete lodash también

331


se implementa. El segundo comando instala el paquete lodash en el mismo directorio del entorno que elcódigo de la función y, a continuación, actualiza el archivo package.json en ese directorio de la maneracorrespondiente.

npm initnpm install lodash --save

Para obtener ayuda con el comando npm init y el archivo package.json, consulte Working withpackage.json en el sitio web de npm.

Desde el IDE, llame a la versión local de la función de Lambda, tal y como se describe en Llamar a unafunción Lambda. (p. 321). Implemente la función tal y como se describe en Cargar código para unafunción Lambda (p. 337) y luego llame a la versión remota de la función. Las versiones locales y remotasde la función deberían funcionar según lo previsto.

Para depender de un paquete pip desde una función Lambda de Python, utilice, por ejemplo, la instrucciónimport de Python. A continuación, utilice pip para instalar el paquete de pip relacionado en el entornosituado un directorio por encima del directorio que contiene el código de la función. Al implementar lafunción de Lambda tal y como se describe en Cargar código para una función Lambda (p. 337), AWSCloud9 implementa tanto la función de Lambda como los paquetes relacionados.

Para demostrarlo, el siguiente código de ejemplo de la función Lambda de Python depende del paqueterequests para realizar una solicitud HTTP y, a continuación, devolver información sobre la respuestaHTTP relacionada.

'''Assume the following payload is input:

{ "url": "https://aws.amazon.com"}

The expected response is similar to the following:

{ "statusCode": "200", "headers": { "Content-type": "application/json" }, "body": { "statusCode": 200, "date": "Fri, 19 Jan 2018 17:57:48 GMT", "lastModified": "Thu, 18 Jan 2018 18:08:23 GMT" }}'''

import requestsimport json

def lambda_handler(event, context):

result = requests.get(event["url"])

response = { "statusCode": "200", "headers": { "Content-type": "application/json" }, "body": json.dumps( { "statusCode": result.status_code, "date": result.headers["Date"], "lastModified": result.headers["Last-Modified"] } ) }

332

https://docs.npmjs.com/getting-started/using-a-package.json

https://docs.npmjs.com/getting-started/using-a-package.json

AWS Cloud9 Guía del usuarioDepurar la versión local de una función

Lambda o su API de API Gateway relacionada

return response

Para instalar el paquete requests en el entorno, utilice una sesión de terminal en el IDE para cambiaral directorio que contiene el código de la función. A continuación, ejecute el siguiente comando. Estecomando instala el paquete requests en el directorio del entorno que está un directorio por encima delcódigo de la función.

pip install requests --target ../

Desde el IDE, llame a la versión local de la función de Lambda, tal y como se describe en Llamar a unafunción Lambda. (p. 321). Implemente la función tal y como se describe en Cargar código para unafunción Lambda (p. 337) y luego llame a la versión remota de la función. Las versiones locales y remotasde la función deberían funcionar según lo previsto.

Para una función Lambda de Python, para depender del código en un archivo de código de Pythonindependiente que se encuentra en el mismo directorio que la función, utilice las instrucciones from eimport. Al implementar la función de Lambda como se describe en Cargar código para una funciónLambda (p. 337), AWS Cloud9 implementa tanto la función de Lambda como los archivos de códigoPython independientes en el mismo directorio que la función.

Para demostrarlo, vamos a utilizar como ejemplo la siguiente estructura de directorios del AWS Cloud9 IDEpara una función Lambda de Python:

myDemoServerlessApplication `- myDemoFunction |- lambda-payloads.json |- lambda_function.py `- myClasses.py

Si el archivo myClasses.py contiene la definición de una clase denominada MyClass1, por ejemplo:

class MyClass1: # Class definition...

Para hacer referencia a la clase MyClass1 desde el archivo lambda_function.py, añada la siguienteinstrucción al archivo:

from myDemoFunction.myClasses import MyClass1

Depurar la versión local de una función Lambda o suAPI de API Gateway relacionadaPuede depurar código de la función Lambda local o su API de API Gateway relacionada en su entornoutilizando ayudas de depuración comunes como puntos de interrupción, avanzando por el código yestableciendo expresiones de inspección.

Note

No se puede depurar la versión remota de una función Lambda o su API de API Gatewayrelacionada en su entorno. Solo puede llamarla.

Para depurar la versión local de una función Lambda existente o su API de API Gateway relacionada,primero debe importar la versión remota de la función a su entorno de desarrollo de AWS Cloud9, si lafunción aún no está allí. Consulte Importar una función Lambda (p. 319).

333



Important

Si importa la versión remota de una función de Python a su entorno, debe elegir una de lassiguientes opciones para poder depurarla:Opción 1: Si la función de Python no utiliza venv, utilice pip para instalar IKPdb en el mismodirectorio que el archivo template.yaml de la función.Utilice una sesión de terminal en el IDE para cambiar al directorio que contiene el archivotemplate.yaml de la función. A continuación, ejecute uno de los siguientes comandos.Este comando instala el depurador IKPdb de Python en el mismo directorio que el archivotemplate.yaml de la función:

pip install ikpdb --target . # For a function that uses Python 2.7.pip-3.6 install ikp3db --target . # For a function that uses Python 3.6.

Opción 2: Si la función de Python utiliza venv, utilice pip en venv para instalar IKPdb enel directorio venv de la función y, a continuación, añada la propiedad CodeUri al archivotemplate.yaml de la función.

1. Utilice una sesión de terminal en el IDE para cambiar al directorio que contiene el archivotemplate.yaml de la función. Desde esa carpeta, ejecute uno de los siguientes comandos.Este comando utiliza pip en el directorio venv/bin de la función para instalar el depuradorIKPdb de Python en el directorio venv/lib/pythonMAJOR.MINOR/dist-packages de lafunción:

venv/bin/pip install ikpdb # For a function that uses Python 2.7.venv/bin/pip3.6 install ikp3db # For a function that uses Python 3.6.

2. En la ventana Entorno, abra el archivo template.yaml de la función para editarlo. En lasección Properties de la función, añada la propiedad CodeUri, establezca su valor en.debug/ y, a continuación, guarde el archivo. Por ejemplo:

AWSTemplateFormatVersion: '2010-09-09'Transform: 'AWS::Serverless-2016-10-31'Description: An AWS Serverless Specification template describing your function.Resources: myDemoFunction: Type: 'AWS::Serverless::Function' Properties: CodeUri: .debug/ # ...

1. En la ventana Entorno, abra el archivo que contiene el código de la función Lambda que quiera depurar.2. Establezca los puntos de interrupción y expresiones de inspección para su código. Consulte Depurar el

código (p. 159).3. En la sección Lambda de la ventana AWS Resources (Recursos de AWS), expanda la lista Local

Functions (Funciones locales) si aún no está expandida.4. Expanda la carpeta de la aplicación sin servidor que contiene la función que desea depurar.5. Elija la función que va a depurar, haga clic con el botón derecho en ella y, a continuación, elija Run, Run

Local (Ejecutar, Ejecutar localmente) o Run, Run API Gateway Local (Ejecutar, Ejecutar API Gatewaylocalmente).

Note

Si no parece que ocurra nada, es posible que ya haya abierta una pestaña para la función. Sies así, vaya a la pestaña invoke (invocar) y elija Lambda (local) o API Gateway (local).

334



6. Para una función Lambda, en el panel Test payload (Carga de prueba) de la pestaña Invoke (Llamar)que se muestra, confirme los datos de entrada personalizados que desea que utilice la función cuandola pruebe. Para obtener información acerca del formato de los datos de entrada, consulte el Paso 2.2:invocación manual de la función de Lambda y verificación de los resultados, los registros y las métricasen la AWS Lambda Developer Guide.

7. Para una API de API Gateway, en el panel Test payload (Carga de prueba) de la pestaña Invoke(Llamar) que aparece, confirme los valores de Ruta, Method (Método), Query String (Cadena deconsulta) y Body (Cuerpo) que desea que utilice la API cuando la pruebe.

Note

Es posible que algunas API no admitan configuraciones como la de Body (Cuerpo). Paraobtener más información, consulte al propietario de la API.

8. Elija, junto al botón Run (Ejecutar), Run in Debug Mode (Ejecutar en modo de depuración) (el icono deerror).

9. Seleccione el botón Run (Ejecutar).10.Decida qué es lo que se debe hacer cuando la ejecución de la función realice una pausa en un punto de

interrupción. Consulte Depurar el código (p. 159).


335



AWS Cloud9 Guía del usuarioCambiar el código en una función Lambda

Cambiar el código en una función LambdaPara utilizar el AWS Cloud9 IDE para cambiar el código de una función, primero debe importar la versiónremota relacionada de la función a su entorno de desarrollo de AWS Cloud9, si la función aún no estáallí. Para hacer esto, consulte Importar una función Lambda (p. 319). A continuación, proceda del modosiguiente:


2. Expanda la carpeta de la aplicación sin servidor que contiene la función cuyo código desea cambiar.3. Haga clic con el botón derecho en la función y, a continuación, elija Edit Function (Editar función).

4. Realice los cambios que desee en el código y, a continuación, guarde el archivo.

336

AWS Cloud9 Guía del usuarioCargar código para una función Lambda

Para cargar los cambios que realice en la versión local del código de la función en la versión remotarelacionada de Lambda, consulte Cargar código para una función Lambda (p. 337).

Cargar código para una función LambdaPara cargar la versión local de una función Lambda en su entorno en la versión remota relacionada de lafunción en Lambda, siga uno de estos procedimientos, dependiendo de cómo se creó la función.

¿Cómo se creó la función? Siga este procedimiento

Mediante el asistente Create serverless application(Crear aplicación sin servidor) en el IDE.

Cargar el código de una función Lambda creadapor el asistente para creación de aplicaciones sinservidor (p. 337)

Como parte de un proyecto de AWS CodeStar. Cargar el código de una función Lambda que formaparte de un proyecto de AWS CodeStar (p. 338)

Mediante AWS Serverless ApplicationRepository, la aplicación sin servidor requiereque se especifiquen parámetros durante laimplementación.

Cargar el código de una función de Lambda queforma parte de un proyecto de AWS ServerlessApplication Repository con parámetros (p. 338)

De cualquier otra manera. Cargar el código de una función Lambda medianteuna pila específica de AWS CloudFormation, unnombre de función o ambos (p. 339)

Cargar el código de una función Lambda creada por el asistentepara creación de aplicaciones sin servidorDespués de Crear una función Lambda con el asistente de creación de aplicaciones sin servidor (p. 312)en su entorno, puede cargar la versión local de esa función con la versión remota relacionada de la funciónen Lambda como sigue.


2. Expanda la carpeta de la aplicación sin servidor que contiene la función que desea cargar.3. Aplique alguna de las siguientes acciones:

• Haga clic con el botón derecho en la carpeta de aplicaciones sin servidor que acaba de elegir y, acontinuación, elija Deploy (Implementar).

• Haga clic con el botón derecho en la función que desea cargar y, a continuación, elija Deploy(Implementar).

• Elija la función que desea cargar y, a continuación, elija Deploy the selected Lambda function(Implementar la función Lambda seleccionada) (el botón con la flecha hacia arriba).

337


Cargar el código de una función Lambda que forma parte de unproyecto de AWS CodeStarA medida que Trabajo con proyectos de AWS CodeStar en el AWS Cloud9 Integrated DevelopmentEnvironment (IDE) (p. 306), puede cargar la versión local de esa función en su entorno en la versiónremota relacionada de la función en Lambda como sigue.

Utilice una sesión de terminal en el IDE para ejecutar el comando git push para enviar los cambiosen el código confirmados al repositorio para el proyecto de AWS CodeStar. De esta manera, se indicaa AWS CodeStar que cargue la versión local de la función Lambda en su entorno con la versión remotarelacionada de la función en Lambda.

Si no sigue este procedimiento, aparece el error "Parameters: [ProjectId] must have values" (Parámetros:[ProjectId] debe tener valores) y la función no se implementará.

Cargar el código de una función de Lambda que forma partede un proyecto de AWS Serverless Application Repository conparámetrosSi Crear e implementar funciones Lambda con AWS Serverless Application Repository (p. 317) y eseproyecto requiere que especifique parámetros durante la carga, consulte la cobertura del comandodeploy de AWS CloudFormation en the section called “Crear e implementar funciones Lambda con AWSServerless Application Repository” (p. 317) para obtener instrucciones acerca de la carga.

Si no sigue este procedimiento, aparecerá un error que indica que faltan los parámetros obligatorios y queel código no se cargará.

338


Cargar el código de una función Lambda mediante una pilaespecífica de AWS CloudFormation, un nombre de función oambosPara iniciar el proceso de carga, AWS Cloud9 indica a AWS CloudFormation que cree una pila con unnombre específico. AWS CloudFormation utiliza la información de esta pila para completar la carga dela versión local de la función Lambda de su entorno en una función específica de Lambda. De formapredeterminada, el nombre de esta pila y el nombre de la función Lambda es uno de los siguientes, quepuede cambiar si es necesario.

• Si existe un archivo .application.json oculto en la misma carpeta que la versión local de la funciónLambda y el archivo contiene un valor de StackName, el nombre de la pila es el mismo que el valorStackName y el nombre de la función Lambda es cloud9-APPLICATION_NAME-FUNCTION_NAME.

• Si no existe un archivo .application.json oculto en la misma carpeta que la versión local de lafunción Lambda, o si el archivo application.json existe, pero no contiene un valor de StackName,el nombre de la pila es cloud9-FOLDER_NAME y el nombre de la función Lambda es cloud9-APPLICATION_NAME-FUNCTION_NAME.

En los nombres de funciones y pila anteriores, FOLDER_NAME es el nombre de la carpeta relacionada en laventana entorno, mientras que APPLICATION_NAME y FUNCTION_NAME son los valores relacionados quese muestran en la sección Lambda de la ventana AWS Resources (Recursos de AWS).

Si no desea cambiar el nombre de la pila de AWS CloudFormation predeterminada o el nombre de funciónpredeterminada en Lambda, vaya al procedimiento de carga que se encuentra al final de esta sección.

Para utilizar o crear una pila de AWS CloudFormation no predeterminada en su cuenta de AWS en lamisma región de AWS que se muestra en la sección Lambda de la ventana AWS Resources (Recursos deAWS), realice una de las siguientes acciones.

• Si desea utilizar una pila de AWS CloudFormation existente para cargar el código, en la secciónLambda de la ventana AWS Resources (Recursos de AWS), haga clic con el botón derecho del ratónen la carpeta de aplicaciones sin servidor que contiene la función de Lambda en la que desea cargarel código, seleccione Link to CloudFormation Stack (Enlace a pila de CloudFormation) y siga lasinstrucciones de la pantalla para elegir la pila existente que se utilizará.

Note

Solo puede elegir entre las pilas existentes que se encuentran en los siguientes estados deAWS CloudFormation.• CREATE_COMPLETE

• CREATE_IN_PROGRESS

• REVIEW_IN_PROGRESS

• ROLLBACK_COMPLETE

• ROLLBACK_IN_PROGRESS

• UPDATE_COMPLETE

• UPDATE_COMPLETE_CLEANUP_IN_PROGRESS

• UPDATE_IN_PROGRESS

• UPDATE_ROLLBACK_COMPLETE

• UPDATE_ROLLBACK_COMPLETE_CLEANUP_IN_PROGRESS

• UPDATE_ROLLBACK_IN_PROGRESS

• Si desea crear una nueva pila de AWS CloudFormation con un nombre que especifique, realice una delas siguientes acciones:

339


• Si existe un archivo .application.json oculto en la misma carpeta que la versión local de lafunción Lambda y el archivo contiene un valor de StackName, cambie el valor de StackName delarchivo .application.json por el nombre de la pila de AWS CloudFormation que desea utilizar y,a continuación, guarde el archivo .application.json.

• Si existe un archivo .application.json oculto en la misma carpeta que la versión localde la función Lambda, pero el archivo no contiene un valor de StackName, añada un valor deStackName al comienzo del archivo .application.json con el nombre de la nueva pila de AWSCloudFormation que desea utilizar y, a continuación, guarde el archivo .application.json. Porejemplo, para un nombre de pila de MyDemoStack, añada el siguiente valor al principio del archivo.(No escriba los puntos suspensivos. Solo se muestran para ayudarle a añadir el valor a la ubicacióncorrecta en el archivo).

{ "StackName": "MyDemoStack", ...}

• Si no existe un archivo .application.json oculto en la misma carpeta que la versión localde la función Lambda, cree un nuevo archivo .application.json en dicha carpeta, añada unvalor de StackName al archivo .application.json con el nombre de la nueva pila de AWSCloudFormation que desea utilizar y, a continuación, guarde el archivo .application.json. Porejemplo, para un nombre de pila de MyDemoStack, añada el siguiente valor al archivo.

{ "StackName": "MyDemoStack"}

Para cargar el código en una función de Lambda que no sea la predeterminada de su cuenta de AWS enla misma región de AWS que se muestra en la sección Lambda de la ventana AWS Resources (Recursosde AWS), añada el nombre de la función como un valor de FunctionName a la sección Propertiesdel recurso de función de Lambda en el archivo de plantilla de AWS SAM relacionado (por ejemplo,template.yaml). Por ejemplo, para un recurso de función Lambda llamado MyDemoFunction, añadaun valor de FunctionName de MyDemoFunction para cargar el código en una función Lambda llamadaMyDemoFunction en lugar de cloud9-APPLICATION_NAME-FUNCTION_NAME. (No escriba los puntossuspensivos. Solo se muestran para ayudarle a añadir el valor a la ubicación correcta en el archivo).

...Resources: MyDemoFunction: Type: AWS::Serverless::Function Properties: FunctionName: MyDemoFunction ...

Cuando esté listo para cargar el código, haga lo siguiente.


2. Expanda la carpeta de la aplicación sin servidor que contiene la función que desea cargar.3. Aplique alguna de las siguientes acciones:

• Haga clic con el botón derecho en la carpeta de aplicaciones sin servidor que acaba de elegir y, acontinuación, elija Deploy (Implementar).

• Haga clic con el botón derecho en la función que desea cargar y, a continuación, elija Deploy(Implementar).

340

AWS Cloud9 Guía del usuarioConvertir una función Lambda en una aplicación sin servidor

• Elija la función que desea cargar y, a continuación, elija Deploy the selected Lambda function(Implementar la función Lambda seleccionada) (el botón con la flecha hacia arriba).

Convertir una función Lambda en una aplicación sinservidorSi la versión local de una función Lambda existente en su entorno de desarrollo de AWS Cloud9 no formaparte ya de una aplicación sin servidor, puede utilizar el AWS Cloud9 IDE para convertir esa función enuna aplicación sin servidor. A continuación, puede utilizar el archivo de plantilla de AWS SAM de esaaplicación sin servidor para crear recursos de AWS de apoyo adicionales para su función. Para obtenermás información, consulte el repositorio del Modelo de aplicación sin servidor de AWS (AWS SAM) enGitHub.

Para convertir la versión local de una función Lambda existente en una aplicación sin servidor, primerodebe importar la versión remota de la función a su entorno de desarrollo de AWS Cloud9, si la función aúnno está allí. Consulte Importar una función Lambda (p. 319).


2. Haga clic con el botón derecho en la función que desea convertir y, a continuación, elija Convert to SAM(Convertir a SAM).

341


AWS Cloud9 Guía del usuarioConvertir una función Lambda en una aplicación sin servidor

AWS Cloud9 hace lo siguiente:

• En la carpeta de la función de la ventana entorno, la configuración DeploymentMethod en el archivo.application.json cambia de lambda a cloudformation. Es decir, ahora AWS Cloud9 indicaráa AWS SAM que utilice AWS CloudFormation cada vez que utilice el IDE para cargar el código de lafunción como parte de la aplicación sin servidor (lambda significa que AWS Cloud9 indicará a Lambdaque implemente la función en su lugar). Para cargar el código de función, consulte the section called“Cargar código para una función Lambda” (p. 337).

• En la sección Lambda de la ventana AWS Resources (Recursos de AWS), en la lista Local Functions(Funciones locales), AWS Cloud9 añade la función de Lambda existente a una nueva aplicación sinservidor (representada por un icono de Lambda dentro de una carpeta). La aplicación sin servidor tieneel mismo nombre que la función.

Al cargar el código de la función tal y como se describe en Cargar código para una funciónLambda (p. 337), dado que el método de carga de la función ya no es Lambda si no que AWS SAMusa AWS CloudFormation, AWS Cloud9 crea una nueva versión remota de la función en Lambda y laañade a la lista Remote Functions (Funciones remotas). AWS Cloud9 proporciona a la versión remota unnombre distinto de la función de Lambda original. Por ejemplo, si el nombre de la aplicación sin servidory el de la función son myDemoFunction, el nombre de la versión remota de su función sería cloud9-myDemoFunction-myDemoFunction-RANDOM_ID, donde RANDOM_ID es un ID determinado de formaaleatoria.

Important

Después de realizar la conversión, si, a continuación, utiliza el IDE para realizar algún cambio enel código de la función y luego carga ese código en Lambda, el cambio solo estará en la versiónremota de la nueva función (por ejemplo, cloud9-myDemoFunction-myDemoFunction-RANDOM_ID). La versión remota de la función original (por ejemplo, myDemoFunction) nocambiará.Si cambia de opinión y desea habilitar el IDE para regresar para cargar sus cambios en el códigode la versión remota de la función original (por ejemplo, myDemoFunction), haga lo siguiente:

1. En la carpeta de la función de la ventana entorno, cambie el ajuste DeploymentMethod en elarchivo .application.json de cloudformation a lambda y, a continuación, guarde elarchivo. Esto elimina la aplicación sin servidor de la lista Local Functions (Funciones locales) yprovoca que AWS Cloud9 retroceda para pedirle a Lambda que implemente la función.

2. Cargue el código de la función tal y como se describe en Cargar código para una funciónLambda (p. 337). Ahora, solo la versión remota de la función original (por ejemplo,myDemoFunction) contendrá el cambio. La versión remota de la nueva función (por ejemplo,cloud9-myDemoFunction-myDemoFunction-RANDOM_ID) no cambiará.

3. Dado que AWS Cloud9 dejará de cargar cambios en el código en la versión remota de lanueva función (por ejemplo, cloud9-myDemoFunction-myDemoFunction-RANDOM_ID),

342

AWS Cloud9 Guía del usuarioActualizar los ajustes de

configuración de una función Lambda

si lo desea, puede utilizar la consola de Lambda para eliminar la nueva función (por ejemplo,cloud9-myDemoFunction-myDemoFunction-RANDOM_ID).

Actualizar los ajustes de configuración de una funciónLambdaPuede utilizar el AWS Cloud9 IDE para cambiar la configuración de la función como, por ejemplo, ladescripción, el identificador del controlador, la cantidad de memoria que utilizará la función y el rol deejecución existente que utilizará la función.

Para cambiar los ajustes de configuración, primero debe importar la versión remota relacionada de lafunción a su entorno de desarrollo de AWS Cloud9, si la función aún no está allí. Para hacer esto, consulteImportar una función Lambda (p. 319). A continuación, proceda del modo siguiente.


2. Expanda la carpeta de la aplicación sin servidor que contiene la función cuyo ajuste desea cambiar.3. Haga clic con el botón derecho en la función y, a continuación, elija Edit Config (Editar configuración).

4. Realice cambios en los ajustes de la configuración y, a continuación, guarde el archivo.

Note

De forma predeterminada, los ajustes de la configuración se muestran en texto sin formato.Para cambiar este comportamiento para ver los ajustes de la configuración en un editor visualde forma predeterminada, elija AWS Cloud9, Preferences (AWS Cloud9, Preferencias) en labarra de menús. Elija AWS Settings (Configuración de AWS) y, a continuación, active Use AWSSAM visual editor (Utilizar el editor visual de AWS SAM). Para utilizar el editor visual, cierreel archivo template.yaml de la función y, a continuación, haga clic con el botón derechoen la función y elija Edit Config (Editar configuración) de nuevo. Para volver a utilizar texto sinformato de forma predeterminada, desactive el ajuste Use AWS SAM visual editor (Utilizar eleditor visual de AWS SAM). Para editar temporalmente texto sin formato, elija View with text

343

AWS Cloud9 Guía del usuarioEliminar una función Lambda

editor (Ace) (Ver con editor de texto (Ace)) en el editor visual y, a continuación, elija View,Editors, Ace (Ver, Editores, Ace) en la barra de menús.

5. Aplique alguna de las siguientes acciones:• En la pestaña de ajustes de configuración, en la vista de la configuración simplificada, elija el botón

Upload Settings to Lambda (Cargar configuración en Lambda).• Siga las instrucciones de Cargar código para una función Lambda (p. 337).

Eliminar una función LambdaPuede eliminar la versión local de una función Lambda desde su entorno, eliminar la versión remota de lafunción desde Lambda o ambas, de la siguiente manera.

Temas• Eliminar la versión local de una función Lambda (p. 344)• Eliminar la versión remota de la función Lambda (p. 345)

Eliminar la versión local de una función LambdaUtilice la ventana entorno en el AWS Cloud9 IDE para eliminar el directorio que contiene la función. (Nopuede utilizar la sección Lambda de la ventana AWS Resources [Recursos de AWS] en el AWS Cloud9IDE para eliminar la versión local de una función de Lambda).

Warning

Si elimina accidentalmente la versión local de una función Lambda, la única forma de volver aañadirla a su entorno es importar la versión remota de la función a su entorno, si la versión remotatodavía existe. Para obtener instrucciones, consulte Importar una función Lambda (p. 319).

344


Eliminar la versión remota de la función LambdaPara eliminar la versión remota de la función Lambda, utilice la consola de Lambda, la consola deAWS CloudFormation o el código. (No puede utilizar la sección Lambda de la ventana AWS Resources[Recursos de AWS] en el AWS Cloud9 IDE para eliminar la versión remota de una función de Lambda).

Para determinar qué método utilizar para eliminar la versión remota de una función Lambda, en el menúAWS Cloud9 IDE, abra el archivo .application.json que se encuentra en el mismo directorio quela versión local de la función Lambda. Si el valor DeploymentMethod se establece en lambda, utiliceLambda para eliminar la función. Si el valor DeploymentMethod se establece en cloudformation,debe utilizar AWS CloudFormation para eliminar la función.

Note

Si el valor DeploymentMethod se establece en cloudformation en el archivo.application.json, no se recomienda utilizar Lambda para eliminar la función. Si utilizaLambda en lugar de AWS CloudFormation para eliminar la función en este caso, podría dejaralgunos recursos de AWS asociados. Esos recursos restantes podrían generar cargos recurrentesen su cuenta de AWS.

Temas• Usar Lambda para eliminar la versión remota de la función (p. 345)• Usar AWS CloudFormation para eliminar la versión remota de la función (p. 346)

Usar Lambda para eliminar la versión remota de la función

Utilice la consola de Lambda o el código para eliminar la función que tiene el mismo nombre que la funciónde la sección Lambda de la ventana AWS Resources (Recursos de AWS) o el valor PhysicalId en elarchivo .application.json, como sigue.

Warning

Cuando se elimina la versión remota de una función, se elimina permanentemente de Lambda. Sielimina accidentalmente la versión remota de una función y necesita recuperarla, puede cargar laversión local de la función en Lambda, si aún existe la versión local. Para obtener instrucciones,consulte Cargar código para una función Lambda (p. 337).

• Para eliminar la función utilizando la consola de Lambda haga lo siguiente.1. Abra la consola de Lambda en https://console.aws.amazon.com/lambda.2. En la barra de navegación de AWS, si no se muestra la región de AWS que contiene la función de

Lambda, selecciónela.3. Si no se muestra la lista de funciones, seleccione Functions (Funciones) en el panel de navegación de

servicio.4. Aplique alguna de las siguientes acciones.

• Elija el botón de opción junto al nombre de la función que desea eliminar. A continuación, elijaActions, Delete (Acciones, Eliminar). Confirme la eliminación eligiendo Delete (Eliminar).

• Elija el nombre de la función que desea eliminar. A continuación, elija Actions, Delete Function(Acciones, Eliminar función). Confirme la eliminación eligiendo Delete (Eliminar).

• Para eliminar la función mediante código, llame a la operación de eliminación de función de Lambda,como se indica a continuación.

AWS CLI delete-function

AWS SDK para C++ DeleteFunctionRequest

345

https://console.aws.amazon.com/lambda

https://docs.aws.amazon.com/cli/latest/reference/lambda/delete-function.html

https://sdk.amazonaws.com/cpp/api/LATEST/class_aws_1_1_lambda_1_1_model_1_1_delete_function_request.html


AWS SDK for Go DeleteFunction, DeleteFunctionRequest,DeleteFunctionWithContext

AWS SDK for Java DeleteFunctionRequest, DeleteFunctionResult

AWS SDK for JavaScript deleteFunction

AWS SDK para .NET DeleteFunctionRequest, DeleteFunctionResponse

AWS SDK para PHP deleteFunction

AWS SDK for Python (Boto) delete_function

AWS SDK parar Ruby delete_function

Herramientas de AWS para Windows PowerShell Remove-LMFunction

API de Lambda DeleteFunction

Usar AWS CloudFormation para eliminar la versión remota de la funciónUtilice la consola de AWS CloudFormation o el código para eliminar la pila que tiene el mismo nombre queel valor StackName del archivo .application.json, como se indica a continuación.

Warning

Al eliminar una pila, AWS CloudFormation elimina todos los recursos de AWS asociados aella. Esto incluye no solo funciones Lambda, sino que también podría incluir otros recursosrelacionados como las API en Amazon API Gateway. Si elimina accidentalmente la versión remotade una función y necesita recuperarla, puede cargar la versión local de la función del AWS Cloud9IDE en Lambda, si aún existe la versión local. Para obtener instrucciones, consulte Cargar códigopara una función Lambda (p. 337). Los demás recursos de la pila se eliminan permanentementey no se pueden recuperar.

• Para eliminar la pila utilizando la consola de AWS CloudFormation haga lo siguiente.1. Abra la consola de AWS CloudFormation en https://console.aws.amazon.com/cloudformation.2. En la barra de navegación de AWS, si no se muestra la región de AWS que contiene la pila,

selecciónela.3. En la lista de pilas, realice una de las siguientes acciones.

• Seleccione la casilla de verificación situada junto al nombre de la pila que desea eliminar. Acontinuación, elija Actions, Delete Stack (Acciones, Eliminar pila). Confirme la eliminación eligiendoYes, Delete (Sí, Eliminar).

• Elija el nombre de la pila que desea eliminar. A continuación, elija Other Actions, Delete Stack(Otras acciones, Eliminar pila). Confirme la eliminación eligiendo Yes, Delete (Sí, Eliminar).

• Para eliminar la pila mediante código, llame a la operación de eliminación de pila de AWSCloudFormation, como se indica a continuación.

AWS CLI delete-stack

AWS SDK para C++ DeleteStackRequest

AWS SDK for Go DeleteStack, DeleteStackRequest,DeleteStackWithContext

AWS SDK for Java DeleteStackRequest, DeleteStackResult

AWS SDK for JavaScript deleteStack

346

https://docs.aws.amazon.com/sdk-for-go/api/service/lambda/#Lambda.DeleteFunction

https://docs.aws.amazon.com/sdk-for-go/api/service/lambda/#Lambda.DeleteFunctionRequest

https://docs.aws.amazon.com/sdk-for-go/api/service/lambda/#Lambda.DeleteFunctionWithContext

https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/lambda/model/DeleteFunctionRequest.html

https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/lambda/model/DeleteFunctionResult.html

https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/Lambda.html#deleteFunction-property

https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/Lambda/TDeleteFunctionRequest.html

https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/Lambda/TDeleteFunctionResponse.html

https://docs.aws.amazon.com/aws-sdk-php/v3/api/api-lambda-2015-03-31.html#deletefunction

https://boto3.readthedocs.io/en/latest/reference/services/lambda.html#Lambda.Client.delete_function

https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/Lambda/Client.html#delete_function-instance_method

https://docs.aws.amazon.com/powershell/latest/reference/items/Remove-LMFunction.html

https://docs.aws.amazon.com/lambda/latest/dg/API_DeleteFunction.html

https://console.aws.amazon.com/cloudformation

https://docs.aws.amazon.com/cli/latest/reference/cloudformation/delete-stack.html

https://sdk.amazonaws.com/cpp/api/LATEST/class_aws_1_1_cloud_formation_1_1_model_1_1_delete_stack_request.html

https://docs.aws.amazon.com/sdk-for-go/api/service/cloudformation/#CloudFormation.DeleteStack

https://docs.aws.amazon.com/sdk-for-go/api/service/cloudformation/#CloudFormation.DeleteStackRequest

https://docs.aws.amazon.com/sdk-for-go/api/service/cloudformation/#CloudFormation.DeleteStackWithContext

https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/cloudformation/model/DeleteStackRequest.html

https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/cloudformation/model/DeleteStackResult.html

https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/CloudFormation.html#deleteStack-property

AWS Cloud9 Guía del usuarioTrabajo con AWS CodePipeline

AWS SDK para .NET DeleteStackRequest, DeleteStackResponse

AWS SDK para PHP deleteStack

AWS SDK for Python (Boto) delete_stack

AWS SDK parar Ruby delete_stack

Herramientas de AWS para Windows PowerShell Remove-CFNStack

API de AWS CloudFormation DeleteStack

Trabajar con AWS CodePipeline en el AWS Cloud9Integrated Development Environment (IDE)

Puede utilizar el AWS Cloud9 IDE para trabajar con código fuente en los repositorios que son compatiblescon AWS CodePipeline.

CodePipeline es un servicio de entrega continua que puede utilizar para modelar, visualizar y automatizarlos pasos necesarios para lanzar su software y los cambios continuos que realice. Puede utilizarCodePipeline para modelar y configurar rápidamente las diferentes etapas de un proceso de lanzamientode software. Para obtener más información, consulte la Guía del usuario de AWS CodePipeline.

Note

El uso de estos procedimientos puede producir cargos en su cuenta de AWS. Entre estos seincluyen posibles cargos por servicios como Amazon EC2, CodePipeline, Amazon S3 y losservicios de AWS compatibles con CodePipeline. Para obtener más información, consulte Preciosde Amazon EC2, Precios de AWS CodePipeline y Precios de Amazon S3 y Precios de losservicios en la nube.AWS CodeStar proporciona características adicionales junto con las canalizaciones como,por ejemplo, plantillas de proyecto, paneles y equipos. Para utilizar AWS CodeStar en lugarde CodePipeline, omita el resto de este tema y consulte Trabajo con proyectos de AWSCodeStar (p. 306) en su lugar.

• Paso 1: Crear o identificar el repositorio del código fuente (p. 347)• Paso 2: Crear un entorno de desarrollo de AWS Cloud9, conectarlo al repositorio de código y cargar el

código (p. 348)• Paso 3: Prepararse para trabajar con AWS CodePipeline (p. 349)• Paso 4: Crear una canalización en AWS CodePipeline (p. 349)

Paso 1: Crear o identificar el repositorio del códigofuenteEn este paso, se crea o identifica un repositorio de código fuente que es compatible con CodePipeline.

Más adelante en este tema, cargue el código fuente del software ese repositorio. CodePipeline compilará,probará e implementará el código fuente cargado en ese repositorio utilizando canalizaciones relacionadasque también creará usted.

El repositorio de código fuente debe ser uno de los siguientes tipos de repositorio que admiteCodePipeline :

347

https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/CloudFormation/TDeleteStackRequest.html

https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/CloudFormation/TDeleteStackResponse.html

https://docs.aws.amazon.com/aws-sdk-php/v3/api/api-cloudformation-2010-05-15.html#deletestack

https://boto3.readthedocs.io/en/latest/reference/services/cloudformation.html#CloudFormation.Client.delete_stack

https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/CloudFormation/Client.html#delete_stack-instance_method

https://docs.aws.amazon.com/powershell/latest/reference/items/Remove-CFNStack.html

https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_DeleteStack.html

https://docs.aws.amazon.com/codepipeline/latest/userguide/welcome.html



https://aws.amazon.com/codepipeline/pricing/

https://aws.amazon.com/s3/pricing/



AWS Cloud9 Guía del usuarioPaso 2: Crear un entorno de desarrollo de AWS Cloud9,

conectarlo al repositorio de código y cargar el código

• AWS CodeCommit. Si ya tiene un repositorio en CodeCommit que desea utilizar, vaya directamente alPaso 2: Crear un entorno de desarrollo de AWS Cloud9, conectarlo al repositorio de código y cargar elcódigo (p. 348). De lo contrario, para utilizar CodeCommit, siga estas instrucciones en el Ejemplo deAWS CodeCommit, en este orden y, a continuación, vuelva a este tema:• Paso 1: Configurar el grupo de IAM con los permisos de acceso necesarios (p. 383)• Paso 2: Crear un repositorio en AWS CodeCommit (p. 384)

• Amazon S3. Si ya tiene un bucket en Amazon S3 que desea utilizar, vaya directamente al Paso2: Crear un entorno de desarrollo de AWS Cloud9, conectarlo al repositorio de código y cargar elcódigo (p. 348). De lo contrario, para utilizar Amazon S3, siga estas instrucciones en la Guía deintroducción a Amazon Simple Storage Service, en este orden y, a continuación, vuelva a este tema:• Inscribirse en Amazon S3• Crear un bucket

• GitHub. Si ya tiene un repositorio en GitHub que desea utilizar, vaya directamente al Paso 2: Crear unentorno de desarrollo de AWS Cloud9, conectarlo al repositorio de código y cargar el código (p. 348).De lo contrario, para utilizar GitHub, siga estas instrucciones en el Ejemplo de GitHub, en este orden y, acontinuación, vuelva a este tema:• Paso 1: Crear una cuenta de GitHub (p. 389)• Paso 2: Crear un repositorio de GitHub (p. 389)

Paso 2: Crear un entorno de desarrollo de AWSCloud9, conectarlo al repositorio de código y cargar elcódigoEn este paso va a crear un entorno de desarrollo de AWS Cloud9 en la consola de AWS Cloud9. Acontinuación, conectará el entorno al repositorio que utilizará CodePipeline. Por último, se utilizará el AWSCloud9 IDE para que el entorno cargue el código fuente en el repositorio.

Para crear el entorno, siga las instrucciones del tema Creación de un entorno (p. 61) y, a continuación,vuelva a este tema. (Si ya tiene un entorno, puede utilizarlo. No es necesario que cree uno nuevo).

Para conectar el entorno al repositorio y, a continuación, cargar el código fuente en el repositorio si aún noestá allí, utilice uno de los siguientes conjuntos de instrucciones. El conjunto que elija dependerá del tipode repositorio que almacene el código fuente.

Repository type Instrucciones

CodeCommit Siga estas instrucciones en el Ejemplo de AWSCodeCommit:

• Paso 3: Conectar el entorno con un repositorioremoto (p. 385)

• Paso 4: Clonar el repositorio remoto en suentorno (p. 386)

• Paso 5: Añadir archivos al repositorio (p. 386),sustituyendo su propio código fuente para estepaso

Amazon S3 • Instale y configure la AWS CLI o el shell deAWS en el entorno, tal y como se describeen el Ejemplo de la CLI de AWS y el shell deaws (p. 379).

348

https://docs.aws.amazon.com/AmazonS3/latest/gsg/SigningUpforS3.html

https://docs.aws.amazon.com/AmazonS3/latest/gsg/CreatingABucket.html

AWS Cloud9 Guía del usuarioPaso 3: Prepararse para trabajar con AWS CodePipeline

Repository type Instrucciones• Para cargar el código fuente en el bucket, utilice

la AWS CLI o el shell de AWS en el entorno paraejecutar el comando aws s3 cp. (Para el aws-shell, puede eliminar aws del comando).

GitHub Siga estas instrucciones en el Ejemplo de GitHub:

• Paso 3: Instalar Git en su entorno (p. 389)• Paso 4: Clonar el repositorio remoto en su

entorno (p. 390)• Paso 5: Añadir archivos al repositorio (p. 390),

sustituyendo su propio código fuente para estepaso

Después de conectar el entorno al repositorio, siempre que envíe los cambios en el código fuente desdeel AWS Cloud9 IDE; al repositorio, CodePipeline envía automáticamente esos cambios a través de lascanalizaciones relacionadas que se van a compilar, probar e implementar. Creará una canalizaciónrelacionada más adelante en este tema.

Paso 3: Prepararse para trabajar con AWSCodePipelineEn este paso, se asocia una política administrada de AWS específica al grupo de IAM que ha creado oidentificado en Configuración de equipos (p. 8). De este modo, los usuarios del grupo pueden comenzar acrear y utilizar canalizaciones en CodePipeline.

Si ya ha utilizado antes CodePipeline vaya directamente al Paso 4: Crear una canalización en AWSCodePipeline (p. 349).

En este paso, siga las instrucciones del Paso 3: Usar una política administrada de IAM para asignarpermisos de AWS CodePipeline al usuario de IAM en la Guía del usuario de AWS CodePipeline y, acontinuación, vuelva a este tema.

Paso 4: Crear una canalización en AWS CodePipelineEn este paso, se crea una canalización en CodePipeline que utiliza el repositorio que ha creado oidentificado anteriormente en este tema.

En este paso, siga las instrucciones que se describen en Crear una canalización en AWS CodePipeline enla Guía del usuario de AWS CodePipeline.

Después de crear la canalización, CodePipeline envía la versión actual del código fuente del repositorioa través de la canalización que se va a compilar, probar e implementar. Luego, siempre que envíe loscambios en el código fuente desde el AWS Cloud9 IDE al repositorio, CodePipeline envía automáticamenteesos cambios a través de la canalización que se va a compilar, probar e implementar.

Para ver la canalización, siga las instrucciones que se indican en Ver los detalles y el historial de lacanalización en AWS CodePipeline en la Guía del usuario de AWS CodePipeline.

349

https://docs.aws.amazon.com/cli/latest/reference/s3/cp.html

https://docs.aws.amazon.com/codepipeline/latest/userguide/getting-started-codepipeline.html#assign-permissions

https://docs.aws.amazon.com/codepipeline/latest/userguide/getting-started-codepipeline.html#assign-permissions

https://docs.aws.amazon.com/codepipeline/latest/userguide/pipelines-create.html

https://docs.aws.amazon.com/codepipeline/latest/userguide/pipelines-view.html

https://docs.aws.amazon.com/codepipeline/latest/userguide/pipelines-view.html

AWS Cloud9 Guía del usuarioTutorial sobre AWS Lambda

Tutoriales y ejemplos para AWSCloud9

¿Es la primera vez que utiliza AWS Cloud9? Haga un recorrido por el IDE en Introducción: tutorialesbásicos (p. 41).

Experimente con estos tutoriales para aumentar sus conocimientos y confianza con AWS Cloud9 condiversos lenguajes de programación y servicios de AWS.

Temas• Tutorial de AWS Lambda para AWS Cloud9 (p. 350)• Tutorial avanzado de AWS Lambda para AWS Cloud9 (p. 368)• Muestra de AWS Command Line Interface y el aws-shell para AWS Cloud9 (p. 379)• Ejemplo de AWS CodeCommit para AWS Cloud9 (p. 382)• Ejemplo de GitHub para AWS Cloud9 (p. 388)• Ejemplo de Amazon DynamoDB para AWS Cloud9 (p. 392)• Ejemplo de AWS CDK para AWS Cloud9 (p. 404)• Ejemplo de LAMP para AWS Cloud9 (p. 411)• Ejemplo de WordPress para AWS Cloud9 (p. 418)• Muestra de Java para AWS Cloud9 (p. 429)• Demostración de C++ para AWS Cloud9 (p. 439)• Tutorial de Python para AWS Cloud9 (p. 448)• Muestra de .NET Core para AWS Cloud9 (p. 452)• Ejemplo de Node.js para AWS Cloud9 (p. 460)• Ejemplo de PHP para AWS Cloud9 (p. 465)• Tutorial: Ruby en AWS Cloud9 (p. 471)• Ejemplo de Go para AWS Cloud9 (p. 477)• Muestra de TypeScript para AWS Cloud9 (p. 483)• Ejemplo de Docker para AWS Cloud9 (p. 490)• Ejemplos relacionados (p. 499)

Tutorial de AWS Lambda para AWS Cloud9En este tutorial, utilizaremos el AWS Cloud9 IDE para crear una función en AWS Lambda y una APIasociada en Amazon API Gateway. Después de crear la función y su API, se ejecutan y depuranlocalmente. A continuación ejecutará la función y la API en Lambda y API Gateway en producción.

Note

El uso de este tutorial puede producir cargos en su cuenta de AWS. Entre estos se incluyenposibles cargos por Amazon EC2, Lambda y API Gateway. Para obtener más información,consulte Precios de Amazon EC2, Precios de AWS Lambda y Precios de Amazon API Gateway.

350




AWS Cloud9 Guía del usuarioRequisitos previos


Pasos• Paso 1: Crear y abrir el entorno (p. 351)• Paso 2: Crear la función de Lambda y la API (p. 353)• Paso 3: Añadir código a la función (p. 356)• Paso 4: Ejecutar o depurar la función localmente (p. 358)• Paso 5: Ejecutar o depurar la API localmente (p. 361)• Paso 6: Ejecutar la función en producción (p. 363)• Paso 7: Ejecutar la API en producción (p. 364)• Paso 8: Cambiar la función e implementar el cambio (p. 364)• Paso 9: Eliminación (p. 365)• Información relacionada (p. 367)

Paso 1: Crear y abrir el entorno(Primer paso del Tutorial de AWS Lambda para AWS Cloud9 (p. 350))

En este paso va a utilizar la consola de AWS Cloud9 para crear un entorno de desarrollo de AWS Cloud9 ydespués abrirlo.

Note

Si ya tiene un entorno, ábralo y vaya a Paso 2: Crear la función de Lambda y la API (p. 353).

En AWS Cloud9, el entorno de desarrollo (o simplemente el entorno) es el lugar en el que se almacenanlos archivos del proyecto de desarrollo y donde se ejecutan las herramientas para desarrollar aplicaciones.En este tutorial, creará un tipo especial de entorno llamado entorno de EC2. Para este tipo de entorno,AWS Cloud9 lanza y administra una nueva instancia Amazon EC2 que se ejecuta en Amazon Linux oUbuntu Server, crea el entorno y, a continuación, conecta el entorno a la instancia recién lanzada. Alabrir el entorno, AWS Cloud9 muestra el AWS Cloud9 IDE que le permite trabajar con los archivos yherramientas en ese entorno.

1. Inicie sesión en la consola de AWS Cloud9 como sigue:






351



AWS Cloud9 Guía del usuarioPaso 1: Crear y abrir el entorno




4. En la página Name entorno (Asignar nombre al entorno), en Name (Nombre), escriba un nombre parael entorno. Para este tutorial, escriba my-lambda-entorno.

5. En Description (Descripción), escriba algo acerca de su entorno. Para este tutorial, utilice Thisentorno is for the AWS Cloud9 tutorial for Lambda.

6. Elija Next Step.7. En la página Configure settings (Configurar ajustes), en entorno type (Tipo de entorno), elija Create a


Warning


352

AWS Cloud9 Guía del usuarioPaso 2: Crear la función de Lambda y la API

8. En Instance type (Tipo de instancia), deje la opción predeterminada. Esta opción tiene RAM y vCPUrelativamente bajos, lo que es suficiente para este tutorial.

Warning




Warning



Warning



Cloud9 crea su entorno. Esto puede tardar varios minutos.

Note




Paso siguientePaso 2: Crear la función de Lambda y la API (p. 353)

Paso 2: Crear la función de Lambda y la API(Paso anterior: Paso 1: Crear y abrir el entorno (p. 351))

En este paso, utilice el AWS Cloud9 IDE para crear la función de Lambda y su API correspondiente almismo tiempo. AWS Cloud9 almacena la nueva función en la instancia Amazon EC2 e implementa una

353





copia de la función en Lambda. AWS Cloud9 también almacena la nueva API asociada a la instancia eimplementa una copia de la API en API Gateway.

La función de Lambda devuelve información sobre el día o la hora que especifique, por ejemplo, el día, elmes y el año, o la hora, el minuto y el segundo actuales.

En la actualidad puede utilizar el IDE para crear automáticamente funciones que solo utilicen Node.js oPython. Esta función utiliza Node.js.

1. Asegúrese de haber completado los requisitos previos para trabajar con las funciones Lambda en elAWS Cloud9 IDE para el entorno. Esto incluye la comprobación de si debe hacer lo siguiente:

• Configurar el grupo de IAM con los permisos de acceso necesarios.• Configurar su entorno con las credenciales de acceso de AWS.• Crear una regla de ejecución para sus funciones Lambda.

Para obtener más información, consulte Prepararse para trabajar con funciones Lambda (p. 309).2. Con el IDE abierto desde el paso anterior, configure la región de AWS en la que desea crear la

función. Para ello, en la barra de menús, elija AWS Cloud9, Preferences (AWS Cloud9, Preferencias).3. En el panel de navegación de la pestaña Preferences (Preferencias), elija AWS Settings

(Configuración de AWS).4. En AWS Region (Región de AWS), seleccione la región de AWS en la que desea crear la función.

5. En el lateral del IDE, elija AWS Resources (Recursos de AWS).

354


6. Amplíe la opción Lambda, si todavía no está ampliada. En la barra de herramientas, haga clic en elicono Create a new Lambda function (Crear una nueva función Lambda).

7. En el cuadro de diálogo Create serverless application (Crear una aplicación sin servidor),en Function name (Nombre de la función), escriba un nombre para la función (por ejemplo,myDateTimeFunction).

8. En Application name (Nombre de la aplicación), escriba un nombre para la función que contenga laaplicación sin servidor (por ejemplo, MyDateTimeApplication).

9. Seleccione Next (Siguiente).10. En Select runtime (Seleccionar tiempo de ejecución), elija Node.js 6.10.11. En Select blueprint (Seleccionar proyecto), elija empty-nodejs. Se creará un código de inicio con el que

trabajar en el siguiente paso.12. Seleccione (Next) Siguiente.13. En Function trigger (Desencadenador de la función), elija API Gateway. Se creará una API en API

Gateway para ejecutar y depurar la función en un paso posterior.14. En Resource Path (Ruta al recurso), escriba / (barra inclinada). Con Resource Path (Ruta al recurso)

se define una parte de la URL que se utiliza para ejecutar y depurar la API en un paso posterior. Paraobtener más información, consulte Configuración de métodos de la API en API Gateway en la Guíapara desarrolladores de API Gateway.

15. En Security (Seguridad), elija NONE (Ninguna) y, a continuación, seleccione Next (Siguiente). Estoespecifica que no se necesitan credenciales especiales para ejecutar y depurar esta API.

16. En Memory (MB) (Memoria [MB]), deje el valor predeterminado, 128 MB, suficiente para este tutorial.17. En Role (Rol), deje el valor predeterminado, Automatically generate role (General rol

automáticamente) y, a continuación, seleccione Next (Siguiente). Esto especifica los permisos deacceso que necesita la función para funcionar correctamente.

18. Revise las opciones seleccionadas y, a continuación, elija Finish (Finalizar).

AWS Cloud9 crea la función y su API relacionada en la instancia. A continuación, implementa una copia dela función y de la API en Lambda y API Gateway. La aplicación sin servidor se muestra en las listas LocalFunctions (Funciones locales) y Remote Functions (Funciones remotas) del panel Lambda de la ventanaAWS Resources (Recursos de AWS). Los archivos de componentes de la aplicación sin servidor y de lafunción se muestran en la ventana entorno. El editor abre el archivo de código de la función, index.js.

Note

Además del archivo de código de la función, AWS Cloud9 crea los siguientes archivos de ayuda.

• .application.json: un archivo oculto que contiene una configuración con formato JSONespecífica de la aplicación sin servidor. AWS Cloud9 utiliza esta configuración de manerainterna. No edite este archivo.

• .gitignore: un archivo oculto que contiene una lista de los archivos que omite Git, si deseautilizar Git para administrar el código fuente para esta función.

• template.yaml: un archivo de plantilla de Modelo de aplicación sin servidor de AWS (AWSSAM) que contiene información acerca de la función de Lambda, la API relacionada en APIGateway y cualquier otro recurso de AWS compatible relacionado. Cada vez que se actualice laversión local de su función y luego se cargue en Lambda, AWS Cloud9 llama a AWS SAM parautilizar este archivo de plantilla para realizar la carga. Para obtener más información, consulte

355

https://docs.aws.amazon.com/apigateway/latest/developerguide/how-to-method-settings.html

AWS Cloud9 Guía del usuarioPaso 3: Añadir código a la función

Uso de Modelo de aplicación sin servidor de AWS (AWS SAM) en la AWS Lambda DeveloperGuide.

Los campos .application.json y .gitignore están ocultos. Para mostrar archivos ocultosu ocultarlos si se muestran, elija el icono del engranaje en la ventana Environment (Entorno). Acontinuación, elija Show Hidden Files (Mostrar archivos ocultos).

Paso siguientePaso 3: Añadir código a la función (p. 356)

Paso 3: Añadir código a la función(Paso anterior: Paso 2: Crear la función de Lambda y la API (p. 353))

En este paso va a sustituir el código de inicio de la función generada por código específico que devuelveinformación sobre el día o la hora que especifique.

Una vez que el archivo index.js esté ya abierto en el editor, sustituya completamente el contenido delarchivo por el siguiente código y, a continuación, guarde el archivo.

'use strict';

exports.handler = function(event, context, callback) {

if (event.body) { event = JSON.parse(event.body); }

var sc; // Status code var result = ""; // Response payload

switch(event.option) { case "date": switch(event.period) { case "yesterday": result = setDateResult("yesterday"); sc = 200; break; case "today": result = setDateResult(); sc = 200; break; case "tomorrow": result = setDateResult("tomorrow"); sc = 200;

356


AWS Cloud9 Guía del usuarioPaso 3: Añadir código a la función

break; default: result = { "error": "Must specify 'yesterday', 'today', or 'tomorrow'." }; sc = 400; break; } break; case "time": var d = new Date(); var h = d.getHours(); var mi = d.getMinutes(); var s = d.getSeconds();

result = { "hour": h, "minute": mi, "second": s }; sc = 200; break; default: result = { "error": "Must specify 'date' or 'time'." }; sc = 400; break; }

const response = { statusCode: sc, headers: { "Content-type": "application/json" }, body: JSON.stringify( result ) };

callback(null, response);

function setDateResult(option) {

var d = new Date(); // Today var mo; // Month var da; // Day var y; // Year

switch(option) { case "yesterday": d.setDate(d.getDate() - 1); break; case "tomorrow": d.setDate(d.getDate() + 1); default: break; }

mo = d.getMonth() + 1; // Months are zero offset (0-11) da = d.getDate(); y = d.getFullYear();

result = { "month": mo, "day": da, "year": y };

return result;

357

AWS Cloud9 Guía del usuarioPaso 4: Ejecutar o depurar la función localmente

}};

Esta función toma una carga de entrada con un valor option de date o time. Si se especifica date,también debe especificar un valor period de yesterday, today o tomorrow. A continuación, la funcióndevuelve el correspondiente valor month, day y year. Si, no obstante, se especifica un valor option detime, la función devuelve el valor actual de hour, minute y second.

Paso siguientePaso 4: Ejecutar o depurar la función localmente (p. 358)

Paso 4: Ejecutar o depurar la función localmente(Paso anterior: Paso 3: Añadir código a la función (p. 356))

Paso 4.1: Ejecutar la función localmenteEn este paso va a utilizar el IDE para ejecutar la función en la instancia. En la actualidad puede utilizar elIDE para ejecutar funciones que solo utilicen Node.js o Python.

1. En el panel Lambda de la ventana AWS Resources (Recursos de AWS), amplíe la carpeta deLambda MyDateTimeApplication y haga clic con el botón derecho del ratón en el icono de LambdamyDateTimeFunction.

2. Elija Run, Run Local (Ejecutar, Ejecutar localmente).

3. En el panel Payload (Carga) de la pestaña de ejecución, sustituya {} por lo siguiente, lo cual envíaestos datos como entrada a la función para su procesamiento.

{ "option": "date", "period": "today"}

4. Elija Run.

358


5. El panel Response (Respuesta) muestra lo siguiente.

{ "statusCode": 200, "headers": { "Content-type": "application/json" }, "body": "{\"month\":4,\"day\":12,\"year\":2018}"}

Note

Si en el panel Response (Respuesta) aparece null, asegúrese de guardar index.js y, acontinuación, elija Run (Ejecutar) de nuevo.


6. Ejecute varias veces la función con las siguientes cargas para ver qué se muestra en el panelResponse (Respuesta).

{ "option": "date", "period": "yesterday"}

{ "option": "date", "period": "tomorrow"}

{ "option": "time"}

Displays an error. Must also specify a 'period' of 'yesterday', 'today', or 'tomorrow'.{ "option": "date"}

Displays an error. Must specify an 'option' of 'date' or 'time'.

359


{ "option": "dates"}

Paso 4.2: Depurar la función localmenteEn este paso va a utilizar el IDE para depurar la función en la instancia. En la actualidad puede utilizar elIDE para depurar funciones que solo utilicen Node.js o Python. También puede utilizar el IDE para depurarfunciones localmente. No es posible utilizar el IDE para depurar funciones en la propia Lambda.

1. En el archivo index.js, cree un punto de interrupción para el depurador. Para ello, en el editor, juntoa la línea de código callback(null, response), haga clic en el margen interno que aparece justoa la izquierda de la línea 62. El punto de interrupción se representa con un círculo rojo.

2. En el lateral derecho del IDE, elija Debugger (Depurador).3. Añada cuatro expresiones que el depurador debe controlar. Para ello, en el área Watch Expressions

(Expresiones de inspección), en Type an expression here (Escriba aquí una expresión), escribaevent.option y, a continuación, pulse Enter. Repita este paso tres veces más, escribiendoevent.period, sc y response.body.

4. En la pestaña de ejecución que AWS Cloud9 abrió en Paso 4.1: Ejecutar la funciónlocalmente (p. 358), seleccione el icono que parece un insecto. (Cambia de gris a verde).

5. En el panel Payload (Carga) de la pestaña de ejecución, asegúrese de que se siga viendo la cargasiguiente.


6. Elija Run.

360

AWS Cloud9 Guía del usuarioPaso 5: Ejecutar o depurar la API localmente

La ejecución del código se pone en pausa en el punto de interrupción. Los valores actuales deevent.option, event.period, sc y response.body se muestran en el área Watch Expressions(Expresiones de inspección) de la ventana Debugger (Depurador).

Para poder ver estos valores en el código, mantenga el cursor del ratón sobre option en la línea 12del código, period en la línea 14, sc en la línea 21 y response en la línea 56. Para response en lalínea 56, amplíe Object {} (Objeto {}) y, a continuación, consulte el valor body (Cuerpo).


7. En la ventana Debugger, elija la fecha azul Resume (Reanudar) para terminar de ejecutar el código.(Tiene el aspecto de un botón de reproducción triangular).

Paso siguientePaso 5: Ejecutar o depurar la API localmente (p. 361)

Paso 5: Ejecutar o depurar la API localmente(Paso anterior: Paso 4: Ejecutar o depurar la función localmente (p. 358))

Paso 5.1: Ejecutar la API localmenteEn este paso va a utilizar el IDE para que API Gateway ejecute la función de Lambda en la instancia.

1. En el panel Lambda de la ventana AWS Resources (Recursos de AWS), haga clic con el botónderecho del ratón en el icono de Lambda myDateTimeFunction y, a continuación, elija Run, RunAPIGateway Local (Ejecutar, Ejecutar API Gateway localmente).

Note

También puede hacerlo eligiendo la lista Lambda (local) de la pestaña de ejecución del pasoanterior y, a continuación, seleccionando API Gateway (local).

2. En la pestaña de ejecución, en Path (Ruta), escriba / (barra inclinada).3. En Method (Método), elija POST.4. En Body (Cuerpo), sustituya {} por lo siguiente para enviar estos datos como entrada a la API para su

procesamiento.


5. Si el icono de error está verde, elíjalo para desactivarlo. (Vuelve al color gris).

361

AWS Cloud9 Guía del usuarioPaso 5: Ejecutar o depurar la API localmente

6. Elija Run.7. En el panel Response (Respuesta) se muestra la siguiente respuesta.

{ "month": 4, "day": 12, "year": 2018}

8. Ejecute varias veces la función con las siguientes cargas para ver qué se muestra en el panelResponse (Respuesta).

{ "option": "date", "period": "yesterday"}

{ "option": "date", "period": "tomorrow"}

{ "option":"time"}

Displays an error. Must also specify a 'period' of 'yesterday', 'today', or 'tomorrow'.{ "option":"date"}

Displays an error. Must specify an 'option' of 'date' or 'time'.{ "option":"dates"}


362

AWS Cloud9 Guía del usuarioPaso 6: Ejecutar la función en producción

Paso 5.2: Depurar la API localmenteEn este paso va a utilizar el IDE para que API Gateway depure la función Lambda en la instancia.

1. Asegúrese de que el archivo index.js sigue teniendo un punto de interrupción en la línea de códigocallback(null, response).

2. Asegúrese de que el área Watch Expressions (Expresiones de inspección) de la ventanaDebugger (Depurador) sigue realizando una inspección de event.option, event.period, sc yresponse.body.

3. En la pestaña de ejecución del paso anterior, elija el icono que tiene un aspecto de un bicho. (Cambiade gris a verde).

4. En el panel Body (Cuerpo) de la pestaña de ejecución, asegúrese de que se siga apareciendo losiguiente.


5. Elija Run.

La ejecución del código se pone en pausa en el punto de interrupción y los valores actuales deevent.option, event.period, sc y response.body se muestran en el área Watch Expressions(Expresiones de inspección) de la ventana Debugger (Depurador).

Para poder ver estos valores en el código, mantenga el cursor del ratón sobre option, period, sc yresponse en el código. En response, amplíe Object {} (Objeto {}) y, a continuación, consulte el valorbody (Cuerpo).

6. En la ventana Debugger, elija la fecha azul Resume (Reanudar) para terminar de ejecutar el código.

Paso siguientePaso 6: Ejecutar la función en producción (p. 363)

Paso 6: Ejecutar la función en producción(Paso anterior: Paso 5: Ejecutar o depurar la API localmente (p. 361))

En este paso va a utilizar el IDE para ejecutar la función en Lambda en sí.

AWS Cloud9 implementó la función en Lambda en Paso 2: Crear la función de Lambda y la API (p. 353).Sin embargo, AWS Cloud9 implementó la función antes de realizar los cambios que se describen en Paso3: Añadir código a la función (p. 356). Esta función original era muy básica, no tomaba cargas ni devolvíaninguna respuesta. Por tanto, primero se deben implementar los cambios en Lambda y, a continuación, sepuede ejecutar ahí la función implementada.

1. En el panel Lambda de la ventana AWS Resources (Recursos de AWS), amplíe Local Functions(Funciones locales), amplíe la carpeta de Lambda MyDateTimeApplication, haga clic con el botónderecho del ratón en el icono de Lambda myDateTimeFunction y, a continuación, elija Deploy(Implementar).

2. Cuando termine la implementación, haga clic con el botón derecho del ratón en el icono de LambdamyDateTimeFunction y, a continuación, elija Run, Run Remote (Ejecutar, Ejecutar remotamente).

363

AWS Cloud9 Guía del usuarioPaso 7: Ejecutar la API en producción

Note

También puede hacerlo eligiendo la lista API Gateway (local) de la pestaña de ejecución delpaso anterior y, a continuación, seleccionando Lambda (remote) (Lambda [remota]).

3. En el panel Payload (Carga) de la pestaña de ejecución, asegúrese de que se vea una de las cargasPaso 4.1: Ejecutar la función localmente (p. 358). Si no aparece, añádala.

4. Elija Run (Ejecutar) y consulte los resultados en el área Response (Respuesta). Estos resultadosdeben ser los mismos que los que se describen en Paso 4.1: Ejecutar la función localmente (p. 358).

Paso siguientePaso 7: Ejecutar la API en producción (p. 364)

Paso 7: Ejecutar la API en producción(Paso anterior: Paso 6: Ejecutar la función en producción (p. 363))

En este paso va a utilizar el IDE para ejecutar la API en API Gateway en sí.

Note

AWS Cloud9 implementó la API en API Gateway en Paso 2: Crear la función de Lambda yla API (p. 353). Dado que no ha efectuado cambios en la API desde que AWS Cloud9 laimplementó por primera vez, no es necesario implementar la API de nuevo para poder ejecutarlaen API Gateway.

1. En el panel Lambda de la ventana AWS Resources (Recursos de AWS), haga clic con el botónderecho del ratón en el icono de Lambda myDateTimeFunction y, a continuación, elija Run, RunAPIGateway Remote (Ejecutar, Ejecutar API Gateway remotamente).

Note

También puede hacerlo eligiendo la lista Lambda (remote) (Lambda [remota]) de la pestañade ejecución del paso anterior y, a continuación, seleccionando API Gateway (remote) (APIGateway [remota]).

2. Asegúrese de que Path (Ruta) siga establecido en /, Method (Método) siga establecido en POSTy Body (Cuerpo) siga establecido en uno de los cuerpos descritos en Paso 5.1: Ejecutar la APIlocalmente (p. 361). Si alguno de estos valores no está establecido correctamente, corríjalo.

3. Elija Run (Ejecutar) y consulte los resultados en el área Response (Respuesta). Estos resultadosdeberían ser los mismos que los descritos en Paso 5.1: Ejecutar la API localmente (p. 361).

Paso siguientePaso 8: Cambiar la función e implementar el cambio (p. 364)

Paso 8: Cambiar la función e implementar el cambio(Paso anterior: Paso 7: Ejecutar la API en producción (p. 364))

Paso 8.1: Cambiar la función localmenteEn este paso va a utilizar el IDE para realizar un pequeño cambio en la función Lambda. A continuación,debe probar la función modificada localmente y la función original en producción para ver las diferencias.

364


1. En el archivo index.js, en la línea 41, añada un valor time a la variable result, tal y como seindica a continuación.

result = { "time": d.toTimeString(), "hour": h, "minute": mi, "second": s};

2. En la línea 86, añada un valor date a la variable result, tal y como se indica a continuación.

result = { "date": d.toDateString(), "month": mo, "day": da, "year": y};

3. Guarde los cambios en el archivo index.js.4. Ejecute la función modificada localmente siguiendo las instrucciones que se indican en Paso 4.1:

Ejecutar la función localmente (p. 358). Observe que el valor time o date ahora se muestra en larespuesta.

5. Ejecute la función original en producción siguiendo las instrucciones que se indican en Paso 6:Ejecutar la función en producción (p. 363). Observe que el valor time o date no se muestra aún enla respuesta. Esto se debe a que no ha implementado la función modificada en producción. Lo hará enel siguiente paso.

Paso 8.2: Implementar la función modificada en producciónEn este paso va a implementar la función modificada de nuevo en Lambda en sí. A continuación probará lafunción modificada en producción para confirmar la implementación.

1. En el panel Lambda de la ventana AWS Resources (Recursos de AWS), haga clic con el botónderecho del ratón en el icono de Lambda myDateTimeFunction y, a continuación, elija Deploy(Implementar).

2. Cuando se realice correctamente la implementación, ejecute la función modificada en producciónsiguiendo las instrucciones que se indican en Paso 6: Ejecutar la función en producción (p. 363).Observe que el valor time o date ahora aparece en la respuesta.

Recuerde que cada vez que se realiza un cambio en la función local y se desea implementar esos cambiosen Lambda (y en API Gateway, si hubiese una API asociada), debe asegurarse de seguir este paso.


Paso 9: Eliminación(Paso anterior: Paso 8: Cambiar la función e implementar el cambio (p. 364))

Para evitar que se apliquen cargos continuos en su cuenta de AWS relacionados con este tutorial, cuandotermine puede eliminar la función de Lambda, la API de API Gateway y el entorno de AWS Cloud9.

365


Paso 9.1: Eliminar la función y la API de Lambda y API GatewayPara que AWS Cloud9 cree la función y su API asociada en segundo plano, AWS Cloud9 utiliza Modelode aplicación sin servidor de AWS (AWS SAM) para crear una pila en AWS CloudFormation. Esta pilaa continuación crea la función y la API asociada. En este procedimiento se utiliza el IDE para que AWSCloudFormation elimine la pila, lo que también elimina la función y la API. (Puede utilizar las consolas deLambda y API Gateway, en lugar de AWS CloudFormation, para eliminar la función y su API asociada. Sinembargo, este enfoque tarda más y no elimina la pila en AWS CloudFormation cuando ya no se necesita).

Warning

La eliminación de la pila no se puede deshacer. Al eliminar esta pila, la función asociada y su APIse eliminan de Lambda y API Gateway, y no se pueden recuperar.

1. Desde el IDE, use la AWS Command Line Interface (AWS CLI) en el terminal para ejecutar elcomando delete-stack de AWS CloudFormation, especificando el nombre y el ID de la región deAWS para la pila. Para mostrar el terminal, en la barra de menús, seleccione Window, New Terminal(Ventana, Nuevo terminal). El nombre de esta pila sigue el formato cloud9-APPLICATION_NAME,por lo que especificaría cloud9-MyDateTimeApplication para este tutorial. Para obtener el ID dela región de AWS (representado en el siguiente comando como us-east-2), consulte la esquina delpanel Lambda en la ventana AWS Resources (Recursos de AWS).

aws cloudformation delete-stack --stack-name cloud9-MyDateTimeApplication --region us-east-2

Si el comando se ha ejecutado correctamente, no se genera ningún resultado y no se muestra ningúnmensaje de error.

Note

Si utiliza un usuario de IAM para ejecutar este comando para este tutorial, en lugar de unusuario raíz de la cuenta de AWS o un administrador de IAM, el usuario de IAM debe tenerlos siguientes permisos de acceso de AWS adicionales.

• cloudformation:ListStacks

• cloudformation:DeleteStack

Si no puede agregar estos permisos al usuario de IAM, consulte con el administrador de lacuenta de AWS de su organización.

2. Para comprobar que la pila se haya eliminado, utilice la AWS CLI para ejecutar el comando AWSCloudFormation de describe-stacks. Si se elimina la función, aparece un mensaje indicando quela pila no existe. (Es posible que tenga que ejecutar este comando varias veces hasta que aparezcaeste mensaje).

aws cloudformation describe-stacks --query 'Stacks[0].StackStatus' --output text --stack-name cloud9-MyDateTimeApplication --region us-east-2

3. Si ya no desea mantener más la función local en el IDE, elimine la carpeta ~/entorno/MyDateTimeApplication (por ejemplo, ejecutando el comando rm -rf ~/entorno/MyDateTimeApplication).

Note

En el IDE, ~/entorno es igual que especificar el directorio raíz en la ventana entorno.

366


Paso 9.2: Eliminar el entorno de AWS Cloud9Warning

La eliminación de un entorno no se puede deshacer. Además, cuando elimina un entorno deEC2, AWS Cloud9 también termina la instancia Amazon EC2 que lanzó previamente y conectó alentorno. Una vez terminada en Amazon EC2, la instancia no se puede activar ni recuperar.

1. Desde el IDE, abra el panel de la consola de AWS Cloud9. Para ello, en la barra de menús, elija AWSCloud9, Go To Your Dashboard (Ir a su panel).

2. Aplique alguna de las siguientes acciones:

• Elija el título que contiene la tarjeta my-demo-lambda-entorno y, a continuación, seleccione Delete(Eliminar).

• Elija la tarjeta my-demo-lambda-entorno y, a continuación, seleccione Delete (Eliminar).3. En el cuadro de diálogo Delete (Eliminar), escriba Delete y, a continuación, elija Delete (Eliminar).


Información relacionadaA continuación se ofrece información adicional para el tutorial de AWS Lambda (p. 350).



Más información sobre el uso de AWS Cloud9 conLambda

Tutorial avanzado de AWS Lambda para AWSCloud9 (p. 368) y Trabajo con funcionesAWS Lambda en el AWS Cloud9 IntegratedDevelopment Environment (IDE) (p. 308)

Más información sobre el AWS Cloud9 IDE Introducción: tutoriales básicos (p. 41) y Uso delIDE (p. 107)

Invite a que otras personas usen el entorno conusted, en tiempo real y con soporte de chat detexto




Utilizar AWS Cloud9 con Amazon Lightsail Trabajo con instancias de Amazon Lightsail en elAWS Cloud9 Integrated Development Environment(IDE) (p. 299)

Utilizar AWS Cloud9 con AWS CodeStar Trabajo con proyectos de AWS CodeStar en elAWS Cloud9 Integrated Development Environment(IDE) (p. 306)

367

AWS Cloud9 Guía del usuarioTutorial avanzado de AWS Lambda


Utilizar AWS Cloud9 con AWS CodePipeline Trabajar con AWS CodePipeline en el AWSCloud9 Integrated Development Environment(IDE) (p. 347)

Utilizar AWS Cloud9 con la AWS CLI, el aws-shell, AWS CodeCommit, el Kit de desarrollo dela nube de AWS (AWS CDK), GitHub o AmazonDynamoDB, así como Node.js, Python u otroslenguajes de programación.






Tutorial avanzado de AWS Lambda para AWSCloud9

En este tutorial, utilizaremos el AWS Cloud9 IDE para crear una función en AWS Lambda y una APIasociada en Amazon API Gateway. Después de crear la función y su API, se ejecutan y depuranlocalmente. A continuación ejecutará la función y la API en Lambda y API Gateway en producción. Lafunción y su API llaman a Amazon Simple Notification Service (Amazon SNS) para enviar mensajes a ladirección de correo electrónico que especifique.

Note

El uso de este tutorial puede producir cargos en su cuenta de AWS. Entre estos se incluyenposibles cargos por Amazon EC2, Lambda, API Gateway y Amazon SNS. Para obtener másinformación, consulte Precios de Amazon EC2, Precios de AWS Lambda y Precios de AmazonAPI Gateway y Precios de Amazon SNS.

• Requisitos previos (p. 369)• Paso 1: Crear la función Lambda y la API (p. 369)• Paso 2: Configurar Amazon SNS (p. 370)• Paso 3: Ejecutar la función localmente (p. 372)• Paso 4: Depurar la función localmente (p. 373)• Paso 5: Ejecutar la API localmente (p. 374)• Paso 6: Depurar la API localmente (p. 375)• Paso 7: Implementar y ejecutar la función modificada en producción (p. 375)• Paso 8: Eliminación (p. 376)• Pasos siguientes (p. 378)

368








https://aws.amazon.com/sns/pricing/


Requisitos previosAntes de comenzar este tutorial, le recomendamos que complete primero el Tutorial de AWS Lambda paraAWS Cloud9 (p. 350). Este tutorial se basa en los conceptos y requisitos previos ahí presentados.

Note

Si no desea completar todo el tutorial primero, al menos siga los pasos que se describenseguidamente, o también puede crear los recursos de AWS equivalentes.

• Requisitos previos (p. 351): incluye decidir qué usuario en una organización o cuenta de AWSutilizará para completar este tutorial.

• Paso 1: Crear y abrir el entorno (p. 351): esto incluye crear un entorno de desarrollo de EC2de AWS Cloud9 y abrir el AWS Cloud9 IDE para ese entorno.

Paso 1: Crear la función de Lambda y la APIEn este paso, utilice el AWS Cloud9 IDE para crear la función de Lambda y su API correspondiente almismo tiempo. AWS Cloud9 almacena la nueva función en la instancia Amazon EC2 e implementa unacopia de la función en Lambda. AWS Cloud9 también almacena la nueva API asociada a la instancia eimplementa una copia de la API en API Gateway.

La función utiliza Amazon Simple Notification Service (Amazon SNS) para enviar mensajes a su direcciónde correo electrónico. En un paso posterior, creará los recursos de Amazon SNS que esta funciónnecesita.

En la actualidad puede utilizar el IDE para crear funciones que solo utilicen Node.js o Python. Esta funciónutiliza Node.js.

1. Con el IDE para el entorno, en la barra de menús, elija AWS Cloud9, Preferences (AWS Cloud9,Preferencias).

2. En el panel de navegación de la pestaña Preferences (Preferencias), elija AWS Settings (Configuraciónde AWS).

3. En AWS Region (Región de AWS), seleccione la región de AWS en la que desea crear la función.

4. En el lateral del IDE, elija AWS Resources (Recursos de AWS).5. Amplíe el panel Lambda si aún no lo está. En la barra de herramientas, elija Create a new Lambda

function (Crear una nueva función Lambda).

369

AWS Cloud9 Guía del usuarioPaso 2: Configurar Amazon SNS

6. En el cuadro de diálogo Create serverless application (Crear una aplicación sin servidor), en Functionname (Nombre de la función), escriba un nombre para la función (por ejemplo, mySNSFunction).

7. En Application name (Nombre de la aplicación), escriba un nombre para la función que contenga laaplicación sin servidor (por ejemplo, MySNSApplication).

8. Seleccione Next (Siguiente).9. En Select runtime (Seleccionar tiempo de ejecución), elija Node.js 6.10.10.En Select blueprint (Seleccionar plan), elija sns-send-mensaje. (Es posible que tenga que desplazarse

por la lista de proyectos para verlo).11.Seleccione Next (Siguiente).12.En Function trigger (Disparador de la función), elija API Gateway.13.En Resource Path (Ruta del recurso), use /.14.En Security (Seguridad), elija NONE (Ninguna) y, a continuación, seleccione Next (Siguiente).15.En Memory (MB) (Memoria [MB]), deje el valor predeterminado, 128 MB, suficiente para este tutorial.16.En Role (Rol), deje el valor predeterminado, Automatically generate role (General rol automáticamente)

y, a continuación, seleccione Next (Siguiente). (Cambiará este rol en el siguiente paso).17.Revise las opciones seleccionadas y, a continuación, elija Finish (Finalizar).

AWS Cloud9 crea la función y su API relacionada en la instancia y, después, implementa una copia de lafunción y de la API en Lambda y API Gateway. La aplicación sin servidor se muestra en las listas LocalFunctions (Funciones locales) y Remote Functions (Funciones remotas) del panel Lambda, en la ventanaAWS Resources (Recursos de AWS). Los archivos de componentes de la función y de la aplicación sinservidor (por ejemplo, una plantilla de AWS CloudFormation que se use más adelante para crear recursosde Amazon SNS) se muestran en la ventana Environment (Entorno). El editor abre el archivo de código dela función, index.js.

Si ejecuta esta función o la API ahora, no funcionará. Esto se debe a que los recursos Amazon SNS queesta función necesita no están configurados todavía. Además, la función no tiene permiso para llamar aAmazon SNS. En el siguiente paso, configura estos recursos y proporciona este permiso.

Paso 2: Configurar Amazon SNSEn este tutorial, la función Lambda utiliza Amazon SNS para enviar mensajes a la dirección de correoelectrónico. En este paso, ejecuta una pila de AWS CloudFormation que crea un tema en Amazon SNS

370

AWS Cloud9 Guía del usuarioPaso 2: Configurar Amazon SNS

rápidamente y, a continuación, suscribe la dirección de correo electrónico al tema. La pila también crea unrol de ejecución en IAM para conceder a la función Lambda el permiso para usar Amazon SNS. (Puedehacer manualmente toda esta configuración en Amazon SNS e IAM, pero AWS CloudFormation la llevaa cabo más fácil y rápidamente). Una vez que AWS CloudFormation crea la pila, debe adjuntar el rol deejecución a la función y, a continuación, asignar permiso a Amazon SNS para comenzar a enviar mensajesa la dirección de correo electrónico indicada.

1. En el terminal, cambie al directorio que contiene el archivo de plantillas de AWS CloudFormationllamada sns-create-topic-subscription.yaml.

cd ~/environment/MySNSApplication

Note

En el IDE, ~/environment es igual que especificar el directorio raíz en la ventanaEnvironment (Entorno).

2. Utilice la AWS CLI para ejecutar el siguiente comando, que crea y ejecuta una pila de AWSCloudFormation basada en este archivo de plantilla.

aws cloudformation create-stack --template-body file://sns-create-topic-subscription.yaml --capabilities CAPABILITY_NAMED_IAM --parameters ParameterKey=SNSTopicName,ParameterValue=MySNSTopic ParameterKey=EmailAddress,[email protected] --stack-name MySNSStack --region us-east-2

En el comando anterior, haga lo siguiente.• Reemplace MySNSTopic por el nombre que desee para el tema de Amazon SNS al que enviar

mensajes.• Sustituya [email protected] por la dirección de correo electrónico a la que Amazon SNS envía

mensajes.• Remplace MySNSStack por el nombre que desea para la pila.• Reemplace us-east-2 por el ID de la región de AWS en la que creó la función (consulte la esquina

del panel Lambda en la ventana AWS Resources (Recursos de AWS)).

Note

Si utiliza un usuario de IAM para llamar a AWS CloudFormation para este tutorial, en lugar deun usuario raíz de la cuenta de AWS o un administrador de IAM, el usuario de IAM debe tenerlos siguientes permisos de acceso de AWS adicionales.• cloudformation:CreateUploadBucket

• cloudformation:GetTemplateSummary

• cloudformation:ListStacks

• iam:CreateRole

• iam:PutRolePolicy

• sns:CreateTopic

• sns:GetTopicAttributes

• sns:Publish

• sns:SetTopicAttributes

• sns:SubscribeSi no puede agregar estos permisos al usuario de IAM, consulte con el administrador de lacuenta de AWS de su organización.

3. Confirme que AWS CloudFormation ha creado correctamente la pila. Para ello, use la AWS CLI paraejecutar la línea de comandos siguiente. 371

AWS Cloud9 Guía del usuarioPaso 3: Ejecutar la función localmente

aws cloudformation describe-stacks --query 'Stacks[0].StackStatus' --output text --stack-name MySNSStack --region us-east-2

No continúe hasta que la AWS CLI muestre CREATE_COMPLETE. (Es posible que tenga que ejecutareste comando varias veces hasta ver CREATE_COMPLETE).

4. En unos minutos, después de que AWS CloudFormation cree correctamente la pila, compruebe si en labandeja de entrada hay un correo electrónico entrante de [email protected]. En este correoelectrónico, elija el enlace Confirm subscription (Confirmar suscripción). Se abrirá una página webdonde confirmar la suscripción. Su correo electrónico no recibirá mensajes de este tema de AmazonSNS hasta que no se confirme la suscripción.

5. Cambie la configuración de la función para usar el nuevo rol de ejecución creado. Para ello, en laventana Environment (Entorno), abra el archivo template.yaml de la carpeta ~/environment/MySNSApplication. En el editor, entre las líneas de código Properties y Handler:mySNSFunction/index.handler, agregue las dos líneas siguientes para especificar el nombre derecurso de Amazon (ARN) del rol de ejecución que la función va a utilizar.

Properties: Role: 'Fn::Sub': 'arn:aws:iam::${AWS::AccountId}:role/LambdaSNSExecutionRole' Handler: mySNSFunction/index.handler

Note

Dado que el archivo template.yaml utiliza sintaxis YAML, el espaciado es importante.Asegúrese de que Role está exactamente posicionado a dos espacios de Properties y que'Fn::Sub' está exactamente posicionado a dos espacios de Role. Asegúrese de utilizarespacios, y no tabuladores, para representar espacios en blanco en este archivo.

6. En el mismo archivo template.yaml, amplíe el periodo de tiempo de espera predeterminado de lafunción cambiando el valor Timeout de 15 a 60. A continuación, guarde el archivo.

Paso 3: Ejecutar la función localmenteEn este paso, utilice la IDE para ejecutar la nueva función en la instancia, que envía mensajes a ladirección de correo electrónico. En la actualidad puede utilizar el IDE para ejecutar funciones que soloutilicen Node.js o Python.

1. Con el IDE aún mostrado para el entorno, en el panel Lambda de la ventana AWS Resources (Recursosde AWS), expanda Local Functions (Funciones locales), expanda la carpeta MySNSApplication deLambda, haga clic con el botón derecho en el icono mySNSFunction de Lambda y elija Run, Run Local(Ejecutar, Ejecutar local).

2. En el panel Payload (Carga) de la pestaña de ejecución, sustituya el contenido del panel por losiguiente, lo cual envía los datos especificados a la función para su procesamiento.

{ "region": "us-east-2", "message": "You just sent an email by using Amazon SNS.", "subject": "Hello from Amazon SNS", "topicARN": "arn:aws:sns:us-east-2:123456789012:MySNSTopic"}

En payload (carga) anterior, haga lo siguiente.• Reemplace us-east-2 por el ID de la región de AWS donde existe el tema de Amazon SNS.• Sustituya 123456789012 por el ID de la cuenta de AWS.

372

http://yaml.org/

AWS Cloud9 Guía del usuarioPaso 4: Depurar la función localmente

• Reemplace MySNSTopic por el nombre del tema de Amazon SNS.3. Elija Run.4. Si la respuesta muestra un statusCode de 200, compruebe pasados unos minutos si ha recibido el

mensaje de correo que se envió


Paso 4: Depurar la función localmenteEn este paso va a utilizar el IDE para depurar la función en la instancia. En la actualidad puede utilizar elIDE para depurar funciones que solo utilicen Node.js o Python. También puede utilizar el IDE para depurarfunciones localmente. No es posible utilizar el IDE para depurar funciones en la propia Lambda.

1. Con el IDE aún abierto para el entorno, abra el archivo index.js.2. Cree un punto de interrupción para el depurador. Para ello, en el editor, haga clic en el margen interno

junto a la línea de código que comienza con sns.publish en la línea 45. El punto de interrupción serepresenta con un círculo rojo.

3. En el lateral del IDE, elija Debugger (Depurador).4. Añada cuatro expresiones que el depurador debe controlar. Para ello, en el área Watch Expressions

(Expresiones de inspección), en Type an expression here (Escriba aquí una expresión), escribaevent['subject'] y, a continuación, pulse Enter. Repita este paso dos veces más, escribiendocontext['memoryLimitInMB'] y sns.endpoint.hostname.

Note

Si realizó el tutorial anterior de Lambda, puede eliminar cualquiera de esas expresiones deinspección que sigan apareciendo. Para ello, simplemente haga clic con el botón derecho enuna expresión y, a continuación, seleccione Remove Watch Expression (Quitar expresión deinspección).

5. En la pestaña de ejecución del paso anterior, elija el icono que tiene un aspecto de un bicho. (Cambiaráde gris a verde).

6. Elija Run.

En el punto de ruptura se detiene la ejecución del código y muestra los valores actuales de la línea deasunto del mensaje, la cantidad máxima de memoria de la función en megabytes y el nombre de hostdel servicio Amazon SNS.

Para poder ver estos valores en el código, mantenga el cursor sobre event, context y sns en elcódigo, y expanda la sugerencia en pantalla que aparece.

373

AWS Cloud9 Guía del usuarioPaso 5: Ejecutar la API localmente

7. En la ventana Debugger, elija el botón azul Resume (Reanudar) para terminar de ejecutar el código.8. En la pestaña de ejecución, si la respuesta muestra un statusCode de 200, compruebe pasados unos

minutos si ha recibido el mensaje de correo que se envió.

Paso 5: Ejecutar la API localmenteEn este paso va a utilizar el IDE para que API Gateway ejecute la función de Lambda en la instancia.

1. En el panel Lambda de la ventana AWS Resources (Recursos de AWS), haga clic con el botón derechodel ratón en el icono de Lambda mySNSFunction y, a continuación, elija Run, Run APIGateway Local(Ejecutar, Ejecutar API Gateway localmente).

Note

También puede hacerlo eligiendo la lista Lambda (local) de la pestaña de ejecución del pasoanterior y, a continuación, seleccionando API Gateway (local).

2. En la pestaña de ejecución, en Path (Ruta), escriba /.3. En Method (Método), elija POST.4. En Body (Cuerpo), sustituya el contenido del panel por lo siguiente, que envía estos datos como entrada

a la API para su procesamiento.

{ "region": "us-east-2", "message": "You just sent an email by using Amazon SNS.", "subject": "Hello from Amazon SNS", "topicARN": "arn:aws:sns:us-east-2:123456789012:MyDemoSNSTopic"}

5. Si el icono de error está verde, elíjalo para desactivarlo. (Vuelve al color gris).6. Elija Run.7. Si la respuesta muestra success, compruebe pasados unos minutos si ha recibido el mensaje de

correo enviado.

Note

Si la respuesta es Missing required key 'Message' in params en lugar de y success,a continuación, añada el siguiente código a su index.js archivo, guarde el archivo y, acontinuación, intente repetir este paso de nuevo.

var sns = new AWS.SNS({apiVersion: '2010-03-31'});

// Begin adding code here.if (event.body) { event = JSON.parse(event.body);}// End adding code here.

var params ={ Message: event['message'], Subject: event['subject'], TopicArn: event['topicARN']};

Para obtener más información, consulte Diferencias de respuesta al llamar a una función Lambdadesde API Gateway (p. 329).

374

AWS Cloud9 Guía del usuarioPaso 6: Depurar la API localmente

Paso 6: Depurar la API localmenteEn este paso va a utilizar el IDE para que API Gateway depure la función Lambda en la instancia.

1. Asegúrese de que el archivo index.js sigue teniendo un punto de interrupción en la línea de códigosns.publish.

2. Asegúrese de que el área Watch Expressions (Expresiones de inspección) de la ventanaDebugger (Depurador) sigue realizando una inspección de event['subject'],context['memoryLimitInMB'] y sns.endpoint.hostname.

3. En la pestaña de ejecución del paso anterior, elija el icono que tiene un aspecto de un bicho. (Cambiade gris a verde).

4. Elija Run.

En el punto de ruptura se detiene la ejecución del código y muestra los valores actuales de la línea deasunto del mensaje, la cantidad máxima de memoria de la función en megabytes, el nombre de host delservicio Amazon SNS y el ID de la clave de acceso de AWS del llamador.

Para poder ver estos valores en el código, mantenga el cursor sobre event, context y sns, y expandala sugerencia en pantalla que aparece.

5. En la ventana Debugger, elija el botón azul Resume (Reanudar) para terminar de ejecutar el código.6. Si la respuesta muestra success, compruebe pasados unos minutos si ha recibido el mensaje de

correo enviado.

Paso 7: Implementar y ejecutar la función modificadaen producciónEn este paso implementará la función que ha cambiado en el Paso 5: Ejecutar la API localmente (p. 374)y en Lambda and API Gateway. A continuación probará los cambios en producción para confirmar laimplementación.

1. En el panel Lambda de la ventana AWS Resources (Recursos de AWS), haga clic con el botón derechodel ratón en el icono de Lambda mySNSFunction y, a continuación, elija Deploy (Implementar).

2. Una vez que la implementación se ha realizado correctamente, ejecute la función modificada enun entorno de producción. Para ello, en el panel Lambda de la ventana AWS Resources (Recursosde AWS), haga clic con el botón derecho del ratón en el icono de Lambda mySNSFunction y, acontinuación, elija Run, Run Remote (Ejecutar, Ejecutar remotamente).

Note

También puede hacerlo eligiendo la lista API Gateway (local) de la pestaña de ejecución delpaso anterior y, a continuación, seleccionando Lambda (remote) (Lambda [remota]).

3. Asegúrese de que el panel Payload (Carga) de la pestaña de ejecución aún contiene los datossiguientes.


4. Elija Run.5. Si la respuesta muestra un statusCode de 200, compruebe pasados unos minutos si ha recibido el

mensaje de correo que se envió

375


6. Ejecute la API en producción. Para ello, en el panel Lambda de la ventana AWS Resources (Recursosde AWS), haga clic con el botón derecho del ratón en el icono de Lambda mySNSFunction y, acontinuación, elija Run, Run APIGateway Remote (Ejecutar, Ejecutar APIGateway remotamente).

Note

También puede hacerlo eligiendo la lista Lambda (remote) (Lambda [remota]) de la pestañade ejecución y, a continuación, seleccionando API Gateway (remote) (API Gateway[remotamente]).

7. En la pestaña de ejecución, en Path (Ruta), escriba /.8. En Method (Método), elija POST.9. En Body (Cuerpo), asegúrese de los siguientes datos siguen apareciendo.


10.Elija Run.11.Si la respuesta muestra success, compruebe pasados unos minutos si ha recibido el mensaje de

correo enviado.

Paso 8: EliminaciónPara evitar que se realicen cargos continuos en la cuenta de AWS relacionada con este tutorial, puedeeliminar la función de Lambda, la API de API Gateway, el tema y la suscripción de Amazon SNS, el rol deejecución de Lambda de IAM y el entorno de AWS Cloud9.

Paso 8.1: Eliminar la función y la API de Lambda y API GatewayPara que AWS Cloud9 cree la función y su API asociada, en segundo plano AWS Cloud9 utiliza el modelode aplicaciones sin servidor de AWS (AWS SAM) para crear una pila en AWS CloudFormation. Esta pilaa continuación crea la función y la API asociada. En este procedimiento se utiliza el IDE para que AWSCloudFormation elimine la pila, lo que también elimina la función y la API. (Puede utilizar las consolas deLambda y API Gateway, en lugar de AWS CloudFormation, para eliminar la función y su API asociada. Sinembargo, este enfoque tarda más y no elimina la pila en AWS CloudFormation cuando ya no se necesita).

Warning

La eliminación de la pila no se puede deshacer. Al eliminar esta pila, la función asociada y su APIse eliminan de Lambda y API Gateway, y no se pueden recuperar.

1. Desde el IDE, utilice la AWS CLI en el terminal para ejecutar el comando delete-stack de AWSCloudFormation, especificando el nombre de la pila. El nombre de esta pila sigue el formato cloud9-APPLICATION_NAME, por lo que especificaría cloud9-MySNSApplication para este tutorial.

aws cloudformation delete-stack --stack-name cloud9-MySNSApplication --region us-east-2


376


Note

Si utiliza un usuario de IAM para ejecutar este comando para este tutorial, en lugar de unusuario raíz de la cuenta de AWS o un administrador de IAM, el usuario de IAM debe tener lossiguientes permisos de acceso de AWS adicionales:• cloudformation:ListStacks

• cloudformation:DeleteStackSi no puede agregar estos permisos al usuario de IAM, consulte con el administrador de lacuenta de AWS de su organización.

2. Para comprobar que la pila se haya eliminado, utilice la AWS CLI para ejecutar el comando AWSCloudFormation de describe-stacks. Si se elimina la función, aparece un mensaje indicando que lapila no existe.

aws cloudformation describe-stacks --query 'Stacks[0].StackStatus' --output text --stack-name cloud9-MySNSApplication --region us-east-2

3. Si ya no desea mantener más la función local en el IDE, elimine la carpeta ~/environment/MySNSApplication (por ejemplo, ejecutando el comando rm -rf ~/environment/MySNSApplication).

Paso 8.2: Eliminar el tema y la suscripción de Amazon SNS y elde rol de ejecución de Lambda de IAMAl eliminar la pila de AWS CloudFormation creada en el Paso 2: Configurar Amazon SNS (p. 370), eltema y la suscripción de Amazon SNS se eliminan, así como el rol de ejecución para la función Lambda.

Warning

La eliminación de la pila no se puede deshacer. Al eliminar esta pila, el tema, la suscripción y elrol de ejecución asociados se eliminan de IAM y Amazon SNS, y no se pueden recuperar.

1. Con el IDE, aún mostrado para el entorno, utilice la AWS CLI en el terminal para ejecutar el comandodelete-stack de AWS CloudFormation, especificando el nombre de la pila.

aws cloudformation delete-stack --stack-name MySNSStack --region us-east-2

Note

Si utiliza un usuario de IAM para ejecutar este comando, en lugar de un usuario raíz de lacuenta de AWS o un administrador de IAM, el usuario de IAM debe tener los siguientespermisos de acceso de AWS adicionales.• cloudFormation:DeleteStack

• iam:DeleteRole

• iam:DeleteRolePolicy

• sns:DeleteTopic

• sns:UnsubscribeSi no puede agregar estos permisos al usuario de IAM, consulte con el administrador de lacuenta de AWS de su organización.


2. Para comprobar que la pila se haya eliminado, utilice la AWS CLI para ejecutar el comando siguiente.377


aws cloudformation describe-stacks --query 'Stacks[0].StackStatus' --output text --stack-name MySNSStack --region us-east-2

Mantenga la ejecución del comando anterior hasta que el resultado indique que la pila ya no existe.

Paso 8.3: Eliminar el entorno de AWS Cloud9Warning

La eliminación de un entorno no se puede deshacer. Además, cuando elimina un entorno deEC2, AWS Cloud9 también termina la instancia Amazon EC2 que lanzó previamente y conectó alentorno. Una vez terminada en Amazon EC2, la instancia no se puede activar ni recuperar.

1. Con el IDE aún mostrada para el entorno, abra el panel de la consola de AWS Cloud9. Para ello, en labarra de menús del IDE, elija AWS Cloud9, Go To Your Dashboard (Ir a su panel).

2. Aplique alguna de las siguientes acciones.• Elija el título que coincida con el nombre del entorno y, a continuación, seleccione Delete (Eliminar).• Seleccione la tarjeta que coincida con el nombre del entorno y, a continuación, seleccione Delete

(Eliminar).3. En el cuadro de diálogo Delete (Eliminar), escriba Delete y, a continuación, elija Delete (Eliminar).

Pasos siguientesExamine todos o algunos de los siguientes temas para continuar familiarizándose con AWS Cloud9.

Más información sobre el uso de AWS Cloud9 conLambda

Trabajo con funciones AWS Lambda (p. 308)

Más información sobre el AWS Cloud9 IDE Introducción: tutoriales básicos (p. 41) y Uso delIDE (p. 107)

Invite a que otras personas usen el entorno conusted, en tiempo real y con soporte de chat detexto



Creación de un entorno (p. 61) y Requisitos dehost del entorno SSH (p. 514)

Utilizar AWS Cloud9 con Amazon Lightsail Trabajo con instancias de AmazonLightsail (p. 299)

Utilizar AWS Cloud9 con AWS CodeStar Trabajar con proyectos de AWS CodeStar (p. 306)

Utilizar AWS Cloud9 con AWS CodePipeline Trabajar con AWS CodePipeline (p. 347)

Utilizar AWS Cloud9 con la AWS CLI, el aws-shell, AWS CodeCommit, el Kit de desarrollo dela nube de AWS (AWS CDK), GitHub o AmazonDynamoDB, así como Node.js, Python u otroslenguajes de programación.


378

AWS Cloud9 Guía del usuarioMuestra de AWS CLI y el aws-shell

Trabaje con código para aplicaciones de robóticainteligentes en AWS RoboMaker.


Para obtener ayuda de la comunidad sobre AWS Cloud9, consulte el foro de debate sobre AWS Cloud9.(Cuando entre en este foro, es posible que AWS requiera que inicie sesión).


Muestra de AWS Command Line Interface y el aws-shell para AWS Cloud9

Esta muestra le permite configurar la AWS Command Line Interface (AWS CLI), el aws-shell o ambos enun entorno de desarrollo de AWS Cloud9. La AWS CLI y el aws-shell son herramientas unificadas queproporcionan una interfaz uniforme para interactuar con todas las partes de AWS. Puede utilizar la AWSCLI o el aws-shell en lugar de la Consola de administración de AWS para ejecutar comandos rápidamentepara interactuar con AWS. Algunos de estos comandos solo se pueden ejecutar con la AWS CLI o el aws-shell.

Para obtener más información sobre la AWS CLI, consulte la AWS Command Line Interface Guía delusuario. Para el aws-shell, consulte los recursos siguientes:

• aws-shell en el sitio web de GitHub• aws-shell en el sitio web de pip

Para obtener una lista de comandos que puede ejecutar con la AWS CLI para interactuar con AWS,consulte la AWS CLI Command Reference. Puede utilizar los mismos comandos con el aws-shell, salvoque los inicie sin el prefijo aws.

La creación de esta muestra puede generar cargos en su cuenta de AWS. Estos incluyen posibles cargospor servicios como Amazon EC2 y Amazon S3. Para obtener más información, consulte Precios deAmazon EC2 y Precios de Amazon S3.

Temas• Requisitos previos (p. 379)• Paso 1: Instalar la AWS CLI, el aws-shell o ambos en el entorno (p. 380)• Paso 2: Configurar la administración de credenciales en su entorno (p. 381)• Paso 3: Ejecutar algunos comandos básicos con la AWS CLI o el aws-shell en su entorno (p. 381)• Paso 4: Limpieza (p. 382)

Requisitos previosAntes de utilizar este ejemplo, asegúrese de que cumple los siguientes requisitos.

• Debe tener un entorno de desarrollo de EC2 de AWS Cloud9 existente. En esta muestra, se da porhecho que ya tiene un entorno de EC2 que está conectado a una instancia Amazon EC2 que ejecutaAmazon Linux o Ubuntu Server. Si tiene otro tipo de entorno o sistema operativo, es posible que tengaque adaptar las instrucciones de este ejemplo para configurar herramientas relacionadas. ConsulteCreación de un entorno en AWS Cloud9 (p. 61) para obtener más información.

379






https://github.com/awslabs/aws-shell

https://pypi.python.org/pypi/aws-shell

https://docs.aws.amazon.com/cli/latest/reference/




AWS Cloud9 Guía del usuarioPaso 1: Instalar la AWS CLI, el

aws-shell o ambos en el entorno

• Tiene ya abierto el AWS Cloud9 IDE para el entorno existente. Al abrir un entorno, AWS Cloud9 abre elIDE de ese entorno en el navegador web. Consulte Apertura de un entorno en AWS Cloud9 (p. 74) paraobtener más información.

Paso 1: Instalar la AWS CLI, el aws-shell o ambos enel entornoEn este paso, utilizará el AWS Cloud9 IDE para instalar la AWS CLI, el aws-shell o ambos en su entornopara poder ejecutar comandos para interactuar con AWS.

Si utiliza un entorno de desarrollo de EC2 de AWS Cloud9 y solo desea utilizar la AWS CLI, puedepasar directamente a Paso 3: Ejecutar algunos comandos básicos con la AWS CLI o el aws-shell en suentorno (p. 381). Esto se debe a que la AWS CLI ya está instalada en un entorno de EC2 y ya hay unconjunto de credenciales de acceso de AWS configurado en el entorno. Para obtener más información,consulte credenciales temporales administradas de AWS (p. 537).

Si no utiliza un entorno de EC2, siga estos pasos para instalar la AWS CLI:

1. Con el entorno abierto, en el IDE, compruebe si la AWS CLI ya está instalada. En el terminal, ejecuteel comando aws --version . (Para iniciar una nueva sesión del terminal, en la barra de menús,seleccione Window [Ventana], New Terminal [Nuevo terminal]). Si la AWS CLI está instalada, apareceel número de versión con información como los números de versión de Python y el número de versióndel sistema operativo de la instancia Amazon EC2 o su propio servidor. Si la AWS CLI está instalada,continúe en Paso 2: Configurar la administración de credenciales en su entorno (p. 381).

2. Para instalar la AWS CLI, consulte Instalación de la AWS Command Line Interface en la AWSCommand Line Interface Guía del usuario. Por ejemplo, en el caso de un entorno de EC2 que seejecute en Amazon Linux, ejecute estos tres comandos en el terminal, de uno en uno, para instalar laAWS CLI.

sudo yum -y update # Install the latest system updates.sudo yum -y install aws-cli # Install the AWS CLI.aws --version # Confirm the AWS CLI was installed.

En el caso de un entorno de EC2 que se ejecute en Ubuntu Server, ejecute en cambio estos trescomandos en el terminal, de uno en uno, para instalar la AWS CLI.

sudo apt update # Install the latest system updates.sudo apt install -y awscli # Install the AWS CLI.aws --version # Confirm the AWS CLI was installed.

Si desea instalar el aws-shell, siga estos pasos:

1. Con el entorno abierto, en el IDE, compruebe si el shell de AWS ya está instalado. En el terminal,ejecute el comando aws-shell . (Para iniciar una nueva sesión del terminal, en la barra de menús,seleccione Window [Ventana], New Terminal [Nuevo terminal]). Si el aws-shell está instalado,se muestra el símbolo de aws>. Si el aws-shell está instalado, continúe en Paso 2: Configurar laadministración de credenciales en su entorno (p. 381).

2. Para instalar el aws-shell, utilice pip. Para ello, debe tener instalado Python.

Para comprobar si Python ya está instalado (y para instalarlo si es necesario), siga las instruccionesen Paso 1: Instalar Python 3.6 (p. 449) en la Muestra de Python y, a continuación, vuelva a estetema.

380


AWS Cloud9 Guía del usuarioPaso 2: Configurar la administración

de credenciales en su entorno

Para comprobar si pip ya está instalado, en el terminal, ejecute el comando pip --version .Si lo está, aparece el número de versión. Si pip no está instalado, instálelo ejecutando estos trescomandos, de uno en uno, en el terminal.

wget https://bootstrap.pypa.io/get-pip.py # Get the pip install file.sudo python get-pip.py # Install pip. (You might need to run 'sudo python2 get-pip.py' or 'sudo python3 get-pip.py' instead, depending on how Python is installed.)rm get-pip.py # Delete the pip install file, as it is no longer needed.

3. Para utilizar pip para instalar el aws-shell, ejecute el siguiente comando.

sudo pip install aws-shell

Paso 2: Configurar la administración de credencialesen su entornoCada vez que utilice la AWS CLI o el aws-shell para llamar a un servicio de AWS, debe proporcionar unconjunto de credenciales con la llamada. Estas credenciales determinan si la AWS CLI o el aws-shelltienen los permisos adecuados para realizar esa llamada. Si las credenciales no cubren los permisosadecuados, la llamada no se realizará correctamente.

Si utiliza un entorno de desarrollo de EC2 de AWS Cloud9, puede pasar directamente a Paso 3: Ejecutaralgunos comandos básicos con la AWS CLI o el aws-shell en su entorno (p. 381). Esto se debe a quelas credenciales ya están configuradas en un entorno de EC2. Para obtener más información, consultecredenciales temporales administradas de AWS (p. 537).

Si no utiliza un entorno de EC2, debe almacenar manualmente sus credenciales dentro del entorno. Paraello, siga las instrucciones en Llamar a los servicios de AWS desde un entorno en AWS Cloud9 (p. 76) y, acontinuación, vuelva a este tema.

Paso 3: Ejecutar algunos comandos básicos con laAWS CLI o el aws-shell en su entornoEn este paso, utilizará la AWS CLI o el aws-shell en su entorno para crear un bucket en Amazon S3, verlos buckets disponibles y, a continuación, eliminar el bucket.

1. Si desea utilizar el aws-shell pero aún no lo ha iniciado, inicie el aws-shell ejecutando el comandoaws-shell. Se muestra el símbolo aws>.

2. Cree un bucket. Ejecute el comando aws s3 mb con la AWS CLI o el comando s3 mb con el aws-shell, especificando el nombre del bucket que se va a crear. En este ejemplo, utilizamos un bucketdenominado cloud9-123456789012-bucket, donde 123456789012 es su ID de cuenta de AWS.Si usa otro nombre, sustitúyalo en todo este paso.

aws s3 mb s3://cloud9-123456789012-bucket # For the AWS CLI.s3 mb s3://cloud9-123456789012-bucket # For the aws-shell.

Note

Los nombres de bucket deben ser únicos en todo AWS, no solo en la cuenta de AWS. Elnombre del bucket sugerido anterior puede ayudarle a crear un nombre de bucket único. Si

381

AWS Cloud9 Guía del usuarioPaso 4: Limpieza

recibe un mensaje que contiene el error BucketAlreadyExists, debe ejecutar el comandode nuevo con otro nombre de bucket.

3. Enumere los buckets disponibles. Ejecute el comando aws s3 ls con la AWS CLI o el comando s3ls con el aws-shell. Se muestra una lista de los buckets disponibles.

4. Eliminar el bucket. Ejecute el comando aws s3 rb con la AWS CLI o el comando s3 rb con elaws-shell, especificando el nombre del bucket que se va a eliminar.

aws s3 rb s3://cloud9-123456789012-bucket # For the AWS CLI.s3 rb s3://cloud9-123456789012-bucket # For the aws-shell.

Para confirmar si el bucket se ha eliminado, ejecute de nuevo el comando aws s3 ls con la AWSCLI o el comando s3 ls con el aws-shell. El nombre del bucket que se haya eliminado no deberíaaparecer ya en la lista.

Note

No es necesario eliminar el bucket si desea seguir utilizándolo. Para obtener másinformación, consulte Añadir un objeto a un bucket en la Guía de introducción a AmazonSimple Storage Service. Consulte también los comandos de s3 en la AWS CLI CommandReference. (Recuerde que si no elimina el bucket, podrían producirse cargos continuos en sucuenta de AWS).

Para continuar experimentando con la AWS CLI, consulte Uso de Amazon Web Services en la AWSCommand Line Interface Guía del usuario así como en la AWS CLI Command Reference. Para continuarexperimentando con el aws-shell, consulte la AWS CLI Command Reference, teniendo en cuenta que debeiniciar los comandos sin el prefijo aws.

Paso 4: LimpiezaSi utiliza el shell de AWS, puede dejar de utilizarlo ejecutando el comando .exit o .quit .

Para evitar que se hagan cargos continuos en su cuenta de AWS después de que haya terminado de usaresta muestra, elimine el entorno. Para obtener instrucciones, consulte Eliminación de un entorno en AWSCloud9 (p. 103).

Ejemplo de AWS CodeCommit para AWS Cloud9Con esta muestra puede configurar un entorno de desarrollo de AWS Cloud9 para interactuar con unrepositorio de código remoto en CodeCommit. CodeCommit es un servicio de control de código fuente quepermite almacenar de forma privada y administrar repositorios Git en la nube de AWS. Para obtener másinformación sobre CodeCommit, consulte Guía del usuario de AWS CodeCommit.

La creación de este ejemplo puede generar cargos en su cuenta de AWS. Estos incluyen posibles cargospor servicios como Amazon EC2 y CodeCommit. Para obtener más información, consulte Precios deAmazon EC2 y Precios de AWS CodeCommit.

• Requisitos previos (p. 383)• Paso 1: Configurar el grupo de IAM con los permisos de acceso necesarios (p. 383)• Paso 2: Crear un repositorio en AWS CodeCommit (p. 384)• Paso 3: Conectar el entorno con un repositorio remoto (p. 385)• Paso 4: Clonar el repositorio remoto en su entorno (p. 386)• Paso 5: Adición de archivos al repositorio (p. 386)• Paso 6: Eliminación (p. 388)

382

https://docs.aws.amazon.com/AmazonS3/latest/gsg/PuttingAnObjectInABucket.html

https://docs.aws.amazon.com/cli/latest/reference/s3/rm.html.html

https://docs.aws.amazon.com/cli/latest/userguide/chap-working-with-services.html



https://docs.aws.amazon.com/codecommit/latest/userguide/



https://aws.amazon.com/codecommit/pricing/





Paso 1: Configurar el grupo de IAM con los permisosde acceso necesariosSi sus credenciales de AWS están asociadas a un usuario administrador de IAM en su cuenta deAWS y desea utilizarlo para trabajar con CodeCommit, vaya al Paso 2: Crear un repositorio en AWSCodeCommit (p. 384).

Puede completar este paso con la consola de administración de AWS (p. 383) o la interfaz de línea decomandos de AWS (CLI de AWS) (p. 384).

Configurar un grupo de IAM con los permisos de accesonecesarios usando la consola1. Si todavía no ha iniciado sesión en la consola de administración de AWS, hágalo.




Policy (Adjuntar política).6. En la lista con los nombres de las políticas, seleccione una de las siguientes casillas:

• Seleccione AWSCodeCommitPowerUser para acceder a toda la funcionalidad de CodeCommit y losrecursos relacionados con el repositorio, pero no permite eliminar repositorios de CodeCommit nicrear o eliminar los recursos relacionados con el repositorio en otros servicios de AWS, como AmazonCloudWatch Events.

• Seleccione AWSCodeCommitFullAccess para tener el control total de repositorios de CodeCommit ylos recursos relacionados en la cuenta de AWS, incluida la posibilidad de eliminar repositorios.

(Si no ve ninguno de los nombres de política en la lista, escríbalo en el cuadro Filter (Filtrar) paramostrarlo).


Para ver la lista de los permisos de acceso que estas políticas administradas de AWS asignan a un grupo,consulte Políticas administradas (predefinidas) de AWS para AWS CodeCommit en la Guía del usuario deAWS CodeCommit.

383

https://docs.aws.amazon.com/codecommit/latest/userguide/auth-and-access-control-iam-identity-based-access-control.html#managed-policies

AWS Cloud9 Guía del usuarioPaso 2: Crear un repositorio en CodeCommit

Vaya al Paso 2: Crear un repositorio en AWS CodeCommit (p. 384).

Configurar un grupo de IAM con los permisos de accesonecesarios usando la AWS CLIEjecute el comando attach-group-policy de IAM especificando el nombre del grupo y el nombrede recurso de Amazon (ARN) de la política administrada de AWS que describe los permisos de accesorequeridos, por ejemplo:

aws iam attach-group-policy --group-name MyGroup --policy-arn POLICY_ARN

En el comando anterior, reemplace MyGroup por el nombre del grupo. Sustituya POLICY_ARN con el ARNde una de las siguientes políticas administradas de AWS como sigue:

• arn:aws:iam::aws:policy/AWSCodeCommitPowerUser para acceder a toda la funcionalidad deCodeCommit y los recursos relacionados con el repositorio, pero no permite eliminar repositorios deCodeCommit ni crear o eliminar los recursos relacionados con el repositorio en otros servicios de AWS,como Amazon CloudWatch Events.

• arn:aws:iam::aws:policy/AWSCodeCommitFullAccess para tener el control total de repositoriosde CodeCommit y los recursos relacionados en la cuenta de AWS, incluida la posibilidad de eliminarrepositorios.

Para ver la lista de los permisos de acceso que estas políticas administradas de AWS asignan a un grupo,consulte Políticas administradas (predefinidas) de AWS para AWS CodeCommit en la Guía del usuario deAWS CodeCommit.

Paso 2: Crear un repositorio en CodeCommitEn este paso, crea un repositorio de código remoto en CodeCommit mediante la consola de CodeCommit.

Si ya tiene un repositorio de CodeCommit, vaya al Paso 3: Conectar el entorno con el repositorioremoto (p. 385).

Puede completar este paso con la consola de administración de AWS (p. 384) o la interfaz de línea decomandos de AWS (CLI de AWS) (p. 385).

Crear un repositorio en CodeCommit, usando la consola1. Si ha iniciado sesión en la consola de administración de AWS como usuario administrador de IAM en el

paso anterior pero no desea utilizar este usuario administrador de IAM para crear el repositorio, cierresesión en la consola de administración de AWS.

2. Abra la consola de CodeCommit en https://console.aws.amazon.com/codecommit.3. En la barra de navegación de la consola, utilice el selector de regiones para elegir la región de AWS en

la que desea crear el repositorio (por ejemplo, EE. UU. Este (Ohio)).4. Si aparece una página de bienvenida, elija Get Started Now. Si no, elija Create repository (Crear

repositorio).5. En la página Create repository (Crear repositorio), en el campo Repository name (Nombre del

repositorio), escriba un nombre para el repositorio, por ejemplo, MyDemoCloud9Repo. Si elige otronombre, sustitúyalo en todo este ejemplo.

6. (Opcional) En Description (Descripción), escriba un breve texto sobre el repositorio; (por ejemplo, Thisis a demonstration repository for the AWS Cloud9 sample.).

7. Elija Create repository. Se muestra un panel Connect to your repository (Conectar con el repositorio).Seleccione Close (Cerrar), ya que se conectará a su repositorio de una forma diferente más adelante eneste tema.

384

https://docs.aws.amazon.com/codecommit/latest/userguide/auth-and-access-control-iam-identity-based-access-control.html#managed-policies

https://console.aws.amazon.com/codecommit

AWS Cloud9 Guía del usuarioPaso 3: Conectar el entorno con el repositorio remoto

Salte al Paso 3: Conectar el entorno con el repositorio remoto (p. 385).

Crear un repositorio en CodeCommit usando la AWS CLIEjecute el comando create-repository de AWS CodeCommit, especificando el nombre del repositorio,una descripción (opcional) y la región de AWS en la que crear el repositorio, por ejemplo:

aws codecommit create-repository --repository-name MyDemoCloud9Repo --repository-description "This is a demonstration repository for the AWS Cloud9 sample." --region us-east-2

En el comando anterior, sustituya us-east-2 por el ID de la región de AWS en la que se creará elrepositorio. Para obtener una lista de las regiones compatibles, consulte AWS CodeCommit en laReferencia general de Amazon Web Services.

Si decide usar otro nombre para el repositorio sustitúyalo en todo este ejemplo.

Paso 3: Conectar el entorno con el repositorio remotoEn este paso, utilice el AWS Cloud9 IDE para conectarse al repositorio de CodeCommit que ha creado oidentificado en el paso anterior.

Complete uno de los siguientes conjuntos de procedimientos, en función del tipo de entorno de desarrollode AWS Cloud9 que tenga.

Tipo de entorno Siga estos procedimientos

entorno de EC2 1. En una sesión de terminal en el IDE 2, ejecutelos siguientes comandos:

git config --global credential.helper '!aws codecommit credential-helper $@'git config --global credential.UseHttpPath true

Para obtener más información, consulte Paso2: configuración del auxiliar de credenciales dela CLI de AWS en el entorno de desarrollo EC2de AWS Cloud9 en Integración de AWS Cloud9con AWS CodeCommit en la Guía del usuariode AWS CodeCommit.

2. Avance al Paso 4: Clonar el repositorio remotoen su entorno (p. 386), más adelante en estetema.

entorno de SSH 1. Si Git no está ya instalado en el entorno,utilice una sesión de terminal en el IDE parahacerlo. Para obtener más información,consulte la sección Paso 2: instalar Git enPasos de configuración para conexiones SSHa repositorios de AWS CodeCommit en Linux,macOS o Unix en la Guía del usuario de AWSCodeCommit.

2. Complete el Paso 3: configurar credenciales enLinux, macOS o Unix de Pasos para configurar

385

https://docs.aws.amazon.com/general/latest/gr/rande.html#codecommit_region

https://docs.aws.amazon.com/codecommit/latest/userguide/setting-up-ide-c9.html#setting-up-ide-c9-credentials




https://docs.aws.amazon.com/codecommit/latest/userguide/setting-up-ssh-unixes.html#setting-up-ssh-unixes-install-git



AWS Cloud9 Guía del usuarioPaso 4: Clonar el repositorio remoto en su entorno

Tipo de entorno Siga estos procedimientosconexiones SSH a repositorios de AWSCodeCommit en Linux, macOS o Unix en laGuía del usuario de AWS CodeCommit.

Cuando se le indique que inicie sesión enla consola de administración de AWS y queabra la consola de IAM, le recomendamos queinicie sesión con las credenciales de usuarioadministrador de IAM de su cuenta de AWS. Sino puede hacerlo, consulte con el administradorde su cuenta de AWS.

3. Avance al Paso 4: Clonar el repositorio remotoen su entorno (p. 386), más adelante en estetema.

Paso 4: Clonar el repositorio remoto en su entornoEn este paso, se utiliza el AWS Cloud9 IDE para clonar el repositorio remoto de CodeCommit en suentorno.

Para clonar el repositorio, ejecute el comando git clone , especificando la dirección URL de laclonación del repositorio, que se muestra aquí como CLONE_URL .

git clone CLONE_URL

Para un entorno de EC2, se proporciona una URL de clonación HTTPS que comienza por https://. Paraun entorno de SSH, se proporciona una URL de clonación SSH que comienza por ssh://.

Para obtener la URL de clonación completa del repositorio, consulte Uso de la consola de AWSCodeCommit para ver la información de los repositorios en la Guía del usuario de AWS CodeCommit.

Si su repositorio no tiene ningún archivo, se muestra un mensaje de advertencia, por ejemplo, Youappear to have cloned an empty repository. Este es el comportamiento esperado y seabordará más adelante.

Paso 5: Añadir archivos al repositorioEn este paso, se crean tres archivos simples en el repositorio clonado de su entorno. A continuación,añada los archivos al espacio provisional de Git del repositorio clonado, confirme los archivos provisionalesy envíe la confirmación al repositorio remoto en CodeCommit.

Si el repositorio clonado ya tiene archivos, ha terminado y puede ignorar el resto de esta muestra.

Para añadir archivos al repositorio

1. Cree un archivo nuevo. En la barra de menús, elija File (Archivo), New File (Archivo nuevo).2. Escriba el contenido siguiente en el archivo y a continuación, elija File (Archivo), Save (Guardar) para

guardar el archivo bird.txt en el directorio MyDemoCloud9Repo de su entorno.

bird.txt--------Birds are a group of endothermic vertebrates, characterized by feathers,toothless beaked jaws, the laying of hard-shelled eggs, a high metabolic

386

https://docs.aws.amazon.com/codecommit/latest/userguide/how-to-view-repository-details.html#how-to-view-repository-details-console

https://docs.aws.amazon.com/codecommit/latest/userguide/how-to-view-repository-details.html#how-to-view-repository-details-console

AWS Cloud9 Guía del usuarioPaso 5: Añadir archivos al repositorio

rate, a four-chambered heart, and a lightweight but strong skeleton.

Note

Para confirmar que guarda el archivo en el directorio correcto, en el cuadro de diálogoSave As (Guardar como), elija la carpeta MyDemoCloud9Repo y asegúrese de que Folder(Carpeta) muestra /MyDemoCloud9Repo.

3. Cree dos archivos más y llámelos insect.txt y reptile.txt, con el contenido siguiente yguárdelos en el mismo directorio MyDemoCloud9Repo.

insect.txt----------Insects are a class of invertebrates within the arthropod phylum thathave a chitinous exoskeleton, a three-part body (head, thorax, and abdomen),three pairs of jointed legs, compound eyes, and one pair of antennae.

reptile.txt-----------Reptiles are tetrapod (four-limbed vertebrate) animals in the classReptilia, comprising today's turtles, crocodilians, snakes,amphisbaenians, lizards, tuatara, and their extinct relatives.

4. En el terminal, ejecute el comando cd para cambiar al directorio MyDemoCloud9Repo.

cd MyDemoCloud9Repo

5. Confirme que el archivo se ha guardado correctamente en el directorio MyDemoCloud9Repoejecutando el comando git status . Los tres archivos se mostrarán como archivos sin seguimiento.

Untracked files: (use "git add <file>..." to include in what will be committed)

bird.txt insect.txt reptile.txt

6. Agréguelos al espacio provisional de Git ejecutando el comando git add .

git add --all

7. Confirme que los archivos se agregaron correctamente al espacio provisional de Git ejecutando elcomando git status de nuevo. Los tres archivos aparecen ahora como cambios por confirmar.

Changes to be committed: (use "git rm --cached <file>..." to unstage)

new file: bird.txt new file: insect.txt new file: reptile.txt

8. Confirme los archivos provisionales ejecutando el comando git commit .

git commit -m "Added information about birds, insects, and reptiles."

9. Envíe la confirmación al repositorio remoto de CodeCommit ejecutando el comando git push .

git push -u origin master

387


10. Confirme si los archivos se han enviado correctamente. Abra la consola de CodeCommit si aún noestá abierta, en https://console.aws.amazon.com/codecommit.

11. En la barra de navegación superior cerca del borde derecho, elija la región de AWS en la que creó elrepositorio (por ejemplo, EE. UU. Este (Ohio)).

12. En la página Dashboard (Panel), seleccione MyDemoCloud9Repo. Se muestran los tres archivos.

Para continuar experimentando con el repositorio de CodeCommit, consulte Examinar el contenido delrepositorio en la Guía del usuario de AWS CodeCommit.

Si es la primera vez que utiliza Git y no desea estropear el repositorio de CodeCommit, experimente conuna muestra de repositorio Git en el sitio web Try Git.

Paso 6: EliminaciónPara evitar que se hagan cargos continuos en su cuenta de AWS una vez terminada esta muestra, leconviene eliminar el repositorio CodeCommit. Para obtener instrucciones, consulte Eliminar un repositoriode AWS CodeCommit en la Guía del usuario de AWS CodeCommit.

También debe eliminar el entorno. Para obtener instrucciones, consulte la sección sobre eliminación deentornos (p. 103).

Ejemplo de GitHub para AWS Cloud9En este ejemplo, puede configurar un entorno de desarrollo de AWS Cloud9 para interactuar con unrepositorio de código remoto en GitHub. Para obtener más información acerca de GitHub, consulte lossitios web de GitHub y GitHub Help.

La creación de esta muestra puede generar cargos en su cuenta de AWS. Entre ellos, se incluyen posiblescargos por servicios como Amazon EC2. Para obtener más información, consulte Precios de Amazon EC2.

Temas• Requisitos previos (p. 388)• Paso 1: Crear una cuenta de GitHub (p. 389)• Paso 2: Crear un repositorio de GitHub (p. 389)• Paso 3: Instalación de Git en su entorno (p. 389)• Paso 4: Clonar el repositorio remoto en su entorno (p. 390)• Paso 5: Adición de archivos al repositorio (p. 390)• Paso 6: Seguir trabajando con el IDE y GitHub (p. 392)• Paso 7: Eliminación (p. 392)




388

https://console.aws.amazon.com/codecommit

https://docs.aws.amazon.com/codecommit/latest/userguide/getting-started-cc.html#getting-started-cc-browse

https://docs.aws.amazon.com/codecommit/latest/userguide/getting-started-cc.html#getting-started-cc-browse

https://try.github.io/

https://docs.aws.amazon.com/codecommit/latest/userguide/how-to-delete-repository.html

https://docs.aws.amazon.com/codecommit/latest/userguide/how-to-delete-repository.html

https://github.com/

https://help.github.com/


AWS Cloud9 Guía del usuarioPaso 1: Crear una cuenta de GitHub

Comience con el siguiente paso, en función de lo que ya tenga.

¿Tiene una cuenta deGitHub?

¿Tiene un repositorio deGitHub?

¿Tiene instalado Git? Comience por este paso

No -- -- Paso 1: Crearuna cuenta deGitHub (p. 389)

Sí No -- Paso 2: Crearun repositorio deGitHub (p. 389)

Sí Sí No (o no estoy seguro) Paso 3: Instalaciónde Git en suentorno (p. 389)

Sí Sí Sí Paso 4: Clonar elrepositorio remoto en suentorno (p. 390)

Paso 1: Crear una cuenta de GitHubSi ya tiene una cuenta de GitHub, continúe en Paso 2: Crear un repositorio de GitHub (p. 389).

Para crear una cuenta de GitHub, consulte Join GitHub en el sitio web de GitHub.

Paso 2: Crear un repositorio de GitHubSi ya tiene un repositorio de GitHub, continúe en Paso 3: Instalación de Git en su entorno (p. 389).

Para crear el repositorio, consulte Create A Repo en el sitio web GitHub Help.

Paso 3: Instalación de Git en su entornoEn este paso, se utiliza el AWS Cloud9 IDE para instalar Git en su entorno para que pueda clonar surepositorio remoto en el entorno más adelante.

Si ya tiene Git instalado en su entorno, continúe en Paso 4: Clonar el repositorio remoto en suentorno (p. 390). Para comprobar si ya tiene instalado Git, ejecute el comando git --version , tal ycomo se describe en este paso.

1. Con el entorno abierto, en el AWS Cloud9 IDE, inicie una nueva sesión de terminal si no hay ningunainiciada. [Para iniciar una nueva sesión del terminal, en la barra de menús, seleccione Window(Ventana), New Terminal (Nuevo terminal)].

2. Compruebe si Git ya está instalado. En el terminal, ejecute el comando git --version . Si Git estáinstalado, aparece el número de versión; por ejemplo, git version N.N.N . La versión instaladadebe ser 1.7.9 o posterior. Si lo está, vaya al paso 4 de este procedimiento para establecer su nombrey dirección de correo electrónico de Git.

3. Para instalar Git, consulte Git Downloads en el sitio web de Git. Por ejemplo, en el caso de un entornode EC2 que se ejecute en Amazon Linux, ejecute estos tres comandos en el terminal, de uno en uno,para instalar Git.

sudo yum -y update # Install the latest system updates.

389

https://github.com/join

https://help.github.com/articles/create-a-repo/

https://git-scm.com/downloads

AWS Cloud9 Guía del usuarioPaso 4: Clonar el repositorio remoto en su entorno

sudo yum -y install git # Install Git.git --version # Confirm Git was installed.

En el caso de un entorno de EC2 que se ejecute en Ubuntu Server, ejecute en cambio estos trescomandos en el terminal, de uno en uno, para instalar Git.

sudo apt update # Install the latest system updates.sudo apt install -y git # Install Git.git --version # Confirm Git was installed.

4. Establezca su nombre y dirección de correo electrónico de Git. En el terminal, ejecute estos doscomandos, de uno en uno, sustituyendo su nombre y dirección de correo electrónico de Git por USER_NAME y EMAIL_ADDRESS .

git config --global user.name "USER_NAME"git config --global user.email EMAIL_ADDRESS

Paso 4: Clonar el repositorio remoto en su entornoEn este paso, se utiliza el AWS Cloud9 IDE para clonar el repositorio remoto de GitHub en su entorno.

Para clonar el repositorio, consulte Cloning a Repository en el sitio web de GitHub.

Note

En el resto de este ejemplo, se da por hecho que el directorio de trabajo actual en el que haclonado el repositorio es el directorio raíz de entorno. Si ha realizado la clonación en otra parte,sustituya esa ubicación donde vea /YOUR_CLONED_REPO_NAME .

Paso 5: Adición de archivos al repositorioEn este paso, se crean tres archivos simples en el repositorio clonado de su entorno. A continuación,se añaden los archivos al espacio provisional de Git del repositorio clonado, se confirman los archivosprovisionales y se envía la confirmación al repositorio remoto en GitHub.

Si el repositorio clonado ya tiene archivos en él, continúe en Paso 6: Seguir trabajando con el IDE yGitHub (p. 392).

1. Cree un archivo nuevo. En la barra de menús, elija File (Archivo), New File (Archivo nuevo).2. Escriba el contenido siguiente en el archivo y a continuación, elija File (Archivo), Save (Guardar) para

guardar el archivo bird.txt en el directorio /YOUR_CLONED_REPO_NAME de su entorno.

bird.txt--------Birds are a group of endothermic vertebrates, characterized by feathers,toothless beaked jaws, the laying of hard-shelled eggs, a high metabolicrate, a four-chambered heart, and a lightweight but strong skeleton.

Note

Para confirmar que guarda el archivo en el directorio correcto, en el cuadro de diálogo SaveAs (Guardar como), elija la carpeta YOUR_CLONED_REPO_NAME y asegúrese de queFolder (Carpeta) muestra /YOUR_CLONED_REPO_NAME .

3. Cree dos archivos más y llámelos insect.txt y reptile.txt, con el contenido siguiente yguárdelos también en el mismo directorio /YOUR_CLONED_REPO_NAME .

390

https://help.github.com/articles/cloning-a-repository/#platform-linux

AWS Cloud9 Guía del usuarioPaso 5: Adición de archivos al repositorio

insect.txt----------Insects are a class of invertebrates within the arthropod phylum thathave a chitinous exoskeleton, a three-part body (head, thorax, and abdomen),three pairs of jointed legs, compound eyes, and one pair of antennae.

reptile.txt-----------Reptiles are tetrapod (four-limbed vertebrate) animals in the classReptilia, comprising today's turtles, crocodilians, snakes,amphisbaenians, lizards, tuatara, and their extinct relatives.

4. En el terminal, ejecute el comando cd para cambiar al directorio /YOUR_CLONED_REPO_NAME .

cd YOUR_CLONED_REPO_NAME

5. Confirme que el archivo se ha guardado correctamente en el directorio /YOUR_CLONED_REPO_NAME ejecutando el comando git status . Los tres archivos se mostrarán como archivos sin seguimiento.

Untracked files: (use "git add <file>..." to include in what will be committed)

bird.txt insect.txt reptile.txt

6. Agréguelos al espacio provisional de Git ejecutando el comando git add .

git add --all

7. Confirme que los archivos se agregaron correctamente al espacio provisional de Git ejecutando elcomando git status de nuevo. Los tres archivos aparecen ahora como cambios por confirmar.

Changes to be committed: (use "git reset HEAD <file>..." to unstage)

new file: bird.txt new file: insect.txt new file: reptile.txt

8. Confirme los archivos provisionales ejecutando el comando git commit .

git commit -m "Added information about birds, insects, and reptiles."

9. Envíe la confirmación al repositorio remoto de CodeCommit ejecutando el comando git push .

git push

Note

Se le solicitará su nombre de usuario y contraseña de GitHub. A medida que continúatrabajando con GitHub, es posible que se le pida de nuevo. Para evitar que se le pida cadavez que intente interactuar con el repositorio remoto en el futuro, considere la posibilidad deinstalar y configurar un administrador de credenciales de Git. Por ejemplo, puede ejecutareste comando en el terminal para que no las solicite antes de transcurridos 15 minutos:git config credential.helper 'cache --timeout 900'. También puedeejecutar este comando para que nunca se las solicite de nuevo, aunque Git almacena sus

391

AWS Cloud9 Guía del usuarioPaso 6: Seguir trabajando con el IDE y GitHub

credenciales en texto sin formato en un archivo sin formato del directorio principal: gitconfig credential.helper 'store --file ~/.git-credentials'. Para obtenermás información, consulte Git Tools - Credential Storage en el sitio web de Git.Si utiliza la autenticación de dos factores de GitHub, debe indicar un token de accesopersonal cuando se le solicite una contraseña. Si escribe una contraseña en lugar de untoken de acceso personal, aparecerá el mensaje "invalid user name or password" (nombre deusuario o contraseña no válidos) y se producirá un error en la operación. Para obtener másinformación, consulte Creating a personal access token for the command line en el sitio webGitHub Help.No verá su contraseña ni el token de acceso personal cuando lo introduzca en el terminal.Este comportamiento es así por diseño.

10. Para confirmar si los archivos se han enviado correctamente desde su copia local del repositorio alrepositorio remoto, abra el repositorio en la consola de GitHub y busque los tres archivos que acabade enviar.

Paso 6: Seguir trabajando con el IDE y GitHubUtilice el AWS Cloud9 IDE y GitHub para seguir trabajando con su código. Estas son algunas cosas quepuede probar.

• Utilice la ventana entorno y las pestañas del editor en el IDE para ver, cambiar y guardar el código. Paraobtener más información, consulte el Paso 3: Ventana entorno (p. 111) y el Paso 4: Editor, pestañas ypaneles (p. 111) en Recorrido del IDE (p. 108).

• Utilice el IDE para ejecutar, depurar y compilar su código. Para obtener más información, consulteTrabajo con compiladores, ejecutores y depuradores en el AWS Cloud9 Integrated DevelopmentEnvironment (IDE) (p. 158).

• Utilice Git en la sesión de terminal en el IDE para seguir enviando más cambios en el código alrepositorio de GitHub, así como para recibir periódicamente los cambios en el código que realicen otraspersonas del repositorio. Para obtener más información, consulte Pushing to a Remote y Fetching aremote en el sitio web GitHub Help.

• Utilice comandos de Git adicionales cuando los necesite. Para ver una lista de estos comandos, consulteGit cheatsheet en el sitio web GitHub Help.

• Si es la primera vez que utiliza Git y no desea estropear el repositorio de GitHub, experimente con unrepositorio Git de ejemplo en el sitio web Try Git.

• Invite a que otras personas trabajen en su código con usted en el mismo entorno, en tiempo real ycon chat de texto. Para obtener más información, consulte Trabajo con entornos compartidos en AWSCloud9 (p. 88).

Paso 7: EliminaciónPara evitar que se hagan cargos continuos en su cuenta de AWS después de que haya terminado de usaresta muestra, elimine el entorno. Para obtener instrucciones, consulte Eliminación de un entorno en AWSCloud9 (p. 103).

Para eliminar el repositorio de GitHub, consulte Deleting a Repository en el sitio web GitHub Help.

Ejemplo de Amazon DynamoDB para AWS Cloud9Este ejemplo le permite configurar un entorno de desarrollo de AWS Cloud9 para trabajar con AmazonDynamoDB.

392

https://git-scm.com/book/en/v2/Git-Tools-Credential-Storage

https://help.github.com/articles/creating-a-personal-access-token-for-the-command-line/

https://help.github.com/articles/pushing-to-a-remote/

https://help.github.com/articles/fetching-a-remote/

https://help.github.com/articles/fetching-a-remote/

https://help.github.com/articles/git-cheatsheet/

https://try.github.io/

https://help.github.com/articles/deleting-a-repository/


DynamoDB es una base de datos administrada NoSQL. Puede utilizar DynamoDB para crear una tabla debase de datos capaz de almacenar y recuperar cualquier cantidad de datos, así como de atender cualquiernivel de tráfico de solicitudes. DynamoDB distribuye automáticamente los datos y el tráfico de la tabla entreun número de servidores suficiente como para administrar la capacidad de solicitudes especificada y lacantidad de datos almacenados, manteniendo al mismo tiempo un desempeño uniforme y rápido. Paraobtener más información, consulte Amazon DynamoDB en la página web de AWS.

La creación de este ejemplo puede generar cargos en su cuenta de AWS. Estos incluyen posibles cargospor servicios como Amazon EC2 y DynamoDB. Para obtener más información, consulte Precios deAmazon EC2 y Precios de Amazon DynamoDB.

Para obtener más información sobre otras ofertas de base de datos de AWS, consulte Amazon RelationalDatabase Service (RDS), Amazon ElastiCache y Amazon Redshift en el sitio web de AWS. Consultetambién AWS Database Migration Service en el sitio web de AWS.

• Requisitos previos (p. 393)• Paso 1: Instalar y configurar la CLI de AWS, el aws-shell o ambos en el entorno (p. 393)• Paso 2: Crear una tabla (p. 394)• Paso 3: Añadir un elemento a la tabla (p. 395)• Paso 4: Añadir varios elementos a la tabla (p. 396)• Paso 5: Crear un índice secundario global (p. 399)• Paso 6: Obtener elementos de la tabla (p. 401)• Paso 7: Eliminación (p. 404)




Paso 1: Instalar y configurar la AWS CLI, el shell deAWS o ambos en el entornoEn este paso, utilizará el AWS Cloud9 IDE para instalar y configurar la AWS CLI, el shell de AWS o ambosen su entorno para poder ejecutar comandos para interactuar con DynamoDB. A continuación, utilice laAWS CLI para ejecutar un comando de DynamoDB básico para probar la instalación y la configuración.

1. Para configurar la administración de credenciales para la AWS CLI o el shell de AWS y para instalar laAWS CLI, el shell de AWS o ambos en su entorno, siga los pasos 1 y 2 del Ejemplo de la CLI de AWSy el shell de AWS (p. 379) y, a continuación, vuelva a este tema. Si ya ha instalado y configurado laAWS CLI, el shell de AWS o ambos en su entorno, no es necesario hacerlo de nuevo.

2. Pruebe la instalación y configuración de la AWS CLI, el shell de AWS o ambos ejecutando el comandolist-tables de DynamoDB desde una sesión de terminal en su entorno para obtener una lista delas tablas de DynamoDB, si hay alguna. Para comenzar una nueva sesión de terminal, en la barra demenús, seleccione Windows (Ventanas), New Terminal (Nuevo terminal).

393

https://aws.amazon.com/dynamodb/



https://aws.amazon.com/dynamodb/pricing/

https://aws.amazon.com/rds/

https://aws.amazon.com/rds/

https://aws.amazon.com/elasticache/

https://aws.amazon.com/redshift/

https://aws.amazon.com/dms/

AWS Cloud9 Guía del usuarioPaso 2: Crear una tabla

aws dynamodb list-tables # For the AWS CLI.dynamodb list-tables # For the aws-shell.

Note

En este ejemplo, si está utilizando el aws-shell, omita aws de cada comando que comience poraws. Para iniciar el shell de AWS, ejecute el comando aws-shell . Para dejar de usar el shellde AWS, ejecute el comando .exit o .quit .

Si este comando se ejecuta correctamente, genera una matriz TableNames que contiene una lista detablas de DynamoDB existentes que es posible que ya tenga. Si no tiene aún tablas de DynamoDB, lamatriz TableNames estará vacía.

{ "TableNames": []}

Si tiene cualquier tabla de DynamoDB, la matriz TableNames contiene una lista de los nombres de lastablas.

Paso 2: Crear una tablaEn este paso, se crea una tabla en DynamoDB y se especifica el nombre de la tabla, el diseño, la claveprincipal simple y los ajustes del desempeño de los datos.

Esta tabla de ejemplo, denominada Weather, contiene información acerca de las previsionesmeteorológicas para algunas ciudades de Estados Unidos. La tabla contiene los siguientes tipos deinformación (en DynamoDB, cada fragmento de información se denomina atributo):

• ID único y obligatorio de la ciudad (CityID)• Fecha de previsión obligatoria (Date)• Nombre de ciudad (City)• Nombre de estado (State)• Condiciones meteorológicas de la previsión (Conditions)• Temperaturas de la previsión (Temperatures)

• Temperatura máxima de la previsión, en grados Fahrenheit (HighF)• Temperatura mínima de la previsión, en grados Fahrenheit (LowF)

Para crear la tabla, en una sesión del terminal del AWS Cloud9 IDE, ejecute el comando create-tablede DynamoDB.

aws dynamodb create-table \--table-name Weather \--attribute-definitions \ AttributeName=CityID,AttributeType=N AttributeName=Date,AttributeType=S \--key-schema \ AttributeName=CityID,KeyType=HASH AttributeName=Date,KeyType=RANGE \--provisioned-throughput ReadCapacityUnits=5,WriteCapacityUnits=5

En este comando:

• --table-name representa el nombre de la tabla (Weather en este ejemplo). Los nombres de tabladeben ser únicos de cada región de AWS de la cuenta de AWS.

394

AWS Cloud9 Guía del usuarioPaso 3: Añadir un elemento a la tabla

• --attribute-definitions representa los atributos que se utilizan para identificar de forma única loselementos de la tabla. Cada uno de los elementos de esta tabla se identifica de forma única por mediode una combinación de un atributo ID numérico y un atributo Date representado como una cadena conformato ISO-8601.

• --key-schema representa el esquema de claves de la tabla. Esta tabla tiene una clave principalcompuesta de CityID y Date. Esto significa que cada uno de los elementos de la tabla debe tener unvalor de atributo CityID y un valor de atributo Date, pero no puede haber dos elementos de la tablaque tengan el mismo valor de atributo CityID y valor de atributo Date.

• --provisioned-throughput representa la capacidad de lectura-escritura de la tabla. DynamoDBpermite hasta 5 lecturas de consistencia alta por segundo para elementos hasta de hasta 4 KB detamaño o hasta 5 lecturas consistentes finales por segundo para los elementos de hasta 4 KB detamaño. DynamoDB también permite hasta 5 escrituras por segundo para los elementos con un tamañode hasta 1 KB.

Note

Si se establece un desempeño aprovisionado mayor, se podrían generar cargos adicionales enla cuenta de AWS.Para obtener más información acerca de este comando y otros comandos de DynamoDBconsulte dynamodb en la AWS CLI Command Reference.

Si este comando se ejecuta correctamente, se muestra información resumida sobre la tabla nueva que seestá creando. Para confirmar que la tabla se ha creado correctamente, ejecute el comando describe-table de DynamoDB, especificando el nombre de la tabla (--table-name).

aws dynamodb describe-table --table-name Weather

Cuando la tabla se crea correctamente, el valor de TableStatus cambia de CREATING a ACTIVE. Nosiga realizando los pasos hasta que la tabla se haya creado correctamente.

Paso 3: Añadir un elemento a la tablaEn este paso, se añade un elemento a la tabla que se acaba de crear.

1. Cree un archivo denominado weather-item.json con el siguiente contenido. Para crear un archivonuevo, en la barra de menús, elija File (Archivo), New File (Nuevo archivo). Para guardar el archivo, elijaFile (Archivo), Save (Guardar).

{ "CityID": { "N": "1" }, "Date": { "S": "2017-04-12" }, "City": { "S": "Seattle" }, "State": { "S": "WA" }, "Conditions": { "S": "Rain" }, "Temperatures": { "M": { "HighF": { "N": "59" }, "LowF": { "N": "46" } } }}

En este código, N representa un valor de atributo que es un número. S es un valor de atributo decadena. M es un atributo de mapa, que es un conjunto de pares de atributo-valor. Debe especificar untipo de datos del atributo siempre que trabaje con elementos. Para obtener tipos de datos de atributosdisponibles adicionales, consulte la sección Tipos de datos en la Guía para desarrolladores de AmazonDynamoDB.

395

https://docs.aws.amazon.com/cli/latest/reference/dynamodb/index.html

https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/HowItWorks.NamingRulesDataTypes.html#HowItWorks.DataTypes

AWS Cloud9 Guía del usuarioPaso 4: Añadir varios elementos a la tabla

2. Ejecute el comando DynamoDB de put-item, especificando el nombre de la tabla (--table-name) yla ruta del elemento con formato JSON (--item).

aws dynamodb put-item \--table-name Weather \--item file://weather-item.json

Si el comando se ejecuta correctamente, no habrá errores y no aparecerá ningún mensaje deconfirmación.

3. Para confirmar el contenido actual de la tabla, ejecute el comando scan de DynamoDB, especificandoel nombre de la tabla (--table-name).

aws dynamodb scan --table-name Weather

Si el comando se ejecuta correctamente, aparece la información resumida sobre la tabla y el elementoque acaba de agregar.

Paso 4: Añadir varios elementos a la tablaEn este paso, agregamos varios elementos más a la tabla Customers.

1. Cree un archivo denominado more-weather-items.json con el siguiente contenido.

{ "Weather": [ { "PutRequest": { "Item": { "CityID": { "N": "1" }, "Date": { "S": "2017-04-13" }, "City": { "S": "Seattle" }, "State": { "S": "WA" }, "Conditions": { "S": "Rain" }, "Temperatures": { "M": { "HighF": { "N": "52" }, "LowF": { "N": "43" } } } } } }, { "PutRequest": { "Item": { "CityID": { "N": "1" }, "Date": { "S": "2017-04-14" }, "City": { "S": "Seattle" }, "State": { "S": "WA" }, "Conditions": { "S": "Rain" }, "Temperatures": { "M": { "HighF": { "N": "49" }, "LowF": { "N": "43" } } } } } }, { "PutRequest": {

396


"Item": { "CityID": { "N": "2" }, "Date": { "S": "2017-04-12" }, "City": { "S": "Portland" }, "State": { "S": "OR" }, "Conditions": { "S": "Thunderstorms" }, "Temperatures": { "M": { "HighF": { "N": "59" }, "LowF": { "N": "43" } } } } } }, { "PutRequest": { "Item": { "CityID": { "N": "2" }, "Date": { "S": "2017-04-13" }, "City": { "S": "Portland" }, "State": { "S": "OR" }, "Conditions": { "S": "Rain" }, "Temperatures": { "M": { "HighF": { "N": "51" }, "LowF": { "N": "41" } } } } } }, { "PutRequest": { "Item": { "CityID": { "N": "2" }, "Date": { "S": "2017-04-14" }, "City": { "S": "Portland" }, "State": { "S": "OR" }, "Conditions": { "S": "Rain Showers" }, "Temperatures": { "M": { "HighF": { "N": "49" }, "LowF": { "N": "39" } } } } } }, { "PutRequest": { "Item": { "CityID": { "N": "3" }, "Date": { "S": "2017-04-12" }, "City": { "S": "Portland" }, "State": { "S": "ME" }, "Conditions": { "S": "Rain" }, "Temperatures": { "M": { "HighF": { "N": "59" }, "LowF": { "N": "40" } } } } } }, { "PutRequest": { "Item": { "CityID": { "N": "3" },

397


"Date": { "S": "2017-04-13" }, "City": { "S": "Portland" }, "State": { "S": "ME" }, "Conditions": { "S": "Partly Sunny" }, "Temperatures": { "M": { "HighF": { "N": "54" }, "LowF": { "N": "37" } } } } } }, { "PutRequest": { "Item": { "CityID": { "N": "3" }, "Date": { "S": "2017-04-14" }, "City": { "S": "Portland" }, "State": { "S": "ME" }, "Conditions": { "S": "Mostly Sunny" }, "Temperatures": { "M": { "HighF": { "N": "53" }, "LowF": { "N": "37" } } } } } } ]}

En este código, hay 8 objetos Item que definen los 8 elementos que se van a añadir a la tabla, deforma similar al elemento único que se ha definido en el paso anterior. Sin embargo, al ejecutar elcomando batch-write-item de DynamoDB en el siguiente paso, debe proporcionar un objeto conformato JSON que incluye cada uno de los objetos Item en un objeto que contiene PutRequest.A continuación, debe incluir esos objetos PutRequest en una matriz principal que tenga el mismonombre que la tabla.

2. Ejecute el comando batch-write-item de DynamoDB, especificando la ruta de los elementos conformato JSON que se van a añadir (--request-items).

aws dynamodb batch-write-item \--request-items file://more-weather-items.json

Si el comando se ejecuta correctamente, se muestra el siguiente mensaje, que confirma que loselementos se han agregado correctamente.

{ "UnprocessedItems": {}}

3. Para confirmar el contenido actual de la tabla, ejecute de nuevo el comando scan de DynamoDB.

aws dynamodb scan --table-name Weather

Si el comando se ejecuta correctamente, ahora se muestran 9 elementos.

398

AWS Cloud9 Guía del usuarioPaso 5: Crear un índice secundario global

Paso 5: Crear un índice secundario globalLa ejecución del comando scan de DynamoDB para obtener información sobre elementos puede serlenta, especialmente cuando la tabla aumenta de tamaño o si el tipo de información que desea obtener escomplejo. Puede crear uno o varios índices secundarios para acelerar las cosas y obtener información másfácilmente. En este paso, conocerá dos tipos de índices secundarios que admite DynamoDB para hacerprecisamente eso. Se denominan índice secundario local e índice secundario global. A continuación, secrea un índice secundario global.

Para comprender estos tipos de índices secundarios, primero debe conocer las claves primarias, queidentifican de forma única los elementos de una tabla. DynamoDB admite una clave principal simple ouna clave principal compuesta. Una clave principal simple posee un único atributo y ese valor del atributodebe ser único para cada elemento de la tabla. Este atributo también se conoce como clave de partición (oun atributo hash), que DynamoDB puede utilizar para particionar elementos para que el acceso sea másrápido. Una tabla también puede tener una clave principal compuesta, que contiene dos atributos. El primeratributo es la clave de partición y el segundo es una clave de ordenación (también conocida como atributode rango). En una tabla con una clave principal compuesta, puede haber dos elementos que tengan elmismo valor de clave de partición, pero no pueden tener también el mismo valor de clave de ordenación.La tabla Weather tiene una clave principal compuesta.

Un índice secundario local tiene la misma clave de partición que la propia tabla, pero este tipo de índicepuede tener una clave de ordenación diferente. Un índice secundario global puede tener una clave departición y una clave de ordenación que son diferentes a la tabla en sí.

Por ejemplo, ya puede utilizar la clave principal para obtener acceso a elementos Weather por CityID.Para obtener acceso a los elementos Weather por State, puede crear un índice secundario local quetenga una clave de partición de CityID (debe ser la misma que la tabla) y una clave de ordenación deState. Para obtener acceso a los elementos Weather por City, puede crear un índice secundario globalque tenga una clave de partición de City y una clave de ordenación de Date.

Solo puede crear índices secundarios locales mientras está creando una tabla. Dado que la tabla Weatherya existe, no puede añadirle cualquier índice secundario local. Sin embargo, puede añadir índicessecundarios globales. Añada uno ahora para practicar.

Note

La creación de índices secundarios puede producir cargos adicionales en su cuenta de AWS.

1. Cree un archivo denominado weather-global-index.json con el siguiente contenido.

[ { "Create": { "IndexName": "weather-global-index", "KeySchema": [ { "AttributeName": "City", "KeyType": "HASH" }, { "AttributeName": "Date", "KeyType": "RANGE" } ], "Projection": { "ProjectionType": "INCLUDE", "NonKeyAttributes": [ "State", "Conditions",

399

AWS Cloud9 Guía del usuarioPaso 5: Crear un índice secundario global

"Temperatures" ] }, "ProvisionedThroughput": { "ReadCapacityUnits": 5, "WriteCapacityUnits": 5 } } }]

En este código:• El nombre del índice secundario global es weather-global-index.• El atributo City es la clave de partición (atributo hash) y el atributo Date es la clave de ordenación

(atributo de rango).• Projection define los atributos que se van a recuperar de forma predeterminada (además del

atributo hash y cualquier atributo de rango) por cada elemento que coincida con una búsqueda detabla que utilice este índice. En este ejemplo, se recuperan los atributosState, Conditions, HighF(parte de Temperatures) y LowF ( Temperatures) (así como los atributos City y Date) para cadaelemento coincidente.

• Al igual que las tablas, un índice secundario global debe definir su configuración de desempeñoaprovisionado.

• La configuración de IndexName, KeySchema, Projection y ProvisionedThroughput debeestar incluida en un objeto Create, que define el índice secundario global que se va a crear alejecutar el comando update-table de DynamoDB en el siguiente paso.

2. Ejecute el comando update-table de DynamoDB.

aws dynamodb update-table \--table-name Weather \--attribute-definitions \ AttributeName=City,AttributeType=S AttributeName=Date,AttributeType=S \--global-secondary-index-updates file://weather-global-index.json

En este comando:• --table-name es el nombre de la tabla que se va a actualizar.• --attribute-definitions son los atributos que se van a incluir en el índice. La clave de partición

siempre aparece primero y cualquier clave de ordenación aparece siempre en segundo lugar.• --global-secondary-index-updates es la ruta al archivo que define el índice secundario

global.

Si este comando se ejecuta correctamente, se muestra información resumida sobre el nuevo índicesecundario global que se está creando. Para confirmar que el índice secundario global se ha creadocorrectamente, ejecute el comando describe-table de DynamoDB, especificando el nombre de latabla (--table-name).


Cuando el índice secundario global se haya creado correctamente, el valor de TableStatus cambia deUPDATING a ACTIVE y el valor de IndexStatus cambia de CREATING a ACTIVE. No siga realizandolos pasos hasta que el índice secundario global se haya creado correctamente. Esto puede tardar variosminutos.

400

AWS Cloud9 Guía del usuarioPaso 6: Obtener elementos de la tabla

Paso 6: Obtener elementos de la tablaExisten muchas formas de obtener elementos de las tablas. En este paso, se obtienen elementos mediantela clave principal de la tabla, mediante otros atributos de la tabla y utilizando el índice secundario global.

Para obtener un solo elemento de una tabla en función del valorde la clave principal del elementoSi conoce el valor de la clave principal del elemento, puede obtener el elemento coincidente ejecutandoel comando get-item , scan o query de DynamoDB. A continuación, se muestran las principalesdiferencias en estos comandos:

• get-item devuelve un conjunto de atributos del elemento con la clave principal especificada.• scan devuelve uno o más elementos y atributos de elementos obteniendo acceso a todos los

elementos de una tabla o un índice secundario.• query busca elementos según los valores de clave principal. Puede consultar cualquier tabla o índice

secundario que cuente con una clave principal compuesta (una clave de partición y una clave deordenación).

En este ejemplo, así es cómo se utiliza cada uno de estos comandos para obtener el elemento quecontiene el valor del atributo CityID de 1 y el valor del atributo Date de 2017-04-12.

1. Para ejecutar el comando get-item de DynamoDB, especifique el nombre de la tabla (--table-name), el valor de clave principal (--key) y los valores de los atributos del elemento que se vaa mostrar (--projection-expression). Dado que Date es una palabra clave reservada enDynamoDB, también debe proporcionar un alias para el valor del atributo Date (--expression-attribute-names). (State también es una palabra clave reservada, por lo que verá un aliasproporcionado para él en pasos posteriores).

aws dynamodb get-item \--table-name Weather \--key '{ "CityID": { "N": "1" }, "Date": { "S": "2017-04-12" } }' \--projection-expression \ "City, #D, Conditions, Temperatures.HighF, Temperatures.LowF" \--expression-attribute-names '{ "#D": "Date" }'

En este y otros comandos, para ver todos los atributos del elemento, no incluya --projection-expression. En este ejemplo, dado que no está incluyendo --projection-expression, tampocoes necesario incluir --expression-attribute-names.

aws dynamodb get-item \--table-name Weather \--key '{ "CityID": { "N": "1" }, "Date": { "S": "2017-04-12" } }'

2. Para ejecutar el comando scan de DynamoDB, especifique:• El nombre de la tabla (--table-name).• La búsqueda que se va a realizar (--filter-expression).• Los criterios de búsqueda que se van a utilizar (--expression-attribute-values).• Los tipos de atributos que se van a mostrar del elemento coincidente (--select).• Los valores de atributos del elemento que se va a mostrar (--projection-expression).• Si alguno de los atributos utiliza palabras reservadas de DynamoDB, los alias de esos atributos (--expression-attribute-names).

401


aws dynamodb scan \--table-name Weather \--filter-expression "(CityID = :cityID) and (#D = :date)" \--expression-attribute-values \ '{ ":cityID": { "N": "1" }, ":date": { "S": "2017-04-12" } }' \--select SPECIFIC_ATTRIBUTES \--projection-expression \ "City, #D, Conditions, Temperatures.HighF, Temperatures.LowF" \--expression-attribute-names '{ "#D": "Date" }'

3. Para ejecutar el comando query de DynamoDB, especifique:• El nombre de la tabla (--table-name).• La búsqueda que se va a realizar (--key-condition-expression).• Los valores de los atributos que se van a utilizar en la búsqueda (--expression-attribute-values).

• Los tipos de atributos que se van a mostrar del elemento coincidente (--select).• Los valores de atributos del elemento que se va a mostrar (--projection-expression).• Si alguno de los atributos utiliza palabras reservadas de DynamoDB, los alias de esos atributos (--expression-attribute-names).

aws dynamodb query \--table-name Weather \--key-condition-expression "(CityID = :cityID) and (#D = :date)" \--expression-attribute-values \ '{ ":cityID": { "N": "1" }, ":date": { "S": "2017-04-12" } }' \--select SPECIFIC_ATTRIBUTES \--projection-expression \ "City, #D, Conditions, Temperatures.HighF, Temperatures.LowF" \--expression-attribute-names '{ "#D": "Date" }'

Fíjese en que el comando scan ha tenido que analizar los 9 elementos para obtener el resultado,mientras que el comando query solo ha tenido que analizar 1 elemento.

Para obtener varios elementos de una tabla en función de losvalores de la clave principal de los elementosSi conoce los valores de la clave principal de los elementos, puede obtener los elementos coincidentesejecutando el comando batch-get-item de DynamoDB. En este ejemplo, se muestra cómo seobtienen los elementos que contienen el valor del atributo CityID de 3 y los valores del atributo Date de2017-04-13 o 2017-04-14.

Ejecute el comando batch-get-item de DynamoDB, especificando la ruta a un archivo que describe loselementos que hay que obtener (--request-items).

aws dynamodb batch-get-item --request-items file://batch-get-item.json

Para este ejemplo, el código del archivo batch-get-item.json especifica que se deben buscar enla tabla Weather los elementos con un CityID de 3 y un Date de 2017-04-13 o 2017-04-14. Paracada elemento encontrado, se muestran los valores de atributo de CityState, Date y HighF (parte deTemperatures), si existen.

{ "Weather" : { "Keys": [

402


{ "CityID": { "N": "3" }, "Date": { "S": "2017-04-13" } }, { "CityID": { "N": "3" }, "Date": { "S": "2017-04-14" } } ], "ProjectionExpression": "City, #S, #D, Temperatures.HighF", "ExpressionAttributeNames": { "#S": "State", "#D": "Date" } }}

Para obtener todos los elementos coincidentes de una tablaSi conoce algo sobre los valores de los atributos de la tabla, puede obtener los elementos coincidentesejecutando el comando scan de DynamoDB. En este ejemplo, se muestra cómo se obtienen lasfechas cuando el valor del atributo Conditions contiene Sunny y el valor del atributo HighF (parte deTemperatures) es mayor que 53.

Ejecute el comando scan de DynamoDB, especificando:

• El nombre de la tabla (--table-name).• La búsqueda que se va a realizar (--filter-expression).• Los criterios de búsqueda que se van a utilizar (--expression-attribute-values).• Los tipos de atributos que se van a mostrar del elemento coincidente (--select).• Los valores de atributos del elemento que se va a mostrar (--projection-expression).• Si alguno de los atributos utiliza palabras reservadas de DynamoDB, los alias de esos atributos (--expression-attribute-names).

aws dynamodb scan \--table-name Weather \--filter-expression \ "(contains (Conditions, :sun)) and (Temperatures.HighF > :h)" \--expression-attribute-values \ '{ ":sun": { "S" : "Sunny" }, ":h": { "N" : "53" } }' \--select SPECIFIC_ATTRIBUTES \--projection-expression "City, #S, #D, Conditions, Temperatures.HighF" \--expression-attribute-names '{ "#S": "State", "#D": "Date" }'

Para obtener todos los elementos coincidentes de un índicesecundario globalPara buscar mediante un índice secundario global, utilice el comando query de DynamoDB. En esteejemplo, se muestra cómo se utiliza el índice secundario weather-global-index para obtener lascondiciones de la previsión en ciudades con el nombre Portland para las fechas 2017-04-13 y2017-04-14.

Ejecute el comando query de DynamoDB, especificando:

• El nombre de la tabla (--table-name).• El nombre del índice secundario global (--index-name).• La búsqueda que se va a realizar (--key-condition-expression).

403


• Los valores de los atributos que se van a utilizar en la búsqueda (--expression-attribute-values).

• Los tipos de atributos que se van a mostrar del elemento coincidente (--select).• Si alguno de los atributos utiliza palabras reservadas de DynamoDB, los alias de esos atributos (--expression-attribute-names).

aws dynamodb query \--table-name Weather \--index-name weather-global-index \--key-condition-expression "(City = :city) and (#D between :date1 and :date2)" \--expression-attribute-values \ '{ ":city": { "S" : "Portland" }, ":date1": { "S": "2017-04-13" }, ":date2": { "S": "2017-04-14" } }' \--select SPECIFIC_ATTRIBUTES \--projection-expression "City, #S, #D, Conditions, Temperatures.HighF" \--expression-attribute-names '{ "#S": "State", "#D": "Date" }'

Paso 7: EliminaciónPara evitar que se efectúen cargos continuos en su cuenta de AWS después de que haya terminado deusar este ejemplo, elimine la tabla. Al eliminar la tabla, también se elimina el índice secundario global.También debe eliminar su entorno.

Para eliminar la tabla, ejecute el comando delete-table de DynamoDB, especificando el nombre de latabla (--table-name).

aws dynamodb delete-table --table-name Weather

Si el comando se ejecuta correctamente, se muestra información sobre la tabla, incluido el valor deTableStatus de DELETING.

Para confirmar que la tabla se haya eliminado correctamente, ejecute el comando describe-table deDynamoDB, especificando el nombre de la tabla (--table-name).


Si la tabla se elimina correctamente, se muestra un mensaje que contiene la frase Requested resourcenot found.

Para eliminar su entorno, consulte la sección sobre eliminación de un entorno (p. 103).

Ejemplo de AWS CDK para AWS Cloud9En este ejemplo se muestra cómo trabajar con el Kit de desarrollo de la nube de AWS (AWS CDK) enun entorno de desarrollo de AWS Cloud9. El AWS CDK es un conjunto de herramientas de softwarey bibliotecas que los desarrolladores pueden utilizar para crear modelos de componentes de lainfraestructura de AWS como código.

El AWS CDK incluye AWS Construct Library, que puede utilizar para resolver rápidamente muchas tareasen AWS. Por ejemplo, puede utilizar la construcción Fleet para implementar código de forma completay segura en una flota de hosts. Puede crear sus propias construcciones para crear modelos de diversoselementos de sus arquitecturas, compartirlos con otras personas o publicarlos en la comunidad. Paraobtener más información, consulte la Guía del desarrollador del kit de desarrollo en la nube de AWS.

404

https://docs.aws.amazon.com/cdk/latest/guide/


La creación de esta muestra puede generar cargos en su cuenta de AWS. Por ejemplo, posibles cargospor servicios como Amazon EC2, Amazon SNS y Amazon SQS. Para obtener más información, consultePrecios de Amazon EC2, Precios de Amazon SNS y Precios de Amazon SQS.

Temas• Requisitos previos (p. 405)• Paso 1: Instalar las herramientas necesarias (p. 405)• Paso 2: Añadir el código (p. 407)• Paso 3: Ejecutar el código (p. 409)• Paso 4: Limpieza (p. 411)




Paso 1: Instalar las herramientas necesariasEn este paso, instalará todas las herramientas en el entorno que necesita el AWS CDK para ejecutar unamuestra escrita en el lenguaje de programación TypeScript:

1. Node Version Manager (p. 405) o nvm, que se utiliza para instalar Node.js más adelante.2. Node.js (p. 406), que es necesario para la muestra y contiene el administrador de paquetes de nodo o

npm, que se utiliza para instalar TypeScript y el AWS CDK más adelante.3. TypeScript (p. 406), que lo requiere esta muestra. (El AWS CDK también ofrece compatibilidad con

otros lenguajes de programación).4. El CDK de AWS (p. 407).

Paso 1.1: Instalar Node Version Manager (nvm)1. En una sesión del terminal de AWS Cloud9 IDE, asegúrese de que las últimas actualizaciones de

seguridad y correcciones de errores están instaladas. Para ello, ejecute el comando yum update (para Amazon Linux) o apt update (para Ubuntu Server). (Para iniciar una nueva sesión delterminal, en la barra de menús, seleccione Window [Ventana], New Terminal [Nuevo terminal]).

En Amazon Linux:

sudo yum -y update

Para Ubuntu Server:

sudo apt update

405


https://aws.amazon.com/sns/pricing/

https://aws.amazon.com/sqs/pricing/

AWS Cloud9 Guía del usuarioPaso 1: Instalar las herramientas necesarias

2. Confirme si nvm ya está instalado. Para ello, ejecute el comando nvm con la opción --version.

nvm --version

Si se ejecuta correctamente, el resultado contiene el número de versión de nvm, en cuyo caso puedeir directamente a Paso 1.2: Instalar Node.js (p. 406).

3. Descargue e instale nvm. Para ello, ejecute el siguiente comando.

curl -o- https://raw.githubusercontent.com/creationix/nvm/v0.33.0/install.sh | bash

4. Comience a utilizar nvm. Puede cerrar la sesión del terminal e iniciarla de nuevo, o bien cargar elarchivo ~/.bashrc que contiene los comandos para cargar nvm.

. ~/.bashrc

Paso 1.2: Instalar Node.js1. Confirme si ya tiene instalado Node.js. Si lo hace, confirme que la versión instalada es 8.12.0 o

superior. Esta muestra se ha probado con Node.js 8.12.0. Para comprobarlo, con la sesión delterminal aún abierta en el IDE, ejecute el comando node con la opción --version.

node --version

Si ha instalado Node.js, la salida contendrá el número de versión. Si el número de versión es v8.12.0,vaya directamente a Paso 1.3: Instalar TypeScript (p. 406).

2. Instale Node.js 8.12.0 ejecutando el comando nvm con la acción install y el número de versión,tal y como se indica a continuación.

nvm install v8.12.0

3. Empiece a utilizar Node.js 8.12.0. Para ello, ejecute el comando nvm junto con la acción alias, elnúmero de versión para el alias y la versión que se va a utilizar para dicho alias, tal y como se indica acontinuación.

nvm alias default 8.12.0

Note

El comando anterior establece Node.js 8.12.0 como la versión predeterminada de Node.js.También puede ejecutar el comando nvm junto con la acción use , en lugar de alias (por ejemplo, nvm use 8.12.0 ). Sin embargo, la acción use provoca que esa versión deNode.js solo se active mientras que la sesión del terminal actual se está ejecutando.

4. Para confirmar que está utilizando 8.12.0 Node.js, vuelva a ejecutar el comando node --version .Si la versión correcta está instalada, la salida contendrá la versión v8.12.0.

Paso 1.3: Instalar TypeScript1. Confirme si ya ha instalado TypeScript. Para ello, en la sesión del terminal aún abierta en el IDE,

ejecute el compilador TypeScript de la línea de comandos con la opción --version.

tsc --version

406

AWS Cloud9 Guía del usuarioPaso 2: Añadir el código

Si ha instalado TypeScript, la salida contendrá el número de versión de TypeScript. Si TypeScript estáinstalado, continúe en Paso 1.4: Instalar el AWS CDK (p. 407).

2. Instale TypeScript. Para ello, ejecute el comando npm con la acción install, la opción -g y elnombre del paquete de TypeScript. De este modo se instala TypeScript como un paquete global en elentorno.

npm install -g typescript

3. Confirme que TypeScript se ha instalado. Para ello, ejecute el compilador TypeScript de la línea decomandos con la opción --version.

tsc --version

Si ha instalado TypeScript, la salida contendrá el número de versión de TypeScript.

Paso 1.4: Instalar el AWS CDK1. Confirme si ya ha instalado el AWS CDK. Para ello, con la sesión del terminal aún abierta en el IDE,

ejecute el comando cdk con la opción --version.

cdk --version

Si el AWS CDK está instalado, el resultado contendrá el AWS CDK y los números de compilación.Vaya a Paso 2: Añadir el código (p. 407).

2. Instale el AWS CDK ejecutando el comando npm junto con la acción install, el nombre delpaquete del AWS CDK que se instalará y la opción -g para instalar el paquete de manera global en elentorno.

npm install -g aws-cdk

3. Confirme que el AWS CDK se ha instalado y que se hace referencia a él de forma correcta. Para ello,ejecute el comando cdk con la opción --version.

cdk --version

Si se ejecuta correctamente, se muestran los números de compilación y versión del AWS CDK.

Paso 2: Añadir el códigoEn este paso, se crea un proyecto de TypeScript de muestra que contiene todo el código fuente necesariopara que el AWS CDK implemente una pila de AWS CloudFormation. Esta pila crea un tema de AmazonSNS y una cola de Amazon SQS en su cuenta de AWS y, a continuación, suscribe la cola al tema.

1. Con la sesión del terminal aún abierta en el IDE, cree un directorio para almacenar el código fuente delproyecto, por ejemplo, un directorio ~/environment/hello-cdk de su entorno. Luego, cambie aese directorio.

rm -rf ~/environment/hello-cdk # Remove this directory if it already exists.mkdir ~/environment/hello-cdk # Create the directory.cd ~/environment/hello-cdk # Switch to the directory.

407


2. Configure el directorio como un proyecto de lenguaje TypeScript para el AWS CDK. Para ello, ejecuteel comando cdk con la acción init , la plantilla sample-app y la opción --language junto conel nombre del lenguaje de programación.

cdk init sample-app --language typescript

De esta forma, se crean los siguientes archivos y subdirectorios en el directorio.

• Un subdirectorio .git y un archivo.gitignore ocultos, que hacen que el proyecto sea compatiblecon herramientas de control de código fuente como Git.

• Un subdirectorio lib, que incluye un archivo hello-cdk-stack.ts. Este archivo contiene elcódigo de la pila del AWS CDK. Este código se describe en el siguiente paso de este procedimiento.

• Un subdirectorio bin, que incluye un archivo hello-cdk.ts. Este archivo contiene el punto deentrada de la aplicación del AWS CDK.

• Un subdirectorio node_modules, que contiene los paquetes de código de apoyo que la aplicación yla pila pueden utilizar según sea necesario.

• Un archivo .npmignore oculto, que enumera los tipos de subdirectorios y los archivos que npm nonecesita al compilar el código.

• Un archivocdk.json, que contiene la información para poder ejecutar el comando cdk másfácilmente.

• Un archivo package-lock.json, que contiene información que npm puede utilizar para reducirposibles errores de compilación y ejecución.

• Un archivo package.json, que contiene información para poder ejecutar el comando npm másfácilmente y con posiblemente menos errores de compilación y ejecución.

• Un archivo README.md, que enumera comandos útiles que puede ejecutar con npm y el AWSCDK.

• Un archivo tsconfig.json, que contiene información para poder ejecutar el comando tsc másfácilmente y con posiblemente menos errores de compilación y ejecución.

3. En la ventana Environment (Entorno), abra el archivo lib/hello-cdk-stack.ts y examine elsiguiente código en ese archivo.

import sns = require('@aws-cdk/aws-sns');import sqs = require('@aws-cdk/aws-sqs');import cdk = require('@aws-cdk/cdk');

export class HelloCdkStack extends cdk.Stack { constructor(parent: cdk.App, name: string, props?: cdk.StackProps) { super(parent, name, props);

const queue = new sqs.Queue(this, 'HelloCdkQueue', { visibilityTimeoutSec: 300 });

const topic = new sns.Topic(this, 'HelloCdkTopic');

topic.subscribeQueue(queue); }}

• Las clases Stack, App, StackProps, Queue y Topic representan una pila de AWSCloudFormation y sus propiedades, un programa ejecutable, una cola de Amazon SQS y un temade Amazon SNS, respectivamente.

• La clase HelloCdkStack representa la pila de AWS CloudFormation para esta aplicación. Estapila contiene la nueva cola de Amazon SQS y el tema de Amazon SNS para esta aplicación.

408

AWS Cloud9 Guía del usuarioPaso 3: Ejecutar el código

4. En la ventana Environment (Entorno), abra el archivo bin/hello-cdk.ts y examine el siguientecódigo en ese archivo.

#!/usr/bin/env nodeimport cdk = require('@aws-cdk/cdk');import { HelloCdkStack } from '../lib/hello-cdk-stack';

const app = new cdk.App();new HelloCdkStack(app, 'HelloCdkStack');app.run();

Este código carga, crea una instancia y luego ejecuta la clase HelloCdkStack a partir del archivolib/hello-cdk-stack.ts.

5. Use npm para ejecutar el compilador de TypeScript para comprobar si hay errores de codificación y,a continuación, habilite el AWS CDK para ejecutar el archivo bin/hello-cdk.js del proyecto. Paraello, desde el directorio raíz del proyecto, ejecute el comando npm con la acción run, especificando elvalor del comando build en el archivo package.json, tal y como se indica a continuación.

npm run build

El comando anterior ejecuta el compilador TypeScript, lo que añade los archivos de soporte bin/hello-cdk.d.ts y lib/hello-cdk-stack.d.ts. El compilador también transpone los archivoshello-cdk-stack.ts y hello-cdk.ts en los archivos hello-cdk-stack.js y hello-cdk.js.

Paso 3: Ejecutar el códigoEn este paso, le indica al AWS CDK que cree una plantilla de pila de AWS CloudFormation basada en elcódigo del archivo bin/hello-cdk.js. A continuación, indique al AWS CDK que implemente la pila, loque crea el tema de Amazon SNS y la cola de Amazon SQS y, a continuación, suscribe la cola al tema.Luego, confirme que el tema y la cola se han implementado correctamente enviando un mensaje del temaa la cola.

1. Haga que el AWS CDK cree la plantilla de pila de AWS CloudFormation. Para ello, con la sesión delterminal aún abierta en el IDE, desde el directorio raíz del proyecto, ejecute el comando cdk con laacción synth y el nombre de la pila.

cdk synth HelloCdkStack

Si se ejecuta correctamente, la salida muestra la sección Resources de la plantilla de pila de AWSCloudFormation.

2. La primera vez que implemente una aplicación del AWS CDK en un entorno para una combinaciónespecífica de cuenta de AWS y región de AWS, debe instalar una pila de arranque. Esta pila incluyediferentes recursos que el AWS CDK necesita para completar sus diversas operaciones. Por ejemplo,esta pila incluye un bucket de Amazon S3 que el AWS CDK utiliza para almacenar plantillas y recursosdurante los procesos de implementación. Para instalar la pila de arranque, ejecute el comando cdk con la acción bootstrap .

cdk bootstrap

3. Haga que el AWS CDK ejecute la plantilla de pila de AWS CloudFormation para implementar la pila.Para ello, desde el directorio raíz del proyecto, ejecute el comando cdk con la acción deploy y elnombre de la pila.

409


cdk deploy HelloCdkStack

Si se ejecuta correctamente, la salida muestra que la pila HelloCdkStack se ha implementado sinerrores.

Note

Si el resultado muestra un mensaje en el que se indica que la pila no define un entorno yque las credenciales de AWS no se han podido obtener de ubicaciones estándar, o bienque no hay ninguna región configurada, asegúrese de que sus credenciales de AWS esténestablecidas correctamente en el IDE y, a continuación, vuelva a ejecutar el comando cdkdeploy . Para obtener más información, consulte Llamar a los servicios de AWS desde unentorno en AWS Cloud9 (p. 76).

4. Para confirmar que el tema de Amazon SNS y la cola de Amazon SQS se han implementadocorrectamente, envíe un mensaje al tema y, luego, compruebe la cola del mensaje recibido. Paraello, puede utilizar una herramienta como la AWS Command Line Interface (AWS CLI) o el aws-shell.Para obtener más información sobre estas herramientas, consulte Muestra de AWS Command LineInterface y el aws-shell para AWS Cloud9 (p. 379).

Por ejemplo, para enviar un mensaje al tema, con la sesión del terminal aún abierta en el IDE, usela AWS CLI para ejecutar el comando Amazon SNS publish , especificando el asunto y cuerpo delmensaje, la región de AWS del tema y el nombre de recurso de Amazon (ARN) del tema.

aws sns publish --subject "Hello from the AWS CDK" --message "This is a message from the AWS CDK." --topic-arn arn:aws:sns:us-east-2:123456789012:HelloCdkStack-HelloCdkTopic1A234567-8BCD9EFGHIJ0K

En el comando anterior, reemplace arn:aws:sns:us-east-2:123456789012:HelloCdkStack-HelloCdkTopic1A234567-8BCD9EFGHIJ0K por el ARN que AWS CloudFormation asigna al tema.Para obtener el ID, puede ejecutar el comando de list-topics de Amazon SNS.

aws sns list-topics --output table --query 'Topics[*].TopicArn'

Si se ejecuta correctamente, la salida del comando publish muestra el valor MessageId delmensaje que se publicó.

Para comprobar la cola del mensaje recibido, ejecute el comando receive-message de AmazonSQS especificando la URL de la cola.

aws sqs receive-message --queue-url https://queue.amazonaws.com/123456789012/HelloCdkStack-HelloCdkQueue1A234567-8BCD9EFGHIJ0K

En el comando anterior, reemplace https://queue.amazonaws.com/123456789012/HelloCdkStack-HelloCdkQueue1A234567-8BCD9EFGHIJ0K por el ARN que AWSCloudFormation asigna a la cola. Para obtener la URL, puede ejecutar el comando de list-queuesde Amazon SQS.

aws sqs list-queues --output table --query 'QueueUrls[*]'

Si se ejecuta correctamente, la salida del comando receive-message muestra información delmensaje que se recibió.

410


Paso 4: LimpiezaPara evitar que se realicen cargos continuos en su cuenta de AWS después de que haya terminado deusar esta muestra, elimine la pila de AWS CloudFormation. Esta acción elimina el tema de Amazon SNS yla cola de Amazon SQS. También debe eliminar el entorno.

Paso 4.1: Eliminar la pilaCon la sesión del terminal aún abierta en el IDE, desde el directorio raíz del proyecto, ejecute el comandocdk con la acción destroy y el nombre de la pila.

cdk destroy HelloCdkStack

Cuando se le pida que elimine la pila, escriba y y, a continuación, pulse Enter.

Si se ejecuta correctamente, la salida muestra que la pila HelloCdkStack se ha eliminado sin errores.

Paso 4.2: Eliminar el entornoPara eliminar el entorno, consulte Eliminación de un entorno en AWS Cloud9 (p. 103).

Ejemplo de LAMP para AWS Cloud9Este ejemplo le permite configurar y ejecutar LAMP (Linux, Apache HTTP Server, MySQL y PHP) en unentorno de desarrollo de AWS Cloud9.

La creación de esta muestra puede generar cargos en su cuenta de AWS. Entre ellos, se incluyen posiblescargos por servicios como Amazon Elastic Compute Cloud (Amazon EC2). Para obtener más información,consulte Precios de Amazon EC2.

Temas• Requisitos previos (p. 411)• Paso 1: Instalar las herramientas (p. 412)• Paso 2: Configurar MySQL (p. 413)• Paso 3: Configurar un sitio web (p. 414)• Paso 4: Limpieza (p. 417)




411


AWS Cloud9 Guía del usuarioPaso 1: Instalar las herramientas

Paso 1: Instalar las herramientasEn este paso, instalará las siguientes herramientas:

• Apache HTTP Server, un servidor web host.• PHP, un lenguaje de scripting especialmente indicado para el desarrollo web y que se puede incluir en

HTML.• MySQL, un sistema de administración de bases de datos.

Debe finalizar este paso iniciando Apache HTTP Server y después MySQL.

1. Asegúrese de que las últimas actualizaciones de seguridad y correcciones de errores están instaladasen la instancia. Para ello, en una sesión de terminal del AWS Cloud9 IDE, ejecute el comando yumupdate para Amazon Linux o apt update para Ubuntu Server. (Para iniciar una nueva sesión delterminal, en la barra de menús, seleccione Window [Ventana], New Terminal [Nuevo terminal]).

En Amazon Linux:

sudo yum -y update

Para Ubuntu Server:

sudo apt -y update

2. Compruebe si Apache HTTP Server ya está instalado. Para ello, ejecute el comando httpd -v (paraAmazon Linux) o apache2 -v (para Ubuntu Server).

Si está instalado, el resultado contendrá el número de versión de Apache HTTP Server.

Si aparece un error, instale Apache HTTP Server ejecutando el comando install .

En Amazon Linux:

sudo yum install -y httpd24

Para Ubuntu Server:

sudo apt install -y apache2

3. Confirme si PHP ya está instalado ejecutando el comando php -v .

Si es así, el resultado contendrá el número de versión de PHP.

Si aparece un error, instale PHP ejecutando el comando install .

En Amazon Linux:

sudo yum install -y php56

Para Ubuntu Server:

sudo apt install -y php libapache2-mod-php php-xml

4. Confirme si MySQL ya está instalado ejecutando el comando mysql --version .412

AWS Cloud9 Guía del usuarioPaso 2: Configurar MySQL

Si ya está instalado, el resultado contendrá el número de versión de MySQL.

Si aparece un error, instale MySQL ejecutando el comando install .

En Amazon Linux:

sudo yum install -y mysql-server

Para Ubuntu Server:

sudo apt install -y mysql-server

5. Después de instalar Apache HTTP Server, PHP y MySQL, inicie Apache HTTP Server y, acontinuación, confirme que se ha iniciado ejecutando el siguiente comando.

Para Amazon Linux (es posible que tenga que ejecutar el comando dos veces):

sudo service httpd start && sudo service httpd status

Para Ubuntu Server (para volver a la línea de comandos, pulse q):

sudo service apache2 start && sudo service apache2 status

6. Inicie MySQL y, a continuación, confirme que se ha iniciado ejecutando el siguiente comando.

En Amazon Linux:

sudo service mysqld start && sudo service mysqld status


sudo service mysql start && sudo service mysql status

Paso 2: Configurar MySQLEn este paso, configurará MySQL para seguir las prácticas de seguridad recomendadas de MySQL.Estas prácticas de seguridad recomendadas incluyen configurar una contraseña para las cuentas raíz,eliminar las cuentas raíz que están accesibles desde fuera del host local, eliminar las cuentas de usuariosanónimos, eliminar la base de datos de prueba y eliminar los privilegios que permiten a cualquier usuarioobtener acceso a las bases de datos con nombres que comienzan por test_.

Para terminar este paso, practique el inicio y la salida del cliente de línea de comandos de MySQL.

1. Implemente las prácticas de seguridad recomendadas de MySQL para la instalación de MySQLejecutando el siguiente comando en una sesión de terminal del AWS Cloud9 IDE.

sudo mysql_secure_installation

2. Cuando se le solicite, responda a las siguientes preguntas.

En Amazon Linux:

1. Escribir la contraseña de la cuenta raíz actual (pulse Intro para ninguna): pulse Enter (si no deseaespecificar una contraseña).

413

AWS Cloud9 Guía del usuarioPaso 3: Configurar un sitio web

2. Establecer una contraseña raíz: escriba Y y, a continuación, pulse Enter.3. Nueva contraseña: escriba una contraseña y pulse Enter.4. Volver a escribir la nueva contraseña: escriba de nuevo la contraseña y, a continuación, pulse

Enter. (Asegúrese de almacenar la contraseña en un lugar seguro para usarla más adelante).5. Eliminar usuarios anónimos: escriba Y y, a continuación, pulse Enter.6. Prohibir el inicio de sesión en la cuenta raíz de forma remota: escriba Y y, a continuación, pulse

Enter.7. Eliminar la base de datos de prueba y el acceso a ella: escriba Y y, a continuación, pulse Enter.8. Volver a cargar ahora las tablas de privilegios: escriba Y y, a continuación, pulse Enter.

Para Ubuntu Server:

1. ¿Desea configurar el complemento VALIDATE PASSWORD?: escriba y y, a continuación, pulseEnter.

2. Existen tres niveles de política de validación de contraseñas: escriba 0, 1 o 2 y, a continuación,pulse Enter.

3. Nueva contraseña: escriba una contraseña y pulse Enter.4. Volver a escribir la nueva contraseña: escriba de nuevo la contraseña y, a continuación, pulse

Enter. (Asegúrese de almacenar la contraseña en un lugar seguro para usarla más adelante).5. ¿Desea continuar con la contraseña proporcionada?: escriba y y, a continuación, pulse Enter.6. Eliminar usuarios anónimos: escriba y y, a continuación, pulse Enter.7. Prohibir el inicio de sesión en la cuenta raíz de forma remota: escriba y y, a continuación, pulse

Enter.8. Eliminar la base de datos de prueba y el acceso a ella: escriba y y, a continuación, pulse Enter.9. Volver a cargar ahora las tablas de privilegios: escriba y y, a continuación, pulse Enter.

3. Para interactuar directamente con MySQL, inicie el cliente de línea de comandos de MySQL comousuario raíz ejecutando el siguiente comando. Cuando se le solicite, escriba la contraseña del usuarioraíz que ha definido anteriormente y, a continuación, pulse Enter. (El símbolo cambia a mysql>mientras se encuentra en el cliente de línea de comandos de MySQL).

sudo mysql -uroot -p

4. Para salir del cliente de línea de comandos de MySQL, ejecute el siguiente comando. (El símbolocambia a $).

exit;

Paso 3: Configurar un sitio webEn este paso, configurará la raíz del sitio web predeterminado para Apache HTTP Server con lospropietarios y los permisos de acceso recomendados. Seguidamente, creará una página web basada enPHP dentro de esa raíz del sitio web predeterminado.

A continuación, habilitará el tráfico web entrante para ver esa página web configurando el grupo deseguridad de Amazon EC2 y la lista de control de acceso de red (ACL de red) en Amazon Virtual PrivateCloud (Amazon VPC) que están asociados a este entorno de EC2. Cada entorno de EC2 debe estarasociado a un grupo de seguridad de Amazon EC2 y a una ACL de red de Amazon VPC. Sin embargo,aunque la ACL de red predeterminada de una cuenta de AWS permite todo el tráfico de entrada y salidadel entorno, el grupo de seguridad predeterminado permite únicamente el tráfico entrante mediante SSH através del puerto 22. Para obtener más información, consulte the section called “Configuración de AmazonVPC” (p. 501).

414


Para finalizar este paso, debe ver correctamente la página web desde fuera del AWS Cloud9 IDE.

1. Configure la raíz del sitio web predeterminado para Apache HTTP Server (/var/www/html) con lospropietarios y los permisos de acceso recomendados. Para ello, ejecute los seis comandos siguientes,de uno en uno, en el orden que se indica a continuación, desde una sesión de terminal del AWSCloud9 IDE. Para entender lo que hace cada comando, lea la información que aparece detrás delcomando # en cada comando.

En Amazon Linux:

sudo groupadd web-content # Create a group named web-content.

sudo usermod -G web-content -a ec2-user # Add the user ec2-user (your default user for this environment) to the group web-content.

sudo usermod -G web-content -a apache # Add the user apache (Apache HTTP Server) to the group web-content.

sudo chown -R ec2-user:web-content /var/www/html # Change the owner of /var/www/html and its files to user ec2-user and group web-content.

sudo find /var/www/html -type f -exec chmod u=rw,g=rx,o=rx {} \; # Change all file permissions within /var/www/html to user read/write, group read-only, and others read/execute.

sudo find /var/www/html -type d -exec chmod u=rwx,g=rx,o=rx {} \; # Change /var/www/html directory permissions to user read/write/execute, group read/execute, and others read/execute.

Para Ubuntu Server:


sudo usermod -G web-content -a ubuntu # Add the user ubuntu (your default user for this environment) to the group web-content.

sudo usermod -G web-content -a www-data # Add the user www-data (Apache HTTP Server) to the group web-content.

sudo chown -R ubuntu:web-content /var/www/html # Change the owner of /var/www/html and its files to user ubuntu and group web-content.

sudo find /var/www/html -type f -exec chmod u=rw,g=rx,o=rx {} \; # Change all file permissions within /var/www/html to user read/write, group read-only, and others read/execute.

sudo find /var/www/html -type d -exec chmod u=rwx,g=rx,o=rx {} \; # Change /var/www/html directory permissions to user read/write/execute, group read/execute, and others read/execute.

2. Cree una página web basada en PHP denominada index.php en la carpeta raíz del sitio webpredeterminado para Apache HTTP Server (que es /var/www/html) ejecutando el siguientecomando.

En Amazon Linux:

sudo touch /var/www/html/index.php && sudo chown -R ec2-user:web-content /var/www/html/index.php && sudo chmod u=rw,g=rx,o=rx /var/www/html/index.php && sudo printf '%s\n%s\n%s' '<?php' ' phpinfo();' '?>' >> /var/www/html/index.php

415


El comando anterior de Amazon Linux cambia también el propietario del archivo a ec2-user, cambiael grupo del archivo a web-content y cambia los permisos del archivo a lectura/escritura para elusuario y a lectura/ejecución para el grupo y otros usuarios.

Para Ubuntu Server:

sudo touch /var/www/html/index.php && sudo chown -R ubuntu:web-content /var/www/html/index.php && sudo chmod u=rw,g=rx,o=rx /var/www/html/index.php && sudo printf '%s\n%s\n%s' '<?php' ' phpinfo();' '?>' >> /var/www/html/index.php

El comando anterior de Ubuntu Server cambia también el propietario del archivo a ubuntu, cambiael grupo del archivo a web-content y cambia los permisos del archivo a lectura/escritura para elusuario y a lectura/ejecución para el grupo y otros usuarios.

Si se ejecuta correctamente, los comandos anteriores crean el archivo index.php con el siguientecontenido.

<?php phpinfo();?>

3. Habilite el tráfico web entrante a través del puerto 80 para ver la nueva página web configurando laACL de red en Amazon VPC y el grupo de seguridad en Amazon EC2 que están asociados a esteentorno de EC2. Para ello, ejecute los ocho comandos siguientes, de uno en uno, en el orden quese indica a continuación. Para entender lo que hace cada comando, lea la información que aparecedetrás del comando # en cada comando.

Important

La ejecución de los siguientes comandos permite el tráfico web entrante a través del puerto80 para todas las instancias de entornos de EC2 y Amazon EC2 que están asociadasal grupo de seguridad y a la ACL de red de este entorno. Esto podría ocasionar que sehabilitara sin querer el tráfico web entrante a través del puerto 80 para instancias entornos deEC2 y Amazon EC2 distintas de esta.

Note

Los comandos del segundo al cuarto siguientes habilitan el grupo de seguridad para permitirel tráfico web entrante a través del puerto 80. Si tiene un grupo de seguridad predeterminado,que solo permite el tráfico SSH a través del puerto 22, debe ejecutar el primer comando ydespués los comandos del segundo al cuarto. Sin embargo, si tiene un grupo de seguridadpersonalizado que ya permite el tráfico web entrante a través del puerto 80, puede omitir sinproblemas la ejecución de estos comandos.Los comandos del quinto al octavo siguientes habilitan la ACL de red para permitir el tráficoweb entrante a través del puerto 80. Si tiene una ACL de red predeterminada, que ya permitetodo el tráfico entrante a través de todos los puertos, puede pasar por alto la ejecución dedichos comandos. Sin embargo, si tiene una ACL de red personalizada que no permite que eltráfico web entrante a través del puerto 80, debe ejecutar el primer comando seguido de loscomandos quinto hasta el octavo.

MY_INSTANCE_ID=$(curl http://169.254.169.254/latest/meta-data/instance-id) # Get the ID of the instance for the environment, and store it temporarily. MY_SECURITY_GROUP_ID=$(aws ec2 describe-instances --instance-id $MY_INSTANCE_ID --query 'Reservations[].Instances[0].SecurityGroups[0].GroupId' --output text) # Get the ID of the security group associated with the instance, and store it temporarily.

416


aws ec2 authorize-security-group-ingress --group-id $MY_SECURITY_GROUP_ID --protocol tcp --cidr 0.0.0.0/0 --port 80 # Add an inbound rule to the security group to allow all incoming IPv4-based traffic over port 80.

aws ec2 authorize-security-group-ingress --group-id $MY_SECURITY_GROUP_ID --ip-permissions IpProtocol=tcp,Ipv6Ranges='[{CidrIpv6=::/0}]',FromPort=80,ToPort=80 # Add an inbound rule to the security group to allow all incoming IPv6-based traffic over port 80.

MY_SUBNET_ID=$(aws ec2 describe-instances --instance-id $MY_INSTANCE_ID --query 'Reservations[].Instances[0].SubnetId' --output text) # Get the ID of the subnet associated with the instance, and store it temporarily.

MY_NETWORK_ACL_ID=$(aws ec2 describe-network-acls --filters Name=association.subnet-id,Values=$MY_SUBNET_ID --query 'NetworkAcls[].Associations[0].NetworkAclId' --output text) # Get the ID of the network ACL associated with the subnet, and store it temporarily.

aws ec2 create-network-acl-entry --network-acl-id $MY_NETWORK_ACL_ID --ingress --protocol tcp --rule-action allow --rule-number 10000 --cidr-block 0.0.0.0/0 --port-range From=80,To=80 # Add an inbound rule to the network ACL to allow all IPv4-based traffic over port 80. Advanced users: change this suggested rule number as desired.

aws ec2 create-network-acl-entry --network-acl-id $MY_NETWORK_ACL_ID --ingress --protocol tcp --rule-action allow --rule-number 10100 --ipv6-cidr-block ::/0 --port-range From=80,To=80 # Add an inbound rule to the network ACL to allow all IPv6-based traffic over port 80. Advanced users: change this suggested rule number as desired.

4. Obtenga la URL al archivo index.php en la raíz del servidor web. Para ello, ejecute el siguientecomando y utilice una nueva pestaña del navegador web o un navegador web distinto desde el AWSCloud9 IDE para ir a la URL que se muestra. Si se ejecuta correctamente, la página web muestrainformación acerca de Apache HTTP Server, MySQL, PHP y otra configuración relacionada.

MY_PUBLIC_IP=$(curl http://169.254.169.254/latest/meta-data/public-ipv4) && echo http://$MY_PUBLIC_IP/index.php # Get the URL to the index.php file within the web server root.

Paso 4: LimpiezaSi desea seguir usando este entorno pero deshabilitar el tráfico web entrante a través del puerto 80,ejecute los ocho comandos siguientes, uno por uno, en el orden que se indica a continuación, para eliminarlas reglas de tráfico entrante correspondientes que configuró anteriormente en el grupo de seguridady en la ACL de red que están asociados al entorno. Para entender lo que hace cada comando, lea lainformación que aparece detrás del comando # en cada comando.

Important

La ejecución de los siguientes comandos deshabilita el tráfico web entrante a través del puerto80 para todas las instancias de entornos de EC2 y Amazon EC2 que están asociadas al grupode seguridad y a la ACL de red de este entorno. Esto podría ocasionar que se deshabilitara sinquerer el tráfico web entrante a través del puerto 80 para instancias entornos de EC2 y AmazonEC2 distintas de esta.Note

Los comandos del quinto al octavo siguientes eliminan las reglas existentes para impedir quela ACL de red permita el tráfico web entrante a través del puerto 80. Si tiene una ACL de redpredeterminada, que ya permite todo el tráfico entrante a través de todos los puertos, puede pasarpor alto la ejecución de dichos comandos. Sin embargo, si tiene una ACL de red personalizadacon reglas existentes que permite el tráfico web entrante a través del puerto 80 y desea eliminarestas reglas, debe ejecutar el primer comando seguido de los comandos quinto hasta el octavo.

417

AWS Cloud9 Guía del usuarioEjemplo de WordPress


aws ec2 revoke-security-group-ingress --group-id $MY_SECURITY_GROUP_ID --protocol tcp --cidr 0.0.0.0/0 --port 80 # Delete the existing inbound rule from the security group to block all incoming IPv4-based traffic over port 80.

aws ec2 revoke-security-group-ingress --group-id $MY_SECURITY_GROUP_ID --ip-permissions IpProtocol=tcp,Ipv6Ranges='[{CidrIpv6=::/0}]',FromPort=80,ToPort=80 # Delete the existing inbound rule from the security group to block all incoming IPv6-based traffic over port 80.



aws ec2 delete-network-acl-entry --network-acl-id $MY_NETWORK_ACL_ID --ingress --rule-number 10000 # Delete the existing inbound rule from the network ACL to block all IPv4-based traffic over port 80. Advanced users: if you originally created this rule with a different number, change this suggested rule number to match.


Si ha terminado de usar este entorno, debe eliminarlo para evitar que se apliquen cargos a su cuenta deAWS. Para obtener instrucciones, consulte Eliminación de un entorno en AWS Cloud9 (p. 103).

Ejemplo de WordPress para AWS Cloud9Este ejemplo le permite ejecutar WordPress en un entorno de desarrollo de AWS Cloud9.

La creación de esta muestra puede generar cargos en su cuenta de AWS. Entre ellos, se incluyen posiblescargos por servicios como Amazon Elastic Compute Cloud (Amazon EC2). Para obtener más información,consulte Precios de Amazon EC2.

Temas• Requisitos previos (p. 418)• Paso 1: instalar las herramientas necesarias (p. 419)• Paso 2: Configurar MySQL (p. 421)• Paso 3: Configurar el sitio web de WordPress (p. 422)• Paso 4: Compartir el sitio web de WordPress a través de Internet (p. 424)• Paso 5: Limpieza (p. 428)


418


AWS Cloud9 Guía del usuarioPaso 1: instalar las herramientas necesarias



Paso 1: instalar las herramientas necesariasEn este paso, instalará las siguientes herramientas, de las que depende WordPress:

• Apache HTTP Server, que aloja sitios web de WordPress.• PHP, que utiliza WordPress para crear scripts en los sitios web.• MySQL, que utiliza WordPress para almacenar y recuperar información de los sitios web.

Debe finalizar este paso iniciando Apache HTTP Server y MySQL e instalando después WordPress.

1. Asegúrese de que las últimas actualizaciones de seguridad y correcciones de errores estáninstaladas. Para ello, en una sesión de terminal del AWS Cloud9 IDE, ejecute el comando yumupdate para Amazon Linux o apt update para Ubuntu Server. (Para iniciar una nueva sesión delterminal, en la barra de menús, seleccione Window [Ventana], New Terminal [Nuevo terminal]).

En Amazon Linux:

sudo yum -y update

Para Ubuntu Server:

sudo apt -y update

2. Compruebe si Apache HTTP Server ya está instalado. Para ello, ejecute el comando httpd -v (paraAmazon Linux) o apache2 -v (para Ubuntu Server).

Si está instalado, el resultado contendrá el número de versión de Apache HTTP Server.

Si aparece un error, instale Apache HTTP Server ejecutando el comando install .

En Amazon Linux:

sudo yum install -y httpd24

Para Ubuntu Server:

sudo apt install -y apache2

3. Confirme si PHP ya está instalado ejecutando el comando php -v .

Si es así, el resultado contendrá el número de versión de PHP.

Si aparece un error, instale PHP ejecutando el comando install .

En Amazon Linux:

419

AWS Cloud9 Guía del usuarioPaso 1: instalar las herramientas necesarias

sudo yum install -y php56

Para Ubuntu Server:

sudo apt install -y php libapache2-mod-php php-xml

4. Confirme si MySQL ya está instalado ejecutando el comando mysql --version .

Si ya está instalado, el resultado contendrá el número de versión de MySQL.

Si aparece un error, instale MySQL ejecutando el comando install .

En Amazon Linux:

sudo yum install -y mysql-server

Para Ubuntu Server:

sudo apt install -y mysql-server

5. Después de instalar Apache HTTP Server, PHP y MySQL, inicie Apache HTTP Server y, acontinuación, confirme que se ha iniciado ejecutando el siguiente comando.


sudo service httpd start && sudo service httpd status


sudo service apache2 start && sudo service apache2 status

6. Inicie MySQL y, a continuación, confirme que se ha iniciado ejecutando el siguiente comando.

En Amazon Linux:

sudo service mysqld start && sudo service mysqld status


sudo service mysql start && sudo service mysql status

7. Descargue WordPress ejecutando el siguiente comando.

wget http://wordpress.org/latest.tar.gz

8. Instale WordPress ejecutando el siguiente comando.

tar -xzvf latest.tar.gz

Si ejecuta el comando anterior desde la ubicación predeterminada en su entorno, puede encontrar losarchivos de instalación de WordPress dentro de una carpeta denominada wordpress en la ventanaEnvironment (Entorno) del AWS Cloud9 IDE. También puede obtener estos archivos desde una sesiónde terminal cambiando a la siguiente ubicación.

420

AWS Cloud9 Guía del usuarioPaso 2: Configurar MySQL

En Amazon Linux:

cd /home/ec2-user/environment/wordpress/

Para Ubuntu Server:

cd /home/ubuntu/environment/wordpress/

Paso 2: Configurar MySQLEn este paso, configurará MySQL para seguir las prácticas de seguridad recomendadas de MySQL.Estas prácticas de seguridad recomendadas incluyen configurar una contraseña para las cuentas raíz,eliminar las cuentas raíz que están accesibles desde fuera del host local, eliminar las cuentas de usuariosanónimos, eliminar la base de datos de prueba y eliminar los privilegios que permiten a cualquier usuarioobtener acceso a las bases de datos con nombres que comienzan por test_.

Para finalizar este paso, configure MySQL para almacenar y recuperar información de un nuevo sitio webde WordPress.

1. Implemente las prácticas de seguridad recomendadas de MySQL para la instalación de MySQLejecutando el siguiente comando en una sesión de terminal del AWS Cloud9 IDE.

sudo mysql_secure_installation

2. Cuando se le solicite, responda a las siguientes preguntas.

En Amazon Linux:

1. Escribir la contraseña de la cuenta raíz actual (pulse Intro para ninguna): pulse Enter (si no deseaespecificar una contraseña).

2. Establecer una contraseña raíz: escriba Y y, a continuación, pulse Enter.3. Nueva contraseña: escriba una contraseña y pulse Enter.4. Volver a escribir la nueva contraseña: escriba de nuevo la contraseña y, a continuación, pulse

Enter. (Asegúrese de almacenar la contraseña en un lugar seguro para usarla más adelante).5. Eliminar usuarios anónimos: escriba Y y, a continuación, pulse Enter.6. Prohibir el inicio de sesión en la cuenta raíz de forma remota: escriba Y y, a continuación, pulse

Enter.7. Eliminar la base de datos de prueba y el acceso a ella: escriba Y y, a continuación, pulse Enter.8. Volver a cargar ahora las tablas de privilegios: escriba Y y, a continuación, pulse Enter.

Para Ubuntu Server:

1. ¿Desea configurar el complemento VALIDATE PASSWORD?: escriba y y, a continuación, pulseEnter.

2. Existen tres niveles de política de validación de contraseñas: escriba 0, 1 o 2 y, a continuación,pulse Enter.

3. Nueva contraseña: escriba una contraseña y pulse Enter.4. Volver a escribir la nueva contraseña: escriba de nuevo la contraseña y, a continuación, pulse

Enter. (Asegúrese de almacenar la contraseña en un lugar seguro para usarla más adelante).5. ¿Desea continuar con la contraseña proporcionada?: escriba y y, a continuación, pulse Enter.6. Eliminar usuarios anónimos: escriba y y, a continuación, pulse Enter.

421

AWS Cloud9 Guía del usuarioPaso 3: Configurar el sitio web de WordPress

7. Prohibir el inicio de sesión en la cuenta raíz de forma remota: escriba y y, a continuación, pulseEnter.

8. Eliminar la base de datos de prueba y el acceso a ella: escriba y y, a continuación, pulse Enter.9. Volver a cargar ahora las tablas de privilegios: escriba y y, a continuación, pulse Enter.

3. Inicie el cliente de línea de comandos de MySQL como usuario raíz ejecutando el siguiente comando.Cuando se le solicite, escriba la contraseña del usuario raíz que ha definido anteriormente y, acontinuación, pulse Enter. (El símbolo cambia a mysql> mientras se encuentra en el cliente de líneade comandos de MySQL).

sudo mysql -uroot -p

4. Cree una base de datos de MySQL para que la utilice el sitio de WordPress. Para ello, ejecute elsiguiente comando, sustituyendo my_db_name por un nombre para la nueva base de datos (porejemplo, mysite). (Asegúrese de almacenar el nombre de esta base de datos en un lugar seguropara usarlo más adelante).

CREATE DATABASE my_db_name;

5. Cree un usuario de MySQL para que lo utilice el sitio de WordPress. Para ello, ejecute el siguientecomando, sustituyendo my_user_name por el nombre del usuario (por ejemplo, wordpress-user) ysustituyendo my_password por una contraseña para el usuario. (Asegúrese de guardar este nombrede usuario y contraseña en un lugar seguro para usarlos más adelante).

GRANT ALL PRIVILEGES ON *.* TO 'my_user_name'@'localhost' IDENTIFIED BY 'my_password';

6. Salga del cliente de línea de comandos de MySQL ejecutando el siguiente comando. (El símbolocambia a $).

exit;

Paso 3: Configurar el sitio web de WordPressEn este paso, configurará un sitio web de WordPress definiendo los detalles básicos de configuración,como la información de conexión de la base de datos MySQL.

Finalizará este paso abriendo el sitio web y especificando su título de visualización, el nombre de usuario yla contraseña y otros ajustes.

1. Cambie el nombre del archivo wp-config-sample.php a wp-config.php en la instalación deWordPress, tal y como se indica a continuación.

a. En la ventana Environment (Entorno), expanda la carpeta wordpress.b. Haga clic con el botón derecho en el archivo wp-config-sample.php.c. Elija Rename (Cambiar nombre).d. Escriba wp-config para cambiar el nombre de este archivo a wp-config.php y, a

continuación, pulse Enter.2. Configure el archivo wp-config.php para el sitio web de WordPress. Para ello, haga doble clic en el

archivo wp-config.php para abrirlo en el editor, sustituya los siguientes valores y, a continuación,guarde y cierre el archivo.

• Sustituya database_name_here por el nombre de la base de datos MySQL que creóanteriormente (por ejemplo, mysite).

422

AWS Cloud9 Guía del usuarioPaso 3: Configurar el sitio web de WordPress

• Sustituya username_here por el nombre del usuario de MySQL que creó anteriormente (porejemplo, wordpress-user).

• Sustituya password_here por la contraseña del usuario de MySQL que creó anteriormente.

/** The name of the database for WordPress */define( 'DB_NAME', 'database_name_here' );

/** MySQL database username */define( 'DB_USER', 'username_here' );

/** MySQL database password */define( 'DB_PASSWORD', 'password_here' );

3. Inicie el sitio web de WordPress. Para ello, haga doble clic en el archivo index.php para abrirlo en eleditor. A continuación, en la barra de menú principal, elija Run (Ejecutar). El ejecutor PHP (built-in webserver) (PHP [servidor web integrado]) se inicia, lo que también inicia el sitio web de WordPress.

Note

Para detener el sitio web de WordPress, en esta pestaña del ejecutor, elija Stop (Detener).4. Consulte el sitio web de WordPress desde el AWS Cloud9 IDE. Para ello, en la barra de menú

principal, elija Preview, Preview Running Application (Vista previa, Vistas previa de la aplicación enejecución). Se abre una ventana nueva en el IDE, que muestra una página Not Found (No encontrada)(resultado previsto en este punto).

5. Abra el sitio web de WordPress en una pestaña nueva dentro del mismo navegador web que el AWSCloud9 IDE. Para ello, en la barra de direcciones de la nueva ventana, elija Pop Out Into New Window(Abrir en nueva ventana). La nueva pestaña muestra la misma página Not Found (No encontrada), loque sigue siendo el resultado previsto.

6. Establezca el idioma, el nombre de usuario, la contraseña y otros ajustes del sitio web de WordPress.Para ello, en la nueva pestaña dentro del mismo navegador web que el AWS Cloud9 IDE, añada /wordpress/ al final de la URL existente y, a continuación, pulse Enter. Se muestra la página webWordPress > Installation (WordPress > Instalación). Siga las instrucciones que aparecen en pantallapara terminar de especificar la configuración del sitio web.

Important

En la sección Information needed (Información necesaria), para Username (Nombre deusuario) y Password (Contraseña), escriba el nombre de usuario (por ejemplo, wordpress-user) y la contraseña del usuario de MySQL que definió anteriormente para WordPress.

7. Al final de la instalación, utilice el nombre de usuario y la contraseña que especificó para iniciar sesiónen el sitio web de WordPress. A continuación, siga las instrucciones que aparecen en pantalla parapersonalizar aún más el sitio web.

Para volver a este panel en cualquier momento, asegúrese de añadir /wordpress/wp-admin/ alfinal de la URL existente y, a continuación, pulse Enter. (O bien, desde la página de inicio del sitioweb, seleccione My Site's Name, Dashboard (Nombre de mi sitio web, Panel)).

Para volver a la página de inicio del sitio web en cualquier momento, asegúrese de añadir /wordpress/ al final de la URL existente y, a continuación, pulse Enter. (O bien, desde el panel delsitio web, seleccione My Site's Name, Dashboard (Nombre de mi sitio, Visitar sitio)).

423

AWS Cloud9 Guía del usuarioPaso 4: Compartir el sitio web deWordPress a través de Internet

Paso 4: Compartir el sitio web de WordPress a travésde InternetEn este paso, configurará Apache HTTP Server con los puertos, ubicaciones de archivo, propietarios ypermisos de acceso recomendados para el sitio web de WordPress.

A continuación, habilitará el tráfico web entrante para ver ese sitio web configurando el grupo de seguridadde Amazon EC2 y la lista de control de acceso de red (ACL de red) en Amazon Virtual Private Cloud(Amazon VPC) que están asociados a este entorno de EC2. Cada entorno de EC2 debe estar asociadoa un grupo de seguridad de Amazon EC2 y a una ACL de red de Amazon VPC. Sin embargo, aunquela ACL de red predeterminada de una cuenta de AWS permite todo el tráfico de entrada y salida delentorno, el grupo de seguridad predeterminado permite únicamente el tráfico entrante mediante SSH através del puerto 22. Para obtener más información, consulte the section called “Configuración de AmazonVPC” (p. 501).

Para finalizar este paso, debe ver correctamente el sitio web desde fuera del AWS Cloud9 IDE.

1. Detenga el sitio web de WordPress. Para ello, en la pestaña del ejecutor PHP (built-in web server)(PHP [servidor web integrado]) del AWS Cloud9 IDE, elija Stop (Detener).

2. Realice copias de seguridad de los archivos de configuración de Apache HTTP Server principales quemodificará más adelante en este procedimiento, por si los archivos originales dejaran de funcionar.Para ello, ejecute los siguientes comandos de copia de archivos.

Para Amazon Linux, ejecute solo el siguiente comando de copia de archivos:

sudo cp /etc/httpd/conf/httpd.conf /etc/httpd/conf/httpd.conf.bak

Para Ubuntu Server, ejecute los tres comandos de copia de archivos siguientes, uno por uno, en elorden que se indica a continuación:

sudo cp /etc/apache2/ports.conf /etc/apache2/ports.conf.bak

sudo cp /etc/apache2/sites-enabled/000-default.conf /etc/apache2/sites-enabled/000-default.conf.bak

sudo cp /etc/apache2/apache2.conf /etc/apache2/apache2.conf.bak

3. Asocie Apache HTTP Server al puerto 8080, en lugar de al puerto predeterminado 80. Para ello,ejecute el siguiente comando de búsqueda y reemplazo de archivos.

En Amazon Linux:

sudo sed -i 's/Listen 80/Listen 8080/g' /etc/httpd/conf/httpd.conf

Para Ubuntu Server:

sudo sed -i 's/Listen 80/Listen 8080/g' /etc/apache2/ports.conf

4. Añada o cambie la configuración del host virtual para que escuche en el puerto 8080, en lugar de en elpuerto predeterminado 80. Para ello, ejecute el siguiente comando de adición o búsqueda y reemplazode archivos.

Para Amazon Linux, añada la configuración del host virtual al archivo de configuración existente:

424


sudo echo -e "<VirtualHost *:8080>\n DocumentRoot /var/www/html\n</VirtualHost>" | sudo tee -a /etc/httpd/conf/httpd.conf

Para Ubuntu Server, busque y reemplace la configuración del host virtual existente en un archivo deconfiguración existente:

sudo sed -i 's/<VirtualHost \*:80>/<VirtualHost \*:8080>/g' /etc/apache2/sites-enabled/000-default.conf

5. Reinicie Apache HTTP Server para que utilice la nueva configuración. Para ello, ejecute el siguientecomando.


sudo service httpd restart && sudo service httpd status


sudo service apache2 restart && sudo service apache2 status

6. Consulte la página web de información predeterminada de Apache HTTP Server desde el AWSCloud9 IDE. Para ello, en la barra de menú principal, elija Preview, Preview Running Application (Vistaprevia, Vistas previa de la aplicación en ejecución). Se abre una nueva ventana en el IDE y se muestrala página web de información predeterminada de Apache HTTP Server.

7. Cambie ahora a Apache HTTP Server para usar el directorio raíz del sitio web de WordPressejecutando el siguiente comando de búsqueda y reemplazo de archivos.

En Amazon Linux:

sudo sed -i 's/<Directory "\/var\/www\/html">/<Directory "\/home\/ec2-user\/environment\/wordpress">/g' /etc/httpd/conf/httpd.conf

Para Ubuntu Server:

sudo sed -i 's/<Directory \/var\/www\/>/<Directory \/home\/ubuntu\/environment\/wordpress\/>/g' /etc/apache2/apache2.conf

8. Cambie a Apache HTTP Server para especificar cómo usar la raíz de documentos del sitio web deWordPress ejecutando el siguiente comando de búsqueda y reemplazo de archivos.

En Amazon Linux:

sudo sed -i 's/DocumentRoot \/var\/www\/html/DocumentRoot \/home\/ec2-user\/environment\/wordpress/g' /etc/httpd/conf/httpd.conf

Para Ubuntu Server:

sudo sed -i 's/DocumentRoot \/var\/www\/html/DocumentRoot \/home\/ubuntu\/environment\/wordpress/g' /etc/apache2/sites-enabled/000-default.conf

9. Configure la raíz del sitio web con los propietarios y los permisos de acceso recomendados. Para ello,ejecute los seis comandos siguientes, de uno en uno, en el orden que se indica a continuación. Paraentender lo que hace cada comando, lea la información que aparece detrás del comando # en cadacomando.

425


En Amazon Linux:


sudo usermod -G web-content -a ec2-user # Add the user ec2-user (your default user for this environment) to the group web-content.

sudo usermod -G web-content -a apache # Add the user apache (Apache HTTP Server) to the group web-content.

sudo chown -R ec2-user:web-content /home/ec2-user/environment/wordpress # Change the owner of /home/ec2-user/environment/wordpress and its files to user ec2-user and group web-content.

sudo find /home/ec2-user/environment/wordpress -type f -exec chmod u=rw,g=rx,o=rx {} \; # Change all file permissions within /home/ec2-user/environment/wordpress to user read/write, group read-only, and others read/execute.

sudo find /home/ec2-user/environment/wordpress -type d -exec chmod u=rwx,g=rx,o=rx {} \; # Change /home/ec2-user/environment/wordpress directory permissions to user read/write/execute, group read/execute, and others read/execute.

Para Ubuntu Server:


sudo usermod -G web-content -a ubuntu # Add the user ubuntu (your default user for this environment) to the group web-content.

sudo usermod -G web-content -a www-data # Add the user www-data (Apache HTTP Server) to the group web-content.

sudo chown -R ubuntu:web-content /home/ubuntu/environment/wordpress # Change the owner of /home/ubuntu/environment/wordpress and its files to user ubuntu and group web-content.

sudo find /home/ubuntu/environment/wordpress -type f -exec chmod u=rw,g=rx,o=rx {} \; # Change all file permissions within /home/ubuntu/environment/wordpress to user read/write, group read-only, and others read/execute.

sudo find /home/ubuntu/environment/wordpress -type d -exec chmod u=rwx,g=rx,o=rx {} \; # Change /home/ubuntu/environment/wordpress directory permissions to user read/write/execute, group read/execute, and others read/execute.

10. Reinicie Apache HTTP Server para que utilice la nueva configuración. Para ello, ejecute el siguientecomando.


sudo service httpd restart && sudo service httpd status


sudo service apache2 restart && sudo service apache2 status

11. Consulte el sitio web de WordPress desde el AWS Cloud9 IDE. Para ello, en la barra de menúprincipal, elija Preview, Preview Running Application (Vista previa, Vistas previa de la aplicación enejecución). Se abre una ventana nueva en el IDE, que muestra una página Not Found (No encontrada)(resultado previsto en este punto).

426


12. Abra el sitio web de WordPress en una pestaña nueva dentro del mismo navegador web que el AWSCloud9 IDE. Para ello, en la barra de direcciones de la nueva ventana, elija Pop Out Into New Window(Abrir en nueva ventana). La nueva pestaña muestra la misma página Not Found (No encontrada), loque sigue siendo el resultado previsto.

13. En la nueva pestaña dentro del mismo navegador web que el AWS Cloud9 IDE, añada /index.phpal final de la URL existente y, a continuación, pulse Enter. Se muestra la página de inicio del sitio webde WordPress.

14. Habilite el tráfico web entrante a través del puerto 8080 para ver la nueva página web configurandola ACL de red en Amazon VPC y el grupo de seguridad en Amazon EC2 que están asociados a esteentorno de EC2. Para ello, ejecute los ocho comandos siguientes, de uno en uno, en el orden quese indica a continuación. Para entender lo que hace cada comando, lea la información que aparecedetrás del comando # en cada comando.

Important

La ejecución de los siguientes comandos permite el tráfico web entrante a través del puerto8080 para todas las instancias de entornos de EC2 y Amazon EC2 que están asociadasal grupo de seguridad y a la ACL de red de este entorno. Esto podría ocasionar que sehabilitara sin querer el tráfico web entrante a través del puerto 8080 para instancias entornosde EC2 y Amazon EC2 distintas de esta.

Note

Los comandos del segundo al cuarto siguientes habilitan el grupo de seguridad parapermitir el tráfico web entrante a través del puerto 8080. Si tiene un grupo de seguridadpredeterminado, que solo permite el tráfico SSH a través del puerto 22, debe ejecutar elprimer comando y después los comandos del segundo al cuarto. Sin embargo, si tiene ungrupo de seguridad personalizado que ya permite el tráfico web entrante a través del puerto8080, puede omitir sin problemas la ejecución de estos comandos.Los comandos del quinto al octavo siguientes habilitan la ACL de red para permitir eltráfico web entrante a través del puerto 8080. Si tiene una ACL de red predeterminada, queya permite todo el tráfico entrante a través de todos los puertos, puede pasar por alto laejecución de dichos comandos. Sin embargo, si tiene una ACL de red personalizada que nopermite que el tráfico web entrante a través del puerto 80, debe ejecutar el primer comandoseguido de los comandos quinto hasta el octavo.


aws ec2 authorize-security-group-ingress --group-id $MY_SECURITY_GROUP_ID --protocol tcp --cidr 0.0.0.0/0 --port 8080 # Add an inbound rule to the security group to allow all incoming IPv4-based traffic over port 8080.

aws ec2 authorize-security-group-ingress --group-id $MY_SECURITY_GROUP_ID --ip-permissions IpProtocol=tcp,Ipv6Ranges='[{CidrIpv6=::/0}]',FromPort=8080,ToPort=8080 # Add an inbound rule to the security group to allow all incoming IPv6-based traffic over port 8080.



427


aws ec2 create-network-acl-entry --network-acl-id $MY_NETWORK_ACL_ID --ingress --protocol tcp --rule-action allow --rule-number 10000 --cidr-block 0.0.0.0/0 --port-range From=8080,To=8080 # Add an inbound rule to the network ACL to allow all IPv4-based traffic over port 8080. Advanced users: change this suggested rule number as desired.

aws ec2 create-network-acl-entry --network-acl-id $MY_NETWORK_ACL_ID --ingress --protocol tcp --rule-action allow --rule-number 10100 --ipv6-cidr-block ::/0 --port-range From=8080,To=8080 # Add an inbound rule to the network ACL to allow all IPv6-based traffic over port 8080. Advanced users: change this suggested rule number as desired.

15. Obtenga la URL al archivo index.php en la raíz del servidor web. Para ello, ejecute el siguientecomando y utilice una nueva pestaña del navegador web o un navegador web distinto desde el AWSCloud9 IDE para ir a la URL que se muestra. Si se ejecuta correctamente, la página web muestra lapágina de inicio del sitio web de WordPress.

MY_PUBLIC_IP=$(curl http://169.254.169.254/latest/meta-data/public-ipv4) && echo http://$MY_PUBLIC_IP:8080/index.php # Get the URL to the index.php file within the web server root.

Paso 5: LimpiezaSi desea seguir usando este entorno pero deshabilitar el tráfico web entrante a través del puerto 8080,ejecute los ocho comandos siguientes, uno por uno, en el orden que se indica a continuación, para eliminarlas reglas de tráfico entrante correspondientes que configuró anteriormente en el grupo de seguridady en la ACL de red que están asociados al entorno. Para entender lo que hace cada comando, lea lainformación que aparece detrás del comando # en cada comando.

Important

La ejecución de los siguientes comandos deshabilita el tráfico web entrante a través del puerto8080 para todas las instancias de entornos de EC2 y Amazon EC2 que están asociadas al grupode seguridad y a la ACL de red de este entorno. Esto podría ocasionar que se deshabilitara sinquerer el tráfico web entrante a través del puerto 8080 para instancias entornos de EC2 y AmazonEC2 distintas de esta.

Note

Los comandos del quinto al octavo siguientes eliminan las reglas existentes para impedir quela ACL de red permita el tráfico web entrante a través del puerto 8080. Si tiene una ACL de redpredeterminada, que ya permite todo el tráfico entrante a través de todos los puertos, puede pasarpor alto la ejecución de dichos comandos. Sin embargo, si tiene una ACL de red personalizadacon reglas existentes que permite el tráfico web entrante a través del puerto 8080 y desea eliminarestas reglas, debe ejecutar el primer comando seguido de los comandos quinto hasta el octavo.


aws ec2 revoke-security-group-ingress --group-id $MY_SECURITY_GROUP_ID --protocol tcp --cidr 0.0.0.0/0 --port 8080 # Delete the existing inbound rule from the security group to block all incoming IPv4-based traffic over port 8080.

aws ec2 revoke-security-group-ingress --group-id $MY_SECURITY_GROUP_ID --ip-permissions IpProtocol=tcp,Ipv6Ranges='[{CidrIpv6=::/0}]',FromPort=8080,ToPort=8080 # Delete the

428

AWS Cloud9 Guía del usuarioEjemplo de Java

existing inbound rule from the security group to block all incoming IPv6-based traffic over port 8080.





Para evitar que se hagan cargos continuos en su cuenta de AWS después de que haya terminado de usaresta muestra, elimine el entorno. Para obtener instrucciones, consulte Eliminación de un entorno en AWSCloud9 (p. 103).

Muestra de Java para AWS Cloud9Esta muestra le permite ejecutar código Java en un entorno de desarrollo de AWS Cloud9.


Temas• Requisitos previos (p. 429)• Paso 1: Instalar las herramientas necesarias (p. 430)• Paso 2: Añadir el código (p. 431)• Paso 3: Compilar y ejecutar el código (p. 431)• Paso 4: Configurar el uso del AWS SDK for Java (p. 432)• Paso 5: Configurar la administración de credenciales de AWS en su entorno (p. 437)• Paso 6: Añadir el código del SDK de AWS (p. 437)• Paso 7: Compilar y ejecutar el código del SDK de AWS (p. 438)• Paso 8: Eliminación (p. 439)



429






Paso 1: Instalar las herramientas necesariasEn este paso, instalará un conjunto de herramientas de desarrollo Java en su entorno de desarrollo deAWS Cloud9. Si ya tiene un conjunto de herramientas de desarrollo Java como Oracle JDK u OpenJDKinstalado en su entorno, continúe en Paso 2: Añadir el código (p. 431). Esta muestra se desarrolló conOpenJDK 8, que puede instalar en su entorno realizando el siguiente procedimiento.

1. Confirme si OpenJDK 8 ya está instalado. Para ello, en una sesión de terminal en AWS Cloud9 IDE,ejecute la versión de la línea de comandos del ejecutador de Java con la opción -version. [Parainiciar una nueva sesión del terminal, en la barra de menús, seleccione Window (Ventana), NewTerminal (Nuevo terminal)].

java -version

En función del resultado del comando anterior, realice una de las siguientes acciones:

• Si el resultado indica que no se encuentra el comando java, continúe con el paso 2 de esteprocedimiento para instalar OpenJDK 8.

• Si el resultado contiene valores que comienzan con Java(TM), Java Runtime Environment,Java SE, J2SE o Java2, el OpenJDK no está instalado o no se ha establecido como el conjunto deherramientas de desarrollo de Java predeterminado. Continúe con el paso 2 de este procedimientopara instalar OpenJDK 8 y, a continuación, cambie a OpenJDK 8.

• Si el resultado contiene valores que comienzan por java version 1.8 y OpenJDK, continúe enPaso 2: Añadir el código (p. 431). OpenJDK 8 se instala correctamente para esta muestra.

• Si el resultado contiene un java version menor que 1.8 y valores que comienzan por OpenJDK,continúe con el paso 2 de este procedimiento para actualizar la versión de OpenJDK instalada aOpenJDK 8.

2. Asegúrese de que las últimas actualizaciones de seguridad y correcciones de errores estáninstaladas. Para ello, ejecute la herramienta yum (para Amazon Linux) o la herramienta apt (paraUbuntu Server) con el comando update .

En Amazon Linux:

sudo yum -y update

Para Ubuntu Server:

sudo apt update

3. Instale OpenJDK 8. Para ello, ejecute la herramienta yum (para Amazon Linux) o la herramienta apt(para Ubuntu Server) con el comando install , especificando el paquete OpenJDK 8.

En Amazon Linux:

sudo yum -y install java-1.8.0-openjdk-devel

Para Ubuntu Server:

sudo apt install -y openjdk-8-jdk

430


Para obtener más información, consulte Cómo descargar e instalar paquetes OpenJDKpreconfigurados en el sitio web de OpenJDK.

4. Cambie o actualice el conjunto de herramientas de desarrollo Java predeterminado a OpenJDK8. Para ello, ejecute el comando update-alternatives con la opción --config. Ejecute estecomando dos veces para cambiar o actualizar las versiones de la línea de comandos del ejecutor ycompilador de Java.

sudo update-alternatives --config javasudo update-alternatives --config javac

En cada solicitud, escriba el número de selección para OpenJDK 8 (el que contiene java-1.8).5. Confirme que las versiones de la línea de comandos del ejecutor y el compilador de Java utilizan

OpenJDK 8. Para ello, ejecute las versiones de la línea de comandos del ejecutor y el compilador deJava con la opción -version.

java -versionjavac -version

Si OpenJDK 8 está instalado y configurado correctamente, la salida de la versión del ejecutadorde Java contiene un valor que comienza por openjdk version 1.8 y la salida de la versión delcompilador de Java comienza por el valor javac 1.8.

Paso 2: Añadir el códigoEn el AWS Cloud9 IDE, cree un archivo con el siguiente código y guárdelo con el nombre hello.java.[Para crear un archivo, en la barra de menús, elija File (Archivo), New File (Nuevo archivo). Para guardar elarchivo, elija File (Archivo), Save (Guardar).

public class hello {

public static void main(String []args) { System.out.println("Hello, World!");

System.out.println("The sum of 2 and 3 is 5.");

int sum = Integer.parseInt(args[0]) + Integer.parseInt(args[1]);

System.out.format("The sum of %s and %s is %s.\n", args[0], args[1], Integer.toString(sum)); }}

Paso 3: Compilar y ejecutar el código1. Utilice la versión de la línea de comandos del compilador de Java para compilar el archivo

hello.java en un archivo hello.class. Para ello, utilizando el terminal en el AWS Cloud9 IDE,desde el mismo directorio que el archivo hello.java, ejecute el compilador de Java, especificandoel archivo hello.java.

javac hello.java

2. Utilice la versión de la línea de comandos del ejecutador de Java para ejecutar el archivohello.class. Para ello, desde el mismo directorio que el archivo hello.class, ejecute el

431

http://openjdk.java.net/install/

http://openjdk.java.net/install/

AWS Cloud9 Guía del usuarioPaso 4: Configurar el uso del AWS SDK for Java

ejecutador de Java, especificando el nombre de la clase hello que se declaró en el archivohello.java, con dos enteros para añadirlos (por ejemplo, 5 y 9).

java hello 5 9

3. Compare sus resultados.

Hello, World!The sum of 2 and 3 is 5.The sum of 5 and 9 is 14.

Paso 4: Configurar el uso del AWS SDK for JavaPuede mejorar esta muestra para utilizar el AWS SDK for Java y crear un bucket de Amazon S3, mostraruna lista de los buckets que tiene disponibles y, a continuación, eliminar el bucket que acaba de crear.

En este paso, instale Apache Maven o Gradle en su entorno. Maven y Gradle son sistemas deautomatización de compilación comunes que se pueden utilizar con proyectos Java. Después de instalarMaven o Gradle, se usa para generarlo un nuevo proyecto Java. En este nuevo proyecto, añada unareferencia al AWS SDK for Java. Este AWS SDK for Java proporciona una forma cómoda de interactuarcon los servicios de AWS como Amazon S3, desde su código Java.

Temas• Configuración con Maven (p. 432)• Configuración con Gradle (p. 434)

Configuración con Maven1. Instale Maven en su entorno. Para determinar si ya está instalado Maven, mediante el terminal en el

AWS Cloud9 IDE, ejecute Maven con la opción -version.

mvn -version

Si es así, el resultado contendrá el número de versión de Maven. Si Maven ya está instalado, vaya alpaso 4 de este procedimiento para utilizar Maven con el fin de generar un nuevo proyecto Java en suentorno.

2. Instale Maven utilizando el terminal para ejecutar los siguientes comandos.

Para Amazon Linux, los siguientes comandos obtienen información sobre el repositorio de paquetesdonde se almacena Maven y, a continuación, utilizan esta información para instalar Maven.

sudo wget http://repos.fedorapeople.org/repos/dchen/apache-maven/epel-apache-maven.repo -O /etc/yum.repos.d/epel-apache-maven.reposudo sed -i s/\$releasever/6/g /etc/yum.repos.d/epel-apache-maven.reposudo yum install -y apache-maven

Para obtener más información sobre los comandos anteriores, consulte Paquetes Extra paraEnterprise Linux (EPEL) en el sitio web wiki del proyecto Fedora.

Para Ubuntu Server, ejecute en cambio el siguiente comando.

sudo apt install -y maven

432

https://maven.apache.org/

https://gradle.org/

https://fedoraproject.org/wiki/EPEL

https://fedoraproject.org/wiki/EPEL


3. Confirme la instalación ejecutando Maven con la opción -version .

mvn -version

4. Utilice Maven para generar un nuevo proyecto Java. Para ello, utilice el terminal para ejecutar elsiguiente comando desde el directorio donde desea que Maven genere el proyecto (por ejemplo, eldirectorio raíz de su entorno).

mvn archetype:generate -DgroupId=com.mycompany.app -DartifactId=my-app -DarchetypeArtifactId=maven-archetype-quickstart -DinteractiveMode=false

El comando anterior crea la siguiente estructura de directorios para el proyecto en su entorno.

my-app |- src | `- main | `- java | `- com | `- mycompany | `- app | `-App.java |- test | `- java | `- com | `- mycompany | `- app | `- AppTest.java `- pom.xml

Para obtener más información sobre la estructura de directorios anterior, consulte Arquetipo de iniciorápido de Maven e Introducción al diseño de directorios estándar en el sitio web del proyecto ApacheMaven.

5. Modifique el archivo Project Object Model (POM) del proyecto. (Un archivo POM define laconfiguración de un proyecto Maven). Para ello, en la ventana Environment (Entorno), abra el archivomy-app/pom.xml. En el editor, reemplace el contenido actual del archivo por el siguiente código y, acontinuación, guarde el archivo pom.xml.

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd"> <modelVersion>4.0.0</modelVersion> <groupId>com.mycompany.app</groupId> <artifactId>my-app</artifactId> <packaging>jar</packaging> <version>1.0-SNAPSHOT</version> <build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-assembly-plugin</artifactId> <version>3.0.0</version> <configuration> <descriptorRefs> <descriptorRef>jar-with-dependencies</descriptorRef> </descriptorRefs> <archive> <manifest> <mainClass>com.mycompany.app.App</mainClass> </manifest>

433

https://maven.apache.org/archetypes/maven-archetype-quickstart/

https://maven.apache.org/archetypes/maven-archetype-quickstart/

https://maven.apache.org/guides/introduction/introduction-to-the-standard-directory-layout.html


</archive> </configuration> <executions> <execution> <phase>package</phase> <goals> <goal>single</goal> </goals> </execution> </executions> </plugin> </plugins> </build> <dependencies> <dependency> <groupId>junit</groupId> <artifactId>junit</artifactId> <version>3.8.1</version> <scope>test</scope> </dependency> <dependency> <groupId>com.amazonaws</groupId> <artifactId>aws-java-sdk</artifactId> <version>1.11.330</version> </dependency> </dependencies></project>

El archivo POM anterior incluye la configuración del proyecto que especifica declaraciones como lassiguientes:

• La configuración artifactid de my-app establece el nombre del directorio raíz del proyecto y laconfiguración group-id de com.mycompany.app establece la estructura de subdirectorios com/mycompany/app y la declaración package en los archivos App.Java y AppTest.java.

• La configuración artifactId de my-app, con la configuración packaging de jar, laconfiguración version de 1.0-SNAPSHOT y la configuración descriptorRef de jar-with-dependencies establece el nombre del archivo JAR de salida de my-app-1.0-SNAPSHOT-jar-with-dependencies.jar.

• La sección plugin declara que se creará un único JAR, que incluye todas las dependencias.• La sección dependency con la configuración groupId de com.amazon.aws y la configuraciónartifactId de aws-java-sdk incluye los archivos de biblioteca de AWS SDK for Java. Laversión de AWS SDK for Java que se usará se declara mediante la configuración version. Parautilizar otra versión, reemplace este número de versión.

Vaya a Paso 5: Configurar la administración de credenciales de AWS en su entorno (p. 437).

Configuración con Gradle1. Instale Gradle en su entorno. Para determinar si ya está instalado Gradle, mediante el terminal en el

AWS Cloud9 IDE, ejecute Gradle con la opción -version.

gradle -version

Si es así, el resultado contendrá el número de versión de Gradle. Si Gradle ya está instalado, vaya alpaso 4 de este procedimiento para utilizar Gradle con el fin de generar un nuevo proyecto Java en suentorno.

434


2. Instale Gradle utilizando el terminal para ejecutar los siguientes comandos. Estos comandos instalan yejecutan la herramienta SDKMAN! y, a continuación, utilizan SDKMAN! para instalar la última versiónde Gradle.

curl -s "https://get.sdkman.io" | bashsource "$HOME/.sdkman/bin/sdkman-init.sh"sdk install gradle

Para obtener más información sobre los comandos anteriores, consulte Installation en el sitio web deSDKMAN e Install with a package manager en el sitio web Gradle.

3. Confirme la instalación ejecutando Gradle con la opción -version .

gradle -version

4. Utilice Gradle para generar un nuevo proyecto Java en su entorno. Para ello, use el terminal paraejecutar los siguientes comandos con el fin de crear un directorio para el proyecto y, a continuación,cambie a ese directorio.

mkdir my-appcd my-app

5. Ejecute el siguiente comando para que Gradle genere un nuevo proyecto de aplicación Java en eldirectorio my-app de su entorno.

gradle init --type java-application

El comando anterior crea la siguiente estructura de directorios para el proyecto en su entorno.

my-app |- .gradle | `- (various supporting project folders and files) |- gradle | `- (various supporting project folders and files) |- src | |- main | | `- java | | `- App.java | `- test | `- java | `- AppTest.java |- build.gradle |- gradlew |- gradlew.bat `- settings.gradle

6. Modifique AppTest.java para el proyecto. (Si no lo hace, es posible que el proyecto no se compileni ejecute del modo previsto). Para ello, en la ventana Environment (Entorno), abra el archivo my-app/src/test/java/AppTest.java. En el editor, reemplace el contenido actual del archivo por elsiguiente código y, a continuación, guarde el archivo AppTest.java.

import org.junit.Test;import static org.junit.Assert.*;

public class AppTest { @Test public void testAppExists () { try { Class.forName("com.mycompany.app.App"); } catch (ClassNotFoundException e) { fail("Should have a class named App.");

435

https://sdkman.io/install

https://gradle.org/install/#with-a-package-manager


} }}

7. Modifique el archivo build.gradle para el proyecto. (Un archivo build.gradle define laconfiguración de un proyecto Gradle). Para ello, en la ventana Environment (Entorno), abra el archivomy-app/build.gradle. En el editor, reemplace el contenido actual del archivo por el siguientecódigo y, a continuación, guarde el archivo build.gradle.

apply plugin: 'java'apply plugin: 'application'

repositories { jcenter() mavenCentral()}

buildscript { repositories { mavenCentral() } dependencies { classpath "io.spring.gradle:dependency-management-plugin:1.0.3.RELEASE" }}

apply plugin: "io.spring.dependency-management"

dependencyManagement { imports { mavenBom 'com.amazonaws:aws-java-sdk-bom:1.11.330' }}

dependencies { compile 'com.amazonaws:aws-java-sdk-s3' testCompile group: 'junit', name: 'junit', version: '4.12'}

run { if (project.hasProperty("appArgs")) { args Eval.me(appArgs) }}

mainClassName = 'App'

El archivo build.gradle anterior incluye la configuración del proyecto que especifica declaracionescomo las siguientes:

• El complemento io.spring.dependency-management se utiliza para importar la lista demateriales (BOM) de AWS SDK for Java de Maven para administrar las dependencias AWS SDKfor Java del proyecto. classpath declara la versión que se utilizará. Para utilizar otra versión,reemplace este número de versión.

• com.amazonaws:aws-java-sdk-s3 incluye la parte de Amazon S3 de los archivos de bibliotecade AWS SDK for Java. mavenBom declara la versión que se utilizará. Si desea utilizar otra versión,reemplace este número de versión.

436

AWS Cloud9 Guía del usuarioPaso 5: Configurar la administración

de credenciales de AWS en su entorno

Paso 5: Configurar la administración de credencialesde AWS en su entornoCada vez que utilice el AWS SDK for Java para llamar a un servicio de AWS, debe proporcionar unconjunto de credenciales de AWS con la llamada. Estas credenciales determinan si el AWS SDK forJava tiene los permisos adecuados para realizar esa llamada. Si las credenciales no cubren los permisosadecuados, la llamada no se realizará correctamente.

En este paso, se almacenan las credenciales dentro del entorno. Para ello, siga las instrucciones enLlamar a los servicios de AWS desde un entorno en AWS Cloud9 (p. 76) y, a continuación, vuelva a estetema.

Para obtener más información, consulte Configuración de credenciales y regiones de AWS para desarrolloen la AWS SDK for Java Developer Guide.

Paso 6: Añadir el código del SDK de AWSEn este paso, añadirá código para interactuar con Amazon S3 y crear un bucket, enumerará los bucketsdisponibles y, a continuación, eliminará el bucket que acaba de crear.

En la ventana Environment (Entorno) abra el archivo my-app/src/main/java/com/mycompany/app/App.java para Maven o el archivo my-app/src/main/java/App.java para Gradle. En el editor,reemplace el contenido actual del archivo por el siguiente código y, a continuación, guarde el archivoApp.java.

package com.mycompany.app;

import com.amazonaws.auth.profile.ProfileCredentialsProvider;import com.amazonaws.services.s3.AmazonS3;import com.amazonaws.services.s3.AmazonS3ClientBuilder;import com.amazonaws.services.s3.model.AmazonS3Exception;import com.amazonaws.services.s3.model.Bucket;import com.amazonaws.services.s3.model.CreateBucketRequest;

import java.util.List;

public class App {

private static AmazonS3 s3;

public static void main(String[] args) { if (args.length < 2) { System.out.format("Usage: <the bucket name> <the AWS Region to use>\n" + "Example: my-test-bucket us-east-2\n"); return; }

String bucket_name = args[0]; String region = args[1];

s3 = AmazonS3ClientBuilder.standard() .withCredentials(new ProfileCredentialsProvider()) .withRegion(region) .build();

// List current buckets. ListMyBuckets();

// Create the bucket. if (s3.doesBucketExistV2(bucket_name)) {

437

https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/setup-credentials.html

AWS Cloud9 Guía del usuarioPaso 7: Compilar y ejecutar el código del SDK de AWS

System.out.format("\nCannot create the bucket. \n" + "A bucket named '%s' already exists.", bucket_name); return; } else { try { System.out.format("\nCreating a new bucket named '%s'...\n\n", bucket_name); s3.createBucket(new CreateBucketRequest(bucket_name, region)); } catch (AmazonS3Exception e) { System.err.println(e.getErrorMessage()); } }

// Confirm that the bucket was created. ListMyBuckets();

// Delete the bucket. try { System.out.format("\nDeleting the bucket named '%s'...\n\n", bucket_name); s3.deleteBucket(bucket_name); } catch (AmazonS3Exception e) { System.err.println(e.getErrorMessage()); }

// Confirm that the bucket was deleted. ListMyBuckets();

}

private static void ListMyBuckets() { List<Bucket> buckets = s3.listBuckets(); System.out.println("My buckets now are:");

for (Bucket b : buckets) { System.out.println(b.getName()); } }

}

Paso 7: Compilar y ejecutar el código del SDK deAWSPara ejecutar el código desde el paso anterior, ejecute los siguientes comandos desde el terminal. Estoscomandos usan Maven o Gradle para crear un archivo JAR ejecutable para el proyecto y, a continuación,usan el ejecutador de Java para ejecutar el archivo JAR. El archivo JAR se ejecuta con el nombre delbucket a crear en Amazon S3 (por ejemplo, my-test-bucket) y el ID de la Región de AWS para crear elbucket como entrada (por ejemplo, us-east-2).

Para Maven, ejecute los siguientes comandos.

cd my-appmvn packagejava -cp target/my-app-1.0-SNAPSHOT-jar-with-dependencies.jar com.mycompany.app.App my-test-bucket us-east-2

Para Gradle, ejecute los siguientes comandos.

gradle buildgradle run -PappArgs="['my-test-bucket', 'us-east-2']"

438


Compare sus resultados con la siguiente salida.

My buckets now are:

Creating a new bucket named 'my-test-bucket'...

My buckets now are:

my-test-bucket

Deleting the bucket named 'my-test-bucket'...

My buckets now are:


Demostración de C++ para AWS Cloud9Esta demostración le permite ejecutar determinado código C++ en un entorno de desarrollo de AWSCloud9.


Temas• Requisitos previos (p. 439)• Paso 1: Instalar las herramientas necesarias (p. 440)• Paso 2: Añadir el código (p. 440)• Paso 3: Ejecutar el código (p. 441)• Paso 4: Instalar y configurar el AWS SDK para C++ (p. 442)• Paso 5: Añadir el código del SDK de AWS (p. 444)• Paso 6: Compilar y ejecutar el código del SDK de AWS (p. 447)• Paso 7: Eliminación (p. 448)




439





Paso 1: Instalar las herramientas necesariasEn este paso instalará y configurará GNU Complier Collection (GCC), necesario para ejecutar esteejemplo.

1. En una sesión de terminal en AWS Cloud9 IDE, confirme si GCC ya se ha instalado ejecutando elcomando g++ --version . [Para iniciar una nueva sesión del terminal, en la barra de menús,seleccione Window (Ventana), New Terminal (Nuevo terminal)]. Si es así, el resultado contendrá elnúmero de versión de GCC. De lo contrario, se debería obtener un mensaje de error como resultado.Si GCC está instalado, continúe en Paso 2: Añadir el código (p. 440).

2. Ejecute el comando yum update (para Amazon Linux) o apt update (para Ubuntu Server) paragarantizar que las últimas actualizaciones de seguridad y correcciones de errores están instaladas.

En Amazon Linux:

sudo yum -y update

Para Ubuntu Server:

sudo apt update

3. Para instalar GCC, ejecute el comando yum install (para Amazon Linux) o el comando aptinstall (para Ubuntu Server).

En Amazon Linux:

sudo yum -y install gcc-c++

Para Ubuntu Server:

sudo apt install -y g++

4. Confirme que GCC se ha instalado correctamente ejecutando el comando g++ --version. Si esasí, el resultado contendrá el número de versión de GCC.

Paso 2: Añadir el códigoEn el AWS Cloud9 IDE, cree un archivo con este contenido y guárdelo con el nombre hello.cpp. [Paracrear un archivo, en la barra de menús, elija File (Archivo), New File (Nuevo archivo). Para guardar elarchivo, elija File (Archivo), Save (Guardar).

#include <iostream>#include <stdlib.h>

int main( int argc, char *argv[] ){ std::cout << "Hello, World!\n"; std::cout << "The sum of 2 and 3 is 5.\n";

if (argc > 2) { std::cout << "The sum of " << argv[1] << " and " << argv[2] << " is " << atoi(argv[1]) + atoi(argv[2]) << ".\n"; }

return 0;

440

https://gcc.gnu.org/


}

Paso 3: Ejecutar el código1. Compile el código fuente hello.cpp en un módulo de objetos y, a continuación, vincule este módulo

de objetos a un programa llamado hello. Para ello, elija Run (Ejecutar), Build System (Sistema decompilación), G++ seguido de Run (Ejecutar), Build (Compilación) en la barra de menús.

Note

Si G++ no está disponible, puede crear un generador personalizado para G++.

1. Elija Run (Ejecutar), Build System (Sistema de compilación), New Build System (Nuevosistema de compilación) en la barra de menús.

2. En la pestaña My Builder.build (Mi Builder.build), sustituya el contenido de la pestaña poreste código.

{ "cmd": [ "g++", "-o", "$file_base_name", "$file_name" ], "info": "Compiling $file_name and linking to $file_base_name...", "selector": "source.cpp"}

3. Elija File (Archivo), Save As (Guardar como) en la barra de menús y, a continuación,guarde el archivo como G++.build en la carpeta /.c9/builders.

4. Elija la pestaña hello.cpp para activarla.5. Elija Run (Ejecutar), Build System (Sistema de compilación), G++ seguido de Run

(Ejecutar), Build (Compilación).2. En el AWS Cloud9 IDE, ejecute el código seleccionando Run (Ejecutar), Run Configurations

(Configuraciones de ejecución), New Run Configuration (Nueva configuración de ejecución) en labarra de menús.

3. En la pestaña [New] - Idle (Nuevo - Inactivo), elija Runner: Auto (Ejecutor: automático) y, acontinuación, elija C++.

Note

Si C++ no está disponible, puede crear un ejecutor personalizado para C++.

1. En la pestaña [New] - Idle (Nuevo - Inactivo), elija Runner: Auto (Ejecutor: automático) y, acontinuación, elija New Runner (Ejecutor nuevo).

2. En la pestaña My Runner.run (Mi Runner.run), sustituya el contenido de la pestaña poreste código.

{ "cmd" : ["$file", "$args"], "info" : "Running $project_path$file_name...", "selector" : "source"}

3. Elija File (Archivo), Save As (Guardar como) en la barra de menús y, a continuación,guarde el archivo como C++.run en la carpeta /.c9/runners.


4. En Command (Comando), escriba hello 5 9. En el código, 5 representa argv[1] y 9 representaargv[2].

5. Elija el botón Run (Ejecutar) y compare los resultados.441

AWS Cloud9 Guía del usuarioPaso 4: Instalar y configurar el AWS SDK para C++


Paso 4: Instalar y configurar el AWS SDK para C++Puede mejorar esta muestra para utilizar el AWS SDK para C++ y crear un bucket de Amazon S3, mostraruna lista de los buckets que tiene disponibles y, a continuación, eliminar el bucket que acaba de crear.

En este paso, se instala y se configura el AWS SDK para C++, que proporciona una forma cómodapara interactuar con los servicios de AWS, como Amazon S3, desde el código C++. Antes de instalar elAWS SDK para C++, debe instalar algunas dependencias. Una vez instalado el AWS SDK para C++,debe configurar la administración de credenciales en su entorno. El AWS SDK para C++ necesita estascredenciales para interactuar con los servicios de AWS.

Note

Para llevar a cabo los siguientes pasos es necesario que su entorno se esté ejecutando en unainstancia Amazon EC2 o en un servidor propio que tenga al menos 4 GB de RAM.

Para instalar las dependencias de AWS SDK para C++Desde una sesión de terminal en el AWS Cloud9 IDE, ejecute el siguiente comando para instalar variospaquetes de los que el AWS SDK para C++ depende para ejecutarse correctamente.

En Amazon Linux:

sudo yum -y install libcurl-devel openssl-devel libuuid-devel cmake3

Para Ubuntu Server:

sudo apt install -y libcurl4-openssl-dev libssl-dev uuid-dev zlib1g-dev libpulse-dev cmake

Para descargar y extraer el código fuente del AWS SDK para C++1. Ejecute el comando wget especificando la ubicación del código fuente del AWS SDK para C++.

wget https://github.com/aws/aws-sdk-cpp/archive/master.zip

2. Ejecute el comando unzip especificando el nombre del archivo.zip que acaba de descargar.

unzip master.zip

3. Ejecute el comando rm para eliminar el archivo .zip, dado que ya no lo necesita.

rm master.zip

442

AWS Cloud9 Guía del usuarioPaso 4: Instalar y configurar el AWS SDK para C++

Para compilar el AWS SDK para C++Note

Este paso podría tardar una o varias horas en completarse en función de los recursos informáticosdisponibles en su instancia Amazon EC2 o en su propio servidor y de qué parte del AWS SDKpara C++ haya decidido compilar.

1. Cree una carpeta en la que compilar el AWS SDK para C++.

mkdir sdk_build

2. Cambie a la carpeta que acaba de crear.

cd sdk_build

3. Prepárese para compilar el AWS SDK para C++ en esta carpeta.

En Amazon Linux:

cmake3 ../aws-sdk-cpp-master

Para Ubuntu Server:

cmake ../aws-sdk-cpp-master

Note

Para compilar únicamente la parte de Amazon S3 del AWS SDK para C++ y susdependencias, ejecute este comando:En Amazon Linux:

cmake3 ../aws-sdk-cpp-master -DBUILD_ONLY="s3"

Para Ubuntu Server:

cmake ../aws-sdk-cpp-master -DBUILD_ONLY="s3"

4. Compile el AWS SDK para C++ en esta carpeta.

make

5. Cuando el AWS SDK para C++ se haya compilado correctamente, cambie a la raíz de su entorno.

cd ..

Para configurar la administración de credenciales en su entornoCada vez que utilice el AWS SDK para C++ para llamar a un servicio de AWS, debe proporcionar unconjunto de credenciales con la llamada. Estas credenciales determinan si el AWS SDK para C++ tiene lospermisos adecuados para realizar esa llamada. Si las credenciales no cubren los permisos adecuados, lallamada no se realizará correctamente.

443

AWS Cloud9 Guía del usuarioPaso 5: Añadir el código del SDK de AWS


Para obtener información adicional, consulte el tema sobre cómo proporcionar credenciales de AWS en laGuía para desarrolladores de AWS SDK para C++.

Paso 5: Añadir el código del SDK de AWSEn este paso, añadirá algo más de código, esta vez para interactuar con Amazon S3 y crear un bucket, veruna lista de los buckets disponibles y después eliminar el bucket que acaba de crear. Ejecutará este códigomás adelante.

1. En el AWS Cloud9 IDE, cree un archivo con este contenido y guárdelo con el nombre s3-demo.cppen la raíz (/) de su entorno.

#include <aws/core/Aws.h>#include <aws/s3/S3Client.h>#include <aws/s3/model/Bucket.h>#include <aws/s3/model/CreateBucketConfiguration.h>#include <aws/s3/model/CreateBucketRequest.h>#include <aws/s3/model/DeleteBucketRequest.h>#include <string>

bool ListMyBuckets(Aws::S3::S3Client s3_client);bool CreateMyBucket(Aws::S3::S3Client s3_client, Aws::String bucket_name, Aws::S3::Model::BucketLocationConstraint region);bool DeleteMyBucket(Aws::S3::S3Client s3_client, Aws::String bucket_name);void Cleanup(Aws::SDKOptions options);

int main(int argc, char** argv) {

if (argc < 3) { std::cout << "Usage: ./s3-demo <the bucket name> <the AWS Region to use>" << std::endl << "Example: ./s3-demo my-test-bucket us-west-1" << std::endl; return false; }

Aws::String bucket_name = argv[1]; Aws::Client::ClientConfiguration client_configuration; Aws::S3::Model::BucketLocationConstraint region;

// Set the AWS Region to use, based on the user's AWS Region input ID. if (strcmp(argv[2], "ap-northeast-1") == 0) { client_configuration.region = Aws::Region::AP_NORTHEAST_1; region = Aws::S3::Model::BucketLocationConstraint::ap_northeast_1; } else if (strcmp(argv[2], "ap-northeast-2") == 0) { client_configuration.region = Aws::Region::AP_NORTHEAST_2; region = Aws::S3::Model::BucketLocationConstraint::ap_northeast_2; } else if (strcmp(argv[2], "ap-south-1") == 0) { client_configuration.region = Aws::Region::AP_SOUTH_1; region = Aws::S3::Model::BucketLocationConstraint::ap_south_1; } else if (strcmp(argv[2], "ap-southeast-1") == 0) { client_configuration.region = Aws::Region::AP_SOUTHEAST_1; region = Aws::S3::Model::BucketLocationConstraint::ap_southeast_1; } else if (strcmp(argv[2], "ap-southeast-2") == 0) { client_configuration.region = Aws::Region::AP_SOUTHEAST_2; region = Aws::S3::Model::BucketLocationConstraint::ap_southeast_2; } else if (strcmp(argv[2], "cn-north-1") == 0) { client_configuration.region = Aws::Region::CN_NORTH_1; region = Aws::S3::Model::BucketLocationConstraint::cn_north_1; } else if (strcmp(argv[2], "eu-central-1") == 0) {

444

https://docs.aws.amazon.com/sdk-for-cpp/latest/developer-guide/credentials.html


client_configuration.region = Aws::Region::EU_CENTRAL_1; region = Aws::S3::Model::BucketLocationConstraint::eu_central_1; } else if (strcmp(argv[2], "eu-west-1") == 0) { client_configuration.region = Aws::Region::EU_WEST_1; region = Aws::S3::Model::BucketLocationConstraint::eu_west_1; } else if (strcmp(argv[2], "sa-east-1") == 0) { client_configuration.region = Aws::Region::SA_EAST_1; region = Aws::S3::Model::BucketLocationConstraint::sa_east_1; } else if (strcmp(argv[2], "us-west-1") == 0) { client_configuration.region = Aws::Region::US_WEST_1; region = Aws::S3::Model::BucketLocationConstraint::us_west_1; } else if (strcmp(argv[2], "us-west-2") == 0) { client_configuration.region = Aws::Region::US_WEST_2; region = Aws::S3::Model::BucketLocationConstraint::us_west_2; } else { std::cout << "Unrecognized AWS Region ID '" << argv[2] << "'" << std::endl; return false; }

Aws::SDKOptions options;

Aws::InitAPI(options); { Aws::S3::S3Client s3_client(client_configuration);

if (!ListMyBuckets(s3_client)) { Cleanup(options); }

if (!CreateMyBucket(s3_client, bucket_name, region)) { Cleanup(options); }

if (!ListMyBuckets(s3_client)) { Cleanup(options); }

if (!DeleteMyBucket(s3_client, bucket_name)) { Cleanup(options); }

if (!ListMyBuckets(s3_client)) { Cleanup(options); } } Cleanup(options);}

// List all of your available buckets.bool ListMyBuckets(Aws::S3::S3Client s3_client) { auto outcome = s3_client.ListBuckets();

if (outcome.IsSuccess()) { std::cout << "My buckets now are:" << std::endl << std::endl;

Aws::Vector<Aws::S3::Model::Bucket> bucket_list = outcome.GetResult().GetBuckets();

for (auto const &bucket: bucket_list) { std::cout << bucket.GetName() << std::endl; }

std::cout << std::endl; return true; } else { std::cout << "ListBuckets error: "

445


<< outcome.GetError().GetExceptionName() << std::endl << outcome.GetError().GetMessage() << std::endl;

return false; }}

// Create a bucket in this AWS Region.bool CreateMyBucket(Aws::S3::S3Client s3_client, Aws::String bucket_name, Aws::S3::Model::BucketLocationConstraint region) { std::cout << "Creating a new bucket named '" << bucket_name << "'..." << std::endl << std::endl;

Aws::S3::Model::CreateBucketConfiguration bucket_configuration; bucket_configuration.WithLocationConstraint(region);

Aws::S3::Model::CreateBucketRequest bucket_request; bucket_request.WithBucket(bucket_name).WithCreateBucketConfiguration(bucket_configuration);

auto outcome = s3_client.CreateBucket(bucket_request);

if (outcome.IsSuccess()) { return true; } else { std::cout << "CreateBucket error: " << outcome.GetError().GetExceptionName() << std::endl << outcome.GetError().GetMessage() << std::endl;

return false; }}

// Delete the bucket you just created.bool DeleteMyBucket(Aws::S3::S3Client s3_client, Aws::String bucket_name) { std::cout << "Deleting the bucket named '" << bucket_name << "'..." << std::endl << std::endl;

Aws::S3::Model::DeleteBucketRequest bucket_request; bucket_request.WithBucket(bucket_name);

auto outcome = s3_client.DeleteBucket(bucket_request);

if (outcome.IsSuccess()) { return true; } else { std::cout << "DeleteBucket error: " << outcome.GetError().GetExceptionName() << std::endl << outcome.GetError().GetMessage() << std::endl;

return false; }}

void Cleanup(Aws::SDKOptions options) { Aws::ShutdownAPI(options);}

2. Cree un archivo con este contenido y guárdelo con el nombre CMakeLists.txt en la raíz (/) de suentorno. Este archivo le permite compilar el código en un archivo ejecutable.

# A minimal CMakeLists.txt file for the AWS SDK for C++.

446


# The minimum version of CMake that will work.cmake_minimum_required(VERSION 2.8)

# The project name.project(s3-demo)

# Locate the AWS SDK for C++ package.# Requires that you build with:# -Daws-sdk-cpp_DIR=/path/to/sdk_build# or export/set:# CMAKE_PREFIX_PATH=/path/to/sdk_buildfind_package(aws-sdk-cpp)

# Link to the AWS SDK for C++ shared libraries.add_definitions(-DUSE_IMPORT_EXPORT)

# The executable name and its source files.add_executable(s3-demo s3-demo.cpp)

# The libraries used by your executable.target_link_libraries(s3-demo aws-cpp-sdk-s3)

Paso 6: Compilar y ejecutar el código del SDK deAWS1. Prepárese para compilar el código fuente en el terminal.

En Amazon Linux:

cmake3 -Daws-sdk-cpp_DIR=sdk_build .

Para Ubuntu Server:

cmake -Daws-sdk-cpp_DIR=sdk_build .

2. Compile su código fuente.

make

3. Ejecute el código seleccionando Run (Ejecutar), Run Configurations (Configuraciones de ejecución),New Run Configuration (Nueva configuración de ejecución) en la barra de menús.


5. En Command (Comando), escriba s3-demo my-test-bucket us-east-2, donde my-test-bucket es el nombre del bucket que quiere crear y después eliminar y us-east-2 es el ID de laregión de AWS en la que desea crear el bucket. Para obtener más ID, consulte Amazon SimpleStorage Service (Amazon S3) en la Referencia general de Amazon Web Services.

Note

Los nombres de bucket de Amazon S3 deben ser únicos en AWS, no solo en la cuenta deAWS.

6. Elija el botón Run (Ejecutar) y compare los resultados.

My buckets now are:

447

https://docs.aws.amazon.com/general/latest/gr/rande.html#s3_region




My buckets now are:

my-test-bucket


My buckets now are:


Tutorial de Python para AWS Cloud9Este tutorial le muestra cómo ejecutar el código de Python en un entorno de desarrollo de AWS Cloud9.

El uso de este tutorial puede producir cargos en su cuenta de AWS. Entre estos se incluyen posiblescargos por servicios como, por ejemplo, de Amazon Elastic Compute Cloud (Amazon EC2) y AmazonSimple Storage Service (Amazon S3). Para obtener más información, consulte Precios de Amazon EC2 yPrecios de Amazon S3.

Temas• Requisitos previos (p. 448)• Paso 1: Instalar Python 3.6 (p. 449)• Paso 2: Añadir el código (p. 449)• Paso 3: Ejecutar el código (p. 449)• Paso 4: Instalar y configurar AWS SDK para Python (Boto 3) (p. 450)• Paso 5: Añadir el código del SDK de AWS (p. 451)• Paso 6: Ejecutar código del SDK de AWS (p. 452)• Paso 7: Eliminación (p. 452)


• Tiene un entorno de desarrollo de EC2 de AWS Cloud9

En este tutorial se supone que tiene un entorno de EC2 y que el entorno está conectado a una instanciaAmazon EC2 que ejecuta Amazon Linux o Ubuntu Server. Consulte Creación de un entorno deEC2 (p. 62) para obtener más información.

Si tiene un tipo de entorno o sistema operativo distinto, es posible que tenga que adaptar lasinstrucciones de este tutorial.

• Ha abierto el AWS Cloud9 IDE para ese entorno

Al abrir un entorno, AWS Cloud9 abre el IDE de ese entorno en el navegador web. Para obtener másinformación, consulte Apertura de un entorno en AWS Cloud9 (p. 74).

448



AWS Cloud9 Guía del usuarioPaso 1: Instalar Python 3.6

Paso 1: Instalar Python 3.61. En una sesión de terminal de AWS Cloud9 IDE, confirme si Python 3.6 ya se ha instalado mediante

la ejecución del comando python --version. (Para iniciar una nueva sesión del terminal, en labarra de menús, seleccione Window [Ventana], New Terminal [Nuevo terminal]). Si Python 3.6 estáinstalado, vaya directamente a Paso 2: Añadir el código (p. 449).

2. Ejecute el comando yum update (para Amazon Linux) o apt update (para Ubuntu Server) paragarantizar que las últimas actualizaciones de seguridad y correcciones de errores están instaladas.

En Amazon Linux:

sudo yum -y update

Para Ubuntu Server:

sudo apt update

3. Instale Python 3.6 mediante la ejecución del comando install.

En Amazon Linux:

sudo yum -y install python36

Para Ubuntu Server:

sudo apt -y install python3

Paso 2: Añadir el códigoEn AWS Cloud9 IDE, cree un archivo con el siguiente contenido y guárdelo con el nombre hello.py.(Para crear un archivo, en la barra de menús, seleccione File [Archivo], New File [Nuevo archivo]. Paraguardar el archivo, elija File (Archivo), Save (Guardar).

import sys

print('Hello, World!')

print('The sum of 2 and 3 is 5.')

sum = int(sys.argv[1]) + int(sys.argv[2])

print('The sum of {0} and {1} is {2}.'.format(sys.argv[1], sys.argv[2], sum))

Paso 3: Ejecutar el código1. En AWS Cloud9 IDE, en la barra de menús, seleccione Run (Ejecutar), Run Configurations (Ejecutar

configuraciones), New Run Configuration (Ejecutar nueva configuración).2. En la pestaña [New] - Stopped ([Nuevo] - Detenido), introduzca hello.py 5 9 en Command

(Comando). En el código, 5 representa sys.argv[1] y 9 representa sys.argv[2].3. Elija Run (Ejecutar) y compare los resultados.

Hello, World!

449

AWS Cloud9 Guía del usuarioPaso 4: Instalar y configurar AWS SDK para Python (Boto 3)

The sum of 2 and 3 is 5.The sum of 5 and 9 is 14.

4. De forma predeterminada, AWS Cloud9 selecciona automáticamente un ejecutor para el código. Paracambiar el ejecutor, seleccione Runner (Ejecutor) y, a continuación, seleccione Python 2 o Python 3.

Note

Puede crear ejecutores personalizados para versiones específicas de Python. Para obtenermás información, consulte Crear un compilador o ejecutor (p. 163).

Paso 4: Instalar y configurar AWS SDK para Python(Boto 3)AWS SDK para Python (Boto 3) le permite utilizar el código de Python para interactuar con los servicios deAWS, como Amazon S3. Por ejemplo, puede utilizar el SDK para crear un bucket de Amazon S3, enumerarlos buckets disponibles y, a continuación, eliminar el bucket que acaba de crear.

Instalar pipEn AWS Cloud9 IDE, confirme si pip ya está instalado en la versión activa de Python al ejecutar elcomando python -m pip --version. Si pip está instalado, vaya a la siguiente sección.

Para instalar pip, ejecute los siguientes comandos. Dado que sudo se encuentra en un entorno diferenteal del usuario, tiene que especificar la versión de Python que va a utilizar si difiere de la versión con aliasactual.

curl -O https://bootstrap.pypa.io/get-pip.py # Get the install script.sudo python36 get-pip.py # Install pip for Python 3.6.python -m pip --version # Verify pip is installed.rm get-pip.py # Delete the install script.

Para obtener más información, consulte Instalación en el sitio web de pip.

Instalar AWS SDK para Python (Boto 3)Después de instalar pip, instale AWS SDK para Python (Boto 3) mediante la ejecución del comando pipinstall.

sudo python36 -m pip install boto3 # Install boto3 for Python 3.6.python -m pip show boto3 # Verify boto3 is installed for the current version of Python.

Para obtener más información, consulte la sección "Installation (Instalación)" de Inicio rápido en AWS SDKpara Python (Boto 3).

Configurar las credenciales en el entornoCada vez que utilice AWS SDK para Python (Boto 3) para llamar a un servicio de AWS, debe proporcionarun conjunto de credenciales con la llamada. Estas credenciales determinan si el SDK tiene los permisosnecesarios para realizar la llamada. Si las credenciales no abarcan los permisos necesarios, se produce unerror en la llamada.

Para almacenar sus credenciales en el entorno, siga las instrucciones del tema Llamar a los servicios deAWS desde un entorno en AWS Cloud9 (p. 76) y, a continuación, vuelva a este tema.

450

https://pip.pypa.io/en/stable/installing/

http://boto3.amazonaws.com/v1/documentation/api/latest/guide/quickstart.html


Para obtener información adicional, consulte Credenciales en AWS SDK para Python (Boto 3).

Paso 5: Añadir el código del SDK de AWSAñada el código que utiliza Amazon S3 para crear un bucket, enumere los buckets disponibles y, de formaopcional, elimine el bucket que acaba de crear.

En AWS Cloud9 IDE, cree un archivo con el siguiente contenido y guárdelo con el nombre s3.py.

import boto3import sysfrom botocore.exceptions import ClientError

def list_my_buckets(s3): print('Buckets:\n\t', *[b.name for b in s3.buckets.all()], sep="\n\t")

def create_and_delete_my_bucket(bucket_name, region, keep_bucket): s3 = boto3.resource('s3', region_name=region)

list_my_buckets(s3)

try: print('\nCreating new bucket:', bucket_name) bucket = s3.create_bucket( Bucket=bucket_name, CreateBucketConfiguration={ 'LocationConstraint': region } ) except ClientError as e: print(e) sys.exit('Exiting the script because bucket creation failed.')

bucket.wait_until_exists() list_my_buckets(s3)

if not keep_bucket: print('\nDeleting bucket:', bucket.name) bucket.delete()

bucket.wait_until_not_exists() list_my_buckets(s3) else: print('\nKeeping bucket:', bucket.name)

def main(): import argparse

parser = argparse.ArgumentParser() parser.add_argument('bucket_name', help='The name of the bucket to create.') parser.add_argument('region', help='The region in which to create your bucket.') parser.add_argument('--keep_bucket', help='Keeps the created bucket. When not specified, the bucket is deleted.', action='store_true')

args = parser.parse_args()

create_and_delete_my_bucket(args.bucket_name, args.region, args.keep_bucket)

if __name__ == '__main__':

451

http://boto3.amazonaws.com/v1/documentation/api/latest/guide/configuration.html

AWS Cloud9 Guía del usuarioPaso 6: Ejecutar código del SDK de AWS

main()

Paso 6: Ejecutar código del SDK de AWS1. En la barra de menús, elija Run (Ejecutar), Run Configurations (Configuraciones de ejecución), New

Run Configuration (Nueva configuración de ejecución).2. En Command (Comando), introduzca s3.py my-test-bucket us-west-2, donde my-test-

bucket es el nombre del bucket que va a crear y us-west-2 es el ID de la región de AWS en la quese ha creado el bucket. De forma predeterminada, el bucket se elimina antes de que el script salga.Para conservar el bucket, añada --keep_bucket al comando. Para obtener una lista de los ID deregión de AWS, consulte Cuotas y puntos de enlace de Amazon Simple Storage Service en la AWSGeneral Reference.

Note


3. Elija Run (Ejecutar) y compare los resultados.

Buckets:

a-pre-existing-bucket

Creating new bucket: my-test-bucketBuckets:

a-pre-existing-bucket my-test-bucket

Deleting bucket: my-test-bucketBuckets:

a-pre-existing-bucket

Paso 7: EliminaciónPara evitar que se hagan cargos continuos en su cuenta de AWS cuando finalice este tutorial, elimineel entorno de AWS Cloud9. Para obtener instrucciones, consulte Eliminación de un entorno en AWSCloud9 (p. 103).

Muestra de .NET Core para AWS Cloud9Esta muestra le permite ejecutar código ,NET Core en un entorno de desarrollo de AWS Cloud9.


Temas• Requisitos previos (p. 453)• Paso 1: Instalar las herramientas necesarias (p. 453)• Paso 2: Crear un proyecto de aplicación de consola de .NET Core (p. 455)

452

https://docs.aws.amazon.com/general/latest/gr/s3.html





• Paso 3: Añadir el código (p. 455)• Paso 4: Compilar y ejecutar el código (p. 456)• Paso 5: Crear y configurar el proyecto de aplicación de consola de .NET Core que usa AWS SDK

para .NET (p. 457)• Paso 6: Añadir el código del SDK de AWS (p. 458)• Paso 7: Compilar y ejecutar el código del SDK de AWS (p. 460)• Paso 8: Eliminación (p. 460)




Paso 1: Instalar las herramientas necesariasEn este paso, debe instalar el SDK de .NET Core 2 en su entorno, lo cual es necesario para ejecutar estamuestra.

1. Confirme si el SDK de .NET Core 2 ya está instalado en su entorno. Para ello, en una sesión determinal en AWS Cloud9 IDE, ejecute la interfaz de la línea de comandos (CLI) de .NET Core con laopción --version .

dotnet --version

Si se muestra la versión de las herramientas de la línea de comandos de .NET y es la versión 2.0 oposterior, vaya a Paso 2: Crear un proyecto de aplicación de consola de .NET Core (p. 455). Si laversión es anterior a 2.0, o si se muestra un error como bash: dotnet: command not found,continúe con la instalación del SDK de .NET Core 2.

2. Para Amazon Linux, en una sesión de terminal en el AWS Cloud9 IDE, ejecute los siguientescomandos para garantizar que se instalen las últimas actualizaciones de seguridad y correccionesde errores, así como para instalar un paquete libunwind que necesita el SDK de .NET Core 2.(Para iniciar una nueva sesión del terminal, en la barra de menús, seleccione Window, New Terminal[Ventana, Nuevo terminal]).

sudo yum -y updatesudo yum -y install libunwind

Para Ubuntu Server, en una sesión de terminal en el AWS Cloud9 IDE, ejecute el siguiente comandopara garantizar que se instalen las últimas actualizaciones de seguridad y correcciones de errores.[Para iniciar una nueva sesión del terminal, en la barra de menús, seleccione Window, New Terminal(Ventana, Nuevo terminal)].

sudo apt -y update

453


3. Descargue el script de instalación del SDK de .NET Core 2 en el entorno ejecutando el siguientecomando.

curl -O https://dot.net/v1/dotnet-install.sh

4. Haga que el script de instalación sea ejecutable por el usuario actual mediante la ejecución delsiguiente comando.

sudo chmod u=rx dotnet-install.sh

5. Ejecute el script de instalación, que descarga e instala el SDK de .NET Core 2, ejecutando el siguientecomando.

./dotnet-install.sh -c Current

6. Añada el SDK de .NET Core 2 a su PATH. Para ello, en el perfil de shell para el entorno (por ejemplo,el archivo .bashrc), añada el subdirectorio $HOME/.dotnet a la variable PATH para el entorno,como sigue.

a. Abra el archivo .bashrc para editarlo mediante el comando vi .

vi ~/.bashrc

b. Para Amazon Linux, con la flecha hacia abajo o la tecla j, vaya a la línea que comienza porexport PATH.

Para Ubuntu Server, vaya a la última línea del archivo escribiendo G.c. Con la flecha derecha o la tecla $, vaya al final de esa línea.d. Cambie a modo de inserción pulsando la tecla i. (Aparecerá -- INSERT --- al final de la

pantalla).e. Para Amazon Linux, añada el subdirectorio $HOME/.dotnet a la variable PATH escribiendo :

$HOME/.dotnet. Asegúrese de incluir el carácter de dos puntos (:). La línea ahora debería tenerun aspecto similar al siguiente.

export PATH=$PATH:$HOME/.local/bin:$HOME/bin:$HOME/.dotnet

Para Ubuntu Server, pulse la tecla de flecha derecha, pulse Enter dos veces y, a continuación,escriba la siguiente línea sola al final del archivo.

export PATH=$HOME/.dotnet:$PATH

f. Guarde el archivo. Para ello, pulse la tecla Esc (desaparecerá -- INSERT --- desde el final dela pantalla), escriba :wq (para escribir y, a continuación, salir del archivo) y, a continuación, pulseEnter.

7. Cargue el SDK de .NET Core 2 SDK mediante el aprovisionamiento del archivo .bashrc.

. ~/.bashrc

8. Confirme que el SDK de .NET Core 2 está cargado mediante la ejecución de la CLI de .NET Core conla opción --help .

dotnet --help

Si se ejecuta correctamente, se muestra el número de versión del SDK de .NET Core 2, coninformación de uso adicional.

454

AWS Cloud9 Guía del usuarioPaso 2: Crear un proyecto de

aplicación de consola de .NET Core

9. Si ya no desea mantener el script de instalación del SDK de .NET Core 2 en su entorno, puedeeliminarlo del siguiente modo.

rm dotnet-install.sh

Paso 2: Crear un proyecto de aplicación de consolade .NET CoreEn este paso, se utiliza .NET Core para crear un proyecto denominado hello. Este proyecto contienetodos los archivos que necesita .NET Core para ejecutar una aplicación simple desde el terminal en el IDE.El código de la aplicación está escrito en C#.

1. En el terminal, ejecute los siguientes comandos para crear un directorio para el proyecto y, acontinuación, cambie a ese nuevo directorio.

mkdir hellocd hello

2. Cree un proyecto de aplicación de consola de .NET Core. Para ello, ejecute la CLI de .NET Core conel comando new , especificando el tipo de plantilla de proyecto de aplicación de consola y el lenguajede programación que se utilizará (en esta muestra, C#).

dotnet new console -lang C#

El comando anterior añade un subdirectorio llamado obj con varios archivos, y algunos archivosindependientes adicionales, al directorio hello. Debe tener en cuenta los dos archivos clavesiguientes:

• El archivo hello/hello.csproj contiene información sobre el proyecto de aplicación de consola.• El archivo hello/Program.cs contiene el código de la aplicación que se ejecutará.

Paso 3: Añadir el códigoEn este paso, añadirá código a la aplicación.

En la ventana entorno en el AWS Cloud9 IDE, abra el archivo hello/Program.cs.

En el editor, reemplace el contenido actual del archivo por el siguiente código y, a continuación, guarde elarchivo Program.cs.

using System;

namespace hello{ class Program { static void Main(string[] args) { Console.WriteLine("Hello, World!");

Console.WriteLine("The sum of 2 and 3 is 5.");

int sum = Int32.Parse(args[0]) + Int32.Parse(args[1]);

455

AWS Cloud9 Guía del usuarioPaso 4: Compilar y ejecutar el código

Console.WriteLine("The sum of {0} and {1} is {2}.", args[0], args[1], sum.ToString()); } }}

Paso 4: Compilar y ejecutar el códigoEn este paso, compilará el proyecto y sus dependencias en un conjunto de archivos binarios, incluido unarchivo de aplicación ejecutable. A continuación, ejecutará la aplicación.

1. En el IDE, cree un constructor para .NET Core de la siguiente manera.

a. En la barra de menús, seleccione Run, Build System, New Build System (Ejecutar, Sistema decompilación, Nuevo sistema de compilación).

b. En la pestaña My Builder.build (Mi Builder.build), reemplace el contenido de la pestaña por elcódigo siguiente.

{ "cmd" : ["dotnet", "build"], "info" : "Building..."}

c. Elija File, Save As (Archivo, Guardar como).d. En Filename (Nombre de archivo), escriba .NET Core.build.e. En Folder (Carpeta), escriba /.c9/builders.f. Seleccione Save.

2. Con el contenido del archivo Program.cs mostrado en el editor, seleccione Run, Build System, .NETCore (Ejecutar, Sistema de compilación, .NET Core). A continuación, elija Run, Build (Ejecutar,Compilar).

Este constructor añade los subdirectorios bin y Debug al subdirectorio hello/obj. Tenga en cuentalos siguientes tres archivos clave.

• El archivo hello/bin/Debug/netcoreapp2.0/hello.dll es el archivo de aplicaciónejecutable.

• El archivo hello/bin/Debug/netcoreapp2.0/hello.deps.json enumera las dependenciasde la aplicación.

• El archivo hello/bin/Debug/netcoreapp2.0/hello.runtimeconfig.json especifica eltiempo de ejecución compartido y su versión para la aplicación.

3. Cree un ejecutor para .NET Core de la siguiente manera.

a. En la barra de menús, seleccione Run, Run With, New Runner (Ejecutar, Ejecutar con, Nuevoejecutor).

b. En la pestaña My Runner.run (Mi Runner.run), reemplace el contenido de la pestaña por el códigosiguiente.

{ "cmd" : ["dotnet", "run", "$args"], "working_dir": "$file", "info" : "Running..."}

c. Elija File, Save As (Archivo, Guardar como).d. En Filename (Nombre de archivo), escriba .NET Core.run.e. En Folder (Carpeta), escriba /.c9/runners.

456

AWS Cloud9 Guía del usuarioPaso 5: Crear y configurar el proyecto de aplicación deconsola de .NET Core que usa AWS SDK para .NET

f. Seleccione Save.4. Ejecute la aplicación con dos números enteros que se añadirán (por ejemplo, 5 y 9) de la siguiente

manera.

a. Con el contenido del archivo Program.cs mostrado en el editor, seleccione Run, RunConfigurations, New Run Configuration (Ejecutar, Configuraciones de ejecución, Nuevaconfiguración de ejecución).

b. En la pestaña [New] - Idle (Nuevo - Inactivo), elija Runner: Auto (Ejecutor: automático) y, acontinuación, elija .NET Core.

c. En el cuadro Command (Comando), escriba hello 5 9.d. Elija Run.

De forma predeterminada, este ejecutor indica a .NET Core que ejecute el archivo hello.dll enel directorio hello/bin/Debug/netcoreapp2.0.

Compare la salida con la siguiente.


Paso 5: Crear y configurar el proyecto de aplicación deconsola de .NET Core que usa AWS SDK para .NETPuede mejorar esta muestra para utilizar el AWS SDK para .NET y crear un bucket de Amazon S3, mostraruna lista de los buckets que tiene disponibles y, a continuación, eliminar el bucket que acaba de crear.

En este nuevo proyecto, añada una referencia al AWS SDK para .NET. El AWS SDK para .NETproporciona una forma cómoda de interactuar con servicios de AWS, como Amazon S3, desde sucódigo .NET. A continuación, configure la administración de credenciales de AWS en su entorno. El AWSSDK para .NET necesita estas credenciales para interactuar con los servicios de AWS.

Para crear el proyecto1. En el terminal, ejecute los siguientes comandos para cambiar al directorio raíz de entorno, cree un

directorio para un proyecto denominado s3 y, a continuación, cambie a ese nuevo directorio.

cd ..mkdir s3cd s3

2. Cree un proyecto de aplicación de consola de .NET Core. Para ello, ejecute la CLI de .NET Core conel comando new , especificando el tipo de plantilla de proyecto de aplicación de consola y el lenguajede programación que se utilizará.

dotnet new console -lang C#

3. Añada una referencia de proyecto al paquete de Amazon S3 en el AWS SDK para .NET. Para ello,ejecute la CLI de .NET Core con el comando add package , especificando el nombre del paquetede Amazon S3 en NuGet. (NuGet define cómo se crean, alojan y consumen los paquetes para .NET, yproporciona las herramientas para cada uno de esos roles).

dotnet add package AWSSDK.S3

457


Al agregar una referencia de proyecto al paquete de Amazon S3, NuGet también añade una referenciade proyecto al resto del AWS SDK para .NET.

Note

En el caso de nombres y versiones de otros paquetes relacionados con AWS en NuGet,consulte Paquetes de NuGet etiquetados con aws-sdk en el sitio web NuGet.

Para configurar la administración de credenciales de AWSCada vez que utilice el AWS SDK para .NET para llamar a un servicio de AWS, debe proporcionarun conjunto de credenciales de AWS con la llamada. Estas credenciales determinan si el AWS SDKpara .NET tiene los permisos adecuados para realizar esa llamada. Si las credenciales no cubren lospermisos adecuados, la llamada no se realizará correctamente.

Para almacenar sus credenciales en el entorno, siga las instrucciones del tema Llamar a los servicios deAWS desde un entorno en AWS Cloud9 (p. 76) y, a continuación, vuelva a este tema.

Para obtener información adicional, consulte Configuración de credenciales de AWS en la AWS SDKpara .NET Developer Guide.

Paso 6: Añadir el código del SDK de AWSEn este paso, añadirá código para interactuar con Amazon S3 y crear un bucket, eliminará el bucket queacaba de crear y, a continuación, enumerar los buckets disponibles.

En la ventana Environment (Entorno) en AWS Cloud9 IDE, abra el archivo s3/Program.cs. En el editor,reemplace el contenido actual del archivo por el siguiente código y, a continuación, guarde el archivoProgram.cs.

using Amazon;using Amazon.S3;using Amazon.S3.Model;using Amazon.S3.Util;using System;using System.Threading.Tasks;

namespace s3{ class Program { private static RegionEndpoint bucketRegion; private static IAmazonS3 s3Client;

static void Main(string[] args) { if (args.Length < 2) { Console.Write("Usage: <the bucket name> <the AWS Region to use>\n" + "Example: my-test-bucket us-east-2\n"); return; }

if (args[1] == "us-east-2") { bucketRegion = RegionEndpoint.USEast2; } else { Console.WriteLine("Cannot continue. The only supported AWS Region ID is " + "'us-east-2'."); return; } // Note: You could add more valid AWS Regions above as needed.

458

https://www.nuget.org/packages?q=Tags%3A%22aws-sdk%22

https://docs.aws.amazon.com/sdk-for-net/latest/developer-guide/net-dg-config-creds.html


s3Client = new AmazonS3Client(bucketRegion); var bucketName = args[0];

// Create the bucket. try { if (DoesBucketExist(bucketName)) { Console.WriteLine("Cannot continue. Cannot create bucket. \n" + "A bucket named '{0}' already exists.", bucketName); return; } else { Console.WriteLine("\nCreating the bucket named '{0}'...", bucketName); s3Client.PutBucketAsync(bucketName).Wait(); } } catch (AmazonS3Exception e) { Console.WriteLine("Cannot continue. {0}", e.Message); } catch (Exception e) { Console.WriteLine("Cannot continue. {0}", e.Message); }

// Confirm that the bucket was created. if (DoesBucketExist(bucketName)) { Console.WriteLine("Created the bucket named '{0}'.", bucketName); } else { Console.WriteLine("Did not create the bucket named '{0}'.", bucketName); }

// Delete the bucket. Console.WriteLine("\nDeleting the bucket named '{0}'...", bucketName); s3Client.DeleteBucketAsync(bucketName).Wait();

// Confirm that the bucket was deleted. if (DoesBucketExist(bucketName)) { Console.WriteLine("Did not delete the bucket named '{0}'.", bucketName); } else { Console.WriteLine("Deleted the bucket named '{0}'.", bucketName); };

// List current buckets. Console.WriteLine("\nMy buckets now are:"); var response = s3Client.ListBucketsAsync().Result;

foreach (var bucket in response.Buckets) { Console.WriteLine(bucket.BucketName); } }

static bool DoesBucketExist(string bucketName) { if ((AmazonS3Util.DoesS3BucketExistAsync(s3Client, bucketName).Result)) { return true; } else { return false; } } }

459


}

Paso 7: Compilar y ejecutar el código del SDK deAWSEn este paso, compilará el proyecto y sus dependencias en un conjunto de archivos binarios, incluido unarchivo de aplicación ejecutable. A continuación, ejecutará la aplicación.

1. Compile el proyecto. Para ello, con el contenido del archivo s3/Program.cs mostrado en el editor,en la barra de menú, elija Run, Build (Ejecutar, Compilar).

2. Ejecute la aplicación con el nombre del bucket de Amazon S3 a crear y el ID de la región de AWS paracrear el bucket (por ejemplo, my-test-bucket y us-east-2) de la siguiente manera.

a. Con el contenido del archivo s3/Program.cs aún mostrado en el editor, seleccione Run,Run Configurations, New Run Configuration (Ejecutar, Configuraciones de ejecución, Nuevaconfiguración de ejecución).

b. En la pestaña [New] - Idle (Nuevo - Inactivo), elija Runner: Auto (Ejecutor: automático) y, acontinuación, elija .NET Core.

c. En el cuadro Command (Comando), escriba el nombre de la aplicación, el nombre del bucket deAmazon S3 a crear y el ID de la región de AWS para crear el bucket (por ejemplo, s3 my-test-bucket us-east-2).

d. Elija Run.

De forma predeterminada, este ejecutor indica a .NET Core que ejecute el archivo s3.dll en eldirectorio s3/bin/Debug/netcoreapp2.0.

Compare sus resultados con la siguiente salida.

Creating a new bucket named 'my-test-bucket'...Created the bucket named 'my-test-bucket'.

Deleting the bucket named 'my-test-bucket'...Deleted the bucket named 'my-test-bucket'.

My buckets now are:


Ejemplo de Node.js para AWS Cloud9Esta muestra permite ejecutar scripts de Node.js en un entorno de desarrollo de AWS Cloud9.


Temas• Requisitos previos (p. 461)

460





• Paso 1: Instalar las herramientas necesarias (p. 461)• Paso 2: Añadir el código (p. 462)• Paso 3: Ejecutar el código (p. 462)• Paso 4: Instalar y configurar el AWS SDK for JavaScript in Node.js (p. 463)• Paso 5: Añadir el código del SDK de AWS (p. 463)• Paso 6: Ejecutar código del SDK de AWS (p. 465)• Paso 7: Eliminación (p. 465)




Paso 1: Instalar las herramientas necesariasEn este paso instalará Node.js, necesario para ejecutar esta muestra.

1. En una sesión del terminal del AWS Cloud9 IDE, confirme si Node.js, ya se ha instalado ejecutandoel comando node --version . [Para iniciar una nueva sesión del terminal, en la barra demenús, seleccione Window (Ventana), New Terminal (Nuevo terminal)]. Si es así, el resultadocontendrá el número de versión de Node.js. Si Node.js está instalado, continúe en Paso 2: Añadir elcódigo (p. 462).

2. Ejecute el comando yum update para (Amazon Linux) o apt update para (Ubuntu Server) paragarantizar que las últimas actualizaciones de seguridad y correcciones de errores están instaladas.

En Amazon Linux:

sudo yum -y update

Para Ubuntu Server:

sudo apt update

3. Para instalar Node.js, comience por ejecutar este comando para descargar Node Version Manager(nvm). (nvm es un sencillo script de shell Bash que resulta útil para instalar y administrar versiones deNode.js. Para obtener más información, consulte Node Version Manager en el sitio web de GitHub).


4. Para comenzar a utilizar nvm, cierre la sesión del terminal e iníciela de nuevo, o cargue el archivo~/.bashrc que contiene los comandos para cargar nvm.

. ~/.bashrc

461



5. Ejecute este comando para instalar la versión más reciente de Node.js.

nvm install node

Paso 2: Añadir el códigoEn el AWS Cloud9 IDE, cree un archivo con este contenido y guárdelo con el nombre hello.js. [Paracrear un archivo, en la barra de menús, elija File (Archivo), New File (Nuevo archivo). Para guardar elarchivo, elija File (Archivo), Save (Guardar).

console.log('Hello, World!');

console.log('The sum of 2 and 3 is 5.');

var sum = parseInt(process.argv[2], 10) + parseInt(process.argv[3], 10);

console.log('The sum of ' + process.argv[2] + ' and ' + process.argv[3] + ' is ' + sum + '.');

Paso 3: Ejecutar el código1. En el AWS Cloud9 IDE, en la barra de menús, elija Run (Ejecutar), Run Configurations

(Configuraciones de ejecución), New Run Configuration (Nueva configuración de ejecución).2. En la pestaña [New] - Idle (Nuevo - Inactivo), elija Runner: Auto (Ejecutor: automático) y, a

continuación, elija Node.js.3. En Command (Comando), escriba hello.js 5 9. En el código, 5 representa process.argv[2] y

9 representa process.argv[3]. (process.argv[0] representa el nombre del tiempo de ejecución(node) y process.argv[1] representa el nombre del archivo (hello.js)).



462

AWS Cloud9 Guía del usuarioPaso 4: Instalar y configurar el

AWS SDK for JavaScript in Node.js

Paso 4: Instalar y configurar el AWS SDK forJavaScript in Node.jsPuede mejorar esta muestra para utilizar el AWS SDK for JavaScript in Node.js y crear un bucket deAmazon S3, mostrar una lista de los buckets que tiene disponibles y, a continuación, eliminar el bucket queacaba de crear.

En este paso va a instalar y configurar el AWS SDK for JavaScript in Node.js, una cómoda forma deinteractuar con servicios de AWS, como Amazon S3, desde el código de JavaScript. Una vez instalado elAWS SDK for JavaScript in Node.js, debe configurar la administración de credenciales en su entorno. ElAWS SDK for JavaScript in Node.js necesita estas credenciales para interactuar con los servicios de AWS.

Para instalar el AWS SDK for JavaScript in Node.jsUse npm para ejecutar el comando install .

npm install aws-sdk

Para obtener más información, consulte Instalación del SDK for JavaScript en la Guía para desarrolladoresde AWS SDK for JavaScript.

Para configurar la administración de credenciales en su entornoCada vez que utilice el AWS SDK for JavaScript in Node.js para llamar a un servicio de AWS, debeproporcionar un conjunto de credenciales con la llamada. Estas credenciales determinan si el AWS SDKfor JavaScript in Node.js tiene los permisos adecuados para realizar esa llamada. Si las credenciales nocubren los permisos adecuados, la llamada no se realizará correctamente.


Para obtener información adicional, consulte Configuración de credenciales en Node.js en la Guía paradesarrolladores de AWS SDK for JavaScript.


En el AWS Cloud9 IDE, cree un archivo con este contenido y guárdelo con el nombre s3.js.

if (process.argv.length < 4) { console.log('Usage: node s3.js <the bucket name> <the AWS Region to use>\n' + 'Example: node s3.js my-test-bucket us-east-2'); process.exit(1); } var AWS = require('aws-sdk'); // To set the AWS credentials and region. var async = require('async'); // To call AWS operations asynchronously. AWS.config.update({ region: region }); var s3 = new AWS.S3({apiVersion: '2006-03-01'}); var bucket_name = process.argv[2];

463

https://docs.aws.amazon.com/sdk-for-javascript/v2/developer-guide/installing-jssdk.html

https://docs.aws.amazon.com/sdk-for-javascript/v2/developer-guide/setting-credentials-node.html


Paso 6: Ejecutar código del SDK de AWS1. Habilite el código para llamar a las operaciones de Amazon S3 de forma asincrónica mediante la

utilización de npm para ejecutar el comando install .

npm install async

2. En el AWS Cloud9 IDE, en la barra de menús, elija Run (Ejecutar), Run Configurations(Configuraciones de ejecución), New Run Configuration (Nueva configuración de ejecución).

3. En la pestaña [New] - Idle (Nuevo - Inactivo), elija Runner: Auto (Ejecutor: automático) y, acontinuación, elija Node.js.

4. En Command (Comando), escriba s3.js my-test-bucket us-east-2, donde my-test-bucketes el nombre del bucket que quiere crear y después eliminar y us-east-2 es el ID de la región deAWS en la que desea crear el bucket. Para obtener más ID, consulte Amazon Simple Storage Service(Amazon S3) en la Referencia general de Amazon Web Services.

Note



My buckets now are:


My buckets now are:

my-test-bucket


My buckets now are:


Ejemplo de PHP para AWS Cloud9Este ejemplo le permite ejecutar scripts de PHP en un entorno de desarrollo de AWS Cloud9.


Temas• Requisitos previos (p. 466)• Paso 1: Instalar las herramientas necesarias (p. 466)• Paso 2: Añadir el código (p. 467)

465







• Paso 3: Ejecutar el código (p. 467)• Paso 4: Instalar y configurar el AWS SDK para PHP (p. 468)• Paso 5: Añadir el código del SDK de AWS (p. 469)• Paso 6: Ejecutar código del SDK de AWS (p. 470)• Paso 7: Eliminación (p. 471)




Paso 1: Instalar las herramientas necesariasEn este paso, instalará PHP, que es necesario para ejecutar este ejemplo.

Note

El siguiente procedimiento instala solo PHP. Para instalar herramientas relacionadas como, porejemplo, un servidor web Apache y una base de datos MySQL, consulte Tutorial: Instalación de unservidor web LAMP con la Amazon Linux en la Guía del usuario de Amazon EC2 para instanciasde Linux.

1. En una sesión de terminal en AWS Cloud9 IDE, confirme si PHP ya se ha instalado ejecutando elcomando php --version . [Para iniciar una nueva sesión del terminal, en la barra de menús,seleccione Window (Ventana), New Terminal (Nuevo terminal)]. Si es así, el resultado contendrá elnúmero de versión de PHP. Si PHP está instalado, continúe en Paso 2: Añadir el código (p. 467).


En Amazon Linux:

sudo yum -y update

Para Ubuntu Server:

sudo apt update

3. Instale PHP ejecutando el comando install .

En Amazon Linux:

sudo yum -y install php56

Para Ubuntu Server:

466

https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/install-LAMP.html

https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/install-LAMP.html


sudo apt install -y php php-xml

Para obtener más información, consulte Installation and Configuration en el sitio web de PHP.

Paso 2: Añadir el códigoEn el AWS Cloud9 IDE, cree un archivo con este contenido y guárdelo con el nombre hello.php. [Paracrear un archivo, en la barra de menús, elija File (Archivo), New File (Nuevo archivo). Para guardar elarchivo, elija File (Archivo), Save (Guardar), escriba hello.php en Filename (Nombre de archivo) y, acontinuación, elija Save (Guardar)).

<?php print('Hello, World!');

print("\nThe sum of 2 and 3 is 5.");

$sum = (int)$argv[1] + (int)$argv[2];

print("\nThe sum of $argv[1] and $argv[2] is $sum.");?>

Note

El código anterior no depende de archivos externos. Sin embargo, si alguna vez incluye o necesitaotros archivos PHP en su archivo y desea que AWS Cloud9 utilice esos archivos para completarel código mientras escribe, active el ajuste Project, PHP Support, Enable PHP code completion(Proyecto, Soporte de PHP, Habilitar completar código PHP) en Preferences (Preferencias) y, acontinuación, añada las rutas a esos archivos al ajuste Project, PHP Support, PHP CompletionInclude Paths (Proyecto, Soporte de PHP, Habilitar completar código PHP). (Para ver y cambiarlas preferencias, elija AWS Cloud9, Preferences [AWS Cloud9, Preferencias] en la barra demenús).



continuación, elija PHP (cli).3. En Command (Comando), escriba hello.php 5 9. En el código, 5 representa $argv[1] y 9

representa $argv[2]. ($argv[0] representa el nombre del archivo (hello.php).)4. Elija el botón Run (Ejecutar) y compare los resultados.


467

http://php.net/manual/en/install.php

AWS Cloud9 Guía del usuarioPaso 4: Instalar y configurar el AWS SDK para PHP

Paso 4: Instalar y configurar el AWS SDK para PHPPuede mejorar esta muestra para utilizar el AWS SDK para PHP y crear un bucket de Amazon S3, mostraruna lista de los buckets que tiene disponibles y, a continuación, eliminar el bucket que acaba de crear.

En este paso, se instala y se configura el AWS SDK para PHP, que proporciona una forma cómoda parainteractuar con los servicios de AWS, como Amazon S3, desde el código PHP. Para poder instalar el AWSSDK para PHP, debe instalar Composer. Una vez instalado el AWS SDK para PHP, debe configurar laadministración de credenciales en su entorno. El AWS SDK para PHP necesita estas credenciales parainteractuar con los servicios de AWS.

Para instalar ComposerEjecute el comando curl con las opciones de silenciar (-s) y mostrar errores (-S), canalizando elinstalador de Composer a un archivo PHP (PHAR), cuyo nombre es composer.phar por convención.

curl -sS https://getcomposer.org/installer | php

Para instalar el AWS SDK para PHPPara Ubuntu Server, instale los paquetes adicionales que Composer necesita para instalar el AWS SDKpara PHP.

sudo apt install -y php-xml php-curl

Para Amazon Linux o Ubuntu Server, use el comando php para ejecutar el instalador de Composer parainstalar el AWS SDK para PHP.

php composer.phar require aws/aws-sdk-php

Este comando crea varias carpetas y archivos en su entorno. El archivo principal que se va a utilizar esautoload.php, que está en la carpeta vendor de su entorno.

Note

Después de la instalación, Composer podría sugerir que se instalen dependencias adicionales.Puede hacerlo con un comando como los siguientes, especificando la lista de dependencias quedesea instalar. Por ejemplo, el siguiente comando indica a Composer que instale la siguiente listade dependencias.

468

https://getcomposer.org/


php composer.phar require psr/log ext-curl doctrine/cache aws/aws-php-sns-message-validator

Para obtener más información, consulte Instalación en la Guía para desarrolladores de AWS SDK paraPHP.

Para configurar la administración de credenciales en su entornoCada vez que utilice el AWS SDK para PHP para llamar a un servicio de AWS, debe proporcionar unconjunto de credenciales con la llamada. Estas credenciales determinan si el AWS SDK para PHP tiene lospermisos adecuados para realizar esa llamada. Si las credenciales no cubren los permisos adecuados, lallamada no se realizará correctamente.


Para obtener información adicional, consulte la sección sobre creación de un cliente de Uso básico en laGuía para desarrolladores de AWS SDK para PHP.


En el AWS Cloud9 IDE, cree un archivo con este contenido y guárdelo con el nombre s3.php.

<?php require './vendor/autoload.php';

if ($argc < 4) { exit("Usage: php s3.php <the time zone> <the bucket name> <the AWS Region to use>\n" . "Example: php s3.php America/Los_Angeles my-test-bucket us-east-2"); }

$timeZone = $argv[1]; $bucketName = $argv[2]; $region = $argv[3];

date_default_timezone_set($timeZone);

$s3 = new Aws\S3\S3Client([ 'region' => $region, 'version' => '2006-03-01' ]);

# Lists all of your available buckets in this AWS Region. function listMyBuckets($s3) { print("\nMy buckets now are:\n");

$promise = $s3->listBucketsAsync();

$result = $promise->wait();

foreach ($result['Buckets'] as $bucket) { print("\n"); print($bucket['Name']); } }

469

https://docs.aws.amazon.com/sdk-for-php/v3/developer-guide/installation.html

https://docs.aws.amazon.com/sdk-for-php/v3/developer-guide/basic-usage.html


listMyBuckets($s3);

# Create a new bucket. print("\n\nCreating a new bucket named '$bucketName'...\n");

try { $promise = $s3->createBucketAsync([ 'Bucket' => $bucketName, 'CreateBucketConfiguration' => [ 'LocationConstraint' => $region ] ]);

$promise->wait();

} catch (Exception $e) { if ($e->getCode() == 'BucketAlreadyExists') { exit("\nCannot create the bucket. " . "A bucket with the name '$bucketName' already exists. Exiting."); } }

listMyBuckets($s3);

# Delete the bucket you just created. print("\n\nDeleting the bucket named '$bucketName'...\n");

$promise = $s3->deleteBucketAsync([ 'Bucket' => $bucketName ]);

$promise->wait();

listMyBuckets($s3);

?>

Paso 6: Ejecutar código del SDK de AWS1. En el AWS Cloud9 IDE, en la barra de menús, elija Run (Ejecutar), Run Configurations


continuación, elija PHP (cli).3. En Command (Comando), escriba s3.php America/Los_Angeles my-test-bucket us-

east-2, donde:

• America/Los_Angeles es el ID de zona horaria predeterminado. Para varios ID, consulte la listade zonas horarias admitidas en el sitio web de PHP.

• my-test-bucket es el nombre del bucket que desea crear y, a continuación, eliminar.

Note


• us-east-2 es el ID de la región de AWS en la que desea crear el bucket. Para obtener más ID,consulte Amazon Simple Storage Service (Amazon S3) en la Referencia general de Amazon WebServices.


My buckets now are:

470

http://php.net/manual/en/timezones.php

http://php.net/manual/en/timezones.php




My buckets now are:

my-test-bucket


My buckets now are:


Tutorial: Ruby en AWS Cloud9En este tutorial se muestra cómo ejecutar scripts de Ruby en un entorno de desarrollo de AWS Cloud9.

Note

El uso de este tutorial puede producir cargos en su cuenta de AWS. Estos incluyen posiblescargos por servicios como Amazon EC2 y Amazon S3. Para obtener más información, consultePrecios de Amazon EC2 y Precios de Amazon S3.


• Tiene un entorno de desarrollo de EC2 de AWS Cloud9

En este tutorial se supone que tiene un entorno de EC2 y que el entorno está conectado a una instanciaAmazon EC2 que ejecuta Amazon Linux o Ubuntu Server. Consulte Creación de un entorno deEC2 (p. 62) para obtener más información.

Si tiene un tipo de entorno o sistema operativo distinto, es posible que tenga que adaptar lasinstrucciones de este tutorial.

• Ha abierto el AWS Cloud9 IDE para ese entorno

Al abrir un entorno, AWS Cloud9 abre el IDE de ese entorno en el navegador web. Para obtener másinformación, consulte Apertura de un entorno en AWS Cloud9 (p. 74).

Pasos• Paso 1: Instalar las herramientas necesarias (p. 472)• Paso 2: Añadir el código (p. 472)• Paso 3: Ejecutar el código (p. 473)• Paso 4: Instalar y configurar el AWS SDK parar Ruby (p. 473)• Paso 5: Añadir el código del SDK de AWS (p. 475)• Paso 6: Ejecutar código del SDK de AWS (p. 476)• Paso 7: Eliminación (p. 477)

471




Paso 1: Instalar las herramientas necesarias(Primer paso del Tutorial: Ruby en AWS Cloud9 (p. 471))

En este paso instalará Ruby, que es necesario para ejecutar este tutorial.

1. En una sesión del terminal del AWS Cloud9 IDE, confirme si Ruby ya está instalado ejecutando elcomando ruby --version. [Para iniciar una nueva sesión del terminal, en la barra de menús,seleccione Window (Ventana), New Terminal (Nuevo terminal)]. Si es así, la salida contendrá elnúmero de versión de Ruby. Si Ruby está instalado, continúe en Paso 2: Añadir el código (p. 472).


En Amazon Linux:

sudo yum -y update

Para Ubuntu Server:

sudo apt update

3. Instale Ruby ejecutando el comando install .

En Amazon Linux:

sudo yum -y install ruby

Para Ubuntu Server:

sudo apt install -y ruby

Para obtener más información sobre el cifrado, consulte Installing Ruby en el sitio web de Ruby.

Paso siguientePaso 2: Añadir el código (p. 472)

Paso 2: Añadir el código(Paso anterior: Paso 1: Instalar las herramientas necesarias (p. 472))

1. En AWS Cloud9 IDE, cree un archivo nuevo (File (Archivo), New File (Archivo nuevo) en la barra demenús).

2. Añada el código siguiente.

puts "Hello, World!"

puts "The sum of 2 and 3 is 5."

argv0 = ARGV[0]argv1 = ARGV[1]sum = argv0.to_i + argv1.to_i

puts "The sum of #{argv0} and #{argv1} is #{sum}."

472

https://www.ruby-lang.org/en/documentation/installation


3. Guarde el archivo con el nombre hello.rb (File (Archivo), Save (Guardar)).

Paso siguientePaso 3: Ejecutar el código (p. 473)

Paso 3: Ejecutar el código(Paso anterior: Paso 2: Añadir el código (p. 472))


2. En la pestaña [New] - Idle ([Nuevo] - Inactivo), elija Runner: Auto (Ejecutor: automático) y, acontinuación, elija Ruby (elemento 1 en la captura de pantalla que se muestra a continuación).

3. En Command (Comando) (elemento 2 en la captura de pantalla), escriba hello.rb 5 9. Dado estecomando, ARGV[0] en el código recibe un valor de 5 y ARGV[1] recibe un valor de 9.

4. Elija el botón Run (Ejecutar) (elemento 3 a continuación) y compare la salida con la siguiente.


Paso siguientePaso 4: Instalar y configurar el AWS SDK parar Ruby (p. 473)

Paso 4: Instalar y configurar el AWS SDK parar Ruby(Paso anterior: Paso 3: Ejecutar el código (p. 473))

Note

Si no desea realizar estos procedimientos mejorados, asegúrese de realizar al menos Paso 7:Eliminación (p. 477).

473

AWS Cloud9 Guía del usuarioPaso 4: Instalar y configurar el AWS SDK parar Ruby

Puede mejorar este tutorial para utilizar el AWS SDK parar Ruby y crear un bucket de Amazon S3, mostraruna lista de los buckets que tiene disponibles y, a continuación, eliminar el bucket que acaba de crear.

En este paso, se instala y se configura el AWS SDK parar Ruby, que proporciona una forma cómoda parainteractuar con los servicios de AWS, como Amazon S3, desde el código Ruby.

• Para poder instalar el AWS SDK parar Ruby, debe instalar RubyGems.• Una vez instalado el AWS SDK parar Ruby, debe configurar la administración de credenciales en su

entorno. El AWS SDK parar Ruby necesita estas credenciales para interactuar con los servicios de AWS.

4.1: Instalar RubyGems1. En una sesión del terminal del AWS Cloud9 IDE, confirme si RubyGems ya está instalado ejecutando

el comando gem --version. Si es así, la salida contendrá el número de versión de RubyGems. Delo contrario, se muestra un mensaje de error.

Si RubyGems está instalado, continúe en 4.2: Instalar AWS SDK parar Ruby (p. 474).2. Para instalar RubyGems, ejecute el comando install como se indica a continuación.

En Amazon Linux:

sudo yum -y install gem

Para Ubuntu Server:

sudo apt install -y gem

Para obtener más información, consulte Download RubyGems (Descargar RubyGems) en el sitio webde RubyGems.

4.2: Instalar AWS SDK parar RubyDespués de instalar RubyGems, ejecute el comando install de RubyGems en una sesión de terminalcomo se indica a continuación.

Note

La instalación del paquete aws-sdk completo puede ejecutarse varios minutos antes de quecomience a mostrar el progreso en la ventana del terminal.

gem install aws-sdk

Note

Si no utiliza una instancia EC2 administrada por AWS Cloud9 (es decir, una entorno de EC2), enfunción de los permisos y la configuración del usuario de la instancia, es posible que tenga queutilizar sudo para instalar el SDK, tal y como se muestra en el siguiente comando.

sudo gem install aws-sdk

En este caso, utilice prácticas estándar basadas en Unix.

Para obtener más información, consulte Instalación de AWS SDK parar Ruby en la AWS SDK parar RubyDeveloper Guide.

474

https://rubygems.org/pages/download

https://docs.aws.amazon.com/sdk-for-ruby/v3/developer-guide/setup-install.html


4.3: Configurar la administración de credenciales en su entornoCada vez que utilice el AWS SDK parar Ruby para llamar a un servicio de AWS, debe proporcionar unconjunto de credenciales con la llamada. Estas credenciales determinan si el AWS SDK parar Ruby tienelos permisos adecuados para realizar esa llamada. Si las credenciales no cubren los permisos adecuados,la llamada no se realizará correctamente.

Si está siguiendo este tutorial estrictamente, habrá permitido a AWS Cloud9 crear y administrar suinstancia EC2. Si este es el caso, AWS Cloud9 también administra las credenciales temporalesautomáticamente, por lo que puede omitir este paso.

De lo contrario, tendrá que almacenar sus credenciales en el entorno. Para ello, siga las instrucciones enLlamar a los servicios de AWS desde un entorno en AWS Cloud9 (p. 76) y, a continuación, vuelva a estetema.

Para obtener información adicional, consulte Configuración de AWS SDK parar Ruby en la AWS SDK pararRuby Developer Guide.

Paso siguientePaso 5: Añadir el código del SDK de AWS (p. 475)

Paso 5: Añadir el código del SDK de AWS(Paso anterior: Paso 4: Instalar y configurar el AWS SDK parar Ruby (p. 473))

En este paso, facilita el código para interactuar con Amazon S3. Este código crea un bucket, enumera losbuckets disponibles y, a continuación, elimina el bucket que se creó. (Ejecutará este código en el siguientepaso).

En el AWS Cloud9 IDE, cree un archivo con el siguiente código y guárdelo con el nombre s3.rb.

require 'aws-sdk'

if ARGV.length < 2 puts "Usage: ruby s3.rb <the bucket name> <the AWS Region to use>\n" + "Example: ruby s3.rb my-test-bucket us-east-2"end

bucket_name = ARGV[0]region = ARGV[1]s3 = Aws::S3::Client.new(region: region)

# Lists all of your available buckets in this AWS Region.def list_my_buckets(s3) resp = s3.list_buckets() puts "My buckets now are:\n\n"

resp.buckets.each do |bucket| puts bucket.name end

end

list_my_buckets(s3)

# Create a new bucket.begin puts "\nCreating a new bucket named '#{bucket_name}'...\n\n"

475

https://docs.aws.amazon.com/sdk-for-ruby/v3/developer-guide/setup-config.html


s3.create_bucket({ bucket: bucket_name, create_bucket_configuration: { location_constraint: region } }) s3.wait_until(:bucket_exists, {bucket: bucket_name,})rescue Aws::S3::Errors::BucketAlreadyExists puts "Cannot create the bucket. " + "A bucket with the name '#{bucket_name}' already exists. Exiting." exit(false)end

list_my_buckets(s3)

# Delete the bucket you just created.puts "\nDeleting the bucket named '#{bucket_name}'...\n\n"s3.delete_bucket(bucket: bucket_name)

s3.wait_until(:bucket_not_exists, {bucket: bucket_name,})

list_my_buckets(s3)

Paso siguientePaso 6: Ejecutar código del SDK de AWS (p. 476)

Paso 6: Ejecutar código del SDK de AWS(Paso anterior: Paso 5: Añadir el código del SDK de AWS (p. 475))


2. En la pestaña [New] - Idle (Nuevo - Inactivo), elija Runner: Auto (Ejecutor: automático) y, acontinuación, elija Ruby.

3. En Command (Comando), escriba s3.rb YOUR_BUCKET_NAME THE_AWS_REGION, donde:

• YOUR_BUCKET_NAME es el nombre del bucket que desea crear y, a continuación, eliminar.

Los nombres de bucket de Amazon S3 deben ser únicos globalmente en AWS, no solo dentro de sucuenta de AWS.

• THE_AWS_REGION es el ID de la región de AWS en la que desea crear el bucket.

Por ejemplo, para la Región EE.UU Este (Ohio), use us-east-2. Para obtener más ID, consulteAmazon Simple Storage Service (Amazon S3) en la Referencia general de Amazon Web Services.

4. Seleccione el botón Run (Ejecutar). El resultado debería ser similar al siguiente.

My buckets now are:


My buckets now are:

my-test-bucket


My buckets now are:

476




Paso 7: Eliminación(Paso anterior: Paso 6: Ejecutar código del SDK de AWS (p. 476))

Para evitar que se hagan cargos continuos en su cuenta de AWS después de que haya terminado de usareste tutorial, elimine el entorno. Para obtener instrucciones, consulte Eliminación de un entorno en AWSCloud9 (p. 103).

(Volver a Tutorial: Ruby (p. 471))

Ejemplo de Go para AWS Cloud9Esta muestra le permite ejecutar código Go en un entorno de desarrollo de AWS Cloud9.


Temas• Requisitos previos (p. 477)• Paso 1: Instalar las herramientas necesarias (p. 477)• Paso 2: Añadir el código (p. 478)• Paso 3: Ejecutar el código (p. 479)• Paso 4: Instalar y configurar el AWS SDK for Go (p. 480)• Paso 5: Añadir el código del SDK de AWS (p. 481)• Paso 6: Ejecutar código del SDK de AWS (p. 483)• Paso 7: Eliminación (p. 483)




Paso 1: Instalar las herramientas necesariasEn este paso, va a instalar y configurar Go, necesario para ejecutar este ejemplo.

1. En una sesión del terminal del AWS Cloud9 IDE, confirme si Go ya está instalado ejecutando elcomando go version. [Para iniciar una nueva sesión del terminal, en la barra de menús, seleccioneWindow (Ventana), New Terminal (Nuevo terminal)]. Si se ejecuta correctamente, el resultado debería

477





contener el número de versión de Go. De lo contrario, se debería obtener un mensaje de error comoresultado. Si Go está instalado, continúe en Paso 2: Añadir el código (p. 478).


En Amazon Linux:

sudo yum -y update

Para Ubuntu Server:

sudo apt update

3. Para instalar Go, ejecute estos comandos de uno en uno.

wget https://storage.googleapis.com/golang/go1.9.3.linux-amd64.tar.gz # Download the Go installer.sudo tar -C /usr/local -xzf ./go1.9.3.linux-amd64.tar.gz # Install Go.rm ./go1.9.3.linux-amd64.tar.gz # Delete the installer.

Los comandos anteriores suponen que se emplea la última versión estable de Go en el momentoen que este tema se escribió. Para obtener más información, consulte Downloads en el sitio web dellenguaje de programación Go.

4. Agregue la ruta de los binarios de Go a la variable de entorno PATH, como se muestra a continuación.

a. Abra el archivo de perfil de shell (por ejemplo, ~/.bashrc) para editarlo.b. Al final de esta línea de código, escriba lo siguiente, de forma que el código ahora pasará a tener

este aspecto.

PATH=$PATH:/usr/local/go/bin

c. Guarde el archivo.5. Dé el origen del archivo ~/.bashrc para que el terminal pueda encontrar el binario de Go al que

acaba de hacer referencia.

. ~/.bashrc

6. Confirme que Go ya está instalado y configurado correctamente ejecutando el comando go version. Si es así, el resultado contendrá el número de versión de Go.

Paso 2: Añadir el códigoEn el AWS Cloud9 IDE, cree un archivo con este contenido y guárdelo con el nombre hello.go. [Paracrear un archivo, en la barra de menús, elija File (Archivo), New File (Nuevo archivo). Para guardar elarchivo, elija File (Archivo), Save (Guardar).

package main

import ( "fmt" "os" "strconv")

478

https://golang.org/dl/


func main() { fmt.Printf("Hello, World!\n")

fmt.Printf("The sum of 2 and 3 is 5.\n")

first, _ := strconv.Atoi(os.Args[1]) second, _ := strconv.Atoi(os.Args[2]) sum := first + second

fmt.Printf("The sum of %s and %s is %s.", os.Args[1], os.Args[2], strconv.Itoa(sum))}



continuación, elija Go.

Note

Si Go no está disponible, puede crear un ejecutor personalizado para Go.

1. En la pestaña [New] - Idle (Nuevo - Inactivo), elija Runner: Auto (Ejecutor: automático) y, acontinuación, elija New Runner (Ejecutor nuevo).

2. En la pestaña My Runner.run (Mi Runner.run), sustituya el contenido de la pestaña poreste código.

{ "cmd" : ["go", "run", "$file", "$args"], "info" : "Running $project_path$file_name...", "selector" : "source.go"}

3. Elija File (Archivo), Save As (Guardar como) en la barra de menús y guarde el archivocomo Go.run en la carpeta /.c9/runners.

4. En la pestaña [New] - Idle (Nuevo - Inactivo), elija Runner: Auto (Ejecutor: automático) y, acontinuación, elija Go.

5. Elija la pestaña hello.go para hacerla activa.3. En Command (Comando), escriba hello.go 5 9. En el código, 5 representa os.Args[1] y 9

representa os.Args[2].

479

AWS Cloud9 Guía del usuarioPaso 4: Instalar y configurar el AWS SDK for Go



Paso 4: Instalar y configurar el AWS SDK for GoPuede mejorar esta muestra para utilizar el AWS SDK for Go y crear un bucket de Amazon S3, mostraruna lista de los buckets que tiene disponibles y, a continuación, eliminar el bucket que acaba de crear.

En este paso, se instala y se configura el AWS SDK for Go, que proporciona una forma cómoda parainteractuar con los servicios de AWS, como Amazon S3, desde el código Go. Antes de instalar el AWSSDK for Go, debe configurar la variable de entorno GOPATH. Una vez instalado el AWS SDK for Goy establecida la variable de entorno GOPATH, debe configurar la administración de credenciales en elentorno. El AWS SDK for Go necesita estas credenciales para interactuar con los servicios de AWS.

Para establecer la variable de entorno GOPATH1. Abra el archivo ~/.bashrc para editarlo.2. Después de la última línea, escriba este código.

GOPATH=~/environment/go export GOPATH

3. Guarde el archivo.4. Dé el origen del archivo ~/.bashrc para que el terminal pueda encontrar la variable de entorno

GOPATH a la que acaba de hacer referencia.

480


. ~/.bashrc

5. Confirme que la variable de entorno GOPATH está establecida correctamente ejecutando el comando echo $GOPATH . Si es correcto, el resultado debe ser /home/ec2-user/environment/go o /home/ubuntu/environment/go.

Para instalar el AWS SDK for GoEjecute el comando go get especificando la ubicación del código fuente del AWS SDK for Go.

go get -u github.com/aws/aws-sdk-go/...

Go instala el código de AWS SDK for Go en la ubicación especificada en la variable de entorno GOPATH,que es la carpeta go de su entorno.

Para configurar la administración de credenciales en su entornoCada vez que utilice el AWS SDK for Go para llamar a un servicio de AWS, debe proporcionar un conjuntode credenciales con la llamada. Estas credenciales determinan si el AWS SDK for Go tiene los permisosadecuados para realizar esa llamada. Si las credenciales no cubren los permisos adecuados, la llamada nose realizará correctamente.


Para obtener información adicional, consulte Especificación de credenciales en la Guía paradesarrolladores de AWS SDK for Go.


En el AWS Cloud9 IDE, cree un archivo con este contenido y guárdelo con el nombre s3.go.

package main

import ( "fmt" "os" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/s3")

func main() {

if len(os.Args) < 3 { fmt.Printf("Usage: go run s3.go <the bucket name> <the AWS Region to use>\n" + "Example: go run s3.go my-test-bucket us-east-2\n") os.Exit(1) }

sess := session.Must(session.NewSessionWithOptions(session.Options{ SharedConfigState: session.SharedConfigEnable,

481

https://docs.aws.amazon.com/sdk-for-go/latest/developer-guide/configuring-sdk.html#specifying-credentials


})) svc := s3.New(sess, &aws.Config{ Region: aws.String(os.Args[2]), })

listMyBuckets(svc) createMyBucket(svc, os.Args[1], os.Args[2]) listMyBuckets(svc) deleteMyBucket(svc, os.Args[1]) listMyBuckets(svc)}

// List all of your available buckets in this AWS Region.func listMyBuckets(svc *s3.S3) { result, err := svc.ListBuckets(nil)

if err != nil { exitErrorf("Unable to list buckets, %v", err) }

fmt.Println("My buckets now are:\n")

for _, b := range result.Buckets { fmt.Printf(aws.StringValue(b.Name) + "\n") }

fmt.Printf("\n")}

// Create a bucket in this AWS Region.func createMyBucket(svc *s3.S3, bucketName string, region string) { fmt.Printf("\nCreating a new bucket named '" + bucketName + "'...\n\n")

_, err := svc.CreateBucket(&s3.CreateBucketInput{ Bucket: aws.String(bucketName), CreateBucketConfiguration: &s3.CreateBucketConfiguration{ LocationConstraint: aws.String(region), }, })

if err != nil { exitErrorf("Unable to create bucket, %v", err) } // Wait until bucket is created before finishing fmt.Printf("Waiting for bucket %q to be created...\n", bucketName)

err = svc.WaitUntilBucketExists(&s3.HeadBucketInput{ Bucket: aws.String(bucketName), })}

// Delete the bucket you just created.func deleteMyBucket(svc *s3.S3, bucketName string) { fmt.Printf("\nDeleting the bucket named '" + bucketName + "'...\n\n")

_, err := svc.DeleteBucket(&s3.DeleteBucketInput{ Bucket: aws.String(bucketName), })

if err != nil { exitErrorf("Unable to delete bucket, %v", err) } // Wait until bucket is deleted before finishing fmt.Printf("Waiting for bucket %q to be deleted...\n", bucketName)

482


err = svc.WaitUntilBucketNotExists(&s3.HeadBucketInput{ Bucket: aws.String(bucketName), })}

// If there's an error, display it.func exitErrorf(msg string, args ...interface{}) { fmt.Fprintf(os.Stderr, msg+"\n", args...) os.Exit(1)}

Paso 6: Ejecutar código del SDK de AWS1. En el AWS Cloud9 IDE, en la barra de menús, elija Run (Ejecutar), Run Configurations


continuación, elija Go.3. En Command (Comando), escriba s3.go YOUR_BUCKET_NAME THE_AWS_REGION ,

donde YOUR_BUCKET_NAME es el nombre del bucket que quiere crear y después eliminar y THE_AWS_REGION es el ID de la región de AWS en la que desea crear el bucket. Por ejemplo,para la Región EE.UU Este (Ohio), use us-east-2. Para obtener más ID, consulte Amazon SimpleStorage Service (Amazon S3) en la Referencia general de Amazon Web Services.

Note



My buckets now are:


My buckets now are:

my-test-bucket


My buckets now are:


Muestra de TypeScript para AWS Cloud9Este muestra presenta cómo trabajar con TypeScript en un entorno de desarrollo de AWS Cloud9.


483







Temas• Requisitos previos (p. 484)• Paso 1: Instalar las herramientas necesarias (p. 484)• Paso 2: Añadir el código (p. 485)• Paso 3: Ejecutar el código (p. 486)• Paso 4: Instalar y configurar el AWS SDK for JavaScript in Node.js (p. 487)• Paso 5: Añadir el código del SDK de AWS (p. 488)• Paso 6: Ejecutar código del SDK de AWS (p. 489)• Paso 7: Eliminación (p. 490)




Paso 1: Instalar las herramientas necesariasEn este paso, instale TypeScript mediante Node Version Manager (npm). Para instalar npm, use NodeVersion Manager (nvm). Si no tiene nvm, instálelo primero en este paso.

1. En una sesión de terminal en AWS Cloud9 IDE, confirme que TypeScript ya esté instalado medianteel compilador TypeScript de la línea de comandos con la opción --version. [Para iniciar una nuevasesión del terminal, en la barra de menús, seleccione Window (Ventana), New Terminal (Nuevoterminal)]. Si es así, la salida contendrá el número de versión de TypeScript. Si TypeScript estáinstalado, continúe en Paso 2: Añadir el código (p. 485).

tsc --version

2. Confirme si npm ya está instalado ejecutando npm con la opción --version. Si es así, el resultadocontendrá el número de versión de npm. Si npm está instalado, vaya al paso 10 de este procedimientopara utilizar npm para instalar TypeScript.

npm --version


En Amazon Linux:

sudo yum -y update

Para Ubuntu Server:

484


sudo apt update

4. Para instalar npm, comience por ejecutar el siguiente comando para descargar Node Version Manager(nvm). nvm es un sencillo script de shell Bash que resulta útil para instalar y administrar versiones deNode.js. Para obtener más información, consulte Node Version Manager en el sitio web de GitHub.


5. Para comenzar a utilizar nvm, cierre la sesión del terminal e iníciela de nuevo, o cargue el archivo~/.bashrc que contiene los comandos para cargar nvm.

. ~/.bashrc

6. Confirme que nvm está instalado ejecutando nvm con la opción --version.

nvm --version

7. Instale la versión más reciente de Node.js ejecutando nvm. (npm se incluye en Node.js).

nvm install node

8. Confirme que Node.js está instalado ejecutando la versión de la línea de comandos de Node.js con laopción --version.

node --version

9. Confirme que npm está instalado ejecutando npm con la opción --version.

npm --version

10. Instale TypeScript ejecutando npm con la opción -g. De este modo se instala TypeScript como unpaquete global en el entorno.

npm install -g typescript

11. Confirme que TypeScript está instalado ejecutando el compilador de TypeScript de la línea decomandos con la opción --version.

tsc --version

Paso 2: Añadir el código1. En la carpeta AWS Cloud9 IDE, cree un archivo llamado hello.ts. [Para crear un archivo, en la

barra de menús, elija File (Archivo), New File (Nuevo archivo). Para guardar el archivo, elija File(Archivo), Save (Guardar).

2. En un terminal en el IDE, desde el mismo directorio que el archivo hello.ts, ejecute npm parainstalar la biblioteca @types/node.

npm install @types/node

De este modo se añade una carpeta node_modules/@types/node en el mismo directorioque el archivo hello.ts. Esta nueva carpeta contiene las definiciones de tipo de Node.js que

485



TypeScript necesitará más adelante en este procedimiento para las propiedades console.log yprocess.argv que añadirá al archivo hello.ts.

3. Añada el siguiente código al archivo hello.ts:

console.log('Hello, World!');

console.log('The sum of 2 and 3 is 5.');

const sum: number = parseInt(process.argv[2], 10) + parseInt(process.argv[3], 10);

console.log('The sum of ' + process.argv[2] + ' and ' + process.argv[3] + ' is ' + sum + '.');

Paso 3: Ejecutar el código1. En el terminal, desde el mismo directorio que el archivo hello.ts, ejecute el compilador TypeScript.

Especifique el archivo hello.ts y las bibliotecas adicionales que se incluirán.

tsc hello.ts --lib es6

TypeScript utiliza el archivo hello.ts y un conjunto de archivos de biblioteca ECMAScript 6 (ES6)para transponer el código TypeScript del archivo hello.ts a código JavaScript equivalente en unarchivo llamado hello.js.

2. En la ventana Environment (Entorno), abra el archivo hello.js.3. En la barra de menús, elija Run (Ejecutar), Run Configurations (Configuraciones de ejecución), New

Run Configuration (Nueva configuración de ejecución).4. En la pestaña [New] - Idle (Nuevo - Inactivo), elija Runner: Auto (Ejecutor: automático) y, a

continuación, elija Node.js.5. En Command (Comando), escriba hello.js 5 9. En el código, 5 representa process.argv[2] y

9 representa process.argv[3]. (process.argv[0] representa el nombre del tiempo de ejecución(node) y process.argv[1] representa el nombre del archivo (hello.js)).

6. Elija Run (Ejecutar) y compare los resultados. Cuando haya terminado, elija Stop (Detener).


486

AWS Cloud9 Guía del usuarioPaso 4: Instalar y configurar el

AWS SDK for JavaScript in Node.js

Note

En lugar de crear una nueva configuración de ejecución en el IDE, también puede ejecutar estecódigo si ejecuta el comando node hello.js 5 9 desde el terminal.

Paso 4: Instalar y configurar el AWS SDK forJavaScript in Node.jsPuede mejorar esta muestra para utilizar el AWS SDK for JavaScript in Node.js y crear un bucket deAmazon S3, mostrar una lista de los buckets que tiene disponibles y, a continuación, eliminar el bucket queacaba de crear.

En este paso, instalará y configurará el AWS SDK for JavaScript in Node.js. El SDK proporciona una formacómoda de interactuar con servicios de AWS, como Amazon S3, desde su código JavaScript. Una vezinstalado el AWS SDK for JavaScript in Node.js, debe configurar la administración de credenciales en suentorno. El SDK necesita estas credenciales para interactuar con los servicios de AWS.

Para instalar el AWS SDK for JavaScript in Node.jsEn una sesión de terminal en el AWS Cloud9 IDE, desde el mismo directorio que el archivo hello.js dePaso 3: Ejecutar el código (p. 486), ejecute npm para instalar el AWS SDK for JavaScript in Node.js.

npm install aws-sdk

Este comando agrega varias carpetas a la carpeta node_modules del Paso 3: Ejecutar elcódigo (p. 486). Estas carpetas contienen código fuente y dependencias para el AWS SDK for JavaScriptin Node.js. Para obtener más información, consulte Instalación del SDK for JavaScript en la Guía paradesarrolladores de AWS SDK for JavaScript.

Para configurar la administración de credenciales en su entornoCada vez que utilice el AWS SDK for JavaScript in Node.js para llamar a un servicio de AWS, debeproporcionar un conjunto de credenciales con la llamada. Estas credenciales determinan si el AWS SDKfor JavaScript in Node.js tiene los permisos adecuados para realizar esa llamada. Si las credenciales nocubren los permisos adecuados, la llamada no se realizará correctamente.


487

https://docs.aws.amazon.com/sdk-for-javascript/v2/developer-guide/installing-jssdk.html


Para obtener información adicional, consulte Configuración de credenciales en Node.js en la Guía paradesarrolladores de AWS SDK for JavaScript.


1. En el AWS Cloud9 IDE, en el mismo directorio que el archivo hello.js de pasos anteriores, cree unarchivo denominado s3.ts.

2. Desde un terminal en el AWS Cloud9 IDE, en el mismo directorio que el archivo s3.ts, habilite elcódigo para llamar a operaciones de Amazon S3 de forma asincrónica ejecutando dos veces npm parainstalar la biblioteca async para TypeScript y de nuevo para JavaScript.

npm install @types/async # For TypeScript.npm install async # For JavaScript.

3. Añada el siguiente código al archivo s3.ts:

import * as async from 'async';import * as AWS from 'aws-sdk';

if (process.argv.length < 4) { console.log('Usage: node s3.js <the bucket name> <the AWS Region to use>\n' + 'Example: node s3.js my-test-bucket us-east-2'); process.exit(1);}

const AWS = require('aws-sdk'); // To set the AWS credentials and AWS Region.const async = require('async'); // To call AWS operations asynchronously.

const s3: AWS.S3 = new AWS.S3({apiVersion: '2006-03-01'});const bucket_name: string = process.argv[2];const region: string = process.argv[3];

AWS.config.update({ region: region});

const create_bucket_params: any = { Bucket: bucket_name, CreateBucketConfiguration: { LocationConstraint: region }};

const delete_bucket_params: any = { Bucket: bucket_name};

// List all of your available buckets in this AWS Region.function listMyBuckets(callback): void { s3.listBuckets(function(err, data) { if (err) {

} else { console.log("My buckets now are:\n");

for (let i: number = 0; i < data.Buckets.length; i++) { console.log(data.Buckets[i].Name); }

488

https://docs.aws.amazon.com/sdk-for-javascript/v2/developer-guide/setting-credentials-node.html


}

callback(err); });}

// Create a bucket in this AWS Region.function createMyBucket(callback): void { console.log("\nCreating a bucket named '" + bucket_name + "'...\n");

s3.createBucket(create_bucket_params, function(err, data) { if (err) { console.log(err.code + ": " + err.message); }

callback(err); });}

// Delete the bucket you just created.function deleteMyBucket(callback): void { console.log("\nDeleting the bucket named '" + bucket_name + "'...\n");

s3.deleteBucket(delete_bucket_params, function(err, data) { if (err) { console.log(err.code + ": " + err.message); }

callback(err); });}

// Call the AWS operations in the following order.async.series([ listMyBuckets, createMyBucket, listMyBuckets, deleteMyBucket, listMyBuckets]);

Paso 6: Ejecutar código del SDK de AWS1. En el terminal, desde el mismo directorio que el archivo s3.ts, ejecute el compilador TypeScript.

Especifique el archivo s3.ts y las bibliotecas adicionales que se incluirán.

tsc s3.ts --lib es6

TypeScript utiliza el archivo s3.ts, el AWS SDK for JavaScript in Node.js, la biblioteca async y unconjunto de archivos de biblioteca ECMAScript 6 (ES6) para transponer el código TypeScript delarchivo s3.ts a código JavaScript equivalente en un archivo llamado s3.js.

2. En la ventana Environment (Entorno), abra el archivo s3.js.3. En la barra de menús, elija Run (Ejecutar), Run Configurations (Configuraciones de ejecución), New

Run Configuration (Nueva configuración de ejecución).4. En la pestaña [New] - Idle (Nuevo - Inactivo), elija Runner: Auto (Ejecutor: automático) y, a

continuación, elija Node.js.5. En Command (Comando), escriba s3.js YOUR_BUCKET_NAME THE_AWS_REGION ,

donde YOUR_BUCKET_NAME el nombre del bucket que quiere crear y después eliminar y

489


THE_AWS_REGION es el ID de la región de AWS en la que se creará el bucket. Por ejemplo, para laRegión EE.UU Este (Ohio), use us-east-2. Para obtener más ID, consulte Amazon Simple StorageService (Amazon S3) en la Referencia general de Amazon Web Services.

Note


6. Elija Run (Ejecutar) y compare los resultados. Cuando haya terminado, elija Stop (Detener).

My buckets now are:


My buckets now are:

my-test-bucket


My buckets now are:


Ejemplo de Docker para AWS Cloud9En esta muestra se presenta cómo conectar un entorno de desarrollo de SSH de AWS Cloud9 a uncontenedor Docker en ejecución dentro de una instancia de Amazon Linux en Amazon EC2. Esto lepermite usar el AWS Cloud9 IDE para trabajar con código y archivos de un contenedor Docker y ejecutarcomandos en dicho contenedor. Para obtener información acerca de Docker, consulte Qué es Docker en elsitio web de Docker.

La creación de esta muestra puede generar cargos en su cuenta de AWS. Entre ellos, se incluyen posiblescargos por servicios como Amazon EC2. Para obtener más información, consulte Precios de Amazon EC2.

Temas• Requisitos previos (p. 490)• Paso 1: instalar y ejecutar Docker (p. 491)• Paso 2: Crear la imagen (p. 492)• Paso 3: Ejecutar el contenedor (p. 495)• Paso 4: Crear el entorno (p. 496)• Paso 5: Ejecutar el código (p. 497)• Paso 6: Eliminación (p. 497)

Requisitos previos• Debe haber una instancia Amazon EC2 que se ejecuta en Amazon Linux o Ubuntu Server. Esta muestra

supone que ya tiene una instancia Amazon EC2 que ejecuta en Amazon Linux o Ubuntu Server en su

490



https://www.docker.com/what-docker


AWS Cloud9 Guía del usuarioPaso 1: instalar y ejecutar Docker

cuenta de AWS. Para lanzar una instancia Amazon EC2, consulte Lanzar una máquina virtual Linux. Enla página Choose an Amazon Machine Image (AMI) (Elegir una imagen de máquina de Amazon [AMI])del asistente, seleccione una AMI cuyo nombre para mostrar comience por Amazon Linux AMI (AMI deAmazon Linux) o Ubuntu Server.

• Si la instancia Amazon EC2 se ejecutan en Amazon VPC, hay requisitos adicionales. ConsulteConfiguración de VPC para entornos de desarrollo de AWS Cloud9 (p. 501).

• La instancia Amazon EC2 debe tener al menos de 8 a 16 GB de espacio libre en disco. Esta muestrautiliza imágenes de Docker de un tamaño superior a 3 GB y puede utilizar incrementos adicionalesde 3 GB o más de espacio en disco para crear imágenes. Si intenta ejecutar esta muestra en undisco que tenga menos de 8 GB de espacio libre, es posible que la imagen de Docker no se cree oque el contenedor Docker no se ejecute. Para consultar el espacio libre en el disco de la instancia,puede ejecutar un comando como df -h (para "información del sistema de archivos del disco enformato legible") en la instancia. Para aumentar el tamaño del disco de una instancia existente, consulteModificación de un volumen en la Guía del usuario de Amazon EC2 para instancias de Linux.

Paso 1: instalar y ejecutar DockerEn este paso, comprobará si Docker está instalado en la instancia Amazon EC2 e instalará Docker si no loestá. Después de instalar Docker, ejecútelo en la instancia.

1. Conéctese a la instancia Amazon EC2 en ejecución utilizando un cliente SSH como la utilidad ssh oPuTTY. Para ello, consulte "Paso 3: conectarse a la instancia" en Lanzar una máquina virtual Linux.

2. Compruebe si Docker está instalado en la instancia. Para ello, ejecute el comando docker en lainstancia con la opción --version .

docker --version

Si Docker está instalado, se muestran la versión y el número de compilación de Docker. En este caso,vaya al paso 5 más adelante de este procedimiento.

3. Instalar Docker. Para ello, ejecute el comando yum o apt con la acción install , especificando elpaquete docker o docker.io para instalar.

En Amazon Linux:

sudo yum install -y docker

Para Ubuntu Server:

sudo apt install -y docker.io

4. Confirme que Docker está instalado. Para ello, vuelva a ejecutar el comando docker --version .Se muestran la versión y el número de compilación de Docker.

5. Ejecute Docker. Para ello, ejecute el comando service con el servicio docker y la acción start.

sudo service docker start

6. Confirme que Docker se está ejecutando. Para ello, ejecute el comando docker con la acción info.

sudo docker info

Si se está ejecutando, se muestra información sobre Docker.

491

https://aws.amazon.com/getting-started/tutorials/launch-a-virtual-machine/

https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ebs-modify-volume.html

https://aws.amazon.com/getting-started/tutorials/launch-a-virtual-machine/

AWS Cloud9 Guía del usuarioPaso 2: Crear la imagen

Paso 2: Crear la imagenEn este paso, se utiliza un Dockerfile para crear una imagen de Docker para en la instancia. Esta muestrautiliza una imagen que incluye Node.js y una aplicación de servidor de chat de muestra.

1. En la instancia, cree el Dockerfile. Para ello, con el cliente SSH todavía conectado a la instancia,en el directorio /tmp de la instancia, cree un archivo llamado Dockerfile. Por ejemplo, ejecute elcomando touch del modo siguiente.

sudo touch /tmp/Dockerfile

2. Añada el siguiente contenido al archivo Dockerfile.

# Build a Docker image based on the cloud9/ws-nodejs Docker image.FROM cloud9/ws-nodejs

# Enable the Docker container to communicate with AWS Cloud9 by# installing SSH.RUN apt update && apt install -y openssh-server

# Ensure that Node.js is installed.RUN apt install -y nodejs && ln -s /usr/bin/nodejs /usr/bin/node

# Disable password authentication by turning off the# Pluggable Authentication Module (PAM).RUN sed -i 's/UsePAM yes/UsePAM no/g' /etc/ssh/sshd_config

# Add the AWS Cloud9 SSH public key to the Docker container.# This assumes a file named authorized_keys containing the# AWS Cloud9 SSH public key already exists in the same# directory as the Dockerfile.RUN mkdir -p /home/ubuntu/.sshADD ./authorized_keys /home/ubuntu/.ssh/authorized_keysRUN chown -R ubuntu /home/ubuntu/.ssh /home/ubuntu/.ssh/authorized_keys && \chmod 700 /home/ubuntu/.ssh && \chmod 600 /home/ubuntu/.ssh/authorized_keys

# Start SSH in the Docker container.CMD /usr/sbin/sshd -D

# Update the password to a random one for the user ubuntu.RUN echo "ubuntu:$(cat /dev/urandom | tr -dc 'a-zA-Z0-9' | fold -w 32 | head -n 1)" | chpasswd

Para añadir el contenido anterior al archivo Dockerfile, puede utilizar la utilidad vi en la instanciatal y como se indica a continuación.

a. Utilice vi para abrir el archivo /tmp/Dockerfile.

sudo vi /tmp/Dockerfile

b. Pegue el contenido anterior en el archivo Dockerfile. Si no sabe cómo hacerlo, consulte ladocumentación de su cliente SSH.

c. Cambie al modo de comando. Para ello, pulse la tecla Esc. (-- INSERT -- desaparece de laparte inferior de la ventana).

d. Escriba :wq (para escribir en el archivo /tmp/Dockerfile, guárdelo y, a continuación, salga de vi ) y, a continuación, pulse Enter.

492


Note

Algunas imágenes adicionales de Docker están disponibles en el repositorio c9/templatesen el sitio web de GitHub. En la siguiente tabla se enumeran las imágenes disponibles, asícomo su contenido y definiciones. Para utilizar una imagen de Docker diferente desde esterepositorio, reemplace cloud9/ws-nodejs en el Dockerfile con uno de los siguientes ID deimagen.

ID de imagen Contenido Definición

cloud9/workspace Ubuntu 14.04.5 conherramientas comunes comoGit, Node.js, OpenJDK,Apache Ant, Apache Maven,Nginx, MySQL, PostgreSQL,Ruby, Apache HTTP Servery PHP.

Definición

cloud9/ws-android El contenido de la imagende cloud9/workspace conel SDK de Android, Gradley las herramientas comunesde Android.

Definición

cloud9/ws-cpp El contenido de la imagende cloud9/workspace conGNU Compiler Collection(GCC) y aplicaciones delínea de comandos demuestra para C y C++.

Definición

cloud9/ws-default El contenido de la imagen decloud9/workspace con unarchivo Léame básico.

Definición

cloud9/ws-html5 El contenido de la imagen decloud9/workspace con unarchivo HTML de muestra.

Definición

cloud9/ws-meteor El contenido de la imagende cloud9/workspacecon Meteor y una aplicaciónMeteor de muestra.

Definición

cloud9/ws-nodejs (esteejemplo)

El contenido de la imagende cloud9/workspacecon versiones adicionales deNode.js y una aplicación deservidor de chat de muestra.

Definición

cloud9/ws-php El contenido de la imagende cloud9/workspacecon una aplicación PHP demuestra.

Definición

493

https://github.com/c9/templates

https://hub.docker.com/r/cloud9/workspace/

https://github.com/c9/templates/blob/master/workspace/Dockerfile

https://hub.docker.com/r/cloud9/ws-android/

https://github.com/c9/templates/blob/master/ws-android/Dockerfile

https://hub.docker.com/r/cloud9/ws-cpp/

https://github.com/c9/templates/blob/master/ws-cpp/Dockerfile

https://hub.docker.com/r/cloud9/ws-default/

https://github.com/c9/templates/blob/master/ws-default/Dockerfile

https://hub.docker.com/r/cloud9/ws-html5/

https://github.com/c9/templates/blob/master/ws-html5/Dockerfile

https://hub.docker.com/r/cloud9/ws-meteor/

https://github.com/c9/templates/blob/master/ws-meteor/Dockerfile

https://hub.docker.com/r/cloud9/ws-nodejs/

https://github.com/c9/templates/blob/master/ws-nodejs/Dockerfile

https://hub.docker.com/r/cloud9/ws-php/

https://github.com/c9/templates/blob/master/ws-php/Dockerfile


ID de imagen Contenido Definición

cloud9/ws-python-plain El contenido de la imagende cloud9/workspace convarias versiones de Pythony una aplicación web demuestra.

Definición

cloud9/ws-python El contenido de la imagende cloud9/workspace conDjango.

Definición

cloud9/ws-ruby El contenido de la imagende cloud9/workspace convarias versiones de Ruby yRuby on Rails.

Definición

cloud9/ws-wordpress El contenido de la imagende cloud9/workspace conWordPress.

Definición

3. En la instancia, cree un archivo que contenga la clave pública SSH de AWS Cloud9 para que la utiliceel contenedor Docker. Para ello, en el mismo directorio que el archivo Dockerfile, cree un archivollamado authorized_keys, por ejemplo, ejecutando el comando touch .

sudo touch /tmp/authorized_keys

4. Añada la clave pública SSH de AWS Cloud9 al archivo authorized_keys. Para obtener la clavepública SSH de AWS Cloud9 haga lo siguiente:

a. Abra la consola de AWS Cloud9 en https://console.aws.amazon.com/cloud9/.b. En la barra de navegación de AWS, en el selector de región de AWS, seleccione la región de

AWS en la que desee crear el entorno de desarrollo de AWS Cloud9 más adelante en este tema.c. Si aparece una página de bienvenida, en New AWS Cloud9 environment (Nuevo entorno de AWS

Cloud9), elija Create environment (Crear entorno). De lo contrario, elija Create environment (Crearentorno).

d. En la página Name environment (Asignar nombre al entorno), en Name (Nombre), escriba unnombre para el entorno. (El nombre no es importante aquí. Elegirá otro nombre más tarde).

e. Elija Next Step.f. En Environment type (Tipo de entorno), elija Connect and run in remote server (SSH) (Conectar y

ejecutar en un servidor remoto (SSH)).g. Expanda View public SSH key (Ver clave SSH pública).h. Elija Copy key to clipboard (Copiar clave en portapapeles). (Está entre View public SSH key (Ver

clave pública SSH) y Advanced settings (Configuración avanzada).)i. Elija Cancel.j. Pegue el contenido del portapapeles en el archivo authorized_keys y, a continuación,

guárdelo. Por ejemplo, puede usar la utilidad vi , como se ha descrito anteriormente en estepaso.

5. Construya la imagen ejecutando el comando docker con la acción build , añadiendo la etiquetacloud9-image:latest a la imagen y especificando la ruta al archivo Dockerfile que se utilizará.

sudo docker build -t cloud9-image:latest /tmp

Si se realiza correctamente, las dos últimas líneas de la salida de compilación muestranSuccessfully built y Successfully tagged.

494

https://hub.docker.com/r/cloud9/ws-python-plain/

https://github.com/c9/templates/blob/master/ws-python-plain/Dockerfile

https://hub.docker.com/r/cloud9/ws-python/

https://github.com/c9/templates/blob/master/ws-python/Dockerfile

https://hub.docker.com/r/cloud9/ws-ruby/

https://github.com/c9/templates/blob/master/ws-ruby/Dockerfile

https://hub.docker.com/r/cloud9/ws-wordpress/

https://github.com/c9/templates/blob/master/ws-wordpress/Dockerfile


AWS Cloud9 Guía del usuarioPaso 3: Ejecutar el contenedor

Para confirmar que Docker ha creado correctamente la imagen, ejecute el comando docker con laacción image ls.

sudo docker image ls

Si se realiza correctamente, la salida muestra una entrada en la que el campo REPOSITORY estáconfigurado en cloud9-image y el campo TAG está configurado en latest.

6. Anote la dirección IP pública de la instancia Amazon EC2. Lo necesitará para el Paso 4: Crear elentorno (p. 496). Si no está seguro de cuál es la dirección IP pública de la instancia, puede ejecutarel siguiente comando en la instancia para obtenerla.

curl http://169.254.169.254/latest/meta-data/public-ipv4

Paso 3: Ejecutar el contenedorEn este paso, ejecutará un contenedor Docker en la instancia. Este contenedor se basa en la imagen quecreó en el paso anterior.

1. Para ejecutar el contenedor Docker, ejecute el comando docker en la instancia con la acción run ylas siguientes opciones.

sudo docker run -d -it --expose 9090 -p 0.0.0.0:9090:22 --name cloud9 cloud9-image:latest

• -d ejecuta el contenedor en modo desasociado y sale siempre que el proceso raíz que se utilizapara ejecutar las salidas del contenedor (en esta muestra, el cliente SSH).

• -it ejecuta el contenedor con un pseudoTTY asignado y mantiene STDIN abierto, incluso si elcontenedor no está asociado.

• --expose hace que el puerto especificado (en esta muestra, el puerto 9090) esté disponible desdeel contenedor.

• -p hace que el puerto especificado esté disponible internamente para la instancia AmazonEC2 sobre la dirección IP y el puerto especificados. En esta muestra, se puede obtener accesointernamente al puerto 9090 del contenedor a través del puerto 22 de la instancia Amazon EC2.

• --name es un nombre en lenguaje natural para el contenedor (en esta muestra, cloud9).• cloud9-image:latest es el nombre en lenguaje natural de la imagen creada que se va a utilizar

para ejecutar el contenedor.

Para confirmar que Docker está ejecutando correctamente el contenedor, ejecute el comando docker con la acción container ls.

sudo docker container ls

Si se realiza correctamente, la salida muestra una entrada en la que el campo IMAGE está configuradoen cloud9-image:latest y el campo NAMES está configurado en cloud9.

2. Inicie sesión en el contenedor en ejecución. Para ello, ejecute el comando docker con la acción exec y las siguientes opciones.

sudo docker exec -it cloud9 bash

495

AWS Cloud9 Guía del usuarioPaso 4: Crear el entorno

• -it ejecuta el contenedor con un pseudoTTY asignado y mantiene STDIN abierto, incluso si elcontenedor no está asociado.

• cloud9 es el nombre en lenguaje natural del contenedor en ejecución.• bash inicia el shell estándar en el contenedor en ejecución.

Si se realiza correctamente, el símbolo del terminal cambia para mostrar el nombre del usuario que hainiciado sesión del contenedor y el ID del contenedor.

Note

Si desea salir del contenedor en ejecución, ejecute el comando exit . El símbolo delterminal cambia vuelve a mostrar el nombre del usuario que ha iniciado sesión de la instanciay el DNS privado de la instancia. El contenedor debe seguir en ejecución.

3. Para el directorio del contenedor en ejecución en el que desee que AWS Cloud9 se inicie despuésde iniciar sesión, establezca sus permisos de acceso a rwxr-xr-x . Eso significa que el propietariodebe tener permisos de lectura, escritura y ejecución, el grupo debe tener permisos de lectura yejecución y el resto deben tener permisos de lectura y ejecución. Por ejemplo, si la ruta del directorioes ~, puede establecer estos permisos en el directorio ejecutando el comando chmod en elcontenedor en ejecución del siguiente modo.

sudo chmod u=rwx,g=rx,o=rx ~

4. Anote la ruta al directorio en el contenedor en ejecución que contiene el binario Node.js, ya que lonecesitará para el Paso 4: Crear el entorno (p. 496). Si no está seguro de cuál es esta ruta, ejecuteel siguiente comando en el contenedor en ejecución para obtenerla.

which node

Paso 4: Crear el entornoEn este paso, utilice AWS Cloud9 para crear un entorno de desarrollo de SSH de AWS Cloud9 y conécteloal contenedor Docker en ejecución. Después de que AWS Cloud9 cree el entorno, muestra el AWS Cloud9IDE para que pueda comenzar a trabajar con los archivos y el código en el contenedor.

1. Inicie sesión en la consola de AWS Cloud9 como sigue:


• Si su organización utiliza AWS Single Sign-On (SSO), solicite instrucciones de inicio de sesión aladministrador de la cuenta de AWS.


• Si es un estudiante en un aula, pide a su instructor las instrucciones de inicio de sesión.2. En la barra de navegación de AWS, en el selector de región de AWS, elija la región de AWS donde

desea crear el entorno de SSH.3. Si aparece una página de bienvenida, en New AWS Cloud9 environment (Nuevo entorno de AWS

Cloud9), elija Create environment (Crear entorno). De lo contrario, elija Create environment (Crearentorno).

4. En la página Name environment (Asignar nombre al entorno), en Name (Nombre), escriba un nombrepara el entorno.

5. Para añadir una descripción del entorno, escríbala en Description (Descripción).

496



6. Elija Next Step.7. En Environment type: (Tipo de entorno), elija Connect and run in remote server (SSH) (Conectar y

ejecutar en un servidor remoto (SSH)).8. En User (Usuario), escriba ubuntu.9. En Host, escriba la dirección IP pública de la instancia Amazon EC2 que anotó anteriormente.10. En Port (Puerto), escriba 9090.11. Amplíe Advanced settings (Configuración avanzada).12. En Environment path (Ruta de entorno), escriba la ruta del directorio en el contenedor en ejecución

que desee que se inicie AWS Cloud9 después de iniciar sesión.13. En Node.js binary path (Ruta del binario de Node.js), escriba la ruta al directorio en el contenedor en

ejecución que contiene el binario de Node.js, que anotó anteriormente.14. Elija Next Step.15. Seleccione Create environment (Crear entorno).16. Cuando aparezca el cuadro de diálogo AWS Cloud9 Installer (Instalador de AWS Cloud9), seleccione

Next (Siguiente).17. En la lista de componentes que se instalarán, desactive la casilla c9.ide.lambda.docker y, a

continuación, seleccione Next (Siguiente). Esto se debe a que AWS Cloud9 no puede ejecutar Dockerdentro de Docker.

18. Cuando el cuadro de diálogo AWS Cloud9 Installer (Instalador de AWS Cloud9) muestre InstallationCompleted (Instalación completada), seleccione Next (Siguiente) y, a continuación, Finish (Finalizar).Aparece el AWS Cloud9 IDE para el contenedor en ejecución y puede comenzar a trabajar con losarchivos y el código del contenedor.

Note

Si el contenedor deja de funcionar, ya no podrá usar el IDE para obtener acceso alcontenedor hasta que comience a ejecutarse de nuevo. Para ello, vaya a Paso 3: Ejecutar elcontenedor (p. 495).

Paso 5: Ejecutar el códigoEn este paso, utilice el AWS Cloud9 IDE para ejecutar una aplicación de muestra dentro del contenedorDocker en ejecución.

1. Con el AWS Cloud9 IDE mostrado para el contenedor en ejecución, inicie el servidor de chat demuestra. Para ello, en la ventana Environment (Entorno), haga clic con el botón derecho en el archivoworkspace/server.js de muestra y, a continuación, seleccione Run (Ejecutar).

2. Obtenga una vista previa de la aplicación de muestra. Para ello, en la ventana Environment (Entorno),abra el archivo workspace/client/index.html. A continuación, en la barra de menús, seleccioneTools, Preview, Preview Running Application (Herramientas, Vista previa, Vista previa de la aplicaciónen ejecución).

3. En la pestaña de vista previa de la aplicación, en Your Name (Su nombre), escriba su nombre. EnMessage (Mensaje) escriba un mensaje. A continuación, elija Send (Enviar). El servidor de chat añadesu nombre y su mensaje a la lista.

Paso 6: EliminaciónEn este paso, eliminará el entorno y los archivos de soporte de AWS Cloud9 y Docker de la instanciaAmazon EC2. Además, para evitar que se hagan cargos continuos en su cuenta de AWS una vezterminada esta muestra, debe terminar la instancia Amazon EC2 que está ejecutando Docker.

497


Paso 6.1: Eliminar el entornoPara eliminar el entorno, consulte Eliminación de un entorno en AWS Cloud9 (p. 103).

Paso 6.2: Eliminar los archivos de soporte de AWS Cloud9 delcontenedorDespués de eliminar el entorno, algunos archivos de soporte de AWS Cloud9 aún permanecen en elcontenedor. Si desea seguir usando el contenedor pero ya no necesita estos archivos de soporte, eliminela carpeta .c9 del directorio en el contenedor que especificó que AWS Cloud9 se iniciara desde despuésde que inicie sesión. Por ejemplo, si el directorio es ~, ejecute el comando rm con la opción -r de lasiguiente manera.

sudo rm -r ~/.c9

Paso 6.3: Eliminar los archivos de soporte de Docker de lainstanciaSi ya no desea conservar el contenedor Docker, la imagen de Docker y Docker en la instancia AmazonEC2, pero desea conservar la instancia, puede eliminar estos archivos de soporte de Docker de lasiguiente manera.

1. Elimine el contenedor Docker de la instancia. Para ello, ejecute el comando docker en la instanciacon las acciones de parada stop y rm , y el nombre en lenguaje natural del contenedor.

sudo docker stop cloud9sudo docker rm cloud9

2. Elimine la imagen de Docker de la instancia. Para ello, ejecute el comando docker en la instanciacon la acción image rm y la etiqueta de la imagen.

sudo docker image rm cloud9-image:latest

3. Elimine los archivos de soporte de Docker adicionales que aún puedan quedar. Para ello, ejecute elcomando docker en la instancia con la acción system prune .

sudo docker system prune -a

4. Desinstale Docker. Para ello, ejecute el comando yum en la instancia con la acción remove ,especificando el paquete docker para desinstalar.

En Amazon Linux:

sudo yum -y remove docker

Para Ubuntu Server:

sudo apt -y remove docker

También puede eliminar los archivos Dockerfile y authorized_keys que creó anteriormente. Porejemplo, ejecute el siguiente comando rm en la instancia.

sudo rm /tmp/Dockerfile

498

AWS Cloud9 Guía del usuarioEjemplos relacionados

sudo rm /tmp/authorized_keys

Paso 6.4: Terminar la instanciaPara terminar la instancia Amazon EC2, consulte Terminar una instancia en la Guía del usuario de AmazonEC2 para instancias de Linux.

Ejemplos relacionados• Introducción a AWS RoboMaker en la Guía para desarrolladores de AWS RoboMaker. Este ejemplo

utiliza AWS Cloud9 para modificar, crear y agrupar una aplicación de robot de muestra.

499

https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/terminating-instances.html

https://docs.aws.amazon.com/robomaker/latest/dg/getting-started.html

AWS Cloud9 Guía del usuarioentornos de EC2 frente a entornos de SSH

Temas avanzados para AWS Cloud9Estos temas contienen los siguientes tipos de información:

• Información que se utiliza para la configuración avanzada y la toma de decisiones.• Información relacionada con una tarea determinada y que puede proporcionar un mejor conocimiento,

pero no es fundamental para realizar dicha tarea.

Temas• entornos de EC2 frente a entornos de SSH en AWS Cloud9 (p. 500)• Configuración de VPC para entornos de desarrollo de AWS Cloud9 (p. 501)• Requisitos de host de entorno de desarrollo de SSH de AWS Cloud9 (p. 514)• Uso del instalador AWS Cloud9 (p. 516)• Rangos de direcciones IP de entrada con SSH para AWS Cloud9 (p. 518)• Contenido de imagen de máquina de Amazon (AMI) para un entorno de desarrollo de EC2 de AWS

Cloud9 (p. 519)• Referencia de los permisos de acceso de AWS Cloud9 (p. 521)• Uso de roles vinculados a servicios para AWS Cloud9 (p. 540)• Registro de llamadas a la API de AWS Cloud9 con AWS CloudTrail (p. 543)• Etiquetas (p. 552)

entornos de EC2 frente a entornos de SSH en AWSCloud9

Tal y como se ha explicado en la introducción de entornos y recursos informáticos (p. 1) y cuando setrabaja con entornos (p. 61), los entornos de AWS Cloud9 se pueden configurar como entornos de EC2 oentornos de SSH.

En la siguiente tabla se proporciona información sobre las similitudes y diferencias entre entornos de EC2 yentornos de SSH.

entornos de EC2 entornos de SSH

AWS Cloud9 crea una instancia de AmazonEC2 asociada y administra el ciclo de vida dela instancia (por ejemplo, comenzar, parar yterminar).

Puede utilizar una instancia de informática enla nube existente o su propio servidor. Puedeadministrar el ciclo de vida de dicha instancia o delservidor.

La instancia se ejecuta en Amazon Linux o UbuntuServer.

Puede utilizar cualquier instancia de informática enla nube que ejecute Linux, o su propio servidor conLinux.

AWS Cloud9 configura automáticamente lainstancia para empezar a trabajar con AWSCloud9.

Debe configurar manualmente la instancia o supropio servidor para trabajar con AWS Cloud9.

AWS Cloud9 configura automáticamente la AWSCommand Line Interface (AWS CLI) en la instanciapara que pueda comenzar su uso.

Si desea utilizar la AWS CLI en la instancia o en unservidor propio, debe configurarlo por su cuenta.

500

AWS Cloud9 Guía del usuarioConfiguración de Amazon VPC

entornos de EC2 entornos de SSH

La instancia tiene acceso a cientos de paquetesútiles, con algunos paquetes comunes yainstalados y configurados, por ejemplo, Git,Docker, Node.js y Python.

Es posible que tenga que descargar, instalar yconfigurar paquetes adicionales para completartareas comunes.

Para mantener la instancia, se aplican lasactualizaciones del sistema periódicamente.

Se mantiene la instancia o su propio servidor.

Al eliminar el entorno, AWS Cloud9 terminaautomáticamente la instancia asociada.

Al eliminar el entorno, la instancia o su propioservidor se mantiene.

Configuración de VPC para entornos de desarrollode AWS Cloud9

Cada entorno de desarrollo de AWS Cloud9 asociado a una Amazon Virtual Private Cloud (Amazon VPC)debe cumplir los requisitos específicos de la VPC. Estos entornos incluyen entornos de EC2, así comoentornos de SSH asociados con instancias de informática en la nube de AWS (por ejemplo, instanciasAmazon EC2 y Amazon Lightsail) que se ejecutan en una VPC.

Temas• Requisitos de Amazon VPC para AWS Cloud9 (p. 501)• Crear una Amazon VPC para AWS Cloud9 (p. 511)• Crear una subred para AWS Cloud9 (p. 513)

Requisitos de Amazon VPC para AWS Cloud9La Amazon VPC que AWS Cloud9 utiliza requiere las siguientes opciones de configuración. Si ya conoceestos requisitos y solo desea crear rápidamente una VPC compatible, vaya directamente a Crear unaAmazon VPC para AWS Cloud9 (p. 511).

Utilice la siguiente lista de comprobación para confirmar que la VPC cumple todos de los siguientesrequisitos.

Criterios Cómo confirmar Recursos adicionales

La VPC puede estar en la mismacuenta de AWS y región de AWSque el entorno de desarrollo deAWS Cloud9.

—O—

La VPC puede ser una VPCcompartida en una cuenta deAWS diferente a la del entorno.(Sin embargo, la VPC debeencontrarse en la misma regiónde AWS que el entorno).

Ver una lista de VPC de unaregión de AWS (p. 503)

• Crear una Amazon VPC paraAWS Cloud9 (p. 511)

• Trabajar con VPC compartidasen la Guía del usuario deAmazon VPC

501


AWS Cloud9 Guía del usuarioRequisitos de Amazon VPC para AWS Cloud9

Criterios Cómo confirmar Recursos adicionales

La VPC debe tener una únicasubred pública. (Una subredes pública cuando su tráfico sedirige a una gateway de Internet.)

• Ver una lista de subredes deuna VPC (p. 503)

• Confirmar si una subred espública (p. 503)

• Crear una subred para AWSCloud9 (p. 513)

• Ver o cambiar la configuraciónde una gateway deInternet (p. 504)

• Crear una gateway deInternet (p. 504)

• Adjuntar una gateway deInternet a una VPC (p. 504)

La subred debe tener una tablade ruteo con un conjunto mínimode rutas.

• Confirmar si una subred tieneuna tabla de ruteo (p. 505)

• Ver o cambiar laconfiguración de una tabla deruteo (p. 506)

• Configuración mínima sugeridade la tabla de ruteo para AWSCloud9 (p. 506)

• Crear una tabla deruteo (p. 506)

• Asociar una tabla de ruteo auna subred (p. 505)

Los grupos de seguridadasociados para la VPC (o parala instancia de informática en lanube de AWS, dependiendo desu arquitectura) deben permitirun conjunto mínimo de tráficoentrante y saliente.

• Ver una lista de gruposde seguridad para unaVPC (p. 506)

• Ver una lista de grupos deseguridad para una instanciade informática en la nube deAWS (p. 507)

• Ver o cambiar la configuraciónde un grupo de seguridad enuna VPC (p. 507)

• Ver una lista de grupos deseguridad para una instanciade informática en la nube deAWS (p. 507)

• Configuración mínima deltráfico entrante y saliente paraAWS Cloud9 (p. 508)

• Crear un grupo de seguridaden una VPC (p. 510)

Para una capa adicional deseguridad, si la VPC tiene unaACL de red, esta debe permitirun conjunto mínimo de tráficoentrante y saliente.

• Confirmar si una VPCtiene al menos una ACL dered (p. 510)

• Ver una lista de las ACL de redpara una VPC (p. 510)

• Ver o cambiar la configuraciónde una ACL de red (p. 511)

• Configuración mínima deltráfico entrante y saliente paraAWS Cloud9 (p. 508)

Crear una ACL de red (p. 511)

Note

Para los siguientes procedimientos, si utiliza las consolas de Amazon VPC o Amazon EC2, lerecomendamos que inicie sesión en la Consola de administración de AWS y abra la consola

502


de Amazon VPC (https://console.aws.amazon.com/vpc) o la consola de Amazon EC2 (https://console.aws.amazon.com/ec2) utilizando credenciales para un usuario administrador de IAM ensu cuenta de AWS. Si utiliza la AWS CLI o el aws-shell, le recomendamos que configure la AWSCLI o el aws-shell con las credenciales para un usuario administrador de IAM en su cuenta deAWS. Si no puede hacerlo, consulte con el administrador de su cuenta de AWS.

Ver una lista de VPC de una región de AWSPara usar la consola de Amazon VPC, en la barra de navegación de AWS, elija la región de AWS en la queAWS Cloud9 creará el entorno. Después, elija Your VPCs (Sus VPC) en el panel de navegación.

Para usar la AWS CLI o el aws-shell, ejecute el comando describe-vpcs de Amazon EC2, por ejemplo,de la siguiente manera.

aws ec2 describe-vpcs --output table --query 'Vpcs[*].VpcId' --region us-east-2

En el comando anterior, reemplace us-east-2 por el ID de la región de AWS en la que AWS Cloud9creará el entorno. Para ejecutar el comando anterior en Windows, reemplace las comillas simples porcomillas dobles. Para ejecutar el comando anterior con aws-shell, omita aws.

El resultado contiene la lista de los ID de VPC.

Ver una lista de subredes de una VPCPara utilizar la consola de Amazon VPC, seleccione Your VPCs (Sus VPC) en el panel de navegación.Anote el ID de la VPC de la columna VPC ID (ID de VPC). A continuación, elija Subnets (Subredes) en elpanel de navegación y busque subredes que contengan ese ID en la columna VPC.

Para usar la AWS CLI o el aws-shell, ejecute el comando describe-subnets de Amazon EC2, porejemplo, de la siguiente manera.

aws ec2 describe-subnets --output table --query 'Subnets[*].[SubnetId,VpcId]' --region us-east-2

En el comando anterior, reemplace us-east-2 por el ID de la región de AWS que contiene las subredes.Para ejecutar el comando anterior en Windows, reemplace las comillas simples por comillas dobles. Paraejecutar el comando anterior con aws-shell, omita aws.

En la salida, busque las subredes que coincidan con el ID de la VPC.

Confirmar si una subred es públicaPara usar la consola de Amazon VPC, elija Subnets (Subredes) en el panel de navegación. Seleccione lacasilla junto a la subred que desea que AWS Cloud9 utilice. En la pestaña Route Table (Tabla de ruteo), sihay una entrada en la columna Target (Objetivo) que comience por igw-, la subred es pública.

Para usar la AWS CLI o el aws-shell, ejecute el comando describe-route-tables de Amazon EC2,por ejemplo, de la siguiente manera.

aws ec2 describe-route-tables --output table --query 'RouteTables[*].Routes[*].{GatewayIds:GatewayId}' --region us-east-2 --filters Name=association.subnet-id,Values=subnet-12a3456b

En el comando anterior, reemplace us-east-2 por la región de AWS que contiene la subred y reemplacesubnet-12a3456b por el ID de subred. Para ejecutar el comando anterior en Windows, reemplace lascomillas simples por comillas dobles. Para ejecutar el comando anterior con aws-shell, omita aws.

503





En la salida, si hay al menos un resultado que comience por igw-, la subred es pública.

En la salida, si no hay resultados, la tabla de ruteo podría estar asociada con la VPC en lugar de con lasubred. Para confirmar esto, ejecute el comando describe-route-tables de Amazon EC2 para laVPC relacionada con la subred en lugar de la subred, por ejemplo, como se indica a continuación.

aws ec2 describe-route-tables --output table --query 'RouteTables[*].Routes[*].{GatewayIds:GatewayId}' --region us-east-1 --filters Name=vpc-id,Values=vpc-1234ab56

En el comando anterior, reemplace us-east-2 por la región de AWS que contiene la VPC y reemplacevpc-1234ab56 por el ID de VPC. Para ejecutar el comando anterior en Windows, reemplace las comillassimples por comillas dobles. Para ejecutar el comando anterior con aws-shell, omita aws.

En la salida, si hay al menos un resultado que comience por igw-, la VPC contiene una gateway deInternet.

Ver o cambiar la configuración de una gateway de InternetPara usar la consola de Amazon VPC, elija Internet Gateways (Gateways de Internet) en el panel denavegación. Seleccione la casilla situada junto a la gateway de Internet. Para ver la configuración, fíjeseen cada una de las pestañas. Para cambiar una configuración de una pestaña, elija Edit (Editar), sicorresponde, y siga las instrucciones en pantalla.

Para usar la AWS CLI o el aws-shell para ver la configuración, ejecute el comando describe-internet-gateways de Amazon EC2, por ejemplo, de la siguiente manera.

aws ec2 describe-internet-gateways --output table --region us-east-2 --internet-gateway-id igw-1234ab5c

En el comando anterior, reemplace us-east-2 por la región de AWS que contiene la gateway de Internety reemplace igw-1234ab5c por el ID de gateway de Internet. Para ejecutar el comando anterior con aws-shell, omita aws.

Crear una gateway de InternetPara usar la consola de Amazon VPC, elija Internet Gateways (Gateways de Internet) en el panel denavegación. Elija Create Internet Gateway (Crear gateway de Internet) y siga las instrucciones en pantalla.

Para usar la AWS CLI o el aws-shell, ejecute el comando create-internet-gateway de Amazon EC2,por ejemplo, de la siguiente manera.

aws ec2 create-internet-gateway --output text --query 'InternetGateway.InternetGatewayId' --region us-east-2

En el comando anterior, reemplace us-east-2 por la región de AWS que contiene la nueva gatewayde Internet. Para ejecutar el comando anterior en Windows, reemplace las comillas simples por comillasdobles. Para ejecutar el comando anterior con aws-shell, omita aws.

La salida contiene el ID de la nueva gateway de Internet.

Adjuntar una gateway de Internet a una VPCPara usar la consola de Amazon VPC, elija Internet Gateways (Gateways de Internet) en el panel denavegación. Seleccione la casilla situada junto a la gateway de Internet. Elija Actions, Attach to VPC(Acciones, Asociar a VPC), si está disponible, y siga las instrucciones en pantalla.

504


Para usar la AWS CLI o el aws-shell, ejecute el comando attach-internet-gateway de Amazon EC2,por ejemplo, de la siguiente manera.

aws ec2 attach-internet-gateway --region us-east-2 --internet-gateway-id igw-a1b2cdef --vpc-id vpc-1234ab56

En el comando anterior, reemplace us-east-2 por la región de AWS que contiene la gateway de Internet,reemplace igw-a1b2cdef por el ID de gateway de Internet y reemplace vpc-1234ab56 por el ID deVPC. Para ejecutar el comando anterior con aws-shell, omita aws.

Confirmar si una subred tiene una tabla de ruteoPara usar la consola de Amazon VPC, elija Subnets (Subredes) en el panel de navegación. Seleccione lacasilla junto a la subred pública de la VPC que desea que AWS Cloud9 utilice. En la pestaña Route table(Tabla de ruteo), si hay un valor para la Route table (Tabla de ruteo), la subred pública tiene una tabla deruteo.

Para usar la AWS CLI o el aws-shell, ejecute el comando describe-route-tables de Amazon EC2,por ejemplo, de la siguiente manera.

aws ec2 describe-route-tables --output table --query 'RouteTables[*].Associations[*].{RouteTableIds:RouteTableId}' --region us-east-2 --filters Name=association.subnet-id,Values=subnet-12a3456b

En el comando anterior, reemplace us-east-2 por la región de AWS que contiene la subred públicay reemplace subnet-12a3456b por el ID de subred pública. Para ejecutar el comando anterior enWindows, reemplace las comillas simples por comillas dobles. Para ejecutar el comando anterior con aws-shell, omita aws.

Si hay valores en la salida, la subred pública tiene al menos una tabla de ruteo.

En la salida, si no hay resultados, la tabla de ruteo podría estar asociada con la VPC en lugar de con lasubred. Para confirmar esto, ejecute el comando describe-route-tables de Amazon EC2 para laVPC relacionada con la subred en lugar de la subred, por ejemplo, como se indica a continuación.

aws ec2 describe-route-tables --output table --query 'RouteTables[*].Associations[*].{RouteTableIds:RouteTableId}' --region us-east-2 --filters Name=vpc-id,Values=vpc-1234ab56


En la salida, si hay al menos un resultado, la VPC tiene al menos una tabla de ruteo.

Asociar una tabla de ruteo a una subredPara usar la consola de Amazon VPC, elija Route Tables (Tablas de ruteo) en el panel de navegación.Seleccione la casilla situada junto a la tabla de ruteo que desea asociar. En la pestaña SubnetAssociations (Asociaciones de subred), elija Edit (Editar), active la casilla situada junto a la subred a la quedesea asociarla y, a continuación, elija Save (Guardar).

Para usar la AWS CLI o el aws-shell, ejecute el comando associate-route-table de Amazon EC2,por ejemplo, de la siguiente manera.

aws ec2 associate-route-table --region us-east-2 --subnet-id subnet-12a3456b --route-table-id rtb-ab12cde3

505


En el comando anterior, reemplace us-east-2 por la región de AWS que contiene la tabla de ruteo,reemplace subnet-12a3456b por el ID de subred y reemplace rtb-ab12cde3 por el ID de tabla deruteo. Para ejecutar el comando anterior con aws-shell, omita aws.

Crear una tabla de ruteoPara usar la consola de Amazon VPC, elija Route Tables (Tablas de ruteo) en el panel de navegación. ElijaCreate Route Table (Crear tabla de ruteo de Internet) y luego siga las instrucciones en pantalla.

Para usar la AWS CLI o el aws-shell, ejecute el comando create-route-table de Amazon EC2, porejemplo, de la siguiente manera.

aws ec2 create-route-table --output text --query 'RouteTable.RouteTableId' --region us-east-2 --vpc-id vpc-1234ab56

En el comando anterior, reemplace us-east-2 por la región de AWS que contiene la nueva tabla de ruteoy reemplace vpc-1234ab56 por el ID de VPC. Para ejecutar el comando anterior en Windows, reemplacelas comillas simples por comillas dobles. Para ejecutar el comando anterior con aws-shell, omita aws.

La salida contiene el ID de la nueva tabla de ruteo.

Ver o cambiar la configuración de una tabla de ruteoPara usar la consola de Amazon VPC, elija Route Tables (Tablas de ruteo) en el panel de navegación.Seleccione la casilla de verificación que hay junto a la tabla de ruteo. Para ver la configuración, fíjese encada una de las pestañas. Para cambiar una configuración de una pestaña, elija Edit (Editar) y luego sigalas instrucciones en pantalla.

Para usar la AWS CLI o el aws-shell para ver la configuración, ejecute el comando describe-route-tables de Amazon EC2, por ejemplo, de la siguiente manera.

aws ec2 describe-route-tables --output table --region us-east-2 --route-table-ids rtb-ab12cde3

En el comando anterior, reemplace us-east-2 por la región de AWS que contiene la tabla de ruteo yreemplace rtb-ab12cde3 por el ID de tabla de ruteo. Para ejecutar el comando anterior con aws-shell,omita aws.

Configuración mínima sugerida de la tabla de ruteo para AWSCloud9

Destino Target Estado Propagado

CIDR-BLOCK local Activa No

0.0.0.0/0 igw-INTERNET-GATEWAY-ID

Activa No

En esta configuración, CIDR-BLOCK es el bloque de CIDR de la subred y igw-INTERNET-GATEWAY-ID es el ID de una gateway de Internet compatible.

Ver una lista de grupos de seguridad para una VPCPara usar la consola de Amazon VPC, seleccione Security Groups (Grupos de seguridad) en el panel denavegación. En el cuadro Search Security Groups (Buscar grupos de seguridad), escriba el ID o el nombre

506


de la VPC y, a continuación, pulse Enter. Los grupos de seguridad de esa VPC aparecen en la lista deresultados de búsqueda.

Para usar la AWS CLI o el aws-shell, ejecute el comando describe-security-groups de AmazonEC2, por ejemplo, de la siguiente manera.

aws ec2 describe-security-groups --output table --query 'SecurityGroups[*].GroupId' --region us-east-2 --filters Name=vpc-id,Values=vpc-1234ab56


La salida contiene la lista de ID de grupo de seguridad para esa VPC.

Ver una lista de grupos de seguridad para una instancia deinformática en la nube de AWSPara usar la consola de Amazon EC2 expanda Instances (Instancias) en el panel de navegación y, acontinuación, elija Instances (Instancias). En la lista de instancias, marque la casilla situada junto a lainstancia. Los grupos d seguridad de esa instancia aparecen en la pestaña Description (Descripción) juntoa Security groups (Grupos de seguridad).

Para usar la AWS CLI o el aws-shell, ejecute el comando describe-security-groups de AmazonEC2, por ejemplo, de la siguiente manera.

aws ec2 describe-instances --output table --query 'Reservations[*].Instances[*].NetworkInterfaces[*].Groups[*].GroupId' --region us-east-2 --instance-ids i-12a3c456d789e0123

En el comando anterior, reemplace us-east-2 por la región de AWS que contiene la instancia yreemplace i-12a3c456d789e0123 por el ID de instancia. Para ejecutar el comando anterior en Windows,reemplace las comillas simples por comillas dobles. Para ejecutar el comando anterior con aws-shell, omitaaws.

La salida contiene la lista de ID de grupo de seguridad para esa instancia.

Ver o cambiar la configuración de un grupo de seguridad en unaVPCPara usar la consola de Amazon VPC, seleccione Security Groups (Grupos de seguridad) en el panelde navegación. Seleccione la casilla de verificación situada junto al grupo de seguridad. Para ver laconfiguración, fíjese en cada una de las pestañas. Para cambiar una configuración de una pestaña, elijaEdit (Editar), si corresponde, y siga las instrucciones en pantalla.

Para usar la AWS CLI o el aws-shell para ver la configuración, ejecute el comando describe-security-groups de Amazon EC2, por ejemplo, de la siguiente manera.

aws ec2 describe-security-groups --output table --region us-east-2 --group-ids sg-12a3b456

En el comando anterior, reemplace us-east-2 por la región de AWS que contiene la instancia yreemplace sg-12a3b456 por el ID de grupo de seguridad. Para ejecutar el comando anterior con aws-shell, omita aws.

507


Ver o cambiar la configuración de un grupo de seguridad parauna instancia de informática en la nube de AWSPara usar la consola de Amazon EC2 expanda Instances (Instancias) en el panel de navegación y, acontinuación, elija Instances (Instancias). En la lista de instancias, marque la casilla situada junto a lainstancia. En la pestaña Description (Descripción), en Security groups (Grupos de seguridad), elija el grupode seguridad. Consulte cada una de las pestañas. Para cambiar una configuración de una pestaña, elijaEdit (Editar), si corresponde, y siga las instrucciones en pantalla.

Para usar la AWS CLI o el aws-shell para ver la configuración, ejecute el comando describe-security-groups de Amazon EC2, por ejemplo, de la siguiente manera.

aws ec2 describe-security-groups --output table --region us-east-2 --group-ids sg-12a3b456

En el comando anterior, reemplace us-east-2 por la región de AWS que contiene la instancia yreemplace sg-12a3b456 por el ID de grupo de seguridad. Para ejecutar el comando anterior con aws-shell, omita aws.

Configuración mínima del tráfico entrante y saliente para AWSCloud9• Entrada: Todas las direcciones IP que usan SSH a través del puerto 22. Sin embargo, puede restringir

estas direcciones IP a la que AWS Cloud9 utiliza únicamente. Para obtener más información, consulteRangos de direcciones IP de entrada con SSH para AWS Cloud9 (p. 518).

Note

Para los entornos de EC2 creados el 31 de julio de 2018 o después, AWS Cloud9 utiliza gruposde seguridad para restringir automáticamente las direcciones IP entrantes mediante SSH enel puerto 22 solo a las direcciones que utiliza AWS Cloud9. Para obtener más información,consulte Rangos de direcciones IP de entrada con SSH para AWS Cloud9 (p. 518).

• Entrada (ACL de red solo): para los entornos de EC2 y para los entornos de SSH asociados coninstancias Amazon EC2 que se ejecutan en Amazon Linux o Ubuntu Server, todas las direcciones IP queusan TCP en los puertos 32768-61000. Para obtener más información, así como rangos de puertos paraotros tipos de instancias Amazon EC2, consulte Puertos efímeros en la Guía del usuario de AmazonVPC.

• Salida: todos los orígenes de tráfico con cualquier protocolo y puerto.

Puede configurar este comportamiento en el nivel del grupo de seguridad. Para un nivel adicional deseguridad, también puede utilizar una ACL de red. Para obtener más información, consulteComparación degrupos de seguridad y ACL de red en la Guía del usuario de Amazon VPC.

Por ejemplo, para añadir reglas de entrada y salida a un grupo de seguridad, configure dichas reglas tal ycomo se indica a continuación.

Reglas de entrada:

Type Protocolo Rango de puertos Fuente

SSH (22) TCP (6) 22 0.0.0.0 (pero consultela siguiente nota y losRangos de direccionesIP de entrada conSSH para AWSCloud9 (p. 518).)

508

https://docs.aws.amazon.com/vpc/latest/userguide/VPC_ACLs.html#VPC_ACLs_Ephemeral_Ports

https://docs.aws.amazon.com/vpc/latest/userguide/VPC_Security.html#VPC_Security_Comparison

https://docs.aws.amazon.com/vpc/latest/userguide/VPC_Security.html#VPC_Security_Comparison


Note

Para los entornos de EC2 creados el 31 de julio de 2018 o después, AWS Cloud9 añadeautomáticamente una regla de entrada para restringir las direcciones IP entrantes mediante SSHen el puerto 22 solo a las direcciones que utiliza AWS Cloud9. Para obtener más información,consulte Rangos de direcciones IP de entrada con SSH para AWS Cloud9 (p. 518).

Reglas de salida:

Type Protocolo Rango de puertos Fuente

ALL Traffic ALL ALL 0.0.0.0/0

Si también decide añadir reglas de entrada y salida a una ACL de red, configure dichas reglas tal y comose indica a continuación.

Reglas de entrada:

Regla n.º Tipo Protocolo Rango depuertos

Fuente Permitir/Denegar

100 SSH (22) TCP (6) 22 0.0.0.0 (peroconsulte losRangos dedirecciones IPde entrada conSSH para AWSCloud9 (p. 518).)

PERMITIR

200 Regla TCPpersonalizada

TCP (6) 32768-61000(parainstanciasde AmazonLinux y UbuntuServer. Paraotros tiposde instancia,consultePuertosefímeros).

0.0.0.0/0 PERMITIR

* ALL Traffic ALL ALL 0.0.0.0/0 DENEGAR

Reglas de salida:

Regla n.º Tipo Protocolo Rango depuertos

Fuente Permitir/Denegar

100 ALL Traffic ALL ALL 0.0.0.0/0 PERMITIR

* ALL Traffic ALL ALL 0.0.0.0/0 DENEGAR

Para obtener más información acerca de los grupos de seguridad y las ACL de red, consulte lo siguienteen la Guía del usuario de Amazon VPC.

509




• Seguridad• Grupos de seguridad de su VPC• ACL de red

Crear un grupo de seguridad en una VPCPara utilizar las consolas de Amazon VPC o Amazon EC2, realice una de las siguientes acciones.

• En la consola de Amazon VPC, seleccione Security Groups (Grupos de seguridad) en el panel denavegación. Elija Create Security Group (Crear grupo de seguridad) y luego siga las instrucciones enpantalla.

• En la consola de Amazon EC2, expanda Network & Security (Red y seguridad) en el panel denavegación y, a continuación, seleccione Security Groups (Grupos de seguridad). Elija Create SecurityGroup (Crear grupo de seguridad) y luego siga las instrucciones en pantalla.

Para usar la AWS CLI o el aws-shell, ejecute el comando create-security-group de Amazon EC2,por ejemplo, de la siguiente manera.

aws ec2 create-security-group --region us-east-2 --vpc-id vpc-1234ab56

En el comando anterior, reemplace us-east-2 por la región de AWS que contiene la VPC y reemplacevpc-1234ab56 por el ID de VPC. Para ejecutar el comando anterior con aws-shell, omita aws.

Confirmar si una VPC tiene al menos una ACL de redPara utilizar la consola de Amazon VPC, seleccione Your VPCs (Sus VPC) en el panel de navegación.Seleccione la casilla junto a la VPC que desea que AWS Cloud9 utilice. En la pestaña Summary(Resumen), si hay un valor para Network ACL (ACL de red), la VPC tiene al menos una ACL de red.

Para usar la AWS CLI o el aws-shell, ejecute el comando describe-network-acls de Amazon EC2,por ejemplo, de la siguiente manera.

aws ec2 describe-network-acls --output table --query 'NetworkAcls[*].Associations[*].NetworkAclId' --region us-east-2 --filters Name=vpc-id,Values=vpc-1234ab56


Si la salida contiene al menos una entrada en la lista, la VPC tiene al menos una ACL de red.

Ver una lista de las ACL de red para una VPCPara usar la consola de Amazon VPC, elija Network ACLs (ACL de red) en el panel de navegación. Enel cuadro Search Network ACLs (ACL de red de búsqueda), escriba el ID o el nombre de la VPC y, acontinuación, pulse Enter. Las ACL de red para esa VPC aparecen en la lista de resultados de búsqueda.

Para usar la AWS CLI o el aws-shell, ejecute el comando describe-network-acls de Amazon EC2,por ejemplo, de la siguiente manera.

aws ec2 describe-network-acls --output table --query 'NetworkAcls[*].Associations[*].NetworkAclId' --region us-east-2 --filters Name=vpc-id,Values=vpc-1234ab56

510




AWS Cloud9 Guía del usuarioCrear una Amazon VPC para AWS Cloud9


La salida contiene una lista de ACL de red para esa VPC.

Ver o cambiar la configuración de una ACL de redPara usar la consola de Amazon VPC, elija Network ACLs (ACL de red) en el panel de navegación. Activela casilla que hay junto a la ACL de red. Para ver la configuración, fíjese en cada una de las pestañas. Paracambiar una configuración de una pestaña, elija Edit (Editar), si corresponde, y siga las instrucciones enpantalla.

Para usar la AWS CLI o el aws-shell para ver la configuración, ejecute el comando describe-network-acls de Amazon EC2, por ejemplo, de la siguiente manera.

aws ec2 describe-network-acls --output table --region us-east-2 --network-acl-ids acl-1234ab56

En el comando anterior, reemplace us-east-2 por la región de AWS que contiene la ACL de red yreemplace acl-1234ab56 por el ID de ACL de red. Para ejecutar el comando anterior con aws-shell,omita aws.

Crear una ACL de redPara usar la consola de Amazon VPC, elija Network ACLs (ACL de red) en el panel de navegación. ElijaCreate Network ACL (Crear ACL de red) y luego siga las instrucciones en pantalla.

Para usar la AWS CLI o el aws-shell, ejecute el comando create-network-acl de Amazon EC2, porejemplo, de la siguiente manera.

aws ec2 create-network-acl --region us-east-2 --vpc-id vpc-1234ab56

En el comando anterior, reemplace us-east-2 por la región de AWS que contiene la VPC a la que deseaconectar la nueva ACL de red y reemplace vpc-1234ab56 por el ID de la VPC. Para ejecutar el comandoanterior con aws-shell, omita aws.

Crear una Amazon VPC para AWS Cloud9Puede utilizar la consola de Amazon VPC para crear una Amazon VPC compatible con AWS Cloud9.

Note

En este procedimiento, recomendamos que inicie sesión en la Consola de administración de AWSy que abra la consola de Amazon VPC con las credenciales de un usuario administrador de IAMen la cuenta de AWS. Si no puede hacerlo, consulte con el administrador de su cuenta de AWS.En algunas organizaciones no se permite crear VPC. Si no puede crear una VPC, consulte con eladministrador de su cuenta de AWS o el administrador de red.

1. Si la consola de Amazon VPC aún no está abierta, inicie sesión en la Consola de administración deAWS y abra la consola de Amazon VPC en https://console.aws.amazon.com/vpc.

2. En la barra de navegación, si la región de AWS no es la misma que la del entorno, elija la región deAWS correcta.

3. Elija VPC Dashboard (Panel de VPC) en el panel de navegación, si todavía no se muestra la páginaVPC Dashboard (Panel de VPC).

4. Elija Launch VPC Wizard (Lanzar el asistente de VPC).

511


AWS Cloud9 Guía del usuarioCrear una Amazon VPC para AWS Cloud9

5. En Step 1: Select a VPC Configuration (Paso 1: Seleccionar una configuración de la VPC), asegúresede que esté seleccionada la opción VPC with a Single Public Subnet (VPC con una única subredpública) y, luego, elija Select (Seleccionar).

6. Para Step 2: VPC with a Single Public Subnet (Paso 2: VPC con una sola subred pública), lerecomendamos que deje la siguiente configuración predeterminada. (Sin embargo, puede cambiar laconfiguración de CIDR si tiene CIDR personalizados que desea utilizar. Para obtener más información,consulte Tamaño de subred y VPC en la Guía del usuario de Amazon VPC.)

• Bloque de CIDR IPv4: 10.0.0.0/16• Bloque de CIDR IPv6: Ningún bloque de CIDR IPv6• CIDR IPv4 de subred pública: 10.0.0.0/24• Zona de disponibilidad: sin preferencia.• Habilitar nombres de host DNS: Sí• Propiedad de hardware: predeterminada

7. En VPC name, escriba un nombre de la VPC.8. En Subnet name (Nombre de subred), escriba un nombre para la subred en la VPC.9. Elija Create new VPC (Crear nueva VPC).

Amazon VPC crea los siguientes recursos que son compatibles con AWS Cloud9:

• Una VPC.• Una subred pública para la VPC.• Una tabla de ruteo para la subred pública con la configuración mínima requerida.• Una gateway de Internet para la subred pública.• Una ACL de red para la subred pública con la configuración mínima requerida.

10. De forma predeterminada, la VPC permite el tráfico entrante de todos los tipos, protocolos, puertos ylas direcciones IP. Puede restringir este comportamiento para permitir únicamente las direcciones IPprocedentes de AWS Cloud9 usando SSH en el puerto 22. Un enfoque es definir reglas entrantes enla ACL de red predeterminada de la VPC, tal y como se indica a continuación.

a. En el panel de navegación de la consola de Amazon VPC, seleccione Your VPCs (Sus VPC).b. Seleccione la casilla de la VPC que acaba de crear.c. En la pestaña Description (Descripción), seleccione el enlace situado junto a Network ACL (ACL

de red).d. Seleccione la casilla situada junto a la ACL de red que se muestra.e. En la pestaña Inbound Rules (Reglas de entrada), seleccione Edit inbound rules (Editar reglas de

entrada).f. En Rule # 100 (Regla n.º 100), en Type (Tipo), elija SSH (22).g. En Source (Fuente), escriba uno de los bloques de CIDR de la lista Rangos de direcciones IP de

entrada con SSH para AWS Cloud9 (p. 518) que coincide con la región de AWS de esta VPC.h. Elija Add another rule.i. En Rule # (Regla n.º), escriba 200.j. En Type, seleccione SSH (22).k. En Source (Fuente), escriba el otro bloque de CIDR de la lista Rangos de direcciones IP de

entrada con SSH para AWS Cloud9 (p. 518) que coincide con la región de AWS de esta VPC.l. Como mínimo, también debe permitir el tráfico entrante de todas las direcciones IP con TCP en

los puertos 32768-61000 para los tipos de instancia de Amazon Linux y Ubuntu Server. (Paraobtener información y rangos de puertos para otros tipos de instancias Amazon EC2, consultePuertos efímeros en la Guía del usuario de Amazon VPC). Para hacerlo, elija Add another rule(Agregar otra regla).

m. En Rule # (Regla n.º), escriba 300.512

https://docs.aws.amazon.com/vpc/latest/userguide/VPC_Subnets.html#VPC_Sizing


AWS Cloud9 Guía del usuarioCrear una subred para AWS Cloud9

n. En Type, elija Custom TCP Rule.o. En Port Range (Rango de puertos), escriba 32768-61000 (para los tipos de instancia de Amazon

Linux y Ubuntu Server).p. En Source (Fuente), escriba 0.0.0.0/0.q. Seleccione Save.r. Es posible que tenga que añadir más reglas entrantes o salientes para la ACL de red, en función

de cómo tenga previsto utilizar AWS Cloud9. Consulte la documentación de los servicios web olas API que desea permitir comunicarse dentro y fuera de la VPC para los valores Type (Tipo),Protocol (Protocolo), Port Range (Rango de puertos) y Source (Fuente) que se deben especificarpara estas reglas.

Crear una subred para AWS Cloud9Puede utilizar la consola de Amazon VPC para crear una subred para una VPC compatible con AWSCloud9.

Si ha seguido el procedimiento anterior para crear una VPC para una AWS Cloud9, no es necesario quesiga también este procedimiento. Esto se debe a que el asistente para Create new VPC (Crear nuevaVPC) crea una subred automáticamente.

Important

• La cuenta de AWS ya debe tener una VPC compatible en la misma región de AWS para elentorno. Para obtener más información, consulte los requisitos de VPC en Requisitos deAmazon VPC para AWS Cloud9 (p. 501).

• En este procedimiento, recomendamos que inicie sesión en la Consola de administración deAWS y, a continuación, que abra la consola de Amazon VPC con las credenciales de un usuarioadministrador de IAM en la cuenta de AWS. Si no puede hacerlo, consulte con el administradorde su cuenta de AWS.

• En algunas organizaciones no se permite crear subredes. Si no puede crear una subred,consulte con el administrador de su cuenta de AWS o el administrador de red.

1. Si la consola de Amazon VPC aún no está abierta, inicie sesión en la Consola de administración deAWS y abra la consola de Amazon VPC en https://console.aws.amazon.com/vpc.

2. En la barra de navegación, si la región de AWS no es la misma región de AWS que la del entorno, elijala región de AWS correcta.

3. Elija Subnets (Subredes) en el panel de navegación, si todavía no se muestra la página Subnets(Subredes).

4. Elija Create Subnet.5. En el cuadro de diálogo Create Subnet (Crear subred), en Name tag (Etiqueta de nombre), escriba el

nombre de la subred.6. En VPC, elija la VPC con la que desea asociar la subred.7. En Availability Zone (Zona de disponibilidad), elija la zona de disponibilidad dentro de la región de

AWS de la subred que se va a utilizar o elija No Preference (Sin preferencia) para que AWS elija unazona de disponibilidad.

8. Para IPv4 CIDR block (Bloque de CIDR IPv4), escriba el rango de direcciones IP de la subred que seva a utilizar, en formato CIDR. Este rango de direcciones IP debe ser un subconjunto de direccionesen la VPC.

Para obtener más información sobre los bloques de CIDR, consulte Tamaño de subred y VPC en laGuía del usuario de Amazon VPC. Véase también 3.1. Basic concepto y Prefix Notation en RFC 4632o Bloques CIDR IPv4 en Wikipedia.

513


https://docs.aws.amazon.com/vpc/latest/userguide/VPC_Subnets.html#VPC_Sizing

http://tools.ietf.org/html/rfc4632#section-3.1

http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing#IPv4_CIDR_blocks

AWS Cloud9 Guía del usuarioRequisitos de host de entorno de SSH

9. Después de crear la subred, asegúrese de asociarla a una tabla de ruteo y a una gateway de Internetcompatibles, así como a los grupos de seguridad, a una ACL de red o ambos. Para obtener másinformación, consulte los requisitos en Requisitos de Amazon VPC para AWS Cloud9 (p. 501).

Requisitos de host de entorno de desarrollo de SSHde AWS Cloud9

Para indicar a AWS Cloud9 que conecte un entorno con una instancia de informática en la nube existente ocon su propio servidor, puede crear un entorno de desarrollo de SSH de AWS Cloud9. No obstante, antesde crear un entorno de SSH, considere las ventajas de crear un entornos de EC2 en su lugar.

Al crear un entorno de EC2, AWS Cloud9 crea un nuevo entorno, solicita a Amazon EC2 que lance unanueva instancia y, a continuación, conecta la instancia que se acaba de lanzar al nuevo entorno. Lacreación de un entorno de EC2 tiene los siguientes beneficios:

• Lanzamiento automático de instancias. Al crear un entorno de EC2, AWS Cloud9 solicita a Amazon EC2que cree una nueva instancia al mismo tiempo. En un entorno de SSH, debe proporcionar una instanciade informática en la nube existente (por ejemplo, una instancia Amazon EC2) o su propio servidor.

• Cierre automático de instancias. De forma predeterminada, AWS Cloud9 cierra automáticamente elentorno de EC2 30 minutos después de que se cierren todas las instancias del navegador web queestén conectadas al IDE para el entorno de EC2. (Puede cambiar este comportamiento en cualquiermomento). Esto ayuda a reducir cargos adicionales en su cuenta de AWS por utilizar Amazon EC2.

• Limpieza automática de instancias. Cuando se elimina un entorno de EC2, la instancia de AmazonEC2 conectada se elimina automáticamente. Esto también ayuda a reducir cargos adicionales en sucuenta de AWS por utilizar Amazon EC2. En un entorno de SSH que esté conectado a una instancia deinformática en la nube, debe acordarse de eliminar la instancia.

Si desea crear un entorno de EC2 en su lugar, consulteCreación de un entorno de EC2 (p. 62). En casocontrario, siga leyendo información sobre cómo crear entornos de SSH.

Cuando y cómo crear un entorno de SSHDebe crear un entorno de SSH en lugar de un entorno de EC2 cuando se cumpla cualquiera de lassiguientes condiciones:

Requisito Instrucciones

No desea incurrir en cargos adicionales en sucuenta de AWS por usar instancias de informáticaen la nube de AWS, por lo que decide conectarAWS Cloud9 a una instancia de informática enla nube existente fuera de AWS o a su propioservidor.

1. Asegúrese de que su instancia o el servidorcumplen los requisitos (p. 515) que seindican más adelante en este tema.

2. Cree un entorno de SSH (p. 61) al que AWSCloud9 pueda conectar la instancia al servidor.

Desea utilizar una instancia de informática en lanube de AWS existente (por ejemplo, una instanciaAmazon EC2) en su cuenta de AWS en lugar deque AWS Cloud9 lance una nueva instancia almismo tiempo que se crea el entorno.

1. Asegúrese de que la instancia cumple losrequisitos (p. 515) que se indican másadelante en este tema.

2. Cree un entorno de SSH (p. 61) al que AWSCloud9 pueda conectar la instancia.

Desea utilizar un tipo de instancia de Amazon EC2que AWS Cloud9 no admite actualmente para unentorno de EC2 (por ejemplo, R4).

1. Lance una instancia Amazon EC2 basada enel tipo de instancia deseado. O bien identifique

514

https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/EC2_GetStarted.html

AWS Cloud9 Guía del usuarioRequisitos del host SSH

Requisito Instruccionesuna instancia existente en su cuenta de AWSque ejecute el tipo de instancia deseado.



Desea utilizar una instancia Amazon EC2 que estábasada en una Amazon Machine Image (AMI) queno es Amazon Linux o Ubuntu Server.

1. Lance una instancia Amazon EC2 basadaen la AMI deseada. O bien identifique unainstancia existente en su cuenta de AWS queesté basada en la AMI deseada.



Desea conectar varios entornos a una únicainstancia de informática en la nube existente o a supropio servidor.

1. Asegúrese de que la instancia o el servidorcumplen los requisitos (p. 515) que seindican más adelante en este tema.

2. Cree un entorno de SSH (p. 61) para cadaentorno al que desea que AWS Cloud9conecte la instancia o servidor.

Note

Si lanza una instancia Amazon EC2, podría incurrir en cargos en su cuenta de AWS para AmazonEC2. Para obtener más información, consulte Precios de Amazon EC2.

Requisitos del host SSHLa instancia de informática en la nube existente o su propio servidor deben cumplir los siguientes requisitospara que AWS Cloud9 los conecte a un entorno de SSH.

• Debe ejecutar Linux. (AWS Cloud9 no admite Windows).• Debe ser accesible a través de la red de Internet pública utilizando SSH. Si solo se puede acceder a

través de una nube virtual privada (VPC) o una red privada virtual (VPN), la VPC o VPN debe teneracceso a la Internet pública.

• Si el host es una instancia de informática en la nube de AWS existente y forma parte de una AmazonVirtual Private Cloud (Amazon VPC), existen requisitos adicionales. Consulte Configuración de AmazonVPC (p. 501).

• Debe tener instalada la versión 2.7 de Python. Para comprobar la versión, ejecute el comando python--version desde el terminal del servidor o la instancia existente. Para instalar Python 2.7 en lainstancia o el servidor, consulte uno de los siguientes temas:• Paso 1: Instalar las herramientas necesarias (p. 449) en el ejemplo de Python.• Descargue Python del sitio web de Python y consulte Installing Packages en la guía Python Packaging

User Guide.Note

Para conectar una instancia de informática en la nube de AWS existente para verificar y cumplirlos requisitos, consulte uno o varios de los siguientes recursos:

515

https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/EC2_GetStarted.html


https://www.python.org/downloads/

https://packaging.python.org/installing/

AWS Cloud9 Guía del usuarioInstalador de AWS Cloud9

• Para Amazon EC2, consulte Conexión con la instancia de Linux en la Guía del usuario deAmazon EC2 para instancias de Linux.

• Para Amazon Lightsail, consulte Conectarse a su instancia de Linux o Unix en Lightsail en ladocumentación de Amazon Lightsail.

• Para AWS Elastic Beanstalk, consulte Listado y conexión a instancias de servidor en la Guíapara desarrolladores de AWS Elastic Beanstalk.

• Para AWS OpsWorks, consulte Uso de SSH para iniciar sesión en una instancia de Linux enla AWS OpsWorks User Guide.

• Para otros servicios de AWS, consulte la documentación del servicio.Para conectarse a su propio servidor y comprobar y cumplir los requisitos, puede buscar enInternet usando una frase como "conectarse a un servidor con el comando ssh" (desde macOSo Linux) o "conectarse a un servidor con PuTTY" (desde Windows).

• Debe tener instalada la versión 0.6.16 o posterior de Node.js. Para comprobar la versión, ejecute elcomando node --version desde el terminal del servidor o la instancia existente. Para instalarNode.js en la instancia o el servidor, consulte uno de los siguientes temas:• Paso 1: Instalar las herramientas necesarias (p. 461) en la Muestra de Node.js.• Installing Node.js via package manager en el sitio web de Node.js.• Node Version Manager en GitHub.

• La ruta al directorio en la instancia existente o el servidor desde el que desea que se inicie AWS Cloud9después del inicio de sesión debe tener establecidos los permisos de acceso en rwxr-xr-x. Esosignifica que el propietario debe tener permisos de lectura, escritura y ejecución que correspondan alnombre de inicio de sesión que especifique en el asistente de creación de entorno (p. 71) para el usuarioen la página Configurar ajustes, el grupo al que pertenece el propietario debe tener permisos de lectura yejecución y el resto deben tener permisos de lectura y ejecución.

Por ejemplo, si la ruta del directorio es ~ (donde ~ representa el directorio de inicio del nombre de iniciode sesión especificado para el usuario en a página Configurar ajustes), puede establecer estos permisosen el directorio ejecutando el comando chmod desde la instancia o el servidor, tal y como se indica acontinuación.

sudo chmod u=rwx,g=rx,o=rx ~

• Descargue y ejecute el instalador de AWS Cloud9 (p. 517) en la instancia o servidor existente.• Si lo prefiere, puede restringir el tráfico de entrada por SSH únicamente a las direcciones IP que utiliza

AWS Cloud9. Para ello, establezca el tráfico SSH de entrada en los rangos de IP, tal y como se describeen Rangos de direcciones IP de entrada con SSH para AWS Cloud9 (p. 518).

Cuando esté seguro de que la instancia o el servidor cumplen todos los requisitos anteriores, cree unentorno de SSH (p. 71) al que AWS Cloud9 pueda conectarse.

Uso del instalador AWS Cloud9Antes de crear un entorno de desarrollo de SSH de AWS Cloud9, la instancia de informática en la nube(por ejemplo una instancia Amazon EC2) o el servidor que se conectará al entorno deben cumplir losRequisitos del host SSH (p. 515). Uno de estos requisitos consiste en descargar y ejecutar el instaladorde AWS Cloud9 en la instancia o servidor. El instalador de AWS Cloud9 es un script de shell de Linuxque comprueba si la instancia o servidor se ejecuta en una plataforma de sistema operativo y arquitecturaque AWS Cloud9 admita. Si esta comprobación se realiza correctamente, el script intentará instalar loscomponentes y las dependencias que AWS Cloud9 necesita para ubicarse en la instancia o servidor.

Este tema describe cómo descargar y ejecutar este script de instalación en la instancia de destino oservidor.

516

https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/AccessingInstances.html

https://lightsail.aws.amazon.com/ls/docs/how-to/article/lightsail-how-to-connect-to-your-instance-virtual-private-server

https://docs.aws.amazon.com/elasticbeanstalk/latest/dg/using-features.ec2connect.html

https://docs.aws.amazon.com/opsworks/latest/userguide/workinginstances-ssh.html


https://nodejs.org/en/download/package-manager/

http://nvm.sh

AWS Cloud9 Guía del usuarioDescargue y ejecute el instalador de AWS Cloud9

• Descargue y ejecute el instalador de AWS Cloud9. (p. 517)• Solución de problemas del instalador de AWS Cloud9 (p. 517)

Descargue y ejecute el instalador de AWS Cloud91. Asegúrese de que la instancia de informática en la nube o el servidor que se conectará al entorno

cumpla los Requisitos del host SSH (p. 515). Esto incluye tener versiones específicas de Pythony Node.js instaladas; configurar permisos específicos en el directorio desde el que desea que AWSCloud9 se ejecute después del inicio de sesión y configurar cualquier Amazon Virtual Private Cloudasociada.

2. Mientras está conectado a la instancia o servidor, ejecute uno de los siguientes comandos en esainstancia o servidor.

curl -L https://raw.githubusercontent.com/c9/install/master/install.sh | bashwget -O - https://raw.githubusercontent.com/c9/install/master/install.sh | bash

3. Si no hay errores en el mensaje Listo, puede crear el entorno SSH (p. 71).

Si se muestra un mensaje de error, consulte la siguiente sección para obtener información sobre laresolución de problemas.

Solución de problemas del instalador de AWS Cloud9En esta sección se describen los problemas más comunes, las posibles causas y las solucionesrecomendadas para solucionar los errores del instalador de AWS Cloud9.

Si su problema no aparece en el listado, o si necesita ayuda adicional, consulte el foro de debate sobreAWS Cloud9. (Cuando entre en este foro, es posible que AWS requiera que inicie sesión). También puedeponerse en contacto con nosotros directamente.

• -bash: wget: no se ha encontrado el comando (p. 517)• Error: instale make para continuar (p. 517)• Error: instale gcc para continuar (p. 518)• configure: error: no se ha encontrado curses (p. 518)

-bash: wget: no se ha encontrado el comandoProblema: al ejecutar el script de instalación, se muestra el siguiente mensaje: -bash: wget: commandnot found.

Causa posible: la utilidad wget no está instalada en la instancia o servidor.

Solución recomendada: ejecute el script de instalación en la instancia o servidor con la utilidad curl como alternativa.

Error: instale make para continuarProblema: al ejecutar el script de instalación, se muestra el siguiente mensaje: Error: please installmake to proceed.

Causa posible: la utilidad make no está instalada en la instancia o servidor.

Solución recomendada: instale la utilidad make y, a continuación, intente volver a ejecutar el script deinstalación en la instancia o servidor.

517




AWS Cloud9 Guía del usuarioRangos de direcciones IP de entrada con SSH

Para instalar la utilidad make , puede ejecutar un comando en la instancia o servidor como los siguientes.

• Para Amazon Linux, Amazon Linux 2 y Red Hat Enterprise Linux (RHEL) en ejecución en Amazon EC2: sudo yum -y groupinstall "Development Tools"

• Para Ubuntu Server en ejecución en Amazon EC2: sudo apt install -y build-essential• Para SUSE: sudo zypper install -y make

Error: instale gcc para continuarProblema: al ejecutar el script de instalación, se muestra el siguiente mensaje: Error: please installgcc to proceed.

Causa posible: la utilidad gcc no está instalada en la instancia o servidor.

Solución recomendada: instale la utilidad gcc y, a continuación, intente volver a ejecutar el script deinstalación en la instancia o servidor.

Para instalar la utilidad gcc , puede ejecutar un comando en la instancia o servidor como los siguientes.

• Para Amazon Linux, Amazon Linux 2 y Red Hat Enterprise Linux (RHEL) en ejecución en Amazon EC2: sudo yum -y groupinstall "Development Tools"

• Para Ubuntu Server en ejecución en Amazon EC2: sudo apt install -y build-essential• Para SUSE: sudo zypper install -y gcc• Para otros sistemas operativos, consulte Instalación de GCC.

configure: error: no se ha encontrado cursesProblema: al ejecutar el script de instalación, se muestra el siguiente mensaje: configure: error:curses not found.

Causa posible: la biblioteca para el control de terminales ncurses no está instalada en la instancia oservidor.

Solución recomendada: instale la biblioteca para el control de terminales ncurses (y, en algunossistemas operativos, la biblioteca glibc-static ) y, a continuación, intente volver a ejecutar el script deinstalación en la instancia o servidor.

Para instalar la biblioteca para el control de terminales ncurses (y, en algunos sistemas operativos,la biblioteca glibc-static ), puede ejecutar comandos en la instancia o en el servidor como lossiguientes.

• Para Amazon Linux, Amazon Linux 2 y Red Hat Enterprise Linux (RHEL) en ejecución en Amazon EC2: sudo yum -y install ncurses-devel

• Para SUSE: sudo zypper install -y ncurses-devel y sudo zypper install -y glibc-static

Rangos de direcciones IP de entrada con SSH paraAWS Cloud9

Puede restringir el tráfico entrante únicamente a los rangos de direcciones IP que AWS Cloud9 utiliza paraconectarse mediante SSH a instancias de informática en la nube de AWS (por ejemplo, instancias AmazonEC2) en una Amazon VPC o en los servidores de su red.

518

https://gcc.gnu.org/install/

AWS Cloud9 Guía del usuarioContenido de AMI

Note

En el caso de un entorno de EC2 creado el 31 de julio de 2018 o después, puede omitir estetema. Esto se debe a que AWS Cloud9 restringe automáticamente el tráfico SSH entrante deese entorno solo a las direcciones IP que se describen más adelante en este tema. AWS Cloud9lo hace añadiendo automáticamente una regla al grupo de seguridad asociado con la instanciaAmazon EC2 del entorno. Esta regla restringe el tráfico SSH entrante sobre el puerto 22 solo aaquellas direcciones IP de la región de AWS asociada.

Estos rangos de direcciones IP están en el archivo ip-ranges.json, tal y como se describe en Rangosde direcciones IP de AWS en la AWS General Reference. Para buscar los rangos IP de ese archivo:

• En Windows, si usa Herramientas de AWS para Windows PowerShell, ejecute el siguiente comando.

Get-AWSPublicIpAddressRange -ServiceKey CLOUD9

• En Linux, descargue el archivo ip-ranges.json. A continuación, puede realizar consultas en él medianteuna herramienta como jq , por ejemplo, ejecutando el siguiente comando.

jq '.prefixes[] | select(.service=="CLOUD9")' < ip-ranges.json

Estos rangos IP podrían cambiar ocasionalmente. Cuando haya un cambio, enviamos notificacionesa los suscriptores del tema AmazonIpSpaceChanged. Para obtener estas notificaciones, consulteNotificaciones de rangos de direcciones IP de AWS en la AWS General Reference.

Para utilizar estos rangos de direcciones IP cuando configure los entornos que utilizan instancias deinformática en la nube de AWS, consulte Configuración de VPC para entornos de desarrollo de AWSCloud9 (p. 501). Además, si elige restringir el tráfico entrante en los entornos de EC2 o entornos de SSHasociados con las instancias Amazon EC2 que se ejecutan en Amazon Linux o Ubuntu Server, asegúresetambién de permitir como mínimo todas las direcciones IP que usan TCP en los puertos 32768-61000.Para obtener más información, así como rangos de puertos para otros tipos de instancias de informática enla nube de AWS, consulte Puertos efímeros en la Guía del usuario de Amazon VPC.

Para utilizar estos rangos de direcciones IP al configurar los entornos de SSH que utilizan su red, consultela documentación de la red o con el administrador de red.

Contenido de imagen de máquina de Amazon (AMI)para un entorno de desarrollo de EC2 de AWSCloud9

Utilice la siguiente información para obtener detalles acerca de las imágenes de Amazon Machine (AMI)que AWS Cloud9 utiliza para un entorno de EC2.

Temas• Amazon Linux (p. 519)• Servidor Ubuntu (p. 520)

Amazon LinuxPara mostrar la versión de una instancia de Amazon Linux, ejecute el siguiente comando desde AWSCloud9 IDE para el entorno conectado o desde una utilidad SSH como el comando ssh o PuTTY.

519

https://docs.aws.amazon.com/general/latest/gr/aws-ip-ranges.html

https://docs.aws.amazon.com/general/latest/gr/aws-ip-ranges.html

https://ip-ranges.amazonaws.com/ip-ranges.json

https://docs.aws.amazon.com/general/latest/gr/aws-ip-ranges.html#subscribe-notifications


AWS Cloud9 Guía del usuarioServidor Ubuntu

cat /etc/system-release

Para mostrar una lista de los paquetes que están instalados en una instancia de Amazon Linux, ejecuteuno o más de los siguientes comandos.

Para mostrar todos los paquetes instalados en una sola lista:

sudo yum list installed

Para mostrar una lista de los paquetes instalados con los nombres de los paquetes que contienen el textoespecificado:

sudo yum list installed | grep YOUR_SEARCH_TERM

En el comando anterior, reemplace YOUR_SEARCH_TERM por parte del nombre del paquete. Por ejemplo,para mostrar una lista de todos los paquetes instalados con nombres que contienen sql:

sudo yum list installed | grep sql

Para mostrar una lista de todos los paquetes instalados, mostrados página por página:

sudo yum list installed | less

Para desplazarse a través de las páginas mostradas:

• Para pasar a la línea siguiente, pulse j.• Para pasar a la línea anterior, pulse k.• Para pasar a la página siguiente, pulse Ctrl-F.• Para pasar a la página anterior, pulse Ctrl-B.• Para salir, pulse q.

Para ver opciones adicionales, ejecute el siguiente comando man yum. Consulte también los paquetes dela AMI 2018.03 de Amazon Linux en el sitio web de la AMI de Amazon Linux.

Servidor UbuntuPara mostrar la versión de una instancia de Ubuntu Server, ejecute el siguiente comando desde AWSCloud9 IDE para el entorno conectado o desde una utilidad SSH como el comando ssh o PuTTY.

lsb_release -a

La versión se mostrará junto al campo Descripción.

Para mostrar una lista de los paquetes que están instalados en un Ubuntu Server, ejecute uno o más delos siguientes comandos.

Para mostrar todos los paquetes instalados en una sola lista:

sudo apt list --installed

Para mostrar una lista de los paquetes instalados con los nombres de los paquetes que contienen el textoespecificado:

520

https://aws.amazon.com/amazon-linux-ami/2018-03-packages/

https://aws.amazon.com/amazon-linux-ami/2018-03-packages/

AWS Cloud9 Guía del usuarioAutenticación y control de acceso

sudo apt list --installed | grep YOUR_SEARCH_TERM

En el comando anterior, reemplace YOUR_SEARCH_TERM por parte del nombre del paquete. Por ejemplo,para mostrar una lista de todos los paquetes instalados con nombres que contienen sql:

sudo apt list --installed grep sql

Para mostrar una lista de todos los paquetes instalados, página por página:

sudo apt list --installed | less

Para desplazarse a través de las páginas mostradas:

• Para pasar a la línea siguiente, pulse j.• Para pasar a la línea anterior, pulse k.• Para pasar a la página siguiente, pulse Ctrl-F.• Para pasar a la página anterior, pulse Ctrl-B.• Para salir, pulse q.

Para ver opciones adicionales, ejecute el siguiente comando man apt. Consulte también Búsqueda depaquetes de Ubuntu en el sitio web de Ubuntu.

Referencia de los permisos de acceso de AWSCloud9

El acceso a AWS Cloud9 requiere credenciales de acceso de AWS. Estas credenciales deben tenerpermisos para realizar operaciones como crear, compartir o eliminar un entorno de desarrollo de AWSCloud9. En las secciones siguientes se describe cómo utilizar AWS Identity and Access Management(IAM) para permitir o denegar el acceso a los recursos de AWS Cloud9 y después asignar esos permisos acredenciales.

Temas• Información general (p. 521)• Políticas administradas (predefinidas) por AWS para AWS Cloud9 (p. 525)• Creación de políticas administradas por el cliente para AWS Cloud9 (p. 528)• credenciales temporales administradas de AWS (p. 537)

Información generalEn esta sección encontrará información general sobre el modelo de la autenticación y el control de accesode IAM que se aplica a AWS Cloud9.

Note

Si solo desea configurar conjuntos predefinidos de permisos de acceso para situaciones de uso ytipos de usuario comunes, continúe en Políticas administradas (predefinidas) por AWS para AWSCloud9 (p. 525).

Temas

521

https://packages.ubuntu.com/

https://packages.ubuntu.com/

AWS Cloud9 Guía del usuarioInformación general

• Autenticación (p. 522)• Control de acceso (p. 523)• Recursos y operaciones de AWS Cloud9 (p. 523)• Titularidad de los recursos (p. 524)• Administración del acceso a los recursos (p. 524)

AutenticaciónPuede obtener acceso a AWS con los siguientes tipos de identidades:

Usuario raíz de la cuenta de AWS

Cuando se inscriba en AWS, tendrá que proporcionar la dirección de correo electrónico y la contraseñaasociadas a su cuenta de AWS. Estas son las credenciales raíz y proporcionan acceso completo a todoslos recursos de AWS.

Important

Como una práctica recomendada de seguridad de AWS, recomendamos utilizar las credencialesraíz solo para crear un grupo administrador de IAM con un usuario administrador de IAM. Se tratade un grupo que da al usuario permisos completos a la cuenta de AWS. Después, podrá utilizareste usuario administrador para crear otros usuarios y funciones de IAM con permisos limitados.Para obtener más información, consulte Crear usuarios de IAM individuales y Creación de ungrupo y usuario administrador de IAM en la Guía del usuario de IAM.

Usuario de IAM

Un usuario de IAM es simplemente una identidad dentro de una cuenta de AWS que tiene permisospersonalizados específicos (por ejemplo, para crear un entorno de desarrollo de AWS Cloud9). Puedeutilizar un nombre de usuario y contraseña de IAM para iniciar sesión en páginas web seguras de AWScomo la consola de AWS Cloud9, la Consola de administración de AWS, los foros de debate de AWS y elcentro de soporte de AWS Support.

Además de un nombre de usuario y una contraseña, también puede generar claves de acceso paracada usuario. Puede utilizar estas claves cuando obtenga acceso a los servicios de AWS medianteprogramación, ya sea a través de uno de los varios SDK de AWS o mediante la AWS Command LineInterface (AWS CLI) o el aws-shell. Los SDK de AWS, la AWS CLI y el aws-shell usan estas claves deacceso para firmar criptográficamente la solicitud. Si no utiliza estas herramientas, debe firmar la solicitud.AWS Cloud9 es compatible con Signature Version 4, un protocolo para autenticar solicitudes entrantes dela API. Para obtener más información acerca de la autenticación de solicitudes, consulte Proceso de firmaSignature Version 4 en la Referencia general de Amazon Web Services.

Rol de IAM

Un rol de IAM es otra identidad de IAM que puede crear en la cuenta que tiene permisos específicos. Essimilar a un usuario de IAM, pero no está asociado a una persona determinada. Las funciones de IAM lepermiten obtener claves de acceso temporales que se pueden usar para obtener acceso a los recursos yservicios de AWS. Las funciones de IAM con credenciales temporales son útiles en los siguientes casos:

Acceso a los servicios de AWS

Puede utilizar un rol de IAM en su cuenta para conceder permisos a otra cuenta de AWS para que tengaacceso a los recursos de su cuenta. Por ejemplo, puede crear una función que permita a AWS Lambdatener acceso a un bucket de Amazon S3 en su nombre y, a continuación, cargar los datos almacenadosen el bucket en un Amazon Redshift. Para obtener más información, consulte Crear un rol para delegarpermisos a un servicio de AWS en la Guía del usuario de IAM.

Aplicaciones que se ejecutan en Amazon EC2

522

https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html#create-iam-users



https://docs.aws.amazon.com/general/latest/gr/signature-version-4.html

https://docs.aws.amazon.com/general/latest/gr/signature-version-4.html




En lugar de almacenar claves de acceso en la instancia Amazon EC2 para que las usen aplicacionesque se ejecutan en la instancia y que realizan solicitudes de API de AWS, puede usar un rol de IAM paraadministrar credenciales temporales para estas aplicaciones. Para asignar un rol de AWS a una instanciaAmazon EC2 y ponerla a disposición de todas las aplicaciones, cree un perfil de instancia asociado a dichainstancia. Un perfil de instancia contiene el rol y permite a los programas que se encuentran en ejecuciónen la instancia Amazon EC2 obtener credenciales temporales. Para obtener más información, consulteCreación y uso de un perfil de instancia para administrar credenciales temporales y Uso de un rol de IAMpara conceder permisos a aplicaciones que se ejecutan en instancias Amazon EC2 en la Guía del usuariode IAM.

Note

En lugar de asociar un perfil de instancia a una instancia Amazon EC2 que se conecta a unentorno AWS Cloud9, puede configurar y administrar automáticamente credenciales temporalesen su nombre en un entorno de EC2. Para obtener más información, consulte credencialestemporales administradas de AWS (p. 537).

Acceso de usuarios federados

En lugar de crear un usuario de IAM, puede usar identidades de usuario preexistentes de AWS DirectoryService, del directorio de usuarios de la compañía o de un proveedor de identidades web. A estasidentidades se les llama usuarios federados. AWS asigna una rol a un usuario federado cuando se solicitaacceso a través de un proveedor de identidades. Para obtener más información, consulte Usuariosfederados y roles en la Guía del usuario de IAM.

Control de accesoPuede tener credenciales válidas para autenticar las solicitudes, pero a menos que tenga permisos nopodrá crear ni tener acceso a los recursos de AWS Cloud9. Por ejemplo, debe disponer de permisos paracrear, compartir o eliminar un entorno de desarrollo de AWS Cloud9.

Cada recurso de AWS es propiedad de una cuenta de AWS, y los permisos para crear o tener acceso aun recurso se rigen por las políticas de permisos. Un administrador de cuentas puede asociar políticas depermisos a identidades de IAM (es decir, usuarios, grupos y funciones).

Cuando concede permisos, decide quién obtiene los permisos, los recursos a los que se tiene acceso y lasacciones que se pueden realizar en esos recursos.

Recursos y operaciones de AWS Cloud9En AWS Cloud9, el recurso principal es un entorno de desarrollo de AWS Cloud9. En las políticas seemplean nombres de recurso de Amazon (ARN) para identificar los recursos a los que se aplican laspolíticas. En la siguiente tabla se incluyen ARN de entorno. Para obtener más información, consulteNombres de recursos de Amazon (ARNs) y espacios de nombres de servicios de AWS en la Referenciageneral de Amazon Web Services.

Tipo de recurso Formato de ARN

entorno arn:aws:cloud9:REGION_ID:ACCOUNT_ID:environment:ENVIRONMENT_ID

Todos los entorno propiedad de la cuentaespecificada en la región determinada

arn:aws:cloud9:REGION_ID:ACCOUNT_ID:environment:*

Todos los entorno propiedad de la cuentaespecificada en la región determinada

arn:aws:cloud9:REGION_ID:ACCOUNT_ID:*

Todos los recursos de AWS Cloud9,independientemente de la cuenta o región

arn:aws:cloud9:*

523

https://docs.aws.amazon.com/IAM/latest/UserGuide/credentials.html#credentials-temporary

https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_use_switch-role-ec2.html

https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_use_switch-role-ec2.html

https://docs.aws.amazon.com/IAM/latest/UserGuide/introduction_access-management.html#intro-access-roles

https://docs.aws.amazon.com/IAM/latest/UserGuide/introduction_access-management.html#intro-access-roles

https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html


Por ejemplo, puede indicar un entorno específico en la instrucción usando su ARN de este modo.

"Resource": "arn:aws:cloud9:us-east-2:123456789012:environment:70d899206236474f9590d93b7c41dfEX"

Para especificar todos los recursos, utilice el carácter comodín (*) en el elemento Resource, tal y como seindica a continuación.

"Resource": "*"

Para especificar varios recursos en una única instrucción, separe sus ARN con comas, tal y como se indicaa continuación.

"Resource": [ "arn:aws:cloud9:us-east-2:123456789012:environment:70d899206236474f9590d93b7c41dfEX", "arn:aws:cloud9:us-east-2:123456789012:environment:81e900317347585a0601e04c8d52eaEX"]

AWS Cloud9 proporciona un conjunto de operaciones para trabajar con recursos de AWS Cloud9. Para veruna lista, consulte la Referencia de permisos de AWS Cloud9 (p. 535).

Titularidad de los recursosLa cuenta de AWS es la propietaria de los recursos que se crean en ella, independientemente de quién loshaya creado. Por ejemplo:

• Si utiliza las credenciales de cuenta raíz de la cuenta de AWS para crear un entorno de desarrollo deAWS Cloud9 (lo cual, si bien es posible, no se recomienda como práctica de seguridad de AWS), lacuenta de AWS es el propietario del entorno.

• Si crea un usuario de IAM en su cuenta de AWS y concede permisos para crear un entorno a eseusuario, el usuario puede crear un entorno. Sin embargo, su cuenta de AWS, a la que pertenece elusuario, será la propietaria del entorno.

• Si crea un rol de IAM en su cuenta de AWS con permisos para crear un entorno, cualquier personaque pueda asumir el rol podrá crear un entorno. La cuenta de AWS a la que pertenece el rol será lapropietaria del entorno.

Administración del acceso a los recursosUna política de permisos describe quién tiene acceso a qué recursos.

Note

En esta sección, se describe cómo se utiliza IAM en AWS Cloud9. No se proporciona informacióndetallada sobre el servicio IAM. Para ver la documentación completa de IAM, consulte ¿Quées IAM? en la Guía del usuario de IAM. Para obtener más información acerca de la sintaxis ydescripciones de la política de IAM, consulte Referencia de políticas JSON de IAM en la Guía delusuario de IAM.

Las políticas que se asocian a una identidad de IAM se denominan políticas basadas en identidad (opolíticas de IAM). Las políticas de permisos que se asocian a un recurso se denominan políticas basadasen recursos. AWS Cloud9 solo admite las políticas basadas en identidades y recursos.

Cada una de las siguientes acciones de la API solo necesita una política de IAM para adjuntarse a laidentidad de IAM que desea llamar a estas acciones de API.

• CreateEnvironmentEC2

• DescribeEnvironments

524

https://docs.aws.amazon.com/IAM/latest/UserGuide/introduction.html

https://docs.aws.amazon.com/IAM/latest/UserGuide/introduction.html


AWS Cloud9 Guía del usuarioPolíticas administradas (predefinidas)

por AWS para AWS Cloud9

Las siguientes acciones de API requieren una política basada en recursos. No es necesaria una política deIAM, pero AWS Cloud9 utilizará una política de IAM si está adjunta a la identidad de IAM que desea llamara estas acciones de API. La política basada en recursos debe aplicarse al recurso AWS Cloud9 deseado.

• CreateEnvironmentMembership

• DeleteEnvironment

• DeleteEnvironmentMembership

• DescribeEnvironmentMemberships

• DescribeEnvironmentStatus

• UpdateEnvironment

• UpdateEnvironmentMembership

Para obtener más información sobre lo que hace cada una de estas acciones de API, consulte laReferencia de la API de AWS Cloud9.

No se puede asociar una política basada en recursos a un recurso de AWS Cloud9 directamente. Encambio, AWS Cloud9 adjunta las políticas basadas en recursos correspondientes a los recursos de AWSCloud9 a medida que añade, modifica, actualiza o elimina miembros del entorno.

Para conceder permisos a un usuario para realizar acciones en recursos de AWS Cloud9, asocie unapolítica de permisos a un grupo de IAM al que pertenezca el usuario. Le recomendamos asociar unapolítica administrada (predefinida) por AWS para AWS Cloud9 siempre que sea posible. Las políticasadministradas por AWS se asocian más fácil y rápidamente. También contienen conjuntos predefinidos depermisos de acceso para situaciones de uso y tipos de usuario comunes, por ejemplo, la administracióncompleta de un entorno, los usuarios de un entorno y los usuarios que únicamente tienen acceso de sololectura a un entorno. Para ver una lista de políticas administradas por AWS para AWS Cloud9, consultePolíticas administradas (predefinidas) por AWS para AWS Cloud9 (p. 525).

Para casos de uso más detallados y tipos de usuario único, puede crear y asociar políticas propiasadministrada por el cliente. Consulte Opciones de configuración adicionales para AWS Cloud9 (Team yEnterprise) (p. 23) y Creación de políticas administradas por el cliente para AWS Cloud9 (p. 528).

Para asociar una política de IAM (administrada por AWS o por el cliente) a una identidad de IAM, consulteAsociación de políticas de IAM (consola) en la Guía del usuario de IAM.

Políticas administradas (predefinidas) por AWS paraAWS Cloud9AWS aborda muchos casos de uso comunes proporcionando políticas de IAM independientes que AWScrea y administra. Estas políticas administradas por AWS conceden los permisos necesarios para casosde uso comunes, lo que le evita tener que investigar los permisos que se necesitan. Por ejemplo, puedeutilizar políticas administradas por AWS para AWS Cloud9 para permitir de manera rápida y sencilla quelos usuarios tengan la administración completa de un entorno de desarrollo de AWS Cloud9, actúen comoun usuario del entorno o usen un entorno al que están añadidos. Para obtener más información, consultePolíticas administradas por AWS en la Guía del usuario de IAM.

Para asociar una política administrada por AWS a una identidad de IAM, consulte Asociación de políticasde IAM (consola) en la Guía del usuario de IAM.

Las siguientes políticas administradas por AWS, que puede asociar a identidades de IAM de su cuenta,son específicas de AWS Cloud9.

• AWSCloud9Administrator: ofrece los permisos siguientes:• Amazon EC2: obtener información acerca de las Amazon VPC y las subredes de su cuenta de AWS.

525

https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage-attach-detach.html#attach-managed-policy-console

https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html#aws-managed-policies





• AWS Cloud9: todas las acciones de AWS Cloud9 en su cuenta de AWS.• IAM: obtener información acerca de los usuarios de IAM en su cuenta de AWS y crear el rol vinculado

al servicio de AWS Cloud9 en su cuenta de AWS según sea necesario.

La política administrada AWSCloud9Administrator siguiente contiene los permisos siguientes:

{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "cloud9:*", "ec2:DescribeSubnets", "ec2:DescribeVpcs", "iam:GetUser", "iam:ListUsers" ], "Resource": "*" }, { "Effect": "Allow", "Action": [ "iam:CreateServiceLinkedRole" ], "Resource": "*", "Condition": { "StringLike": { "iam:AWSServiceName": "cloud9.amazonaws.com" } } } ]}

• AWSCloud9User: ofrece los permisos siguientes:• Amazon EC2: obtener información acerca de las Amazon VPC y las subredes de su cuenta de AWS.• AWS Cloud9: crear y obtener información sobre sus entornos, así como obtener y cambiar la

configuración de usuario para sus entornos.• IAM: obtener información acerca de los usuarios de IAM en su cuenta de AWS y crear el rol vinculado

al servicio de AWS Cloud9 en su cuenta de AWS según sea necesario.

La política administrada AWSCloud9User siguiente contiene los permisos siguientes:

{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "cloud9:CreateEnvironmentEC2", "cloud9:CreateEnvironmentSSH", "cloud9:GetUserPublicKey", "cloud9:GetUserSettings", "cloud9:UpdateUserSettings", "cloud9:ValidateEnvironmentName", "ec2:DescribeSubnets", "ec2:DescribeVpcs", "iam:GetUser", "iam:ListUsers" ], "Resource": "*"

526



}, { "Effect": "Allow", "Action": [ "cloud9:DescribeEnvironmentMemberships" ], "Resource": "*", "Condition": { "Null": { "cloud9:UserArn": "true", "cloud9:EnvironmentId": "true" } } }, { "Effect": "Allow", "Action": [ "iam:CreateServiceLinkedRole" ], "Resource": "*", "Condition": { "StringLike": { "iam:AWSServiceName": "cloud9.amazonaws.com" } } } ]}

• AWSCloud9EnvironmentMember: ofrece los permisos siguientes:• AWS Cloud9: obtener información sobre entornos cuando se les invite a hacerlo y obtener la

configuración de usuario para entornos cuando se les invite a hacerlo.• IAM: obtener información acerca de los usuarios de IAM en su cuenta de AWS.

La política administrada AWSCloud9EnvironmentMember siguiente contiene los permisos siguientes:

{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "cloud9:GetUserSettings", "cloud9:UpdateUserSettings", "iam:GetUser", "iam:ListUsers" ], "Resource": "*" }, { "Effect": "Allow", "Action": [ "cloud9:DescribeEnvironmentMemberships" ], "Resource": "*", "Condition": { "Null": { "cloud9:UserArn": "true", "cloud9:EnvironmentId": "true" } } } ]

527

AWS Cloud9 Guía del usuarioCreación de políticas administradas

por el cliente para AWS Cloud9

}

Creación de políticas administradas por el cliente paraAWS Cloud9Si ninguna de las políticas administradas por AWS satisface sus requisitos de control de acceso, puedecrear y asociar sus propias políticas administradas por el cliente.

Para crear una política administrada por el cliente, consulte Creación de políticas de IAM (consola) en laGuía del usuario de IAM.

Temas• Especificar elementos de política: efectos, entidades principales, acciones y recursos (p. 528)• Ejemplos de políticas administradas por los clientes (p. 528)• Referencia de permisos de AWS Cloud9 (p. 535)

Especificar elementos de política: efectos, entidades principales,acciones y recursosPara cada recurso de AWS Cloud9, el servicio define un conjunto de operaciones de API. Para concederpermisos a estas operaciones de API, AWS Cloud9 define un conjunto de acciones que puede especificaren una política.

A continuación, se indican los elementos básicos de la política:

• Effect: especifique el efecto (permitir o denegar) cuando el usuario solicite la acción específica. Si noconcede acceso de forma explícita (permitir) a un recurso, el acceso se deniega implícitamente. Tambiénpuede denegar explícitamente el acceso a un recurso. Puede hacer esto para asegurarse de que unusuario no tenga acceso a un recurso, aunque otra política se lo conceda.

• Principal: en las políticas basadas en identidad (políticas de IAM), el usuario al que se asocia estapolítica es la entidad principal implícita. Para las políticas basadas en recursos, debe especificar elusuario, cuenta, servicio u otra entidad que desee que reciba permisos.

• Resource: se emplean los nombres de recurso de Amazon (ARN) para identificar los recursos a los quese aplican las políticas.

• Action: use palabras de clave de acción para identificar las operaciones del recurso que desea permitiro denegar. Por ejemplo, el permiso cloud9:CreateEnvironmentEC2 concede a los usuarios permisopara realizar la operación CreateEnvironmentEC2.

Para obtener más información sobre la sintaxis y las descripciones de las políticas de IAM, consulteReferencia de políticas JSON de IAM en la Guía del usuario de IAM.

Para ver una tabla con todas las acciones de API de AWS Cloud9 y los recursos a los que se aplican,consulte la Referencia de permisos de AWS Cloud9 (p. 535).

Ejemplos de políticas administradas por los clientesEn esta sección, encontrará ejemplos de políticas que conceden permisos para acciones de AWS Cloud9.Puede adaptar las siguientes políticas de ejemplo de IAM para permitir o denegar explícitamente acceso aAWS Cloud9 a sus identidades de IAM.

Para crear o asociar una política administrada por el cliente a una identidad de IAM, consulte Creación depolíticas de IAM (consola) y Asociación de política de IAM (consola) en la Guía del usuario de IAM.

528

https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create.html#access_policies_create-start







Note

En los siguientes ejemplos se utiliza la Región EE.UU Este (Ohio) (us-east-2), un ID de cuentade AWS ficticio (123456789012) y un ID de entorno de desarrollo de AWS Cloud9 ficticio(81e900317347585a0601e04c8d52eaEX).

Temas• Obtener información acerca de entornos (p. 529)• Create entornos de EC2 (p. 529)• Crear entornos de EC2 con tipos de instancias Amazon EC2 específicos (p. 530)• Crear entornos de EC2 en subredes Amazon VPC específicas (p. 530)• Crear un entorno de EC2 con un nombre de entorno específico (p. 531)• Crear entornos de SSH únicamente (p. 531)• Actualizar entornos o impedir la actualización de un entorno (p. 531)• Obtener listas de miembros del entorno (p. 532)• Compartir entornos con un usuario específico únicamente (p. 532)• Impedir que se compartan entornos (p. 533)• Cambiar o evitar el cambio, de la configuración de miembros del entorno (p. 533)• Eliminar o impedir la eliminación, de miembros del entorno (p. 534)• Eliminar entornos o impedir la eliminación de un entorno (p. 534)

Obtener información acerca de entornos

En la siguiente instrucción de política de IAM de ejemplo, asociada a una entidad de IAM, se permite quedicha entidad obtenga información sobre cualquier entorno de sus cuentas.

{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "cloud9:DescribeEnvironments", "Resource": "*" } ]}

Observe que el permiso de acceso anterior ya se incluye en las políticas administradas por AWSAWSCloud9Administrator y AWSCloud9User.

Create entornos de EC2

En la siguiente instrucción de política de IAM de ejemplo, asociada a una entidad de IAM, se permite quedicha entidad cree entornos de desarrollo de EC2 de AWS Cloud9 en sus cuentas.

{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "cloud9:CreateEnvironmentEC2", "Resource": "*" }

529



]}

Observe que el permiso de acceso anterior ya se incluye en las políticas administradas por AWSAWSCloud9Administrator y AWSCloud9User.

Crear entornos de EC2 con tipos de instancias Amazon EC2 específicos

En la siguiente instrucción de política de IAM de ejemplo, asociada a una entidad de IAM, se permite quedicha entidad cree entornos de desarrollo de EC2 de AWS Cloud9 en sus cuentas. Sin embargo, entornosde EC2 solo pueden usar la clase especificada de tipos de instancias Amazon EC2.

{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "cloud9:CreateEnvironmentEC2", "Resource": "*", "Condition": { "StringLike": { "cloud9:InstanceType": "t2.*" } } } ]}

Observe que si la política administrada por AWS AWSCloud9Administrator o AWSCloud9User yaestá asociada a la entidad de IAM, esas políticas administradas por AWS anularán el comportamientode la instrucción de la política de IAM anterior, ya que dichas políticas administradas por AWS son máspermisivas.

Crear entornos de EC2 en subredes Amazon VPC específicas

En la siguiente instrucción de política de IAM de ejemplo, asociada a una entidad de IAM, se permite quedicha entidad cree entornos de desarrollo de EC2 de AWS Cloud9 en sus cuentas. Sin embargo, entornosde EC2 solo puede utilizar subredes de Amazon VPC especificadas.

{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "cloud9:CreateEnvironmentEC2", "Resource": "*", "Condition": { "StringLike": { "cloud9:SubnetId": [ "subnet-12345678", "subnet-23456789" ] } } } ]}

Observe que si la política administrada por AWS AWSCloud9Administrator o AWSCloud9User yaestá asociada a la entidad de IAM, esas políticas administradas por AWS anularán el comportamiento

530



de la instrucción de la política de IAM anterior, ya que dichas políticas administradas por AWS son máspermisivas.

Crear un entorno de EC2 con un nombre de entorno específico

En la siguiente instrucción de política de IAM de ejemplo, asociada a una entidad de IAM, se permite quedicha entidad cree un entorno de desarrollo de EC2 de AWS Cloud9 en sus cuentas. Sin embargo, elentorno de EC2 solo puede utilizar el nombre especificado.

{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "cloud9:CreateEnvironmentEC2", "Resource": "*", "Condition": { "StringEquals": { "cloud9:EnvironmentName": "my-demo-environment" } } } ]}


Crear entornos de SSH únicamente

En la siguiente instrucción de política de IAM de ejemplo, asociada a una entidad de IAM, se permite quedicha entidad cree entornos de desarrollo de SSH de AWS Cloud9 en sus cuentas. Sin embargo, la entidadno puede crear entornos de desarrollo de EC2 de AWS Cloud9.

{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "cloud9:CreateEnvironmentSSH", "Resource": "*" }, { "Effect": "Deny", "Action": "cloud9:CreateEnvironmentEC2", "Resource": "*" } ]}

Actualizar entornos o impedir la actualización de un entorno

En la siguiente instrucción de política de IAM de ejemplo, asociada a una entidad de IAM, se permite quedicha entidad cambie información sobre cualquier entorno de desarrollo de AWS Cloud9 de sus cuentas.

{ "Version": "2012-10-17",

531



"Statement": [ { "Effect": "Allow", "Action": "cloud9:UpdateEnvironment", "Resource": "*" } ]}

Observe que el permiso de acceso anterior ya se incluye en la política administrada por AWSAWSCloud9Administrator.

La siguiente instrucción de política de IAM asociada a una entidad de IAM, impide de forma explícita quedicha entidad cambie información sobre el entorno con el ARN especificado.

{ "Version": "2012-10-17", "Statement": [ { "Effect": "Deny", "Action": "cloud9:UpdateEnvironment", "Resource": "arn:aws:cloud9:us-east-2:123456789012:environment:81e900317347585a0601e04c8d52eaEX" } ]}

Obtener listas de miembros del entorno

En la siguiente instrucción de política de IAM de ejemplo, asociada a una entidad de IAM, se permite quedicha entidad obtenga una lista de los miembros de cualquier entorno de sus cuentas.

{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "cloud9:DescribeEnvironmentMemberships", "Resource": "*" } ]}

Observe que el permiso de acceso anterior ya se incluye en la política administrada por AWSAWSCloud9Administrator. Observe también que el permiso de acceso anterior es más permisivo queel permiso equivalente de la política administrada por AWS AWSCloud9User.

Compartir entornos con un usuario específico únicamente

La siguiente instrucción de política de IAM de ejemplo, asociada a una entidad de IAM, permite que dichaentidad comparta una entorno de sus cuentas con el usuario especificado únicamente.

{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "cloud9:CreateEnvironmentMembership"

532



], "Resource": "*", "Condition": { "StringEquals": { "cloud9:UserArn": "arn:aws:iam::123456789012:user/MyDemoUser" } } } ]}


Impedir que se compartan entornos

La siguiente instrucción de política de IAM de ejemplo, asociada a una entidad de IAM, evita que dichaentidad comparta ningún entorno de sus cuentas.

{ "Version": "2012-10-17", "Statement": [ { "Effect": "Deny", "Action": [ "cloud9:CreateEnvironmentMembership", "cloud9:UpdateEnvironmentMembership" ], "Resource": "*" } ]}

Cambiar o evitar el cambio, de la configuración de miembros del entorno

En la siguiente instrucción de política de IAM de ejemplo, asociada a una entidad de IAM, se permite quedicha entidad cambie la configuración de los miembros de cualquier entorno de sus cuentas.

{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "cloud9:UpdateEnvironmentMembership", "Resource": "*" } ]}


La siguiente instrucción de política de IAM asociada a una entidad de IAM, impide de forma explícita quedicha entidad cambie la configuración de los miembros sobre el entorno con el ARN especificado.

{ "Version": "2012-10-17",

533



"Statement": [ { "Effect": "Deny", "Action": "cloud9:UpdateEnvironmentMembership", "Resource": "arn:aws:cloud9:us-east-2:123456789012:environment:81e900317347585a0601e04c8d52eaEX" } ]}

Eliminar o impedir la eliminación, de miembros del entorno

La siguiente instrucción de política de IAM de ejemplo, asociada a una entidad de IAM, permite que dichaentidad elimine cualquier miembro de cualquier entorno de sus cuentas.

{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "cloud9:DeleteEnvironmentMembership", "Resource": "*" } ]}


La siguiente instrucción de política de IAM asociada a una entidad de IAM, impide de forma explícita quedicha entidad elimine ningún miembro del entorno con el ARN especificado.

{ "Version": "2012-10-17", "Statement": [ { "Effect": "Deny", "Action": "cloud9:DeleteEnvironmentMembership", "Resource": "arn:aws:cloud9:us-east-2:123456789012:environment:81e900317347585a0601e04c8d52eaEX" } ]}

Eliminar entornos o impedir la eliminación de un entorno

La siguiente instrucción de política de IAM de ejemplo, asociada a una entidad de IAM, permite que dichaentidad elimine cualquier entorno de sus cuentas.

{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "cloud9:DeleteEnvironment", "Resource": "*" } ]}

534




La siguiente instrucción de política de IAM asociada a una entidad de IAM, impide de forma explícita quedicha entidad elimine el entorno con el ARN especificado.

{ "Version": "2012-10-17", "Statement": [ { "Effect": "Deny", "Action": "cloud9:DeleteEnvironment", "Resource": "arn:aws:cloud9:us-east-2:123456789012:environment:81e900317347585a0601e04c8d52eaEX" } ]}

Referencia de permisos de AWS Cloud9Puede utilizar la siguiente tabla como referencia cuando configure políticas de control de acceso y deescritura pueda asociar a una identidad de IAM (políticas basadas en identidad).

Puede utilizar claves de condiciones generales de AWS en sus políticas de AWS Cloud9 para expresarcondiciones. Para ver una lista, consulte Elementos de política JSON de IAM: Condition en la Guía delusuario de IAM.

Las acciones se especifican en el campo Action de la política. Para especificar una acción,use el prefijo cloud9: seguido del nombre de operación de la API (por ejemplo, "Action":"cloud9:DescribeEnvironments"). Para especificar varias acciones en una única instrucción,sepárelas con comas (por ejemplo, "Action": [ "cloud9:UpdateEnvironment","cloud9:DeleteEnvironment" ]).

Temas• Uso de caracteres comodín (p. 535)• Operaciones de API y permisos necesarios para acciones de AWS Cloud9 (p. 536)

Uso de caracteres comodín

Debe especificar un ARN, con o sin un carácter comodín (*), como el valor del recurso en el campo de lapolítica Resource. Puede utilizar un carácter comodín para especificar varias acciones o recursos. Porejemplo, cloud9:* especifica todas las acciones de AWS Cloud9 y cloud9:Describe* especifica todaslas acciones de AWS Cloud9 que comienzan por la palabra Describe.

En el siguiente ejemplo se permite que una entidad de IAM obtenga información acerca de lassuscripciones a los entornos y entorno de cualquier entorno de sus cuentas.

{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "cloud9:Describe*" ], "Resource": "*" }

535

https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition.html



]}

Observe que el permiso de acceso anterior ya se incluye en la política administrada por AWSAWSCloud9Administrator. Observe también que el permiso de acceso anterior es más permisivo queel permiso equivalente de la política administrada por AWS AWSCloud9User.

Operaciones de API y permisos necesarios para acciones de AWS Cloud9

Operación de AWS Cloud9 Permisos necesarios (acción dela API)

Recurso

CreateEnvironmentEC2 cloud9:CreateEnvironmentEC2

Necesario para crear un entornode desarrollo de EC2 de AWSCloud9.

*

CreateEnvironmentMembershipcloud9:CreateEnvironmentMembership

Necesario para añadir unmiembro a un entorno.

arn:aws:cloud9:REGION_ID:ACCOUNT_ID:environment:ENVIRONMENT_ID

DeleteEnvironment cloud9:DeleteEnvironment

Necesario para eliminar unentorno.


DeleteEnvironmentMembershipcloud9:DeleteEnvironmentMembership

Necesario para eliminar unmiembro a un entorno.


DescribeEnvironmentMembershipscloud9:DescribeEnvironmentMemberships

Necesario para obtener una listade miembros en un entorno.

*

DescribeEnvironments cloud9:DescribeEnvironments

Necesario para obtenerinformación sobre un entorno.


DescribeEnvironmentStatus cloud9:DescribeEnvironmentStatus

Necesario para obtenerinformación sobre el estado deun entorno.


UpdateEnvironment cloud9:UpdateEnvironment

Necesario para actualizar laconfiguración de un entorno.


UpdateEnvironmentMembershipcloud9:UpdateEnvironmentMembership

Necesario para actualizar laconfiguración de un miembro enun entorno.


536

AWS Cloud9 Guía del usuariocredenciales temporales administradas de AWS

credenciales temporales administradas de AWS

Si solo busca la lista de acciones que admite credenciales temporales administradas de AWS, vayadirectamente a Acciones admitidas en credenciales temporales administradas de AWS (p. 538).

Para un entorno de desarrollo de EC2 de AWS Cloud9, AWS Cloud9 crea credenciales de acceso de AWStemporales disponibles en el entorno. Las denominamos credenciales temporales administradas de AWS.Esto proporciona los siguientes beneficios:

• No es necesario almacenar las credenciales de acceso de AWS permanentes de una entidad de AWS(por ejemplo, un usuario de IAM) en cualquier lugar del entorno. Esto impide que los miembros delentorno tengan acceso a esas credenciales sin su conocimiento y aprobación.

• No es necesario configurar, administrar ni adjuntar manualmente un perfil de instancia a la instanciaAmazon EC2 que se conecta al entorno. (Un perfil de instancia es otra estrategia para administrarcredenciales temporales de acceso a AWS).

• AWS Cloud9 renueva constantemente sus credenciales temporales, por lo que un único conjunto decredenciales solo se puede utilizar durante un tiempo limitado. Esta es una práctica recomendada deseguridad de AWS. Para obtener más información, consulte Creación y actualización de credencialestemporales administradas de AWS (p. 539).

• AWS Cloud9 pone restricciones adicionales sobre cómo se pueden usar las credenciales temporalespara tener acceso a los recursos y acciones de AWS desde el entorno. Esta también es una prácticarecomendada de seguridad de AWS.

A continuación, se explica cómo credenciales temporales administradas de AWS trabaja cuando unentorno de EC2 intenta acceder a un servicio de AWS en nombre de una entidad de AWS (por ejemplo, unusuario de IAM):

1. AWS Cloud9 comprueba si la entidad de AWS que llama (por ejemplo, el usuario de IAM) tiene lospermisos para llevar a cabo la acción solicitada para el recurso solicitado en AWS. Si el permiso noexiste o se deniega explícitamente, la solicitud produce un error.

2. AWS Cloud9 comprueba credenciales temporales administradas de AWS para ver si sus permisospermiten la acción solicitada para el recurso solicitado en AWS. Si el permiso no existe o se deniegaexplícitamente, la solicitud produce un error. Para obtener una lista de los permisos compatiblescon credenciales temporales administradas de AWS, consulte Acciones admitidas en credencialestemporales administradas de AWS (p. 538).

3. Si ambas entidades de AWS y credenciales temporales administradas de AWS permiten la acciónsolicitada para el recurso solicitado, la solicitud se realiza correctamente.

4. Si la entidad de AWS o credenciales temporales administradas de AWS deniegan explícitamente (o nolo aprueban de forma explícita) la acción solicitada para el recurso solicitado, la solicitud dará error. Estosignifica que, aunque la entidad de AWS que llama tenga los permisos adecuados, se producirá un erroren la solicitud si AWS Cloud9 no lo permite también explícitamente. Del mismo modo, si AWS Cloud9permite que un recurso específico realice una acción específica, se producirá un error en la solicitud si laentidad de AWS no lo permite también explícitamente.

El propietario de un entorno de EC2 puede activar o desactivar las credenciales temporales administradasde AWS para ese entorno en cualquier momento como se indica a continuación:

1. Con el entorno abierto en el AWS Cloud9 IDE, en la barra de menús, elija AWS Cloud9, Preferences(AWS Cloud9, Preferencias).

2. En la pestaña Preferences (Preferencias), en el panel de navegación, elija AWS Settings, Credentials(Configuración de AWS, Credenciales).

537


3. Utilice las AWS managed temporary credentials (credenciales temporales administradas por AWS) paraactivar o desactivar las credenciales temporales administradas de AWS.

Si desactiva las credenciales temporales administradas de AWS, de forma predeterminada el entornono puede obtener acceso a los servicios de AWS, independientemente de la entidad de AWS que hagala solicitud. Si no puede o no desea activar las credenciales temporales administradas de AWS para unentorno, pero sigue necesitando que el entorno tenga acceso a los servicios de AWS, tenga en cuenta lassiguientes alternativas:

• Adjunte un perfil de instancia a la instancia Amazon EC2 que se conecta al entorno. Para verinstrucciones, consulte la sección sobre la creación y uso de un perfil de instancia para administrarcredenciales temporales (p. 78).

• Almacene las credenciales de acceso de AWS permanentes en el entorno, por ejemplo, configurandovariables de entorno especiales o ejecutando el comando aws configure. Para obtener instrucciones,consulte Crear y almacenar las credenciales de acceso permanente en un entorno (p. 82).

La alternativas anteriores anulan todos los permisos permitidos (o denegados) por credenciales temporalesadministradas de AWS en un entorno de EC2.

Acciones admitidas en credenciales temporales administradas deAWSPara un entorno de desarrollo de EC2 de AWS Cloud9, las credenciales temporales administradas de AWSpermiten todas las acciones de AWS a todos los recursos de AWS en la cuenta de AWS del intermediario,con las siguientes restricciones:

• Para AWS Cloud9, solo se permiten las siguientes acciones:• cloud9:CreateEnvironmentEC2

• cloud9:CreateEnvironmentSSH

• cloud9:DescribeEnvironmentMemberships

• cloud9:DescribeEnvironments

• cloud9:DescribeEnvironmentStatus

• cloud9:UpdateEnvironment

• Para IAM, solo se permiten las siguientes acciones:• iam:AttachRolePolicy

• iam:ChangePassword

• iam:CreatePolicy

• iam:CreatePolicyVersion

• iam:CreateRole

• iam:CreateServiceLinkedRole

• iam:DeletePolicy

• iam:DeletePolicyVersion

• iam:DeleteRole

• iam:DeleteRolePolicy

• iam:DeleteSSHPublicKey

• iam:DetachRolePolicy

• iam:GetInstanceProfile

• iam:GetPolicy

• iam:GetPolicyVersion 538


• iam:GetRole

• iam:GetRolePolicy

• iam:GetSSHPublicKey

• iam:GetUser

• iam:List*

• iam:PassRole

• iam:PutRolePolicy

• iam:SetDefaultPolicyVersion

• iam:UpdateAssumeRolePolicy

• iam:UpdateRoleDescription

• iam:UpdateSSHPublicKey

• iam:UploadSSHPublicKey

• Todas las acciones de IAM que interactúan con roles solo se permiten para nombres de rol quecomienzan por Cloud9-. Sin embargo, iam:PassRole funciona con todos los nombres de rol.

• Para AWS Security Token Service (AWS STS), solo se permiten las siguientes acciones:• sts:GetCallerIdentity

• sts:DecodeAuthorizationMessage

• Todas las acciones de AWS admitidas se limitan a la dirección IP del entorno. Esta es una prácticarecomendada de seguridad de AWS.

Si AWS Cloud9 no admite una acción o recurso a la que necesita que un entorno de EC2 tenga acceso osi credenciales temporales administradas de AWS están desactivadas para un entorno de EC2 y no puedevolver a activarlas, tenga en cuenta las siguientes alternativas:

• Adjunte un perfil de instancia a la instancia Amazon EC2 que se conecta al entorno de EC2. Paraobtener instrucciones, consulte Creación y uso de un perfil de instancia para administrar credencialestemporales (p. 78).

• Almacene las credenciales de acceso de AWS permanentes en el entorno de EC2, por ejemplo,configurando variables de entorno especiales o ejecutando el comando aws configure. Para obtenerinstrucciones, consulte Crear y almacenar las credenciales de acceso permanente en un entorno (p. 82).

La alternativas anteriores anulan todos los permisos permitidos (o denegados) por credenciales temporalesadministradas de AWS en un entorno de EC2.

Creación y actualización de credenciales temporalesadministradas de AWSPara un entorno de desarrollo de EC2 de AWS Cloud9, se crean credenciales temporales administradas deAWS la primera vez que abra el entorno.

Las credenciales temporales administradas de AWS se actualizan en cualquiera de las siguientescondiciones:

• Siempre que pase un determinado periodo de tiempo. En la actualidad, cada 5 minutos.• Cada vez que se vuelva a cargar la pestaña del navegador web que muestra el IDE del entorno.• Cuando se alcanza la marca temporal que se muestra en el archivo ~/.aws/credentials para el

entorno.• Si la configuración de las AWS managed temporary credentials (credenciales temporales administradas

por AWS) está desactivada, cuando vuelve a activarla. Para ver o cambiar esta configuración, elijaAWS Cloud9, Preferences (AWS Cloud9, Preferencias) en la barra de menús del IDE. En la pestaña

539

AWS Cloud9 Guía del usuarioUso de funciones vinculadas a servicios

Preferences (Preferencias), en el panel de navegación, elija AWS Settings, Credentials (Configuraciónde AWS, Credenciales).

Uso de roles vinculados a servicios para AWSCloud9

AWS Cloud9 usa AWS Identity and Access Management (IAM) roles vinculados a servicios. Un rolvinculado a un servicio es un tipo único de rol de IAM que está vinculado directamente a AWS Cloud9.Los roles vinculados a servicios están predefinidos por AWS Cloud9 e incluyen todos los permisos que elservicio requiere para llamar a otros servicios de AWS en su nombre.

Con una función vinculada a servicios, resulta más sencillo configurar AWS Cloud9, porque no es precisoagregar los permisos necesarios manualmente. AWS Cloud9 define los permisos de las funcionesvinculadas con su propio servicio y solo AWS Cloud9 puede asumir sus funciones. Los permisos definidosincluyen las políticas de confianza y de permisos, y que la política de permisos no se pueda asociar aninguna otra entidad de IAM.

Las funciones se pueden eliminar únicamente después de eliminar primero sus recursos relacionados.De esta forma, se protegen los recursos de AWS Cloud9, ya que se evita que se puedan eliminaraccidentalmente permisos de acceso a los recursos.

Para obtener información sobre otros servicios que admiten roles vinculados a servicios, consulte Serviciosde AWS que funcionan con IAM y busque los servicios que tienen Sí en la columna Rol vinculado aservicio. Seleccione una opción Sí con un enlace para ver la documentación acerca del rol vinculado alservicio en cuestión.

• Permisos de roles vinculados a servicios para AWS Cloud9 (p. 540)• Creación de un rol vinculado a un servicio para AWS Cloud9 (p. 542)• Modificación de un rol vinculado a un servicio para AWS Cloud9 (p. 542)• Eliminación de un rol vinculado a un servicio para AWS Cloud9 (p. 542)• Regiones admitidas para los roles vinculados al servicio de AWS Cloud9 (p. 543)

Permisos de roles vinculados a servicios para AWSCloud9AWS Cloud9 usa el rol vinculado al servicio denominado AWSServiceRoleForAWSCloud9. Este rolvinculado al servicio confía en el servicio cloud9.amazonaws.com para asumir el rol.

La política de permisos del rol permite que AWS Cloud9 realice las siguientes acciones en los recursosespecificados.

{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "cloudformation:CreateStack", "cloudformation:DescribeStacks", "ec2:CreateSecurityGroup", "ec2:DescribeInstances", "ec2:DescribeSecurityGroups", "ec2:DescribeVpcs", "ec2:RunInstances"

540

https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_terms-and-concepts.html

https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html

https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html

AWS Cloud9 Guía del usuarioPermisos de roles vinculados a servicios para AWS Cloud9

], "Resource": "*" }, { "Effect": "Allow", "Action": [ "ec2:AuthorizeSecurityGroupIngress", "ec2:DeleteSecurityGroup", "ec2:TerminateInstances" ], "Resource": "*" }, { "Effect": "Allow", "Action": [ "cloudformation:DeleteStack" ], "Resource": "arn:aws:cloudformation:*:*:stack/aws-cloud9-*" }, { "Effect": "Allow", "Action": [ "ec2:CreateTags" ], "Resource": "arn:aws:ec2:*:*:instance/*", "Condition": { "StringLike": { "aws:RequestTag/Name": "aws-cloud9-*" } } }, { "Effect": "Allow", "Action": [ "ec2:StartInstances" ], "Resource": "*", "Condition": { "StringLike": { "ec2:ResourceTag/aws:cloudformation:stack-name": "aws-cloud9-*" } } } ]}

Debe configurar permisos para permitir que AWS Cloud9 cree un rol vinculado a un servicio en nombre deuna entidad de IAM (como un usuario, grupo o función).

Para permitir que AWS Cloud9 cree el rol vinculado al servicio AWSServiceRoleForAWSCloud9, añada lasiguiente instrucción a la política de permisos de la entidad de IAM en cuyo nombre AWS Cloud9 necesitacrear el rol vinculado al servicio.

{ "Effect": "Allow", "Action": [ "iam:CreateServiceLinkedRole" ], "Resource": "*", "Condition": { "StringLike": { "iam:AWSServiceName": "cloud9.amazonaws.com" } }

541

AWS Cloud9 Guía del usuarioCreación de una función vinculada

a servicios para AWS Cloud9

}

También puede añadir las políticas administradas por AWS AWSCloud9User oAWSCloud9Administrator a la entidad de IAM.

Para permitir que una entidad de IAM elimine el rol vinculado al servicio AWSServiceRoleForAWSCloud9,añada la siguiente instrucción a la política de permisos de la entidad de IAM que necesita eliminar el rolvinculado al servicio.

{ "Effect": "Allow", "Action": [ "iam:DeleteServiceLinkedRole", "iam:GetServiceLinkedRoleDeletionStatus" ], "Resource": "*", "Condition": { "StringLike": { "iam:AWSServiceName": "cloud9.amazonaws.com" } }}

Creación de una función vinculada a servicios paraAWS Cloud9No necesita crear manualmente un rol vinculado a un servicio. Al crear un entorno de desarrollo de AWSCloud9, AWS Cloud9 se encarga de crear automáticamente el rol vinculado al servicio.

Edición de un rol vinculado a servicio para AWSCloud9AWS Cloud9 no le permite modificar el rol vinculado al servicio AWSServiceRoleForAWSCloud9. Porejemplo, después de crear un rol vinculado a un servicio, no puede cambiarle el nombre, ya que variasentidades pueden hacer referencia a él. Sin embargo, puede editar la descripción de la función utilizandoIAM. Para obtener más información, consulte Editar un rol vinculado a un servicio en la Guía del usuario deIAM.

Eliminación de una función vinculada a un serviciopara AWS Cloud9Si ya no necesita utilizar una característica o servicio que requiere un rol vinculado a un servicio, lerecomendamos que elimine dicho rol. De esta forma no tiene una entidad no utilizada que no se monitoriceni mantenga de forma activa.

Eliminación de un rol vinculado a un servicio en IAMPara poder utilizar IAM para eliminar un rol vinculado a un servicio, debe eliminar los recursos de AWSCloud9 que utiliza el rol. Para eliminar recursos de AWS Cloud9, consulte la sección sobre eliminación deentornos (p. 103).

Puede utilizar la consola de IAM para eliminar el rol vinculado a servicio AWSServiceRoleForAWSCloud9.Para obtener más información, consulte Eliminar un rol vinculado a un servicio en la Guía del usuario deIAM.

542

https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#edit-service-linked-role

https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#delete-service-linked-role

AWS Cloud9 Guía del usuarioRegiones admitidas para los roles

vinculados al servicio de AWS Cloud9

Regiones admitidas para los roles vinculados alservicio de AWS Cloud9AWS Cloud9 admite el uso de roles vinculados a servicios en todas las regiones en las que el servicio estádisponible. Para obtener más información, consulte AWS Cloud9 en la Referencia general de Amazon WebServices.

Registro de llamadas a la API de AWS Cloud9 conAWS CloudTrail

AWS Cloud9 se integra con CloudTrail, un servicio que proporciona un registro de las acciones realizadaspor un usuario, rol o un servicio de AWS en AWS Cloud9. CloudTrail captura todas las llamadas a laAPI de AWS Cloud9 como eventos. Las llamadas capturadas incluyen las llamadas realizadas desdela consola de AWS Cloud9 y las llamadas de código a las API de AWS Cloud9. Si crea un registro deseguimiento, puede habilitar la entrega continua de eventos de CloudTrail a un bucket de Amazon SimpleStorage Service (Amazon S3), incluidos los eventos de AWS Cloud9. Si no configura un registro deseguimiento, puede ver los eventos más recientes en la consola de CloudTrail en el Event history (Historialde eventos). Con la información recopilada por CloudTrail, se puede determinar la solicitud que se envió aAWS Cloud9, la dirección IP desde la que se realizó la solicitud, quién la realizó, cuándo la realizó y otrosdetalles.

Para obtener más información acerca de CloudTrail, consulte la AWS CloudTrail User Guide.

Información de AWS Cloud9 en CloudTrailCloudTrail se habilita en una cuenta de AWS al crearla. Cuando se produce una actividad en AWS Cloud9,dicha actividad se registra en un evento de CloudTrail junto con los eventos de otros servicios de AWS delEvent history (Historial de eventos). Puede ver, buscar y descargar los últimos eventos de la cuenta deAWS. Para obtener más información, consulte Ver eventos con el historial de eventos de CloudTrail.

Para mantener un registro continuo de los eventos de la cuenta de AWS, incluidos los eventos deAWS Cloud9, cree un registro de seguimiento. Un registro de seguimiento permite a CloudTrail enviararchivos de registro a un bucket de Amazon S3. De forma predeterminada, cuando se crea un registrode seguimiento en la consola, este se aplica a todas las regiones de AWS. El registro de seguimientoregistra los eventos de todas las regiones de la partición de AWS y envía los archivos de registro al bucketde Amazon S3 especificado. También puede configurar otros servicios de AWS para analizar y actuar enfunción de los datos de eventos recopilados en los registros de CloudTrail. Para obtener más información,consulte los siguientes temas:

• Introducción a la creación de registros de seguimiento• Consulte Servicios e integraciones compatibles con CloudTrail.• Configuración de notificaciones de Amazon SNS para CloudTrail• Para obtener más información, consulte Recibir archivos de registro de CloudTrail de varias regiones y

Recepción de archivos de registro de CloudTrail de varias cuentas.

AWS Cloud9 permite registrar las siguientes acciones como eventos en los archivos de registro deCloudTrail:

• CreateEnvironmentEC2

• CreateEnvironmentSSH

• CreateEnvironmentMembership

543


https://docs.aws.amazon.com/awscloudtrail/latest/userguide/

https://docs.aws.amazon.com/awscloudtrail/latest/userguide/view-cloudtrail-events.html

https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-create-and-update-a-trail.html

https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-aws-service-specific-topics.html

https://docs.aws.amazon.com/awscloudtrail/latest/userguide/getting_notifications_top_level.html

https://docs.aws.amazon.com/awscloudtrail/latest/userguide/receive-cloudtrail-log-files-from-multiple-regions.html

https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-receive-logs-from-multiple-accounts.html

AWS Cloud9 Guía del usuarioDescripción de las entradas de

archivos de registro de AWS Cloud9

• DeleteEnvironment

• DeleteEnvironmentMembership

• DescribeEnvironmentMemberships

• DescribeEnvironments

• ListEnvironments

• UpdateEnvironment

• UpdateEnvironmentMembership

Cada entrada de registro o evento contiene información acerca de quién generó la solicitud. La informaciónde identidad del usuario le ayuda a determinar lo siguiente:

• Si la solicitud se realizó con credenciales de usuario raíz o de AWS Identity and Access Management(IAM).

• Si la solicitud se realizó con credenciales de seguridad temporales de un rol o fue un usuario federado.• Si la solicitud la realizó otro servicio de AWS.

Para obtener más información, consulte Elemento userIdentity de CloudTrail.

Descripción de las entradas de archivos de registro deAWS Cloud9Un registro de seguimiento es una configuración que permite la entrega de eventos como archivos deregistro al bucket de Amazon S3 que se especifique. Los archivos de registro de CloudTrail contienenuna o varias entradas de registro. Un evento representa una única solicitud de cualquier origen e incluyeinformación sobre la acción solicitada, la fecha y la hora de la acción, los parámetros de la solicitud,etcétera. Los archivos de registro de CloudTrail no están un rastro de la pila ordenada de las llamadas a laAPI públicas, por lo que no aparecen en ningún orden específico.

• CreateEnvironmentEC2 (p. 544)• CreateEnvironmentSSH (p. 545)• CreateEnvironmentMembership (p. 546)• DeleteEnvironment (p. 547)• DeleteEnvironmentMembership (p. 547)• DescribeEnvironmentMemberships (p. 548)• DescribeEnvironments (p. 549)• ListEnvironments (p. 549)• UpdateEnvironment (p. 550)• UpdateEnvironmentMembership (p. 551)

CreateEnvironmentEC2En el ejemplo siguiente, se muestra una entrada de registro de CloudTrail que ilustra la acciónCreateEnvironmentEC2.

{ "Records": [ { "eventVersion": "1.05", "userIdentity": { "type": "IAMUser",

544

https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-user-identity.html



"principalId": "AIDACKCEVSQ6C2EXAMPLE", "arn": "arn:aws:iam::111122223333:user/MyUser", "accountId": "111122223333", "accessKeyId": "AKIAIOSFODNN7EXAMPLE", "userName": "MyUser", "sessionContext": { "attributes": { "mfaAuthenticated": "false", "creationDate": "2019-01-14T11:29:47Z" } }, "invokedBy": "signin.amazonaws.com" }, "eventTime": "2019-01-14T11:33:27Z", "eventSource": "cloud9.amazonaws.com", "eventName": "CreateEnvironmentEC2", "awsRegion": "us-west-2", "sourceIPAddress": "192.0.2.0", "userAgent": "signin.amazonaws.com", "requestParameters": { "instanceType": "t2.small", "subnetId": "subnet-1d4a9eEX", "description": "HIDDEN_DUE_TO_SECURITY_REASONS", "dryRun": true, "automaticStopTimeMinutes": 30, "name": "my-test-environment", "clientRequestToken": "cloud9-console-f8e37272-e541-435d-a567-5c684EXAMPLE" }, "responseElements": null, "requestID": "f0e629fb-fd37-49bd-b2cc-e9822EXAMPLE", "eventID": "8a906445-1b2a-47e9-8d7c-5b242EXAMPLE", "eventType": "AwsApiCall", "recipientAccountId": "111122223333" } ]}

CreateEnvironmentSSHEn el ejemplo siguiente, se muestra una entrada de registro de CloudTrail que ilustra la acciónCreateEnvironmentSSH.

{ "Records": [ { "eventVersion": "1.05", "userIdentity": { "type": "IAMUser", "principalId": "AIDACKCEVSQ6C2EXAMPLE", "arn": "arn:aws:iam::111122223333:user/MyUser", "accountId": "111122223333", "accessKeyId": "AKIAIOSFODNN7EXAMPLE", "userName": "MyUser", "sessionContext": { "attributes": { "mfaAuthenticated": "false", "creationDate": "2019-01-14T11:29:47Z" } }, "invokedBy": "signin.amazonaws.com" }, "eventTime": "2019-01-14T11:33:27Z", "eventSource": "cloud9.amazonaws.com", "eventName": "CreateEnvironmentSSH",

545



"awsRegion": "us-west-2", "sourceIPAddress": "192.0.2.0", "userAgent": "signin.amazonaws.com", "requestParameters": { "host": "198.51.100.0", "port": 22, "name": "my-ssh-environment", "description": "HIDDEN_DUE_TO_SECURITY_REASONS", "clientRequestToken": "cloud9-console-b015a0e9-469e-43e3-be90-6f432EXAMPLE", "loginName": "ec2-user" }, "responseElements": { "environmentId": "5c39cc4a85d74a8bbb6e23ed6EXAMPLE" }, "requestID": "f0e629fb-fd37-49bd-b2cc-e9822EXAMPLE", "eventID": "8a906445-1b2a-47e9-8d7c-5b242EXAMPLE", "eventType": "AwsApiCall", "recipientAccountId": "111122223333" } ]}

CreateEnvironmentMembershipEn el ejemplo siguiente, se muestra una entrada de registro de CloudTrail que ilustra la acciónCreateEnvironmentMembership.

{ "Records": [ { "eventVersion": "1.05", "userIdentity": { "type": "IAMUser", "principalId": "AIDACKCEVSQ6C2EXAMPLE", "arn": "arn:aws:iam::111122223333:user/MyUser", "accountId": "111122223333", "accessKeyId": "AKIAIOSFODNN7EXAMPLE", "userName": "MyUser", "sessionContext": { "attributes": { "mfaAuthenticated": "false", "creationDate": "2019-01-14T11:29:47Z" } }, "invokedBy": "signin.amazonaws.com" }, "eventTime": "2019-01-14T11:33:27Z", "eventSource": "cloud9.amazonaws.com", "eventName": "CreateEnvironmentMembership", "awsRegion": "us-west-2", "sourceIPAddress": "192.0.2.0", "userAgent": "signin.amazonaws.com", "requestParameters": { "environmentId": "2f5ff70a640f49398f67e3bdeEXAMPLE", "userArn": "arn:aws:iam::111122223333:user/MyUser", "permissions": "read-write" }, "responseElements": { "membership": { "environmentId": "2f5ff70a640f49398f67e3bdeEXAMPLE", "permissions": "read-write", "userId": "AIDACKCEVSQ6C2EXAMPLE", "userArn": "arn:aws:iam::111122223333:user/MyUser" }

546



}, "requestID": "f0e629fb-fd37-49bd-b2cc-e9822EXAMPLE", "eventID": "8a906445-1b2a-47e9-8d7c-5b242EXAMPLE", "eventType": "AwsApiCall", "recipientAccountId": "111122223333" } ]}

DeleteEnvironmentEn el ejemplo siguiente, se muestra una entrada de registro de CloudTrail que ilustra la acciónDeleteEnvironment.

{ "Records": [ { "eventVersion": "1.05", "userIdentity": { "type": "IAMUser", "principalId": "AIDACKCEVSQ6C2EXAMPLE", "arn": "arn:aws:iam::111122223333:user/MyUser", "accountId": "111122223333", "accessKeyId": "AKIAIOSFODNN7EXAMPLE", "userName": "MyUser", "sessionContext": { "attributes": { "mfaAuthenticated": "false", "creationDate": "2019-01-14T11:29:47Z" } }, "invokedBy": "signin.amazonaws.com" }, "eventTime": "2019-01-14T11:33:27Z", "eventSource": "cloud9.amazonaws.com", "eventName": "DeleteEnvironment", "awsRegion": "us-west-2", "sourceIPAddress": "192.0.2.0", "userAgent": "signin.amazonaws.com", "requestParameters": { "environmentId": "2f5ff70a640f49398f67e3bdeEXAMPLE" }, "responseElements": null, "requestID": "f0e629fb-fd37-49bd-b2cc-e9822EXAMPLE", "eventID": "8a906445-1b2a-47e9-8d7c-5b242EXAMPLE", "eventType": "AwsApiCall", "recipientAccountId": "111122223333" } ]}

DeleteEnvironmentMembershipEn el ejemplo siguiente, se muestra una entrada de registro de CloudTrail que ilustra la acciónDeleteEnvironmentMembership.

{ "Records": [ { "eventVersion": "1.05", "userIdentity": { "type": "IAMUser",

547



"principalId": "AIDACKCEVSQ6C2EXAMPLE", "arn": "arn:aws:iam::111122223333:user/MyUser", "accountId": "111122223333", "accessKeyId": "AKIAIOSFODNN7EXAMPLE", "userName": "MyUser", "sessionContext": { "attributes": { "mfaAuthenticated": "false", "creationDate": "2019-01-14T11:29:47Z" } }, "invokedBy": "signin.amazonaws.com" }, "eventTime": "2019-01-14T11:33:27Z", "eventSource": "cloud9.amazonaws.com", "eventName": "DeleteEnvironmentMembership", "awsRegion": "us-west-2", "sourceIPAddress": "192.0.2.0", "userAgent": "signin.amazonaws.com", "requestParameters": { "environmentId": "2f5ff70a640f49398f67e3bdeEXAMPLE", "userArn": "arn:aws:iam::111122223333:user/MyUser", }, "responseElements": null, "requestID": "f0e629fb-fd37-49bd-b2cc-e9822EXAMPLE", "eventID": "8a906445-1b2a-47e9-8d7c-5b242EXAMPLE", "eventType": "AwsApiCall", "recipientAccountId": "111122223333" } ]}

DescribeEnvironmentMembershipsEn el ejemplo siguiente, se muestra una entrada de registro de CloudTrail que ilustra la acciónDescribeEnvironmentMemberships.

{ "Records": [ { "eventVersion": "1.05", "userIdentity": { "type": "IAMUser", "principalId": "AIDACKCEVSQ6C2EXAMPLE", "arn": "arn:aws:iam::111122223333:user/MyUser", "accountId": "111122223333", "accessKeyId": "AKIAIOSFODNN7EXAMPLE", "userName": "MyUser", "sessionContext": { "attributes": { "mfaAuthenticated": "false", "creationDate": "2019-01-14T11:29:47Z" } }, "invokedBy": "signin.amazonaws.com" }, "eventTime": "2019-01-14T11:33:27Z", "eventSource": "cloud9.amazonaws.com", "eventName": "DescribeEnvironmentMemberships", "awsRegion": "us-west-2", "sourceIPAddress": "192.0.2.0", "userAgent": "signin.amazonaws.com", "requestParameters": { "nextToken": "NEXT_TOKEN_EXAMPLE",

548



"permissions": [ "owner" ], "maxResults": 15 }, "responseElements": null, "requestID": "f0e629fb-fd37-49bd-b2cc-e9822EXAMPLE", "eventID": "8a906445-1b2a-47e9-8d7c-5b242EXAMPLE", "readOnly": true, "eventType": "AwsApiCall", "recipientAccountId": "111122223333" } ]}

DescribeEnvironmentsEn el ejemplo siguiente, se muestra una entrada de registro de CloudTrail que ilustra la acciónDescribeEnvironments.

{ "Records": [ { "eventVersion": "1.05", "userIdentity": { "type": "IAMUser", "principalId": "AIDACKCEVSQ6C2EXAMPLE", "arn": "arn:aws:iam::111122223333:user/MyUser", "accountId": "111122223333", "accessKeyId": "AKIAIOSFODNN7EXAMPLE", "userName": "MyUser", "sessionContext": { "attributes": { "mfaAuthenticated": "false", "creationDate": "2019-01-14T11:29:47Z" } }, "invokedBy": "signin.amazonaws.com" }, "eventTime": "2019-01-14T11:33:27Z", "eventSource": "cloud9.amazonaws.com", "eventName": "DescribeEnvironments", "awsRegion": "us-west-2", "sourceIPAddress": "192.0.2.0", "userAgent": "signin.amazonaws.com", "requestParameters": { "environmentIds": [ "2f5ff70a640f49398f67e3bdeb811ab2" ] }, "responseElements": null, "requestID": "f0e629fb-fd37-49bd-b2cc-e9822EXAMPLE", "eventID": "8a906445-1b2a-47e9-8d7c-5b242EXAMPLE", "readOnly": true, "eventType": "AwsApiCall", "recipientAccountId": "111122223333" } ] }

ListEnvironmentsEn el ejemplo siguiente, se muestra una entrada de registro de CloudTrail que ilustra la acciónListEnvironments.

549



{ "Records": [ { "eventVersion": "1.05", "userIdentity": { "type": "IAMUser", "principalId": "AIDACKCEVSQ6C2EXAMPLE", "arn": "arn:aws:iam::111122223333:user/MyUser", "accountId": "111122223333", "accessKeyId": "AKIAIOSFODNN7EXAMPLE", "userName": "MyUser", "sessionContext": { "attributes": { "mfaAuthenticated": "false", "creationDate": "2019-01-14T11:29:47Z" } }, "invokedBy": "signin.amazonaws.com" }, "eventTime": "2019-01-14T11:33:27Z", "eventSource": "cloud9.amazonaws.com", "eventName": "ListEnvironments", "awsRegion": "us-west-2", "sourceIPAddress": "192.0.2.0", "userAgent": "signin.amazonaws.com", "requestParameters": { "nextToken": "NEXT_TOKEN_EXAMPLE", "maxResults": 15 }, "responseElements": null, "requestID": "f0e629fb-fd37-49bd-b2cc-e9822EXAMPLE", "eventID": "8a906445-1b2a-47e9-8d7c-5b242EXAMPLE", "readOnly": true, "eventType": "AwsApiCall", "recipientAccountId": "111122223333" } ] }

UpdateEnvironmentEn el ejemplo siguiente, se muestra una entrada de registro de CloudTrail que ilustra la acciónUpdateEnvironment.

{ "Records": [ { "eventVersion": "1.05", "userIdentity": { "type": "IAMUser", "principalId": "AIDACKCEVSQ6C2EXAMPLE", "arn": "arn:aws:iam::111122223333:user/MyUser", "accountId": "111122223333", "accessKeyId": "AKIAIOSFODNN7EXAMPLE", "userName": "MyUser", "sessionContext": { "attributes": { "mfaAuthenticated": "false", "creationDate": "2019-01-14T11:29:47Z" } }, "invokedBy": "signin.amazonaws.com" },

550



"eventTime": "2019-01-14T11:33:27Z", "eventSource": "cloud9.amazonaws.com", "eventName": "UpdateEnvironment", "awsRegion": "us-west-2", "sourceIPAddress": "192.0.2.0", "userAgent": "signin.amazonaws.com", "requestParameters": { "environmentId": "2f5ff70a640f49398f67e3bdeEXAMPLE", "description": "HIDDEN_DUE_TO_SECURITY_REASONS", "name": "my-test-environment-renamed" }, "responseElements": null, "requestID": "f0e629fb-fd37-49bd-b2cc-e9822EXAMPLE", "eventID": "8a906445-1b2a-47e9-8d7c-5b242EXAMPLE", "eventType": "AwsApiCall", "recipientAccountId": "111122223333" } ]}

UpdateEnvironmentMembershipEn el ejemplo siguiente, se muestra una entrada de registro de CloudTrail que ilustra la acciónUpdateEnvironmentMembership.

{ "Records": [ { "eventVersion": "1.05", "userIdentity": { "type": "IAMUser", "principalId": "AIDACKCEVSQ6C2EXAMPLE", "arn": "arn:aws:iam::111122223333:user/MyUser", "accountId": "111122223333", "accessKeyId": "AKIAIOSFODNN7EXAMPLE", "userName": "MyUser", "sessionContext": { "attributes": { "mfaAuthenticated": "false", "creationDate": "2019-01-14T11:29:47Z" } }, "invokedBy": "signin.amazonaws.com" }, "eventTime": "2019-01-14T11:33:27Z", "eventSource": "cloud9.amazonaws.com", "eventName": "UpdateEnvironmentMembership", "awsRegion": "us-west-2", "sourceIPAddress": "192.0.2.0", "userAgent": "signin.amazonaws.com", "requestParameters": { "environmentId": "2f5ff70a640f49398f67e3bdeEXAMPLE", "userArn": "arn:aws:iam::111122223333:user/MyUser", "permissions": "read-only" }, "responseElements": { "membership": { "environmentId": "2f5ff70a640f49398f67e3bdeEXAMPLE", "permissions": "read-only", "userId": "AIDACKCEVSQ6C2EXAMPLE", "userArn": "arn:aws:iam::111122223333:user/MyUser" } }, "requestID": "f0e629fb-fd37-49bd-b2cc-e9822EXAMPLE",

551

AWS Cloud9 Guía del usuarioEtiquetas

"eventID": "8a906445-1b2a-47e9-8d7c-5b242EXAMPLE", "eventType": "AwsApiCall", "recipientAccountId": "111122223333" } ]}

EtiquetasUna etiqueta es un nombre o atributo que usted o AWS adjuntan a un recurso de AWS. Cada etiquetaconsta de una clave y un valor emparejado. Puede utilizar etiquetas para controlar el acceso a los recursosde AWS Cloud9 según se describe en Controlar el acceso mediante etiquetas de recursos de AWSen la Guía del usuario de IAM. Las etiquetas también pueden ayudarle a administrar la información defacturación, como se describe en Etiquetas de asignación de costos definidas por el usuario.

Cuando crea un entorno de desarrollo de EC2 de AWS Cloud9 (p. 62), AWS Cloud9 incluye ciertasetiquetas del sistema que necesita para administrar el entorno. Las etiquetas del sistema comienzan por"aws:". Durante ese proceso de creación, también puede añadir sus propias etiquetas de recursos.

Una vez creado el entorno puede ver las etiquetas que están asociadas al entorno, añadir nuevasetiquetas de recursos al entorno o modificar o quitar las etiquetas que ha añadido anteriormente. Puedeasociar hasta 50 etiquetas definidas por el usuario a un entorno de AWS Cloud9.

Vea o actualice etiquetas mediante uno o varios de los métodos siguientes.

• En la consola de AWS Cloud9, seleccione el entorno que le interese y, a continuación, elija View Details(Ver detalles).

• Utilice los siguientes comandos de la CLI de AWS Cloud9: list-tags-for-resource, tag-resource y untag-resource.

• Utilice las siguientes acciones de la API de AWS Cloud9: ListTagsForResource, TagResource yUntagResource.

Warning

Las etiquetas que se crean o actualizan para AWS Cloud9 mediante los métodos anterioresNO se propagan automáticamente a los recursos subyacentes. Para información sobre cómohacerlo, consulte la siguiente sección, Propagación de actualizaciones de etiquetas a los recursossubyacentes (p. 552).

Propagación de actualizaciones de etiquetas a losrecursos subyacentesCuando se utilizan comandos de la CLI o acciones de la API de AWS Cloud9 para añadir, modificaro eliminar las etiquetas que asociadas a un entorno de AWS Cloud9, esos cambios no se propaganautomáticamente a los recursos subyacentes como la pila de AWS CloudFormation, la instancia AmazonEC2 y los grupos de seguridad de Amazon EC2. Debe propagar manualmente esos cambios.

Para facilitar el uso de los siguientes procedimientos, puede obtener el ID del entorno que le interesa. Sidesea hacer esto, hágalo de la siguiente manera:

552



https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/custom-tags.html


https://docs.aws.amazon.com/cli/latest/reference/cloud9/list-tags-for-resource.html

https://docs.aws.amazon.com/cli/latest/reference/cloud9/tag-resource.html

https://docs.aws.amazon.com/cli/latest/reference/cloud9/tag-resource.html

https://docs.aws.amazon.com/cli/latest/reference/cloud9/untag-resource.html

https://docs.aws.amazon.com/cloud9/latest/APIReference/API_ListTagsForResource.html

https://docs.aws.amazon.com/cloud9/latest/APIReference/API_TagResource.html

https://docs.aws.amazon.com/cloud9/latest/APIReference/API_UntagResource.html

AWS Cloud9 Guía del usuarioPropagación de actualizaciones de

etiquetas a los recursos subyacentes

1. En la consola de AWS Cloud9, seleccione el entorno que le interese y, a continuación, elija ViewDetails (Ver detalles).

2. Busque la propiedad Environment ARN (ARN de entorno) y registre el ID de entorno, que es la partedel ARN de entorno después de "environment:".

Deberá propagar las actualizaciones de etiqueta a uno o más de los siguientes lugares, dependiendo depara qué vaya a usar las etiquetas.

Propagación de actualizaciones de etiqueta a través de la pila deAWS CloudFormation

Note

Cuando actualiza las etiquetas a través de la pila de AWS CloudFormation, esas actualizacionesse propagan automáticamente a la instancia Amazon EC2 y a los grupos de seguridad de AmazonEC2 que están asociados con la pila.

1. Navegue a la consola de AWS CloudFormation.2. Busque y elija la pila que corresponda al entorno de AWS Cloud9 que le interesa. Si ha registrado el

ID de entorno, puede usarlo para filtrar el entorno.3. En la pestaña Stack info (Información de pila), en la sección Tags (Etiquetas), revisa la lista de

etiquetas.4. Si necesita actualizar las etiquetas, elija Update (Actualizar) cerca de la parte superior de la página y

siga las instrucciones. Para obtener más información, consulte Actualización de las pilas directamenteen la Guía del usuario de AWS CloudFormation.

También puede actualizar las etiquetas usando los comandos de la CLI describe-stacks y update-stack.

Propagación de actualizaciones de etiqueta a la instanciaAmazon EC21. Desplácese hasta la consola de instancias Amazon EC2.2. Busque y seleccione la instancia Amazon EC2 que corresponda al entorno AWS Cloud9 que le

interesa. Si ha registrado el ID de entorno con anterioridad, puede usarlo para filtrar el entorno.3. En la pestaña Tags (Etiquetas) vea y actualice las etiquetas según sea necesario.

También puede actualizar las etiquetas con los comandos de la CLI describe-tags, create-tags y delete-tags.

Propagación de actualizaciones de etiqueta a grupos deseguridad de Amazon EC21. Vaya a la consola Grupos de seguridad de Amazon EC2.2. Busque y seleccione el grupo de seguridad que corresponda al entorno de AWS Cloud9 que le

interesa. Si ha registrado el ID de entorno con anterioridad, puede usarlo para filtrar el entorno.3. Abre la pestaña Tags (Etiquetas) para ver y actualizar las etiquetas según sea necesario.

También puede actualizar las etiquetas con los comandos de la CLI describe-tags, create-tags y delete-tags.

553


https://console.aws.amazon.com/cloudformation

https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-direct.html

https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/

https://docs.aws.amazon.com/cli/latest/reference/cloudformation/describe-stacks.html

https://docs.aws.amazon.com/cli/latest/reference/cloudformation/update-stack.html

https://docs.aws.amazon.com/cli/latest/reference/cloudformation/update-stack.html

https://console.aws.amazon.com/ec2/home#Instances

https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-tags.html

https://docs.aws.amazon.com/cli/latest/reference/ec2/create-tags.html

https://docs.aws.amazon.com/cli/latest/reference/ec2/delete-tags.html


https://console.aws.amazon.com/ec2/home#SecurityGroups

https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-tags.html

https://docs.aws.amazon.com/cli/latest/reference/ec2/create-tags.html



AWS Cloud9 Guía del usuarioError de creación de entorno: "No hemos

podido crear las instancias EC2..."

Solución de problemas de AWSCloud9

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

Si el problema no aparece en la lista o si necesita ayuda adicional, consulte el foro de debate de AWSCloud9. (Cuando entre en este foro, es posible que AWS requiera que inicie sesión). También puedeponerse en contacto con nosotros directamente.

Temas• Error de creación de entorno: "No hemos podido crear las instancias EC2..." (p. 554)• Error al crear el entorno: no dispone de autorización para sts: AssumeRole (p. 555)• Error de consola: el usuario no está autorizado para realizar la acción en el recurso (p. 555)• Las identidades federadas no pueden crear entornos (p. 556)• No se puede abrir un entorno (p. 556)• El instalador de AWS Cloud9 se bloquea o falla (p. 558)• Error de entorno de SSH: se precisa la versión 2.7 de Python para instalar pty.js (p. 558)• Aviso de vista previa de aplicaciones o vista previa de archivos: «Cookies de terceros

desactivadas» (p. 558)• La pestaña de vista previa de la aplicación muestra un mensaje de error o está en blanco (p. 560)• No se puede mostrar la aplicación en ejecución fuera del IDE (p. 561)• Después de volver a cargar un entorno, es necesario actualizar la vista previa de la

aplicación (p. 563)• No se puede previsualizar la aplicación en el AWS Cloud9 IDE con HTTP (p. 563)• No se pueden ejecutar algunos comandos o scripts en un entorno de EC2 (p. 563)• Error de la AWS CLI/aws-shell: "The security token included in the request is invalid" (El token de

seguridad incluido en la solicitud no es válido) en un entorno de EC2 (p. 564)• Las instancias de Amazon EC2 no se actualizan automáticamente (p. 564)• Error de ejecución de la función local Lambda: no se puede instalar SAM Local (p. 565)• Advertencia del IDE: "Este entorno se está quedando sin memoria" o "Este entorno tiene una elevada

carga de CPU" (p. 566)• La vista previa de un archivo devuelve un error 499 (p. 567)• Error de eliminación del entorno: "One or more entornos failed to delete" (No se han podido eliminar

uno o más entornos) (p. 567)• Advertencia de la consola: "Cambio al motor de finalización de código mínimo..." (p. 568)

Error de creación de entorno: "No hemos podidocrear las instancias EC2..."

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

554




AWS Cloud9 Guía del usuarioError al crear el entorno: no dispone

de autorización para sts: AssumeRole

Causa: AWS está verificando y activando actualmente su cuenta de AWS. Hasta que no se complete laactivación, que puede tardar hasta 24 horas, no puede crear este u otros entornos.

Solución: intente crear el entorno más adelante. Si después de 24 horas sigue recibiendo este mensaje,envíe un correo electrónico a [email protected]. Tenga en cuenta que AWS CloudFormationcrea una pila relacionada en su cuenta, aunque se produzca un error en el intento de crear un entorno.Estas pilas cuentan en el límite de creación de pilas de su cuenta. Para evitar el límite de creación de pilas,puede eliminar de forma segura estas pilas con error. Para obtener más información, consulte Eliminaciónde una pila en la consola de AWS CloudFormation en la Guía del usuario de AWS CloudFormation.

(Volver arriba (p. 554))

Error al crear el entorno: no dispone de autorizaciónpara sts: AssumeRole

Problema: Al tratar de crear un nuevo entorno, verá un error que indica que no dispone de autorizaciónpara sts: AssumeRole y no se creará el entorno.

Causas posibles: no existe un rol vinculado al servicio de AWS Cloud9 en su cuenta de AWS.

Soluciones recomendadas: cree un rol vinculado al servicio de AWS Cloud9 en su cuenta de AWSejecutando el siguiente comando con la AWS Command Line Interface (AWS CLI) o el aws-shell.

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 su cuenta de AWS.

Después de ejecutar este comando, intente crear el entorno de nuevo.


Error de consola: el usuario no está autorizado pararealizar la acción en el recurso

Problema: cuando intenta utilizar la consola de AWS Cloud9 para crear o administrar un entornode desarrollo de AWS Cloud9, aparece un error que contiene una frase parecida a esta "Userarn:aws:iam::123456789012:user/MyUser is not authorized to perform cloud9:action on resourcearn:aws:cloud9:us-east-2:123456789012:environment:12a34567b8cd9012345ef67abcd890e1" (El usuarioarn:aws:iam::123456789012:user/MyUser no está autorizado a realizar cloud9:action en el recursoarn:aws:cloud9:us-east-2:123456789012:environment:12a34567b8cd9012345ef67abcd890e1), donde:

• arn:aws:iam::123456789012:user/MyUser es el Nombre del recurso de Amazon (ARN) delusuario 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 delentorno que el usuario solicitó para ejecutar la operación.

555

mailto:[email protected]

https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cfn-console-delete-stack.html

https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cfn-console-delete-stack.html

AWS Cloud9 Guía del usuarioLas identidades federadas no pueden crear entornos

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

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

• Paso 3: Añadir permisos de acceso para AWS Cloud9 al grupo (p. 13) en Configuración de equipo• Paso 6. Habilitar usuarios y grupos dentro de la organización para utilizar AWS Cloud9 (p. 21) en

Configuración de empresa• Acerca de los roles de acceso de miembro del entorno (p. 89) en Trabajo con entornos compartidos


Las identidades federadas no pueden crearentornos

Problema: al tratar de utilizar una identidad federada de AWS para crear un entorno de desarrollo de AWSCloud9 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 primeravez 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 AWS Security Token Service API Reference.

Solución: pida al administrador de cuentas de AWS que cree el rol vinculado al servicio para AWS Cloud9bien en la consola de IAM o ejecutando este comando con la 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.


No se puede abrir un entornoProblema: Al tratar de abrir un entorno, no se muestra el IDE durante mucho tiempo (transcurridos almenos cinco minutos).

Causas posibles:

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

• Si el entorno está asociado con una instancia de informática en la nube de AWS (por ejemplo, unainstancia Amazon EC2):• La VPC asociada a la instancia no se establecerá en la configuración correcta para AWS Cloud9.

556

https://docs.aws.amazon.com/STS/latest/APIReference/API_API_GetFederationToken.html

https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html

AWS Cloud9 Guía del usuarioNo se puede abrir un entorno

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

• Si el entorno es un entorno de SSH, la instancia de informática en la nube asociada o su propio servidorno tiene la configuración adecuada para permitir que AWS Cloud9 obtenga acceso a ella.

Soluciones recomendadas:

• Asegúrese de que el usuario de IAM que ha iniciado sesión en la consola de AWS Cloud9 tiene lospermisos de acceso de AWS necesarios para abrir el entorno y, a continuación, intente abrir el entornode nuevo. Para obtener más información, consulte los siguientes temas o consulte con el administradorde su cuenta de AWS:• Paso 3: Añadir permisos de acceso para AWS Cloud9 al grupo (p. 13) en Configuración de equipo• Políticas administradas (predefinidas) por AWS para AWS Cloud9 (p. 525) en Autenticación y control

de acceso• Ejemplos de políticas administradas por el cliente para equipos que utilizan AWS Cloud9 (p. 26) en

Configuración de equipo avanzada• Ejemplos de políticas administradas por los clientes (p. 528) en Autenticación y control de acceso• Cambio de los permisos de un usuario de IAM en la Guía del usuario de IAM• Solución de problemas de políticas de IAM en la Guía del usuario de IAM

Si el usuario de IAM que ha iniciado sesión sigue sin poder abrir el entorno, podría intentar cerrar sesióny, a continuación, iniciar sesión de nuevo como el usuario raíz de la cuenta de AWS o bien como usuarioadministrador de IAM en la cuenta. A continuación, intente abrir el entorno de nuevo. Si sí puede abrirel entorno de este modo, lo más probable es que haya un problema con los permisos de acceso delusuario de IAM.

• Si el entorno está asociado con una instancia de informática en la nube de AWS (por ejemplo, unainstancia Amazon EC2):• Asegúrese de que la VPC asociada a la instancia tiene la configuración correcta para AWS Cloud9 e

intente abrir el entorno de nuevo. Para obtener más información, consulte Requisitos de Amazon VPCpara AWS Cloud9 (p. 501).

Si la VPC asociada de la instancia de informática en la nube de AWS tiene la configuración correctapara AWS Cloud9 y sigue sin poder abrir el entorno, el grupo de seguridad de la instancia podríaestar impidiendo el acceso a AWS Cloud9. (Solo como técnica de solución de problemas) Compruebeel grupo de seguridad para asegurarse de que, como mínimo, se permite el tráfico SSH entrante através del puerto 22 para todas las direcciones IP (Anywhere o 0.0.0.0/0). Para ver instrucciones,consulte Descripción de los grupos de seguridad y Actualización de las reglas del grupo de seguridaden la Guía del usuario de Amazon EC2 para instancias de Linux.

Si desea consultar pasos adicionales de resolución de problemas de VPC, vea el vídeo relacionado de5 minutos Vídeos de AWS Knowledge Center: ¿Qué puedo comprobar si no puedo conectarme a unainstancia en una VPC? en el sitio web de YouTube.

Warning

Cuando haya terminado la solución de problemas, asegúrese de establecer las reglas deentrada en un rango de direcciones adecuado, tal y como se describe en the section called“Rangos de direcciones IP de entrada con SSH” (p. 518).

• Reinicie la instancia, asegúrese de que está en ejecución y ha superado todas las comprobacionesdel sistema e intente abrir de nuevo el entorno. Para obtener más información, consulte Reinicio deinstancias y Visualización de comprobaciones de estado en la Guía del usuario de Amazon EC2 parainstancias de Linux.

• Si el entorno es un entorno de SSH, asegúrese de que la instancia de informática en la nube asociada osu propio servidor tenga la configuración adecuada para permitir que AWS Cloud9 obtenga acceso a ella

557

https://docs.aws.amazon.com/IAM/latest/UserGuide/id_users_change-permissions.html

https://docs.aws.amazon.com/IAM/latest/UserGuide/troubleshoot_policies.html

https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-network-security.html#describing-security-group

https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-network-security.html#updating-security-group-rules

https://www.youtube.com/watch?v=--BoDeCF5Dw

https://www.youtube.com/watch?v=--BoDeCF5Dw

https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-reboot.html

https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-reboot.html

https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/monitoring-system-instance-status-check.html#viewing_status

AWS Cloud9 Guía del usuarioEl instalador de AWS Cloud9 se bloquea o falla

y, a continuación, intente abrir el entorno de nuevo. Para obtener más información, consulte Requisitosde host de entorno de desarrollo de SSH de AWS Cloud9 (p. 514).


El instalador de AWS Cloud9 se bloquea o fallaProblema: cuando descarga y ejecuta el instalador de AWS Cloud9 (p. 517), se muestran uno o másmensajes de error y el script de instalación no muestra Done.

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

Solución: consulte los problemas más comunes, las posibles causas y las soluciones recomendadas enSolución de problemas del instalador de AWS Cloud9 (p. 517).


Error de entorno de SSH: se precisa la versión 2.7de Python para instalar pty.js

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

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

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

• Paso 1: Instalar Python 3.6 (p. 449) en la Muestra de Python.• Sección sobre descarga de Python en el sitio web de Python y sección sobre instalación de paquetes en

la guía del usuario de empaquetado de Python.


Aviso de vista previa de aplicaciones o vista previade archivos: «Cookies de terceros desactivadas»

Problema: Cuando intenta obtener una vista previa de una aplicación (p. 147) o un archivo (p. 145),aparece un aviso con el siguiente mensaje: «La funcionalidad de vista previa está deshabilitada porque sunavegador tiene cookies de terceros deshabilitadas».

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

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.

558

https://www.python.org/downloads/

https://packaging.python.org/installing/

AWS Cloud9 Guía del usuarioAviso de vista previa de aplicaciones o vista previade archivos: «Cookies de terceros desactivadas»

• Apple Safari: Administrar cookies y datos de sitios web en Safari en el sitio web de soporte de Apple.• Google Chrome: Cambiar las configuraciones de las cookies en Borrar, habilitar y administrar cookies en

Chrome en el sitio web de ayuda de Google Chrome.• Internet Explorer: Bloquear o permitir cookies en Eliminar y administrar cookies en el sitio web de soporte

técnico de Microsoft.• Microsoft Edge: bloqueo de cookies de terceros en el sitio web de soporte técnico de Microsoft.• Mozilla Firefox: configuración Aceptar cookies de páginas web en Habilitar y deshabilitar cookies que los

sitios web utilizan para rastrear tus preferencias en el sitio web de soporte de Mozilla.• Cualquier otro navegador web: consulte la documentación de ese navegador web.

Para habilitar las cookies de terceros solo para AWS Cloud9 (si el navegador web permite este grado dedetalle), especifique los siguientes dominios en función de la compatibilidad con las regiones de AWS enlas que desee utilizar AWS Cloud9.

Región de AWS Dominios

US East (N. Virginia) *.vfs.cloud9.us-east-1.amazonaws.com

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

EE.UU. Este (Ohio) *.vfs.cloud9.us-east-2.amazonaws.com

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

EE.UU. Oeste (Oregón) *.vfs.cloud9.us-west-2.amazonaws.com

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

Asia Pacífico (Mumbai) *.vfs.cloud9.ap-south-1.amazonaws.com

vfs.cloud9.ap-south-1.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á (Central) *.vfs.cloud9.ca-central-1.amazonaws.com

559

https://support.apple.com/guide/safari/manage-cookies-and-website-data-sfri11471/mac

https://support.google.com/chrome/answer/95647

https://support.google.com/chrome/answer/95647

https://support.microsoft.com/en-us/help/17442

https://support.microsoft.com/en-us/help/4464209/issue-with-blocking-third-party-cookies

https://support.mozilla.org/kb/enable-and-disable-cookies-website-preferences

https://support.mozilla.org/kb/enable-and-disable-cookies-website-preferences

AWS Cloud9 Guía del usuarioLa pestaña de vista previa de la aplicación

muestra un mensaje de error o está en blanco

Región de AWS Dominiosvfs.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 (Estocolmo) *.vfs.cloud9.eu-north-1.amazonaws.com

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


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

Problema: en la barra de menús de la IDE, cuando elige Preview, Preview Running Application (Vistaprevia, 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ónen una pestaña de vista previa del 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.• Su 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. El

comportamiento predeterminado del AWS Cloud9 IDE es que intentará ir a su equipo local, en lugar deintentar ir a la instancia o a su propio servidor que está conectado al entorno.


• 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 (p. 147).• 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 (p. 147).

560

AWS Cloud9 Guía del usuarioNo se puede mostrar la aplicación

en ejecución fuera del IDE

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

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

• 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 su 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 dirección: https://12a34567b8cd9012345ef67abcd890e1.vfs.cloud9.us-east-2.amazonaws.com/, donde 12a34567b8cd9012345ef67abcd890e1 es el ID que AWSCloud9 asigna al entorno y us-east-2 es el ID de la región de AWS para el entorno. También puedeintentar ir a esta dirección fuera del IDE, pero solo funciona cuando el IDE para el entorno está abierto yla 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, acontinuació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 bienintente elegir el botón Refresh (Actualizar) (flecha circular) en la correspondiente pestaña de vista previade la aplicación, si la pestaña ya está visible.


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

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

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 está ejecutando en un entorno de desarrollo de EC2 de AWS Cloud9 y uno o varios

grupos de seguridad que están asociados a la correspondiente instancia Amazon EC2 no permiten eltráfico de entrada a través de los protocolos, los puertos o las direcciones IP que necesita la aplicación.

• La aplicación se está ejecutando en un entorno de desarrollo de SSH de AWS Cloud9 de una instanciade informática en la nube de AWS (por ejemplo, una instancia Amazon EC2) y la ACL de red de lasubred en la nube virtual privada (VPC) que está asociada a la correspondiente instancia no permite eltrá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 intentarán obtener acceso a los recursos de su 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.

561

AWS Cloud9 Guía del usuarioNo se puede mostrar la aplicación

en ejecución fuera del IDE

• La aplicación se está ejecutando en un entorno de SSH y su servidor o la red asociada no permiten eltráfico a través de los protocolos, los puertos o las direcciones IP que la aplicación necesita.


• 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 (p. 147).• Si la aplicación se está ejecutando en una instancia de informática en la nube de AWS (por ejemplo,

una instancia Amazon EC2), asegúrese de que todos los grupos de seguridad que están asociadosa la correspondiente instancia permiten el tráfico de entrada a través de los protocolos, los puertos ylas direcciones IP que necesita la aplicación. Para obtener instrucciones, consulte Paso 2: configurarel grupo de seguridad para la instancia (p. 151) en Compartir una aplicación en ejecución a través deInternet. Consulte también Grupos de seguridad de su VPC en la Guía del usuario de Amazon VPC.

• Si la aplicación se está ejecutando en una instancia de informática en la nube de AWS y hay una ACLde red para la subred en la VPC que está asociada a la correspondiente instancia, asegúrese de queesta ACL de red permite el tráfico de entrada a través de los protocolos, los puertos y las direccionesIP que necesita la aplicación. Para obtener instrucciones, consulte Paso 3: configurar la subred para lainstancia (p. 152) en Compartir una aplicación en ejecución a través de Internet. Consulte también ACLde 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) escorrecta. Para obtener más información, consulte Paso 5: compartir la URL de la aplicación enejecución (p. 154) en Compartir una aplicación en ejecución a través de Internet.

• No se recomienda solicitar una URL con el formatohttps://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 para el entorno). Esta URL solo funciona cuando el IDE delentorno está abierto y la aplicación se está ejecutando en el mismo navegador web.

• Si está intentando ir a una dirección que contiene una IP de 127.0.0.1 o localhost, intente ir ala dirección no local correcta para la aplicación en ejecución. Para obtener más información, consulteCompartir una aplicación en ejecución a través de Internet (p. 150).

• Si la aplicación se está ejecutando en una instancia de informática en la nube de AWS, determine si hacambiado la dirección IP pública de la instancia. La dirección IP pública de la instancia podría cambiar encualquier momento que la instancia se reinicie. Para evitar que cambie esta dirección IP, puede asignaruna dirección IP elástica y asignarla a la instancia en ejecución. Para obtener más información, consultePaso 5: compartir la URL de la aplicación en ejecución (p. 154) en Compartir una aplicación en ejecucióna 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 losprotocolos, los puertos y las direcciones IP que la aplicación necesita. Si no puede realizar cambios ensu VPN, consulte con el administrador de red. Otra opción es realizar la solicitud web desde otra red, sies posible.

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

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


562




AWS Cloud9 Guía del usuarioDespués de volver a cargar un entorno, es

necesario actualizar la vista previa de la aplicación

Después de volver a cargar un entorno, esnecesario 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 laaplicación, la pestaña no se muestra en la vista previa de la aplicación.

Causa: A veces, los usuarios escriben código que puede ejecutar un bucle infinito o que utiliza tantamemoria que hace que el AWS Cloud9 IDE se ponga en pausa o se detenga cuando la vista previa de laaplicación se está ejecutando. Para evitar que esto ocurra, AWS Cloud9 no vuelve a cargar las pestañasde 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 lapágina) en la pestaña.


No se puede previsualizar la aplicación en el AWSCloud9 IDE con HTTP

Problema: en el cuadro de direcciones de una pestaña de vista previa de la aplicación en el AWSCloud9 IDE, la URL siempre comienza por https. Si intenta cambiar https en el cuadro por http y, acontinuación, pulsa Enter, la pestaña no muestra la vista previa de la aplicación.

Causa: Para ayudar a mejorar la seguridad del código, en el cuadro de direcciones de la pestaña de vistaprevia de la aplicación en el IDE, AWS Cloud9 siempre utiliza https. Este comportamiento no se puedecambiar.

Solución: para obtener una vista previa de una aplicación cuya dirección comienza por http en lugar dehttps, cambie https en el cuadro de direcciones de la pestaña por http y pulse Enter. A continuación,elija el botón Open your page in a new tab. Se mostrará una vista previa de la aplicación en unanueva pestaña del navegador web a través de HTTP.


No se pueden ejecutar algunos comandos o scriptsen un entorno de EC2

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

Causa: La instancia Amazon EC2 que utiliza AWS Cloud9 para un entorno de EC2 utiliza 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 lainstancia para ese entorno.

563

AWS Cloud9 Guía del usuarioError de la AWS CLI/aws-shell: "The security token

included in the request is invalid" (El token de seguridadincluido en la solicitud no es válido) en un entorno de EC2


Error de la AWS CLI/aws-shell: "The security tokenincluded in the request is invalid" (El token deseguridad incluido en la solicitud no es válido) en unentorno de EC2

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

Causas posibles:

• Si tiene credenciales temporales administradas de AWS habilitadas, está intentando ejecutar uncomando que no se permite con esas credenciales temporales administradas de AWS. Para ver unalista de comandos permitidos, consulte Acciones admitidas en credenciales temporales administradas deAWS (p. 538).

• Si tiene las credenciales temporales administradas de AWS habilitadas y el entorno es un entornocompartido, el propietario del entorno no ha abierto el entorno en las anteriores 12 horas, de modo queAWS Cloud9 pueda actualizar las credenciales temporales administradas de AWS en el entorno. (AWSCloud9 establece este límite de 12 horas como recomendación de seguridad de AWS).


• Si tiene credenciales temporales administradas de AWS habilitadas, ejecute únicamente comandospermitidos. Si tiene que ejecutar un comando que no permiten las credenciales temporalesadministradas de AWS, un enfoque sería configurar la AWS CLI o el aws-shell en el entorno con unconjunto de credenciales permanentes, lo que acabaría con esta limitación. Para obtener instrucciones,consulte Crear y almacenar las credenciales de acceso permanente en un entorno (p. 82).

• Haga que el propietario del entorno abra el entorno para que AWS Cloud9 pueda actualizar lascredenciales temporales en el entorno.

Para obtener más información, consulte credenciales temporales administradas de AWS (p. 537).


Las instancias de Amazon EC2 no se actualizanautomáticamente

Problema: Las últimas actualizaciones del sistema no se aplican automáticamente a una instancia AmazonEC2 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 lainstancia Amazon EC2 se comporten de forma imprevista, sin su conocimiento previo o sin su aprobación.


564

AWS Cloud9 Guía del usuarioError de ejecución de la función local

Lambda: no se puede instalar SAM Local

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

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

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


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

Problema: Después de intentar ejecutar la versión local de una función AWS Lambda en el AWS Cloud9IDE, se muestra un cuadro de diálogo que indica que AWS Cloud9 está teniendo problemas al instalarSAM Local. AWS Cloud9 necesita SAM Local para ejecutar las versiones locales de las funciones de AWSLambda en el IDE. Hasta que no se instale SAM Local, no se pueden ejecutar las versiones locales de lasfunciones de 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 dichaubicación.

Soluciones recomendadas: Puede esperar a que AWS Cloud9 intente finalizar la instalación de SAM Localo 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 usted mismo SAM Local, ejecute los siguientes comandos, de uno en uno, en el orden que seindica a continuación, desde una sesión de terminal en el IDE.

npm install -g aws-sam-local # Use Node Package Manager (npm) to install SAM Local as a global package in the environment.ln -sfn $(which sam) ~/.c9/bin/sam # Create a symbolic link (a shortcut) from the path that AWS Cloud9 expects to where SAM Local is installed.

Si, después de ejecutar los comandos anteriores, sigue teniendo problemas para instalar SAM Local,pruebe a ejecutar los siguientes comandos adicionales, uno a la vez en el orden que se indica acontinuación, desde una sesión de la terminal en la IDE.

npm uninstall -g aws-sam-local # Use npm to uninstall the globally-installed SAM Local from the environment.rm -rf $(which sam) # Remove the related symbolic link.pip install --user aws-sam-cli # Use pip to re-install the AWS SAM CLI from the context of the user (not globally).hash -r # Reset the bash cache (removes all current tracked aliases).sam –-version # Verify that your installation worked.

565

https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/install-updates.html

AWS Cloud9 Guía del usuarioAdvertencia del IDE: "Este entorno se está quedando sin

memoria" o "Este entorno tiene una elevada carga de CPU"

Para obtener más información, consulte el repositorio awslabs/aws-sam-cli en el sitio web de GitHub.


Advertencia del IDE: "Este entorno se estáquedando sin memoria" o "Este entorno tiene unaelevada carga de CPU"

Problema: mientras se está ejecutando el IDE, aparece un mensaje que contiene la frase "este entorno seestá 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 funcionandosin retrasos o bloqueos.


• Detenga uno o más procesos en ejecución para liberar la memoria disponible. Para ello, en la barra demenú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 queel sistema operativo puede utilizar como memoria virtual.

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

Para crear un archivo de intercambio, puede ejecutar 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 la información en /etc/fstab file, que permite 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é disponibleinmediatamente en lugar de esperar a un reinicio, ejecute el comando siguiente.

sudo swapon /var/swapfile

• Mueva o cambie el tamaño del entorno a una instancia o servidor con más recursos de informáticos.Para mover o cambiar el tamaño de instancias Amazon EC2, consulte Mover o cambiar el tamaño deun entorno en AWS Cloud9 (p. 99). Para otros tipos de instancia o servidor, consulte la documentacióncorrespondiente.


566

https://github.com/awslabs/aws-sam-cli/blob/develop/README.md

AWS Cloud9 Guía del usuarioLa vista previa de un archivo devuelve un error 499

La vista previa de un archivo devuelve un error 499Problema: cuando intenta utilizar AWS Cloud9 IDE para obtener una vista previa de un archivo quecontiene un elemento <script> que incluye el atributo src y con el atributo type configurado enmodule, se produce un error 499 y el script no se ejecuta correctamente.

Causa: las solicitudes de vista previa de archivos en AWS Cloud9 IDE requieren que el navegador webenvíe cookies para autenticarse. De forma predeterminada, los navegadores web envían las cookies paralas solicitudes de script habituales, pero no para las solicitudes de script del módulo, a menos que añada elatributo crossorigin.

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


Error de eliminación del entorno: "One or moreentornos failed to delete" (No se han podidoeliminar uno o más entornos)

Problema: cuando intenta eliminar uno o más entornos en la consola de AWS Cloud9, aparece el mensajeque indica que no se pudieron eliminar una o más entornos y al menos uno de los entornos no se haeliminado.

Causa posible: AWS CloudFormation puede tener un problema al eliminar uno o más entornos. (AWSCloud9 confía en AWS CloudFormation para crear y eliminar entornos.)

Solución recomendada: pruebe a usar AWS CloudFormation para eliminar cada uno de los entornos noeliminadas, tal y como se indica a continuación.

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 lapila que empieza con el nombre aws-cloud9-my-demo-environment. (Elija la casilla u opción junto alnombre del entorno, no el 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, entonces se elimina el entorno.

Si la pila se sigue mostrando con DELETE_FAILED (ERROR_ELIMINACIÓN) después de unos minutos, elentorno sigue sin eliminarse. En este caso, puede intentar eliminar manualmente cada uno de los recursosde la pila con error.

Note

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

567

https://console.aws.amazon.com/cloudformation/

AWS Cloud9 Guía del usuarioAdvertencia de la consola: "Cambio al

motor de finalización de código mínimo..."

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


Advertencia de la consola: "Cambio al motor definalizació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áginaweb 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 cadasesión adicional. Para evitar utilizar demasiados recursos, especialmente en tamaños de instanciaspequeñ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 períodos de tiempo, elija unainstancia Amazon EC2 más grande al crear su entorno de EC2 (o conecte su entorno de SSH a unainstancia con más capacidad).

Note

Elegir una instancia Amazon EC2 más grande podría generar cargos adicionales en su cuenta deAWS. Para obtener más información, consulte Precios de Amazon EC2.


568



Navegadores compatibles con AWSCloud9

En la tabla siguiente se muestran los navegadores compatibles con AWS Cloud9.

Navegador Versions

Google Chrome Tres últimas versiones

Mozilla Firefox Tres últimas versiones

Microsoft Edge Tres últimas versiones

Apple Safari para macOS Dos últimas versiones

569

AWS Cloud9 Guía del usuarioLímites de AWS Cloud9

Límites de AWS Cloud9En las siguientes tablas se muestran los límites en AWS Cloud9 y los servicios de AWS relacionados.

• Límites de AWS Cloud9 (p. 570)• Límites de los servicios de AWS relacionados (p. 571)

Límites de AWS Cloud9En la tabla siguiente se proporcionan los límites predeterminados de los servicios de AWS Cloud9 parauna cuenta de AWS. A menos que se indique otra cosa, cada límite es específico de la región.

Para solicitar un aumento de un límite que es ajustable, haga lo siguiente:

1. Inicie sesión en AWS y abra la página Create case (Crear caso) en el sitio web del Centro de AWSSupport.

2. Seleccione Service Limit increase (Aumento del límite del servicio).3. En Case classification (Clasificación del caso), elija cloud9 en la lista Limit type (Tipo de límite).4. Rellene el resto de los campos según corresponda. Si la solicitud es urgente, elija Phone (Teléfono)

como método de contacto en lugar de Web.5. Elija Submit.

Estos aumentos no se conceden de inmediato, de modo que podrían tardar unos días en hacerseefectivos.

Recurso Límite predeterminado Ajustable

Número máximo de entornosde desarrollo de EC2 de AWSCloud9

• 100 por usuario• 200 por cuenta

Sí

Número máximo de entornos deSSH

• 100 por usuario• 200 por cuenta

Sí

Número máximo de miembros enun entorno

El número máximopredeterminado de miembros esigual a la memoria de la instanciapara ese entorno dividido por 60MB, con resultados redondeadosa la baja. Por ejemplo, unainstancia con 1 GiB de memoriapuede tener un máximo de 17miembros (que es 1 GiB divididopor 60 MB, redondeado).

Si AWS Cloud9 no puededeterminar la memoriade una instancia, el valorpredeterminado es un máximo

No1

570

https://console.aws.amazon.com/support/cases#/create

https://console.aws.amazon.com/support/home

https://console.aws.amazon.com/support/home

AWS Cloud9 Guía del usuarioLímites de los servicios de AWS relacionados

Recurso Límite predeterminado Ajustablede 8 usuarios para cada entornoasociado a dicha instancia.

El número máximo absoluto demiembros para un entorno es 25.

Tamaño máximo de archivoeditable

8 MB No

1 Puede mover un entorno (p. 100) para intentar aumentar el número máximo predeterminado demiembros. Sin embargo, el número máximo absoluto de miembros para un entorno sigue siendo 25.

Límites de los servicios de AWS relacionadosNúmero máximo de volúmenes de Amazon ElasticBlock Store (Amazon EBS)

5000

Para obtener más información, consulte Límites deAmazon Elastic Block Store (Amazon EBS) en laReferencia general de Amazon Web Services.

Número máximo de pilas de AWS CloudFormation 200

Para obtener más información, consulte Límitesde AWS CloudFormation en la Guía del usuario deAWS CloudFormation.

Límites de Amazon EC2 Consulte Límites de Amazon Elastic ComputeCloud (Amazon EC2) en la Referencia general deAmazon Web Services.

571

https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html#limits_ebs

https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html#limits_ebs

https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cloudformation-limits.html

https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cloudformation-limits.html

https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html#limits_ec2

https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html#limits_ec2


Historial de revisiones de la Guía delusuario de AWS Cloud9

Este tema contiene una lista de cambios importantes en la Guía del usuario de AWS Cloud9. Para obtenernotificaciones sobre las actualizaciones de esta documentación, puede suscribirse a la fuente RSS.

Actualizaciones recientes

En la siguiente tabla se describen los cambios importantes en la Guía del usuario de AWS Cloud9 a partirde marzo de 2019.

update-history-change update-history-description update-history-date

Etiquetas (p. 552) Utilice etiquetas que le ayuden acontrolar el acceso a los recursosde AWS Cloud9 y a administrar lainformación de facturación.

January 22, 2020

Se ha añadido compatibilidadde una Región con AWSCloud9 (p. 572)

AWS Cloud9 está ahoradisponible en las siguientesRegiones: Asia Pacífico(Mumbai), Asia Pacífico (Seúl),Asia Pacífico (Sídney), Canadá(Central), Europa (Londres),Europa (Estocolmo)

December 18, 2019

Añadido: solución deproblemas, cookies de tercerosdesactivadas (p. 558)

Aunque las cookies de tercerosya no son necesarias para abrirel IDE, son necesarias parautilizar las características deVista previa de la aplicación oVista previa de archivos. Se haañadido información sobre estecomportamiento al tema Soluciónde problemas.

November 6, 2019

Actualizado: solución deproblemas, no se puede abrir unentorno (p. 556)

Las cookies de terceros ya noson necesarias para abrir el IDE.

November 6, 2019

Organización dedocumentos (p. 572)

Los cambios de la organizaciónse aplicaron a la guía del usuariopara facilitar la navegación,especialmente para los nuevosusuarios.

August 15, 2019

AWS Cloud9 también estádisponible en Región de Europa(Fráncfort) (p. 572)

AWS Cloud9 ahora tambiénestá disponible en Región deEuropa (Fráncfort). Para obtenermás información, consulte AWSCloud9 en la Referencia generalde Amazon Web Services.

May 15, 2019

Se ha añadido una muestra deLAMP (p. 572)

Se ha añadido una nuevamuestra que demuestra cómo

May 10, 2019

572

https://docs.aws.amazon.com/cloud9/latest/user-guide/aws-cloud9-user-guide-updates.rss

https://docs.aws.amazon.com/general/latest/gr/rande.html?id=docs_gateway#cloud9_region



usar AWS Cloud9 con LAMP(Linux, Apache HTTP Server,MySQL, y PHP). Para obtenermás información, consulte lamuestra de LAMP para AWSCloud9.

Se ha añadido un ejemplo deWordPress (p. 572)

Se ha añadido un nuevo ejemploque muestra cómo usar AWSCloud9 con WordPress. Paraobtener más información,consulte la muestra deWordPress para AWS Cloud9.

April 19, 2019

AWS Cloud9 también estádisponible en la Región AsiaPacífico (Tokio) (p. 572)

AWS Cloud9 ahora también estádisponible en la Región AsiaPacífico (Tokio). Para obtenermás información, consulte AWSCloud9 en la Referencia generalde Amazon Web Services.

April 4, 2019

Se ha añadido informaciónsobre compatibilidad conUbuntu Server en entornos deEC2 (p. 572)

Se han añadido instruccionespara la utilización de la consolade AWS Cloud9 para crearentornos de desarrollo de EC2 deAWS Cloud9 que se conecten aUbuntu Server. Para obtener másinformación, consulte Creaciónde un entorno de EC2.

Tenga en cuenta queactualmente no puede utilizarcódigo para crear entornosde desarrollo de EC2 de AWSCloud9 que se conecten aUbuntu Server, por ejemplo,mediante el uso de la AWS CLI,AWS CloudFormation, los SDKde AWS, las Herramientas paraWindows PowerShell o la APIde AWS Cloud9. Se esperaofrecer compatibilidad con estosmétodos en el futuro.

April 2, 2019

Actualizaciones anteriores

En la siguiente tabla se describen los cambios importantes en la Guía del usuario de AWS Cloud9 antes deabril de 2019.

Cambio Descripción Fecha de modificación

Se han añadido instrucciones deintroducción para estudiantes,educadores y empresas

Se han ampliado lasinstrucciones de introduccióna AWS Cloud9 para incluirpasos para estudiantes,educadores y empresas. Paraobtener más información,

7 de febrero de 2019

573

https://docs.aws.amazon.com/cloud9/latest/user-guide/sample-lamp.html

https://docs.aws.amazon.com/cloud9/latest/user-guide/sample-lamp.html

https://docs.aws.amazon.com/cloud9/latest/user-guide/sample-wordpress.html

https://docs.aws.amazon.com/cloud9/latest/user-guide/sample-wordpress.html



https://docs.aws.amazon.com/cloud9/latest/user-guide/create-environment.html#create-environment-main

https://docs.aws.amazon.com/cloud9/latest/user-guide/create-environment.html#create-environment-main


Cambio Descripción Fecha de modificaciónconsulte Configuración de AWSCloud9 (p. 6).

Se ha añadido compatibilidadcon AWS CloudTrail

AWS CloudTrail ya admiteAWS Cloud9. Para obtenermás información, consulteRegistro de llamadas a la APIde AWS Cloud9 con AWSCloudTrail (p. 543).

21 de enero de 2019

Se ha añadido compatibilidadcon VPC compartidas

AWS Cloud9 ahora admitelas VPC compartidas enAmazon VPC. Para obtener másinformación, consulte Requisitosde Amazon VPC para AWSCloud9 (p. 501).

7 de diciembre de 2018

Se ha añadido integración deAWS RoboMaker

AWS Cloud9 ahora escompatible con AWSRoboMaker, un servicio quefacilita las tareas de desarrollo,prueba e implementaciónde aplicaciones de robóticainteligentes a escala. Paraobtener más información,consulte Introducción a AWS yDesarrollo con AWS Cloud9 enla Guía para desarrolladores deAWS RoboMaker.

26 de noviembre de 2018

Se ha añadido información sobrecaracterísticas de productividadadicionales para proyectos delenguaje

El AWS Cloud9 IDE ahoraofrece características deproductividad adicionalespara algunos lenguajes en elcontexto de un proyecto delenguaje. Para obtener másinformación, consulte Trabajarcon proyectos de lenguajeen el AWS Cloud9 IntegratedDevelopment Environment(IDE) (p. 166).

2 de octubre de 2018

Se ha añadido la ventana Go (Ir);se han eliminado las ventanasNavigate (Navegar) y Commands(Comandos)

Se agregó la ventana Go (Ir)al AWS Cloud9 IDE para losentornos creados a partir del2 de octubre de 2018. Estanueva ventana reemplaza a lasventanas Navigate (Navegar) yCommands (Comandos), quese han quitado del IDE para losentornos creados a partir del 2 deoctubre de 2018. Para obtenermás información, consulte Paso10: Ventana Go (Ir) (p. 117) en elRecorrido del IDE (p. 108).

2 de octubre de 2018

574

https://docs.aws.amazon.com/robomaker/latest/dg/getting-started.html




Se ha añadido una muestra deAWS CDK

Se ha añadido una nuevamuestra que demuestra cómoutilizar AWS Cloud9 con el kit dedesarrollo en la nube de AWSCloud (AWS CDK). Para obtenermás información, consulte laEjemplo de AWS CDK para AWSCloud9 (p. 404).

30 de agosto de 2018

Se ha añadido información sobrerestricciones de direcciones IPSSH añadidas automáticamentea entornos de EC2

Para los entornos de desarrollode EC2 de AWS Cloud9 creadosa partir del 31 de julio de 2018,AWS Cloud9 ahora restringeautomáticamente el tráfico SSHentrante solo a los rangos dedirecciones IP que utiliza AWSCloud9 para conectarse a travésde SSH. Para obtener másinformación, consulte Rangos dedirecciones IP de entrada conSSH para AWS Cloud9 (p. 518).

31 de julio de 2018

Se ha añadido una muestra deDocker

Se añadió una nueva muestraque demuestra cómo usar AWSCloud9 con Docker. Para obtenermás información, consulte laEjemplo de Docker para AWSCloud9 (p. 490).

19 de junio de 2018

Se han añadido opciones deimplementación de funciones deLambda adicionales

Se añadió información sobreopciones adicionales paraimplementar funciones AWSLambda del AWS Cloud9 IDE,dependiendo de cómo se creóoriginalmente la función Lambda.Para obtener más información,consulte Cargar código para unafunción Lambda (p. 337).

29 de mayo de 2018

Se han añadido muestras deJava, .NET Core y TypeScript

Se añadieron nuevas muestrasque demuestran cómo usarAWS Cloud9 con Java, .NETCore, y TypeScript. Paraobtener más información,consulte la Muestra de Javapara AWS Cloud9 (p. 429),Muestra de .NET Core paraAWS Cloud9 (p. 452) y Muestrade TypeScript para AWSCloud9 (p. 483).

29 de mayo de 2018

575



Se ha añadido una lista denavegadores admitidos

Se ha añadido informaciónacerca de los navegadorescompatibles con AWS Cloud9.Para obtener más información,consulte Navegadorescompatibles con AWSCloud9 (p. 569).

23 de mayo de 2018

Se han añadido tutoriales defunciones de Lambda

Se han añadido nuevos tutorialesque muestran cómo crearfunciones Lambda con AWSCloud9. Para obtener másinformación, consulte Tutorialde AWS Lambda para AWSCloud9 (p. 350) y Tutorialavanzado de AWS Lambda paraAWS Cloud9 (p. 368).

19 de abril de 2018

Se ha añadido información sobrerestricciones de tráfico IP SSH

Se ha añadido informaciónacerca de cómo restringirel tráfico entrante a tan sololos rangos de direcciones IPque AWS Cloud9 utiliza paraconectarse a hosts a travésde SSH. Para obtener másinformación, consulte Rangos dedirecciones IP de entrada conSSH para AWS Cloud9 (p. 518).

19 de abril de 2018

Se ha añadido información deAWS Serverless ApplicationRepository

Se ha añadido informaciónacerca de cómo utilizar AWSServerless Application Repositorycon AWS Cloud9. Para obtenermás información, consulte Creare implementar funciones Lambdacon AWS Serverless ApplicationRepository (p. 317).

19 de abril de 2018

Se han añadido solucionadoresde problemas para obtener unavista previa de las aplicacionesy compartir las aplicaciones enejecución

Se han añadido nuevossolucionadores de problemaspara obtener una vista previade las aplicaciones y compartirlas aplicaciones en ejecución.Para obtener más información,consulte La pestaña de vistaprevia de la aplicación muestraun mensaje de error o estáen blanco (p. 560) y No sepuede mostrar la aplicación enejecución fuera del IDE (p. 561).

19 de abril de 2018

576



Se ha añadido información deFile Revision History (Historial derevisiones de archivos)

Se ha añadido informaciónsobre cómo utilizar el panelFile Revision History (Historialde revisiones de archivos)en el IDE. Para obtener másinformación, consulte Trabajocon revisiones de archivo enel AWS Cloud9 IntegratedDevelopment Environment(IDE) (p. 154).

19 de abril de 2018

Se ha añadido información sobredepuración de funciones deLambda que usan Python

Se ha añadido informaciónacerca de cómo depurarfunciones Lambda que utilizanPython. Para obtener másinformación, consulte Depurarla versión local de una funciónLambda o su API de APIGateway relacionada (p. 333).

22 de marzo de 2018

Se ha añadido un solucionadorde problemas para abrir entornos

Se ha añadido un nuevosolucionador de problemas paraabrir entornos de desarrollo deAWS Cloud9. Para obtener másinformación, consulte No sepuede abrir un entorno (p. 556).

19 de marzo de 2018

Se ha añadido un solucionadorde problemas para el instaladorde AWS Cloud9

Se ha añadido un nuevosolucionador de problemas parael instalador de AWS Cloud9.Para obtener más información,consulte El instalador deAWS Cloud9 se bloquea ofalla (p. 558).

19 de marzo de 2018

Se ha añadido información deAWS CodePipeline

Se ha añadido informaciónacerca de cómo utilizar AWSCloud9 con AWS CodePipeline.Para obtener más información,consulte Trabajar con AWSCodePipeline en el AWSCloud9 Integrated DevelopmentEnvironment (IDE) (p. 347).

13 de febrero de 2018

Se ha añadido información sobreaws-shell

Se ha añadido informaciónacerca de cómo utilizar AWSCloud9 con el aws-shell. Paraobtener más información,consulte la Muestra de AWSCommand Line Interfacey el aws-shell para AWSCloud9 (p. 379).

19 de enero de 2018

577



Se ha añadido disponibilidad dedocumentación en GitHub

Esta guía ya está disponible enGitHub. También puede utilizarGitHub para enviar comentariosy realizar solicitudes de cambiodel contenido de esta guía. Paraobtener más información, hagaclic en el icono Edit on GitHub(Editar en GitHub) en la barra denavegación de la guía o consulteel repositorio de awsdocs/aws-cloud9-user-guide en el sitio webde GitHub.

10 de enero de 2018

Disponibilidad del formato Kindle Esta guía ya está disponible enel formato de Amazon Kindle.Para obtener más información,haga clic en el icono OpenKindle (Abrir Kindle) en la barrade navegación de la guía oconsulte AWS Cloud9: UserGuide Kindle Edition en el sitioweb de Amazon.

2 de enero de 2018

Se ha añadido información deAmazon Lightsail

Se ha añadido informaciónacerca de cómo utilizar AWSCloud9 con Amazon Lightsail.Para obtener más información,consulte Trabajo con instanciasde Amazon Lightsail en el AWSCloud9 Integrated DevelopmentEnvironment (IDE) (p. 299).


Se han añadido descripcionesde configuración de entorno paraAWS

Se han añadido descripcionesde la configuración de AWSespecífica para entornos dedesarrollo de AWS Cloud9.Para obtener más información,consulte Trabajar con laconfiguración de usuarios yproyectos de AWS en el AWSCloud9 Integrated DevelopmentEnvironment (IDE) (p. 187).


Se han añadido instrucciones deintroducción para usuarios raízde la cuenta de AWS y pasosde configuración avanzada paraequipos

Se han añadido pasos parautilizar AWS Cloud9 con unusuario raíz de la cuentade AWS. Se han agregadolos pasos de configuraciónavanzados para utilizar AWSCloud9 con equipos. Paraobtener más información,consulte Configuración de AWSCloud9 (p. 6).


578

https://github.com/awsdocs/aws-cloud9-user-guide

https://github.com/awsdocs/aws-cloud9-user-guide

http://www.amazon.com/AWS-Cloud9-Amazon-Web-Services-ebook/dp/B078XBZMWS

http://www.amazon.com/AWS-Cloud9-Amazon-Web-Services-ebook/dp/B078XBZMWS



Se ha ampliado la cobertura derequisitos para un entorno

Se ha ampliado la coberturade los requisitos para que unainstancia de Amazon EC2 o supropio servidor se conecten a unentorno de desarrollo de SSH deAWS Cloud9. Para obtener másinformación, consulte Requisitosde host de entorno de desarrollode SSH de AWS Cloud9 (p. 514).


Publicación inicial de ladocumentación

Esta es la versión inicial dela Guía del usuario de AWSCloud9.

30 de noviembre de 2017

579

AWS Cloud9 - Guía del usuario · AWS Cloud9 Guía del usuario Amazon's trademarks and trade dress...

Documents

Transcript of AWS Cloud9 - Guía del usuario · AWS Cloud9 Guía del usuario Amazon's trademarks and trade dress...