Montages de volume Cloud Storage pour les services

Cette page explique comment installer un bucket Cloud Storage en tant que volume de stockage, à l'aide des installations de volume Cloud Run.

L'installation du bucket en tant que volume dans Cloud Run présente le contenu du bucket sous forme de fichiers dans le système de fichiers du conteneur. Après avoir installé le bucket en tant que volume, vous y accédez comme s'il s'agissait d'un répertoire de votre système de fichiers local, en utilisant les opérations et les bibliothèques du système de fichiers de votre langage de programmation au lieu d'utiliser les bibliothèques clientes des API Google.

Vous pouvez installer votre volume en lecture seule et vous pouvez également spécifier des options d'installation pour votre volume.

Exigences relatives à la mémoire

Les installations de volume Cloud Storage utilisent la mémoire du conteneur Cloud Run pour les activités suivantes :

  • Pour toute la mise en cache de Cloud Storage FUSE, Cloud Run utilise par défaut le paramètre de cache de statistiques avec une valeur TTL (Time To Live) de 60 secondes. La taille maximale par défaut du cache de statistiques est de 32 Mo. La taille maximale par défaut du cache de types est de 4 Mo.

  • Lors de la lecture, Cloud Storage FUSE consomme également de la mémoire en plus des caches de statistiques et de types, par exemple un tableau de 1 Mo pour chaque fichier en cours de lecture et pour les goroutines.

  • Lors de l'écriture dans Cloud Storage, l'ensemble du fichier est stocké dans la mémoire Cloud Run avant son écriture dans Cloud Storage.

Limites

Étant donné que Cloud Run utilise Cloud Storage FUSE pour cette installation de volume, vous devez prendre en compte les éléments suivants lors de l'installation d'un bucket Cloud Storage en tant que volume :

  • Cloud Storage FUSE ne permet pas de contrôler la simultanéité pour plusieurs écritures (verrouillage de fichiers) dans un même fichier. Lorsque plusieurs écritures tentent de remplacer un fichier, la dernière écriture l'emporte et toutes les écritures précédentes sont perdues.
  • Cloud Storage FUSE n'est pas un système de fichiers entièrement compatible avec POSIX. Pour plus de détails, consultez la documentation de Cloud Storage FUSE.

Chemins d'accès non autorisés

Cloud Run ne vous permet pas d'installer un volume sur /dev, /proc et /sys, ou dans leurs sous-répertoires.

Avant de commencer

Vous avez besoin d'un bucket Cloud Storage à installer en tant que volume.

Pour optimiser les performances de lecture/écriture dans Cloud Storage, consultez Optimiser les performances de bande passante réseau de Cloud Storage FUSE.

Rôles requis

Pour obtenir les autorisations nécessaires pour configurer des installations de volume Cloud Storage, demandez à votre administrateur de vous accorder les rôles IAM suivants :

Pour obtenir les autorisations nécessaires à votre identité de service pour accéder au fichier et au bucket Cloud Storage, demandez à votre administrateur d'accorder à l'identité du service le rôle IAM suivant:

Pour en savoir plus sur les rôles et les autorisations Cloud Storage, consultez la page IAM pour Cloud Storage.

Pour obtenir la liste des rôles et des autorisations IAM associés à Cloud Run, consultez les pages Rôles IAM Cloud Run et Autorisations IAM Cloud Run. Si votre service Cloud Run communique avec les API Google Cloud, telles que les bibliothèques clientes Cloud, consultez le guide de configuration de l'identité du service. Pour en savoir plus sur l'attribution de rôles, consultez les pages Autorisations de déploiement et Gérer les accès.

Installer un volume Cloud Storage

Vous pouvez installer plusieurs buckets sur différents chemins d'installation. Vous pouvez également installer un volume sur plusieurs conteneurs à l'aide de chemins d'installation identiques ou différents sur l'ensemble des conteneurs.

