> 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-fr/byos/connecting-shade-with-google-cloud-storage.md).

# Connexion de Shade à Google Cloud Storage

Shade prend en charge le mode Bring-Your-Own-S3 (BYOS3) avec plusieurs fournisseurs tels qu’AWS, GCP, MinIO, Wasabi, Backblaze, et bien d’autres. Voici comment connecter Shade à votre compte GCP existant.

### Création d’un nouveau bucket dans Google Cloud Storage

{% hint style="info" %}
Bien que le provisionnement d’un nouveau bucket ne soit pas strictement nécessaire, nous recommandons vivement d’en provisionner un nouveau pour Shade. Shade ne peut pas utiliser des fichiers dans des buckets existants en raison de la nature de ShadeFS. Shade créera deux nouveaux dossiers `blobs` et `chunks` dans n’importe quel bucket auquel vous le connectez.
{% endhint %}

Pour créer un nouveau bucket dans GCS, connectez-vous à votre compte, accédez au stockage cloud, puis cliquez sur « Créer un nouveau bucket » :

<figure><img src="https://2926217644-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 ne nécessite aucun autre paramètre spécifique sur le bucket. Vous pouvez choisir de répliquer les données, de journaliser ou de configurer le versioning comme vous le souhaitez pour votre entreprise.
{% endhint %}

### Configuration de CORS

Le Cross-Origin Resource Sharing est une caractéristique importante qui permet aux buckets d’être accessibles depuis d’autres origines (comme <https://app.shade.inc>). Ceci est essentiel pour permettre à Shade d’accéder aux médias d’origine et de les télécharger pour vous depuis notre application. Pour configurer CORS, vous devrez suivre ces étapes [ici](https://cloud.google.com/storage/docs/using-cors#command-line) pour installer `l’interface de ligne de commande gcloud` et configurer CORS.

Il est recommandé d’utiliser le JSON suivant :

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

### Création de clés HMAC

Pour que Shade puisse accéder à votre bucket GCS, vous devrez provisionner une clé HMAC pour un compte de service.

Rendez-vous dans Cloud Storage > Paramètres > Interopérabilité pour accéder à vos clés HMAC ou en générer.

<figure><img src="https://2926217644-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>

Une fois que vous avez créé une nouvelle clé, copiez la clé d’accès et la clé secrète générées dans votre presse-papiers et conservez-les pour les étapes suivantes.

### Créer un lecteur BYOS dans Shade

En arrivant à ce stade, vous devriez avoir acquis avec succès les éléments suivants :

1. Espace de travail Shade
2. Nom du bucket
3. Région du bucket
4. Clé d’accès
5. Clé secrète

Si vous n’avez pas encore d’espace de travail, vous pouvez en créer un [ici](https://app.shade.inc).

Dans votre espace de travail Shade, vous pouvez maintenant créer un lecteur. Sélectionnez le bouton plus à côté de « My drives » > lecteur BYOS.

<figure><img src="https://2926217644-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>

#### Sélectionnez un modèle

<figure><img src="https://2926217644-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>

Nos modèles vous aident à configurer rapidement Shade avec des métadonnées et des vues supplémentaires qui vous aident à organiser vos fichiers et vos ressources. Pour plus d’informations sur notre IA, vous pouvez consulter notre [academy](https://academy.shade.inc/ai-tools/custom-and-automated-metadata). Dans ce cas, nous avons चयनné Production vidéo.

#### Création de notre lecteur GCS

Ensuite, nous définissons le nom de notre lecteur et sélectionnons notre fournisseur GCS.

<figure><img src="https://2926217644-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>

#### Ajout de nos identifiants GCS

À partir des étapes précédentes, nous ajoutons nos identifiants GCS, y compris le nom de notre bucket, la région, la clé d’accès et la clé secrète.

{% hint style="info" %}
Il doit s’agir du nom du bucket que vous avez créé dans GCS. Ce n’est pas le même que le nom du lecteur que vous avez créé à l’écran précédent.
{% endhint %}

{% hint style="info" %}
Notez également : si vous avez sélectionné plusieurs régions pour votre bucket GCS, vous pouvez choisir n’importe quelle région en toute sécurité. Toutes les régions pointent vers <https://storage.googleapis.com>
{% endhint %}

<figure><img src="https://2926217644-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>

### Téléchargement de votre premier fichier

Une fois que vous avez suivi les étapes précédentes, vous êtes maintenant en mesure de téléverser votre premier fichier vers votre lecteur Shade. Si la configuration a réussi, vous devriez pouvoir téléverser votre fichier et monter le lecteur Shade sur votre ordinateur depuis l’ [application de bureau Shade](https://shade.inc/download)

<figure><img src="https://2926217644-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>

### Conseils de dépannage

Si vous avez d’autres questions, n’hésitez pas à nous contacter à <support@shade.inc> ou rejoignez notre [Discord](https://discord.gg/h8wqFMJ4vK).

#### Je n’arrive pas à téléverser, que se passe-t-il ?

Si vous n’arrivez pas à téléverser, veuillez vérifier les paramètres CORS de votre bucket ou vos clés secrètes / d’accès ainsi que les autorisations associées.


---

# 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-fr/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.
