Esta documentación es para la versión 1 de AWS CLI. Para obtener documentación relacionada con la versión 2 de AWS CLI, consulte la Guía del usuario de la versión 2.
Puede instalar la versión 1 de la AWS Command Line Interface (AWS CLI) y sus dependencias en la mayoría de las distribuciones de Linux con el administrador de paquetes pip
o el instalador incluido.
Aunque el paquete awscli
está disponible en los repositorios de otros administradores de paquetes, como apt
y yum
, estos no han sido generados ni están administrados ni admitidos por AWS. Le recomendamos que solamente instale la AWS CLI desde los puntos de distribución oficiales de AWS, tal y como se indica en esta guía.
Secciones
Instalación y desinstalación de la versión 1 de la AWS CLI en Linux con el instalador incluido
Instalación y desinstalación de la versión 1 de la AWS CLI con Snapcraft
Agregue la versión 1 de la AWS CLI ejecutable a la ruta de la línea de comandos
Solución de errores de instalación y desinstalación de AWS CLI
Requisitos previos
Debe tener instalado Python 3.8 o una versión posterior. Para obtener instrucciones de instalación, consulte la página Downloading Python
Matriz de compatibilidad con versiones de Python
Version de la AWS CLI | Versión de Python compatible |
---|---|
1.32.0: actual | Python 3.8+ |
1.27.0: 1.31.x | Python 3.7+ |
1.20.0 – 1.26.x | Python 3.6+ |
1.19.0 – 1.19.x | Python: Python 3.6 y 2.7 |
1.17 – 1.18.x | Python 2.7+, Python 3.4+ |
1.0 – 1.16.x | Python 2.6 y versiones anteriores, Python 3.3 y versiones anteriores |
Instalación y desinstalación de la versión 1 de la AWS CLI en Linux con el instalador incluido
En Linux o macOC, también utilizar el instalador incluido para instalar la versión 1 de la AWS CLI. Este incluye todas las dependencias y se puede usar sin conexión.
nota
El instalador empaquetado no admite la instalación en rutas que contienen espacios.
Temas
Instalación de la versión 1 de la AWS CLI con el instalador incluido con sudo
Los pasos que se indican a continuación le permiten instalar AWS CLI la versión 1 de la desde la línea de comandos en cualquier compilación de Linux o macOS.
A continuación, se muestra un resumen de los comandos de instalación que puede cortar y pegar para que se ejecuten como un único conjunto de comandos.
Para instalar la última versión del AWS CLI, utilice el siguiente bloque de comandos:
$
curl "https://s3.amazonaws.com/aws-cli/awscli-bundle.zip" -o "awscli-bundle.zip" unzip awscli-bundle.zip sudo ./awscli-bundle/install -i /usr/local/aws -b /usr/local/bin/aws
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 1.16.312
sería awscli-bundle-1.16.312.zip
lo que da como resultado el siguiente comando:
$
curl "https://s3.amazonaws.com/aws-cli/awscli-bundle-
1.16.312
.zip" -o "awscli-bundle.zip" unzip awscli-bundle.zip sudo ./awscli-bundle/install -i /usr/local/aws -b /usr/local/bin/aws
Siga estos pasos desde la línea de comandos para instalar la versión 1 de la AWS CLI con el instalador empaquetado.
Para instalar la versión 1 de la AWS CLI con el instalador empaquetado
-
Descargue el instalador empaquetado de la versión 1 de la AWS CLI con uno de los métodos siguientes.
-
Descárguelo con el comando
curl
.Para instalar la última versión del AWS CLI, utilice el siguiente bloque de comandos:
$
curl "https://s3.amazonaws.com/aws-cli/awscli-bundle.zip" -o "awscli-bundle.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
1.16.312
seríaawscli-bundle-1.16.312.zip
lo que da como resultado el siguiente comando:$
curl "https://s3.amazonaws.com/aws-cli/awscli-bundle-
1.16.312
.zip" -o "awscli-bundle.zip" -
Descárguelo mediante el enlace directo.
Para obtener la última versión de AWS CLI: https://s3.amazonaws.com/aws-cli/awscli-bundle.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
1.16.312
seríaawscli-bundle-
lo que da como resultado el siguiente url https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip1.16.312
.zip
-
-
Extraiga los archivos del paquete. Si no tiene
unzip
para extraer los archivos, utilice el administrador de paquetes integrado de la distribución de Linux para instalarlo.$
unzip awscli-bundle.zip
-
Ejecute el programa de instalación. El instalador instala la AWS CLI en
/usr/local/aws
y crea el symlinkaws
en el directorio/usr/local/bin
. Si se usa la opción-b
para crear un symlink, no es necesario especificar el directorio de instalación en la variable$PATH
del usuario. Con esto, todos los usuarios deberían poder llamar a la AWS CLI al escribiraws
desde cualquier directorio.$
sudo ./awscli-bundle/install -i /usr/local/aws -b /usr/local/bin/aws
El script de instalación se ejecuta en la versión de Python predeterminada del sistema. Si tiene instalada una versión alternativa de Python y quiere usar esa versión para instalar la AWS CLI, ejecute el script de instalación de esa versión utilizando la ruta absoluta del ejecutable de Python, tal y como se muestra a continuación
$
sudo
/usr/local/bin/python3.7
awscli-bundle/install -i /usr/local/aws -b /usr/local/bin/aws -
Compruebe que AWS CLI se ha instalado correctamente.
$
aws --version
aws-cli/1.35.20 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 botocore/1.18.6
Si obtiene un error, consulte Solución de errores para la AWS CLI.
Instale la versión 1 de la AWS CLI con el instalador empaquetado sin sudo
Si no tiene permisos sudo
o quiere instalar la AWS CLI solo para el usuario actual, puede utilizar una versión modificada de los comandos anteriores. Los dos primeros comandos son iguales.
Para instalar la última versión del AWS CLI, utilice el siguiente bloque de comandos:
$
curl "https://s3.amazonaws.com/aws-cli/awscli-bundle.zip" -o "awscli-bundle.zip" unzip awscli-bundle.zip ./awscli-bundle/install -b ~/bin/aws
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 1.16.312
sería awscli-bundle-1.16.312.zip
lo que da como resultado el siguiente comando:
$
curl "https://s3.amazonaws.com/aws-cli/awscli-bundle-
1.16.312
.zip" -o "awscli-bundle.zip" unzip awscli-bundle.zip ./awscli-bundle/install -b ~/bin/aws
Para instalar la versión 1 de la AWS CLI para el usuario actual
-
Descargue el instalador empaquetado de la versión 1 de la AWS CLI de una de las siguientes maneras.
-
Descárguelo con el comando
curl
.Para instalar la última versión del AWS CLI, utilice el siguiente bloque de comandos:
$
curl "https://s3.amazonaws.com/aws-cli/awscli-bundle.zip" -o "awscli-bundle.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
1.16.312
seríaawscli-bundle-1.16.312.zip
lo que da como resultado el siguiente comando:$
curl "https://s3.amazonaws.com/aws-cli/awscli-bundle-
1.16.312
.zip" -o "awscli-bundle.zip" -
Descárguelo mediante el enlace directo.
Para obtener la última versión de AWS CLI: https://s3.amazonaws.com/aws-cli/awscli-bundle.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
1.16.312
seríaawscli-bundle-
lo que da como resultado el siguiente url https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip1.16.312
.zip
-
-
Extraiga los archivos del paquete mediante
unzip
. Si no tieneunzip
, utilice el administrador de paquetes integrado de la distribución de Linux para instalarlo.$
unzip awscli-bundle.zip
-
Ejecute el programa de instalación. El instalador instala la AWS CLI en
/usr/local/aws
y crea el symlinkaws
en el directorio/usr/local/bin
. El comando utiliza el parámetro-b
para especificar el directorio en el que el instalador coloca el archivo del enlace simbólico deaws
. Debe tener permisos de escritura en la carpeta especificada.$
./awscli-bundle/install -b ~/bin/aws
Esto instala la AWS CLI en la ubicación predeterminada (
~/.local/lib/aws
) y crea un enlace simbólico (symlink) en~/bin/aws
. Asegúrese de que~/bin
está en la variable de entornoPATH
para que el enlace simbólico funcione.$
echo $PATH | grep ~/bin
// See if $PATH contains ~/bin (output will be empty if it doesn't)$
export PATH=~/bin:$PATH
// Add ~/bin to $PATH if necessary -
Asegúrese de que el directorio de la versión 1 de la AWS CLI sea parte de su variable
PATH
.-
Busque el script de perfil de su shell en su carpeta de usuario. Si no está seguro de cuál es el shell que tiene, ejecute
echo $SHELL
.$
ls -a ~
. .. .bash_logout .bash_profile .bashrc Desktop Documents Downloads
-
Bash:
.bash_profile
,.profile
o.bash_login
. -
Zsh:
.zshrc
-
Tcsh:
.tcshrc
,.cshrc
o.login
.
-
-
Añada un comando de exportación al final del script de su perfil igual que en el siguiente ejemplo.
export PATH=
~/.local/bin
:$PATHEste comando inserta la ruta,
~/.local/bin
en este ejemplo, delante de la variablePATH
existente. -
Vuelva a cargar el perfil en la sesión actual para que esos cambios surtan efecto.
$
source ~/
.bash_profile
-
-
Compruebe que AWS CLI se ha instalado correctamente.
$
aws --version
aws-cli/1.35.20 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 botocore/1.18.6
Si obtiene un error, consulte Solución de errores para la AWS CLI.
Desinstale el instalador empaquetado de la versión 1 de la AWS CLI
-
Si instaló la AWS CLI con el instalador empaquetado, siga estas instrucciones. El instalador empaquetado no añade recursos fuera del directorio de instalación, salvo el symlink opcional. Por tanto, para desinstalar, solo es necesario eliminar esos dos elementos.
$
sudo rm -rf /usr/local/aws
$
sudo rm -rf /usr/local/bin/aws
-
(Opcional) Elimine el SDK de AWS compartido e información de configuración de AWS CLI en la carpeta
.aws
.aviso
Estos ajustes de configuración y credenciales se comparten en todos los SDK de AWS y AWS CLI. Si elimina esta carpeta, ningún SDK de AWS que todavía sigue en el sistema podrá acceder a ella.
La ubicación predeterminada de la carpeta
.aws
difiere entre plataformas, de forma predeterminada la carpeta se encuentra en~/.aws/
. Si su usuario tiene permiso de escritura en este directorio, no es necesario que utilicesudo
.$
sudo rm -r
~/.aws/
Instale y desinstale la versión 1 de la AWS CLI con pip
Temas
Instalar pip
Si aún no ha instalado pip
, puede hacerlo con el script proporcionado por Python Packaging Authority. Ejecute pip --version
para saber si su versión de Linux ya incluye Python y pip
. Si tiene instalada la versión 3 o posterior de Python, recomendamos que utilice el comando pip3
.
-
Utilice el comando
curl
para descargar el script de instalación. El comando siguiente utiliza el parámetro-O
(letra "O" mayúscula) para especificar que el archivo descargado debe almacenarse en el directorio actual con el mismo nombre que tiene en el host remoto.$
curl -O https://bootstrap.pypa.io/get-pip.py
-
Ejecute el script con el comando
python
opython3
para descargar e instalar la versión más reciente depip
y otros paquetes de soporte necesarios. Cuando se incluye el modificador--user
, el script instalapip
en la ruta~/.local/bin
.$
python3 get-pip.py --user
-
Asegúrese de que el directorio que contiene
pip
forma parte de la variablePATH
.-
Busque el script de perfil de su shell en su carpeta de usuario. Si no está seguro de cuál es el shell que tiene, ejecute
echo $SHELL
.$
ls -a ~
. .. .bash_logout .bash_profile .bashrc Desktop Documents Downloads
-
Bash:
.bash_profile
,.profile
o.bash_login
. -
Zsh:
.zshrc
-
Tcsh:
.tcshrc
,.cshrc
o.login
.
-
-
Añada un comando de exportación al final del script de su perfil igual que en el siguiente ejemplo.
export PATH=
~/.local/bin
:$PATHEste comando inserta la ruta,
~/.local/bin
en este ejemplo, delante de la variablePATH
existente. -
Vuelva a cargar el perfil en la sesión actual para que esos cambios surtan efecto.
$
source ~/
.bash_profile
-
-
Para comprobar que
pip
opip3
se ha instalado correctamente, ejecute el siguiente comando.$
pip3 --version
pip 24.0 from ~/.local/lib/python3.7/site-packages (python 3.7)
Instale y actualice la versión 1 de la AWS CLI con pip
-
Utilice el comando
pip
opip3
para instalar o actualizar la AWS CLI. Si utiliza la versión 3 o posterior de Python, recomendamos que utilice el comandopip3
. El conmutador--user
,pip
instala la AWS CLI en~/.local/bin
.Para instalar la última versión del AWS CLI, utilice el siguiente bloque de comandos:
$
pip3 install awscli --upgrade --user
Para una versión específica de AWS CLI, agregue dos signos de igual
=
y el número de versión al nombre del archivo. Para este ejemplo, el nombre de archivo de la versión 1.16.312
sería==1.16.312
lo que da como resultado el siguiente comando:$
pip3 install awscli==
1.16.312
--upgrade --usernota
Utilice reglas de entrecomillado adecuadas para el terminal. Para utilizar el carácter
=
, es posible que tenga que usar comillas simples o dobles para aplicar escape correctamente. En el siguiente ejemplo se aplica escape mediante comillas simples:$
pip3 install 'awscli==
1.16.312
' --upgrade --user -
Compruebe que AWS CLI se ha instalado correctamente.
$
aws --version
aws-cli/1.35.20 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 botocore/1.18.6
Si obtiene un error, consulte Solución de errores para la AWS CLI.
Desinstalación de la AWS CLI con pip
-
Si ha instalado la versión 1 de la AWS CLI con
pip
, también la debe desinstalar conpip
.$
pip uninstall awscli
Si utiliza la versión 2 o 3 de Python, es posible que necesite usar el comando
pip2
opip3
. Use el comandoaws --version
para determinar la versión de Python asociada a la versión 1 de la AWS CLI instalada.$
pip3 uninstall awscli
Es posible que deba reiniciar la ventana del símbolo del sistema o el equipo para eliminar todos los archivos.
-
(Opcional) Elimine el SDK de AWS compartido e información de configuración de AWS CLI en la carpeta
.aws
.aviso
Estos ajustes de configuración y credenciales se comparten en todos los SDK de AWS y AWS CLI. Si elimina esta carpeta, ningún SDK de AWS que todavía sigue en el sistema podrá acceder a ella.
La ubicación predeterminada de la carpeta
.aws
difiere entre plataformas, de forma predeterminada la carpeta se encuentra en~/.aws/
. Si su usuario tiene permiso de escritura en este directorio, no es necesario que utilicesudo
.$
sudo rm -r
~/.aws/
Instalación y desinstalación de la versión 1 de la AWS CLI con Snapcraft
Temas
Instalación de snap
Si aún no ha instalado snap
, puede instalarlo siguiendo las instrucciones que se indican en Canonical Snapcraft. Ejecute snap
version
para saber si su versión de Linux ya incluye snap
.
-
Instale Snapcraft en su plataforma. Para obtener información sobre la instalación de Snapcraft, consulte Installing the daemon
en la documentación de Snap. -
Reinicie 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 issuesde la documentación de Snap. -
Para comprobar que
snap
se haya instalado correctamente, ejecute el siguiente comando.$
snap version
Instale y actualice la versión 1 de la AWS CLI con snap
-
Ejecute el siguiente comando
snap install
para la versión 1 de la AWS CLI.$
snap install aws-cli --channel=v1/stable --classic
En función de los permisos, es posible que tenga añadir
sudo
al comando.$
sudo snap install aws-cli --channel=v1/stable --classic
-
Compruebe que AWS CLI se ha instalado correctamente.
$
aws --version
aws-cli/1.35.20 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 botocore/1.18.6
Si obtiene un error, consulte Solución de errores para la AWS CLI.
Desinstalación de la AWS CLI con snap
-
Si ha instalado la versión 1 de la AWS CLI con
snap
, también la debe desinstalar consnap
.$
snap remove aws-cli
Es posible que deba reiniciar la ventana del símbolo del sistema o el equipo para eliminar todos los archivos.
-
(Opcional) Elimine el SDK de AWS compartido e información de configuración de AWS CLI en la carpeta
.aws
.aviso
Estos ajustes de configuración y credenciales se comparten en todos los SDK de AWS y AWS CLI. Si elimina esta carpeta, ningún SDK de AWS que todavía sigue en el sistema podrá acceder a ella.
La ubicación predeterminada de la carpeta
.aws
difiere entre plataformas, de forma predeterminada la carpeta se encuentra en~/.aws/
. Si su usuario tiene permisos de escritura en este directorio, no es necesario que utilicesudo
.$
sudo rm -r
~/.aws/
Agregue la versión 1 de la AWS CLI ejecutable a la ruta de la línea de comandos
Después de realizar la instalación con pip
o snap
, es posible que necesite añadir el archivo ejecutable aws
a la variable de entorno PATH
del sistema operativo.
Para comprobar en qué carpeta instaló pip
la AWS CLI, ejecute este comando.
$
which aws
/home/
username
/.local/bin/aws
Puede hacer referencia a esto como ~/.local/bin/
ya que /home/username
se corresponde con ~
en Linux.
Si omitió el modificador --user
y, por tanto, no realizó la instalación en modo de usuario, el archivo ejecutable podría estar en la carpeta bin
de la instalación de Python. Si no sabe dónde se ha instalado Python, ejecute este comando.
$
which python
/usr/local/bin/python
La salida puede ser la ruta a un symlink, no el archivo ejecutable real. Ejecute ls
-al
para ver adónde apunta.
$
ls -al /usr/local/bin/python
/usr/local/bin/python -> ~/.local/Python/3.6/bin/python3.6
pip
instala los programas en la misma carpeta que contiene la aplicación de Python. Añada esta carpeta a la variable PATH
.
Para modificar la variable PATH
-
Busque el script de perfil de su shell en su directorio de usuario. Si no está seguro de cuál es el shell que tiene, ejecute
echo $SHELL
.$
ls -a ~
. .. .bash_logout .bash_profile .bashrc Desktop Documents Downloads
-
Bash:
.bash_profile
,.profile
, o.bash_login
-
Zsh –
.zshrc
-
Tcsh:
.tcshrc
,.cshrc
, o.login
-
-
Añada un comando de exportación al script de su perfil.
export PATH=
~/.local/bin
:$PATHEste comando añade una ruta,
~/.local/bin
en este ejemplo, a la variablePATH
actual. -
Cargue el perfil actualizado en su sesión actual.
$
source ~/
.bash_profile
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 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.