Crea un'istanza

Questa pagina mostra come creare un'istanza Filestore utilizzando la console Google Cloud o Google Cloud CLI.

Istruzioni per creare un'istanza

gcloud filestore instances create INSTANCE_ID \
    [--project=PROJECT_ID] \
    [--location=LOCATION] \
    [--description=DESCRIPTION] \
    [--performance=PERFORMANCE] \
    --tier=TIER \
    --file-share=name="FILE_SHARE_NAME",capacity=FILE_SHARE_SIZE \
    --network=name="VPC-NETWORK",[connect-mode=CONNECT_MODE],[reserved-ip-range="RESERVED_IP_ADDRESS"] \
    [--labels=KEY=VALUE,[KEY=VALUE,…]] \
    [--kms-key=KMS_KEY] \
    [--deletion-protection] \
    [--deletion-protection-reason="PROTECTION_REASON"]

gcloud filestore instances create render1 \
  --project=myproject \
  --region=us-central1 \
  --tier=REGIONAL \
  --performance=max-iops-per-tb=17000 \
  --network=name="default",reserved-ip-range="10.0.7.0/29" \
  --flags-file=nfs-export-options.json \
  --deletion-protection \
  --deletion-protection-reason="All genomics data must adhere to current
  organization policies."

 {
"--file-share":
  {
    "capacity": "2048",
    "name": "my_vol",
    "nfs-export-options": [
      {
        "access-mode": "READ_WRITE",
        "ip-ranges": [
          "10.0.0.0/29",
          "10.2.0.0/29"
        ],
        "squash-mode": "ROOT_SQUASH",
        "anon_uid": 1003,
        "anon_gid": 1003
      },
      {
        "access-mode": "READ_ONLY",
        "ip-ranges": [
          "192.168.0.0/26"
        ],
        "squash-mode": "NO_ROOT_SQUASH"
      }
    ]
  }
}

Informazioni su istanze e condivisioni

Un'istanza Filestore rappresenta la capacità di archiviazione fisica.

Una condivisione rappresenta una porzione allocata di spazio di archiviazione con un punto di accesso individuale e unico.

Tutti i livelli di servizio offrono opzioni di archiviazione con un rapporto di condivisione/istanza di 1:1. In alternativa, Filestore Multishares per Google Kubernetes Engine (GKE), disponibile solo per le istanze di livello Enterprise, offre l'accesso a più condivisioni su una singola istanza.

I nomi delle istanze o gli ID istanza vengono utilizzati dagli amministratori per gestire le istanze. I nomi delle condivisioni file vengono utilizzati dai client per connettersi alle condivisioni esportate da queste istanze.

Assegna un nome all'istanza

Il nome dell'istanza Filestore, o ID istanza, viene utilizzato per identificare l'istanza e nei comandi gcloud. Gli ID istanza devono essere conformi all'elemento <label> di RFC 1035. In particolare, devono:

• Deve avere una lunghezza compresa tra 1 e 63 caratteri.
• Inizia con una lettera minuscola.
• Essere composto da trattini, lettere minuscole o cifre.
• Terminare con lettere minuscole o cifre.

L'ID istanza deve essere univoco nel progetto Google Cloud e nella zona in cui si trova. Una volta creata un'istanza, il relativo ID non può essere modificato.

Configura livello di servizio

Seleziona il livello di servizio più adatto alle tue esigenze. Una volta creata un'istanza, il relativo livello di servizio non può essere modificato. Per una descrizione dettagliata delle funzionalità disponibili per livello di servizio, consulta Livelli di servizio.

Le operazioni Create per le istanze di zona, di regione e Enterprise possono richiedere da 15 minuti a un'ora, a seconda delle dimensioni dell'istanza.

La quota Filestore viene utilizzata quando inizia la creazione dell'istanza, ma non ti viene addebitato alcun costo per l'istanza durante questo periodo.

Alloca capacità

