AWS Toolkit for Eclipse

Transcripción

1 AWS Toolkit for Eclipse Guía del usuario AWS Toolkit for Eclipse: Guía del usuario Copyright 2017 Amazon Web Services, Inc. and/or its affiliates. All rights reserved.

2 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 discredits Amazon. All other trademarks not owned by Amazon are the property of their respective owners, who may or may not be affiliated with, connected to, or sponsored by Amazon.

3 Table of Contents Qué es AWS Toolkit for Eclipse?... 1 Documentación y recursos adicionales... 1 Introducción... 3 Configuración del Toolkit... 3 Requisitos previos... 3 Instalación de AWS Toolkit for Eclipse... 4 Actualización de AWS Toolkit for Eclipse... 4 Configuración de credenciales de AWS... 4 Obtener las claves de acceso de AWS... 5 Adición de sus claves de acceso de AWS a AWS Toolkit for Eclipse... 5 Uso de varias cuentas de AWS con AWS Toolkit for Eclipse... 6 Cambio de la ubicación del archivo de credenciales de AWS... 7 Asociación de claves privadas con pares de claves de Amazon EC Aspectos básicos de AWS Toolkit for Eclipse Creación de una aplicación de Java para AWS Cree y ejecute el ejemplo de Amazon Simple Queue Service Proyectos sin servidor Creación de un proyecto sin servidor Planes de proyectos sin servidor Estructura de proyectos sin servidor Implementación de un proyecto sin servidor Véase también Diferenciación de los recursos de AWS mediante la nomenclatura Trabajo con los servicios de AWS Cómo obtener acceso a AWS Explorer Uso de Lambda con AWS Toolkit for Eclipse Tutorial: cómo crear, cargar e invocar una función de AWS Lambda Referencia de la interfaz de AWS Lambda Editor de plantillas de AWS CloudFormation Añadir plantillas de AWS CloudFormation y obtener acceso a ellas en Eclipse Implementación de una plantilla de AWS CloudFormation en Eclipse Actualización de una plantilla de AWS CloudFormation en Eclipse Validación de una plantilla de AWS CloudFormation en Eclipse Uso de DynamoDB con AWS Explorer Creación de una tabla de DynamoDB Visualización de una tabla de DynamoDB como una cuadrícula Edición de atributos y valores Análisis de una tabla de DynamoDB Lanzamiento de una instancia Amazon EC2 desde una Amazon Machine Image Administración de grupos de seguridad desde AWS Explorer Creación de un nuevo grupo de seguridad Adición de permisos a los grupos de seguridad Visualización y adición de notificaciones de Amazon SNS Visualización de una notificación de Amazon SNS Adición de una notificación de Amazon SNS Conexión a Amazon Relational Database Service (Amazon RDS) Identity and Access Management Acerca de AWS Identity and Access Management Creación de un usuario de IAM Creación de un grupo de IAM Adición de un usuario de IAM a un grupo de IAM Administración de credenciales para un usuario de IAM Creación de un rol de IAM Adjuntar una política de IAM a un usuario, un grupo o un rol iii

4 Definición de la política de contraseñas... Solución de problemas... Complemento de AWS CodeCommit: Eclipse no ha podido escribir en el almacenamiento seguro.... Historial de revisión... iv

5 Documentación y recursos adicionales Qué es AWS Toolkit for Eclipse? AWS Toolkit for Eclipse es un complemento de código abierto para el entorno de desarrollo integrado (IDE) de Eclipse que hace más sencillo para los desarrolladores desarrollar, depurar e implementar las aplicaciones de Java que usan Amazon Web Services. Amplía el IDE de Eclipse con características adicionales: AWS SDK for Java se incluye y se instala como parte de AWS Toolkit for Eclipse AWS Explorer, una interfaz de Amazon Web Services que permite administrar los recursos de AWS desde el entorno de Eclipse. Implementación y depuración de AWS Elastic Beanstalk Un editor de plantillas de AWS CloudFormation Compatibilidad con varias cuentas de AWS Important No se aplica ningún cargo por utilizar AWS Toolkit for Eclipse, pero es posible que se apliquen cargos de AWS por crear o usar recursos facturables de AWS como, por ejemplo, ejecutar instancias Amazon EC2 o utilizar el almacenamiento de Amazon S3. Puede utilizar la Calculadora coste mensual AWS para hacer una estimación de los cargos por el uso de diversos recursos de AWS. Documentación y recursos adicionales Además de esta guía, existen otros recursos disponibles para los usuarios de AWS Toolkit for Eclipse: AWS Java Developer Guide AWS SDK for Java Reference Blog para desarrolladores de Java Foros para desarrolladores de Java GitHub: origen de documentación problemas de documentación origen del Toolkit problemas del Toolkit 1

6 Documentación y recursos (Twitter) Licencia del Toolkit Preguntas frecuentes del Toolkit Getting Started with the AWS SDK for Java Installing the AWS Toolkit for Eclipse (vídeo) Using AWS Elastic Beanstalk with the AWS Toolkit for Eclipse (vídeo) Amazon SimpleDB Management in AWS Toolkit for Eclipse (vídeo) AWS Toolkit for Eclipse: Amazon EC2 Management (vídeo) 2

7 Configuración del Toolkit Introducción Esta sección proporciona información de introducción sobre el AWS Toolkit for Eclipse, incluida información sobre cómo instalar y configurar el AWS Toolkit for Eclipse. Temas Configuración del Toolkit (p. 3) Configuración de credenciales de AWS (p. 4) Asociación de claves privadas con pares de claves de Amazon EC2 (p. 8) Configuración del Toolkit En esta sección se describe cómo instalar o actualizar AWS Toolkit for Eclipse. Requisitos previos AWS Toolkit for Eclipse tiene los siguientes requisitos previos: Una cuenta de Amazon Web Services: para obtener una cuenta de AWS, vaya a la página de inicio de AWS y haga clic en Sign Up Now. Al inscribirse, podrá usar todos los servicios ofrecidos por AWS. Un sistema operativo compatible: AWS Toolkit for Eclipse es compatible con Windows, Linux, macos, or Unix. Java 1.6 o posterior Eclipse IDE for Java Developers 3.6 o posterior: hacemos todo lo posible por mantener AWS Toolkit for Eclipse actualizado con la versión predeterminada disponible en la página de descarga de Eclipse. Note Eclipse ofrece diversas descargas. Es recomendable instalar Eclipse IDE for Java EE Developers, que incluye Eclipse Web Tools Platform, requerido por Elastic Beanstalk, y Eclipse Data Tools Platform, requerido para las características de Amazon SimpleDB. Si instala otra versión de Eclipse, asegúrese de que hay (o de que se instala, usando los enlaces proporcionados) compatibilidad con estas características. (Opcional) Google Android Development Tools (ADT): si desea que AWS Toolkit for Eclipse sea compatible con AWS Mobile SDK for Android, debe instalar primero ADT. 3

8 Instalación de AWS Toolkit for Eclipse Instalación de AWS Toolkit for Eclipse Para instalar AWS Toolkit for Eclipse 1. En Eclipse, haga clic en Help y, a continuación, haga clic en Install New Software. 2. En el cuadro Work with, escriba y, a continuación, pulse Enter. 3. Elija los componentes de AWS Toolkit for Eclipse que desea instalar. Haga clic en Select All para instalar todos los componentes a la vez. Note AWS Toolkit for Eclipse Core (en la sección AWS Core Management Tools) es obligatorio; todos los demás componentes son opcionales. La compatibilidad con AWS Mobile SDK for Android requiere que Google Android Developer Tools (ADT) for Eclipse se haya instalado primero. Si aún no ha instalado ADT, asegúrese de que la opción AWS SDK para Android está desactivada o la instalación fallará. La compatibilidad con los administradores de Amazon RDS o Amazon SimpleDB requiere que se haya instalado Eclipse Data Tools Platform (DTP). DTP se instala de forma predeterminada con la versión "Java EE Developers" de Eclipse o se puede instalar por separado. 4. Una vez que haya realizado las selecciones, haga clic en Next (o en Finish) para completar la instalación. Una vez que haya configurado AWS Toolkit for Eclipse, debe configurar sus credenciales de AWS (p. 4). Note En función de las opciones seleccionadas y de factores como la velocidad de la red, la latencia del servidor y las capacidades del sistema, la instalación puede tardar hasta 30 minutos en completarse. Actualización de AWS Toolkit for Eclipse Para actualizar o reinstalar AWS Toolkit for Eclipse, utilice las mismas instrucciones que para instalar el Toolkit (p. 4). Algunas versiones de Eclipse (especialmente Mars y Neon) pueden tener problemas para recuperar los artefactos más recientes debido a un error de las versiones anteriores del complemento Oomph. Para solucionar este problema: 1. Asegúrese de utilizar como sitio de actualización de AWS Toolkit for Eclipse. 2. Elimine el directorio ~/.eclipse/org.eclipse.oomph.p2/cache/ para eliminar el contenido almacenado en caché. 3. Instale la versión más reciente de Oomph (Eclipse Installer). Configuración de credenciales de AWS Para obtener acceso a Amazon Web Services con AWS Toolkit for Eclipse, debe configurar AWS Toolkit for Eclipse con las credenciales de la cuenta de AWS. 4

9 Obtener las claves de acceso de AWS Obtener las claves de acceso de AWS Las claves de acceso constan de un ID de clave de acceso y una clave de acceso secreta, que se utilizan para firmar las solicitudes de programación que se realizan a AWS. Si no tiene claves de acceso, puede crearlas utilizando la consola de administración de AWS. Es recomendable que utilice las claves de acceso de IAM en lugar de las claves de acceso de la cuenta raíz de AWS. IAM le permite controlar de forma segura el acceso a los servicios de AWS y a los recursos de su cuenta de AWS. Note Para crear claves de acceso, debe tener permisos para realizar las acciones de IAM requeridas. Para obtener más información, consulte Granting IAM User Permission to Manage Password Policy and Credentials en la IAM User Guide. Para obtener su ID de clave de acceso y la clave de acceso secreta 1. Abra la consola de IAM. 2. En el menú de navegación, haga clic en Users. 3. Seleccione su nombre de usuario de IAM. 4. Haga clic en User Actions y, a continuación, haga clic en Manage Access Keys. 5. Haga clic en Create Access Key. Sus claves tendrán un aspecto similar al siguiente: Ejemplo de ID de clave de acceso: AKIAIOSFODNN7EXAMPLE Ejemplo de clave de acceso secreta: wjalrxutnfemi/k7mdeng/bpxrficyexamplekey 6. Haga clic en Download Credentials y guarde las claves en un lugar seguro. Important Su clave secreta ya no estará disponible a través de la Consola de administración de AWS; usted tendrá la única copia. Manténgala en secreto para proteger su cuenta y no la envíe nunca por correo electrónico. No la comparta fuera de su organización, aunque reciba una petición que parezca provenir de AWS o Amazon.com. Nadie que represente legítimamente a Amazon le pedirá nunca su clave secreta. Temas relacionados Qué es IAM? en la IAM User Guide. Credenciales de seguridad de AWS en la Amazon Web Services General Reference. Adición de sus claves de acceso de AWS a AWS Toolkit for Eclipse Para localizar y utilizar las claves de acceso de AWS, AWS Toolkit for Eclipse utiliza el mismo sistema que la interfaz de línea de comandos (CLI) de AWS y AWS Java SDK. Las claves de acceso especificadas en el IDE de Eclipse se guardan en un archivo de credenciales de AWS compartido (llamado credentials) en el subdirectorio.aws contenido en el directorio principal. 5

