Untuk mengetahui informasi versi, lihat catatan rilis Distributed Cloud terhubung.

Membuat dan mengelola cluster

Halaman ini menjelaskan cara membuat dan mengelola resource cluster Google Distributed Cloud.

Untuk mengetahui informasi selengkapnya tentang cluster Distributed Cloud, lihat Cara kerja Distributed Cloud.

Server Cloud Terdistribusi hanya mendukung cluster bidang kontrol lokal. Anda tidak dapat membuat cluster bidang kontrol Cloud di Distributed Cloud Servers.

Cluster bidang kontrol lokal di Distributed Cloud 1.5.x

Setelah Google mengupdate deployment Distributed Cloud Anda ke versi 1.5.0 atau yang lebih baru, Anda harus menghapus dan membuat ulang semua cluster bidang kontrol lokal yang telah Anda buat dengan Distributed Cloud versi 1.4.0 secara manual. Jika tidak, perilaku yang tidak terduga dan kehilangan data dapat terjadi. Cluster yang dikonfigurasi untuk menggunakan bidang kontrol cloud akan terus berjalan normal setelah Google memperbarui deployment Distributed Cloud ke versi 1.5.0 atau yang lebih baru.

Membuat cluster

Untuk membuat cluster Distributed Cloud, selesaikan langkah-langkah di bagian ini. Membuat cluster adalah salah satu dari beberapa langkah yang diperlukan untuk men-deploy workload di Distributed Cloud.

Untuk membuat cluster dengan bidang kontrol lokal yang dapat menjalankan workload saat terputus sementara dari Google Cloud, baca terlebih dahulu Mode kemampuan bertahan.

Untuk menyelesaikan tugas ini, Anda harus memiliki peran Admin Edge Container (roles/edgecontainer.admin) di project Google Cloud Anda.

Anda harus mengupgrade Google Cloud SDK ke versi 450.0.0 atau yang lebih baru untuk membuat cluster bidang kontrol lokal yang menjalankan software Distributed Cloud versi 1.5.0. Jika tidak, pembuatan cluster tersebut akan gagal.

Konsol

Di konsol Google Cloud , buka halaman Clusters.

Buka Cluster
Klik Buat kluster.
Di halaman Create a cluster, klik tab On-premises.
Di samping opsi Distributed Cloud Edge, klik Configure.
Di halaman Cluster basics, berikan informasi berikut:
- Name: nama unik yang mengidentifikasi cluster ini. Nama ini harus sesuai dengan RFC 1213 dan hanya terdiri dari karakter alfanumerik huruf kecil dan tanda hubung (-). Nama ini harus diawali dan diakhiri dengan karakter alfanumerik.
- Lokasi: region Google Cloud tempat Anda ingin membuat cluster ini.
- Pod maks default per node: jumlah maksimum Pod Kubernetes yang diinginkan untuk dieksekusi di setiap node dalam cluster ini.
- Label: memungkinkan Anda menambahkan satu atau beberapa label ke cluster ini dengan mengklik Tambahkan label.
Di navigasi kiri, klik Networking.
Di halaman Networking, berikan informasi berikut:
- Rentang alamat pod default cluster: blok CIDR IPv4 yang diinginkan untuk Pod Kubernetes yang berjalan di cluster ini.
- Rentang alamat layanan: blok CIDR IPv4 yang diinginkan untuk Layanan Kubernetes yang berjalan di cluster ini.
Untuk mengetahui informasi selengkapnya, lihat Alokasi alamat jaringan Pod dan Layanan Distributed Cloud.
Di navigasi sebelah kiri, klik Otorisasi.
Di halaman Otorisasi, berikan nama akun pengguna dalam project Google Cloud target yang diberi otorisasi untuk mengubah resource cluster.
Di navigasi sebelah kiri, klik Kebijakan pemeliharaan.

