Google utilizza la tecnologia AI per tradurre i contenuti nella tua lingua preferita. Le traduzioni generate dall'AI potrebbero contenere errori.

Configurare i mount dei volumi Cloud Storage per i servizi Cloud Run

Questa pagina mostra come montare un bucket Cloud Storage come volume di archiviazione utilizzando i montaggi dei volumi di Cloud Run.

Il montaggio del bucket come volume in Cloud Run presenta i contenuti del bucket come file nel file system del container. Dopo aver montato il bucket come volume, accedi al bucket come se fosse una directory nel file system locale, utilizzando le operazioni e le librerie del file system del tuo linguaggio di programmazione anziché le librerie client delle API di Google.

Puoi montare il volume in sola lettura e specificare le opzioni di montaggio per il volume.

Requisiti di memoria

I montaggi dei volumi Cloud Storage utilizzano la memoria del container di Cloud Run per le seguenti attività:

Per tutta la memorizzazione nella cache di Cloud Storage FUSE, Cloud Run utilizza l'impostazione della cache stat con una durata (TTL) predefinita di 60 secondi. La dimensione massima predefinita della cache stat è 32 MB, mentre la dimensione massima predefinita della cache dei tipi è 4 MiB.
Quando legge da Cloud Storage, Cloud Storage FUSE effettua chiamate API per leggere un oggetto direttamente, senza scaricare l'intero file in una directory locale. Cloud Storage FUSE stabilisce una connessione TCP e legge l'intero oggetto Cloud Storage o solo le parti del file specificate nell'applicazione o nel sistema operativo tramite un offset. Durante la lettura, Cloud Storage FUSE utilizza anche memoria diversa dalle cache stat e dei tipi, ad esempio un array da 1 MiB per ogni file che legge e per goroutines.
Quando scrive su Cloud Storage, Cloud Storage FUSE supporta streaming-writes, un percorso di scrittura, per impostazione predefinita. Cloud Storage FUSE carica i dati direttamente su Cloud Storage senza eseguire la gestione temporanea completa del file. Ogni file aperto per le scritture in modalità flusso consuma circa 64 MiB di memoria durante il processo di caricamento. In questo modo si riducono sia la latenza sia l'utilizzo dello spazio su disco, il che è particolarmente utile per le scritture sequenziali di grandi dimensioni.

Limitazioni

Poiché Cloud Run utilizza Cloud Storage FUSE per questo montaggio del volume, tieni presente alcuni aspetti quando monti un bucket Cloud Storage come volume:

Cloud Storage FUSE non fornisce controllo della contemporaneità per più scritture (blocco dei file) sullo stesso file. Quando più scritture tentano di sostituire un file, l'ultima scrittura ha la precedenza e tutte le scritture precedenti vengono perse.
Cloud Storage FUSE non è un file system completamente conforme a POSIX. Per maggiori dettagli, consulta la documentazione di Cloud Storage FUSE.

Percorsi non consentiti

Cloud Run non consente di montare un volume in /dev, /proc o /sys o nelle relative sottodirectory.

Prima di iniziare

Devi montare un bucket Cloud Storage come volume.

Per prestazioni di lettura/scrittura ottimali su Cloud Storage, consulta Ottimizzazione delle prestazioni della larghezza di banda della rete di Cloud Storage FUSE.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per configurare i montaggi dei volumi Cloud Storage, chiedi all'amministratore di concederti i seguenti ruoli IAM:

Cloud Run Developer (roles/run.developer) sul servizio Cloud Run
Utente dell'account di servizio (roles/iam.serviceAccountUser) sull'identità di servizio

Per ottenere le autorizzazioni necessarie alla tua identità di servizio per accedere al file e al bucket Cloud Storage, chiedi all'amministratore di concedere all'identità di servizio il ruolo Storage Object Viewer (roles/storage.objectViewer). Se l'identità di servizio deve anche eseguire operazioni di scrittura in un bucket, concedi invece il ruolo Storage Object User (roles/storage.objectUser).

Per maggiori dettagli su ruoli e autorizzazioni di Cloud Storage, consulta IAM per Cloud Storage.

