# 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 los lanzamientos más recientes de AWS CLI, consulte el [registro de cambios de la versión 2 de la AWS CLI](https://raw.githubusercontent.com/aws/aws-cli/v2/CHANGELOG.rst) en GitHub. Para instalar una versión anterior de la AWS CLI, consulte [Instalación de versiones anteriores de la versión 2 de AWS CLI](getting-started-version.md). Para obtener instrucciones de desinstalación, consulte [Desinstalación de la versión 2 de AWS CLI](uninstall.md). **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 [Guía de migración para la versión 2 de la AWS CLI](cliv2-migration.md). **Topics** + [ ## Instrucciones de instalación y actualización de AWS CLI ](#getting-started-install-instructions) + [ ## Solución de errores de instalación y desinstalación de AWS CLI ](#install-tshoot) + [ ## Siguientes pasos ](#install-next-steps) ## Instrucciones de instalación y actualización de AWS CLI Para obtener las instrucciones de instalación, amplíe la sección para el sistema operativo. ### Linux #### Requisitos de instalación y actualización + Debe poder extraer o “descomprimir” el paquete descargado. Si el sistema operativo no tiene el comando `unzip` integrado, utiliza 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 AWS CLI en las versiones de 64 bits de las distribuciones recientes de CentOS, Fedora, Ubuntu, Amazon Linux 1, Amazon Linux 2, Amazon Linux 2023 y Linux ARM. + Debido a que AWS no mantiene los repositorios de terceros excepto `snap`, no podemos garantizar que contengan la versión más reciente de AWS CLI. #### Instalación o actualización de AWS CLI **aviso** Si es la primera vez que actualiza en Amazon Linux, para instalar la versión más reciente de la AWS CLI, debe desinstalar la versión de `yum` instalada previamente mediante el siguiente comando: ``` $ sudo yum remove awscli ``` Después de que la instalación `yum` de la AWS CLI se haya eliminado, siga las instrucciones de instalación de Linux que se muestran a continuación. Para instalar la AWS CLI, puede seguir uno de los siguientes métodos: + El **instalador de línea de comandos** es una buena opción para el control de versiones, ya que puede especificar la versión que se va a instalar. Esta opción no se actualiza automáticamente y debe descargar un nuevo instalador cada vez que actualice para sobrescribir la versión anterior. + El **paquete `snap` compatible oficialmente** es una buena opción para tener siempre la versión más reciente de la AWS CLI ya que los paquetes snap se actualizan automáticamente. No se ha integrado compatibilidad para seleccionar versiones secundarias de AWS CLI y, por lo tanto, no es un método de instalación óptimo si su equipo tiene que fijar versiones. ------ #### [ Command line installer - Linux x86 (64-bit) ] Para actualizar la instalación actual de la AWS CLI en Windows, descargue un nuevo instalador cada vez que actualice para sobrescribir las versiones anteriores. Siga estos pasos desde la línea de comandos para instalar la AWS CLI en Linux. A continuación, se presentan los pasos de instalación rápida en un solo grupo de copiar y pegar que proporcionan una instalación básica. Para obtener instrucciones guiadas, consulte los pasos a continuación. **nota** **(Opcional)** El siguiente bloque de comandos descarga e instala la AWS CLI sin verificar primero la integridad de la descarga. Para verificar la integridad de la descarga, siga las instrucciones paso a paso que se muestran a continuación. **Para instalar** la AWS CLI, ejecute los siguientes comandos. ``` $ curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip" -o "awscliv2.zip" unzip awscliv2.zip sudo ./aws/install ``` **Para actualizar la instalación actual** de la AWS CLI, agregue la información del enlace simbólico y del instalador existentes para construir el comando `install` con los parámetros `--bin-dir`, `--install-dir` y `--update`. El siguiente bloque de comandos utiliza un enlace simbólico de ejemplo de */usr/local/bin* y una ubicación de instalador de ejemplo de */usr/local/aws-cli* para instalar la AWS CLI localmente para el usuario actual. ``` $ curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip" -o "awscliv2.zip" unzip awscliv2.zip sudo ./aws/install --bin-dir /usr/local/bin --install-dir /usr/local/aws-cli --update ``` **Pasos de la instalación guiada** 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`. ``` $ 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](https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip) 1. **(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 AWS CLI del paquete del instalador de la `.zip` 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](https://www.gnupg.org/). 1. 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 tCFBV1MgQ0xJIFRlYW0gPGF3cy1jbGlAYW1hem9uLmNvbT6JAlQEEwEIAD4CGwMF CwkIBwIGFQoJCAsCBBYCAwECHgECF4AWIQT7Xbd/1cEYuAURraimMQrMRnJHXAUC aGveYQUJDMpiLAAKCRCmMQrMRnJHXKBYD/9Ab0qQdGiO5hObchG8xh8Rpb4Mjyf6 0JrVo6m8GNjNj6BHkSc8fuTQJ/FaEhaQxj3pjZ3GXPrXjIIVChmICLlFuRXYzrXc Pw0lniybypsZEVai5kO0tCNBCCFuMN9RsmmRG8mf7lC4FSTbUDmxG/QlYK+0IV/l uJkzxWa+rySkdpm0JdqumjegNRgObdXHAQDWlubWQHWyZyIQ2B4U7AxqSpcdJp6I S4Zds4wVLd1WE5pquYQ8vS2cNlDm4QNg8wTj58e3lKN47hXHMIb6CHxRnb947oJa pg189LLPR5koh+EorNkA1wu5mAJtJvy5YMsppy2y/kIjp3lyY6AmPT1posgGk70Z CmToEZ5rbd7ARExtlh76A0cabMDFlEHDIK8RNUOSRr7L64+KxOUegKBfQHb9dADY qqiKqpCbKgvtWlds909Ms74JBgr2KwZCSY1HaOxnIr4CY43QRqAq5YHOay/mU+6w hhmdF18vpyK0vfkvvGresWtSXbag7Hkt3XjaEw76BzxQH21EBDqU8WJVjHgU6ru+ DJTs+SxgJbaT3hb/vyjlw0lK+hFfhWKRwgOXH8vqducF95NRSUxtS4fpqxWVaw3Q V2OWSjbne99A5EPEySzryFTKbMGwaTlAwMCwYevt4YT6eb7NmFhTx0Fis4TalUs+ j+c7Kg92pDx2uQ== =OBAt -----END PGP PUBLIC KEY BLOCK----- ``` Como referencia, a continuación se indican los detalles de la clave pública. ``` Key ID: A6310ACC4672475C Type: RSA Size: 4096/4096 Created: 2019-09-18 Expires: 2026-07-07 User ID: AWS CLI Team Key fingerprint: FB5D B77F D5C1 18B8 0511 ADA8 A631 0ACC 4672 475C ``` 1. 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 " imported gpg: Total number processed: 1 gpg: imported: 1 ``` 1. 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`. **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 ``` 1. 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 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 " [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, consulta [ Red de confianza](https://en.wikipedia.org/wiki/Web_of_trust). 1. 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 ``` **nota** Al actualizar desde una versión anterior, el comando `unzip` solicita sobrescribir los archivos existentes. Para omitir estas instrucciones, por ejemplo, en el caso de la automatización de scripts, utilice la marca de actualización `-u` para `unzip`. Este indicador actualiza automáticamente los archivos existentes y crea otros nuevos según sea necesario. ``` $ unzip -u awscliv2.zip ``` 1. 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: 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 ``` 1. Confirme la instalación con el siguiente comando. ``` $ aws --version aws-cli/2.27.41 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 ``` 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 para la AWS CLI](cli-chap-troubleshooting.md). ------ #### [ Command line - Linux ARM ] Para actualizar la instalación actual de la AWS CLI en Windows, descargue un nuevo instalador cada vez que actualice para sobrescribir las versiones anteriores. Siga estos pasos desde la línea de comandos para instalar la AWS CLI en Linux. A continuación, se presentan los pasos de instalación rápida en un solo grupo de copiar y pegar que proporcionan una instalación básica. Para obtener instrucciones guiadas, consulte los pasos a continuación. **nota** **(Opcional)** El siguiente bloque de comandos descarga e instala la AWS CLI sin verificar primero la integridad de la descarga. Para verificar la integridad de la descarga, siga las instrucciones paso a paso que se muestran a continuación. **Para instalar** la AWS CLI, ejecute los siguientes comandos. ``` $ curl "https://awscli.amazonaws.com/awscli-exe-linux-aarch64.zip" -o "awscliv2.zip" unzip awscliv2.zip sudo ./aws/install ``` **Para actualizar la instalación actual** de la AWS CLI, agregue la información del enlace simbólico y del instalador existentes para construir el comando `install` con los parámetros `--bin-dir`, `--install-dir` y `--update`. El siguiente bloque de comandos utiliza un enlace simbólico de ejemplo de */usr/local/bin* y una ubicación de instalador de ejemplo de */usr/local/aws-cli*. ``` $ curl "https://awscli.amazonaws.com/awscli-exe-linux-aarch64.zip" -o "awscliv2.zip" unzip awscliv2.zip sudo ./aws/install --bin-dir /usr/local/bin --install-dir /usr/local/aws-cli --update ``` **Pasos de la instalación guiada** 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`. ``` $ 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](https://awscli.amazonaws.com/awscli-exe-linux-aarch64.zip) 1. **(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 AWS CLI del paquete del instalador de la `.zip` 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](https://www.gnupg.org/). 1. 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 tCFBV1MgQ0xJIFRlYW0gPGF3cy1jbGlAYW1hem9uLmNvbT6JAlQEEwEIAD4CGwMF CwkIBwIGFQoJCAsCBBYCAwECHgECF4AWIQT7Xbd/1cEYuAURraimMQrMRnJHXAUC aGveYQUJDMpiLAAKCRCmMQrMRnJHXKBYD/9Ab0qQdGiO5hObchG8xh8Rpb4Mjyf6 0JrVo6m8GNjNj6BHkSc8fuTQJ/FaEhaQxj3pjZ3GXPrXjIIVChmICLlFuRXYzrXc Pw0lniybypsZEVai5kO0tCNBCCFuMN9RsmmRG8mf7lC4FSTbUDmxG/QlYK+0IV/l uJkzxWa+rySkdpm0JdqumjegNRgObdXHAQDWlubWQHWyZyIQ2B4U7AxqSpcdJp6I S4Zds4wVLd1WE5pquYQ8vS2cNlDm4QNg8wTj58e3lKN47hXHMIb6CHxRnb947oJa pg189LLPR5koh+EorNkA1wu5mAJtJvy5YMsppy2y/kIjp3lyY6AmPT1posgGk70Z CmToEZ5rbd7ARExtlh76A0cabMDFlEHDIK8RNUOSRr7L64+KxOUegKBfQHb9dADY qqiKqpCbKgvtWlds909Ms74JBgr2KwZCSY1HaOxnIr4CY43QRqAq5YHOay/mU+6w hhmdF18vpyK0vfkvvGresWtSXbag7Hkt3XjaEw76BzxQH21EBDqU8WJVjHgU6ru+ DJTs+SxgJbaT3hb/vyjlw0lK+hFfhWKRwgOXH8vqducF95NRSUxtS4fpqxWVaw3Q V2OWSjbne99A5EPEySzryFTKbMGwaTlAwMCwYevt4YT6eb7NmFhTx0Fis4TalUs+ j+c7Kg92pDx2uQ== =OBAt -----END PGP PUBLIC KEY BLOCK----- ``` Como referencia, a continuación se indican los detalles de la clave pública. ``` Key ID: A6310ACC4672475C Type: RSA Size: 4096/4096 Created: 2019-09-18 Expires: 2026-07-07 User ID: AWS CLI Team Key fingerprint: FB5D B77F D5C1 18B8 0511 ADA8 A631 0ACC 4672 475C ``` 1. 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 " imported gpg: Total number processed: 1 gpg: imported: 1 ``` 1. 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`. **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 ``` 1. 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 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 " [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, consulta [ Red de confianza](https://en.wikipedia.org/wiki/Web_of_trust). 1. 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 ``` **nota** Al actualizar desde una versión anterior, el comando `unzip` solicita sobrescribir los archivos existentes. Para omitir estas instrucciones, por ejemplo, en el caso de la automatización de scripts, utilice la marca de actualización `-u` para `unzip`. Este indicador actualiza automáticamente los archivos existentes y crea otros nuevos según sea necesario. ``` $ unzip -u awscliv2.zip ``` 1. 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: 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 ``` 1. Confirme la instalación con el siguiente comando. ``` $ aws --version aws-cli/2.27.41 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 ``` 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 para la AWS CLI](cli-chap-troubleshooting.md). ------ #### [ Snap package ] Proporcionamos una versión oficial de AWS compatible de la AWS CLI en `snap`. Si desea tener siempre instalada la versión más reciente de AWS CLI en su sistema, se la proporciona un paquete snap que se actualiza automáticamente. No se ha integrado compatibilidad para seleccionar versiones secundarias de AWS CLI y, por lo tanto, no es un método de instalación óptimo si su equipo tiene que fijar versiones. Si desea instalar una versión secundaria específica de la AWS CLI, le sugerimos que utilice el instalador de línea de comandos. 1. Si su plataforma Linux aún no tiene `snap` instalado, instale `snap` en su plataforma. 1. Para obtener información sobre la instalación de `snap`, consulte [Installing the daemon](https://snapcraft.io/docs/installing-snapd) en la *documentación de Snap*. 1. Puede que tenga que reiniciar el sistema para que las variables `PATH` se actualicen correctamente. Si tiene problemas durante la instalación, siga los pasos que se indican en la sección [Fix common issues](https://snapcraft.io/docs/fix-common-issues) de la *documentación de Snap*. 1. Para comprobar que `snap` se haya instalado correctamente, ejecute el siguiente comando. ``` $ snap version ``` 1. Ejecute el siguiente comando `snap install` para la AWS CLI. ``` $ snap install aws-cli --classic ``` En función de los permisos, es posible que tenga añadir `sudo` al comando. ``` $ sudo snap install aws-cli --classic ``` **nota** Para ver el repositorio de snap de la AWS CLI, incluidas las instrucciones de `snap` adicionales, consulte la página [https://snapcraft.io/aws-cli](https://snapcraft.io/aws-cli) del *sitio web de Canonical Snapcraft*. 1. Compruebe que AWS CLI se ha instalado correctamente. ``` $ aws --version aws-cli/2.27.41 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 ``` Si obtiene un error, consulte [Solución de errores para la AWS CLI](cli-chap-troubleshooting.md). ------ ### macOS #### Requisitos de instalación y actualización + Admitimos la AWS CLI en las versiones 11 y posteriores de macOS. Para obtener más información, consulte las [actualizaciones de la política de compatibilidad de macOS para la versión 2 de AWS CLI](https://aws.amazon.com/blogs/developer/macos-support-policy-updates-for-the-aws-cli-v2/) en el *blog de herramientas para desarrolladores de AWS*. + Debido a que AWS no mantiene repositorios de terceros, no podemos garantizar que contengan la última versión de AWS CLI. **Matriz de compatibilidad con versiones de macOS** | AWS CLIVersión | Versión de macOS compatible | | --- | --- | | 2.21.0 - actual | 11\$1 | | 2.17.0 - 2.20.0 | 10.15\$1 | | 2.0.0 - 2.16.12 | 10.14 y anteriores | #### 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](https://awscli.amazonaws.com/AWSCLIV2.pkg) 1. 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. La ubicación predeterminada de un enlace simbólico es `/usr/local/bin/`: ``` $ ln -s /folder/installed/aws-cli/aws /usr/local/bin/aws $ ln -s /folder/installed/aws-cli/aws_completer /usr/local/bin/aws_completer ``` Si no tiene permisos de escritura en la carpeta, puede que necesite usar `sudo` en el comando. En el siguiente ejemplo de `sudo`, se utiliza la ubicación predeterminada para un enlace simbólico en `/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\$1L** 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`. 1. 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.27.41 Python/3.11.6 Darwin/23.3.0 ``` 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 para la AWS CLI](cli-chap-troubleshooting.md). ------ #### [ 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 / ``` **Instrucciones de instalación guiada** 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" ``` 1. 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`. 1. 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.27.41 Python/3.11.6 Darwin/23.3.0 ``` 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 para la AWS CLI](cli-chap-troubleshooting.md). ------ #### [ 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`. ``` choiceAttribute customLocation attributeSetting /Users/myusername choiceIdentifier default ``` 1. 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" ``` 1. 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 ``` 1. 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/`. Reemplace `folder/installed` por la ruta de su instalación de la AWS CLI. ``` $ 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`. 1. 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.27.41 Python/3.11.6 Darwin/23.3.0 ``` 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 para la AWS CLI](cli-chap-troubleshooting.md). ------ ### Windows #### Requisitos de instalación y actualizació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 la versión 2 de la AWS CLI](https://raw.githubusercontent.com/aws/aws-cli/v2/CHANGELOG.rst) en *GitHub*. 1. Descargue y ejecute el instalador MSI de la AWS CLI para Windows (64 bits): [https://awscli.amazonaws.com/AWSCLIV2.msi](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](https://docs.microsoft.com/en-us/windows-server/administration/windows-commands/msiexec) en el sitio web de *Documentos de Microsoft*. Por ejemplo, puede usar el indicador `/qn` para una instalación silenciosa. ``` C:\> msiexec.exe /i https://awscli.amazonaws.com/AWSCLIV2.msi /qn ``` 1. 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.27.41 Python/3.11.6 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 para la AWS CLI](cli-chap-troubleshooting.md). ## 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 para la AWS CLI](cli-chap-troubleshooting.md) 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](cli-chap-troubleshooting.md#tshoot-install-not-found), [El comando "`aws --version`" devuelve una versión diferente a la instalada](cli-chap-troubleshooting.md#tshoot-install-wrong-version) y [El comando "`aws --version`" devuelve una versión después de desinstalar la AWS CLI](cli-chap-troubleshooting.md#tshoot-uninstall-1). ## Siguientes pasos Después de instalar de forma satisfactoria la AWS CLI, puede eliminar de forma segura los archivos del instalador descargados. Después de completar los pasos indicados en [Requisitos previos para utilizar la versión 2 de AWS CLI](getting-started-prereqs.md) e instalar AWS CLI, debe realizar [Configuración de AWS CLI](getting-started-quickstart.md).