Descubre el almacenamiento de objetos con la herramienta gcloud

En esta página, se muestra cómo realizar tareas básicas en Cloud Storage con la herramienta de línea de comandos de gcloud.

Los costos se generan en Cloud Storage según los recursos que usas. Por lo general, en esta guía de inicio rápido, se usa menos de $0.01 en recursos de Cloud Storage.

Antes de comenzar

  1. Accede a tu cuenta de Google Cloud. Si eres nuevo en Google Cloud, crea una cuenta para evaluar el rendimiento de nuestros productos en situaciones reales. Los clientes nuevos también obtienen $300 en créditos gratuitos para ejecutar, probar y, además, implementar cargas de trabajo.
  2. En la consola de Google Cloud, en la página del selector de proyectos, haz clic en Crear proyecto para comenzar a crear un proyecto de Google Cloud nuevo.

    Ir al selector de proyectos

  3. Asegúrate de que la facturación esté habilitada para tu proyecto de Google Cloud.

  4. Instala Google Cloud CLI.
  5. Para inicializar la CLI de gcloud, ejecuta el siguiente comando:

    gcloud init
  6. En la consola de Google Cloud, en la página del selector de proyectos, haz clic en Crear proyecto para comenzar a crear un proyecto de Google Cloud nuevo.

    Ir al selector de proyectos

  7. Asegúrate de que la facturación esté habilitada para tu proyecto de Google Cloud.

  8. Instala Google Cloud CLI.
  9. Para inicializar la CLI de gcloud, ejecuta el siguiente comando:

    gcloud init

Cree un bucket

Los buckets son los contenedores básicos que conservan tus datos en Cloud Storage.

Para crear un bucket, haz lo siguiente:

  1. Abre una ventana de la terminal.
  2. Usa el comando de gcloud storage buckets create y un nombre único para crear un bucket:

    gcloud storage buckets create gs://my-awesome-bucket/ --uniform-bucket-level-access

    Esto usa un bucket llamado “my-awesome-bucket”. Debes elegir tu propio nombre de bucket que sea único a nivel global.

    Si se ejecuta de forma correcta, el comando mostrará lo siguiente:

    Creating gs://my-awesome-bucket/...

Acabas de crear un bucket para almacenar datos.

Creating gs://my-awesome-bucket/...
ServiceException: 409 Bucket my-awesome-bucket already exists.

Vuelve a intentarlo con otro nombre de bucket.

Suba un objeto a su bucket

La imagen de un gatito que se subirá al bucket

  1. Haz clic derecho sobre la imagen anterior y guárdala en algún lugar de tu computadora, como el escritorio.

  2. Usa el comando gcloud storage cp para copiar la imagen de la ubicación en la que la guardaste al bucket que creaste:

    gcloud storage cp Desktop/kitten.png gs://my-awesome-bucket

    Si no hay errores, el comando mostrará lo siguiente:

    Copying file://Desktop/kitten.png [Content-Type=image/png]...
    Uploading   gs://my-awesome-bucket/kitten.png:       0 B/164.3 KiB
    Uploading   gs://my-awesome-bucket/kitten.png:       164.3 KiB/164.3 KiB

    Almacenaste un objeto en tu bucket.

Descarga el objeto del bucket

  1. Usa el comando gcloud storage cp para descargar la imagen que almacenaste en el bucket en algún lugar de tu computadora, como el escritorio:

    gcloud storage cp gs://my-awesome-bucket/kitten.png Desktop/kitten2.png

    Si no hay errores, el comando mostrará lo siguiente:

    Copying gs://my-awesome-bucket/kitten.png...
    Downloading file://Desktop/kitten2.png:               0 B/164.3 KiB
    Downloading file://Desktop/kitten2.png:               164.3 KiB/164.3 KiB

    Descargaste un objeto desde tu bucket.

Copia el objeto a una carpeta del bucket

  1. Usa el comando gcloud storage cp para crear una carpeta y copiar la imagen en ella:

    gcloud storage cp gs://my-awesome-bucket/kitten.png gs://my-awesome-bucket/just-a-folder/kitten3.png

    Si se ejecuta correctamente, el comando mostrará lo siguiente:

    Copying gs://my-awesome-bucket/kitten.png [Content-Type=image/png]...
    Copying     ...my-awesome-bucket/just-a-folder/kitten3.png: 164.3 KiB/164.3 KiB

    Acabas de copiar tu imagen en una carpeta nueva del bucket.