Si vous utilisez plusieurs conteneurs, spécifiez les volumes, puis spécifiez les installations de volume pour chaque conteneur.

Les installations de volume nécessitent l'environnement d'exécution de deuxième génération. Si aucun environnement d'exécution n'est explicitement configuré, Cloud Run sélectionne automatiquement l'environnement d'exécution de deuxième génération pour votre service.

Console

  1. Dans la console Google Cloud, accédez à Cloud Run :

    Accédez à Cloud Run

  2. Cliquez sur Déployer un conteneur et sélectionnez Service pour configurer un nouveau service. Si vous configurez un service existant, cliquez sur celui-ci puis sur Modifier et déployer la nouvelle révision.

  3. Si vous configurez un nouveau service, remplissez la page initiale des paramètres du service, puis cliquez sur Conteneur(s), volumes, mise en réseau et sécurité pour développer la page de configuration du service.

  4. Cliquez sur l'onglet Volumes.

    image

    • Cliquez sur Ajouter un volume.
    • Dans la liste déroulante Type de volume, sélectionnez "Bucket Cloud Storage" comme type de volume.
    • Dans le champ Nom du volume, saisissez le nom du volume que vous souhaitez utiliser.
    • Parcourez les buckets Cloud Storage et sélectionnez celui à utiliser pour le volume ou, si vous le souhaitez, créez un bucket.
    • Si vous souhaitez passer le bucket en lecture seule, cochez la case "Lecture seule".
    • Cliquez sur OK.
    • Cliquez sur l'onglet Conteneur:
      • Cliquez sur l'onglet Montages de volume.
      • Cliquez sur Monter le volume.
      • Sélectionnez le volume de stockage dans le menu.
      • Spécifiez le chemin d'accès où vous souhaitez installer le volume.
      • Cliquez sur Terminé.

  5. Cliquez sur Créer ou Déployer.

gcloud

  • Pour ajouter un volume et l'installer, procédez comme suit :

    gcloud run services update SERVICE \
--add-volume name=VOLUME_NAME,type=cloud-storage,bucket=BUCKET_NAME \
--add-volume-mount volume=VOLUME_NAME,mount-path=MOUNT_PATH

    Remplacez :

    • SERVICE par le nom de votre service.
    • MOUNT_PATH par le chemin relatif où vous installez le volume, par exemple, /mnt/my-volume.
    • VOLUME_NAME par le nom que vous souhaitez pour votre volume. La valeur VOLUME_NAME permet de mapper le volume à l'installation du volume.
    • BUCKET_NAME par le nom de votre bucket Cloud Storage.

  • Pour installer votre volume en tant que volume en lecture seule, procédez comme suit :

    --add-volume=name=VOLUME_NAME,type=cloud-storage,bucket=BUCKET_NAME,readonly=true

  • Si vous utilisez plusieurs conteneurs, spécifiez d'abord vos volumes, puis les installations de volumes pour chaque conteneur :

    gcloud run services update SERVICE \
--add-volume name=VOLUME_NAME,type=cloud-storage,bucket=BUCKET_NAME \
--container CONTAINER_1 \
--add-volume-mount volume=VOLUME_NAME,mount-path=MOUNT_PATH \
--container CONTAINER_2 \
--add-volume-mount volume=VOLUME_NAME,mount-path=MOUNT_PATH2

YAML

  1. Si vous créez un service, ignorez cette étape. Si vous mettez à jour un service existant, téléchargez sa configuration YAML :

    gcloud run services describe SERVICE --format export > service.yaml

  2. Modifiez-les si nécessaire.

    apiVersion: serving.knative.dev/v1
kind: Service
metadata:
  name: SERVICE