Peringatan: Cluster Distributed Cloud tidak memiliki periode pemeliharaan default. Artinya, update software berpotensi menghentikan workload penting. Untuk memastikan ketersediaan tinggi, Anda harus mengonfigurasi periode pemeliharaan bertahap untuk cluster Distributed Cloud agar update software terjadi pada waktu yang berbeda dan workload Anda tetap tersedia.
Di halaman Kebijakan pemeliharaan, berikan informasi berikut:
- Enable Maintenance Window: centang kotak ini untuk mengonfigurasi masa pemeliharaan untuk cluster. Untuk mencegah waktu nonaktif yang tidak terduga akibat update software Distributed Cloud, sebaiknya Anda selalu mengonfigurasi masa pemeliharaan untuk setiap cluster Distributed Cloud yang Anda buat. Untuk mengetahui informasi selengkapnya, lihat Memahami update software dan masa pemeliharaan.
- Waktu mulai: tanggal dan waktu yang diinginkan saat jendela pemeliharaan dimulai untuk cluster ini.
- End time: tanggal dan waktu yang diinginkan saat periode pemeliharaan berakhir untuk cluster ini.
- RRule: frekuensi periode pemeliharaan dalam format FREQ=WEEKLY|DAILY;BYDAY=MO,TU,WE,TH,FR,SA,SU:
  - FREQ dapat berupa DAILY atau WEEKLY.
  - BYDAY: daftar hari yang dipisahkan koma saat pemeliharaan dapat terjadi jika FREQ disetel ke WEEKLY. Jika Anda menghapus parameter BYDAY, Google akan memilih hari dalam seminggu untuk Anda.
  - Jika Anda menyetel FREQ ke DAILY, masa pemeliharaan akan terjadi setiap hari selama jam yang ditentukan.
Tetapkan node pool ke cluster dengan melakukan salah satu tindakan berikut:
- Untuk menetapkan node pool yang ada ke cluster ini, di bagian Node pool di navigasi kiri, pilih node pool yang ada dan verifikasi bahwa konfigurasi node pool di halaman Detail node pool sudah benar.
- Untuk membuat node pool baru yang akan ditetapkan ke cluster ini, klik add_boxAdd node pool dan berikan informasi berikut di halaman Node pool details:
  - Nama node pool: nama unik yang mengidentifikasi node pool ini.
  - Label kumpulan node: klik Tambahkan label untuk menambahkan satu atau beberapa label ke kumpulan node ini.
  - Preferensi node pekerja: pilih node Distributed Cloud yang akan ditetapkan ke node pool ini.
Untuk membuat cluster Distributed Cloud, klik Create.

gcloud

Gunakan perintah gcloud edge-cloud container clusters create:

gcloud edge-cloud container clusters create CLUSTER_ID \
    --project=PROJECT_ID \
    --location=REGION \
    --fleet-project=FLEET_PROJECT_ID \
    --cluster-ipv4-cidr=CLUSTER_IPV4_CIDR_BLOCK \
    --services-ipv4-cidr=SERVICE_IPV4_CIDR_BLOCK \
    --default-max-pods-per-node=MAX_PODS_PER_NODE \
    --release-channel RELEASE_CHANNEL \
    --control-plane-kms-key=CONTROL_PLANE_KMS_KEY \
    --control-plane-node-location=CONTROL_PLANE_LOCATION \
    --control-plane-node-count=CONTROL_PLANE_NODE_COUNT \
    --control-plane-machine-filter=CONTROL_PLANE_NODE_FILTER \
    --control-plane-shared-deployment-policy=CONTROL_PLANE_NODE_SHARING \
    --external-lb-ipv4-address-pools=IPV4_DATA_PLANE_ADDRESSES \
    --version SOFTWARE_VERSION \
    --offline-reboot-ttl REBOOT_TIMEOUT

Ganti kode berikut:

CLUSTER_ID: nama unik yang mengidentifikasi cluster ini. Nama ini harus sesuai dengan RFC 1213 dan hanya terdiri dari karakter alfanumerik huruf kecil dan tanda hubung (-). Nama ini harus diawali dan diakhiri dengan karakter alfanumerik.
PROJECT_ID: ID project Google Cloud target.
REGION: region Google Cloud tempat cluster dibuat dan tempat bidang kontrol Kubernetes untuk cluster disediakan.
FLEET_PROJECT_ID: ID project host Fleet tempat cluster terdaftar. Jika flag ini tidak ada, project cluster Distributed Cloud akan digunakan sebagai project host Fleet.
CLUSTER_IPV4_CIDR_BLOCK: blok CIDR IPv4 yang diinginkan untuk Pod Kubernetes yang berjalan di cluster ini.
SERVICE_IPV4_CIDR_BLOCK: blok CIDR IPv4 yang diinginkan untuk Layanan Kubernetes yang berjalan di cluster ini.
MAX_PODS_PER_NODE (opsional): jumlah maksimum Pod Kubernetes yang diinginkan untuk dieksekusi di setiap node dalam cluster ini.
RELEASE_CHANNEL: (opsional): menentukan saluran rilis untuk versi software Distributed Cloud yang ingin Anda jalankan di cluster ini. Nilai yang valid adalah REGULAR (mengaktifkan upgrade cluster otomatis) dan NONE (menonaktifkan upgrade cluster otomatis). Jika dihilangkan, setelan defaultnya adalah REGULAR.
CONTROL_PLANE_KMS_KEY (opsional): jalur lengkap ke kunci Cloud KMS yang ingin Anda gunakan dengan node bidang kontrol cluster ini. Contoh:
```
/projects/myProject/locations/us-west1-a/keyRings/myKeyRing/cryptoKeys/myGDCE-Key
```
Flag ini hanya berlaku jika Anda telah mengintegrasikan Distributed Cloud dengan Cloud Key Management Service seperti yang dijelaskan dalam Mengaktifkan dukungan untuk kunci enkripsi yang dikelola pelanggan (CMEK) untuk penyimpanan lokal.

