Instalación, actualización y desinstalación de la versión 2 de la AWS CLI en Linux - AWS Command Line Interface

Python 2.7, 3.4 y 3.5 están obsoletas para la versión 1 de AWS CLI. Para obtener más información, consulte la sección de la versión 1 de AWS CLI de Acerca de las versiones de AWS CLI.

Instalación, actualización y desinstalación de la versión 2 de la AWS CLI en Linux

En esta sección se describe cómo instalar, actualizar y eliminar la versión 2 de la AWS CLI en Linux o Unix. La versión 2 de la AWS CLI no tiene dependencias de otros paquetes de Python. Tiene una copia propia incrustada de Python incluida en el instalador.

importante

Las versiones 1 y 2 de la AWS CLI utilizan el mismo nombre de comando de aws. Si tiene ambas versiones instaladas, el equipo utiliza la primera que encuentra en la ruta de búsqueda. Si ha instalado la versión 1 de la AWS CLI anteriormente, le recomendamos que realice una de las siguientes acciones para usar la versión 2 de la AWS CLI:

  • Recomendado: desinstale la versión 1 de la AWS CLI y use solo la versión 2 de la AWS CLI. Para obtener instrucciones de desinstalación, determine el método utilizado para instalar la versión 1 de la AWS CLI y siga las instrucciones de desinstalación adecuadas para su sistema operativo en Instalación, actualización y desinstalación de la versión 1 de la AWS CLI

  • Utilice la capacidad de su sistema operativo para crear un enlace simbólico (symlink) o alias con un nombre diferente para uno de los dos comandos de aws. Por ejemplo, puede usar un enlace simbólico o alias en Linux y macOS, o DOSKEY en Windows.

Para obtener información sobre los cambios notorios entre la versión 1 y la versión 2, consulte Cambios bruscos: migración desde la versión 1 a versión 2 de la AWS CLI.

Requisitos previos para Linux

  • Debe poder extraer o “descomprimir” el paquete descargado. Si su sistema operativo no tiene el comando unzip integrado, utilice un equivalente.

  • La versión 2 de la AWS CLI utiliza glibc, groff y less. Estos se incluyen de forma predeterminada en la mayoría de las distribuciones principales de Linux.

  • Admitimos la versión 2 de la AWS CLI en versiones de 64 bits de las distribuciones recientes de CentOS, Fedora, Ubuntu, Amazon Linux 1 y Amazon Linux 2.

  • Admitimos la versión 2 de la AWS CLI en Linux ARM de 64 bits.

  • Debido a que AWS no mantiene repositorios de terceros, no podemos garantizar que contengan la última versión de AWS CLI.

Instalación de la versión 2 de la AWS CLI en Linux.

Siga estos pasos desde la línea de comandos para instalar la AWS CLI en Linux.

Proporcionamos los pasos en un grupo fácil de copiar y pegar basado en si usa Linux de 64 bits o Linux ARM. Consulte las descripciones de cada línea en los pasos que se indican a continuación.

Linux x86 (64-bit)

Para obtener la última versión de la AWS CLI, utilice el siguiente bloque de comandos.

$ curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip" -o "awscliv2.zip" unzip awscliv2.zip sudo ./aws/install

Para una versión específica de la AWS CLI, agregue un guión y el número de versión al nombre del archivo. Para este ejemplo, el nombre de archivo de la versión 2.0.30 sería awscli-exe-linux-x86_64-2.0.30.zip lo que resultaría en el siguiente comando:

$ curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64-2.0.30.zip" -o "awscliv2.zip" unzip awscliv2.zip sudo ./aws/install

Para obtener una lista de las versiones, consulte el registro de cambios de la versión 2 de la AWS CLI en GitHub.

Linux ARM

Para obtener la última versión de la AWS CLI, utilice el siguiente bloque de comandos:

$ curl "https://awscli.amazonaws.com/awscli-exe-linux-aarch64.zip" -o "awscliv2.zip" unzip awscliv2.zip sudo ./aws/install