10 Uso de varias cuentas de AWS con AWS Toolkit for Eclipse Note La ubicación del archivo de credenciales se puede modificar. Para obtener más información acerca de la configuración de la ubicación de este archivo, consulte Changing the AWS credentials file location (p. 7). Si ya ha establecido las credenciales de AWS a través de la interfaz de línea de comandos (CLI) de AWS, AWS Toolkit for Eclipse detectará y usará automáticamente esas credenciales. Para obtener más información acerca del uso de la CLI de AWS, consulte la AWS CLI User Guide. Para añadir sus claves de acceso a AWS Toolkit for Eclipse 1. Abra el cuadro de diálogo Preferences de Eclipse y haga clic en AWS Toolkit en la barra lateral. 2. Escriba o pegue el ID de clave de acceso de AWS en el cuadro Access Key ID. 3. Escriba o pegue la clave de acceso secreta de AWS en el cuadro Secret Access Key. 4. Haga clic en Apply o en OK para almacenar la información de su clave de acceso. A continuación se muestra un ejemplo de un conjunto configurado de credenciales predeterminadas: Uso de varias cuentas de AWS con AWS Toolkit for Eclipse El cuadro de diálogo Preferences le permite añadir información para más de una cuenta de AWS. Varias cuentas pueden ser útiles, por ejemplo, para proporcionar a los desarrolladores y los administradores recursos independientes para el desarrollo y para el lanzamiento y la publicación. Los conjuntos independientes de credenciales de AWS se almacenan como perfiles en el archivo de credenciales de AWS compartido que se ha descrito en Add your AWS access keys to the AWS Toolkit for Eclipse (p. 5). Todos los perfiles configurados se puede ver en el menú desplegable de la parte superior de la pantalla Global Configuration de AWS Toolkit Preferences, con la etiqueta Default Profile. Para añadir un nuevo conjunto de claves de acceso 1. En la pantalla AWS Toolkit Preferences del cuadro de diálogo Preferences de Eclipse, haga clic en Add profile. 6

11 Cambio de la ubicación del archivo de credenciales de AWS 2. Añada la información de la nueva cuenta en la sección Profile Details. Elija un nombre descriptivo para Profile Name y escriba la información de la clave de acceso en los cuadros Access Key ID y Secret Access Key. 3. Haga clic en Apply o en OK para almacenar la información de su clave de acceso. Puede repetir este procedimiento para tantos conjuntos de información de la cuenta de AWS como sea necesario. Cuando haya especificado toda la información de su cuenta de AWS, seleccione la cuenta predeterminada eligiendo una de las cuentas del menú desplegable Default Profile. AWS Explorer muestra los recursos asociados a la cuenta predeterminada y, cuando se crea una nueva aplicación mediante AWS Toolkit for Eclipse, la aplicación utiliza las credenciales de la cuenta predeterminada configurada. Note Si desea conocer un procedimiento alternativo para separar los recursos de AWS, consulte Diferenciación de los recursos de AWS mediante la nomenclatura (p. 14). Cambio de la ubicación del archivo de credenciales de AWS En la pantalla Preferences de AWS Toolkit for Eclipse, puede cambiar la ubicación utilizada por el Toolkit para almacenar y cargar las credenciales. Para definir la ubicación del archivo de credenciales de AWS En el cuadro de diálogo AWS Toolkit Preferences, busque la sección Credentials file location y escriba el nombre de la ruta del archivo en la que desea almacenar las credenciales de AWS. Important Se recomienda no almacenar la información de las credenciales de AWS en un directorio compartido de red o en proyectos con administración de control de origen. Mantenga siempre un control estricto de sus claves de acceso de AWS. 7

12 Asociación de claves privadas con pares de claves de Amazon EC2 Asociación de claves privadas con pares de claves de Amazon EC2 AWS Toolkit for Eclipse puede obtener sus pares de claves de Amazon EC2 de AWS. Sin embargo, tendrá que asociar las claves privadas para utilizarlas con AWS Toolkit for Eclipse. Para ver los pares de claves de Amazon EC2 en AWS Toolkit for Eclipse y asociar las claves privadas con ellos 1. Abra el cuadro de diálogo Preferences de Eclipse y haga clic en el triángulo situado junto a AWS Toolkit en la barra lateral para mostrar categorías adicionales de la configuración de AWS Toolkit for Eclipse. 2. Seleccione Key Pairs. Eclipse muestra una lista desplazable de los pares de claves. Si un par de claves tiene una X roja junto a él, tendrá que asociar una clave privada con el par de claves para utilizarlo. 3. Haga clic con el botón derecho en el par de claves y, en el menú contextual, seleccione Select Private Key File... 8

13 Asociación de claves privadas con pares de claves de Amazon EC2 4. Vaya hasta el archivo de la clave privada y selecciónelo para asociarlo con el par de claves. 9

14 Creación de una aplicación de Java para AWS Aspectos básicos de AWS Toolkit for Eclipse En esta sección se proporciona información acerca del modo de realizar las tareas de desarrollo comunes con AWS Toolkit for Eclipse. Temas Creación de una aplicación de Java para AWS (p. 10) Proyectos sin servidor (p. 12) Diferenciación de los recursos de AWS mediante la nomenclatura (p. 14) Creación de una aplicación de Java para AWS En esta sección, vamos a utilizar el AWS Toolkit for Eclipse local para crear y ejecutar una aplicación de Java que accede a los recursos de AWS. El AWS Toolkit for Eclipse incluye el AWS SDK for Java y una serie de programas de ejemplo de Java. El AWS Toolkit for Eclipse le facilita la tarea de crear y ejecutar cualquiera de estos ejemplos. Para demostrar cómo puede ayudarle el AWS Toolkit for Eclipse a crear y ejecutar aplicaciones de AWS en Java, usaremos AmazonSimpleQueueService a modo de ejemplo. AWS Explorer, que se proporciona con el AWS Toolkit for Eclipse se puede utilizar para ver la cola de Amazon SQS en ejecución. Note Los ejemplos de AWS SDK for Java se proporcionan en el directorio samples en la descarga del SDK y también pueden visualizarse en GitHub. Para obtener más información sobre el AWS SDK for Java, vea la AWS Java Developer Guide. Cree y ejecute el ejemplo de Amazon Simple Queue Service Para crear y ejecutar el ejemplo de Amazon Simple Queue Service 1. Haga clic en el icono de AWS en la barra de herramientas de Eclipse y, a continuación, haga clic en New AWS Java Project. 2. En el cuadro de diálogo que aparece, escriba un nombre para el proyecto en el cuadro Project name y seleccione Amazon Simple Queue Service Sample. 10

15 Cree y ejecute el ejemplo de Amazon Simple Queue Service 3. Haga clic en Finalizar. 4. La aplicación de ejemplo aparece en Project Explorer. Amplíe la vista de árbol para este proyecto. 5. Bajo el nodo src, haga doble clic en el archivo de origen SimpleQueueService.java para abrirlo en el panel de editor. Localice la siguiente línea: System.out.println("Receiving messages from MyQueue.\n"); 6. Haga clic con el botón derecho en el margen izquierdo del panel de editor y seleccione Toggle Breakpoint. 11

16 Proyectos sin servidor 7. Haga clic con el botón derecho en el nodo del proyecto en Project Explorer, en nuestro ejemplo, este sería el nodo denominado myjavasqsapp y, a continuación, haga clic en Debug As > Java Application. 8. En el cuadro de diálogo Select Java Application, seleccione la aplicación SQS y, a continuación, haga clic en OK. 9. Cuando la aplicación se detiene en el punto de ruptura, Eclipse le preguntará si debería cambiar a la perspectiva de depuración. Haga clic en No (la perspectiva de depuración no incluye AWS Explorer). 10.Vaya a AWS Explorer y expanda el nodo de Amazon SQS. 11.Haga doble clic en MyQueue y vea el contenido de la cola que creó la aplicación cliente Java. 12.Pulse F8. Cliente Java se seguirá ejecutando y finalizará normalment. 13.Actualice la vista en AWS Explorer. Verá que la cola MyQueue ya no está presente, la aplicación elimina la cola antes de que la aplicación salga. Note Si ejecuta esta aplicación de ejemplo repetidamente, debe esperar al menos 60 segundos entre las posteriores ejecuciones. Amazon SQS exige que transcurran al menos 60 segundos después de eliminar una cola antes de crear una cola con el mismo nombre. Proyectos sin servidor AWS Toolkit for Eclipse incluye un asistente de creación de proyectos que se puede utilizar para configurar y crear rápidamente proyectos sin servidor que se implementen en AWS CloudFormation y ejecuten funciones de Lambda en respuesta a solicitudes web RESTful. Creación de un proyecto sin servidor Para crear un proyecto sin servidor Seleccione el icono de AWS en la barra de herramientas y elija New AWS serverless project... en el menú que aparece. Escriba un nombre en Project name. Escriba un valor en Package namespace para el proyecto. Esto se utilizará como prefijo de los espacios de nombres de origen creados para el proyecto. Elija Select a blueprint o Select a serverless template file: Select a Blueprint Elija un plan de proyecto predefinido (p. 13) para utilizarlo en el proyecto sin servidor. 12

17 Planes de proyectos sin servidor Select a Serverless Template File Elija un archivo.template de modelo de aplicación sin servidor (SAM) con formato JSON en su sistema de archivos para personalizar por completo el proyecto sin servidor. Note Para obtener información acerca de la estructura y el contenido de un archivo.template, vea la versión actual de la especificación en GitHub. 5. Pulse el botón Finish para crear el nuevo proyecto sin servidor. El asistente de proyectos sin servidor Planes de proyectos sin servidor Los siguientes planes de proyectos sin servidor están disponibles: article Este plan crea un bucket de S3 para almacenar contenido de artículos y una tabla de DynamoDB para los metadatos de los artículos. Contiene funciones de Lambda para recuperar (GetArticle) y almacenar (PutArticle) artículos, que se activan mediante eventos de API Gateway. hello-world Un plan sencillo que crea una función de Lambda que toma una única cadena. Su salida es Hello, value, donde value es la cadena que se especificó o World si no se transfirió ninguna cadena para la función. Estructura de proyectos sin servidor El asistente de proyectos sin servidor creará un nuevo proyecto de Eclipse, que se compone de las siguientes partes: El directorio src contiene dos subdirectorios, cada uno con un prefijo correspondiente al valor elegido para Package namespace: mynamespace.function Contiene archivos de clase para las funciones de Lambda definidas por su plantilla sin servidor. mynamespace.model Contiene clases ServerlessInput y ServerlessOutput genéricas que definen el modelo de entrada y de salida para las funciones de Lambda. Note Para obtener más información acerca de los formatos de entrada y de salida utilizados en las clases de modelo, consulte la página Configuración de la integración del proxy de API Gateway en la API Gateway Developer Guide. El archivo serverless.template define los recursos de AWS y las funciones de Lambda (un recurso de tipo "AWS::Serverless: Function") que se utilizan en el proyecto. 13