Alloca la capacità in base alla quantità necessaria quando crei l'istanza. Man mano che ti avvicini al limite di capacità, puoi aumentarla in base alle necessità senza influire sul runtime. Per scoprire come monitorare la capacità delle tue istanze, consulta Monitoraggio delle istanze.

Nella gcloud CLI, puoi specificare la capacità in numeri interi utilizzando GiB o TiB. L'unità predefinita è GiB.

La tabella seguente mostra le dimensioni delle istanze disponibili per ogni livello:

Le dimensioni delle istanze possono essere qualsiasi valore intero di gibibyte o il suo equivalente in tebibyte compreso tra le dimensioni minime e massime dell'istanza e divisibile per le dimensioni del passo incrementale. Ad esempio, le dimensioni valide per le istanze di livello a livello di zona con un intervallo di capacità più elevato includono 10 TiB, 12, 5 TiB e 15 TiB.

Una volta create, le istanze HDD base e SSD base possono solo fare lo scale up delle dimensioni. Tutti gli altri livelli di servizio possono aumentare o diminuire la capacità. Per saperne di più, vedi Modificare le istanze e Scalare la capacità.

Quota di capacità totale

A ogni progetto viene assegnata una quota di capacità separata, definita in base alla regione e al livello di servizio. I limiti di quota variano in base al livello di servizio.

Una volta raggiunto il limite di quota, non potrai creare altre istanze Filestore o aumentare la capacità delle istanze esistenti. Per visualizzare la quota disponibile, vai alla pagina Quote nella console Google Cloud :

Vai a Quote

Per informazioni su come richiedere una quota maggiore, consulta Richiesta di aumenti di quota.

Configura le prestazioni

Le prestazioni dell'istanza dipendono dal livello di servizio che scegli.

Livelli regionali e a livello di zona

• Per i livelli Regional e Zonal, le prestazioni personalizzate sono abilitate per impostazione predefinita quando utilizzi la console Google Cloud , consentendoti di configurare le prestazioni in base al workload e alla scalabilità. Puoi impostare un rapporto IOPS per TiB che consente alle IOPS dell'istanza di scalare con la capacità o un valore IOPS costante che non scala con la capacità, ma che può essere modificato in qualsiasi momento se la capacità cambia. Per informazioni dettagliate sui limiti, consulta Limiti di prestazioni personalizzate.

• La creazione di istanze regionali con capacità inferiore a 1024 GiB richiede l'abilitazione delle prestazioni personalizzate. Il valore IOPS minimo per queste istanze è 2000. Per saperne di più, consulta Istanze Filestore con capacità ridotta.

Livelli SSD base e HDD base

• Per i livelli SSD base, il numero di IOPS è costante e non cambia quando modifichi le impostazioni della capacità.
• Per i livelli HDD base, i limiti di prestazioni cambiano a seconda che la capacità rientri nell'intervallo da 1 TiB a 10 TiB o da 10 TiB a 63,9 TiB.

Per ulteriori informazioni sui limiti e sulle impostazioni delle prestazioni, consulta Prestazioni.

Specifica il rapporto IOPS per TiB

L'opzione Prestazioni personalizzate consente di specificare il rapporto nel campo IOPS per TiB in cui le prestazioni vengono scalate in base alla capacità.

Se vuoi utilizzare IOPS fisse, deseleziona la casella di controllo Scala le prestazioni in base alla capacità.

Supponendo di aver specificato i seguenti valori di rendimento iniziali:

• Capacità: 1 TiB
• IOPS per TiB: 6000
• Prestazioni (quando è selezionata la casella di controllo Scala le prestazioni in base alla capacità): 6000 IOPS

I seguenti esempi mostrano come le prestazioni scalano in base alle impostazioni modificate:

• Se aumenti IOPS per TiB a 7000, Rendimento viene impostato su 7000 IOPS.
• L'aumento della capacità a 2 TiB regola le prestazioni a 14.000 IOPS.
• Se riduci le prestazioni a 8000 IOPS, le IOPS per TiB vengono impostate su 4000.