spec:
  template:
    metadata:
      annotations:
        run.googleapis.com/execution-environment: gen2
    spec:
      containers:
      - image: IMAGE_URL
        volumeMounts:
        - name: VOLUME_NAME
          mountPath: MOUNT_PATH
      volumes:
      - name: VOLUME_NAME
        csi:
          driver: gcsfuse.run.googleapis.com
          readOnly: IS_READ_ONLY
          volumeAttributes:
            bucketName: BUCKET_NAME

    Remplacer

    • IMAGE_URL par une référence à l'image de conteneur, par exemple us-docker.pkg.dev/cloudrun/container/hello:latest. Si vous utilisez Artifact Registry, le dépôt REPO_NAME doit déjà être créé. L'URL se présente sous la forme suivante : LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG
    • MOUNT_PATH par le chemin relatif où vous installez le volume, par exemple, /mnt/my-volume.
    • VOLUME_NAME par le nom que vous souhaitez pour votre volume. La valeur VOLUME_NAME permet de mapper le volume à l'installation du volume.
    • IS_READ_ONLY par True pour passer le volume en lecture seule ou False pour autoriser les écritures.
    • BUCKET_NAME par le nom du bucket Cloud Storage

  3. Créez ou mettez à jour le service à l'aide de la commande suivante :

    gcloud run services replace service.yaml

Lire et écrire dans un volume

Si vous utilisez la fonctionnalité d'installation de volume Cloud Run, vous accédez à un volume installé à l'aide des mêmes bibliothèques dans votre langage de programmation que celles que vous utilisez pour lire et écrire des fichiers sur votre système de fichiers local.

Ceci est particulièrement utile si vous utilisez un conteneur existant qui attend que des données soient stockées sur le système de fichiers local et utilise des opérations standards du système de fichiers pour y accéder.

Les extraits suivants supposent une installation de volume avec un mountPath défini sur /mnt/my-volume.

Node.js

Utilisez le module File System pour créer un fichier ou ajouter des données à un fichier existant dans le volume /mnt/my-volume : 

var fs = require('fs');
fs.appendFileSync('/mnt/my-volume/sample-logfile.txt', 'Hello logs!', { flag: 'a+' });

Python

Écrivez les données dans un fichier conservé dans le volume /mnt/my-volume : 

f = open("/mnt/my-volume/sample-logfile.txt", "a")

Go

Utilisez le package os pour créer un fichier conservé dans le volume /mnt/my-volume. 

f, err := os.Create("/mnt/my-volume/sample-logfile.txt")

Java

Utilisez la classe Java.io.File pour créer un fichier journal dans le volume /mnt/my-volume : 

import java.io.File;
File f = new File("/mnt/my-volume/sample-logfile.txt");

Configuration de volume à l'aide d'options d'installation

Vous pouvez éventuellement utiliser des options d'installation pour configurer différentes propriétés de votre installation de volume. Les options d'installation disponibles vous permettent de configurer les paramètres de cache, d'installer un répertoire spécifique, d'activer la journalisation de débogage et d'autres comportements.

Spécifier les options d'installation

Vous pouvez spécifier des options de montage à l'aide de Google Cloud CLI ou de YAML.

gcloud

Pour ajouter un volume et l'installer avec des options d'installation:

gcloud beta run services update SERVICE \
    --execution-environment gen2 \
    --add-volume name=VOLUME_NAME,type=cloud-storage,bucket=BUCKET_NAME,mount-options="OPTION_1=VALUE_1;OPTION_N=VALUE_N" \
    --add-volume-mount volume=VOLUME_NAME,mount-path=MOUNT_PATH

Remplacez :

  • SERVICE par le nom de votre service.
  • VOLUME_NAME par le nom que vous souhaitez pour votre volume. La valeur VOLUME_NAME permet de mapper le volume à l'installation du volume.
  • BUCKET_NAME par le nom de votre bucket Cloud Storage.
  • OPTION_1 avec la première option d'installation. Notez que vous pouvez spécifier autant d'options d'installation que nécessaire, en séparant chaque option d'installation et chaque paire de valeurs par un point-virgule.
  • VALUE_1 par le paramètre souhaité pour la première option d'installation.
  • OPTION_N avec la deuxième option de montage.
  • VALUE_N avec le paramètre de la deuxième option d'installation.
  • MOUNT_PATH par le chemin relatif où vous installez le volume, par exemple, /cache.