18 Implementación de un proyecto sin servidor Implementación de un proyecto sin servidor Para implementar un proyecto sin servidor 1. En la ventana Project Explorer de Eclipse, seleccione su proyecto y abra el menú contextual (haga clic con el botón derecho o mantenga pulsado). 2. Elija Amazon Web Services Deploy Serverless Project... en el menú contextual. Esto abrirá el cuadro de diálogo Deploy Serverless to AWS CloudFormation. 3. Seleccione los valores de AWS Regions que desea utilizar. Esto determina la ubicación en la que se encuentra la pila de AWS CloudFormation que se ha implementado. 4. Elija un valor de S3 Bucket para almacenar el código de la función de Lambda en él o seleccione el botón Create para crear un nuevo bucket de S3 para almacenar el código. 5. Elija un nombre para su pila de AWS CloudFormation. 6. Pulse el botón Finish para cargar sus funciones de Lambda en Amazon S3 e implementar la plantilla de proyecto en AWS CloudFormation. Cuadro de diálogo de la implementación del proyecto sin servidor Cuando se implementa el proyecto, aparece una ventana de detalles de la pila de AWS CloudFormation que proporciona información acerca de la implementación y su estado actual. El estado se muestra inicialmente como CREATE_IN_PROGRESS. Cuando el estado es CREATE_COMPLETE, la implementación está activa. Para volver a esta ventana en cualquier momento, abra AWS Explorer, seleccione el nodo AWS CloudFormation y, a continuación, seleccione el nombre de la pila de AWS CloudFormation que ha especificado. Note Si se ha producido un error durante la implementación, la pila se puede revertir. Consulte Troubleshooting en la CloudFormation User Guide para obtener información acerca del modo de diagnosticar los errores de implementación de la pila. Véase también AWS Serverless Application Model (GitHub) The CloudFormation Template Editor (p. 33) Using Lambda with the AWS Toolkit for Eclipse (p. 19) Diferenciación de los recursos de AWS mediante la nomenclatura Durante el desarrollo de nuevos productos o características, resulta útil mantener los recursos de AWS que se usan para el desarrollo separados de los recursos que se utilizan para la producción. Una de las estrategias para mantener esta separación se trató en Configuración de credenciales de AWS (p. 4) y consiste en utilizar cuentas diferentes para los recursos de desarrollo y producción. Esta estrategia funciona especialmente bien cuando se utiliza AWS Explorer, ya que AWS Explorer muestra los recursos en función de las credenciales de la cuenta. En esta sección se describe una estrategia alternativa en la que se usa una convención de nomenclatura para diferenciar los recursos de desarrollo y de producción, y en la que la compatibilidad con la convención de nomenclatura se implementa en el código. 14

19 Diferenciación de los recursos de AWS mediante la nomenclatura La idea básica consiste en diferenciar los recursos de AWS, como buckets de Amazon Simple Storage Service (Amazon S3) o dominios de Amazon SimpleDB, mediante la adición de un valor de cadena especificado a los nombres de los recursos. Por ejemplo, en lugar de asignar al dominio de Amazon SimpleDB el nombre "customers", le asignaría el nombre "customers-dev" para el uso en el desarrollo o el nombre "customer-prod" para el uso en la producción. Sin embargo, surge un problema si necesita transferir el código de desarrollo a la producción. En ese momento, tendría cambiar todas estas cadenas, quizás por medio de varias operaciones globales de búsqueda y reemplazo, lo que podría ser lento o propenso a errores. Un método más eficiente sería añadir en el código la compatibilidad con la convención de nomenclatura. La clase StageUtils expone el siguiente método. public static String getresourcesuffixforcurrentstage() El método getresourcesuffixforcurrentstage devuelve una cadena que se corresponde con la "fase" del ciclo de vida de software para la que se usa el recurso, como "dev", "beta" o "prod". Esta cadena se puede añadir a continuación a los identificadores de recursos empleados en el código. Puede utilizar getresourcesuffixforcurrentstage para construir nombres de recursos. Por ejemplo, el siguiente 15

20 Diferenciación de los recursos de AWS mediante la nomenclatura método, gettopicname, devuelve un nombre único para un tema de Amazon SNS. Observe cómo incrusta el valor devuelto por getresourcesuffixforcurrentstage en este nombre. private String gettopicname (Entry entry) { return "entry" + StageUtils.getResourceSuffixForCurrentStage() + "-" + entry.getid(); } El valor devuelto por getresourcesuffixforcurrentstage se obtiene de la propiedad del sistema de Java "application.stage". Puede especificar este valor mediante el ajuste de la propiedad del sistema en la configuración del contenedor de AWS Elastic Beanstalk. Note En AWS Toolkit for Eclipse, la aplicación de AWS Elastic Beanstalk debe estar funcionando para que se pueda tener acceso a la configuración del contenedor. Al modificar y guardar la configuración, la aplicación se reinicia automáticamente con la nueva configuración. Para obtener acceso al panel Container/JVM Options de su aplicación de AWS Elastic Beanstalk 1. En AWS Explorer, expanda el nodo AWS Elastic Beanstalk y el nodo de su aplicación. 2. Bajo el nodo de la aplicación, haga doble clic en su entorno de AWS Elastic Beanstalk. 3. En la parte inferior del panel Overview, haga clic en la pestaña Configuration. 4. En el área Container, configure las opciones de contenedor. 5. En el cuadro Additional Tomcat JVM command line options, especifique el valor de la propiedad application.stage system añadiendo una opción de línea de comando -D. Por ejemplo, puede utilizar la siguiente sintaxis para especificar que el valor de cadena debe ser "-beta". -Dapplication.stage=beta Tenga en cuenta que getresourcesuffixforcurrentstage antepone automáticamente un guion a cualquier valor de cadena que se especifique. 6. Una vez que haya añadido el valor de la propiedad del sistema, haga clic en el menú File y, a continuación, haga clic en Save. Eclipse guardará la nueva configuración. La aplicación debería reiniciarse automáticamente. Puede comprobar la pestaña Events, situada en la parte inferior del editor de Eclipse, para ver el evento que indica que la nueva configuración se ha implementado correctamente en el entorno. 7. Una vez que la aplicación se haya reiniciado, expanda el nodo Amazon SimpleDB en AWS Explorer. Ahora debería poder ver un nuevo conjunto de dominios que utilizan el valor de cadena especificado. 16

21 Diferenciación de los recursos de AWS mediante la nomenclatura Note Para obtener más información acerca de la configuración del contenedor, consulte Creating and Deploying Java Applications on AWS Elastic Beanstalk en la Elastic Beanstalk Developer Guide. 17

22 Cómo obtener acceso a AWS Explorer Trabajo con los servicios de AWS AWS Explorer le ofrece una vista de varias instancias de Amazon Web Services y le permite manipularlas simultáneamente. Esta sección proporciona información acerca de cómo obtener acceso a la vista de AWS Explorer en Eclipse y cómo utilizarla. Se presupone que ya ha instalado (p. 3) AWS Toolkit for Eclipse en el sistema. Temas Cómo obtener acceso a AWS Explorer (p. 18) Uso de Lambda con AWS Toolkit for Eclipse (p. 19) Editor de plantillas de AWS CloudFormation (p. 33) Uso de DynamoDB con AWS Explorer (p. 42) Lanzamiento de una instancia Amazon EC2 desde una Amazon Machine Image (p. 45) Administración de grupos de seguridad desde AWS Explorer (p. 46) Visualización y adición de notificaciones de Amazon SNS (p. 48) Conexión a Amazon Relational Database Service (Amazon RDS) (p. 50) Identity and Access Management (p. 51) Cómo obtener acceso a AWS Explorer Para visualizar AWS Explorer, haga clic en el icono de AWS en la barra de herramientas y seleccione Show AWS Explorer View. Menú del icono de AWS Note Si el icono de AWS no está visible en la barra de herramientas, haga clic en el menú Window y, a continuación, haga clic en Open Perspective Other. Haga clic en AWS Management en la lista de perspectivas de Eclipse. Puede expandir cada nodo de AWS Explorer para ver los recursos de AWS que están asociados con su cuenta. Por ejemplo, si hace clic en el triángulo blanco situado a la izquierda del nodo Amazon EC2, se 18

23 Uso de Lambda con AWS Toolkit for Eclipse expandirá y mostrará los recursos de Amazon EC2 asociados con su cuenta de AWS. AWS Toolkit for Eclipse utiliza la cuenta de AWS que ha configurado en Set up AWS Credentials (p. 4) para determinar qué recursos se deben mostrar. Si selecciona cualquiera de los subnodes de Amazon EC2, Eclipse abrirá una vista con información detallada acerca de esos recursos. Por ejemplo, al hacer doble clic en Instances, se abre una vista que muestra información sobre cada una de las instancias Amazon EC2, como su nombre de DNS público, su zona de disponibilidad y la hora de lanzamiento. Uso de Lambda con AWS Toolkit for Eclipse AWS Toolkit for Eclipse permite crear código para AWS Lambda. Lambda es un servicio de computación totalmente administrado que ejecuta su código como respuesta a eventos generados por código personalizado o de varios servicios de AWS como Amazon S3, DynamoDB, Kinesis, Amazon SNS y Amazon Cognito. Para obtener más información acerca de Lambda, consulte la Lambda Developer Guide. Esta sección de la AWS Toolkit for Eclipse User Guide se centra en cómo se pueden utilizar las características de AWS Toolkit for Eclipse para crear, implementar y ejecutar funciones de Lambda. Temas Tutorial: cómo crear, cargar e invocar una función de AWS Lambda (p. 20) Referencia de la interfaz de AWS Lambda (p. 27) 19

24 Tutorial: cómo crear, cargar e invocar una función de AWS Lambda Tutorial: cómo crear, cargar e invocar una función de AWS Lambda Este tutorial le guiará a través del proceso de un flujo de trabajo típico de AWS Lambda y le proporcionará una experiencia de primera mano del uso de Lambda con AWS Toolkit for Eclipse. Important El tutorial presupone que tiene una cuenta de AWS, que ya ha instalado AWS Toolkit for Eclipse (p. 3) y que conoce las características y los conceptos básicos de Lambda. Si no está familiarizado con Lambda, puede obtener más información en la página de inicio de Lambda y en la Lambda Developer Guide. Creación de una clase de controlador de Lambda En primer lugar, implementará el código como un método en una clase de controlador. AWS Toolkit for Eclipse proporciona un nuevo asistente de proyectos para ayudarle a crear una nueva clase de controlador. Para crear una clase de controlador de Lambda 1. En la barra de herramientas de Eclipse, abra el menú desplegable Amazon Web Services (identificado por el icono de AWS) y seleccione New AWS Lambda Java project Añada el nombre de su proyecto de Java, el nombre del paquete y el nombre de la clase en los cuadros de entrada correspondientes. Puede elegir cualquier nombre válido que desee. En este tutorial se usarán los siguientes valores de muestra: Project name: HelloLambda Package name: example Clase name: Hello A medida que escriba, el código de Source preview cambiará para reflejar los cambios realizados en el cuadro de diálogo. 3. En Input Type, elija Custom. Para obtener más información acerca de cada uno de los tipos de entrada disponibles, consulte New AWS Lambda Java Project Dialog (p. 27). 4. El segundo campo Input Type es el nombre del tipo de Java que se devolverá, que debe ser una clase de Java (no un tipo primitivo como, por ejemplo, float, int o boolean). El valor predeterminado es Object. Cambie este valor a String. 5. Cambie también el valor de Output Type a String. 6. Compruebe que las entradas tienen un aspecto parecido al de la siguiente captura de pantalla (modifíquelas si no es así) y, a continuación, haga clic en Finish. 20