Para una versión específica de la AWS CLI, agregue un guión y el número de versión al nombre del archivo. Para este ejemplo, el nombre de archivo de la versión 2.0.30 sería awscli-exe-linux-aarch64-2.0.30.zip lo que resultaría en el siguiente comando:

$ curl "https://awscli.amazonaws.com/awscli-exe-linux-aarch64-2.0.30.zip" -o "awscliv2.zip" unzip awscliv2.zip sudo ./aws/install

Para obtener una lista de las versiones, consulte el registro de cambios de la versión 2 de la AWS CLI en GitHub.

  1. Descargue el archivo de instalación de una de las siguientes maneras:

    • Use el comando curl: la opción -o especifica el nombre de archivo en el que se escribe el paquete descargado. Las opciones del comando de ejemplo siguiente escriben el archivo descargado en el directorio actual con el nombre local awscliv2.zip.

      Linux x86 (64-bit)

      Para la versión actual de la AWS CLI, use el siguiente comando:

      $ curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip" -o "awscliv2.zip"

      Para una versión específica de la AWS CLI, agregue un guión y el número de versión al nombre del archivo. Para este ejemplo, el nombre de archivo de la versión 2.0.30 sería awscli-exe-linux-x86_64-2.0.30.zip lo que resultaría en el siguiente comando:

      $ curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64-2.0.30.zip" -o "awscliv2.zip"

      Para obtener una lista de las versiones, consulte el registro de cambios de la versión 2 de la AWS CLI en GitHub.

      Linux ARM

      Para la versión actual de la AWS CLI, use el siguiente comando:

      $ curl "https://awscli.amazonaws.com/awscli-exe-linux-aarch64.zip" -o "awscliv2.zip"

      Para una versión específica de la AWS CLI, agregue un guión y el número de versión al nombre del archivo. Para este ejemplo, el nombre de archivo de la versión 2.0.30 sería awscli-exe-linux-aarch64-2.0.30.zip lo que resultaría en el siguiente comando:

      $ curl "https://awscli.amazonaws.com/awscli-exe-linux-aarch64-2.0.30.zip" -o "awscliv2.zip"

      Para obtener una lista de las versiones, consulte el registro de cambios de la versión 2 de la AWS CLI en GitHub.

    • Descarga de desde la URL: para descargar el instalador con su navegador, utilice una de las siguientes direcciones URL. Puede verificar la integridad y autenticidad del archivo de instalación descargado antes de extraer (descomprimir) el paquete. Para obtener más información, consulte Verificación de la integridad y autenticidad de los archivos de instalador descargados.

      Linux x86 (64-bit)

      Para obtener la última versión de la AWS CLI: https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip

      Para una versión específica de la AWS CLI, agregue un guión y el número de versión al nombre del archivo. Para este ejemplo, el nombre de archivo de la versión 2.0.30 sería awscli-exe-linux-x86_64-2.0.30.zip lo que da como resultado el siguiente url: https://awscli.amazonaws.com/awscli-exe-linux-x86_64-2.0.30.zip

      Para obtener una lista de las versiones, consulte el registro de cambios de la versión 2 de la AWS CLI en GitHub.

      Linux ARM

      Para obtener la última versión de la AWS CLI: https://awscli.amazonaws.com/awscli-exe-linux-aarch64.zip

      Para una versión específica de la AWS CLI, agregue un guión y el número de versión al nombre del archivo. Para este ejemplo, el nombre de archivo de la versión 2.0.30 sería awscli-exe-linux-aarch64-2.0.30.zip lo que da como resultado el siguiente url: https://awscli.amazonaws.com/awscli-exe-linux-aarch64-2.0.30.zip

      Para obtener una lista de las versiones, consulte el registro de cambios de la versión 2 de la AWS CLI en GitHub.

  2. (Opcional) Verifique la integridad del archivo zip siguiendo los pasos de Verificación de la integridad y autenticidad de los archivos de instalador descargados.

  3. Descomprima el instalador. Si su distribución de Linux no tiene un comando unzip integrado, use un equivalente para descomprimirlo. El siguiente comando de ejemplo descomprime el paquete y crea un directorio denominado aws en el directorio actual.

    $ unzip awscliv2.zip
  4. Ejecute el programa de instalación. El comando de instalación utiliza un archivo denominado install en el directorio aws recién descomprimido. De forma predeterminada, todos los archivos se instalan en /usr/local/aws-cli y se crea un enlace simbólico en /usr/local/bin. El comando incluye sudo para conceder permisos de escritura en esos directorios.

    $ sudo ./aws/install

    Puede realizar la instalación sin sudo si especifica directorios en los que ya tiene permisos de escritura. Utilice las siguientes instrucciones en el comando install para especificar la ubicación de instalación:

    • Asegúrese de que las rutas que proporcione a los parámetros -i y -b no contengan nombres de volumen ni nombres de directorio que contengan caracteres de espacio u otros caracteres de espacio en blanco. Si hay un espacio, la instalación falla.

    • --install-dir o -i: esta opción especifica el directorio en la que se copiarán todos los archivos.

      El valor predeterminado es /usr/local/aws-cli.

    • --bin-dir o -b: esta opción especifica que el programa de aws principal del directorio de instalación está vinculado de forma simbólica al archivo aws en la ruta de acceso especificada. Debe tener permisos de escritura en el directorio especificado. Al crear un enlace simbólico a un directorio que ya está en su ruta, se elimina la necesidad de agregar el directorio de instalación a la variable $PATH del usuario.

      El valor predeterminado es /usr/local/bin.

    $ ./aws/install -i /usr/local/aws-cli -b /usr/local/bin
  5. Confirme la instalación con el siguiente comando. Si el comando de aws no se encuentra, es posible que deba reiniciar el terminal.

    $ aws --version aws-cli/2.1.29 Python/3.7.4 Linux/4.14.133-113.105.amzn2.x86_64 botocore/2.0.0

