Modifica istanze

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

Una volta creata, puoi modificare un'istanza Filestore nei seguenti modi:

Per informazioni dettagliate sulla scalabilità della capacità, consulta Scalare la capacità.

Alcune specifiche, come l'indirizzo IP dell'istanza, sono immutabili.

Istruzioni per la modifica di un'istanza

Google Cloud Console

Per modificare le istanze Filestore utilizzando la Google Cloud console, vai alla pagina Modifica istanza , dove puoi modificare la descrizione dell'istanza, gestire le regole di controllo dell'accesso basate su IP e scalare le prestazioni della condivisione file:

  1. Nella Google Cloud console, vai alla pagina Istanze Filestore.

    Vai alla pagina Istanze Filestore

  2. Fai clic sull'ID istanza dell'istanza che vuoi modificare.

  3. Nella pagina Dettagli istanza, fai clic su Modifica per andare alla pagina Modifica istanza.

  4. Modifica la descrizione dell'istanza, le regole di controllo dell'accesso basate su IP e la capacità in base alle esigenze. Per maggiori dettagli, consulta Creare istanze.

  5. Fai clic su Salva.

gcloud

Prima di iniziare

Per utilizzare gcloud CLI, devi installarlo o utilizzare Cloud Shell integrato nella Google Cloud console:

Vai alla Google Cloud console

Comando gcloud per la modifica di un'istanza

Puoi modificare un'istanza Filestore eseguendo il instances update comando. Se devi aggiornare le regole di configurazione per il controllo dell'accesso basato su IP, devi utilizzare il flag --flags-file e specificare un file di configurazione JSON. Se scegli questo metodo, non devi utilizzare il flag --file-share perché è già incluso nel file di configurazione JSON.

gcloud filestore instances update INSTANCE_ID
    --[project="PROJECT_ID"]
    --[location=LOCATION]
    --[performance=PERFORMANCE] \
    --[file-share=name="FILE_SHARE_NAME",CAPACITY=FILE_SHARE_SIZE]
    --[description="DESCRIPTION"]
    --[flags-file=FILE_NAME.json]

dove:

  • INSTANCE_ID è l'ID istanza dell'istanza Filestore che vuoi modificare.

  • PROJECT_ID è l'ID progetto del Google Cloud progetto che contiene l'istanza Filestore. Puoi saltare questo flag se l'istanza Filestore si trova nel progetto predefinito di gcloud. Puoi impostare il progetto predefinito eseguendo:

    gcloud config set project project-id

  • LOCATION è la località in cui risiede l'istanza Filestore. Per le istanze regionali e aziendali, specifica una regione. Per tutte le altre istanze, specifica una zona. Esegui il gcloud filestore zones list comando per ottenere un elenco delle zone supportate. Puoi saltare questo flag se l'istanza Filestore si trova nella zona predefinita di gcloud. Puoi impostare la zona predefinita eseguendo:

    gcloud config set filestore/zone zone

  • PERFORMANCE è la configurazione delle prestazioni utilizzata per specificare impostazioni delle prestazioni personalizzate indipendentemente dalla capacità scelta.

    Puoi utilizzare solo una delle seguenti opzioni:

    • max-iops-per-tb specifica una frequenza di IOPS per TiB che viene scalata linearmente con la capacità dell'istanza.

    • max-iops specifica una frequenza di IOPS fissa che non viene scalata con la capacità dell'istanza.

      Il formato è il seguente:

      --performance=max-iops-per-tb=17000

  • FILE_SHARE_NAME è il nome della condivisione file fornita dall'istanza Filestore. I nomi delle condivisioni file non possono essere modificati dopo la creazione dell'istanza.

  • FILE_SHARE_SIZE è la nuova dimensione che vuoi per la condivisione file. Puoi specificare la dimensione della condivisione file in numeri interi utilizzando GiB (valore predefinito) o TiB.

    Per visualizzare la quota disponibile, vai alla pagina Quote nella Google Cloud console:

    Vai alla pagina Quote

  • DESCRIPTION è la descrizione facoltativa dell'istanza Filestore.

  • FILE_NAME è il nome del file di configurazione JSON per il controllo dell'accesso basato su IP- .

    Esempio di file di configurazione JSON:

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

    dove:

    • 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 i seguenti livelli di servizio supportano le impostazioni di configurazione per gli intervalli di indirizzi IP sovrapposti:
      • Zonal
      • Regionale
      • Aziende
    • 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.
