Instalación o actualización de la versión más reciente de AWS CLI - AWS Command Line Interface

Instalación o actualización de la versión más reciente de AWS CLI

En este tema se describe cómo instalar o actualizar la última versión de AWS Command Line Interface (AWS CLI) en sistemas operativos compatibles. Para obtener información sobre las últimas versiones de AWS CLI, consulte AWS CLI change notes en GitHub.

Para instalar una versión anterior de AWS CLI, consulte Instalación de versiones anteriores de la versión 2 de AWS CLI. Para obtener instrucciones de desinstalación, consulte Desinstalación de la versión 2 de AWS CLI.

Instrucciones de instalación de AWS CLI

importante

Las versiones 1 y 2 de la AWS CLI utilizan el mismo nombre de comando de aws. Si ha instalado previamente la AWS CLI versión 1, consulte Migración de la AWS CLI versión 1 a la versión 2.

Para obtener las instrucciones de instalación, amplíe la sección para el sistema operativo.

Requisitos de instalación

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

  • Los AWS CLI usa glibc, groff y less. Estos se incluyen de forma predeterminada en la mayoría de las distribuciones principales de Linux.

  • Admitimos las versiones de 64 bits de AWS CLI de las distribuciones recientes de CentOS, Fedora, Ubuntu, Amazon Linux 1, Amazon Linux 2 y Linux ARM.

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

Instalación o actualización de AWS CLI

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)
$ curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip" -o "awscliv2.zip" unzip awscliv2.zip sudo ./aws/install
Linux ARM
$ curl "https://awscli.amazonaws.com/awscli-exe-linux-aarch64.zip" -o "awscliv2.zip" unzip awscliv2.zip sudo ./aws/install
  1. Descargue el archivo de instalación de una de las siguientes maneras:

    Linux x86 (64-bit)
    • 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.

      $ curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip" -o "awscliv2.zip"
    • Descarga de la URL: para descargar el instalador con el navegador, utilice la URL siguiente: https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip

      (Opcional) Para verificar la integridad y autenticidad del archivo de instalación descargado antes de desempaquetar el paquete, siga las instrucciones que se indican en (Opcional) Verificación de la integridad del archivo zip descargado.

    Linux ARM
    • 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.

      $ curl "https://awscli.amazonaws.com/awscli-exe-linux-aarch64.zip" -o "awscliv2.zip"
    • Descarga de la URL: para descargar el instalador con el navegador, utilice la URL siguiente: https://awscli.amazonaws.com/awscli-exe-linux-aarch64.zip

      (Opcional) Para verificar la integridad y autenticidad del archivo de instalación descargado antes de desempaquetar el paquete, siga las instrucciones que se indican en (Opcional) Verificación de la integridad del archivo zip descargado.

  2. 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
  3. 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
    nota

    Para actualizar la instalación actual de AWS CLI, agregue 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

    Para localizar el enlace simbólico y el directorio de instalación existentes, siga los siguientes pasos:

    1. 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
    2. 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. Confirme la instalación con el siguiente comando.

    $ aws --version aws-cli/2.4.5 Python/3.8.8 Linux/4.14.133-113.105.amzn2.x86_64 botocore/2.4.5

    Si no se encuentra el comando aws, es posible que deba reiniciar el terminal o seguir el proceso de solución de problemas en Solución de errores de AWS CLI.

(Opcional) Verificación de la integridad del archivo zip descargado

Si eligió descargar manualmente el paquete del instalador de AWS CLI .zip en los pasos indicados anteriormente, puede usar los pasos siguientes para verificar las firmas mediante la herramienta GnuPG.

Los archivos .zip del paquete del instalador de la AWS CLI están firmados criptográficamente mediante firmas PGP. 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.

  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 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 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.

Requisitos de instalación

  • La AWS CLI se admite en las versiones compatibles de Apple de macOS 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 o actualización de AWS CLI

Si va a actualizar a la versión más reciente, utilice el mismo método de instalación que utilizó en la versión actual. Puede instalar ‎AWS CLI en macOS de las siguientes maneras.

GUI installer

