- Resource: Cluster
- Fleet
- ClusterNetworking
- Otorisasi
- ClusterUser
- MaintenancePolicy
- MaintenanceWindow
- RecurringTimeWindow
- TimeWindow
- MaintenanceExclusionWindow
- ControlPlane
- Remote
- Lokal
- SharedDeploymentPolicy
- SystemAddonsConfig
- Ingress
- VMServiceConfig
- ControlPlaneEncryption
- Status
- MaintenanceEvent
- Jenis
- Jadwal
- Status
- ReleaseChannel
- SurvivabilityConfig
- ConnectionState
- Status
- ExternalLoadBalancerPool
- ZoneStorageEncryption
- ContainerRuntimeConfig
- DefaultContainerRuntime
- GoogleGroupAuthenticationConfig
- Metode
Resource: Cluster
Cluster Kubernetes Google Distributed Cloud Edge.
| Representasi JSON |
|---|
{ "name": string, "createTime": string, "updateTime": string, "labels": { string: string, ... }, "fleet": { object ( |
| Kolom | |
|---|---|
name |
Wajib. Nama resource cluster. |
createTime |
Hanya output. Waktu saat cluster dibuat. Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: |
updateTime |
Hanya output. Waktu saat cluster terakhir diperbarui. Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: |
labels |
Label yang terkait dengan resource ini. Objek yang berisi daftar pasangan |
fleet |
Wajib. Konfigurasi armada. |
networking |
Wajib. Konfigurasi jaringan seluruh cluster. |
authorization |
Wajib. Tidak dapat diubah. Kebijakan RBAC yang akan diterapkan dan dikelola oleh GEC. |
defaultMaxPodsPerNode |
Opsional. Jumlah maksimum pod per node default yang digunakan jika nilai maksimum tidak ditentukan secara eksplisit untuk node pool di cluster ini. Jika tidak ditentukan, nilai default Kubernetes akan digunakan. |
endpoint |
Hanya output. Alamat IP server Kubernetes API. |
port |
Hanya output. Nomor port server Kubernetes API. |
clusterCaCertificate |
Hanya output. Sertifikat publik berenkode PEM dari CA cluster. |
maintenancePolicy |
Opsional. Konfigurasi kebijakan pemeliharaan seluruh cluster. |
controlPlaneVersion |
Hanya output. Versi rilis bidang kontrol |
nodeVersion |
Hanya output. Versi rilis terendah di antara semua worker node. Kolom ini dapat kosong jika cluster tidak memiliki node pekerja. |
controlPlane |
Opsional. Konfigurasi bidang kontrol cluster. |
systemAddonsConfig |
Opsional. Konfigurasi add-on sistem. |
externalLoadBalancerIpv4AddressPools[] |
Opsional. Kumpulan alamat IPv4 untuk load balancing eksternal bidang data cluster. |
controlPlaneEncryption |
Opsional. Opsi enkripsi disk bidang kontrol jarak jauh. Kolom ini hanya digunakan saat mengaktifkan dukungan CMEK. |
status |
Hanya output. Status cluster saat ini. |
maintenanceEvents[] |
Hanya output. Semua peristiwa pemeliharaan yang dijadwalkan untuk cluster, termasuk yang sedang berlangsung, direncanakan untuk masa mendatang, dan dilakukan pada masa lalu (hingga 90 hari). |
targetVersion |
Opsional. Versi cluster target. Misalnya: "1.5.0". |
releaseChannel |
Opsional. Saluran rilis yang diikuti oleh cluster. |
survivabilityConfig |
Opsional. Konfigurasi kelangsungan cluster, misalnya, untuk kasus saat konektivitas jaringan terputus. Catatan: Setelan ini hanya berlaku untuk cluster bidang kontrol lokal. |
externalLoadBalancerIpv6AddressPools[] |
Opsional. Kumpulan alamat IPv6 untuk load balancing eksternal bidang data cluster. |
connectionState |
Hanya output. Status koneksi cluster saat ini. |
externalLoadBalancerAddressPools[] |
Opsional. Kumpulan load balancer eksternal untuk cluster. |
zoneStorageEncryption |
Opsional. Konfigurasi enkripsi penyimpanan zona |
containerRuntimeConfig |
Opsional. Konfigurasi runtime container cluster. |
enableRemoteBackup |
Opsional. Jika benar (true), fitur pencadangan/pemulihan jarak jauh akan diaktifkan untuk cluster ini. |
enableClusterIsolation |
Opsional. Menunjukkan apakah cluster harus diisolasi. go/cluster-isolation-in-gdcc-cluster |
googleGroupAuthentication |
Opsional. Konfigurasi autentikasi Grup Google pada cluster. |
Fleet
Konfigurasi terkait fleet.
Fleet adalah konsep Google Cloud untuk mengatur cluster secara logis, sehingga memungkinkan Anda menggunakan dan mengelola kemampuan multi-cluster serta menerapkan kebijakan yang konsisten di seluruh sistem Anda.
| Representasi JSON |
|---|
{ "project": string, "membership": string } |
| Kolom | |
|---|---|
project |
Wajib. Nama project host Fleet tempat cluster ini akan didaftarkan. Nama project diformat sebagai |
membership |
Hanya output. Nama resource Keanggotaan Hub terkelola yang terkait dengan cluster ini. Nama keanggotaan diformat sebagai |
ClusterNetworking
Konfigurasi jaringan seluruh cluster.
| Representasi JSON |
|---|
{ "clusterIpv4CidrBlocks": [ string ], "servicesIpv4CidrBlocks": [ string ] } |
| Kolom | |
|---|---|
clusterIpv4CidrBlocks[] |
Wajib. Semua pod dalam cluster akan mendapatkan alamat IPv4 RFC1918 dari blok ini. Hanya satu blok yang didukung. Kolom ini tidak dapat diubah setelah dibuat. |
servicesIpv4CidrBlocks[] |
Wajib. Semua layanan dalam cluster akan mendapatkan alamat IPv4 RFC1918 dari blok ini. Hanya satu blok yang didukung. Kolom ini tidak dapat diubah setelah dibuat. |
Otorisasi
Kebijakan RBAC yang akan diterapkan dan dikelola oleh GEC.
| Representasi JSON |
|---|
{
"adminUsers": {
object ( |
| Kolom | |
|---|---|
adminUsers |
Wajib. Pengguna yang akan diberi peran cluster-admin di cluster, sehingga memberikan akses penuh ke cluster. Saat ini, kolom ini adalah kolom tunggal, tetapi akan diperluas untuk memungkinkan beberapa admin pada masa mendatang. |
ClusterUser
Akun utama pengguna untuk kebijakan RBAC.
| Representasi JSON |
|---|
{ "username": string } |
| Kolom | |
|---|---|
username |
Wajib. Nama pengguna Google yang aktif. |
MaintenancePolicy
Konfigurasi kebijakan pemeliharaan.
| Representasi JSON |
|---|
{ "window": { object ( |
| Kolom | |
|---|---|
window |
Menentukan masa pemeliharaan saat pemeliharaan dapat dilakukan. |
maintenanceExclusions[] |
Opsional. Pengecualian untuk pemeliharaan otomatis. Pemeliharaan non-darurat tidak boleh terjadi dalam periode ini. Setiap pengecualian memiliki nama unik dan dapat aktif atau sudah berakhir. Jumlah maksimum pengecualian pemeliharaan yang diizinkan pada waktu tertentu adalah 3. |
MaintenanceWindow
Konfigurasi masa pemeliharaan
| Representasi JSON |
|---|
{
"recurringWindow": {
object ( |
| Kolom | |
|---|---|
recurringWindow |
Konfigurasi masa pemeliharaan berulang. |
RecurringTimeWindow
Mewakili periode waktu arbitrer yang berulang.
| Representasi JSON |
|---|
{
"window": {
object ( |
| Kolom | |
|---|---|
window |
Periode pengulangan pertama. |
recurrence |
RRULE (https://tools.ietf.org/html/rfc5545#section-3.8.5.3) untuk cara pengulangan periode ini. Mereka terus berlanjut selama rentang waktu antara waktu mulai dan akhir. |
TimeWindow
Mewakili periode waktu arbitrer.
| Representasi JSON |
|---|
{ "startTime": string, "endTime": string } |
| Kolom | |
|---|---|
startTime |
Waktu saat jendela pertama kali dimulai. Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: |
endTime |
Waktu berakhirnya periode. Waktu berakhir harus terjadi setelah waktu mulai. Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: |
MaintenanceExclusionWindow
Menunjukkan periode pengecualian pemeliharaan.
| Representasi JSON |
|---|
{
"window": {
object ( |
| Kolom | |
|---|---|
window |
Opsional. Periode waktu. |
id |
Opsional. ID unik (per cluster) untuk jendela. |
ControlPlane
Konfigurasi bidang kontrol cluster.
| Representasi JSON |
|---|
{ // Union field |
| Kolom | |
|---|---|
Kolom union
|
|
remote |
Konfigurasi bidang kontrol jarak jauh. |
local |
Konfigurasi bidang kontrol lokal. Peringatan: Cluster bidang kontrol lokal harus dibuat di projectnya sendiri. Cluster bidang kontrol lokal tidak dapat berada bersama dalam project yang sama dengan jenis cluster lainnya, termasuk cluster non-GDCE. Mencampur cluster GDCE bidang kontrol lokal dengan jenis cluster lain dalam project yang sama dapat menyebabkan kehilangan data. |
Eksternal
Jenis ini tidak memiliki kolom.
Konfigurasi khusus untuk cluster dengan bidang kontrol yang dihosting dari jarak jauh.
Lokal
Konfigurasi khusus untuk cluster dengan bidang kontrol yang dihosting secara lokal.
Peringatan: Cluster bidang kontrol lokal harus dibuat di projectnya sendiri. Cluster bidang kontrol lokal tidak dapat berada bersama dalam project yang sama dengan jenis cluster lainnya, termasuk cluster non-GDCE. Mencampur cluster GDCE bidang kontrol lokal dengan jenis cluster lain dalam project yang sama dapat menyebabkan kehilangan data.
| Representasi JSON |
|---|
{ "nodeLocation": string, "nodeCount": integer, "machineFilter": string, "sharedDeploymentPolicy": enum ( |
| Kolom | |
|---|---|
nodeLocation |
Nama zona Google Distributed Cloud Edge tempat node pool ini akan dibuat. Misalnya: |
nodeCount |
Jumlah node yang akan berfungsi sebagai replika Bidang Kontrol. |
machineFilter |
Hanya mesin yang cocok dengan filter ini yang akan diizinkan untuk menghosting node bidang kontrol. Bahasa pemfilteran menerima string seperti "name= |
sharedDeploymentPolicy |
Konfigurasi kebijakan tentang cara aplikasi pengguna di-deploy. |
controlPlaneNodeStorageSchema |
Opsional. Nama untuk skema penyimpanan node bidang kontrol. |
controlPlaneNodeSystemPartitionSize |
Opsional. Ukuran partisi sistem untuk node bidang kontrol dalam GiB. |
SystemAddonsConfig
Konfigurasi yang dapat ditentukan pelanggan untuk add-on sistem GDCE.
| Representasi JSON |
|---|
{ "ingress": { object ( |
| Kolom | |
|---|---|
ingress |
Opsional. Konfigurasi untuk Ingress. |
vmServiceConfig |
Opsional. Konfigurasi untuk Layanan VM. |
Masuk
Konfigurasi untuk add-on Ingress yang memungkinkan pelanggan membuat objek Ingress untuk mengelola akses eksternal ke server dalam cluster. Add-on ini terdiri dari istiod dan istio-ingress.
| Representasi JSON |
|---|
{ "disabled": boolean, "ipv4Vip": string } |
| Kolom | |
|---|---|
disabled |
Opsional. Apakah Ingress dinonaktifkan. |
ipv4Vip |
Opsional. VIP Ingress. |
VMServiceConfig
VMServiceConfig menentukan konfigurasi untuk Layanan VM GDCE.
| Representasi JSON |
|---|
{ "vmmEnabled": boolean } |
| Kolom | |
|---|---|
vmmEnabled |
Opsional. Apakah VMM diaktifkan. |
ControlPlaneEncryption
Konfigurasi untuk dukungan kunci KMS yang dikelola pelanggan untuk node bidang kontrol.
| Representasi JSON |
|---|
{ "kmsKey": string, "kmsKeyActiveVersion": string, "kmsKeyState": enum ( |
| Kolom | |
|---|---|
kmsKey |
Opsional. CryptoKey Cloud KMS, misalnya projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{cryptoKey} yang akan digunakan untuk melindungi disk bidang kontrol. Jika tidak ditentukan, kunci yang dikelola Google akan digunakan. |
kmsKeyActiveVersion |
Hanya output. CryptoKeyVersion Cloud KMS yang saat ini digunakan untuk melindungi disk bidang kontrol. Hanya berlaku jika kmsKey disetel. |
kmsKeyState |
Hanya output. Ketersediaan CryptoKey Cloud KMS. Jika tidak |
kmsStatus |
Hanya output. Status error yang ditampilkan oleh Cloud KMS saat menggunakan kunci ini. Kolom ini hanya dapat diisi jika |
resourceState |
Hanya output. Status resource saat ini yang terkait dengan cmek. |
Status
Menunjukkan status cluster.
| Enum | |
|---|---|
STATUS_UNSPECIFIED |
Status tidak diketahui. |
PROVISIONING |
Cluster sedang dibuat. |
RUNNING |
Cluster dibuat dan dapat digunakan sepenuhnya. |
DELETING |
Cluster sedang dihapus. |
ERROR |
Status menunjukkan bahwa terjadi beberapa error saat merekonsiliasi/menghapus cluster. |
RECONCILING |
Cluster sedang melakukan beberapa tugas seperti upgrade versi, dll. |
MaintenanceEvent
Peristiwa Pemeliharaan adalah operasi yang dapat menyebabkan gangguan sementara pada workload cluster, termasuk upgrade cluster yang dilakukan Google atau dimulai pengguna, perubahan konfigurasi cluster yang dimulai pengguna yang memerlukan restart node, dll.
| Representasi JSON |
|---|
{ "uuid": string, "targetVersion": string, "operation": string, "type": enum ( |
| Kolom | |
|---|---|
uuid |
Hanya output. UUID peristiwa pemeliharaan. |
targetVersion |
Hanya output. Versi target cluster. |
operation |
Hanya output. Operasi untuk menjalankan peristiwa pemeliharaan. Ditentukan dalam format projects/*/locations/*/operations/*. Jika peristiwa pemeliharaan dibagi menjadi beberapa operasi (misalnya karena masa pemeliharaan), operasi terbaru akan dicatat. |
type |
Hanya output. Jenis peristiwa pemeliharaan. |
schedule |
Hanya output. Jadwal acara pemeliharaan. |
state |
Hanya output. Status peristiwa pemeliharaan. |
createTime |
Hanya output. Waktu saat permintaan acara pemeliharaan dibuat. Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: |
startTime |
Hanya output. Waktu saat peristiwa pemeliharaan dimulai. Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: |
endTime |
Hanya output. Waktu saat peristiwa pemeliharaan berakhir, baik berhasil maupun tidak. Jika peristiwa pemeliharaan dibagi menjadi beberapa masa pemeliharaan, endTime hanya diperbarui saat seluruh alur berakhir. Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: |
updateTime |
Hanya output. Waktu saat pesan peristiwa pemeliharaan diperbarui. Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: |
Jenis
Menunjukkan jenis peristiwa pemeliharaan.
| Enum | |
|---|---|
TYPE_UNSPECIFIED |
Tidak ditentukan. |
USER_INITIATED_UPGRADE |
Upgrade yang dimulai oleh pengguna. |
GOOGLE_DRIVEN_UPGRADE |
Upgrade yang didorong oleh Google. |
Jadwal
Menunjukkan kapan peristiwa pemeliharaan harus dilakukan.
| Enum | |
|---|---|
SCHEDULE_UNSPECIFIED |
Tidak ditentukan. |
IMMEDIATELY |
Segera setelah menerima permintaan. |
Negara bagian/Provinsi
Menunjukkan status peristiwa pemeliharaan.
| Enum | |
|---|---|
STATE_UNSPECIFIED |
Tidak ditentukan. |
RECONCILING |
Acara pemeliharaan sedang berlangsung. Cluster mungkin tidak dapat digunakan. |
SUCCEEDED |
Acara pemeliharaan berhasil. |
FAILED |
Acara pemeliharaan gagal. |
ReleaseChannel
Saluran rilis yang diikuti oleh cluster.
| Enum | |
|---|---|
RELEASE_CHANNEL_UNSPECIFIED |
Saluran rilis tidak ditentukan. Secara default, channel ini akan ditetapkan ke channel REGULER. |
NONE |
Tidak ada saluran rilis. |
REGULAR |
Saluran rilis reguler. |
SurvivabilityConfig
Konfigurasi kelangsungan cluster, misalnya, untuk kasus saat konektivitas jaringan terputus.
| Representasi JSON |
|---|
{ "offlineRebootTtl": string } |
| Kolom | |
|---|---|
offlineRebootTtl |
Opsional. Periode waktu yang memungkinkan node cluster di-reboot dan berfungsi tanpa konektivitas jaringan ke Google. Nilai default 0 berarti tidak diizinkan. Durasi maksimumnya adalah 30 hari. Durasi dalam detik dengan maksimal sembilan digit pecahan, yang diakhiri dengan ' |
ConnectionState
ConnectionState menyimpan status koneksi saat ini dari cluster ke Google.
| Representasi JSON |
|---|
{
"state": enum ( |
| Kolom | |
|---|---|
state |
Hanya output. Status koneksi saat ini. |
updateTime |
Hanya output. Waktu saat status koneksi terakhir diubah. Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: |
Negara bagian/Provinsi
Status koneksi.
| Enum | |
|---|---|
STATE_UNSPECIFIED |
Status koneksi tidak diketahui. |
DISCONNECTED |
Cluster ini saat ini terputus dari Google. |
CONNECTED |
Cluster ini saat ini terhubung ke Google. |
CONNECTED_AND_SYNCING |
Cluster ini saat ini terhubung ke Google, tetapi mungkin baru-baru ini terhubung kembali setelah koneksi terputus. Perangkat masih menyinkronkan kembali. |
ExternalLoadBalancerPool
Kumpulan load balancer eksternal dengan konfigurasi kustom seperti nama, penetapan manual/otomatis, IPv4 yang tidak tumpang-tindih, dan rentang alamat IPv6 opsional.
| Representasi JSON |
|---|
{ "addressPool": string, "ipv4Range": [ string ], "ipv6Range": [ string ], "avoidBuggyIps": boolean, "manualAssign": boolean } |
| Kolom | |
|---|---|
addressPool |
Opsional. Nama kumpulan load balancer eksternal. |
ipv4Range[] |
Wajib. Rentang alamat IPv4 yang tidak tumpang-tindih dari kumpulan load balancer eksternal. |
ipv6Range[] |
Opsional. Rentang alamat IPv6 yang tidak tumpang-tindih dari kumpulan load balancer eksternal. |
avoidBuggyIps |
Opsional. Jika benar, kumpulan ini akan menghilangkan alamat IP yang diakhiri dengan .0 dan .255. Beberapa hardware jaringan akan membatalkan traffic ke alamat khusus ini. Nilai defaultnya adalah false. |
manualAssign |
Opsional. Jika benar (true), alamat di kumpulan ini tidak otomatis ditetapkan ke Layanan Kubernetes. Jika benar (true), alamat IP dalam kumpulan ini hanya digunakan jika ditentukan secara eksplisit oleh layanan. Nilai defaultnya adalah false. |
ZoneStorageEncryption
Konfigurasi untuk Dukungan CMEK Zone Storage
| Representasi JSON |
|---|
{
"kmsKey": string,
"kmsKeyActiveVersion": string,
"resourceState": enum ( |
| Kolom | |
|---|---|
kmsKey |
Opsional. Kunci Cloud KMS |
kmsKeyActiveVersion |
Hanya output. Cloud KMS CryptoKeyVersion yang saat ini digunakan untuk enkripsi/dekripsi |
resourceState |
Hanya output. Status resource CMEK saat ini |
ContainerRuntimeConfig
Konfigurasi runtime container cluster.
| Representasi JSON |
|---|
{
"defaultContainerRuntime": enum ( |
| Kolom | |
|---|---|
defaultContainerRuntime |
Opsional. Runtime container default yang akan dikonfigurasi di cluster. |
DefaultContainerRuntime
Daftar runtime container yang didukung.
| Enum | |
|---|---|
DEFAULT_CONTAINER_RUNTIME_UNSPECIFIED |
Runtime container tidak ditentukan. |
RUNC |
Gunakan runc sebagai runtime container default di cluster. |
GVISOR |
Gunakan gVisor sebagai runtime container default di cluster. |
GoogleGroupAuthenticationConfig
Konfigurasi autentikasi Google Grup pada cluster. go/gdc-google-group-authentication
| Representasi JSON |
|---|
{ "enable": boolean } |
| Kolom | |
|---|---|
enable |
Opsional. Jika benar (true), cluster akan dikonfigurasi untuk menggunakan autentikasi Grup Google. |
Metode |
|
|---|---|
|
Membuat Cluster baru di project dan lokasi tertentu. |
|
Menghapus satu Cluster. |
|
Membuat token akses untuk Cluster. |
|
Membuat kredensial offline untuk Cluster. |
|
Mendapatkan detail satu Cluster. |
|
Mencantumkan Cluster di project dan lokasi tertentu. |
|
Memperbarui parameter satu Cluster. |
|
Mengupgrade satu cluster. |