Utilizzo dei file system di rete NBD, 9P, CIFS/Samba e Ceph

Questa pagina descrive l'utilizzo di NBD, 9P, CIFS/Samba e Ceph come file system di rete con Cloud Run.

Se utilizzi NFS, Filestore o Cloud Storage FUSE su Cloud Run, consulta le seguenti pagine:

  • Configurazione del volume NFS per servizi o job
  • Configurazione del volume Cloud Storage per servizi o job

Puoi utilizzare i file system di rete NBD, 9P, CIFS/Samba e Ceph per condividere e mantenere i dati tra più contenitori e servizi in Cloud Run. Questa funzionalità è disponibile solo se utilizzi l'ambiente di esecuzione di seconda generazione di Cloud Run.

Se devi leggere e scrivere file nel tuo servizio Cloud Run utilizzando questi file system, hai a disposizione diverse opzioni:

  • Se non devi mantenere i dati oltre il ciclo di vita dell'istanza, puoi utilizzare il file system in memoria integrato.
  • Se devi mantenere i dati oltre la durata delle istanze e vuoi utilizzare la semantica del file system standard, utilizza i file system di rete NDB, 9P, CIFS/Samba e Ceph con Cloud Run.
  • Se devi mantenere i dati oltre la durata delle istanze e non hai bisogno della semantica del file system standard, l'opzione più semplice è utilizzare le librerie client di Cloud Storage. Questa è anche una buona opzione se devi accedere ai dati di molte istanze contemporaneamente.

Limitazioni

Le seguenti considerazioni si applicano all'utilizzo dei Network File System NDB, 9P, CIFS/Samba e Ceph su Cloud Run:

  • Devi specificare l'ambiente di esecuzione di seconda generazione quando esegui il deployment su Cloud Run.

  • Cloud Run è progettato per scalare rapidamente a un numero elevato di istanze. Tuttavia, la maggior parte dei file system di rete non è progettata per l'uso simultaneo da parte di un numero elevato di client. Valuta la possibilità di utilizzare la funzionalità Istanze massime per limitare il numero di istanze Cloud Run.

Configurare un file system di rete

Se non hai già configurato un file server, segui la guida alla soluzione File server su Compute Engine per selezionare e configurare il file system adatto alle tue esigenze. Se utilizzi un file server esistente, assicurati che sia accessibile da una rete VPC

Configurare un connettore di accesso VPC serverless

Devi utilizzare il connettore di accesso VPC serverless per connettere il servizio Cloud Run alla rete VPC in cui è in esecuzione il file system di rete.

Per creare un connettore di accesso VPC serverless sulla stessa rete VPC per collegarti al servizio Cloud Run, segui le istruzioni riportate nella pagina Connessione a una rete VPC.

Monta il file system dal servizio Cloud Run

Per montare un file system di rete:

  1. Definisci uno script di avvio che avvii l'applicazione e specifichi il punto di montaggio del tuo Dockerfile, utilizzando gli esempi riportati di seguito e sostituendo le variabili in base alle esigenze:

    • Per NBD 

       echo "mounting ext4 image via NBD"
 nbd-client -L -name image IP_ADDRESS DEVICE_NAME
 mount DEVICE_NAME MOUNT_POINT_DIRECTORY

    • Per PD-SSD tramite NBD 

       echo "mounting PD-SSD via NBD"
 nbd-client -L -name disk IP_ADDRESS DEVICE_NAME
 mount DEVICE_NAME MOUNT_POINT_DIRECTORY

    • Per 9P 

       echo "mounting 9p export"
 mount -t 9p -o trans=tcp,aname=/mnt/diod,version=9p2000.L,uname=root,access=user IP_ADDRESS MOUNT_POINT_DIRECTORY

    • Per SMB 

       echo "mounting SMB public share"
 mount -t cifs -ousername=USERNAME,password=PASSWORD,ip=IP_ADDRESS //FILESHARE_NAME MOUNT_POINT_DIRECTORY
 echo "mounts completed"

  2. Definisci la configurazione dell'ambiente con il Dockerfile. Utilizzerai RUN per specificare eventuali pacchetti di sistema aggiuntivi necessari, ad esempio nbd-client per NBD. Utilizza CMD per specificare il comando da eseguire quando viene eseguita l'immagine (lo script di avvio run.sh) e per fornire gli argomenti predefiniti per ENTRYPOINT, che specifica il file binario del processo di inizializzazione.

Accedere a un file system di rete dal codice del servizio Cloud Run

Per accedere ai file system di rete nel codice di servizio, utilizza le operazioni di lettura e scrittura dei file come di consueto.

Containerizza ed esegui il deployment

Quando il codice del servizio Cloud Run è completo, esegui il containerizzazione ed esegui il deploy come faresti normalmente per un servizio Cloud Run, assicurandoti di specificare l'ambiente di esecuzione di seconda generazione.

Passaggi successivi