Actualice la versión 2 de la AWS CLI en Linux

Para actualizar su copia de la versión 2 de la AWS CLI, desde la línea de comandos de Linux, siga estos pasos.

  1. Descargue el archivo de instalación de una de las siguientes maneras:

    Uso del comando curl: las opciones del comando de ejemplo siguiente escriben el archivo descargado en el directorio actual con el nombre local awscliv2.zip.

    En este ejemplo, la opción -o especifica el nombre de archivo en el que se escribe el paquete descargado. En este ejemplo, el archivo se escribe awscliv2.zip en el directorio actual.

    Linux x86 (64-bit)

    Para obtener la última versión de la AWS CLI, utilice el siguiente bloque de comandos.

    $ curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip" -o "awscliv2.zip"

    Para una versión específica de la AWS CLI, agregue un guión y el número de versión al nombre del archivo. Para este ejemplo, el nombre de archivo de la versión 2.0.30 sería awscli-exe-linux-x86_64-2.0.30.zip lo que resultaría en el siguiente comando:

    $ curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64-2.0.30.zip" -o "awscliv2.zip"

    Para obtener una lista de las versiones, consulte el registro de cambios de la versión 2 de la AWS CLI en GitHub.

    Linux ARM

    Para obtener la última versión de la AWS CLI, utilice el siguiente bloque de comandos:

    $ curl "https://awscli.amazonaws.com/awscli-exe-linux-aarch64.zip" -o "awscliv2.zip"

    Para una versión específica de la AWS CLI, agregue un guión y el número de versión al nombre del archivo. Para este ejemplo, el nombre de archivo de la versión 2.0.30 sería awscli-exe-linux-aarch64-2.0.30.zip lo que resultaría en el siguiente comando:

    $ curl "https://awscli.amazonaws.com/awscli-exe-linux-aarch64-2.0.30.zip" -o "awscliv2.zip"

    Para obtener una lista de las versiones, consulte el registro de cambios de la versión 2 de la AWS CLI en GitHub.

    Descarga de desde la URL: para descargar el instalador mediante el navegador, utilice una de las direcciones URL siguientes. Puede verificar la integridad y autenticidad del archivo de instalación después de descargarlo. Para obtener más información antes de descomprimir el paquete, consulte Verificación de la integridad y autenticidad de los archivos de instalador descargados.

    Linux x86 (64-bit)

    Para obtener la última versión de la AWS CLI: https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip

    Para obtener una versión específica de la AWS CLI: agregue un guión y el número de versión al nombre del archivo. Para este ejemplo, el nombre de archivo de la versión 2.0.30 sería awscli-exe-linux-x86_64-2.0.30.zip lo que da como resultado el siguiente enlace https://awscli.amazonaws.com/awscli-exe-linux-x86_64-2.0.30.zip. Para obtener una lista de las versiones, consulte el registro de cambios de la versión 2 de la AWS CLI en GitHub.

    Linux ARM

    Para obtener la última versión de la AWS CLI: https://awscli.amazonaws.com/awscli-exe-linux-aarch64.zip

    Para obtener una versión específica de la AWS CLI: agregue un guión y el número de versión al nombre del archivo. Para este ejemplo, el nombre de archivo de la versión 2.0.30 sería awscli-exe-linux-aarch64-2.0.30.zip lo que da como resultado el siguiente enlace https://awscli.amazonaws.com/awscli-exe-linux-aarch64-2.0.30.zip. Para obtener una lista de las versiones, consulte el registro de cambios de la versión 2 de la AWS CLI en GitHub.

  2. Descomprima el instalador. Si su distribución de Linux no tiene un comando unzip integrado, use un equivalente para instalarlo. El siguiente comando de ejemplo descomprime el paquete y crea un directorio denominado aws en el directorio actual.

    $ unzip awscliv2.zip
  3. Para asegurarse de que la actualización se instala en la misma ubicación que la versión 2 de la AWS CLI actual, busque el enlace simbólico y el directorio de instalación existentes.

    • Utilice el comando which para buscar el enlace simbólico. Esto le dará la ruta que puede utilizar con el parámetro --bin-dir.

      $ which aws /usr/local/bin/aws
    • Utilice el comando ls para buscar el directorio al que apunta el enlace simbólico. Esto le dará la ruta que puede utilizar con el parámetro --install-dir.

      $ ls -l /usr/local/bin/aws lrwxrwxrwx 1 ec2-user ec2-user 49 Oct 22 09:49 /usr/local/bin/aws -> /usr/local/aws-cli/v2/current/bin/aws
  4. Utilice la información del enlace simbólico y del instalador para construir el comando install con el parámetro --update.

    $ sudo ./aws/install --bin-dir /usr/local/bin --install-dir /usr/local/aws-cli --update
  5. Confirme la instalación.

    $ aws --version aws-cli/2.1.29 Python/3.7.4 Linux/4.14.133-113.105.amzn2.x86_64 botocore/2.0.0

