Cómo subir y descargar objetos de almacenamiento en proyectos

En esta página, se muestra cómo subir y descargar objetos a buckets de almacenamiento aislados de Google Distributed Cloud (GDC).

Antes de comenzar

Los buckets de almacenamiento son recursos con alcance para un proyecto específico. El proyecto actúa como un contenedor, agrupa tus buckets y permite su administración a través del servidor de la API de Management. Antes de que puedas realizar las operaciones en esta página, debes crear un proyecto nuevo o seleccionar uno existente en el que tengas permisos suficientes.

Roles de IAM obligatorios

Comunícate con tu administrador de proyectos de IAM para solicitar los siguientes roles en tu espacio de nombres del proyecto:

  • Administrador de buckets de proyectos (project-bucket-admin): Crea, actualiza y borra buckets de almacenamiento.
  • Visualizador de objetos de buckets de proyectos (project-bucket-object-viewer): Visualiza y verifica los detalles de los buckets y objetos de almacenamiento.

Para obtener más información, consulta Otorga bucket buckets.

Prepara el entorno

Para ejecutar comandos en el servidor de la API de Management o en el servidor de la API global, haz lo siguiente:

  1. Accede y genera el archivo kubeconfig para el servidor de la API de Management zonal si no tienes uno.
  2. Para los buckets de dos zonas, haz lo siguiente:
    • Verifica con tu operador de infraestructura (IO) que se haya creado el recurso personalizado BucketLocationConfig para tus zonas vinculadas.
    • Genera el archivo kubeconfig para el servidor de la API global.

Lineamientos para asignar nombres de objetos

Usa los siguientes lineamientos para nombrar objetos:

  • Usa caracteres UTF-8 cuando nombres objetos.
  • Debe tener entre 1 y 55 caracteres.
  • Evita incluir información de identificación personal (PII).

Sube objetos a buckets de almacenamiento

Console

  1. En el menú de navegación, haz clic en Object Storage.
  2. Haz clic en el nombre del bucket al que deseas subir el objeto.
  3. Opcional: Si deseas crear una carpeta para almacenar tu objeto, haz clic en Crear carpeta > ingresa un nombre de carpeta > haz clic en Crear.
  4. Haz clic en Subir archivo directamente o navega a la carpeta que acabas de crear y, luego, haz clic en Subir archivo.
  5. Selecciona el archivo deseado y haz clic en Abrir.
  6. Espera el mensaje de confirmación de que la carga se realizó correctamente.

gdcloud

Para subir un objeto, ejecuta los siguientes comandos:

gdcloud storage cp LOCAL_PATH s3://REMOTE_PATH
gdcloud storage cp s3://FULLY_QUALIFIED_SOURCE_BUCKET_NAME s3://FULLY_QUALIFIED_DESTINATION_BUCKET_NAME
gdcloud storage mv s3://FULLY_QUALIFIED_SOURCE_BUCKET_NAME s3://FULLY_QUALIFIED_DESTINATION_BUCKET_NAME

Los siguientes comandos requieren el parámetro FULLY_QUALIFIED_BUCKET_NAME. Usa el comando GET o DESCRIBE de la sección Ver configuración del bucket para obtener el nombre de bucket completamente calificado.

El siguiente comando sube todos los archivos de texto del directorio local a un bucket:

gdcloud storage cp *.txt s3://FULLY_QUALIFIED_BUCKET_NAME

El siguiente comando sube varios archivos del directorio local a un bucket:

gdcloud storage cp abc1.txt abc2.txt s3://FULLY_QUALIFIED_BUCKET_NAME

Para subir una carpeta a un bucket, usa la opción --recursive para copiar un árbol de directorios completo. El siguiente comando sube el árbol de directorios dir:

gdcloud storage cp DIRECTORY_NAME s3://FULLY_QUALIFIED_BUCKET_NAME --recursive

Realiza cargas de varias partes para objetos grandes o usa cargas de varias partes automáticamente cuando tengas un archivo para subir que sea más grande que 15 MB. En ese caso, el archivo se divide en varias partes, y cada parte tiene un tamaño de 15 MB. La última parte es más pequeña. Cada parte se sube por separado y se reconstruye en el destino cuando se completa la transferencia.

Si falla la carga de una parte, puedes reiniciar la carga sin afectar ninguna de las otras partes que ya se subieron.

Existen dos opciones relacionadas con las cargas de varias partes:

  • --disable-multipart: Inhabilita las cargas de varias partes para todos los archivos.
  • --multipart-chunk-size-mb=SIZE: Establece el tamaño de cada fragmento de una carga de varias partes.

Los archivos más grandes que SIZE se suben automáticamente como varias partes de varios subprocesos. Los archivos más pequeños se suben con el método tradicional. SIZE está en megabytes. El tamaño predeterminado del fragmento es de 15 MB. El tamaño mínimo permitido del fragmento es de 5 MB y el máximo es de 5 GB.

Descarga objetos de buckets de almacenamiento

Console

  1. En el menú de navegación, haz clic en Object Storage.
  2. Haz clic en el nombre del bucket que contiene los objetos.
  3. Selecciona la casilla de verificación junto al nombre del objeto que deseas descargar.
  4. Haz clic en Descargar.

gdcloud

Para obtener objetos del bucket, haz lo siguiente:

gdcloud storage cp s3://FULLY_QUALIFIED_BUCKET_NAME/OBJECT LOCAL_FILE_TO_SAVE

Para descargar todos los archivos de texto de un bucket a tu directorio actual, haz lo siguiente:

gdcloud storage cp s3://FULLY_QUALIFIED_BUCKET_NAME/*.txt .

Para descargar el archivo de texto abc.txt de un bucket a tu directorio actual, haz lo siguiente:

gdcloud storage cp s3://FULLY_QUALIFIED_BUCKET_NAME/abc.txt .

Para descargar una versión anterior del archivo, primero enumera todas las versiones del archivo:

gdcloud storage ls s3://FULLY_QUALIFIED_BUCKET_NAME/abc.txt --all-versions

Resultado de ejemplo:

s3://my-bucket/abc.txt#OEQxNTk4MUEtMzEzRS0xMUVFLTk2N0UtQkM4MjAwQkJENjND
s3://my-bucket/abc.txt#ODgzNEYzQ0MtMzEzRS0xMUVFLTk2NEItMjI1MTAwQkJENjND
s3://my-bucket/abc.txt#ODNCNDEzNzgtMzEzRS0xMUVFLTlDOUMtQzRDOTAwQjg3RTg3

Luego, descarga una versión específica del archivo de texto abc.txt del bucket a tu directorio actual:

gdcloud storage cp s3://FULLY_QUALIFIED_BUCKET_NAME/abc.txt#OEQxNTk4MUEtMzEzRS0xMUVFLTk2N0UtQkM4MjAwQkJENjND .

Usa AEADKey personalizado

Para una mayor personalización, puedes crear tu propia AEADKey y usarla directamente cuando encriptes objetos en tu bucket. Esto te brinda un control total sobre la clave de encriptación, sin pasar por la predeterminada. Sigue los pasos para crear una clave para crear una AEADKey nueva y asegúrate de que esté en el mismo Namespace que el bucket que deseas usar. Luego, cada vez que envíes la solicitud, asegúrate de que el HEADER esté configurado con x-amz-server-side-encryption: SSE-KMS y x-amz-server-side-encryption-aws-kms-key-id: NAMESPACE_NAME/AEADKey_NAME.