Jika Anda membuat cluster dengan bidang kontrol lokal, selain mengganti variabel sebelumnya, ganti juga yang berikut:

CONTROL_PLANE_LOCATION: menginstruksikan Distributed Cloud untuk men-deploy beban kerja bidang kontrol untuk cluster ini secara lokal. Nilainya adalah nama target zona Distributed Cloud.
CONTROL_PLANE_NODE_COUNT (opsional): menentukan jumlah node tempat menjalankan workload bidang kontrol lokal. Nilai yang valid adalah 3 untuk ketersediaan tinggi dan 1 untuk operasi standar. Jika dihilangkan, setelan defaultnya adalah 3.
CONTROL_PLANE_NODE_FILTER (opsional): menentukan daftar node berformat regex yang menjalankan beban kerja bidang kontrol lokal. Jika tidak ditentukan, Distributed Cloud akan memilih node secara otomatis dan acak.
CONTROL_PLANE_NODE_SHARING: (opsional) menentukan apakah beban kerja aplikasi dapat berjalan di node yang menjalankan beban kerja bidang kontrol lokal. Nilai yang valid adalah DISALLOWED dan ALLOWED. Jika dihilangkan, Jika dihilangkan, setelan defaultnya adalah DISALLOWED.
IPV4_DATA_PLANE_ADDRESSES: menentukan daftar alamat IPv4, rentang alamat, atau subnetwork yang dipisahkan koma untuk traffic ingress untuk Layanan yang berjalan di belakang load balancer Distributed Cloud saat cluster berjalan dalam mode survivabilitas.
SOFTWARE_VERSION: menentukan versi software Distributed Cloud yang Anda inginkan untuk dijalankan cluster ini dalam format 1.X.Y dengan X adalah versi minor, dan Y adalah versi patch, misalnya 1.5.0. Jika tidak ditentukan, versi software default server akan digunakan secara default, yang biasanya merupakan versi Distributed Cloud terbaru yang tersedia. Untuk mendapatkan versi software yang tersedia untuk pembuatan cluster, termasuk versi default server, lihat Mendapatkan versi software yang tersedia untuk cluster.
REBOOT_TIMEOUT: (memerlukan gcloud alpha) menentukan jangka waktu dalam detik saat node cluster dapat bergabung kembali ke cluster setelah melakukan booting ulang saat cluster berjalan dalam mode survivabilitas. Jika tidak ditentukan, nilai defaultnya adalah 0 yang tidak mengizinkan node yang di-reboot untuk bergabung kembali ke cluster hingga koneksi ke Google Cloud terhubung kembali. Ini adalah fitur tingkat pratinjau.

PERHATIAN: Jika Anda menentukan periode waktu tunggu mulai ulang, node yang offline dapat dimulai ulang dan bergabung kembali ke cluster meskipun Anda menonaktifkan atau menghapus kunci penyimpanan untuk waktu yang ditentukan.

API

Buat permintaan POST ke metode projects.locations.clusters:

POST /v1/projects/PROJECT_ID/locations/REGION/clusters?clusterId=CLUSTER_ID&requestId=REQUEST_ID&fleetId=FLEET_PROJECT_ID

{
  "labels": { LABELS,
  },
  "authorization": {
    "adminUsers": {
      "username": "USERNAME"
    }
  },
  "fleet": {
    "project": "FLEET_PROJECT_ID"
  },
  "networking": {
    "clusterIpv4CidrBlocks": CLUSTER_IPV4_CIDR_BLOCK,
    "servicesIpv4CidrBlocks": SERVICE_IPV4_CIDR_BLOCK,
      },
  "defaultMaxPodsPerNode": MAX_PODS_PER_NODE,
  "releaseChannel": "RELEASE_CHANNEL",
  "controlPlaneEncryption": {
   "kmsKey": CONTROL_PLANE_KMS_KEY,
  },      
  "controlPlane": {
    "local": {
      "nodeLocation": "CONTROL_PLANE_LOCATION",
      "nodeCount": CONTROL_PLANE_NODE_COUNT,
      "machineFilter": "CONTROL_PLANE_NODE_FILTER",
      "sharedDeploymentPolicy": "CONTROL_PLANE_NODE_SHARING"
    }
  },
  "externalLoadBalancerIpv4AddressPools": [
    "IPV4_DATA_PLANE_ADDRESSES"
  ],
  "targetVersion": "SOFTWARE_VERSION",
  "offlineRebootTtl": "REBOOT_TIMEOUT",
}

