Edit instance

Halaman ini menunjukkan cara mengedit instance Filestore menggunakan konsol atau gcloud CLI.Google Cloud

Setelah dibuat, Anda dapat mengubah instance Filestore dengan cara berikut:

  • Meningkatkan kapasitasnya
  • Menurunkan kapasitas untuk tingkat layanan berikut:
    • Zonal
    • Regional
    • Enterprise
  • Mengonfigurasi performa
  • Mengubah deskripsinya
  • Mengelola aturan kontrol akses berbasis IP
  • Mengelola label

Untuk mengetahui detail tentang penskalaan kapasitas, lihat Menskalakan kapasitas.

Spesifikasi tertentu, seperti alamat IP instance, tidak dapat diubah.

Petunjuk untuk mengedit instance

Google Cloud Konsol

Untuk mengedit instance Filestore menggunakan Google Cloud konsol, buka halaman Edit instance, tempat Anda dapat mengedit deskripsi instance, mengelola aturan kontrol akses berbasis IP, dan menskalakan performa berbagi file:

  1. Di Google Cloud konsol, buka halaman Instance Filestore.

    Buka halaman instance Filestore

  2. Klik ID instance yang ingin Anda edit.

  3. Di halaman Instance details, klik Edit untuk membuka halaman Edit instance.

  4. Ubah deskripsi instance, aturan kontrol akses berbasis IP, dan kapasitas sesuai kebutuhan. Untuk mengetahui detailnya, lihat Membuat instance.

  5. Klik Save.

gcloud

Sebelum memulai

Untuk menggunakan gcloud CLI, Anda harus menginstal gcloud CLI atau menggunakan Cloud Shell yang terintegrasi ke dalam Google Cloud konsol:

Buka Google Cloud konsol

Perintah gcloud untuk mengedit instance

Anda dapat mengedit instance Filestore dengan menjalankan perintah instances update. Jika perlu memperbarui aturan konfigurasi untuk kontrol akses berbasis IP, Anda harus menggunakan flag --flags-file dan menentukan file konfigurasi JSON. Jika memilih metode ini, Anda tidak perlu menggunakan flag --file-share karena sudah disertakan dalam file konfigurasi 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]

dengan:

  • INSTANCE_ID adalah ID instance Filestore yang ingin Anda edit.

  • PROJECT_ID adalah ID project yang Google Cloud berisi instance Filestore. Anda dapat melewati flag ini jika instance Filestore berada di project default gcloud. Anda dapat menetapkan project default dengan menjalankan:

    gcloud config set project project-id

  • LOCATION adalah lokasi tempat instance Filestore berada. Untuk instance regional dan enterprise, tentukan region. Untuk semua instance lainnya, tentukan zona. Jalankan perintah gcloud filestore zones list untuk mendapatkan daftar zona yang didukung. Anda dapat melewati flag ini jika instance Filestore berada di zona default gcloud. Anda dapat menetapkan zona default dengan menjalankan:

    gcloud config set filestore/zone zone

  • PERFORMANCE adalah konfigurasi performa yang digunakan untuk menentukan setelan performa kustom secara terpisah dari kapasitas yang dipilih.

    Anda hanya dapat menggunakan salah satu opsi berikut:

    • max-iops-per-tb menentukan rasio IOPS per TiB yang diskalakan secara linear dengan kapasitas instance.

    • max-iops menentukan rasio IOPS tetap yang tidak diskalakan dengan kapasitas instance.

      Formatnya terlihat sebagai berikut:

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

  • FILE_SHARE_NAME adalah nama berbagi file yang ditampilkan dari instance Filestore. Nama berbagi file tidak dapat diubah setelah pembuatan instance.

  • FILE_SHARE_SIZE adalah ukuran baru yang Anda inginkan untuk berbagi file. Anda dapat menentukan ukuran berbagi file dalam bilangan bulat menggunakan GiB (default) atau TiB.

    Untuk melihat kuota yang tersedia, buka halaman Quotas di Google Cloud konsol:

    Buka halaman Quotas

  • DESCRIPTION adalah deskripsi instance Filestore opsional.

  • FILE_NAME adalah nama file konfigurasi json untuk kontrol akses berbasis IP- .

    Contoh file konfigurasi 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"
      }
    ],
  }
}

    dengan:

    • ip-ranges adalah alamat atau rentang IP untuk memberikan akses. Anda dapat menentukan beberapa alamat atau rentang IP dengan memisahkannya menggunakan koma. Hanya tingkat layanan berikut yang mendukung setelan konfigurasi untuk rentang alamat IP yang tumpang-tindih:
      • Zonal
      • Regional
      • Enterprise
    • access-mode adalah tingkat akses yang akan diberikan kepada klien yang alamat IP-nya berada dalam ip-range. Nilai yang dapat digunakan adalah READ_WRITE atau READ_ONLY. Nilai defaultnya adalah READ_WRITE.
    • squash-mode dapat memiliki nilai ROOT_SQUASH atau NO_ROOT_SQUASH. ROOT_SQUASH menghapus akses tingkat root ke klien yang alamat IP-nya berada dalam ip-range, sedangkan NO_ROOT_SQUASH mengaktifkan akses root. Nilai defaultnya adalah NO_ROOT_SQUASH.
    • anon_uid adalah nilai ID pengguna yang ingin Anda petakan ke anon_uid. Nilai defaultnya adalah 65534.
    • anon_gid adalah nilai ID grup yang ingin Anda petakan ke anon_gid. Nilai defaultnya adalah 65534.