Per un elenco di ruoli e autorizzazioni IAM associati a Cloud Run, consulta Ruoli IAM di Cloud Run e Autorizzazioni IAM di Cloud Run. Se il tuo servizio Cloud Run interagisce con le APIGoogle Cloud , come le librerie client Cloud, consulta la guida alla configurazione dell'identità del servizio. Per saperne di più sulla concessione dei ruoli, consulta Autorizzazioni di deployment e Gestisci l'accesso.

Monta un volume Cloud Storage

Puoi montare più bucket in percorsi di montaggio diversi. Puoi anche montare un volume su più container utilizzando percorsi di montaggio uguali o diversi tra i container.

Se utilizzi più container, specifica prima i volumi, poi i montaggi dei volumi per ogni container.

I montaggi dei volumi richiedono l'ambiente di esecuzione di seconda generazione. Cloud Run seleziona automaticamente l'ambiente di esecuzione di seconda generazione per il tuo servizio se non è stato configurato in modo esplicito un ambiente di esecuzione.

Console

Nella console Google Cloud , vai a Cloud Run:

Vai a Cloud Run
Seleziona Servizi dal menu di navigazione di Cloud Run:
1. Se stai configurando un nuovo servizio, fai clic su Esegui il deployment del container e compila la pagina delle impostazioni iniziali del servizio. Poi fai clic su Container, networking, sicurezza per espandere la pagina di configurazione del servizio e fai clic su Volumi.
2. Se stai configurando un servizio esistente, fai clic sul servizio, quindi sulla scheda Container.
Fai clic su Monta volume.
Seleziona Bucket Cloud Storage come tipo di volume.
Nel campo Percorso di montaggio, inserisci il percorso in cui vuoi montare il volume.
Sfoglia e seleziona il bucket Cloud Storage o una directory specifica da utilizzare per il volume. Se vuoi, crea un nuovo bucket.
Se vuoi rendere il bucket di sola lettura, seleziona la casella di controllo Sola lettura.
Facoltativamente, espandi Opzioni di montaggio per specificare le opzioni di montaggio.
Fai clic su Salva.
Fai clic su Crea per un nuovo servizio. Fai clic su Visualizza differenze e fai di nuovo il deployment, quindi su Esegui il deployment delle modifiche per un servizio esistente.

gcloud

Per aggiungere un volume e montarlo:
```
gcloud run deploy SERVICE \
  --image IMAGE_URL \
  --add-volume mount-path=MOUNT_PATH,type=cloud-storage,bucket=BUCKET_NAME,readonly=READ_ONLY
```
Sostituisci quanto segue:
- SERVICE: il nome del servizio.
- IMAGE_URL: un riferimento all'immagine container, ad esempio us-docker.pkg.dev/cloudrun/container/hello:latest. Se utilizzi Artifact Registry, il repository REPO_NAME deve essere già stato creato. L'URL segue il formato LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG
- MOUNT_PATH: il percorso relativo in cui stai montando il volume, ad esempio /mnt/my-volume.
- BUCKET_NAME: il nome del bucket Cloud Storage.
- READ_ONLY: true per rendere il volume di sola lettura o false per consentire le scritture.

Se utilizzi più container, specifica prima i volumi, poi i punti di montaggio dei volumi per ogni container:

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

Se stai creando un nuovo servizio, salta questo passaggio. Se stai aggiornando un servizio esistente, scarica la relativa configurazione YAML:
```
gcloud run services describe SERVICE --format export > service.yaml
```

Aggiorna se necessario.

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

Sostituisci quanto segue:

IMAGE_URL: un riferimento all'immagine container, ad esempio us-docker.pkg.dev/cloudrun/container/hello:latest. Se utilizzi Artifact Registry, il repository REPO_NAME deve essere già stato creato. L'URL segue il formato LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG.
MOUNT_PATH: il percorso relativo in cui stai montando il volume, ad esempio /mnt/my-volume.
VOLUME_NAME: un nome qualsiasi per il volume. Il valore VOLUME_NAME viene utilizzato per mappare il volume al montaggio del volume.
IS_READ_ONLY: True per rendere il volume di sola lettura o False per consentire le scritture.
BUCKET_NAME: il nome del bucket Cloud Storage.

