> 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/apportez-votre-propre-stockage/connecting-shade-with-google-cloud-storage.md).

# Connexion de Shade avec Google Cloud Storage

Shade prend en charge Bring-Your-Own-S3 (BYOS3) avec plusieurs fournisseurs tels qu’AWS, GCP, MinIO, Wasabi, Backblaze, et plus encore. 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 les fichiers 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, rendez-vous dans Cloud Storage, puis cliquez sur « Créer un nouveau bucket » :

<figure><img src="/files/d3e6c57e85e58ee97434ab2605466bab30461b7b" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
ShadeFS n’exige aucune autre propriété spécifique sur le bucket. Vous pouvez choisir de répliquer les données, d’activer les journaux ou de mettre en place le versioning selon vos besoins pour votre entreprise.
{% endhint %}

### Configuration du CORS

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

Il est recommandé d’utiliser le JSON suivant :

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

### Création des 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 > Settings > Interoperability pour accéder à vos clés HMAC ou en générer de nouvelles.

<figure><img src="/files/014454e2b38956bf295954e334e5ac0acf1de2b1" 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 prochaines étapes.

### Création d’un lecteur BYOS dans Shade

À ce stade, vous devriez avoir obtenu 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="/files/7e5c9172394c24f32daae767888a33dd8f1e9a7c" alt=""><figcaption></figcaption></figure>

#### Sélectionnez un modèle

<figure><img src="/files/62c62960b8af36e90c43a79bc97d780c8e6390b4" alt=""><figcaption></figcaption></figure>

Nos modèles vous aident à démarrer rapidement avec Shade grâce à des métadonnées et des vues supplémentaires qui vous aident à organiser vos fichiers et vos actifs. Pour en savoir plus sur notre IA, vous pouvez consulter notre [académie](https://academy.shade.inc/ai-tools/custom-and-automated-metadata). Dans ce cas, nous avons sélectionné Production vidéo.

#### Création de notre drive GCS

Ensuite, nous choisissons le nom de notre drive et sélectionnons notre fournisseur GCS.

<figure><img src="/files/5b7979f1788088925852744ba1e6832548ff74e7" 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 drive que vous avez créé à l’écran précédent.
{% endhint %}

{% hint style="info" %}
Notez également que 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="/files/2249d727d01b7a753ab46046868b7a04108fbcdf" alt=""><figcaption></figcaption></figure>

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

Une fois les étapes précédentes suivies, vous êtes maintenant en mesure de téléverser votre premier fichier sur 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="/files/79011fc93bdc1397bed3aaa485443a6c94c23af5" alt=""><figcaption></figcaption></figure>

### Conseils de dépannage

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

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

Si vous ne parvenez 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://academy.shade.inc/shade-academy/shade-academy-fr/apportez-votre-propre-stockage/connecting-shade-with-google-cloud-storage.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.