25 Tutorial: cómo crear, cargar e invocar una función de AWS Lambda 7. Una vez que haga clic en Finish, el directorio y los archivos de origen del proyecto se generarán en su espacio de trabajo de Eclipse y aparecerá una nueva ventana del navegador web en la que se mostrará README.html (que se ha creado en el directorio raíz del proyecto). README.html proporciona instrucciones que le guiarán a través de los siguientes pasos de la implementación, las pruebas, la carga y la invocación de la nueva función de Lambda. Lea el documento para familiarizarse con los siguientes pasos que se describirán aquí. A continuación, implementaremos la función en el proyecto de Java HelloLambda que se acaba de crear en Eclipse. Implementación del método del controlador El cuadro de diálogo Create New Project crea el esqueleto de un proyecto, en el que el usuario tendrá que rellenar el código que se ejecutará cuando se invoque la función de Lambda (en este caso, por un evento personalizado que envíe una cadena a la función, como se especificó al definir el parámetro de entrada del método). 21

26 Tutorial: cómo crear, cargar e invocar una función de AWS Lambda Para implementar el método de controlador de Lambda 1. En Eclipse, en Project Explorer, abra Hello.java en el proyecto HelloLambda. Contendrá un código similar al siguiente: package example; import com.amazonaws.services.lambda.runtime.context; import com.amazonaws.services.lambda.runtime.requesthandler; public class Hello implements RequestHandler<String, String> public String handlerequest(string input, Context context) { context.getlogger().log("input: " + input); } // TODO: implement your handler return null; } 2. Reemplace el contenido de la función handlerequest con el siguiente public String handlerequest(string input, Context context) { String output = "Hello, " + input + "!"; return output; } Ahora, el archivo Hello.java debe contener: package example; import com.amazonaws.services.lambda.runtime.context; import com.amazonaws.services.lambda.runtime.requesthandler; public class Hello implements RequestHandler<String, String> public String handlerequest(string input, Context context) { String output = "Hello, " + input + "!"; return output; } } Permitir que Lambda asuma un rol de IAM Para que Lambda obtenga acceso a su función de Lambda, tendrá que crear un rol de IAM que le dé acceso a los recursos de AWS. La manera más sencilla de hacerlo es usar la Consola de administración de AWS. Para crear un rol de IAM para Lambda 1. Inicie sesión en la consola de administración de AWS. 2. Abra la consola de IAM. 3. Seleccione Roles en la barra lateral y, a continuación, Create New Role. 4. Añada un nombre para el rol, como, por ejemplo, hello-lambda-role y, a continuación, haga clic en Next Step. 22

27 Tutorial: cómo crear, cargar e invocar una función de AWS Lambda 5. En la página Select Role Type, seleccione AWS Lambda en la lista AWS Service Roles. 6. En Attach Policy, active AmazonS3FullAccess, que permite a Lambda obtener acceso a sus recursos de Amazon S3, y, a continuación, haga clic en Next Step para continuar. Note Amazon S3 es necesario porque Lambda cargará el código en un bucket de Amazon S3 cuando implemente y ejecute su función de Lambda. Puede utilizar un bucket creado por usted (esto se explica en la siguiente sección) o utilizar un bucket existente. 7. Revise los parámetros del rol y, a continuación, haga clic en Create Role para terminar de crear el rol de IAM. Cree un bucket de Amazon S3 para su código de Lambda AWS Lambda requiere un bucket de Amazon S3 para almacenar su proyecto de Java cuando lo cargue. Puede utilizar un bucket que ya exista en la región de AWS en la que se ejecutará el código o puede crear uno nuevo específicamente para que Lambda lo use (recomendado). Para crear un bucket de Amazon S3 para su uso con Lambda 1. Inicie sesión en AWS y vaya a la consola de S3. 2. Haga clic en Create Bucket. 3. Escriba un nombre para el bucket y seleccione una región de AWS para él. Esta región debe ser la misma en la que desea ejecutar la función de Lambda. Para obtener una lista de las regiones admitidas por Lambda, consulte el tema Regions and Endpoints en la Amazon Web Services General Reference. 4. Haga clic en Create para terminar de crear el bucket. Carga del código A continuación, cargaremos el código en AWS Lambda como preparación para invocarlo desde la Consola de administración de AWS. Para cargar la función en Lambda 1. Haga clic con el botón derecho en la ventana y seleccione AWS Lambda y, a continuación, Upload function to AWS Lambda En el cuadro de diálogo Select Target Lambda Function que aparece, seleccione la región de AWS que desee usar. Debe ser la misma región que eligió para el bucket de Amazon S3 (p. 23). 23

28 Tutorial: cómo crear, cargar e invocar una función de AWS Lambda 3. Seleccione Create a new Lambda function y escriba el nombre de su función (como HelloFunction). 4. Haga clic en Next para ir al paso Function Configuration. 5. Escriba una descripción para la función de Lambda de destino. Puede dejar el resto de las opciones como están; AWS Toolkit for Eclipse elige los valores predeterminados. 24

29 Tutorial: cómo crear, cargar e invocar una función de AWS Lambda Para obtener más información acerca de las opciones disponibles, consulte Upload AWS Lambda Function Dialog (p. 29). 6. Haga clic en Finish para cargar la función de Lambda en AWS. Si la carga se realiza correctamente, verá el nombre de la función de Lambda que eligió junto al nombre de su proyecto de Eclipse en la vista de Project Explorer: De no ser así, debe abrir la vista Error Log de Eclipse. Lambda escribirá la información relativa a los errores de la carga o la ejecución de la función en el registro de errores para continuar con la depuración. 25

30 Tutorial: cómo crear, cargar e invocar una función de AWS Lambda Invocar la función de Lambda Ahora puede invocar la función en AWS Lambda. Para invocar una función de Lambda 1. Haga clic con el botón derecho en la ventana de código y seleccione AWS Lambda y, a continuación, Run on AWS Lambda. 2. En el cuadro de entrada, escriba una cadena de JSON válida, como "AWS Lambda". Note Puede añadir nuevos archivos de entrada JSON en el proyecto y se mostrarán en este cuadro de diálogo siempre que el nombre de archivo termine con ".json". Puede utilizar esta característica para proporcionar archivos de entrada estándar para las funciones de Lambda. 3. Haga clic en Invoke y enviará los datos de entrada a la función de Lambda. Si lo ha configurado todo correctamente, el valor de retorno de la función se debería imprimir en la vista Console de Eclipse (que aparecerá automáticamente si no se muestra aún). Enhorabuena, acaba de ejecutar su primera función de Lambda directamente desde el IDE de Eclipse. 26

31 Referencia de la interfaz de AWS Lambda Próximos pasos Ahora que ha cargado e implementado su función, pruebe a cambiar el código y volver a ejecutar la función. Lambda volverá a cargar e invocar automáticamente la función e imprimirá los resultados en la consola. Para obtener más información acerca de cada una de las pantallas que se han descrito en este tutorial, así como una descripción completa de cada opción, consulte AWS Lambda Interface Reference (p. 27). Para obtener más información acerca de Lambda y acerca de la escritura de código Java para Lambda, consulte Authoring Lambda Functions in Java en la Lambda Developer Guide. Referencia de la interfaz de AWS Lambda Esta sección proporciona información detallada acerca de cada uno de los elementos de la interfaz añadidos a Eclipse por el AWS Toolkit for Eclipse para AWS Lambda. Temas Cuadro de diálogo New AWS Lambda Java Project (p. 27) Cuadro de diálogo Upload AWS Lambda Function (p. 29) Cuadro de diálogo Run AWS Lambda Function (p. 32) Cuadro de diálogo New AWS Lambda Java Project El cuadro de diálogo New Lambda Java Project le ayuda a crear y configurar un nuevo proyecto de Java que puede utilizar para crear una función de Lambda. Lanzamiento del cuadro de diálogo El cuadro de diálogo New Lambda Java Project se puede lanzar de las siguientes formas: abriendo el menú AWS de la barra de herramientas de Eclipse y seleccionando New AWS Lambda Java project... seleccionando File New Other... en el menú Eclipse y, a continuación, eligiendo AWS AWS Lambda Java Project en el cuadro de diálogo resultante. 27

32 Referencia de la interfaz de AWS Lambda Interfaz de usuario del cuadro de diálogo de creación de proyectos Project name Obligatorio. Debe proporcionar un nombre para el proyecto. Package name Nombre opcional para el paquete de Java. Debe ser un nombre de paquete de Java válido, como "com.mycompany.myproject". Cuando escriba el nombre del paquete en el campo de entrada de texto, se añadirá al contenido de la ventana Source Preview. Valor predeterminado: ninguno, este parámetro es opcional. Class name Obligatorio. Nombre que identifica la clase de Java que contiene el código de Lambda. Debe ser un nombre de clase de Java válido. El valor predeterminado es genérico; puede especificar su propio nombre aquí o cambiar el valor de Package name para evitar los conflictos con las clases con nombres similares. Valor predeterminado: LambdaFunctionHandler 28

33 Referencia de la interfaz de AWS Lambda Input type Obligatorio. Tipo de entrada que se utilizará para llamar a su función de Lambda. Puede seleccionar una categoría en la lista desplegable: S3 Event: recibe un evento de Amazon S3. SNS Event: recibe un evento de Amazon SNS. Kinesis Event: recibe un evento de un flujo de Amazon Kinesis. Cognito Event: recibe un evento de Amazon Cognito. Custom: recibe un evento del código personalizado. Si establece el tipo de entrada en Custom, también podrá configurar el nombre del tipo de entrada personalizado en el cuadro situado junto a la selección del tipo. De forma predeterminada, se usa el tipo genérico Object. Important El tipo de entrada personalizado debe ser un nombre de clase de Java válido y no un tipo primitivo como, por ejemplo int, float, etc. Puede utilizar los tipos estándar de Java (Integer, Float, etc.) para esos casos. Utilice el tipo de entrada Custom para configurar orígenes de eventos como los siguientes: aplicaciones de usuario aplicaciones móviles La consola de administración de AWS. El comando invoke de la CLI de AWS. Valor predeterminado: S3 Event Output type Tipo de salida. Debe ser un objeto de Java válido. Valor predeterminado: Object Cuadro de diálogo Upload AWS Lambda Function El cuadro de diálogo Upload Lambda Function creará una función de Lambda y cargará el código que se debe ejecutar cuando se invoque la función de Lambda. Lanzamiento del cuadro de diálogo El cuadro de diálogo Upload Lambda Function se puede lanzar de las siguientes formas: abriendo el menú contextual de su proyecto Java de AWS Lambda en la vista Project Explorer de Eclipse y seleccionando Amazon Web Services > Upload function to AWS Lambda... abriendo el menú contextual en la ventana de código de la clase de Java y seleccionando AWS Lambda > Upload function to AWS Lambda... El cuadro de diálogo Upload Function contiene dos pantallas: Select Target Lambda Function (p. 30) Función de configuración (p. 31) 29

34 Referencia de la interfaz de AWS Lambda Interfaz de usuario de Select Target Lambda Function Select AWS Region Obligatorio. Seleccione la región en la que se creará la función de Lambda. Valor predeterminado: la región predeterminada de la Consola de administración de AWS para su cuenta de AWS. Select or create a Lambda function Obligatorio. Debe elegir si desea utilizar una función de Lambda de la lista desplegable o crear una nueva escribiendo su nombre. Valor predeterminado: Create a new Java function Al hacer clic en Finish, el control avanza a la pantalla Configure Function. 30

