> For the complete documentation index, see [llms.txt](https://academy.shade.inc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://academy.shade.inc/shade-academy/shade-academy-es/byos/connecting-shade-with-google-cloud-storage.md).

# Conectar Shade con Google Cloud Storage

Shade admite Bring-Your-Own-S3 (BYOS3) con múltiples proveedores como AWS, GCP, MinIO, Wasabi, Backblaze y más. Así es como conectar Shade con tu cuenta de GCP existente.

### Aprovisionamiento de un nuevo bucket en Google Cloud Storage

{% hint style="info" %}
Aunque aprovisionar un nuevo bucket no es estrictamente necesario, recomendamos encarecidamente aprovisionar un nuevo bucket para Shade. Shade no puede usar archivos en buckets existentes debido a la naturaleza de ShadeFS. Shade creará dos nuevas carpetas `blobs` y `chunks` en cualquier bucket que conectes a él.
{% endhint %}

Para crear un nuevo bucket en GCS, inicia sesión en tu cuenta, ve a almacenamiento en la nube y “Crear un nuevo bucket”:

<figure><img src="https://440362858-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUNq6h2Bfw7aAK0J2ffnZ%2Fuploads%2FAwLm7oIx1qpthRjAlDgU%2FScreenshot%202025-07-21%20at%2010.31.38%E2%80%AFPM.png?alt=media&amp;token=8c4bea55-db55-4797-8540-ab623cead764" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
ShadeFS no requiere que se configure ninguna otra propiedad específica en el bucket. Puedes optar por replicar datos, registrar eventos o configurar el versionado como prefieras para tu negocio.
{% endhint %}

### Configuración de CORS

Cross-Origin Resource Sharing es una característica importante que permite que los buckets sean accesibles desde otros orígenes (como <https://app.shade.inc>). Esto es fundamental para que Shade acceda y descargue el contenido multimedia original para ti desde nuestra app. Para configurar CORS, deberás seguir estos pasos [aquí](https://cloud.google.com/storage/docs/using-cors#command-line) para instalar el `CLI de gcloud` y configurar CORS.

Se recomienda usar el siguiente JSON:

```json
[
  {
    "origin": ["*"],
    "method": ["*"],
    "responseHeader": ["*"],
    "maxAgeSeconds": 3600
  }
]
```

### Creación de claves HMAC

Para que Shade acceda a tu bucket de GCS, deberás aprovisionar una clave HMAC para una cuenta de servicio.

Ve a Cloud Storage > Configuración > Interoperabilidad para acceder o generar tus claves HMAC.

<figure><img src="https://440362858-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUNq6h2Bfw7aAK0J2ffnZ%2Fuploads%2FJGaqsOWXFyQs7WBhyMn9%2FScreenshot%202025-07-21%20at%2010.40.28%E2%80%AFPM.png?alt=media&amp;token=1e7ca17e-16d9-4cbc-abd1-d1468f2b004a" alt=""><figcaption></figcaption></figure>

Una vez que crees una nueva clave, copia la clave de acceso y la clave secreta creadas en tu portapapeles y guárdalas para los siguientes pasos.

### Creación de una unidad BYOS en Shade

Al llegar a este punto, deberías haber obtenido correctamente los siguientes elementos:

1. Espacio de trabajo de Shade
2. Nombre del bucket
3. Región del bucket
4. Clave de acceso
5. Clave secreta

Si aún no tienes un espacio de trabajo, puedes crear uno [aquí](https://app.shade.inc).

Dentro de tu espacio de trabajo de Shade, ahora puedes crear una unidad. Selecciona el botón más junto a “My drives” > BYOS drive.

<figure><img src="https://440362858-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUNq6h2Bfw7aAK0J2ffnZ%2Fuploads%2FjqzLgveMAH1u4Jue0PBb%2FScreenshot%202025-07-21%20at%209.43.17%E2%80%AFPM.png?alt=media&amp;token=f29ba862-4ea3-454a-9b60-6a14622fa1e5" alt=""><figcaption></figcaption></figure>

#### Selecciona una plantilla

<figure><img src="https://440362858-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUNq6h2Bfw7aAK0J2ffnZ%2Fuploads%2FPE80uq4lWAvyvhx7ZpEn%2FScreenshot%202025-07-21%20at%209.43.25%E2%80%AFPM.png?alt=media&amp;token=72b36257-7e12-4c7e-95b5-7d8e29632adc" alt=""><figcaption></figcaption></figure>

Nuestras plantillas te ayudan a configurarte rápidamente con Shade, con metadatos y vistas adicionales que te ayudan a organizar tus archivos y recursos. Para obtener más información sobre nuestra IA, puedes consultar nuestra [academia](https://academy.shade.inc/ai-tools/custom-and-automated-metadata). En este caso, hemos seleccionado Producción de video.

#### Creación de nuestro Drive de GCS

A continuación, elegimos el nombre de nuestro drive y seleccionamos nuestro proveedor GCS.

<figure><img src="https://440362858-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUNq6h2Bfw7aAK0J2ffnZ%2Fuploads%2FdpvdTNoAtK5owDOTiVFo%2FScreenshot%202025-07-21%20at%2010.43.02%E2%80%AFPM.png?alt=media&amp;token=ed04de47-27f8-4f66-93cd-b5c4f4447944" alt=""><figcaption></figcaption></figure>

#### Añadir nuestras credenciales de GCS

A partir de los pasos anteriores, añadimos nuestras credenciales de GCS, incluidos el nombre de nuestro bucket, la región, la clave de acceso y la clave secreta.

{% hint style="info" %}
Este tiene que ser el nombre del bucket que creaste en GCS. No es el mismo que el nombre del drive que creaste en la pantalla anterior.
{% endhint %}

{% hint style="info" %}
Ten en cuenta también: si seleccionaste varias regiones para tu bucket de GCS, puedes seleccionar con seguridad cualquier región. Todas las regiones apuntan a <https://storage.googleapis.com>
{% endhint %}

<figure><img src="https://440362858-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUNq6h2Bfw7aAK0J2ffnZ%2Fuploads%2FaYZgOmWk6xhdFkGjAk4z%2FScreenshot%202025-07-21%20at%209.44.02%E2%80%AFPM.png?alt=media&amp;token=33a14d3c-569a-4ab8-994c-a10a847c9bd8" alt=""><figcaption></figcaption></figure>

### Subiendo tu primer archivo

Una vez que hayas seguido los pasos anteriores, ya podrás subir tu primer archivo a tu unidad de Shade. Si se configuró correctamente, deberías poder subir tu archivo y montar la unidad de Shade en tu ordenador desde la [Aplicación de escritorio de Shade](https://shade.inc/download)

<figure><img src="https://440362858-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUNq6h2Bfw7aAK0J2ffnZ%2Fuploads%2F64bJhaCemet6iLpQFXWz%2FScreenshot%202025-07-21%20at%209.45.00%E2%80%AFPM.png?alt=media&amp;token=32cda603-88ed-4cb6-a0e9-4124c8734011" alt=""><figcaption></figcaption></figure>

### Consejos de solución de problemas

Si tienes más preguntas, no dudes en contactarnos en <support@shade.inc> o unirte a nuestro [Discord](https://discord.gg/h8wqFMJ4vK).

#### No puedo subir, ¿qué está pasando?

Si no puedes subir archivos, revisa la configuración de CORS de tu bucket o tus claves secreta/de acceso y los permisos asociados.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://academy.shade.inc/shade-academy/shade-academy-es/byos/connecting-shade-with-google-cloud-storage.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
