Modifica istanze

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

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

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

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

Istruzioni per modificare un'istanza

Console Google Cloud

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

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

    Vai alla pagina Istanze di 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 basato su IP e la capacità in base alle esigenze. Per maggiori dettagli, consulta Creazione di istanze.

  5. Fai clic su Salva.

gcloud

Prima di iniziare

Per utilizzare gcloud CLI, devi installarla o utilizzare Cloud Shell integrata nella console Google Cloud :

Vai alla console Google Cloud

Comando gcloud per modificare un'istanza

Puoi modificare un'istanza Filestore eseguendo il comando instances update. Se devi aggiornare le regole di configurazione per 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 del progetto Google Cloud che contiene l'istanza Filestore. Puoi saltare questo flag se l'istanza Filestore si trova nel progetto gcloud predefinito. Puoi impostare il progetto predefinito eseguendo:

    gcloud config set project project-id

  • LOCATION è la posizione in cui si trova l'istanza di Filestore. Per le istanze regionali e aziendali, specifica una regione. Per tutte le altre istanze, specifica una zona. Esegui il comando gcloud filestore zones list per ottenere un elenco delle zone supportate. Puoi saltare questo flag se l'istanza Filestore si trova nella zona predefinita 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 velocità di IOPS per TiB che viene scalata linearmente in base alla capacità dell'istanza.

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

      Il formato dovrebbe avere un aspetto simile al seguente:

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

  • FILE_SHARE_NAME è il nome della condivisione file pubblicata 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 impostare per la condivisione file. Puoi specificare la dimensione della condivisione file in numeri interi utilizzando GiB (impostazione predefinita) o TiB.

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

    Vai alla pagina Quote

  • DESCRIPTION è la descrizione facoltativa dell'istanza Filestore.

  • FILE_NAME è il nome del file di configurazione JSON per 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 o l'intervallo IP 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:
      • A livello di zona
      • 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

Il seguente esempio aggiorna l'istanza nfs-server aumentando le dimensioni 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. Avere gcloud CLI installata e inizializzata, il 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 consente prestazioni personalizzate con una frequenza di IOPS definita dall'utente che viene scalata in base alla capacità dell'istanza. Per definire gli IOPS per TiB, utilizza il campo maxIopsPerTb.

      • fixedIops consente prestazioni personalizzate con una frequenza di IOPS fissa che non viene scalata in base alla 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, puoi aggiungere una nota relativa all'impostazione. Per aggiungere la nota, utilizza il flag facoltativo deletionProtectionReason e includi una descrizione della giustificazione dell'impostazione che hai scelto. Ad esempio, "Tutti i dati genomici devono rispettare le norme attuali dell'organizzazione". Per saperne di più, 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