Crea o aggiorna il servizio utilizzando il seguente comando:
```
gcloud run services replace service.yaml
```
Il comando gcloud run services replace utilizza per impostazione predefinita il file service.yaml, se presente.

Terraform

Per scoprire come applicare o rimuovere una configurazione Terraform, consulta Comandi Terraform di base.

Aggiungi quanto segue a una risorsa google_cloud_run_v2_service nella configurazione Terraform:

  resource "google_cloud_run_v2_service" "default" {
    name     = "SERVICE"
    location = "REGION"

    template {
      containers {
        image = "IMAGE_URL"
        volume_mounts {
          name = "VOLUME_NAME"
          mount_path = "MOUNT_PATH"
        }
      }

      volumes {
        name = "VOLUME_NAME"
        gcs {
          bucket = google_storage_bucket.default.name
          read_only = IS_READ_ONLY
        }
      }
    }
  }

  resource "google_storage_bucket" "default" {
    name     = "BUCKET_NAME"
    location = "REGION"
  }

Sostituisci quanto segue:

SERVICE: il nome del servizio Cloud Run.
REGION: la regione Google Cloud .
IMAGE_URL: un riferimento all'immagine container, ad esempio us-docker.pkg.dev/cloudrun/container/hello:latest. Se utilizzi Artifact Registry, il repository REPO_NAME deve essere già stato creato. L'URL segue il formato LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG.
VOLUME_NAME: un nome qualsiasi per il volume. Il valore VOLUME_NAME viene utilizzato per mappare il volume al punto di montaggio del volume.
MOUNT_PATH: il percorso relativo in cui stai montando il volume, ad esempio /mnt/my-volume.
IS_READ_ONLY: True per rendere il volume di sola lettura o False per consentire le scritture.
BUCKET_NAME: il nome del bucket Cloud Storage.

Scrivi

Per specificare i punti di montaggio dei volumi nel file compose.yaml, aggiungi l'attributo volumes alla definizione del servizio. Le volumes o configs di primo livello vengono mappate ai bucket Cloud Storage.

  services:
    web:
      image: IMAGE
      volumes:
        - VOLUME_NAME:MOUNT_PATH
  volumes:
    VOLUME_NAME:

Sostituisci quanto segue:

IMAGE: l'URL dell'immagine container.
VOLUME_NAME: il nome del volume.
MOUNT_PATH: il percorso in cui vuoi montare il volume.

Esegui il deployment dei servizi

Per eseguire il deployment dei servizi, esegui il comando gcloud run compose up:
```
gcloud run compose up compose.yaml
```
Rispondi y a eventuali prompt per installare i componenti richiesti o per abilitare le API.
(Facoltativo) Rendi pubblico il servizio se vuoi consentire l'accesso non autenticato al servizio.

Dopo il deployment, viene visualizzato l'URL del servizio Cloud Run. Copia questo URL e incollalo nel browser per visualizzare il container in esecuzione. Puoi disattivare l'autenticazione predefinita dalla console Google Cloud .

Lettura e scrittura su un volume

Se utilizzi la funzionalità di montaggio del volume di Cloud Run, accedi a un volume montato utilizzando le stesse librerie nel tuo linguaggio di programmazione che utilizzi per leggere e scrivere file nel file system locale.

Questo è particolarmente utile se utilizzi un container esistente che prevede che i dati vengano archiviati nel file system locale e utilizza le normali operazioni del file system per accedervi.

Gli snippet seguenti presuppongono un montaggio del volume con un mountPath impostato su /mnt/my-volume.

Nodejs

Utilizza il modulo File System per creare un nuovo file o aggiungerlo a un file esistente nel volume /mnt/my-volume:

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

Python

Scrivi in un file conservato nel volume, /mnt/my-volume:

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

Vai

Utilizza il pacchetto os per creare un nuovo file conservato nel volume /mnt/my-volume:

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

Java

Utilizza la classe Java.io.File per creare un file di log nel volume /mnt/my-volume:

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

Configurazione del volume utilizzando le opzioni di montaggio

