AWS Command Line Interface y tutorial de aws-shell para AWS Cloud9

Este tutorial le permite configurar AWS Command Line Interface (AWS CLI), el aws-shell o ambos en un entorno de desarrollo de AWS Cloud9. AWS CLI y aws-shell son herramientas unificadas que proporcionan una interfaz uniforme para interactuar con todas las partes de AWS. Puede utilizar la AWS CLI en lugar de la AWS Management Console para ejecutar comandos rápidamente para interactuar con AWS. Algunos de estos comandos solo se pueden ejecutar con la AWS CLI o bien con AWS CloudShell.

Para obtener más información sobre AWS CLI, consulte la Guía del usuario de AWS Command Line Interface. Para el aws-shell, consulte los recursos siguientes:

• aws-shell en el sitio web de GitHub

• aws-shell en el sitio web de pip

Para obtener una lista de comandos que puede ejecutar con AWS CLI para interactuar con AWS, consulte la Referencia de los comandos de AWS CLI. Puede utilizar los mismos comandos con AWS CloudShell, salvo que los inicie sin el prefijo aws.

La creación de esta muestra puede generar cargos en su cuenta de AWS. Entre estos se incluyen posibles cargos por servicios como Amazon EC2 y Amazon S3. Para obtener más información, consulte Precios de Amazon EC2 y Precios de Amazon S3.

Requisitos previos

Antes de utilizar este ejemplo, asegúrese de que su configuración cumpla los siguientes requisitos:

• Debe tener un entorno de desarrollo de AWS Cloud9 EC2. En este ejemplo, se da por hecho que ya tiene un entorno de EC2 que está conectado a una instancia de Amazon EC2 que ejecuta Amazon Linux o Ubuntu Server. Si tiene otro tipo de entorno o sistema operativo, es posible que tenga que adaptar las instrucciones de este ejemplo para configurar herramientas relacionadas. Para obtener más información, consulte Creación de un entorno en AWS Cloud9.

• Ya tiene abierto el IDE de AWS Cloud9 para el entorno existente. Al abrir un entorno, AWS Cloud9 abre el IDE de ese entorno en el navegador web. Para obtener más información, consulte Apertura de un entorno en AWS Cloud9.

Paso 1: Instalar AWS CLI, aws-shell o ambos en el entorno

En este paso, utilizará el IDE de AWS Cloud9 para instalar AWS CLI, aws-shell o ambos en su entorno a fin de poder ejecutar comandos para interactuar con AWS.

Si utiliza un entorno de desarrollo de AWS Cloud9 EC2 y solo desea utilizar AWS CLI, puede pasar directamente a Paso 3: Ejecutar comandos básicos con AWS CLI o aws-shell en su entorno. Esto se debe a que AWS CLI ya está instalado en un entorno de EC2 y ya hay un conjunto de credenciales de acceso de AWS configurado en el entorno. Para obtener más información, consulte AWS credenciales temporales gestionadas.

Si no utiliza un entorno de EC2, siga estos pasos para instalar AWS CLI:

1. Con el entorno abierto, en el IDE, verifique si AWS CLI ya está instalado. En el terminal, ejecute el comando aws --version . (Para iniciar una nueva sesión del terminal, en la barra de menús, seleccione Window [Ventana], New Terminal [Nuevo terminal]). Si AWS CLI ya está instalado, aparece el número de versión con información como los números de versión de Python y el número de versión del sistema operativo de la instancia de Amazon EC2 o su propio servidor. Si la AWS CLI está instalada, continúe en Paso 2: Configurar la administración de credenciales en su entorno.

2. Para instalar AWS CLI, consulte Instalación de AWS Command Line Interface en la Guía del usuario de AWS Command Line Interface. Por ejemplo, en el caso de un entorno de EC2 que ejecute Amazon Linux, ejecute estos tres comandos en el terminal, de uno en uno, para instalar AWS CLI.

   sudo yum -y update          # Install the latest system updates.
   sudo yum -y install aws-cli # Install the AWS CLI.
   aws --version               # Confirm the AWS CLI was installed.

   En el caso de un entorno de EC2 que ejecute Ubuntu Server, ejecute estos tres comandos en el terminal en su lugar, de uno en uno, para instalar AWS CLI.

   sudo apt update             # Install the latest system updates.
   sudo apt install -y awscli  # Install the AWS CLI.
   aws --version               # Confirm the AWS CLI was installed.

Si desea instalar el aws-shell, siga estos pasos:

1. Con el entorno abierto, en el IDE, verifique si aws-shell ya está instalado. En el terminal, ejecute el comando aws-shell . (Para iniciar una nueva sesión del terminal, en la barra de menús, seleccione Window [Ventana], New Terminal [Nuevo terminal]). Si el aws-shell está instalado, se muestra el símbolo de aws>. Si el aws-shell está instalado, continúe en Paso 2: Configurar la administración de credenciales en su entorno.

