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

Membuat dan mengelola cluster

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

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

Server yang terhubung Distributed Cloud dan deployment multi-rack yang terhubung Distributed Cloud, yang di dalamnya rack dasar menggabungkan resource dari satu atau beberapa rack mandiri, hanya mendukung cluster bidang kontrol lokal. Anda tidak dapat membuat cluster bidang kontrol Cloud pada jenis deployment tersebut.

Membuat cluster

Untuk membuat cluster yang terhubung 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 yang terhubung.

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.

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 yang terhubung ke 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 periode nonaktif yang tidak terduga yang disebabkan oleh update software yang terhubung ke Distributed Cloud, sebaiknya Anda selalu mengonfigurasi periode 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 yang terhubung ke Distributed Cloud untuk ditetapkan ke node pool ini.
Untuk membuat cluster yang terhubung ke Distributed Cloud, klik Buat.

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 yang terhubung 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 yang terhubung 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 yang terhubung dengan 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 terhubung yang ingin Anda jalankan di cluster ini dalam format 1.X.Y dengan X adalah versi minor, dan Y adalah versi patch, misalnya 1.5.1. Jika tidak ditentukan, versi software default server akan digunakan, yang biasanya merupakan versi terbaru yang tersedia dari Distributed Cloud yang terhubung. Untuk mendapatkan versi software yang tersedia untuk pembuatan cluster, termasuk versi default server, lihat Mendapatkan versi software yang tersedia untuk cluster. Anda harus menetapkan flag RELEASE_CHANNEL ke NONE untuk menentukan versi software 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: region Google Cloud tempat cluster Distributed Cloud terhubung 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 yang terhubung ke Distributed Cloud yang menjadi 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: (opsional): menentukan saluran rilis untuk versi software yang terhubung dengan 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
```
Parameter ini hanya berlaku jika Anda telah mengintegrasikan Distributed Cloud yang terhubung 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.1. Jika tidak ditentukan, versi software default server akan digunakan, yang biasanya merupakan versi terbaru yang tersedia dari Distributed Cloud yang terhubung. Untuk mendapatkan versi software yang tersedia untuk pembuatan cluster, termasuk versi default server, lihat Mendapatkan versi software yang tersedia untuk cluster. Anda harus menetapkan kolom RELEASE_CHANNEL ke NONE untuk menentukan versi software 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 yang terhubung Distributed Cloud yang disediakan di regionGoogle 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
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 yang terhubung.

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 yang terhubung ke 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: region Google Cloud tempat Anda membuat zona terhubung 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: region Google Cloud tempat cluster target yang terhubung ke Distributed Cloud dibuat.
CLUSTER_ID: nama cluster target.

Mendapatkan versi software yang tersedia untuk cluster

Untuk mengetahui versi software yang terhubung ke Distributed Cloud yang tersedia di zona yang terhubung ke Distributed Cloud 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 yang terhubung ke 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: region Google Cloud tempat cluster target yang terhubung ke Distributed Cloud dibuat.

Mengupgrade versi software cluster bidang kontrol lokal

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

Bergantung pada jenis deployment Anda, upgrade software Distributed Cloud connected sebagai berikut:

Untuk deployment server yang terhubung Distributed Cloud dan deployment rak yang terhubung Distributed Cloud menggunakan satu rak per zona, node di zona diupgrade dan di-reboot satu per satu.
Untuk deployment rak yang terhubung Distributed Cloud menggunakan beberapa rak per zona, semua node di zona tersebut diupgrade secara bersamaan.

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: region Google Cloud tempat cluster target yang terhubung ke Distributed Cloud 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 terhubung yang ingin Anda jalankan di 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 bagi cluster yang terhubung ke 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: region Google Cloud tempat cluster target yang terhubung ke Distributed Cloud 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 periode pemeliharaan dan menghapus periode pemeliharaan untuk cluster yang terhubung ke Distributed Cloud.

Menentukan masa pemeliharaan untuk cluster

Untuk menentukan periode pemeliharaan bagi cluster yang terhubung ke 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 yang terhubung.

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: region Google Cloud tempat cluster Distributed Cloud terhubung 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: region Google Cloud tempat cluster Distributed Cloud terhubung 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 mengosongkan jendela pemeliharaan untuk cluster yang terhubung ke 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: region Google Cloud tempat cluster Distributed Cloud terhubung 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 yang terhubung ke 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: region Google Cloud tempat cluster target yang terhubung ke Distributed Cloud 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: region Google Cloud tempat cluster target yang terhubung ke Distributed Cloud 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.

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