35 Referencia de la interfaz de AWS Lambda Interfaz de usuario de Configure Function La pantalla se divide en cuatro secciones, cada una con sus propios ajustes. Basic Settings Esta sección muestra el nombre de la función y le permite añadir una descripción de texto. Nombre No se puede cambiar. El nombre viene determinado por el nombre elegido en la pantalla Select Target Lambda Function. No se puede modificar aquí, aunque puede hacer clic en Back para volver a escribirlo en la pantalla anterior. Descripción Opcional. Descripción de texto de la función. Valor predeterminado: la descripción está vacía. 31

36 Referencia de la interfaz de AWS Lambda Function Execution Esta sección le permite modificar el entorno de ejecución de la función. Controlador Obligatorio. La clase de Java que contiene el código de la función de Lambda. Valor predeterminado: el paquete y el nombre de la clase de su proyecto se seleccionan automáticamente. Rol de IAM Obligatorio. Rol que Lambda utilizará para obtener acceso a sus recursos de AWS durante la ejecución de la función. Debe asegurarse de que este rol proporciona acceso para AWS Lambda al menos a Amazon S3, pero si su función utiliza otros recursos de AWS, también debe proporcionar acceso a cada uno de los servicios utilizados. Valor predeterminado: el primer rol de IAM de su cuenta de AWS. S3 Bucket for Function Code Esta sección le permite configurar un bucket de S3 utilizado por su función de Lambda. S3Bucket Obligatorio. Un bucket de Amazon S3 que se puede utilizar en el código de la función. Solo los buckets que están en la misma región en la que se ejecutará la función se muestran aquí. Configuración avanzada Esta sección contiene los ajustes que se usan con menos frecuencia y que proporcionan más control sobre el entorno de ejecución de la función que la configuración de la sección Function Execution. Memoria (MB) Obligatorio. El número de megabytes de memoria disponibles para la función de Lambda. Valor predeterminado: 512 MB Timeout (s) Obligatorio. El tiempo de espera, en segundos, después del cual se considerará que la función ha fallado si ha finalizado la ejecución. Valor predeterminado: 15 s. Cuadro de diálogo Run AWS Lambda Function El cuadro de diálogo Run Lambda Function proporciona una forma de invocar una función de Lambda directamente desde la interfaz de usuario de Eclipse. Lanzamiento del cuadro de diálogo El cuadro de diálogo Run Lambda Function se puede iniciar de las siguientes formas: abriendo el menú contextual de su proyecto Java de AWS Lambda en la vista Project Explorer de Eclipse y seleccionando Amazon Web Services > Run function on AWS Lambda... abriendo el menú contextual en la ventana de código de la clase de Java y seleccionando AWS Lambda > Run function on AWS Lambda... 32

37 Editor de plantillas de AWS CloudFormation Aparece el cuadro de diálogo Invoke Function como se muestra a continuación: Opciones Hay dos formas de proporcionar datos a una función. Es necesario usar una de las dos. Select one of the JSON files as input: si hay archivos.json adjuntados al proyecto, puede seleccionar uno de ellos en la lista proporcionada. De lo contrario, esta opción estará atenuada. Or enter the JSON input for your function: aquí puede escribir directamente una entrada JSON válida para su función. El tipo de datos que escriba debe coincidir con el parámetro de entrada del método Java de la clase del controlador. Una vez que haya realizado una selección y haya proporcionado los datos de entrada, puede hacer clic en Finish para invocar su función de Lambda o hacer clic en Cancel para salir del cuadro de diálogo sin ejecutar nada. Editor de plantillas de AWS CloudFormation AWS Toolkit for Eclipse incluye un editor de plantillas de AWS CloudFormation integrado. Entre las características admitidas se incluyen las siguientes: La capacidad para crear y actualizar pilas directamente en el IDE de Eclipse IDE desde la plantilla que se está editando. Un validador de JSON que ayuda a garantizar que la plantilla cumple con las reglas de formato y contenido de JSON. Temas 33

38 Añadir plantillas de AWS CloudFormation y obtener acceso a ellas en Eclipse Añadir plantillas de AWS CloudFormation y obtener acceso a ellas en Eclipse (p. 34) Implementación de una plantilla de AWS CloudFormation en Eclipse (p. 36) Actualización de una plantilla de AWS CloudFormation en Eclipse (p. 39) Validación de una plantilla de AWS CloudFormation en Eclipse (p. 42) Añadir plantillas de AWS CloudFormation y obtener acceso a ellas en Eclipse Para añadir una plantilla de CloudFormation a su proyecto de Eclipse 1. Localice la plantilla que desee añadir a su proyecto en el administrador del sistema de archivos y arrastre el archivo a la ventana Package Explorer del proyecto. 2. Elija cómo desea añadir el archivo al proyecto y haga clic en OK. 34

39 Añadir plantillas de AWS CloudFormation y obtener acceso a ellas en Eclipse Para obtener acceso a una plantilla de CloudFormation en un proyecto de Eclipse Haga doble clic en el nombre de la plantilla en Package Explorer para comenzar a editar el archivo. Note Los archivos que finalizan con.template o.json usan automáticamente el editor de plantillas de AWS CloudFormation. Si el archivo no se reconoce automáticamente como plantilla de AWS CloudFormation, puede seleccionar el editor. Para ello, haga clic con el botón derecho del 35

40 Implementación de una plantilla de AWS CloudFormation en Eclipse ratón en el nombre de archivo en Package Explorer o haga clic con el botón derecho del ratón en la ventana de editor con el archivo cargado, seleccione Open With y, a continuación, elija CloudFormation Template Editor. Implementación de una plantilla de AWS CloudFormation en Eclipse Note Solo es posible lanzar desde Eclipse IDE los archivos que acaben en.template. Si el archivo termina con otra extensión, por ejemplo.json, en primer lugar deberá cambiar el nombre con una extensión.template para utilizar esta característica. Para implementar una plantilla de CloudFormation de Eclipse 1. Con el archivo.template de AWS CloudFormation abierto en el editor de plantilla de AWS CloudFormation (consulte Adding and Accessing CloudFormation Templates in Eclipse (p. 34) para obtener más información), haga clic con el botón derecho en la plantilla y seleccione Run on AWS y, a continuación, Create Stack en el menú contextual. 2. En el cuadro de diálogo Create New CloudFormation Stack, escriba el nombre de la pila en el campo Stack Name. Deberá elegirse automáticamente su archivo de plantilla en el campo Template File. 36

41 Implementación de una plantilla de AWS CloudFormation en Eclipse 3. Elija una (o ninguna) de las siguientes opciones: SNS Topic: elija un tema de SNS de la lista para recibir notificaciones sobre el progreso de la pila o cree uno nuevo. Para ello, escriba una dirección de correo electrónico en el cuadro y haga clic en Create New Topic. Creation Timeout: elija cuánto tiempo debe permitir AWS CloudFormation que transcurra para la creación de la pila antes de declarar un error (y para la restauración, a menos que la opción Rollback on failure no esté marcada). Rollback on failure: si desea que se produzca la restauración de la pila (se elimina a sí misma) al producirse el error, marque esta opción. Déjela desactivada si desea que la pila permanezca activa, a efectos de depuración, incluso si no se ha podido completar el lanzamiento. 4. Haga clic en Next para seguir escribiendo valores de parámetros. 5. Si la pila tiene parámetros, a continuación escribirá sus valores. En el caso de los parámetros con una lista predefinida de posibles respuestas, puede elegir un valor en la lista proporcionada. 37

42 Implementación de una plantilla de AWS CloudFormation en Eclipse 6. Haga clic en Finish para empezar a lanzar la pila. Mientras se lanza la pila, puede ver su estado. Para ello, haga doble clic en el nombre de la pila debajo del nodo CloudFormation en la vista AWS Explorer o haga clic con el botón derecho en el nombre de la pila y seleccione Open in Stack Editor en el menú contextual. Note Si no puede ver la pila que lanzó en AWS Explorer, es posible que tenga que actualizar manualmente la vista. Para ello, haga clic en el icono Refresh AWS Explorer de la parte superior de la vista de AWS Explorer. 38

43 Actualización de una plantilla de AWS CloudFormation en Eclipse Actualización de una plantilla de AWS CloudFormation en Eclipse Para actualizar una plantilla de CloudFormation en Eclipse 1. Con el archivo.template de AWS CloudFormation abierto en el editor de plantillas de AWS CloudFormation (consulte Adding and Accessing CloudFormation Templates in Eclipse (p. 34) para obtener más información), haga clic con el botón derecho en la plantilla abierta y seleccione Run on AWS y, a continuación, Update Stack en el menú contextual. 2. En el cuadro de diálogo Update CloudFormation Stack, seleccione el nombre de la pila en el campo Stack Name si no se ha seleccionado de forma automática. El archivo de plantilla debería haberse elegido también automáticamente en el campo Template File. 39

44 Actualización de una plantilla de AWS CloudFormation en Eclipse 3. Elija una (o ninguna) de las siguientes opciones: SNS Topic: elija un tema de SNS de la lista para recibir notificaciones sobre el progreso de la pila o cree uno nuevo. Para ello, escriba una dirección de correo electrónico en el cuadro y haga clic en Create New Topic. Creation Timeout: elija cuánto tiempo debe permitir AWS CloudFormation que transcurra para la creación de la pila antes de declarar un error (y para la restauración, a menos que la opción Rollback on failure no esté marcada). Rollback on failure: si desea que se produzca la restauración de la pila (se elimina a sí misma) al producirse el error, marque esta opción. Déjela desactivada si desea que la pila permanezca activa, a efectos de depuración, incluso si no se ha podido completar el lanzamiento. 4. Haga clic en Next para seguir escribiendo valores de parámetros. 5. Si la pila tiene parámetros, a continuación escribirá sus valores. En el caso de los parámetros con una lista predefinida de posibles respuestas, puede elegir un valor en la lista proporcionada. 40

45 Actualización de una plantilla de AWS CloudFormation en Eclipse 6. Haga clic en Finish para comenzar a actualizar la pila. Mientras se actualiza la pila, puede ver su estado haciendo doble clic en el nombre de la pila debajo del nodo CloudFormation en la vista AWS Explorer o haciendo clic con el botón derecho en el nombre de la pila y seleccionado Open in Stack Editor en el menú contextual. 41

46 Validación de una plantilla de AWS CloudFormation en Eclipse Validación de una plantilla de AWS CloudFormation en Eclipse Para validar una plantilla de CloudFormation en Eclipse Lleve a cabo una de las siguientes acciones: Haga clic con el botón derecho en el nombre de la plantilla en la vista Package Explorer y haga clic en Validate en el menú contextual. Haga clic con el botón derecho en la plantilla que está editando en el panel del editor y haga clic en Validate en el menú contextual. Important La plantilla se validará para comprobar únicamente la corrección de JSON; no se validará para comprobar la corrección de CloudFormation. Una plantilla de pila validada de este modo puede a pesar de ello generar errores de lanzamiento o de actualización. Uso de DynamoDB con AWS Explorer Amazon DynamoDB es un servicio de base de datos no relacional rentable, rápido, de alta disponibilidad y muy escalable. DynamoDB elimina las limitaciones tradicionales de escalabilidad en el almacenamiento de datos y, al mismo tiempo, mantiene una baja latencia y un desempeño previsible. El AWS Toolkit for Eclipse ofrece funcionalidades para trabajar con DynamoDB en un contexto de desarrollo. Para obtener más información, consulte DynamoDB en la página web de AWS. En el AWS Toolkit for Eclipse, AWS Explorer muestra todas las tablas de DynamoDB asociadas con la cuenta de AWS activa. Mostrar tablas de Amazon DynamoDB en AWS Explorer. 42