Desinstalación de la versión 2 de la AWS CLI en Linux

Para desinstalar la versión 2 de la AWS CLI, ejecute los siguientes comandos.

  1. Busque el enlace simbólico y las rutas de instalación.

    • Utilice el comando which para encontrar el enlace simbólico. Se muestra la ruta que utilizó con el parámetro --bin-dir.

      $ which aws /usr/local/bin/aws
    • Utilice el comando ls para buscar el directorio al que apunta el enlace simbólico. Esto le da la ruta que utilizó con el parámetro --install-dir.

      $ ls -l /usr/local/bin/aws lrwxrwxrwx 1 ec2-user ec2-user 49 Oct 22 09:49 /usr/local/bin/aws -> /usr/local/aws-cli/v2/current/bin/aws
  2. Elimine los dos enlaces simbólicos del directorio --bin-dir. Si su cuenta de usuario tiene permiso de escritura en estos directorios, no es necesario que utilice sudo.

    $ sudo rm /usr/local/bin/aws $ sudo rm /usr/local/bin/aws_completer
  3. Elimine directorio --install-dir. Si su cuenta de usuario tiene permiso de escritura en este directorio, no es necesario que utilice sudo.

    $ sudo rm -rf /usr/local/aws-cli

Verificación de la integridad y autenticidad de los archivos de instalador descargados