Esempio

L'esempio seguente aggiorna l'istanza nfs-server aumentando la dimensione della condivisione file a 3 TiB.

    gcloud filestore instances update nfs-server --zone=us-central1-c --file-share=name="vol1",capacity=3TiB
  ```

API REST

  1. Assicurati di aver installato e inizializzato gcloud CLI installato e inizializzato, che ti consente di generare un token di accesso per l'intestazione Authorization.

  2. Utilizza cURL per chiamare l'API Filestore:

    curl --request PATCH \
    'https://file.googleapis.com/v1/projects/PROJECT/locations/LOCATION/instances?instanceId=NAME?updateMask=performanceConfig%2CdeletionProtectionReason%2CdeletionProtectionEnabled&key=YOUR_API_KEY' \
    --header "Authorization: Bearer $(gcloud auth print-access-token)" \
    --header 'Accept: application/json' \
    --header 'Content-Type: application/json' \
    --data '{
            "tier":"TIER",
            "networks":[
                {
                "network":"NETWORK"
                }
              ],
            "performanceConfig": {"PERFORMANCE"}
            "fileShares":[
              {"capacityGb":CAPACITY,"name":"SHARE_NAME"}
              ],
            "deletionProtectionEnabled": true,
            "deletionProtectionReason": "PROTECTION_REASON"}' \
    --compressed

    Dove:

    • PROJECT è il nome del progetto in cui risiederà l'istanza. Ad esempio, my-genomics-project.
    • LOCATION è la località in cui risiederà l'istanza. Ad esempio, us-east1 o us-central1-a.
    • NAME è il nome dell'istanza che vuoi creare. Ad esempio, my-genomics-instance.

    • PERFORMANCE è la configurazione delle prestazioni utilizzata per specificare impostazioni delle prestazioni personalizzate.

      Puoi utilizzare solo una delle opzioni fornite.

      • iopsPerTB abilita le prestazioni personalizzate con una frequenza di IOPS definita dall'utente che viene scalata con la capacità dell'istanza. Per definire le IOPS per TiB, utilizza il campo maxIopsPerTb.

      • fixedIops abilita le prestazioni personalizzate con una frequenza di IOPS fissa che non viene scalata con la capacità dell'istanza. Per definire il valore IOPS fisso, utilizza il campo maxIops.

        Il formato è il seguente:

        "performanceConfig": {
    "iopsPerTb" : {
        "maxIopsPerTb":17000
    }
  }

    • CAPACITY è la dimensione, in GiB, che vuoi allocare per l'istanza. Ad esempio, 1024.

    • SHARE_NAME è il nome della condivisione file. Ad esempio, vol1.

    • PROTECTION_REASON se scegli di utilizzare il flag deletionProtectionEnabled, hai la possibilità di aggiungere una nota relativa all'impostazione. Per aggiungere la nota, utilizza il flag facoltativo deletionProtectionReason e includi una descrizione della giustificazione per l'impostazione scelta. Ad esempio, "Tutti i dati genomici devono rispettare le policy dell'organizzazione vigenti". Per ulteriori informazioni, consulta Protezione dall'eliminazione.

    Esempio

    L'esempio seguente aggiorna l'istanza nfs-server diminuendo il rapporto IOPS per TiB a 12000.

    curl --request PATCH \
    'https://file.googleapis.com/v1/projects/my-project/locations/us-central1/instances?instanceId=nfs-server?updateMask=performanceConfig%2CdeletionProtectionReason&key=12334fr232' \
    --header "Authorization: Bearer $(gcloud auth print-access-token)" \
    --header 'Accept: application/json' \
    --header 'Content-Type: application/json' \
    --data '{
              "performanceConfig":
                {
                  "iopsPerTb":
                    {
                      "maxIopsPerTb":12000
                    }
                },
              "deletionProtectionReason":"Deletion+not+allowed"}' \
    --compressed

Passaggi successivi