YAML

  1. Si vous créez un service, ignorez cette étape. Si vous mettez à jour un service existant, téléchargez sa configuration YAML :

    gcloud run services describe SERVICE --format export > service.yaml

  2. Modifiez-les si nécessaire.

    apiVersion: serving.knative.dev/v1
kind: Service
metadata:
  name: SERVICE
  annotations:
    run.googleapis.com/launch-stage: BETA
spec:
  template:
    metadata:
      annotations:
        run.googleapis.com/execution-environment: gen2
    spec:
      containers:
      - image: IMAGE_URL
        volumeMounts:
        - name: VOLUME_NAME
          mountPath: MOUNT_PATH
      volumes:
      - name: VOLUME_NAME
        csi:
          driver: gcsfuse.run.googleapis.com
          readOnly: IS_READ_ONLY
          volumeAttributes:
            bucketName: BUCKET_NAME
            mountOptions: OPTION_1=VALUE_1,OPTION_N=VALUE_N

    Remplacer

    • IMAGE_URL par une référence à l'image de conteneur, par exemple us-docker.pkg.dev/cloudrun/container/hello:latest. Si vous utilisez Artifact Registry, le dépôt REPO_NAME doit déjà être créé. L'URL se présente sous la forme suivante : LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG
    • MOUNT_PATH par le chemin relatif où vous installez le volume, par exemple, /cache.
    • VOLUME_NAME par le nom que vous souhaitez pour votre volume. La valeur VOLUME_NAME permet de mapper le volume à l'installation du volume.
    • IS_READ_ONLY par True pour passer le volume en lecture seule ou False pour autoriser les écritures.
    • BUCKET_NAME par le nom du bucket Cloud Storage
    • OPTION_1 avec la première option d'installation. Notez que vous pouvez spécifier autant d'options d'installation que nécessaire, en séparant chaque option d'installation et chaque paire de valeurs par une virgule.
    • VALUE_1 par le paramètre souhaité pour la première option d'installation.
    • OPTION_N avec la deuxième option de montage.
    • VALUE_N avec le paramètre de la deuxième option d'installation.

  3. Créez ou mettez à jour le service à l'aide de la commande suivante :

    gcloud run services replace service.yaml

Options de montage couramment utilisées

Les options d'installation sont couramment utilisées pour configurer les paramètres de cache, n'installer qu'un répertoire spécifique du bucket Cloud Storage, configurer la propriété du volume (uid, gid), désactiver les répertoires implicites ou spécifier les niveaux de journalisation de débogage.

Configurer les paramètres de mise en cache

Vous pouvez modifier les paramètres de mise en cache de votre volume en définissant les options de montage associées à la mise en cache. Le tableau suivant répertorie les paramètres, ainsi que les valeurs par défaut de Cloud Run :

Paramètre de cache Description Par défaut
metadata-cache-ttl-secs Valeur TTL (Time To Live) en secondes des entrées de métadonnées mises en cache. Par exemple, metadata-cache-ttl-secs=120s. Pour utiliser le fichier le plus récent, spécifiez la valeur 0. Pour toujours utiliser la version mise en cache, spécifiez la valeur -1. Pour en savoir plus, consultez Configurer l'invalidation du cache. 60
stat-cache-max-size-mb Taille maximale en mébioctets (Mio) que le cache de statistiques peut utiliser. Le cache de statistiques est toujours entièrement conservé en mémoire, ce qui a un impact sur la consommation de mémoire. Spécifiez une valeur de 32 si votre charge de travail implique jusqu'à 20 000 fichiers. Si votre charge de travail dépasse 20 000 fichiers, augmentez la taille avec des valeurs de 10 pour 6 000 fichiers supplémentaires, où le cache de statistiques utilise en moyenne 1 500 Mo par fichier.