Specifica un numero fisso di IOPS

Se deselezioni la casella di controllo Scala le prestazioni in base alla capacità, il campo Prestazioni specifica il numero di IOPS che vuoi utilizzare. Questo numero deve rientrare nell'intervallo di prestazioni ed essere un multiplo di 1000.

L'impostazione di un numero fisso di IOPS indipendentemente dalla capacità consente l'ottimizzazione delle prestazioni. Tuttavia, questa opzione impedisce la scalabilità automatica delle prestazioni con le modifiche della capacità. La modifica della capacità potrebbe richiedere la regolazione del valore delle prestazioni e viceversa.

Ad esempio, hai specificato i seguenti valori:

• Capacità: 4 TiB
• Prestazioni: 40.000 IOPS

A questo punto, puoi aumentare le prestazioni fino a 68.000 IOPS, che è il limite per 4 TiB di capacità. Vuoi aumentare le prestazioni a 70.000 IOPS,un valore che supera l'intervallo di prestazioni per la capacità di 4 TiB. Per mantenere la compatibilità, devi aumentare la capacità a 4,25 TiB o superiore per rientrare nell'intervallo di prestazioni.

Seleziona una località

La località si riferisce alla Regione e alla Zona in cui si trova l'istanza Filestore. Per ottenere le migliori prestazioni ed evitare addebiti per il networking tra regioni, assicurati che l'istanza Filestore si trovi nella stessa regione delle VM Compute Engine che devono accedervi.

Per saperne di più su regioni e zone, consulta Area geografica e regioni.

Seleziona il protocollo del file system

Seleziona il protocollo del file system più adatto alle tue esigenze. Filestore supporta i protocolli NFSv3 e NFSv4.1.

Configura connessioni

Seleziona il tipo di stack IP di rete e la rete VPC.

Scegli il tipo di stack IP di rete

Seleziona IPv4 o IPv6 come tipo di stack IP di rete.

Scegli rete VPC

La rete che selezioni per l'utilizzo con Filestore può essere una rete VPC standard o una rete VPC condiviso.

Rete VPC

Se utilizzi la console Google Cloud , devi utilizzare Private Service Connect, che consente ai consumer di accedere ai servizi gestiti privatamente dall'interno della propria rete VPC. Private Service Connect richiede al consumer di eseguire il provisioning di un singolo indirizzo IP interno nel proprio VPC per creare un endpoint Private Service Connect, anziché allocare un intero intervallo di indirizzi IP per facilitare la connessione.

Per creare un endpoint Private Service Connect nella rete di destinazione consumer, devi creare una policy di connessione ai servizi nel tuo progetto.

Per saperne di più su come utilizzare Private Service Connect, consulta Crea un'istanza Filestore con Private Service Connect.

La rete che scegli deve avere risorse IP disponibili sufficienti da dedicare all'istanza Filestore, altrimenti l'istanza non viene creata a causa dell'esaurimento degli indirizzi IP. Per saperne di più, consulta Requisiti di rete e delle risorse IP.

I client devono trovarsi sulla stessa rete dell'istanza Filestore per accedere ai file archiviati su questa istanza. Una volta creata un'istanza, questa selezione di rete non può essere modificata.

Rete VPC condivisa

Prima di poter creare un'istanza su una rete VPC condivisa in un progetto di servizio, l'amministratore di rete deve prima abilitare l'accesso privato ai servizi per la rete VPC condiviso. Se crei l'istanza nel progetto host, l'accesso privato ai servizi non è richiesto.

Le reti VPC condiviso vengono visualizzate nella console Google Cloud nel seguente formato:

projects/HOST_PROJECT_ID/global/networks/SHARED_VPC_NAME

Per le procedure dettagliate, consulta Creazione di un'istanza su una VPC condiviso condivisa.

Blocco dei file NFS