Los archivos .zip del paquete del instalador de la versión 2 de la AWS CLI están firmados criptográficamente mediante firmas PGP. Puede seguir los pasos indicados a continuación para verificar las firmas con la herramienta GnuPG. Si hay algún tipo de daño o alteración en los archivos, esta verificación produce un error, por lo que no debería continuar con la instalación.

En el siguiente ejemplo, se supone que ha descargado el paquete del instalador y lo ha guardado localmente como awscliv2.zip. Si le ha asignado otro nombre, sustituya ese nombre en los pasos siguientes.

Para validar los archivos mediante la firma PGP

  1. Descargue e instale el comando gpg usando su administrador de paquetes. Para obtener más información acerca de GnuPG, consulte el sitio web de GnuPG.

  2. Para crear el archivo de clave pública, cree un archivo de texto y pegue el siguiente texto en él:

    -----BEGIN PGP PUBLIC KEY BLOCK----- mQINBF2Cr7UBEADJZHcgusOJl7ENSyumXh85z0TRV0xJorM2B/JL0kHOyigQluUG ZMLhENaG0bYatdrKP+3H91lvK050pXwnO/R7fB/FSTouki4ciIx5OuLlnJZIxSzx PqGl0mkxImLNbGWoi6Lto0LYxqHN2iQtzlwTVmq9733zd3XfcXrZ3+LblHAgEt5G TfNxEKJ8soPLyWmwDH6HWCnjZ/aIQRBTIQ05uVeEoYxSh6wOai7ss/KveoSNBbYz gbdzoqI2Y8cgH2nbfgp3DSasaLZEdCSsIsK1u05CinE7k2qZ7KgKAUIcT/cR/grk C6VwsnDU0OUCideXcQ8WeHutqvgZH1JgKDbznoIzeQHJD238GEu+eKhRHcz8/jeG 94zkcgJOz3KbZGYMiTh277Fvj9zzvZsbMBCedV1BTg3TqgvdX4bdkhf5cH+7NtWO lrFj6UwAsGukBTAOxC0l/dnSmZhJ7Z1KmEWilro/gOrjtOxqRQutlIqG22TaqoPG fYVN+en3Zwbt97kcgZDwqbuykNt64oZWc4XKCa3mprEGC3IbJTBFqglXmZ7l9ywG EEUJYOlb2XrSuPWml39beWdKM8kzr1OjnlOm6+lpTRCBfo0wa9F8YZRhHPAkwKkX XDeOGpWRj4ohOx0d2GWkyV5xyN14p2tQOCdOODmz80yUTgRpPVQUtOEhXQARAQAB tCFBV1MgQ0xJIFRlYW0gPGF3cy1jbGlAYW1hem9uLmNvbT6JAlQEEwEIAD4WIQT7 Xbd/1cEYuAURraimMQrMRnJHXAUCXYKvtQIbAwUJB4TOAAULCQgHAgYVCgkICwIE FgIDAQIeAQIXgAAKCRCmMQrMRnJHXJIXEAChLUIkg80uPUkGjE3jejvQSA1aWuAM yzy6fdpdlRUz6M6nmsUhOExjVIvibEJpzK5mhuSZ4lb0vJ2ZUPgCv4zs2nBd7BGJ MxKiWgBReGvTdqZ0SzyYH4PYCJSE732x/Fw9hfnh1dMTXNcrQXzwOmmFNNegG0Ox au+VnpcR5Kz3smiTrIwZbRudo1ijhCYPQ7t5CMp9kjC6bObvy1hSIg2xNbMAN/Do ikebAl36uA6Y/Uczjj3GxZW4ZWeFirMidKbtqvUz2y0UFszobjiBSqZZHCreC34B hw9bFNpuWC/0SrXgohdsc6vK50pDGdV5kM2qo9tMQ/izsAwTh/d/GzZv8H4lV9eO tEis+EpR497PaxKKh9tJf0N6Q1YLRHof5xePZtOIlS3gfvsH5hXA3HJ9yIxb8T0H QYmVr3aIUes20i6meI3fuV36VFupwfrTKaL7VXnsrK2fq5cRvyJLNzXucg0WAjPF RrAGLzY7nP1xeg1a0aeP+pdsqjqlPJom8OCWc1+6DWbg0jsC74WoesAqgBItODMB rsal1y/q+bPzpsnWjzHV8+1/EtZmSc8ZUGSJOPkfC7hObnfkl18h+1QtKTjZme4d H17gsBJr+opwJw/Zio2LMjQBOqlm3K1A4zFTh7wBC7He6KPQea1p2XAMgtvATtNe YLZATHZKTJyiqA== =vYOk -----END PGP PUBLIC KEY BLOCK-----

    Como referencia, a continuación se indican los detalles de la clave pública.

    Key ID: A6310ACC4672 Type: RSA Size: 4096/4096 Created: 2019-09-18 Expires: 2023-09-17 User ID: AWS CLI Team <aws-cli@amazon.com> Key fingerprint: FB5D B77F D5C1 18B8 0511 ADA8 A631 0ACC 4672 475C
  3. Importe la clave pública de la AWS CLI con el siguiente comando, sustituyendo public-key-file-name por el nombre del archivo de la clave pública que ha creado.

    $ gpg --import public-key-file-name gpg: /home/username/.gnupg/trustdb.gpg: trustdb created gpg: key A6310ACC4672475C: public key "AWS CLI Team <aws-cli@amazon.com>" imported gpg: Total number processed: 1 gpg: imported: 1
  4. Descargue el archivo de firma de la AWS CLI del paquete que descargó. Tiene la misma ruta y el mismo nombre que el archivo .zip al que corresponde, pero con la extensión .sig. En los siguientes ejemplos, lo guardaremos en el directorio actual como un archivo llamado awscliv2.sig.

    Linux x86 (64-bit)

    Para obtener la última versión de la AWS CLI, utilice el siguiente bloque de comandos.

    $ curl -o awscliv2.sig https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip.sig

    Para una versión específica de la AWS CLI, agregue un guión y el número de versión al nombre del archivo. Para este ejemplo, el nombre de archivo de la versión 2.0.30 sería awscli-exe-linux-x86_64-2.0.30.zip.sig lo que resultaría en el siguiente comando:

    $ curl -o awscliv2.sig https://awscli.amazonaws.com/awscli-exe-linux-x86_64-2.0.30.zip.sig

    Para obtener una lista de las versiones, consulte el registro de cambios de la versión 2 de la AWS CLI en GitHub.

    Linux ARM

    Para obtener la última versión de la AWS CLI, utilice el siguiente bloque de comandos:

    $ curl -o awscliv2.sig https://awscli.amazonaws.com/awscli-exe-linux-aarch64.zip.sig

    Para una versión específica de la AWS CLI, agregue un guión y el número de versión al nombre del archivo. Para este ejemplo, el nombre de archivo de la versión 2.0.30 sería awscli-exe-linux-aarch64-2.0.30.zip.sig lo que resultaría en el siguiente comando:

    $ curl -o awscliv2.sig https://awscli.amazonaws.com/awscli-exe-linux-aarch64-2.0.30.zip.sig

    Para obtener una lista de las versiones, consulte el registro de cambios de la versión 2 de la AWS CLI en GitHub.

  5. Verifique la firma pasando los nombres de archivo .sig y .zip como parámetros al comando gpg.

    $ gpg --verify awscliv2.sig awscliv2.zip

    El resultado debería tener parecerse al siguiente:

    gpg: Signature made Mon Nov 4 19:00:01 2019 PST gpg: using RSA key FB5D B77F D5C1 18B8 0511 ADA8 A631 0ACC 4672 475C gpg: Good signature from "AWS CLI Team <aws-cli@amazon.com>" [unknown] gpg: WARNING: This key is not certified with a trusted signature! gpg: There is no indication that the signature belongs to the owner. Primary key fingerprint: FB5D B77F D5C1 18B8 0511 ADA8 A631 0ACC 4672 475C
    importante

    Se espera la advertencia en la salida y ello no indica un problema. Esto se produce porque no existe una cadena de confianza entre su clave PGP personal (si es su caso) y la clave PGP de la AWS CLI. Para obtener más información, consulte Red de confianza.