Pour permettre au cache de statistiques d'utiliser autant de mémoire que nécessaire, c'est-à-dire pour ne définir aucune limite, spécifiez une valeur de -1. Pour désactiver le cache de statistiques, spécifiez la valeur 0.		 32
type-cache-max-size-mb Taille maximale en Mio par répertoire que le cache de types peut utiliser. Le cache de type est toujours entièrement conservé en mémoire, ce qui a un impact sur la consommation de mémoire.

Spécifiez la valeur 4 si le nombre maximal de fichiers dans un seul répertoire à partir du bucket que vous installez contient 20 000 fichiers ou moins. Si le nombre maximal de fichiers dans un même répertoire que vous installez contient plus de 20 000 fichiers, augmentez la valeur de 1 pour chaque tranche de 5 000 fichiers, soit environ 200 octets par fichier.

Pour permettre au cache de types d'utiliser autant de mémoire que nécessaire, c'est-à-dire pour ne spécifier aucune limite, définissez la valeur sur -1.

Pour désactiver le cache de types, définissez la valeur sur 0.		 4

La commande Google Cloud CLI suivante définit metadata-cache-ttl-secs sur 120 secondes et augmente la capacité du cache d'état et de type à 52 et 7 Mo, respectivement:

gcloud beta run services update SERVICE \
    --add-volume name=VOLUME_NAME,type=cloud-storage,bucket=BUCKET_NAME,mount-options="metadata-cache-ttl-secs=120;stat-cache-max-size-mb=52;type-cache-max-size-mb=7" \
    --add-volume-mount volume=VOLUME_NAME,mount-path=MOUNT_PATH

Activer la journalisation du débogage

Par défaut, Cloud Storage FUSE consigne les événements de gravité Info. Vous pouvez modifier les paramètres de journalisation à l'aide de l'une des options de montage de gravité de journalisation suivantes:

  • trace
  • debug
  • info
  • warning
  • error
  • Pour désactiver toute journalisation, spécifiez la valeur off.

Ces niveaux de gravité sont classés du moins grave au plus grave. Lorsque vous spécifiez un niveau de gravité, Cloud Storage FUSE génère des journaux pour les événements dont le niveau de gravité est égal ou supérieur à celui spécifié. Par exemple, lorsque vous spécifiez le niveau warning, Cloud Storage FUSE génère des journaux pour les avertissements et les erreurs.

Définir la gravité des journaux à des niveaux supérieurs à info peut avoir un impact sur les performances et générer une grande quantité de données de journalisation. Nous vous recommandons donc de ne le faire que si nécessaire.

La ligne de commande suivante active la journalisation du débogage:

gcloud beta run services update SERVICE \
    --add-volume name=VOLUME_NAME,type=cloud-storage,bucket=BUCKET_NAME,mount-options="log-severity=debug" \
    --add-volume-mount volume=VOLUME_NAME,mount-path=MOUNT_PATH

Désactiver les répertoires implicites

Pour que Cloud Storage ressemble davantage à un système de fichiers standard, Cloud Run active les répertoires implicites par défaut lors de l'installation d'un bucket Cloud Storage. Vous pouvez désactiver les répertoires implicites à l'aide de l'option de montage implicit-dirs. Désactiver les répertoires implicites peut améliorer les performances et les coûts, mais entraîne des compromis de compatibilité.

La fonctionnalité de répertoires implicites permet à Cloud Run de reconnaître les fichiers Cloud Storage préexistants dont les noms de fichiers imitent une structure de répertoires, comme /mydir/myfile.txt. Si vous désactivez les répertoires implicites, Cloud Run ne pourra pas lister ni lire ces fichiers.