Se le applicazioni che prevedi di utilizzare con un'istanza Filestore richiedono il blocco dei file NFS, potresti dover aprire le porte utilizzate da Filestore nella rete che scegli, se una delle seguenti opzioni si applica al tuo caso d'uso:

• Una rete VPC diversa da quella predefinita.
• La rete VPC predefinita con regole firewall modificate.

Questa considerazione si applica solo alle istanze Filestore che utilizzano i metodi di connessione di accesso privato ai servizi o di peering diretto.

Per saperne di più, consulta Configurazione delle regole firewall.

Configura la condivisione file

Una condivisione file è la directory di un'istanza Filestore in cui sono archiviati tutti i file condivisi. È anche l'elemento che monti o mappi sulla VM client.

Il nome della condivisione file deve rispettare i seguenti requisiti:

• Deve avere una lunghezza compresa tra 1 e 32 caratteri per i livelli aziendale, regionale e di zona e tra 1 e 16 caratteri per i livelli di base.
• Inizia con una lettera.
• Essere composto da lettere maiuscole o minuscole, numeri e trattini bassi.
• Deve terminare con una lettera o un numero.

Configurare controllo dell'accesso basato su IP

Per impostazione predefinita, un'istanza Filestore concede l'accesso in lettura e scrittura a livello root a tutti i client, incluse le VM di Compute Engine e i cluster GKE, che condividono lo stesso progetto Google Cloud e la stessa rete VPC. Se vuoi limitare l'accesso, puoi farlo creando regole che concedono livelli di accesso specifici ai client in base al loro indirizzo IP. Una volta aggiunte le regole, l'accesso viene revocato per tutti gli indirizzi e gli intervalli IP non specificati in una regola. Le istanze zonali, regionali ed Enterprise supportano le impostazioni di configurazione per gli intervalli di indirizzi IP sovrapposti. Per saperne di più, consulta Autorizzazioni sovrapposte.

La tabella seguente descrive i privilegi di ciascun livello di accesso. Questi livelli di accesso vengono utilizzati solo nella console Google Cloud . In gcloud CLI e nell'API, devi specificare direttamente le configurazioni delle regole.

root-squash mappa tutte le richieste da uid 0 e gid 0 rispettivamente a anon_uid e anon_gid. Questa configurazione rimuove l'accesso a livello root dai client che tentano di accedere alla condivisione file come utente root.

Quando crei regole di accesso basate su IP:

• Devi specificare un indirizzo o un intervallo IP interno e il livello di accesso concesso.
• Almeno una regola deve concedere l'accesso admin al momento della creazione dell'istanza. Questa regola può essere rimossa una volta creata l'istanza.
• Le istanze di zona, di regione ed Enterprise supportano le impostazioni di configurazione per gli intervalli di indirizzi IP sovrapposti. Le istanze di livello Basic non sono supportate. Per saperne di più, consulta Autorizzazioni sovrapposte.

Nella console Google Cloud puoi creare fino a 4 regole diverse (admin, admin-viewer, editor, viewer) che coinvolgono fino a 64 indirizzi IP o intervalli diversi.

In gcloud CLI, puoi configurare fino a 64 indirizzi IP o blocchi CIDR diversi per istanza Filestore in un massimo di 10 regole diverse. Una regola è definita come la combinazione delle configurazioni access-mode, squash-mode e anon_uid/anon_gid. I campi anon_uid e anon_gid hanno valori predefiniti di 65534 e possono essere configurati solo tramite l'API e gcloud CLI.

Esempio

Ecco un esempio di tre diverse regole di accesso basate su IP:

• access-mode=READ_ONLY, squash-mode=ROOT_SQUASH, anon_uid=10000.
• access-mode=READ_WRITE, squash-mode=ROOT_SQUASH, anon_gid=150.
• access-mode=READ_WRITE, squash-mode=NO_ROOT_SQUASH.

