Generalidades
Este artículo explica cómo instalar y configurar el AWS CLI para interactuar con tu cuenta de DreamObjects.
Antecedentes
AWS CLI es una herramienta de línea de comandos para administrar datos en Amazon S3 y otros proveedores de servicios de almacenamiento en la nube que utilizan el protocolo S3, como DreamObjects. Es ideal para usuarios con dominio de los comandos SSH y para scripts automatizados activados desde un cron job.
¿Necesito instalar AWS CLI?
AWS CLI está instalado en todos los servidores excepto Ubuntu Noble.
- Si tu servidor ejecuta Ubuntu Noble, sigue los pasos de instalación a continuación.
- De lo contrario, puedes pasar a la sección Configuración de AWS CLI.
Instalar una versión personalizada de AWS CLI
Esta sección explica cómo instalar una versión personalizada de Python 3 y crear un entorno virtual en un servidor DreamHost o en tu computador local.
Servidores DreamHost
-
Estos pasos suponen que ya has adquirido una cuenta de DreamObjects y has configurado un usuario y un bucket.
- Inicia sesión en tu servidor usando SSH.
- Instala la versión de Python que prefieras.
- Accede al directorio principal del usuario.
[server]$ cd ~
- Corre el siguiente comando para crear un entorno virtual.
- Usa el usuario shell para especificar la ruta completa a la instalación local de tu Python.
- Cambia my-bucket por el nombre de tu bucket de DreamObjects.
[server]$ virtualenv -p /home/username/opt/python-3.9.2/bin/python my-bucket
- Se crea un nuevo directorio llamado my-bucket.
- Activa este nuevo entorno virtual.
[server]$ source ~/my-bucket/bin/activate
Cuando este activo, el símbolo del sistema cambia para mostrar el nombre del entorno virtual. Por ejemplo:
(my-bucket)
- Instala AWS CLI usando pip.
(my-bucket) pip install awscli
- Dentro de tu entorno virtual, actualiza los permisos del nuevo directorio aws para poder correr los comandos de la CLI de AWS.
(my-bucket) chmod +x ~/my-bucket/bin/aws
Ahora puedes continuar con la configuración para usar tu depósito de DreamObjects.
macOS y Windows
-
Instala Python
Si deseas configurar AWS CLI en tu computador macOS o Windows, primero debes instalar Python.
Configurar un entorno virtual
A continuación, puedes continuar con la creación del entorno virtual. Revisa esta página para obtener instrucciones.
Instalar paquetes
Una vez creado, puedes usar el comando pip para instalar paquetes dentro de este entorno virtual.
Configurar AWS CLI
Esta sección configura la instalación de AWS CLI con tus credenciales de DreamObjects.
Almacenar tus credenciales de DreamObjects
- Corre aws configure para iniciar el mensaje.
[user@localhost]$ aws configure AWS Access Key ID: ********** AWS Secret Access Key: ********** Default region name: us-east-005 Default output format [None]:
- Copia las llaves de acceso y secretas de tu bucket. La AWS CLI las almacena cifradas.
- Establece la Default region a us-east-005.
- Deja Default output format en blanco.
- Presiona Enter para guardar.
Agregar configuraciones al archivo de configuración
Una vez configurado el perfil predeterminado, deberás agregar manualmente esta configuración al archivo de configuración ubicado en ~/.aws/config.
region = us-east-005 Ignore_configure_endpoint_urls = true Endpoint_url = https://s3.us-east-005.dream.io #Configurations for checksums are required if using aws-cli version 2.23.0 or greater request_checksum_calculation = WHEN_REQUIRED
Ahora puedes correr comandos de AWS CLI para interactuar con tu bucket de DreamObjects.
Activar automáticamente el entorno virtual (Opcional)
Este paso es opcional, pero útil, ya que permite que el entorno virtual se active automáticamente al iniciar sesión. De lo contrario, deberás activarlo manualmente cada vez que inicies sesión.
Para activar automáticamente tu entorno virtual al iniciar sesión, agrega la siguiente línea a tu .bash_profile.
source ~/my-bucket/bin/activate
Asegúrate de cambiar my-bucket por el nombre del entorno virtual que creaste.