Ganti kode berikut:

PROJECT_ID: ID project Google Cloud target.
REGION: Google Cloud region tempat cluster Distributed Cloud target dibuat.
CLUSTER_ID: nama unik yang mengidentifikasi cluster ini. Nama ini harus sesuai dengan RFC 1213 dan hanya terdiri dari karakter alfanumerik huruf kecil dan tanda hubung (-). Nama ini harus diawali dan diakhiri dengan karakter alfanumerik.
REQUEST_ID: ID terprogram unik yang mengidentifikasi permintaan ini.
FLEET_PROJECT_ID: ID project host Fleet tempat cluster terdaftar. Project ini dapat berupa project terpisah atau project Distributed Cloud tempat cluster ini berada (PROJECT_ID). Pendaftaran fleet bersifat wajib.
LABELS: daftar label yang akan diterapkan ke resource cluster ini.
USERNAME: nama akun pengguna dalam project Google Cloud target yang diberi otorisasi untuk mengubah resource cluster.
CLUSTER_IPV4_CIDR_BLOCK: blok CIDR IPv4 yang diinginkan untuk Pod Kubernetes yang berjalan di cluster ini.
SERVICE_IPV4_CIDR_BLOCK: blok CIDR IPv4 yang diinginkan untuk Layanan Kubernetes yang berjalan di cluster ini.
MAX_PODS_PER_NODE: jumlah maksimum Pod Kubernetes yang diinginkan untuk dieksekusi di setiap node dalam cluster ini.
RELEASE_CHANNEL: menentukan saluran rilis untuk versi software Distributed Cloud yang Anda inginkan agar cluster ini berjalan. Nilai yang valid adalah REGULAR dan NONE. Jika dihilangkan, setelan defaultnya adalah REGULAR.
CONTROL_PLANE_KMS_KEY (opsional): jalur lengkap ke kunci Cloud KMS yang ingin Anda gunakan dengan node bidang kontrol cluster ini. Contoh:
```
/projects/myProject/locations/us-west1-a/keyRings/myKeyRing/cryptoKeys/myGDCE-Key
```
Parameter ini hanya berlaku jika Anda telah mengintegrasikan Distributed Cloud dengan Cloud Key Management Service seperti yang dijelaskan dalam Mengaktifkan dukungan untuk kunci enkripsi yang dikelola pelanggan (CMEK) untuk penyimpanan lokal.

Jika Anda membuat cluster dengan bidang kontrol lokal, selain mengganti variabel sebelumnya, ganti juga yang berikut:

CONTROL_PLANE_LOCATION: menginstruksikan Distributed Cloud untuk men-deploy beban kerja bidang kontrol untuk cluster ini secara lokal. Nilainya adalah nama target zona Distributed Cloud.
CONTROL_PLANE_NODE_COUNT: menentukan jumlah node yang akan menjalankan beban kerja bidang kontrol lokal. Nilai yang valid adalah 3 untuk ketersediaan tinggi dan 1 untuk operasi standar.
CONTROL_PLANE_NODE_FILTER (opsional): menentukan daftar node berformat regex yang menjalankan beban kerja bidang kontrol lokal. Jika tidak ditentukan, Distributed Cloud akan memilih node secara otomatis dan acak.
CONTROL_PLANE_NODE_SHARING: menentukan apakah beban kerja aplikasi dapat berjalan di node yang menjalankan beban kerja bidang kontrol lokal. Nilai yang valid adalah DISALLOWED dan ALLOWED. Jika dihilangkan, nilai defaultnya adalah DISALLOWED.
IPV4_DATA_PLANE_ADDRESSES: menentukan daftar alamat IPv4, rentang alamat, atau subnetwork yang dipisahkan koma untuk traffic ingress untuk Layanan yang berjalan di belakang load balancer Distributed Cloud pada cluster bidang kontrol lokal. Tidak berlaku untuk cluster bidang kontrol Cloud.
SOFTWARE_VERSION: menentukan versi software Distributed Cloud yang Anda inginkan untuk dijalankan cluster ini dalam format 1.X.Y dengan X adalah versi minor, dan Y adalah versi patch, misalnya 1.5.0. Jika tidak ditentukan, versi software default server akan digunakan secara default, yang biasanya merupakan versi Distributed Cloud terbaru yang tersedia. Untuk mendapatkan versi software yang tersedia untuk pembuatan cluster, termasuk versi default server, lihat Mendapatkan versi software yang tersedia untuk cluster.
REBOOT_TIMEOUT: (memerlukan v1alpha1) menentukan jangka waktu dalam detik saat node cluster dapat bergabung kembali ke cluster setelah melakukan booting ulang saat cluster berjalan dalam mode survivabilitas. Jika tidak ditentukan, nilai defaultnya adalah 0 yang tidak mengizinkan node yang di-reboot untuk bergabung kembali ke cluster hingga koneksi ke Google Cloud terhubung kembali. Ini adalah fitur tingkat pratinjau.