En los pasos siguientes se muestra cómo instalar la versión más reciente de AWS CLI mediante la interfaz de usuario estándar de macOS y el navegador.

  1. En el navegador, descargue el archivo pkg de macOS:‎ https://awscli.amazonaws.com/AWSCLIV2.pkg

  2. Ejecute el archivo descargado y siga las instrucciones que aparecen en pantalla. Puede elegir instalar la AWS CLI de las siguientes maneras:

    • Para todos los usuarios del equipo (requiere sudo)

      • Puede realizar la instalación en cualquier carpeta o elegir la carpeta predeterminada recomendada de /usr/local/aws-cli.

      • El instalador crea automáticamente un enlace simbólico en /usr/local/bin/aws que enlaza al programa principal en la carpeta de instalación elegida.

    • Solo para el usuario actual (no requiere sudo)

      • Puede realizar la instalación en cualquier carpeta en la que tenga permiso de escritura.

      • Debido a los permisos de usuario estándar, una vez finalizado el instalador, debe crear manualmente un archivo de enlace simbólico en $PATH que apunte a los programas aws y aws_completer mediante los siguientes comandos en el símbolo del sistema. Si su $PATH incluye una carpeta en la que puede escribir, puede ejecutar el siguiente comando sin sudo si especifica esa carpeta como ruta de destino. Si no tiene una carpeta en la que se pueda escribir en $PATH, debe usar sudo en los comandos para obtener permisos para escribir en la carpeta de destino especificada. La ubicación predeterminada de un enlace simbólico es /usr/local/bin/.

        $ sudo ln -s /folder/installed/aws-cli/aws /usr/local/bin/aws $ sudo ln -s /folder/installed/aws-cli/aws_completer /usr/local/bin/aws_completer
    nota

    Puede ver los registros de depuración de la instalación si presiona Cmd+L en cualquier lugar del instalador. Esto abre un panel de registro que le permite filtrar y guardar el registro. El archivo de registro también se guarda automáticamente en /var/log/install.log.

  3. Para comprobar que el shell puede encontrar y ejecutar el comando aws en $PATH, utilice los siguientes comandos.

    $ which aws /usr/local/bin/aws $ aws --version aws-cli/2.4.5 Python/3.8.8 Darwin/18.7.0 botocore/2.4.5

    Si no se encuentra el comando aws, es posible que deba reiniciar el terminal o seguir el proceso de solución de problemas en Solución de errores de AWS CLI.

Command line installer - All users

Si tiene permisos sudo, puede instalar la AWS CLI para todos los usuarios del equipo. Proporcionamos los pasos agrupados para que resulte sencillo copiarlos y pegarlos. Consulte las descripciones de cada línea en los pasos siguientes.

$ curl "https://awscli.amazonaws.com/AWSCLIV2.pkg" -o "AWSCLIV2.pkg" $ sudo installer -pkg AWSCLIV2.pkg -target /
  1. Descargar el archivo con el comando curl. 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.pkg en la carpeta actual.

    $ curl "https://awscli.amazonaws.com/AWSCLIV2.pkg" -o "AWSCLIV2.pkg"
  2. Ejecute el programa installer de macOS estándar, especificando el archivo .pkg descargado como fuente. Utilice el parámetro -pkg para especificar el nombre del paquete que se va a instalar y el parámetro -target / para indicar la unidad en la que se instalará el paquete. Los archivos se instalan en /usr/local/aws-cli y se crea automáticamente un symlink en /usr/local/bin. Debe incluir sudo en el comando para conceder permisos de escritura a esas carpetas.

    $ sudo installer -pkg ./AWSCLIV2.pkg -target /

    Una vez completada la instalación, los registros de depuración se escriben en /var/log/install.log.

  3. Para comprobar que el shell puede encontrar y ejecutar el comando aws en $PATH, utilice los siguientes comandos.

    $ which aws /usr/local/bin/aws $ aws --version aws-cli/2.4.5 Python/3.8.8 Darwin/18.7.0 botocore/2.4.5

    Si no se encuentra el comando aws, es posible que deba reiniciar el terminal o seguir el proceso de solución de problemas en Solución de errores de AWS CLI.