2. Para instalar el aws-shell, utilice pip. Para ello, debe tener instalado Python.

   Para verificar si Python ya está instalado (y para instalarlo si es necesario), siga las instrucciones de Paso 1: Instalar Python en la Muestra de Python y, a continuación, vuelva a este tema.

   Para comprobar si pip ya está instalado, en el terminal, ejecute el comando pip --version . Si lo está, aparece el número de versión. Si pip no está instalado, instálelo ejecutando estos tres comandos, de uno en uno, en el terminal.

   wget https://bootstrap.pypa.io/get-pip.py # Get the pip install file.
   sudo python get-pip.py                    # Install pip. (You might need to run 'sudo python2 get-pip.py' or 'sudo python3 get-pip.py' instead, depending on how Python is installed.)
   rm get-pip.py                             # Delete the pip install file, as it is no longer needed.

3. Para utilizar pip para instalar el aws-shell, ejecute el siguiente comando.

   sudo pip install aws-shell

Paso 2: Configurar la administración de credenciales en su entorno

Cada vez que utilice la AWS CLI o el aws-shell para llamar a un servicio de AWS, debe proporcionar un conjunto de credenciales con la llamada. Estas credenciales determinan si la AWS CLI o el aws-shell tienen los permisos adecuados para realizar esa llamada. Si las credenciales no cubren los permisos adecuados, la llamada no se realizará correctamente.

Si utiliza un entorno de desarrollo de EC2 de AWS Cloud9, puede avanzar hasta Paso 3: Ejecutar comandos básicos con AWS CLI o aws-shell en su entorno. Esto se debe a que las credenciales ya están configuradas en un entorno de EC2. Para obtener más información, consulte AWS credenciales temporales gestionadas.

Si no utiliza un entorno de EC2, debe almacenar manualmente sus credenciales en el entorno. Para ello, siga las instrucciones de Llamar a los Servicios de AWS desde un entorno en AWS Cloud9 y, a continuación, vuelva a este tema.

Paso 3: Ejecutar comandos básicos con AWS CLI o aws-shell en su entorno

En este paso, utilizará AWS CLI o aws-shell en su entorno para crear un bucket en Amazon S3, ver los buckets disponibles y, a continuación, eliminar el bucket.

1. Si desea utilizar el aws-shell pero aún no lo ha iniciado, inicie el aws-shell ejecutando el comando aws-shell. Se muestra el símbolo aws>.

2. Crear un bucket. Ejecute el comando aws s3 mb con AWS CLI o el comando s3 mb con aws-shell y especifique el nombre del bucket que se va a crear. En este ejemplo, utilizamos un bucket denominado cloud9-123456789012-bucket, donde 123456789012 es su ID de cuenta de AWS. Si usa otro nombre, sustitúyalo en todo este paso.

   aws s3 mb s3://cloud9-123456789012-bucket # For the AWS CLI.
   s3 mb s3://cloud9-123456789012-bucket     # For the aws-shell.

   nota

   Los nombres de bucket deben ser únicos en todo AWS, no solo en la cuenta de AWS. El nombre del bucket sugerido anterior puede ayudarle a crear un nombre de bucket único. Si recibe un mensaje que contiene el error BucketAlreadyExists, debe ejecutar el comando de nuevo con otro nombre de bucket.

3. Enumere los buckets disponibles. Ejecute el comando aws s3 ls con AWS CLI o el comando s3 ls con aws-shell. Se muestra una lista de los buckets disponibles.

4. Elimine el bucket. Ejecute el comando aws s3 rb con AWS CLI o el comando s3 rb con aws-shell y especifique el nombre del bucket que se va a eliminar.

   aws s3 rb s3://cloud9-123456789012-bucket # For the AWS CLI.
   s3 rb s3://cloud9-123456789012-bucket     # For the aws-shell.

   Para confirmar si el bucket se ha eliminado, ejecute de nuevo el comando aws s3 ls con AWS CLI o el comando s3 ls con aws-shell. El nombre del bucket que se haya eliminado no debería aparecer ya en la lista.

   nota

   No es necesario eliminar el bucket si desea seguir utilizándolo. Para obtener más información, consulte Add an Object to a Bucket (Adición de un objeto a un bucket) en la Guía del usuario de Amazon Simple Storage Service. Consulte también Comandos de S3 en Referencia de los comandos de AWS CLI. (Recuerde que si no elimina el bucket, podrían producirse cargos continuos en su cuenta de AWS).

Para continuar experimentando con AWS CLI, consulte Trabajar con Amazon Web Services en la Guía del usuario de AWS Command Line Interface y en Referencia de los comandos de AWS CLI. Para continuar experimentando con aws-shell, consulte Referencia de los comandos de AWS CLI y tenga en cuenta que debe iniciar los comandos sin el prefijo aws.

Paso 4: Limpiar

Si utiliza el shell de AWS, puede dejar de utilizarlo ejecutando el comando .exit o .quit .

Para evitar que se apliquen cargos continuos en su cuenta de AWS después de terminar de usar esta muestra, debe eliminar el entorno. Para obtener más información, consulte Eliminación de un entorno en AWS Cloud9.