PERHATIAN: Jika Anda menentukan periode waktu tunggu mulai ulang, node yang offline dapat dimulai ulang dan bergabung kembali ke cluster meskipun Anda menonaktifkan atau menghapus kunci penyimpanan untuk waktu yang ditentukan.

Mencantumkan cluster dalam region

Untuk mencantumkan cluster Distributed Cloud yang disediakan di Google Cloud region, selesaikan langkah-langkah di bagian ini.

Untuk menyelesaikan tugas ini, Anda harus memiliki peran Edge Container Viewer (roles/edgecontainer.viewer) di project Google Cloud Anda.

Konsol

Di konsol Google Cloud , buka halaman Clusters.

Buka Cluster
Periksa daftar cluster.

gcloud

Gunakan perintah gcloud edge-cloud container clusters list:

gcloud edge-cloud container clusters list \
    --project=PROJECT_ID \
    --location=REGION

Ganti kode berikut:

PROJECT_ID: ID project Google Cloud target.
REGION: Google Cloud region tempat Anda membuat cluster Distributed Cloud.

API

Buat permintaan GET ke metode projects.locations.clusters.list:

GET /v1/projects/PROJECT_ID/locations/REGION/clusters?clusterId=CLUSTER_ID&filter=FILTER&pageSize=PAGE_SIZE&orderBy=SORT_BY&pageToken=PAGE_TOKEN

Ganti kode berikut:

PROJECT_ID: ID project Google Cloud target.
REGION: Google Cloud region tempat cluster Distributed Cloud target dibuat.
CLUSTER_ID: nama cluster target.
FILTER: ekspresi yang membatasi hasil yang ditampilkan ke nilai tertentu.
PAGE_SIZE: jumlah hasil yang akan ditampilkan per halaman.
SORT_BY: daftar nama kolom yang dipisahkan koma yang digunakan untuk mengurutkan hasil yang ditampilkan. Urutan pengurutan default adalah menaik; untuk urutan pengurutan menurun, beri awalan kolom yang diinginkan dengan ~.
PAGE_TOKEN: token yang diterima dalam respons terhadap permintaan daftar terakhir di kolom nextPageToken dalam respons. Kirim token ini untuk menerima halaman hasil.

Mendapatkan informasi tentang cluster

Untuk mendapatkan informasi tentang cluster Distributed Cloud, selesaikan langkah-langkah di bagian ini.

Untuk menyelesaikan tugas ini, Anda harus memiliki peran Edge Container Viewer (roles/edgecontainer.viewer) di project Google Cloud Anda.

Konsol

Di konsol Google Cloud , buka halaman Clusters.

Buka Cluster
Pilih cluster yang diinginkan.

Panel yang dapat dilipat dengan informasi mendetail tentang cluster akan muncul di panel kanan.

gcloud

Gunakan perintah gcloud edge-cloud container clusters describe:

gcloud edge-cloud container clusters describe CLUSTER_ID \
    --project=PROJECT_ID \
    --location=REGION

Ganti kode berikut:

CLUSTER_ID: nama cluster target.
PROJECT_ID: ID project Google Cloud target.
REGION: Google Cloud region tempat Anda membuat zona Distributed Cloud.

API

Buat permintaan GET ke metode projects.locations.clusters.get:

GET /v1/projects/PROJECT_ID/locations/REGION/clusters/CLUSTER_ID

Ganti kode berikut:

PROJECT_ID: ID project Google Cloud target.
REGION: Google Cloud region tempat cluster Distributed Cloud target dibuat.
CLUSTER_ID: nama cluster target.

Mendapatkan versi software yang tersedia untuk cluster

Untuk mengetahui versi software Distributed Cloud yang tersedia di zona Distributed Cloud Anda untuk membuat cluster, selesaikan langkah-langkah di bagian ini.