Se vuoi, puoi utilizzare le opzioni di montaggio per configurare varie proprietà del montaggio del volume. Le opzioni di montaggio disponibili consentono di configurare le impostazioni della cache, montare una directory specifica, attivare il logging di debug e altri comportamenti.

Specifica le opzioni di montaggio

Puoi specificare le opzioni di montaggio utilizzando la console Google Cloud , Google Cloud CLI, YAML o Terraform. Le opzioni di montaggio sono separate da punti e virgola (;) in Google Cloud CLI e da virgole in YAML, come mostrato nelle seguenti schede:

Console

Per specificare le opzioni di montaggio per un volume esistente:

Nella console Google Cloud , vai alla pagina Servizi di Cloud Run:

Vai a Cloud Run
Fai clic sul servizio per aprire la relativa pagina dei dettagli.
Fai clic sulla scheda Container.
1. Fai clic sull'icona di modifica accanto al volume da modificare.
2. Espandi Opzioni di montaggio.
3. Configura le opzioni di montaggio aggiornando i campi appropriati o aggiungendo le opzioni di montaggio manualmente.
4. Fai clic su Salva.
Fai clic su Visualizza differenze e fai di nuovo il deployment, quindi su Esegui il deployment delle modifiche.

gcloud

Per aggiungere un volume e montarlo con le opzioni di montaggio:

  gcloud run deploy SERVICE \
      --image IMAGE_URL \
      --add-volume mount-path=MOUNT_PATH,type=cloud-storage,bucket=BUCKET_NAME,readonly=READ_ONLY,mount-options="OPTION_1=VALUE_1;OPTION_N=VALUE_N"

Sostituisci quanto segue:

SERVICE: il nome del servizio.
IMAGE_URL: un riferimento all'immagine container, ad esempio us-docker.pkg.dev/cloudrun/container/hello:latest. Se utilizzi Artifact Registry, il repository REPO_NAME deve essere già stato creato. L'URL segue il formato LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG
MOUNT_PATH: il percorso relativo in cui stai montando il volume, ad esempio /cache.
BUCKET_NAME: il nome del bucket Cloud Storage.
READ_ONLY: true per rendere il volume di sola lettura o false per consentire le scritture.
OPTION_1: la prima opzione di montaggio. Tieni presente che puoi specificare tutte le opzioni di montaggio che vuoi, separando ogni coppia di opzione di montaggio e valore con un punto e virgola.
VALUE_1: l'impostazione che vuoi per la prima opzione di montaggio.
OPTION_N: l'opzione di montaggio successiva.
VALUE_N: l'impostazione per l'opzione di montaggio successiva.

YAML

Se stai creando un nuovo servizio, salta questo passaggio. Se stai aggiornando un servizio esistente, scarica la relativa configurazione YAML:
```
gcloud run services describe SERVICE --format export > service.yaml
```
Aggiorna se necessario.
```
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
            mountOptions: OPTION_1=VALUE_1,OPTION_N=VALUE_N
```
Sostituisci quanto segue:
- IMAGE_URL: un riferimento all'immagine container, ad esempio us-docker.pkg.dev/cloudrun/container/hello:latest. Se utilizzi Artifact Registry, il repository REPO_NAME deve essere già stato creato. L'URL segue il formato LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG
- MOUNT_PATH: il percorso relativo in cui stai montando il volume, ad esempio /cache.
- VOLUME_NAME: un nome qualsiasi per il volume. Il valore VOLUME_NAME viene utilizzato per mappare il volume al montaggio del volume.
- IS_READ_ONLY: True per rendere il volume di sola lettura o False per consentire le scritture.
- BUCKET_NAME: il nome del bucket Cloud Storage.
- OPTION_1: la prima opzione di montaggio. Tieni presente che puoi specificare tutte le opzioni di montaggio che vuoi, separando ogni coppia di opzione e valore di montaggio con una virgola.
- VALUE_1: l'impostazione che vuoi per la prima opzione di montaggio.
- OPTION_N: l'opzione di montaggio successiva.
- VALUE_N: l'impostazione per l'opzione di montaggio successiva.
Crea o aggiorna il servizio utilizzando il seguente comando:
```
gcloud run services replace service.yaml
```
Il comando gcloud run services replace utilizza per impostazione predefinita il file service.yaml, se presente.