Muestre el contenido de un bucket o una carpeta

  1. Usa el comando gcloud storage ls para mostrar el contenido en el nivel superior del bucket:

    gcloud storage ls gs://my-awesome-bucket

    Si no hay errores, el comando mostrará un mensaje similar a este:

    gs://my-awesome-bucket/kitten.png
    gs://my-awesome-bucket/just-a-folder/

    Ya viste los contenidos en el nivel superior de tu bucket.

Muestre los detalles de un objeto

  1. Usa el comando gcloud storage ls con la marca --long para obtener detalles sobre una de las imágenes:

    gcloud storage ls gs://my-awesome-bucket/kitten.png --long

    Si no hay errores, el comando mostrará un mensaje similar a este:

    2638  2016-02-26T23:05:14Z  gs://my-awesome-bucket/kitten.png
    TOTAL: 1 objects, 168243.2 bytes (164.3 KiB)

    Acabas de obtener información sobre el tamaño y la fecha de creación de la imagen.

Haz que los objetos sean de acceso público

  1. Usa el comando gcloud storage buckets add-iam-policy-binding a fin de otorgar a todos los usuarios permiso para leer las imágenes almacenadas en el bucket:

    gcloud storage buckets add-iam-policy-binding gs://my-awesome-bucket --member=allUsers --role=roles/storage.objectViewer

    El comando es exitoso si tu respuesta contiene lo siguiente:

    bindings:
      - members:
        - allUsers
        role: roles/storage.objectViewer
    

    Ahora cualquiera puede obtener las imágenes.

  2. Para quitar este acceso, usa el siguiente comando:

    gcloud storage buckets remove-iam-policy-binding gs://my-awesome-bucket --member=allUsers --role=roles/storage.objectViewer

    El comando resulta exitoso si no se muestra ningún error.

    Quitaste el acceso público a las imágenes del bucket.

Otorga acceso a tu bucket

  1. Usa el comando gcloud storage buckets add-iam-policy-binding a fin de dar permiso a una dirección de correo electrónico específica para que agregue objetos a tu bucket:

    gcloud storage buckets add-iam-policy-binding gs://my-awesome-bucket --member=user:jane@gmail.com --role=roles/storage.objectCreator

    El comando es exitoso si tu respuesta contiene lo siguiente:

    bindings:
      - members:
        - user:jane@gmail.com
        role: roles/storage.objectCreator
    

    Ahora alguien más puede agregar elementos a tu bucket.

  2. Para quitar este permiso, ejecuta el siguiente comando:

    gcloud storage buckets remove-iam-policy-binding gs://my-awesome-bucket --member=user:jane@gmail.com --role=roles/storage.objectCreator

    El comando es exitoso si no se muestra ningún error.

    Le quitaste al usuario el acceso a este bucket.

Borra un objeto

  1. Usa el comando gcloud storage rm para borrar una de las imágenes:

    gcloud storage rm gs://my-awesome-bucket/kitten.png

    Si no hay errores, el comando mostrará lo siguiente:

    Removing gs://my-awesome-bucket/kitten.png...

    Esta copia de la imagen ya no se almacena en Cloud Storage (aunque la copia que creaste en la carpeta just-a-folder/ todavía existe).

Realiza una limpieza

Sigue estos pasos para evitar que se apliquen cargos a tu cuenta de Google Cloud por los recursos que usaste en esta página.

  1. Abre una ventana de la terminal (si no está abierta).
  2. Usa el comando gcloud storage rm con la marca --recursive para borrar el bucket y su contenido:

    gcloud storage rm gs://my-awesome-bucket --recursive

    Si no hay errores, el comando mostrará un mensaje similar a este:

    Removing gs://my-awesome-bucket/just-a-folder/cloud-storage.logo.png#1456530077282000...
    Removing gs://my-awesome-bucket/...

    Se borraron tu bucket y su contenido.

¿Qué sigue?