Command line - Current user
  1. Para especificar en qué carpeta se instala AWS CLI, debe crear un archivo XML con cualquier nombre de archivo. Es un archivo con formato XML que se parece al siguiente ejemplo. Deje todos los valores tal como se muestran. Es posible que deba reemplazar la ruta /Users/myusername de la línea 9 con la ruta de la carpeta en la que quiere instalar la AWS CLI. La carpeta ya debe existir o se producirá un error en el comando. El siguiente ejemplo XML, denominado choices.xml, especifica el instalador que va a instalar AWS CLI en la carpeta /Users/myusername, donde crea una carpeta denominada aws-cli.

    <?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd"> <plist version="1.0"> <array> <dict> <key>choiceAttribute</key> <string>customLocation</string> <key>attributeSetting</key> <string>/Users/myusername</string> <key>choiceIdentifier</key> <string>default</string> </dict> </array> </plist>
  2. Descargue el instalador pkg con el comando curl. 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.pkg en la carpeta actual.

    $ curl "https://awscli.amazonaws.com/AWSCLIV2.pkg" -o "AWSCLIV2.pkg"
  3. Ejecute el programa installer de macOS estándar con las siguientes opciones:

    • Especifique el nombre del paquete que desea instalar mediante el parámetro -pkg.

    • Para especificar una instalación solo para el usuario actual debe establecer el parámetro -target en CurrentUserHomeDirectory.

    • Especifique la ruta de acceso (relativa a la carpeta actual) y el nombre del archivo XML que creó en el parámetro -applyChoiceChangesXML.

    En el ejemplo siguiente se instala la AWS CLI en la carpeta /Users/myusername/aws-cli.

    $ installer -pkg AWSCLIV2.pkg \ -target CurrentUserHomeDirectory \ -applyChoiceChangesXML choices.xml
  4. Dado que los permisos de usuario estándar normalmente no permiten escribir en las carpetas de $PATH, el instalador en este modo no intenta agregar los enlaces simbólicos a los programas aws y aws_completer. Para que la AWS CLI se ejecute correctamente, debe crear manualmente los enlaces simbólicos una vez finalizado el instalador. Si su $PATH incluye una carpeta en la que puede escribir y especifica la carpeta como la ruta de destino, puede ejecutar el siguiente comando sin sudo. Si no tiene una carpeta en la que se pueda escribir en $PATH, debe usar sudo para obtener permisos para escribir en la carpeta de destino especificada. La ubicación predeterminada de un enlace simbólico es /usr/local/bin/.

    $ sudo ln -s /folder/installed/aws-cli/aws /usr/local/bin/aws $ sudo ln -s /folder/installed/aws-cli/aws_completer /usr/local/bin/aws_completer

    Una vez completada la instalación, los registros de depuración se escriben en /var/log/install.log.

  5. Para comprobar que el shell puede encontrar y ejecutar el comando aws en $PATH, utilice los siguientes comandos.

    $ which aws /usr/local/bin/aws $ aws --version aws-cli/2.4.5 Python/3.8.8 Darwin/18.7.0 botocore/2.4.5

    Si no se encuentra el comando aws, es posible que deba reiniciar el terminal o seguir el proceso de solución de problemas en Solución de errores de AWS CLI.

Requisitos de instalación

  • Admitimos AWS CLI en las versiones compatibles con Microsoft de Windows de 64 bits.

  • Derechos de administrador para instalar software

Instalación o actualización de AWS CLI

Para actualizar la instalación actual de AWS CLI en Windows, descargue un nuevo instalador cada vez que actualice para sobrescribir las versiones anteriores. AWS CLI se actualiza periódicamente. Para ver si se ha lanzado la versión más reciente, consulte el registro de cambios de AWS CLI en GitHub.

  1. Descargue y ejecute el instalador MSI de la AWS CLI para Windows (64 bits):

    https://awscli.amazonaws.com/AWSCLIV2.msi

    Si lo desea, también puede ejecutar el comando msiexec para ejecutar el instalador MSI.

    C:\> msiexec.exe /i https://awscli.amazonaws.com/AWSCLIV2.msi

    Para varios parámetros que se pueden usar con msiexec, consulte msiexec en el sitio web de Documentos de Microsoft.

  2. Para confirmar la instalación, abra el menú Inicio, busque cmd para abrir una ventana del símbolo del sistema y, en el símbolo del sistema, use el comando aws --version.

    C:\> aws --version aws-cli/2.4.5 Python/3.8.8 Windows/10 exe/AMD64 prompt/off

    Si Windows no puede encontrar el programa, es posible que tenga que cerrar y volver a abrir la ventana del símbolo del sistema para actualizar la ruta o siga el proceso de solución de problemas en Solución de errores de AWS CLI.

Solución de errores de instalación y desinstalación de AWS CLI

Si se encuentra con problemas después de instalar o desinstalar la AWS CLI, consulte en Solución de errores de AWS CLI los pasos para la solución de problemas. Para conocer los pasos más relevantes de la solución de problemas, consulte Errores de comando no encontrado, El comando "aws --version" devuelve una versión diferente a la instalada y El comando "aws --version" devuelve una versión después de desinstalar la AWS CLI.

Pasos siguientes

Después de completar los pasos indicados en Requisitos previos para utilizar la versión 2 de AWS CLI e instalar AWS CLI, debe realizar Instalación rápida.