47 Creación de una tabla de DynamoDB Creación de una tabla de DynamoDB Puede crear una tabla de DynamoDB nueva con el AWS Toolkit for Eclipse. Para crear una tabla nueva en AWS Explorer 1. En AWS Explorer, haga clic con el botón derecho en Amazon DynamoDB y, a continuación, haga clic en Create Table. Aparece el asistente Create New DynamoDB Table. 2. Introduzca el nombre de la tabla en el cuadro Table name. 3. Escriba un atributo de clave hash principal en el campo Hash key attribute y seleccione el tipo de clave hash de la lista desplegable Hash key type. DynamoDB crea un índice hash sin ordenar a partir del atributo de clave principal y un índice de rango ordenado opcional a partir del atributo de clave principal de rango. Para obtener más información sobre el atributo de clave hash principal, consulte Partitions and Data Distribution en la DynamoDB Developer Guide. 4. Si lo desea, seleccione Use a range key para especificar una clave principal de rango. Escriba un atributo de clave de rango en el cuadro Range key attribute y seleccione un tipo de clave de rango de la lista desplegable Range key type. 5. Especifique el número de unidades de capacidad de lectura en el cuadro Read capacity units y especifique el número de unidades de capacidad de escritura en el cuadro Write capacity units. Debe especificar un mínimo de 3 unidades de capacidad de lectura y 5 unidades de capacidad de escritura. Para obtener más información acerca de unidades de capacidad de lectura y escritura, vaya a Provisioned Throughput en la DynamoDB Developer Guide. 6. Haga clic en Finish para crear la tabla. Haga clic en el botón de actualización en AWS Explorer para ver la tabla nueva en la lista de tablas. Creación de una tabla Visualización de una tabla de DynamoDB como una cuadrícula Para abrir una vista de cuadrícula de una de sus tablas de DynamoDB, haga doble clic en el subnodo en AWS Explorer que se corresponde con la tabla. En la vista de cuadrícula, puede ver los elementos, atributos y valores almacenados en la tabla. Cada fila corresponde a un elemento en la tabla. Las columnas de la tabla corresponden a los atributos. Cada celda de la tabla contiene los valores asociados con dicho atributo para dicho elemento. Un atributo puede tener un valor que es una cadena o un número. Algunos atributos tienen un valor que consta de un conjunto de cadenas o números. Los valores establecidos se muestran como una lista separada por comas delimitados entre corchetes. Vista de cuadrícula de Amazon DynamoDB Edición de atributos y valores La vista de cuadrícula de la tabla puede editarse; al hacer doble clic en una celda, puede editar los valores para el atributo correspondiente del elemento. Para atributos de valor de conjunto, también puede añadir o eliminar valores individuales desde el conjunto. Edición de celdas en vista de cuadrícula de Amazon DynamoDB La interfaz de usuario (IU) de edición le permite no solo cambiar el valor de un atributo, sino también cambiar el formato del valor de un atributo, con algunas limitaciones. Por ejemplo, cualquier valor numérico puede convertirse en un valor de cadena. Si tiene un valor de cadena, cuyo contenido es un número, como, por ejemplo, 125, la IU de edición le permite convertir el formato del valor de cadena a número. Además, la IU de edición le permite convertir un valor individual en un valor de conjunto. Sin embargo, 43

48 Análisis de una tabla de DynamoDB por lo general, no es posible convertir un valor de conjunto en un valor individual, excepto si el valor de conjunto tiene, de hecho, un solo elemento en el conjunto. Edición de valores de conjuntos en vista de cuadrícula de Amazon DynamoDB El cuadro de diálogo Edit Values se abre cuando se edita un conjunto de valores. Después de editar el valor del atributo, haga clic en Save set para confirmar los cambios. Si desea desechar los cambios, haga clic en Cancel. Después de confirmar los cambios, el valor del atributo se muestra en rojo. Esto indica que el atributo se ha actualizado, pero que el valor nuevo no se ha vuelto a escribir en la base de datos de Amazon DynamoDB. Para volver a escribir los cambios en DynamoDB, haga clic en File y, a continuación, haga clic en Save o pulse desde el teclado. Para desechar los cambios, haga clic en Scan Table y cuando el Toolkit pregunte si desea confirmar los cambios antes de la exploración, haga clic en No. Análisis de una tabla de DynamoDB Botón de análisis Desde el Toolkit, puede realizar exploraciones en las tablas de DynamoDB. En un análisis, usted define un conjunto de criterios y el análisis devuelve todos los elementos de la tabla que cumplan sus criterios. Los análisis son operaciones caras y deben utilizarse con cuidado para evitar interrumpir el tráfico de producción de mayor prioridad en la tabla. Para obtener más recomendaciones sobre el uso seguro de la operación de exploración, consulte la Guía de desarrolladores de Amazon DynamoDB. Para realizar un análisis en una tabla de Amazon DynamoDB desde AWS Explorer 1. En la vista de cuadrícula, haga clic en Add scan condition. Aparecerá una IU que le permite editar una nueva cláusula de análisis. 2. En el editor de cláusula de análisis, especifique el atributo para realizar la comparación, cómo debe asociarse (Begins With, Contains, etc.), el valor literal con el que debe coincidir y si el valor es una cadena o un número. 3. Añada más cláusulas de análisis, según sea necesario, para la búsqueda. El análisis devolverá únicamente aquellos elementos que coincidan con los criterios de todas sus cláusulas de análisis. Tenga en cuenta que el análisis hará una comparación que distingue entre mayúsculas y minúsculas al realizar la comparación con los valores de cadena. 4. En la barra de botones en la parte superior de la vista de cuadrícula, haga clic en el botón verde para ejecutar el análisis. Para eliminar una cláusula de análisis, haga clic en el botón rojo X a la izquierda de cada cláusula. Botón de análisis Para volver a la vista de la tabla que incluye todos los elementos, haga doble clic en Amazon DynamoDB en AWS Explorer. Paginación de los resultados del análisis En la parte superior de la vista hay tres botones. Botones de paginación y exportación El segundo botón proporciona la paginación para los resultados de análisis. Al hacer clic en el botón situado más a la derecha exporta los resultados del análisis actual a un archivo CSV. 44

49 Lanzamiento de una instancia Amazon EC2 desde una Amazon Machine Image Lanzamiento de una instancia Amazon EC2 desde una Amazon Machine Image Antes de lanzar una instancia EC2, debe crear un grupo de seguridad que permitirá que el tráfico de la red sea adecuado para que su aplicación se conecte a la instancia. Como mínimo, el grupo de seguridad debe permitir el acceso en el puerto 22 para que se pueda utilizar SSH en la instancia EC2. Es posible que además desee crear un par de claves, aunque también puede hacerlo mientras completa el asistente de lanzamiento. Por último, debe pensar en los tipos de instancias que son adecuados para la aplicación. El precio de una instancia EC2 suele ser superior para los tipos de instancias más potentes. Puede encontrar una lista de tipos de instancias e información sobre precios en la página Precios de Amazon EC2. Para lanzar una instancia Amazon EC2 1. En AWS Explorer, expanda el nodo Amazon EC2. Haga clic con el botón derecho en el subnodo Amazon Machine Images (AMIs) y seleccione Open EC2 AMIs View. Cuadro de diálogo de configuración de la AMI 2. Configure la vista AMIs para mostrar la AMI que se utilizará en este ejemplo. En el cuadro de filtro, escriba start ebs. Esto filtra la lista de las AMI para mostrar solo aquellas cuyos nombres contienen "start" y "ebs". Haga clic con el botón derecho en la AMI amazon/getting-started-with-ebs y seleccione Launch en el menú contextual. Seleccione la AMI Getting Started with EBS 3. En el cuadro de diálogo Launch EC2 Instance, configure la AMI para su aplicación. Number of Hosts Establezca este valor en el número de instancias EC2 que se van a lanzar. Tipo de instancia Seleccione el tipo de instancia EC2 que se va a lanzar. Puede encontrar una lista de tipos de instancias e información sobre precios en la página Precios de Amazon EC2. Zona de disponibilidad Seleccione la zona de disponibilidad (AZ) en la que se debe lanzar la instancia. No todas las zonas de disponibilidad están disponibles en todas las regiones. Si la zona de disponibilidad que seleccione no está disponible, el Toolkit generará un mensaje en el que se indica que debe seleccionar una zona de disponibilidad diferente. Para obtener más información acerca de las zonas de disponibilidad, consulte Region and Availability Zone FAQ en la Amazon EC2 User Guide for Linux Instances. Key Pair Un par de claves es un conjunto de claves de cifrado públicas/privadas que se utilizan para autenticarle cuando se conecta a la instancia EC2 mediante SSH. Seleccione un par de claves para el que tenga acceso a la clave privada. Grupo de seguridad El grupo de seguridad controla el tipo de tráfico de red que aceptará la instancia EC2. Debe seleccionar un grupo de seguridad que admita tráfico entrante en el puerto 22, el puerto utilizado por SSH, para que pueda conectarse a la instancia EC2. Para obtener información acerca del modo de crear grupos de seguridad con el Toolkit, consulte Managing Security Groups from AWS Explorer (p. 46). 45

50 Administración de grupos de seguridad desde AWS Explorer Instance Profile El perfil de instancia es un contenedor lógico para un rol de IAM. Cuando selecciona un perfil de instancia, asocia el rol de IAM correspondiente con la instancia EC2. Los roles de IAM se configuran con políticas que especifican el acceso a determinados servicios de AWS y recursos de la cuenta. Cuando una instancia EC2 está asociada con un rol de IAM, el software de la aplicación que se ejecuta en la instancia se ejecuta con los permisos especificados por el rol de IAM. Esto permite que el software de la aplicación se ejecute sin tener que especificar ninguna credencial de AWS, lo que hace que sea más seguro. Para obtener información detallada acerca de los roles de IAM, vaya a Working with Roles en la IAM User Guide. User Data Los datos de usuario son los datos que se proporcionan al software de la aplicación que se ejecuta en la instancia EC2. El software de la aplicación puede obtener acceso a estos datos a través de Instance Meta Data Service (IMDS). Lanzamiento de una AMI desde AWS Explorer 4. Haga clic en Finalizar. 5. En AWS Explorer, bajo el nodo Amazon EC2, haga clic con el botón derecho en el subnodo Instances y seleccione Open EC2 Instances View. La instancia EC2 debe aparecer en la vista EC2 Instances. La transición de la instancia al estado running puede tardar unos minutos. Una vez que la instancia esté en ejecución, puede hacer clic con el botón derecho en ella para que aparezca un menú contextual con las operaciones que puede realizar en la instancia. Por ejemplo, puede terminar la instancia desde este menú. También puede copiar la dirección DNS pública de la instancia. Debe usar esta dirección para conectarse a la instancia por medio de SSH. Lista de instancias Amazon EC2 Administración de grupos de seguridad desde AWS Explorer AWS Toolkit for Eclipse le permite crear y configurar grupos de seguridad para su uso con las instancias Amazon Elastic Compute Cloud (Amazon EC2). Al lanzar una instancia Amazon EC2, tiene que especificar un grupo de seguridad asociado. Un grupo de seguridad actúa como un firewall para el tráfico de red entrante. El grupo de seguridad especifica qué tipos de tráfico de red se pueden recibir en una instancia Amazon EC2. También puede especificar que solo se aceptará el tráfico entrante procedente de determinadas direcciones IP o de otros grupos de seguridad especificados. Creación de un nuevo grupo de seguridad En esta sección, crearemos un nuevo grupo de seguridad. Inicialmente tras la creación, el grupo de seguridad no tendrá ningún permiso configurado. La configuración de permisos se realiza por medio de una operación adicional. Para crear nuevos grupos de seguridad En AWS Explorer, bajo el nodo Amazon EC2, haga clic con el botón derecho en Security Groups y, a continuación, haga clic en Open EC2 Security Groups View. Haga clic con el botón derecho en el panel izquierdo de la pestaña EC2 Security Groups y, a continuación, haga clic en New Group. 46