Per creare regole di controllo dell'accesso basate su IP utilizzando gcloud CLI, utilizza il flag --flags-file con i comandi instances create o instances update e indirizzalo a un file di configurazione JSON. Ad esempio, se il file di configurazione JSON è denominato nfs-export-options.json, il flag sarà:

--flags-file=nfs-export-options.json

Esempio di file di configurazione JSON:

   {
  "--file-share":
    {
      "capacity": "2048",
      "name": "my_vol",
      "nfs-export-options": [
        {
          "access-mode": "READ_WRITE",
          "ip-ranges": [
            "10.0.0.0/29",
            "10.2.0.0/29"
          ],
          "squash-mode": "ROOT_SQUASH",
          "anon_uid": 1003,
          "anon_gid": 1003
        },
         {
          "access-mode": "READ_ONLY",
          "ip-ranges": [
            "192.168.0.0/26"
          ],
          "squash-mode": "NO_ROOT_SQUASH"
        }
      ]
    }
}

• ip-ranges è l'indirizzo IP o l'intervallo a cui concedere l'accesso. Puoi specificare più indirizzi IP o intervalli separandoli con una virgola. Solo le istanze zonali, regionali ed enterprise supportano le impostazioni di configurazione per intervalli di indirizzi IP sovrapposti. Per saperne di più, consulta Autorizzazioni sovrapposte.
• access-mode è il livello di accesso da concedere ai client il cui indirizzo IP rientra in ip-range. Può avere i valori READ_WRITE o READ_ONLY. Il valore predefinito è READ_WRITE.
• squash-mode può avere i valori ROOT_SQUASH o NO_ROOT_SQUASH. ROOT_SQUASH rimuove l'accesso a livello di root ai client il cui indirizzo IP rientra in ip-range, mentre NO_ROOT_SQUASH abilita l'accesso root. Il valore predefinito è NO_ROOT_SQUASH.
• anon_uid è il valore dell'ID utente che vuoi mappare a anon_uid. Il valore predefinito è 65534.
• anon_gid è il valore dell'ID gruppo che vuoi mappare a anon_gid. Il valore predefinito è 65534.

Client su intervalli non RFC 1918

Se prevedi di connettere client non RFC 1918 alla tua istanza Filestore, devi concedere esplicitamente l'accesso all'istanza Filestore utilizzando il controllo degli accessi basato su IP.

Campi facoltativi

Le sezioni seguenti descrivono i campi facoltativi.

Aggiungere una descrizione dell'istanza

Una descrizione dell'istanza ti consente di scrivere descrizioni, note o istruzioni per te e per altri utenti. Ad esempio, puoi includere informazioni su:

• I tipi di file archiviati nell'istanza.
• Chi ha accesso all'istanza.
• Istruzioni su come ottenere l'accesso all'istanza.
• Lo scopo dell'istanza.

Le descrizioni delle istanze hanno un limite di 2048 caratteri. Non sono previste limitazioni per i caratteri consentiti. Una volta creata un'istanza Filestore, puoi aggiornarne la descrizione in qualsiasi momento, se necessario. Per informazioni sull'aggiornamento delle descrizioni delle istanze, consulta Modifica delle istanze.

Aggiungi etichette

Le etichette sono coppie chiave-valore che puoi utilizzare per raggruppare istanze correlate e archiviare i metadati di un'istanza. Puoi aggiungere, eliminare o modificare le etichette in qualsiasi momento. Per saperne di più, consulta Gestione delle etichette.

Configura un intervallo di indirizzi IP riservato

A ogni istanza Filestore deve essere associato un intervallo di indirizzi IP. Sono supportati sia gli intervalli di indirizzi IP RFC 1918 sia quelli non RFC 1918 (GA).

Una volta specificato, l'intervallo di indirizzi IP di un'istanza è immutabile.

Invitiamo gli utenti a consentire a Filestore di determinare automaticamente un intervallo di indirizzi IP libero e assegnarlo all'istanza. Quando selezioni il tuo intervallo, tieni presente i seguenti requisiti delle risorse IP di Filestore:

• Deve utilizzare la notazione CIDR.

• Deve essere un intervallo di subnet VPC valido.

• Le istanze di base richiedono una dimensione del blocco di 29. Ad esempio, 10.123.123.0/29.

• Le istanze a livello di zona, regione e aziendale richiedono una dimensione del blocco pari a 26. Ad esempio, 172.16.123.0/26.

• L'intervallo di indirizzi IP non deve sovrapporsi a quanto segue:

  • Le subnet esistenti nella rete VPC utilizzata dall'istanza Filestore.

  • Subnet esistenti in una rete VPC in peering con quella utilizzata dall'istanza Filestore. Per maggiori dettagli, consulta Subnet sovrapposte al momento del peering.

  • Intervalli di indirizzi IP assegnati ad altre istanze Filestore esistenti nella rete.

  • L'intervallo di indirizzi 172.17.0.0/16 è riservato ai componenti Filestore interni. Di conseguenza, si applicano le seguenti limitazioni:

    • I client in questo intervallo non possono essere connessi alle istanze Filestore.

    • Non è possibile creare istanze Filestore all'interno di questo intervallo IP. Per saperne di più, vedi Problemi noti.

• Deve essere presente almeno una connessione di peering di rete VPC o di accesso privato ai servizi per VPC.

Puoi visualizzare gli intervalli di indirizzi IP per le subnet della tua rete andando alla pagina Reti VPC nella console Google Cloud :

Vai a Reti VPC

Puoi ottenere l'intervallo di indirizzi IP riservati per qualsiasi istanza Filestore nella pagina delle istanze Filestore della consoleGoogle Cloud :

Vai a Istanze di Filestore

Se vuoi utilizzare l'accesso privato ai servizi e specificare un intervallo di indirizzi IP riservati, devi specificare il nome di un intervallo di indirizzi allocato per la connessione. Se non specifichi un nome di intervallo, Filestore utilizza automaticamente uno degli intervalli allocati associati alla connessione di accesso privato ai servizi.

Utilizza una chiave di crittografia gestita dal cliente

Per impostazione predefinita, Google Cloud cripta automaticamente i dati at-rest utilizzando chiavi di crittografia gestite da Google. Se hai bisogno di un maggiore controllo sulle chiavi che proteggono i tuoi dati, puoi utilizzare le chiavi di crittografia gestite dal cliente (CMEK) per Filestore. Per maggiori dettagli, consulta Cripta i dati con chiavi di crittografia gestite dal cliente.

Abilita la protezione da eliminazione

Configura l'impostazione della protezione da eliminazione dell'istanza. Per impostazione predefinita, questa impostazione è disattivata. Per saperne di più, consulta Protezione dall'eliminazione.

Aggiungi una descrizione dell'impostazione della protezione da eliminazione

Aggiungi una descrizione della motivazione alla base dell'impostazione di protezione dall'eliminazione che hai scelto. Per saperne di più, consulta Protezione dall'eliminazione.

Passaggi successivi

• Scopri come configurare un'istanza per l'utilizzo con il protocollo NFSv4.1.
• Scopri come connettere le istanze ai client:
  • Monta la condivisione file di Filestore su un'istanza VM di Compute Engine.
  • Accedi alle istanze Filestore con il driver CSI Filestore.
  • Utilizza le istanze Filestore come datastore esterni per gli host VMware ESXi in Google Cloud VMware Engine.
  • Monta le condivisioni file su client remoti.
  • Monta un'istanza Filestore su un servizio Cloud Run per condividere i dati tra container e servizi.
• Scopri come recuperare i dettagli dell'istanza, ad esempio il suo indirizzo IP, in modo da poter accedere alla condivisione file di Filestore dai client.
• Risolvi i problemi di creazione delle istanze relativi a Filestore.
• Scopri di più sulle reti e sulle subnet VPC.
• Scopri di più sui requisiti delle risorse di rete e IP per Filestore.