Terraform

Per scoprire come applicare o rimuovere una configurazione Terraform, consulta Comandi Terraform di base.

Aggiungi quanto segue a una risorsa google_cloud_run_v2_service nella configurazione Terraform:

  resource "google_cloud_run_v2_service" "default" {
    name     = "SERVICE"
    location = "REGION"

    template {
      containers {
        image = "IMAGE_URL"
        volume_mounts {
          name = "VOLUME_NAME"
          mount_path = "MOUNT_PATH"
        }
      }

      volumes {
        name = "VOLUME_NAME"
        gcs {
            bucket = google_storage_bucket.default.name
            read_only = IS_READ_ONLY
            mount_options = ["OPTION_1=VALUE_1", "OPTION_N=VALUE_N", "OPTION_O"]
        }
      }
    }
  }

Sostituisci quanto segue:

SERVICE: il nome del servizio Cloud Run.
REGION: la regione Google Cloud .
IMAGE_URL: un riferimento all'immagine container che contiene il pool di worker, ad esempio us-docker.pkg.dev/cloudrun/container/worker-pool:latest
VOLUME_NAME: un nome qualsiasi per il volume. Il valore VOLUME_NAME viene utilizzato per mappare il volume al punto di montaggio del volume.
MOUNT_PATH: il percorso relativo in cui stai montando il volume, ad esempio /mnt/my-volume.
IS_READ_ONLY: True per rendere il volume di sola lettura o False per consentire le scritture.
BUCKET_NAME: il nome del bucket Cloud Storage.
OPTION_1: la prima opzione di montaggio. Tieni presente che puoi specificare tutte le opzioni di montaggio che vuoi, separando ogni coppia di opzione e valore di montaggio con una virgola.
VALUE_1: l'impostazione che vuoi per la prima opzione di montaggio.
OPTION_N: la seconda opzione di montaggio, se applicabile.
VALUE_N: l'impostazione per la seconda opzione di montaggio.
OPTION_O: la terza opzione di montaggio, se applicabile. Alcune opzioni di montaggio non hanno un valore.

Opzioni di montaggio di uso comune

Le opzioni di montaggio vengono comunemente utilizzate per:

Configura impostazioni cache
Monta solo una directory specifica dal bucket Cloud Storage
Configura la proprietà del volume (uid, gid)
Disattiva le directory implicite
Specifica i livelli di logging di debug.

Configura le impostazioni di memorizzazione nella cache

Puoi modificare le impostazioni di memorizzazione nella cache per il volume impostando le opzioni di montaggio relative alla memorizzazione nella cache. La tabella seguente elenca le impostazioni, insieme ai valori predefiniti di Cloud Run:

Impostazione della cache	Descrizione	Predefinito
`cache-dir`	Il nome del volume in memoria da utilizzare come directory sottostante per rendere persistenti i file del bucket Cloud Storage nel formato `cr-volume:{volume name}`. Ad esempio, se hai un volume in memoria denominato `in-memory-1` che vuoi utilizzare come directory della cache, specifica `cr-volume:in-memory-1`. Per istruzioni sulla configurazione dei volumi in memoria, consulta Configura i montaggi dei volumi in memoria per i servizi. Quando attivi queste funzionalità, Cloud Run modifica la contabilità delle risorse del processo Cloud Storage FUSE e la conteggia ai fini dei limiti di memoria del container. Per aumentare il limite di memoria del container, consulta Configura i limiti di memoria per i servizi.
`file-cache-download-chunk-size-mb`	Specifica le dimensioni in MiB di ogni richiesta di lettura effettuata da ogni goroutine a Cloud Storage durante il download dell'oggetto nella cache dei file.	200
`file-cache-enable-parallel-downloads`	Accelera le letture di file di grandi dimensioni utilizzando la directory della cache dei file come buffer di precaricamento con più worker per scaricare più parti di un file in parallelo.	true
`file-cache-max-parallel-downloads`	Il numero massimo di goroutine che possono essere generate in un determinato momento in tutti i job di download dei file.	Il doppio del numero di core della CPU sulla tua macchina o 16, a seconda di quale sia il valore più alto.
`file-cache-parallel-downloads-per-file`	Il numero di richieste di download simultanee per file.	16
`file-cache-cache-file-for-range-read`	Determina se l'intero oggetto deve essere scaricato in modo asincrono e archiviato nella directory della cache di Cloud Storage FUSE quando la prima lettura viene completata da un offset diverso da zero.	false
`stat-cache-max-size-mb`	Dimensione massima in mebibyte (MiB) che la cache delle statistiche può utilizzare. La cache delle statistiche viene sempre conservata interamente in memoria, il che influisce sul consumo di memoria. Specifica un valore di `32` se il tuo workload coinvolge fino a 20.000 file. Se il tuo workload utilizza più di 20.000 file, aumenta la dimensione di valori di `10` per ogni 6000 file aggiuntivi, dove la cache delle statistiche utilizza in media 1500 byte per file. Per consentire alla cache delle statistiche di utilizzare la quantità di memoria necessaria, specifica un valore di `-1`. Per disattivare la cache delle statistiche, specifica un valore di `0`.	32
`type-cache-max-size-mb`	La dimensione massima in MiB per directory che la cache dei tipi può utilizzare. La cache dei tipi viene sempre conservata interamente in memoria, con un impatto sul consumo di memoria. Specifica un valore di `4` se il numero massimo di file all'interno di una singola directory del bucket che stai montando contiene 20.000 file o meno. Se il numero massimo di file all'interno di una singola directory che stai montando contiene più di 20.000 file, aumenta il valore di `1` per ogni 5000 file, ovvero una media di circa 200 byte per file. Per consentire alla cache dei tipi di utilizzare la quantità di memoria necessaria, specifica un valore di `-1`. Per disabilitare la cache dei tipi, specifica un valore di `0`.	4

Il seguente comando di Google Cloud CLI imposta metadata-cache-ttl-secs su 120 secondi e aumenta la capacità della cache di statistiche e tipi rispettivamente a 52 e 7 MiB:

gcloud run services update SERVICE \
    --add-volume mount-path=MOUNT_PATH,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"

Sostituisci quanto segue:

SERVICE: il nome del servizio.
BUCKET_NAME: il nome del bucket Cloud Storage.
MOUNT_PATH: il percorso relativo in cui stai montando il volume, ad esempio /cache.

Abilita il logging di debug

Per impostazione predefinita, Cloud Storage FUSE registra gli eventi con Info o superiore. Puoi modificare le impostazioni di logging utilizzando uno dei seguenti livelli di gravità dei log, elencati in ordine dal più basso al più alto:

trace
debug
info
warning
error
Per disattivare tutti i log, specifica il valore off.

Quando specifichi un livello di gravità, Cloud Storage FUSE genera log per gli eventi con un livello di gravità uguale o superiore a quello specificato. Ad esempio, quando specifichi il livello warning, Cloud Storage FUSE genera log per avvisi ed errori.

L'impostazione della gravità dei log su livelli superiori a info può influire sulle prestazioni e generare una grande quantità di dati di logging, pertanto ti consigliamo di farlo solo se necessario. Per la compatibilità con Cloud Logging, il formato del log è text e il formato json non è supportato.

La seguente riga di comando attiva il logging di debug:

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

Sostituisci quanto segue:

SERVICE: il nome del servizio.
BUCKET_NAME: il nome del bucket Cloud Storage.
MOUNT_PATH: il percorso relativo in cui stai montando il volume, ad esempio /cache.

Disabilita directory implicite

Per fare in modo che Cloud Storage assomigli di più a un file system standard, Cloud Run abilita le directory implicite per impostazione predefinita quando monta un bucket Cloud Storage. Puoi disattivare le directory implicite utilizzando l'opzione di montaggio implicit-dirs. La disabilitazione delle directory implicite può migliorare le prestazioni e ridurre i costi, ma comporta compromessi in termini di compatibilità.

La funzionalità delle directory implicite consente a Cloud Run di riconoscere i file Cloud Storage preesistenti i cui nomi file simulano una struttura di directory, ad esempio /mydir/myfile.txt. Se disattivi le directory implicite, Cloud Run non potrà elencare o leggere questi file.