Désactiver les répertoires implicites réduit le nombre de requêtes envoyées à Cloud Storage, ce qui peut améliorer les performances et les coûts de votre application. Pour en savoir plus, consultez la documentation Fichiers et répertoires de Cloud Storage FUSE.

La ligne de commande suivante désactive les répertoires implicites:

gcloud beta run services update SERVICE \
    --add-volume name=VOLUME_NAME,type=cloud-storage,bucket=BUCKET_NAME,mount-options="implicit-dirs=false" \
    --add-volume-mount volume=VOLUME_NAME,mount-path=MOUNT_PATH

Installer un répertoire spécifique dans votre bucket Cloud Storage

Par défaut, Cloud Run installe l'intégralité du bucket Cloud Storage, ce qui donne aux services Cloud Run accès à l'ensemble de son contenu. Dans certains cas, vous ne souhaitez installer qu'un répertoire spécifique. Par exemple, si le bucket contient un grand nombre de fichiers, installer un répertoire spécifique peut améliorer les performances.

Autre exemple : à des fins d'isolation, vous avez besoin de différents services pour avoir accès à différents répertoires du bucket de stockage.

La ligne de commande suivante spécifie le répertoire à installer:

gcloud beta run services update SERVICE \
    --add-volume name=VOLUME_NAME,type=cloud-storage,bucket=BUCKET_NAME,mount-options="only-dir=images" \
    --add-volume-mount volume=VOLUME_NAME,mount-path=MOUNT_PATH

Définir le volume UID et GID

Utilisez les options de montage uid et gid pour modifier l'identifiant utilisateur et l'identifiant de groupe du volume. Cette option est utile si vous souhaitez définir la propriété du fichier sur un utilisateur ou un groupe spécifique correspondant à l'identité d'un ou de plusieurs conteneurs en cours d'exécution. Par défaut, les volumes appartiennent à l'utilisateur racine.

La ligne de commande suivante définit uid et gid:

gcloud beta run services update SERVICE \
    --add-volume name=VOLUME_NAME,type=cloud-storage,bucket=BUCKET_NAME,mount-options="uid=UID;gid=GID" \
    --add-volume-mount volume=VOLUME_NAME,mount-path=MOUNT_PATH

Définir d'autres options d'installation

Vous trouverez ci-dessous la liste complète de toutes les options de montage compatibles avec Cloud Run.

Annuaire

  • implicit-dirs
  • only-dir
  • rename-dir-limit

Debug

  • debug_fuse_errors
  • debug_fuse
  • debug_gcs
  • debug-invariants
  • debug_mutex

Cache

  • stat-cache-capacity
  • stat-cache-ttl
  • type-cache-ttl
  • enable-nonexistent-type-cache

Autorisations

  • uid
  • gid
  • file-mode
  • dir-mode

Other

  • billing-project
  • client-protocol
  • experimental-enable-json-read
  • experimental-opentelemetry-collector-address
  • http-client-timeout
  • limit-bytes-per-sec
  • limit-ops-per-sec
  • max-conns-per-host
  • max-idle-conns-per-host
  • max-retry-sleep
  • -o
  • retry-multiplier
  • sequential-read-size-mb
  • stackdriver-export-interval

Pour obtenir la documentation complète des options d'installation compatibles, consultez les options d'installation de la ligne de commande Cloud Storage FUSE.

Afficher les paramètres des installations de volumes

Console

  1. Dans la console Google Cloud, accédez à la page des services Cloud Run:

    Accéder aux jobs Cloud Run

  2. Cliquez sur le service qui vous intéresse pour ouvrir la page Informations sur le service.

  3. Cliquez sur l'onglet Volumes.

  4. Recherchez le paramètre des installations de volumes dans la page d'informations sur les volumes.

gcloud

  1. Exécutez la commande suivante :

    gcloud run services describe SERVICE_NAME

  2. Recherchez le paramètre correspondant aux montages de volumes dans la configuration renvoyée.