Untuk menyelesaikan tugas ini, Anda harus memiliki peran Edge Container Viewer (roles/edgecontainer.viewer) di project Google Cloud Anda.

gcloud

Gunakan perintah gcloud edge-cloud container get-server-config:

gcloud edge-cloud container get-server-config --location=REGION

Ganti REGION: dengan Google Cloud region tempat Anda membuat zona Distributed Cloud.

API

Buat permintaan GET ke metode projects.locations.serverConfig:

GET /v1/projects/PROJECT_ID/locations/REGION/serverConfig

Ganti kode berikut:

PROJECT_ID: ID project Google Cloud target.
REGION: Google Cloud region tempat cluster Distributed Cloud target dibuat.

Mengupgrade versi software cluster bidang kontrol lokal

Untuk mengupgrade versi software cluster panel kontrol lokal Distributed Cloud, selesaikan langkah-langkah di bagian ini. Fitur ini tidak tersedia untuk cluster bidang kontrol Cloud.

Untuk menyelesaikan tugas ini, Anda harus memiliki peran Admin Edge Container (roles/edgecontainer.admin) di project Google Cloud Anda.

gcloud

Gunakan perintah gcloud edge-cloud container clusters upgrade:

gcloud edge-cloud container clusters upgrade CLUSTER_ID \
   --location=REGION \
   --project=PROJECT_ID \
   --schedule=UPGRADE_SCHEDULE \
   --version=SOFTWARE_VERSION

Ganti kode berikut:

CLUSTER_ID: nama cluster target.
REGION: Google Cloud region tempat cluster Distributed Cloud target dibuat.
PROJECT_ID: ID project Google Cloud target.
UPGRADE_SCHEDULE: menentukan kapan harus memicu upgrade software. Satu-satunya nilai yang valid adalah IMMEDIATELY.
SOFTWARE_VERSION: menentukan versi software Distributed Cloud yang Anda inginkan untuk dijalankan cluster ini dalam format 1.X.Y dengan X adalah versi minor, dan Y adalah versi patch, misalnya 1.5.1. Untuk mendapatkan versi software yang tersedia untuk pembuatan cluster, termasuk versi default server, lihat Mendapatkan versi software yang tersedia untuk cluster.

API

Buat permintaan POST ke metode projects.locations.clusters.upgrade:

POST /v1/projects/PROJECT_ID/locations/REGION/clusters/CLUSTER_ID:upgrade?requestId=REQUEST_ID
{
  "name": "projects/PROJECT_ID/locations/REGION/clusters/CLUSTER_ID",
  "targetVersion": "SOFTWARE_VERSION",
    "schedule": "UPGRADE_SCHEDULE",
}

Ganti kode berikut:

PROJECT_ID: ID project Google Cloud target.
REGION: Google Cloud region tempat cluster Distributed Cloud target dibuat.
CLUSTER_ID: nama cluster target.
REQUEST_ID: ID terprogram unik yang mengidentifikasi permintaan ini.
UPGRADE_SCHEDULE: menentukan kapan harus memicu upgrade software. Satu-satunya nilai yang valid adalah IMMEDIATELY.
SOFTWARE_VERSION: menentukan versi software Distributed Cloud yang Anda inginkan untuk dijalankan cluster ini dalam format 1.X.Y dengan X adalah versi minor, dan Y adalah versi patch, misalnya 1.5.1. Untuk mendapatkan versi software yang tersedia untuk pembuatan cluster, termasuk versi default server, lihat Mendapatkan versi software yang tersedia untuk cluster.

Upgrade software biasanya memerlukan waktu sekitar 2 jam per node yang merupakan bagian dari node pool cluster. Perintah ini menampilkan operasi yang memungkinkan Anda melacak progres upgrade software. Saat upgrade software sedang berlangsung, status cluster ditetapkan ke Reconciling dan kembali ke Running setelah upgrade selesai. Status cluster Error menunjukkan bahwa upgrade software gagal. Dalam kasus tersebut, jalankan proses upgrade lagi. Lihat Mendapatkan informasi tentang cluster untuk mengetahui informasi tentang cara memeriksa status cluster.

Mendapatkan kredensial untuk cluster

Untuk mendapatkan kredensial untuk cluster Distributed Cloud, selesaikan langkah-langkah di bagian ini.

Untuk menyelesaikan tugas ini, Anda harus memiliki peran Edge Container Viewer (roles/edgecontainer.viewer) di project Google Cloud Anda.

gcloud

Gunakan perintah gcloud edge-cloud container clusters get-credentials:

gcloud edge-cloud container clusters get-credentials CLUSTER_ID \
    --project=PROJECT_ID \
    --location=REGION