Contoh

Contoh berikut memperbarui instance nfs-server dengan meningkatkan ukuran berbagi file menjadi 3 TiB.

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

REST API

  1. Pastikan gcloud CLI telah diinstal dan diinisialisasi, yang memungkinkan Anda membuat token akses untuk header Authorization.

  2. Gunakan cURL untuk memanggil Filestore API:

    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

    Dengan:

    • PROJECT adalah nama project tempat instance Anda akan berada. Misalnya, my-genomics-project.
    • LOCATION adalah lokasi tempat instance akan berada. Misalnya, us-east1 atau us-central1-a.
    • NAME adalah nama instance yang ingin Anda buat. Misalnya, my-genomics-instance.

    • PERFORMANCE adalah konfigurasi performa yang digunakan untuk menentukan setelan performa kustom.

      Anda hanya dapat menggunakan salah satu opsi yang disediakan.

      • iopsPerTB mengaktifkan performa kustom dengan rasio IOPS yang ditentukan pengguna dan diskalakan dengan kapasitas instance. Untuk menentukan IOPS per TiB, gunakan kolom maxIopsPerTb.

      • fixedIops mengaktifkan performa kustom dengan rasio IOPS tetap yang tidak diskalakan dengan kapasitas instance. Untuk menentukan nilai IOPS tetap, gunakan kolom maxIops.

        Formatnya adalah sebagai berikut:

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

    • CAPACITY adalah ukuran, dalam GiB, yang ingin Anda alokasikan untuk instance. Misalnya, 1024.

    • SHARE_NAME adalah nama berbagi file. Misalnya, vol1.

    • PROTECTION_REASON jika Anda memilih untuk menggunakan flag deletionProtectionEnabled, Anda memiliki opsi untuk menambahkan catatan terkait setelan tersebut. Untuk menambahkan catatan, gunakan flag deletionProtectionReason opsional dan sertakan deskripsi justifikasi untuk setelan yang Anda pilih. Misalnya, "Semua data genomik harus mematuhi kebijakan organisasi saat ini". Untuk mengetahui informasi selengkapnya, lihat Perlindungan penghapusan.

    Contoh

    Contoh berikut memperbarui instance nfs-server dengan mengurangi rasio IOPS per TiB menjadi 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

Langkah berikutnya