Optimiser les performances de la bande passante réseau de Cloud Storage FUSE

Pour de meilleures performances de lecture et d'écriture, connectez votre service Cloud Run à un réseau VPC à l'aide du VPC direct et acheminez tout le trafic sortant via votre réseau VPC. Pour ce faire, utilisez l'une des options suivantes:

Délai de démarrage du conteneur et installations Cloud Storage FUSE

L'utilisation de Cloud Storage FUSE peut légèrement augmenter le temps de démarrage à froid de votre conteneur Cloud Run, car l'installation de volumes est effectuée avant le démarrage du ou des conteneurs. Votre conteneur ne démarre que si Cloud Storage FUSE est correctement installé.

Notez que Cloud Storage FUSE n'installe un volume que lorsqu'il a établi une connexion à Cloud Storage. Tout retard de mise en réseau peut avoir un impact sur le temps de démarrage du conteneur. En conséquence, si la tentative de connexion échoue, Cloud Storage FUSE ne sera pas installé et le service Cloud Run ne démarrera pas. En outre, si l'installation de Cloud Storage FUSE prend plus de 30 secondes, le service Cloud Run ne démarre pas, car Cloud Run a un délai total de 30 secondes pour effectuer toutes les installations.

Caractéristiques de performances de Cloud Storage FUSE

Si vous définissez deux volumes, chacun pointant vers un bucket différent, deux processus Cloud Storage FUSE seront lancés. Les montages et les processus se produisent en parallèle.

Les opérations utilisant Cloud Storage FUSE sont affectées par la bande passante réseau, car Cloud Storage FUSE communique avec Cloud Storage à l'aide de l'API Cloud Storage. Certaines opérations, comme la liste du contenu d'un bucket, peuvent être lentes si la bande passante du réseau est faible. De même, la lecture d'un fichier volumineux peut prendre du temps, car cette opération est également limitée par la bande passante du réseau.

Lorsque vous écrivez dans un bucket, Cloud Storage FUSE met entièrement l'objet en file d'attente dans la mémoire. Cela signifie que l'écriture de fichiers volumineux est limitée par la quantité de mémoire disponible pour l'instance de conteneur (la limite de mémoire maximale du conteneur est de 32 Gio).

L'écriture n'est effacée dans le bucket que lorsque vous effectuez une opération close ou fsync : l'objet complet est alors importé/ré-importé dans le bucket. La seule exception à un objet en cours de réimportation dans le bucket concerne un fichier avec du contenu ajouté lorsque sa taille est supérieure ou égale à 2 Mio.

Pour en savoir plus, consultez les ressources suivantes :

Effacer et supprimer les volumes et les installations de volume

Vous pouvez effacer tous les volumes et les montages de volume, ou supprimer des volumes et des montages de volume individuels.

Effacer tous les volumes et les installations de volume

Pour effacer tous les volumes et les montages de volume de votre service à conteneur unique, exécutez la commande suivante:

gcloud beta run services update SERVICE \
    --clear-volumes
    --clear-volume-mounts

Si vous disposez de plusieurs conteneurs, suivez les conventions de la CLI Sidecar pour effacer les volumes et les installations de volume:

gcloud beta run services update SERVICE \
    --container=container1 \
    --clear-volumes
    -–clear-volume-mounts \
    --container=container2 \
    --clear-volumes \
    -–clear-volume-mounts

Supprimer des volumes et des montages de volume spécifiques

Pour supprimer un volume, vous devez également supprimer tous les montages de volume qui l'utilisent.

Pour supprimer des volumes ou des montages de volumes individuels, utilisez les options remove-volume et remove-volume-mount:

gcloud beta run services update SERVICE \
    --remove-volume VOLUME_NAME \
    --container=container1 \
    --remove-volume-mount MOUNT_PATH \
    --container=container2 \
    --remove-volume-mount MOUNT_PATH