# 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 al que lo conectes.
{% 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&#x26;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 o configurar el control de versiones según prefieras para tu negocio.
{% endhint %}

### Configuración de CORS

El uso compartido de recursos de origen cruzado 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 material original para ti desde nuestra aplicación. 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 > Settings > Interoperability 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&#x26;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 generadas en tu portapapeles y guarda esto 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 “Mis unidades” > unidad BYOS.

<figure><img src="https://440362858-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUNq6h2Bfw7aAK0J2ffnZ%2Fuploads%2F3CefkYBfTEC9UhfKiEL4%2FScreenshot%202025-07-21%20at%209.43.17%E2%80%AFPM%20(2).png?alt=media&#x26;token=0f984956-5c44-4f0b-b2ba-b5075e510ee5" 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%2F77CwHhG71xRg9arQj5Nj%2FScreenshot%202025-07-21%20at%209.43.25%E2%80%AFPM.png?alt=media&#x26;token=1f945c7f-aac5-47e4-8abe-8d9cb068378c" 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 activos. Para 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 nuestra unidad GCS

A continuación, elegimos el nombre de nuestra unidad 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&#x26;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, incluido el nombre de nuestro bucket, la región, la clave de acceso y la clave secreta.

{% hint style="info" %}
Debe ser el nombre del bucket que creaste en GCS. No es lo mismo que el nombre de la unidad que creaste en la pantalla anterior.
{% endhint %}

{% hint style="info" %}
Además, ten en cuenta: 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%2F4sETffBotAmAGIhPRzZk%2FScreenshot%202025-07-21%20at%209.44.02%E2%80%AFPM.png?alt=media&#x26;token=60dc6023-7537-49f3-863b-b9421ad841be" alt=""><figcaption></figcaption></figure>

### Subir 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 configura correctamente, deberías poder subir tu archivo y montar la unidad de Shade en tu computadora 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%2FLOUUu4QNu99OEOD6T46D%2FScreenshot%202025-07-21%20at%209.45.00%E2%80%AFPM.png?alt=media&#x26;token=881650f8-ad00-443c-8745-5d3975d88387" alt=""><figcaption></figcaption></figure>

### Consejos para solucionar 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, revisa la configuración de CORS en tu bucket o tus claves secreta / de acceso y los permisos asociados.