51 Adición de permisos a los grupos de seguridad 3. En el cuadro de diálogo, escriba un nombre y una descripción para el nuevo grupo de seguridad. Haga clic en OK. Adición de permisos a los grupos de seguridad En esta sección, añadiremos permisos al nuevo grupo de seguridad para permitir que otros equipos se conecten a la instancia Amazon EC2 mediante el protocolo Secure Shell (SSH). Para añadir permisos a un grupo de seguridad 1. Haga clic con el botón derecho en el panel derecho de la pestaña EC2 Security Groups y, a continuación, haga clic en Add Permissions. Invocar la interfaz de usuario de Add Permissions 2. En el cuadro de diálogo, seleccione Protocol, port and network. Haga clic en TCP en el menú desplegable Protocol. Escriba 22 para Port or Port Range. El puerto 22 es el puerto estándar para SSH. El cuadro Network Mask especifica las direcciones IP de origen permitidas en formato CIDR; el 47

52 Visualización y adición de notificaciones de Amazon SNS valor predeterminado es /0, que especifica que el grupo de seguridad permitirá una conexión TCP al puerto 22 (SSH) desde cualquier dirección IP externa. También puede, por ejemplo, especificar que las conexiones se permitan exclusivamente desde los equipos de la subred de su equipo local. En este caso, debería especificar la dirección IP de su equipo local seguida por "/10". Por ejemplo, "xxx.xxx.xxx.xxx/10", donde "xxx" corresponde a los diferentes valores de octeto que componen la dirección IP del equipo local. Haga clic en OK. También puede establecer permisos en el grupo de seguridad especificando un ID de usuario y un nombre de grupo de seguridad. En este caso, las instancias Amazon EC2 de este grupo de seguridad aceptarán todo el tráfico de red entrante procedente de instancias Amazon EC2 del grupo de seguridad especificado. También es necesario especificar el ID de usuario como una manera de desambiguar el nombre del grupo de seguridad; los nombres de los grupos de seguridad no tienen que ser únicos en todo AWS. Para obtener más información acerca de los grupos de seguridad, consulte Network and Security en la Amazon EC2 User Guide for Linux Instances. Visualización y adición de notificaciones de Amazon SNS Puede utilizar AWS Toolkit for Eclipse para ver los temas de Amazon Simple Notification Service (Amazon SNS) asociados a su aplicación. Amazon SNS es un servicio que permite a su aplicación enviar notificaciones a través de un protocolo como el de correo electrónico cuando se producen los eventos especificados. Para obtener más información acerca de Amazon SNS, consulte la Amazon SNS Developer Guide. Visualización de una notificación de Amazon SNS El siguiente proceso muestra los pasos para ver una notificación de Amazon SNS. Para ver una notificación 48

53 Adición de una notificación de Amazon SNS 1. En AWS Explorer, haga clic en el triángulo situado a la izquierda del nodo Amazon SNS para expandirlo y ver los temas de Amazon SNS que contiene. 2. Haga doble clic en el tema de SNS para abrir una vista detallada en el panel del editor de Eclipse. En este ejemplo, la columna Subscription ARN afirma que el tema está pendiente de confirmación. Amazon SNS requiere una confirmación de la persona especificada por la dirección de correo electrónico antes de que SNS envíe notificaciones por correo electrónico a esa persona. Adición de una notificación de Amazon SNS Puede añadir nuevas notificaciones de Amazon SNS a través de AWS Explorer. Para añadir una nueva notificación 1. En AWS Explorer, haga clic con el botón derecho en Amazon SNS y, a continuación, haga clic en Create New Topic. Escriba un nombre para el nuevo tema y, a continuación, haga clic en OK. 49

54 Conexión a Amazon Relational Database Service (Amazon RDS) 2. Haga doble clic en el nuevo tema para mostrar la vista detallada para el tema. Haga clic con el botón derecho en el área Subscriptions y, a continuación, haga clic en Create Subscription. Deje el cuadro Subscription Protocol como (plain text) y escriba una dirección de correo electrónico para el punto de enlace. Haga clic en OK. La vista de detalles de la notificación incluirá ahora esta suscripción. Seleccione el protocolo y el punto de enlace de la notificación. 3. Para eliminar la suscripción, haga clic con el botón derecho del ratón en la columna Protocol de la suscripción y haga clic en Delete Subscription. Note La creación de la suscripción hará que se envíe un correo electrónico de verificación a la persona especificada por la dirección de correo electrónico del "punto de enlace" de la suscripción. AWS solo utilizará esta dirección de correo electrónico para enviar notificaciones. No se usará con ningún otro fin ni en AWS ni en Amazon.com. Conexión a Amazon Relational Database Service (Amazon RDS) En esta sección, se usará AWS Toolkit for Eclipse para establecer conexión con una instancia de base de datos en Amazon Relational Database Service (Amazon RDS). Antes de completar el proceso que se describe a continuación, deberá disponer de una instancia de base de datos de RDS asociada con su cuenta de AWS. Puede crear una instancia de base de datos en RDS con la consola de administración de AWS. Cuando cree una instancia de base de datos, asigne al puerto TCP que la base de datos utiliza para recibir las conexiones un valor que sea accesible desde su ubicación. Por ejemplo, si está detrás de un firewall, elija un puerto TCP para que el firewall permita las conexiones. Para obtener más información, consulte la Amazon RDS User Guide. 1. En AWS Explorer, expanda el nodo Amazon RDS. Debería ver una lista de las instancias de bases de datos que están asociadas con su cuenta de AWS. Haga clic con el botón derecho en una de estas instancias y, a continuación, haga clic en Connect. Connect en el menú contextual de AWS Explorer 2. AWS Toolkit for Eclipse muestra un cuadro de diálogo de autenticación. Escriba la contraseña maestra que especificó cuando creó la instancia de la base de datos. Haga clic en Finalizar. Autenticar con respecto a la instancia de base de datos 3. AWS Toolkit for Eclipse abre la conexión a la instancia de base de datos en Eclipse Data Source Explorer. Aquí puede inspeccionar la estructura y los datos de la base de datos. Data Source Explorer 50

55 Identity and Access Management Identity and Access Management AWS Identity and Access Management (IAM) le permite controlar quiénes pueden obtener acceso a sus recursos de AWS y lo que pueden hacer con ellos. AWS Explorer le permite crear y administrar usuarios, grupos y roles de IAM. También puede definir una política de contraseñas para los usuarios, lo que le permite establecer los requisitos de la contraseña, como la longitud mínima, y especificar si los usuarios tienen permiso para cambiar sus propias contraseñas. Note Es una práctica recomendada para todos los usuarios, incluido el propietario de la cuenta, obtener acceso a los recursos de AWS como usuarios de IAM. De este modo, se garantiza que si las credenciales de uno de los usuarios de IAM se ven comprometidas, las credenciales afectadas se pueden revocar sin necesidad de cambiar las credenciales raíz de la cuenta. Acerca de AWS Identity and Access Management En lugar de compartir la contraseña y las credenciales de seguridad de su cuenta (el ID de clave de acceso y la clave de acceso secreta), puede crear usuarios de IAM que pueden tener sus propias contraseñas y credenciales de seguridad. A continuación, puede adjuntar políticas a los usuarios. En las políticas se especifican los permisos que determinan las acciones que puede llevar a cabo un usuario y los recursos a los que puede obtener acceso. Para mayor comodidad, en lugar de añadir políticas a los distintos usuarios, puede crear grupos de IAM (por ejemplo, administradores y desarrolladores), adjuntarles políticas y, a continuación, añadir usuarios a esos grupos. También puede crear roles que tengan políticas con permisos. Los roles se puede asignar a usuarios que están en otras cuentas, a servicios y a usuarios que no disponen de una identidad de IAM. Para obtener más información acerca de IAM, consulte la IAM User Guide. Creación de un usuario de IAM Puede crear usuarios de IAM para que otros miembros de su organización puedan tener su propia identidad de AWS. Para asignar permisos a un usuario de IAM, puede adjuntarle una política de IAM o asignar el usuario a un grupo. Los usuarios de IAM que están asignados a un grupo obtienen sus permisos de las políticas adjuntadas al grupo. Para obtener más información, consulte Creación de un grupo de IAM (p. 52) y Adición de un usuario de IAM a un grupo de IAM (p. 54). En el Toolkit, también puede generar credenciales de AWS (ID de clave de acceso y clave de acceso secreta) para el usuario de IAM. Para obtener más información, consulte Administración de credenciales para un usuario de IAM (p. 56). Para crear un usuario de IAM 1. En AWS Explorer, expanda el nodo AWS Identity and Access Management, haga clic con el botón derecho en el nodo Users y seleccione Create New Users. 51

56 Creación de un grupo de IAM 2. En el cuadro de diálogo Create New Users, escriba hasta cinco nombres de nuevos usuarios de IAM y, a continuación, haga clic en Finish. Para obtener información acerca de las restricciones de los nombres para los usuarios de IAM, consulte Limitations on IAM Entities en la IAM User Guide. Para obtener información acerca de la adición de un usuario a un grupo, consulte Adición de un usuario de IAM a un grupo de IAM (p. 54). Para obtener información acerca del procedimiento para crear una política y adjuntarla al usuario, consulte Adjuntar una política de IAM a un usuario, un grupo o un rol (p. 62). Creación de un grupo de IAM Puede añadir usuarios de IAM a los grupos para facilitar la administración de permisos. Los permisos que se adjuntan al grupo se aplican a todos los usuarios de ese grupo. Para obtener más información acerca de los grupos de IAM, consulte Working with Users and Groups en la IAM User Guide. Cuando cree un grupo, puede crear una política que incluya los permisos que tendrán los miembros del grupo. 52

57 Creación de un grupo de IAM Para crear un grupo de IAM 1. En AWS Explorer, expanda el nodo AWS Identity and Access Management, haga clic con el botón derecho en el nodo Groups y seleccione Create New Group. 2. Escriba un nombre para el nuevo grupo de IAM y, a continuación, haga clic en Next. 3. Escriba un nombre para la política que establece lo que los miembros del grupo pueden hacer. Especifique la política como un documento JSON y, a continuación, haga clic en OK. 53