Ganti kode berikut:

CLUSTER_ID: nama cluster target.
PROJECT_ID: ID project Google Cloud target.
REGION: Google Cloud region tempat cluster Distributed Cloud target dibuat.

API

Buat permintaan GET ke metode projects.locations.clusters:

GET /v1/projects/PROJECT_ID/locations/REGION/clusters/CLUSTER_ID

Ganti kode berikut:

PROJECT_ID: ID project Google Cloud target.
REGION: region Google Cloud tempat zona Distributed Cloud target dibuat.
CLUSTER_ID: nama cluster target.

Mengonfigurasi masa pemeliharaan untuk cluster

Bagian ini menjelaskan cara menentukan jendela pemeliharaan dan menghapus jendela pemeliharaan untuk cluster Distributed Cloud.

Menentukan masa pemeliharaan untuk cluster

Untuk menentukan periode pemeliharaan untuk cluster Distributed Cloud, selesaikan langkah-langkah di bagian ini. Untuk mengetahui informasi selengkapnya tentang pemeliharaan cluster, lihat Memahami update software dan masa pemeliharaan.

Untuk format tanggal dan waktu, gunakan RFC 5545.

Untuk menyelesaikan tugas ini, Anda harus memiliki peran Admin Edge Container (roles/edgecontainer.admin) di project Google Cloud Anda.

Konsol

Jika menggunakan konsol Google Cloud , Anda hanya dapat menentukan periode pemeliharaan saat membuat cluster. Untuk menentukan periode pemeliharaan pada cluster yang ada, Anda harus menggunakan Google Cloud CLI atau Distributed Cloud Edge Container API.

gcloud

Gunakan perintah gcloud edge-cloud container clusters update:

gcloud edge-cloud container clusters update CLUSTER_ID \
    --project=PROJECT_ID \
    --location=REGION \
    --maintenance-window-start=MAINTENANCE_START \
    --maintenance-window-end=MAINTENANCE_END \
    --maintenance-window-recurrence=MAINTENANCE_FREQUENCY

Ganti kode berikut:

CLUSTER_ID: nama cluster target.
PROJECT_ID: ID project Google Cloud target.
REGION: Google Cloud region tempat cluster Distributed Cloud target dibuat.
MAINTENANCE_START: waktu mulai masa pemeliharaan dalam format YYYY-MM-DDTHH:MM:SSZ.
MAINTENANCE_END: waktu berakhir masa pemeliharaan dalam format YYYY-MM-DDTHH:MM:SSZ.
MAINTENANCE_FREQUENCY: frekuensi masa pemeliharaan dalam format FREQ=WEEKLY|DAILY;BYDAY=MO,TU,WE,TH,FR,SA,SU:
- BYDAY: daftar hari yang dipisahkan koma saat pemeliharaan dapat terjadi jika FREQ disetel ke WEEKLY. Jika Anda menghapus parameter BYDAY, Google akan memilih hari dalam seminggu untuk Anda.
- Jika Anda menyetel FREQ ke harian, masa pemeliharaan akan terjadi setiap hari selama jam yang ditentukan.

API

Buat permintaan PATCH ke metode projects.locations.clusters.update:

PATCH /v1/projects/PROJECT_ID/locations/REGION/clusters/CLUSTER_ID?updateMask=maintenancePolicy&requestId=REQUEST_ID
{
 "maintenance_policy": {
   "window": {
     "recurring_window": {
       "window": {
         "start_time": "MAINTENANCE_START",
         "end_time": "MAINTENANCE_END"
         },
       "recurrence": "MAINTENANCE_FREQUENCY"
     }
   }
 }
}

Ganti kode berikut:

PROJECT_ID: ID project Google Cloud target.
REGION: Google Cloud region tempat cluster Distributed Cloud target dibuat.
CLUSTER_ID: nama cluster target.
UPDATE_MASK: daftar nama kolom yang sepenuhnya memenuhi syarat yang dipisahkan koma untuk diperbarui dalam permintaan ini dalam format FieldMask.
REQUEST_ID: ID terprogram unik yang mengidentifikasi permintaan ini.
CLUSTER_ID: nama cluster target.
USERNAME: nama akun pengguna dalam project Google Cloud target yang diberi otorisasi untuk mengubah resource cluster.
MAINTENANCE_START: waktu mulai masa pemeliharaan dalam format YYYY-MM-DDTHH:MM:SSZ.
MAINTENANCE_END: waktu berakhir masa pemeliharaan dalam format YYYY-MM-DDTHH:MM:SSZ.
MAINTENANCE_FREQUENCY: frekuensi masa pemeliharaan dalam format FREQ=WEEKLY|DAILY;BYDAY=MO,TU,WE,TH,FR,SA,SU:
- FREQ dapat berupa DAILY atau WEEKLY.
- BYDAY: daftar hari yang dipisahkan koma saat pemeliharaan dapat terjadi jika FREQ disetel ke WEEKLY. Jika Anda menghapus parameter BYDAY, Google akan memilih hari dalam seminggu untuk Anda.
- Jika Anda menyetel FREQ ke harian, masa pemeliharaan akan terjadi setiap hari selama jam yang ditentukan.