La disattivazione delle directory implicite riduce il numero di richieste a Cloud Storage, il che potrebbe migliorare le prestazioni e i costi dell'applicazione. Per saperne di più, consulta la documentazione di Cloud Storage FUSE su file e directory.

La seguente riga di comando disabilita le directory implicite:

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

Sostituisci quanto segue:

SERVICE: il nome del servizio.
BUCKET_NAME: il nome del bucket Cloud Storage.
MOUNT_PATH: il percorso relativo in cui stai montando il volume, ad esempio /cache.

Monta una directory specifica all'interno del bucket Cloud Storage

Per impostazione predefinita, Cloud Run monta l'intero bucket Cloud Storage, il che consente ai servizi Cloud Run di accedere a tutti i suoi contenuti. In alcuni casi, potresti voler montare solo una directory specifica. Ad esempio, se il bucket contiene un numero elevato di file, il montaggio di una directory specifica può migliorare le prestazioni.

Puoi anche implementare questa soluzione per scopi di isolamento, quando hai bisogno che servizi diversi abbiano accesso a directory diverse nel bucket di archiviazione.

La seguente riga di comando specifica la directory da montare:

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

Sostituisci quanto segue:

SERVICE: il nome del servizio.
BUCKET_NAME: il nome del bucket Cloud Storage.
MOUNT_PATH: il percorso relativo in cui stai montando il volume, ad esempio /cache.

Imposta il volume `UID` e `GID`

Utilizza le opzioni di montaggio uid e gid per modificare l'identificatore dell'utente e l'identificatore del gruppo per il volume. Questo è utile se vuoi impostare la proprietà del file su un utente o un gruppo specifico corrispondente all'identità di uno o più container in esecuzione. Per impostazione predefinita, i volumi sono di proprietà di root.

La seguente riga di comando imposta uid e gid:

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

Sostituisci quanto segue:

SERVICE: il nome del servizio.
MOUNT_PATH: il percorso relativo in cui stai montando il volume, ad esempio /cache.
BUCKET_NAME: il nome del bucket Cloud Storage.
UID: ID utente per montare il volume.
GID: l'ID gruppo per montare il volume.

Imposta altre opzioni di montaggio

Di seguito è riportato l'elenco completo di tutte le opzioni di montaggio supportate da Cloud Run.

Directory

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

Autorizzazioni

uid
gid
file-mode
dir-mode

Altro

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

Per descrizioni dettagliate di queste opzioni, consulta Opzioni di montaggio della riga di comando di Cloud Storage FUSE. La pagina di Cloud Storage FUSE elenca tutte le opzioni FUSE disponibili, alcune delle quali non sono supportate da Cloud Run.

Visualizza le impostazioni dei montaggi volume

Console

Nella console Google Cloud , vai alla pagina Servizi di Cloud Run:

Vai a Cloud Run
Nell'elenco dei servizi, fai clic sul servizio che ti interessa per aprire la pagina dei dettagli del servizio.
Fai clic sulla scheda Container per visualizzare i dettagli del volume.

gcloud

Per visualizzare le impostazioni di montaggio del volume, esegui questo comando:
```
gcloud run services describe SERVICE_NAME
```
Individua l'impostazione Montaggi di volumi nell'output restituito.

Ottimizza le prestazioni della larghezza di banda della rete di Cloud Storage FUSE

Per migliorare le prestazioni di lettura e scrittura, connetti il servizio Cloud Run a una rete VPC utilizzando il VPC diretto e instrada tutto il traffico in uscita attraverso la rete VPC. Puoi farlo utilizzando una delle seguenti opzioni:

Abilita l'accesso privato Google, assicurandoti di impostare il parametro vpc-egress su all-traffic.
Utilizza una delle opzioni descritte nella pagina delle best practice per il networking, nella sezione Traffico interno verso un'API di Google.

Tempo di avvio del container e montaggi di Cloud Storage FUSE

L'utilizzo di Cloud Storage FUSE può aumentare leggermente il tempo di avvio a freddo del container Cloud Run, perché Cloud Run avvia il montaggio del volume prima di avviare i container. Il container verrà avviato solo se Cloud Storage FUSE viene montato correttamente.