58 Adición de un usuario de IAM a un grupo de IAM El nombre de la política debe ser único en su cuenta. El JSON especificado para la política se debe validar; de lo contrario, no se podrá guardar la política. Para obtener información acerca de la creación de una política, consulte Overview of Policies en la IAM User Guide. 4. Haga clic en Finalizar. Para obtener información acerca del procedimiento para adjuntar políticas adicionales al grupo de IAM, consulte Adjuntar una política de IAM a un usuario, un grupo o un rol (p. 62). Adición de un usuario de IAM a un grupo de IAM Si un usuario de IAM se añade a un grupo, las políticas que se han adjuntado al grupo también se aplicarán al usuario. Para obtener más información acerca de los usuarios de IAM, consulte Users and Groups en la IAM User Guide. Para agregar un usuario de IAM a un grupo de IAM 1. En AWS Explorer, expanda el nodo AWS Identity and Access Management, haga clic con el botón derecho en el nodo Groups y seleccione Open Groups Editor. Tenga en cuenta que los usuarios de IAM se añaden a los grupos de IAM en el nodo Groups de AWS Explorer y no en el nodo Users. 2. En el editor Groups, seleccione el grupo en el que desea añadir usuarios y, a continuación, haga clic en la pestaña Users. 54

59 Adición de un usuario de IAM a un grupo de IAM 3. En la parte derecha del panel inferior, haga clic en el botón Add Users. 4. En el cuadro de diálogo Add Users to Group, seleccione los usuarios que desea añadir y, a continuación, haga clic en OK. 55

60 Administración de credenciales para un usuario de IAM Administración de credenciales para un usuario de IAM Para cada usuario, puede añadir una contraseña. Los usuarios de IAM utilizan una contraseña para trabajar con los recursos de AWS en la Consola de administración de AWS. Para crear una contraseña para un usuario de IAM 1. En AWS Explorer, expanda el nodo AWS Identity and Access Management, haga clic con el botón derecho en el nodo Users y seleccione Open Users Editor. 2. En la lista de los usuarios, seleccione el usuario para el que desea crear una contraseña y, a continuación, haga clic en la pestaña Summary. 3. En la parte derecha del panel inferior, haga clic en el botón Update Password. 4. En el cuadro de diálogo Update User Password, escriba una contraseña y a continuación haga clic en OK. Note La nueva contraseña reemplazará a la contraseña existente. 56

61 Administración de credenciales para un usuario de IAM Para cada usuario también puede generar un conjunto de claves de acceso (un ID de clave de acceso y una clave de acceso secreta). Estas claves se pueden usar para representar el usuario para el acceso a AWS mediante programación; por ejemplo, para utilizar la interfaz de línea de comandos (CLI) de AWS, para firmar solicitudes de programación utilizando el SDK o para obtener acceso a los servicios de AWS a través del Toolkit. (Para obtener más información acerca de la especificación de credenciales para su uso con el Toolkit, consulte Configuración de credenciales de AWS (p. 4)). Para generar claves de acceso para un usuario de IAM 1. En AWS Explorer, expanda el nodo AWS Identity and Access Management, haga clic con el botón derecho en el nodo Users y seleccione Open Users Editor. 2. En la lista de los usuarios, seleccione el usuario para el que desea generar las claves y, a continuación, haga clic en la pestaña Summary. 3. Haga clic en el botón Manage Access Keys. Aparecerá una ventana en la que puede administrar las claves de acceso del usuario. 4. Haga clic en el botón Create Access Key. Se muestra el cuadro de diálogo Manage Access Key. 57

62 Administración de credenciales para un usuario de IAM 5. Haga clic en el botón Download para descargar un archivo de valores separados por comas (CSV) que contenga las credenciales generadas. Note Esta será su única oportunidad para ver y descargar estas claves de acceso. Si pierde estas claves, tendrá que eliminarlas y crear un nuevo conjunto de claves de acceso. Solo puede generar dos conjuntos de credenciales por cada usuario de IAM. Si ya tiene dos conjuntos de credenciales y necesita crear un conjunto adicional, debe eliminar primero uno de los conjuntos existentes. También puede desactivar credenciales. En ese caso, las credenciales siguen existiendo, pero todas las solicitudes a AWS que se realicen con esas credenciales generarán un error. Esto resulta útil si desea deshabilitar temporalmente el acceso a AWS para ese conjunto de credenciales. Puede volver a activar las credenciales que se han desactivado anteriormente. Para eliminar, desactivar o reactivar claves de acceso para un usuario de IAM 1. En AWS Explorer, expanda el nodo AWS Identity and Access Management, haga clic con el botón derecho en el nodo Users y seleccione Open Users Editor. 2. En la lista de los usuarios, seleccione el usuario para el que desea administrar las claves de acceso, haga clic en la pestaña Summary y, a continuación, haga clic en el botón Manage Access Keys. 3. En la ventana que muestra la lista de claves de acceso de ese usuario, haga clic con el botón derecho en las credenciales que desee administrar y, a continuación, elija una de las siguientes acciones: Delete Access Key Make Inactive Make Active 58

63 Creación de un rol de IAM Creación de un rol de IAM Con AWS Toolkit, puede crear roles de IAM. El rol puede ser asumido a continuación por las entidades a las que desea permitir el acceso a sus recursos de AWS. Las políticas adjuntadas al rol determinan quién puede asumir ese rol (la entidad de confianza o principal) y lo que esas entidades tienen permitido hacer. En el Toolkit, puede especificar las siguientes entidades de confianza: Un servicio de AWS. Por ejemplo, puede especificar que Amazon EC2 pueda llamar a otros servicios de AWS o que AWS Data Pipeline tenga permiso para administrar instancias Amazon EC2. Esto se conoce como rol de servicio. Una cuenta diferente de la suya. Si tiene varias cuentas de AWS, es posible que necesite permitir que los usuarios de una cuenta utilicen un rol para conseguir permisos para obtener acceso a recursos que se encuentran en otra de sus cuentas. Una cuenta de terceros. Es posible que permita que un tercero administre sus recursos de AWS. En ese caso, puede crear un rol en el que la entidad de confianza sea la cuenta de AWS de terceros. Después de especificar cuál es la entidad de confianza, puede seleccionar una política que determine lo que el rol tiene permitido hacer. Por ejemplo, puede crear un rol y adjuntarle una política que limite el acceso únicamente a uno de sus buckets de Amazon S3. A continuación, puede asociar el rol con una instancia Amazon EC2. Cuando una aplicación se ejecuta en la instancia Amazon EC2, puede obtener acceso únicamente al bucket de Amazon S3 al que se le ha proporcionado acceso en la política del rol. Para obtener más información acerca de los roles de IAM, consulte IAM Roles en la IAM User Guide. Para crear un rol de IAM 1. En AWS Explorer, expanda el nodo AWS Identity and Access Management, haga clic con el botón derecho en el nodo Roles y seleccione Create New Role. 59

64 Creación de un rol de IAM 2. Escriba un nombre para el rol de IAM y, a continuación, haga clic en Next. 3. Seleccione la entidad de confianza para el rol. Para crear un rol de servicio, seleccione AWS Service Roles y, a continuación, seleccione un rol de servicio en la lista desplegable. 60

65 Creación de un rol de IAM Para proporcionar acceso a un usuario que se ha definido en una cuenta de AWS diferente a la suya, seleccione Account ID y escriba el número de cuenta de AWS de la otra cuenta. Para proporcionar acceso a una cuenta de terceros, seleccione Account ID y escriba el número de cuenta de AWS de terceros. Si el tercero le ha proporcionado un ID externo, escríbalo también. 4. Haga clic en Next. 5. Escriba un nombre para la política que establece lo que el rol tiene permitido hacer. A continuación, especifique la política como un documento JSON y haga clic en OK. 61

66 Adjuntar una política de IAM a un usuario, un grupo o un rol El nombre de la política debe ser único en su cuenta. El JSON especificado para la política se debe validar; de lo contrario, no se podrá guardar la política. Para obtener información acerca de la creación de una política, consulte Overview of Policies en la guía Using IAM. 6. Haga clic en Finalizar. El nuevo rol de IAM aparece en el editor Roles. Para ver ejemplos que ilustran cómo obtener acceso a AWS mediante el rol de IAM asociado a una instancia Amazon EC2, consulte Using IAM Roles to Grant Access to AWS Resources en Amazon EC2 en la AWS Java Developer Guide. Adjuntar una política de IAM a un usuario, un grupo o un rol Las políticas son documentos que definen los permisos. Por ejemplo, una política que se ha adjuntado a un usuario puede especificar qué acciones de AWS puede invocar el usuario y en qué recursos puede realizar el usuario esas acciones. Si la política está adjuntada a un grupo, los permisos se aplican a los usuarios del grupo. Si la política está adjuntada a un rol, los permisos se aplican a quien asuma ese rol. El proceso para adjuntar una política a un usuario o a un grupo es similar. Para los roles, puede adjuntar una política que especifique lo que el rol tiene permitido hacer. Puede utilizar un proceso independiente 62

67 Adjuntar una política de IAM a un usuario, un grupo o un rol para adjuntar o editar la política que determina quién puede asumir el rol (es decir, administrar la relación de confianza). Note Si ha adjuntado una política a un usuario, un grupo o un rol anteriormente, puede utilizar ese procedimiento para adjuntar una política adicional. Para editar una política existente de un usuario, un grupo o un rol, utilice la consola de IAM, las herramientas de línea de comandos o las llamadas a la API. Para crear una política de IAM para un usuario, un grupo o un rol 1. En AWS Explorer, expanda el nodo AWS Identity and Access Management y haga doble clic en el nodo Groups, el nodo Users o el nodo Roles. 2. Seleccione el grupo, el usuario o el rol al que desea adjuntar la política y, a continuación, haga clic en la pestaña Permissions. 3. En la parte derecha del panel inferior, haga clic en el botón Attach Policy. 4. En los cuadros de diálogo Manage Group Policy, Manage User Policy o Manage Role Permissions, escriba un nombre para la política. A continuación, especifique la política como un documento JSON y haga clic en OK. 63

68 Adjuntar una política de IAM a un usuario, un grupo o un rol El nombre de la política debe ser único en su cuenta. El JSON especificado para la política se debe validar; de lo contrario, no se podrá guardar la política. Para obtener información acerca de la creación de una política, consulte Overview of IAM Policies en la IAM User Guide. Para crear o administrar una relación de confianza para un rol 1. En AWS Explorer, expanda el nodo AWS Identity and Access Management y haga doble clic en el nodo Roles. 2. En el editor Roles, seleccione el rol que desea administrar y, a continuación, haga clic en la pestaña Trust Relationships. 64

69 Definición de la política de contraseñas 3. En la parte derecha del panel inferior, haga clic en el botón Edit Trust Relationship. 4. En el cuadro de diálogo Edit Trust Relationship, edite el documento JSON de la política y haga clic en OK. Definición de la política de contraseñas En AWS Toolkit for Eclipse puede definir una política de contraseñas para su cuenta. Esto le permite asegurarse de que las contraseñas que se crean para los usuarios de IAM siguen determinadas pautas de longitud y complejidad. También le permite especificar si los usuarios pueden cambiar sus propias contraseñas. Para obtener más información, consulte Managing an IAM Password Policy en la IAM User Guide. Para crear una política de IAM para un usuario o un grupo 1. En AWS Explorer, en Identity and Access Management, haga doble clic en el nodo Password Policy. 2. En el panel Password Policy, especifique las opciones de política que desea aplicar en su cuenta de AWS y, a continuación, haga clic en Apply Password Policy. 65

70 Definición de la política de contraseñas 66