Untuk mengetahui informasi selengkapnya, lihat Resource: cluster.

Menghapus masa pemeliharaan untuk cluster

Untuk menghapus jendela pemeliharaan untuk cluster Distributed Cloud, selesaikan langkah-langkah di bagian ini. Untuk mengetahui informasi selengkapnya tentang pemeliharaan cluster, lihat Memahami update software dan masa pemeliharaan.

Untuk menyelesaikan tugas ini, Anda harus memiliki peran Admin Edge Container (roles/edgecontainer.admin) di project Google Cloud Anda.

gcloud

Gunakan perintah gcloud edge-cloud container clusters update:

gcloud edge-cloud container clusters update CLUSTER_ID \
    --project=PROJECT_ID \
    --location=REGION \
    --clear-maintenance-window

Ganti kode berikut:

CLUSTER_ID: nama cluster target.
PROJECT_ID: ID project Google Cloud target.
REGION: Google Cloud region tempat cluster Distributed Cloud target dibuat.

API

Buat permintaan PATCH ke metode projects.locations.clusters.update:

PATCH /v1/projects/PROJECT_ID/locations/REGION/clusters/CLUSTER_ID?updateMask=maintenancePolicy&requestId=REQUEST_ID
{
 "maintenance_policy": null
}

Ganti kode berikut:

PROJECT_ID: ID project Google Cloud target.
REGION: Google Cloud region tempat cluster Distributed Cloud target dibuat.
CLUSTER_ID: nama cluster target.
UPDATE_MASK: daftar nama kolom yang sepenuhnya memenuhi syarat yang dipisahkan koma untuk diperbarui dalam permintaan ini dalam format FieldMask.
REQUEST_ID: ID terprogram unik yang mengidentifikasi permintaan ini.
USERNAME: nama akun pengguna dalam project Google Cloud target yang diberi otorisasi untuk mengubah resource cluster.

Untuk mengetahui informasi selengkapnya, lihat Resource: cluster.

Menghapus cluster

Untuk menghapus cluster Distributed Cloud, selesaikan langkah-langkah di bagian ini. Sebelum dapat menghapus cluster, Anda harus melakukan hal berikut terlebih dahulu:

Untuk menyelesaikan tugas ini, Anda harus memiliki peran Admin Edge Container (roles/edgecontainer.admin) di project Google Cloud Anda.

gcloud

Gunakan perintah gcloud edge-cloud container clusters delete:

gcloud edge-cloud container clusters delete CLUSTER_ID \
    --project=PROJECT_ID \
    --location=REGION

Ganti kode berikut:

CLUSTER_ID: nama cluster target.
PROJECT_ID: ID project Google Cloud target.
REGION: Google Cloud region tempat cluster Distributed Cloud target dibuat.

API

Buat permintaan DELETE ke metode projects.locations.clusters.delete:

DELETE /v1/projects/PROJECT_ID/locations/REGION/clusters/CLUSTER_ID?requestId=REQUEST_ID

Ganti kode berikut:

PROJECT_ID: ID project Google Cloud target.
REGION: Google Cloud region tempat cluster Distributed Cloud target dibuat.
CLUSTER_ID: nama cluster target.
REQUEST_ID: ID terprogram unik yang mengidentifikasi permintaan ini.

Membuat dan mengelola cluster Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Cluster bidang kontrol lokal di Distributed Cloud 1.5.x

Membuat cluster

Konsol

gcloud

API

Mencantumkan cluster dalam region

Konsol

gcloud

API

Mendapatkan informasi tentang cluster

Konsol

gcloud

API

Mendapatkan versi software yang tersedia untuk cluster

gcloud

API

Mengupgrade versi software cluster bidang kontrol lokal

gcloud

API

Mendapatkan kredensial untuk cluster

gcloud

API

Mengonfigurasi masa pemeliharaan untuk cluster

Menentukan masa pemeliharaan untuk cluster

Konsol

gcloud

API

Menghapus masa pemeliharaan untuk cluster

gcloud

API

Menghapus cluster

gcloud

API

Langkah berikutnya

Membuat dan mengelola cluster