Tieni presente che Cloud Storage FUSE monta correttamente un volume solo dopo aver stabilito una connessione a Cloud Storage. Eventuali ritardi di rete possono influire sul tempo di avvio del container. Di conseguenza, se il tentativo di connessione non va a buon fine, il montaggio di Cloud Storage FUSE non riuscirà e il servizio Cloud Run non verrà avviato. Inoltre, se il montaggio di Cloud Storage FUSE richiede più di 30 secondi, il servizio Cloud Run non verrà avviato perché Cloud Run ha un timeout totale di 30 secondi per eseguire tutti i montaggi.

Caratteristiche delle prestazioni di Cloud Storage FUSE

Se definisci due volumi, ciascuno che punta a un bucket diverso, verranno avviati due processi Cloud Storage FUSE. I montaggi e i processi avvengono in parallelo.

Le operazioni che utilizzano Cloud Storage FUSE sono influenzate dalla larghezza di banda della rete perché Cloud Storage FUSE comunica con Cloud Storage utilizzando l'API Storage di Cloud Storage. Alcune operazioni, come l'elenco dei contenuti di un bucket, possono essere lente se la larghezza di banda della rete è bassa. Analogamente, la lettura di un file di grandi dimensioni può richiedere tempo, poiché è limitata anche dalla larghezza di banda della rete.

Quando scrivi in un bucket, Cloud Storage FUSE esegue la gestione temporanea completa dell'oggetto in memoria. Ciò significa che la scrittura di file di grandi dimensioni è limitata dalla quantità di memoria disponibile per l'istanza del container (il limite massimo di memoria del container è 32 GiB).

La scrittura viene trasferita nel bucket solo quando esegui un'operazione close o fsync: l'oggetto completo viene quindi caricato nel bucket. L'unica eccezione al caricamento completo di un oggetto nel bucket è il caso di un file con contenuti aggiunti quando il file è di almeno 2 MiB.

Per maggiori informazioni, consulta le seguenti risorse:

Cancella e rimuovi volumi e punti di montaggio dei volumi

Puoi cancellare tutti i volumi e i montaggi oppure rimuovere singoli volumi e montaggi di volumi.

Cancella tutti i volumi e i punti di montaggio dei volumi

Per cancellare tutti i volumi e i punti di montaggio dei volumi dal servizio single-container, esegui questo comando:

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

Se hai più container, segui le convenzioni dell'interfaccia a riga di comando dei sidecar per cancellare volumi e montaggi dei volumi:

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

Rimuovi singoli volumi e punti di montaggio dei volumi

Per rimuovere un volume, devi anche rimuovere tutti i montaggi dei volumi che lo utilizzano.

Per rimuovere singoli volumi o montaggi di volumi, utilizza i flag remove-volume e remove-volume-mount:

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

Configurare i mount dei volumi Cloud Storage per i servizi Cloud Run Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Requisiti di memoria

Limitazioni

Percorsi non consentiti

Prima di iniziare

Ruoli obbligatori

Monta un volume Cloud Storage

Console

gcloud

YAML

Terraform

Scrivi

Lettura e scrittura su un volume

Nodejs

Python

Vai

Java

Configurazione del volume utilizzando le opzioni di montaggio

Specifica le opzioni di montaggio

Console

gcloud

YAML

Terraform

Opzioni di montaggio di uso comune

Configura le impostazioni di memorizzazione nella cache

Abilita il logging di debug

Disabilita directory implicite

Monta una directory specifica all'interno del bucket Cloud Storage

Imposta il volume UID e GID

Imposta altre opzioni di montaggio

Visualizza le impostazioni dei montaggi volume

Console

gcloud

Ottimizza le prestazioni della larghezza di banda della rete di Cloud Storage FUSE

Tempo di avvio del container e montaggi di Cloud Storage FUSE

Caratteristiche delle prestazioni di Cloud Storage FUSE

Cancella e rimuovi volumi e punti di montaggio dei volumi

Cancella tutti i volumi e i punti di montaggio dei volumi

Rimuovi singoli volumi e punti di montaggio dei volumi

Configurare i mount dei volumi Cloud Storage per i servizi Cloud Run

Imposta il volume `UID` e `GID`