Guía de inicio rápido: Usa la herramienta de gsutil

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

Los costos se generan en Cloud Storage según los recursos que usas. Este inicio rápido normalmente 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 Google Cloud Console, 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 Cloud. Descubre cómo confirmar que tienes habilitada la facturación en un proyecto.

  4. En Google Cloud Console, 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

  5. Asegúrate de que la facturación esté habilitada para tu proyecto de Cloud. Descubre cómo confirmar que tienes habilitada la facturación en un proyecto.

  6. Instala el SDK de Cloud.

    Cuando se te solicite, elige el proyecto que creaste antes.

  7. Instala Python 3.8.

    Si usas Windows y dejaste la casilla de verificación correspondiente seleccionada cuando instalaste el SDK de Cloud, esto se hizo de forma automática.

Crea un bucket

Los depósitos 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 gsutil mb y un nombre único para crear un bucket:

    gsutil mb -b on -l us-east1 gs://my-awesome-bucket/

    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.

Sube un objeto al bucket

Imagen de un gatito

  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 gsutil cp para copiar la imagen de la ubicación en la que la guardaste al depósito que creaste:

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

    Si se ejecuta correctamente, 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 gsutil cp para descargar la imagen que almacenaste en el depósito en algún lugar de tu computadora, como el escritorio:

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

    Si se ejecuta correctamente, 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 gsutil cp para crear una carpeta y copiar la imagen en ella:

    gsutil 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.

Muestra el contenido de un bucket o una carpeta

  1. Usa el comando gsutil ls para mostrar el contenido en el nivel superior del depósito:

    gsutil ls gs://my-awesome-bucket

    Si tiene éxito, 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.

Muestra los detalles de un objeto

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

    gsutil ls -l gs://my-awesome-bucket/kitten.png

    Si tiene éxito, 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 gsutil iam ch a fin de otorgar a todos los usuarios permiso para leer las imágenes almacenadas en el depósito:

    gsutil iam ch allUsers:objectViewer gs://my-awesome-bucket

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

    Ahora cualquiera puede obtener las imágenes.

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

    gsutil iam ch -d allUsers:objectViewer gs://my-awesome-bucket

    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 gsutil iam ch a fin de dar permiso a una dirección de correo electrónico específica para que lea y escriba objetos en el depósito:

    gsutil iam ch user:jane@gmail.com:objectCreator,objectViewer gs://my-awesome-bucket

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

    Ahora alguien más puede colocar objetos y ver lo que hay en tu bucket.

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

    gsutil iam ch -d user:jane@gmail.com:objectCreator,objectViewer gs://my-awesome-bucket

    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 gsutil rm para borrar una de las imágenes:

    gsutil rm gs://my-awesome-bucket/kitten.png

    Si se ejecuta correctamente, 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).

Limpia

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 terminal (si no está abierta).
  2. Usa rm command de gsutil con la marca -r para borrar el depósito y su contenido:

    gsutil rm -r gs://my-awesome-bucket

    Si tiene éxito, 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.

Próximos pasos