Halaman ini menjelaskan cara membuat cluster pengguna menggunakan Konsol Google Cloud, Google Cloud CLI (gcloud CLI), atau Terraform.
Apa itu GKE On-Prem API?
GKE On-Prem API adalah API yang dihosting Google Cloud dan dapat Anda gunakan untuk mengelola siklus proses cluster lokal menggunakan Terraform dan aplikasi Google Cloud standar. GKE On-Prem API berjalan di infrastruktur Google Cloud. Terraform, konsol, dan gcloud CLI adalah klien API, dan mereka menggunakan API tersebut untuk membuat cluster di pusat data Anda.
Untuk mengelola siklus proses cluster Anda, GKE On-Prem API harus menyimpan metadata tentang status cluster Anda di Google Cloud, menggunakan region Google Cloud yang Anda tentukan saat membuat cluster. Dengan metadata ini, API dapat mengelola siklus proses cluster dan tidak menyertakan data khusus workload.
Saat membuat cluster menggunakan klien GKE On-Prem API, Anda menentukan project Google Cloud. Setelah dibuat, cluster akan otomatis didaftarkan ke fleet project yang ditentukan. Project ini disebut sebagai project host perangkat. Project host fleet tidak dapat diubah setelah cluster dibuat.
Jika mau, Anda dapat membuat cluster pengguna dengan membuat file konfigurasi cluster pengguna dan menggunakan bmctl
, seperti yang dijelaskan dalam Membuat cluster pengguna.
Jika Anda ingin menggunakan Terraform, konsol, atau gcloud CLI untuk mengelola siklus proses cluster yang dibuat menggunakan bmctl
, baca artikel Mengonfigurasi cluster pengguna agar dikelola dengan GKE On-Prem API.
Sebelum memulai
Bagian ini menjelaskan persyaratan untuk membuat cluster pengguna menggunakan klien GKE On-Prem API.
Memberikan izin IAM
Jika bukan pemilik project, Anda harus diberi akses ke roles/gkeonprem.admin.
Jika ingin mengakses halaman GKE Enterprise dan Google Kubernetes Engine di konsol, Anda juga harus memiliki peran berikut:
Setelah cluster dibuat, jika Anda bukan pemilik project dan ingin menggunakan gateway Connect untuk terhubung ke cluster pengguna melalui command line, peran berikut diperlukan:
roles/gkehub.gatewayAdmin: Peran ini memungkinkan Anda mengakses Connect gateway API. Jika Anda hanya memerlukan akses hanya baca ke cluster,
roles/gkehub.gatewayReader
sudah cukup.roles/gkehub.viewer: Peran ini memungkinkan Anda mengambil kredensial cluster.
Untuk mengetahui informasi tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.
Google API yang diperlukan
Pastikan semua Google API yang diperlukan diaktifkan dalam project host fleet.
Jika akan menggunakan gcloud CLI untuk membuat cluster, Anda harus mengaktifkan GKE On-Prem API. Jika Anda menggunakan konsol untuk membuat cluster, GKE On-Prem API akan otomatis diaktifkan.
gcloud services enable --project FLEET_HOST_PROJECT_ID \ gkeonprem.googleapis.com
Prasyarat cluster admin
Anda memerlukan cluster admin yang berfungsi sebelum dapat membuat cluster pengguna. Cluster admin harus:
Memiliki akses ke server Kubernetes API di cluster pengguna setelah dibuat.
Memiliki konektivitas jaringan ke semua node pada cluster pengguna setelah dibuat.
Harus terdaftar ke fleet. Project ID yang dikonfigurasi di kolom
gkeConnect.projectID
dari cluster admin tersebut, yang disebut sebagai project host fisik, harus sama dengan project tempat Anda akan membuat cluster pengguna.
Prasyarat mesin node cluster
Tinjau Prasyarat mesin node cluster untuk memastikan bahwa mesin yang akan menjalankan cluster pengguna memenuhi prasyarat.
Akses command line
Setelah cluster dibuat, jika Anda ingin menggunakan gateway Connect untuk menjalankan
kubectl
terhadap cluster pengguna di komputer selain workstation admin, instal alat command line
berikut di komputer yang akan Anda gunakan.
- Versi terbaru gcloud CLI.
kubectl
untuk menjalankan perintah terhadap cluster Kubernetes. Jika Anda perlu menginstalkubectl
, ikuti instructions ini.
Membuat cluster pengguna
Anda dapat menggunakan Terraform, Konsol Google Cloud, atau Google Cloud CLI (gcloud CLI) untuk membuat cluster yang dikelola dengan GKE On-Prem API. Jika ini pertama kalinya Anda menginstal Google Distributed Cloud, Anda mungkin akan menemukan konsol sebagai alat yang paling mudah digunakan.
Setelah terbiasa dengan informasi yang perlu diberikan untuk membuat cluster, Anda mungkin merasa lebih nyaman dengan Terraform atau gcloud CLI, terutama jika Anda akan membuat lebih dari satu cluster. Terraform adalah alat infrastruktur sebagai kode standar industri. Jika organisasi Anda sudah menggunakan Terraform, kemungkinan Anda dapat menggunakannya untuk membuat cluster dan mengelola siklus proses cluster.
Dengan gcloud CLI, Anda dapat menyimpan perintah beserta argumennya ke file teks dan membuat perubahan sesuai kebutuhan untuk membuat cluster tambahan. Jika menggunakan alat CI/CD, seperti Cloud Build, Anda dapat menggunakan perintah gcloud
untuk membuat cluster dan kumpulan node, serta menentukan flag --impersonate-service-account
untuk mengotomatiskan pembuatan.
Konsol
Sebagian besar setelan di konsol sesuai dengan kolom dalam file konfigurasi cluster.
Di konsol, buka halaman Create a Distributed Cloud cluster.
Pilih project Google Cloud tempat Anda ingin membuat cluster. Project yang dipilih juga digunakan sebagai project host fleet. Project ini harus sama dengan project yang didaftarkan ke cluster admin. Setelah dibuat, cluster pengguna akan otomatis didaftarkan ke fleet project yang dipilih.
Klik Next untuk mulai mengonfigurasi cluster.
Bagian berikut akan memandu Anda mengonfigurasi cluster pengguna.
Dasar-dasar cluster
Masukkan informasi dasar tentang cluster.
- Masukkan Nama untuk cluster pengguna.
Pada Admin cluster, pilih cluster admin dari daftar.
Di kolom Lokasi Google Cloud API, pilih region Google Cloud dari daftar. Setelan ini menentukan region tempat API dan layanan berikut dijalankan:
- GKE On-Prem API (
gkeonprem.googleapis.com
) - Layanan armada (
gkehub.googleapis.com
) - Hubungkan layanan (
gkeconnect.googleapis.com
)
Setelan ini juga mengontrol region tempat hal berikut disimpan:
- Metadata cluster pengguna yang diperlukan GKE On-Prem API untuk mengelola siklus proses cluster
- Data Cloud Logging dan Cloud Monitoring komponen sistem
- Log Audit Admin yang dibuat oleh Cloud Audit Logs
Semua nama cluster, project, dan lokasi secara unik mengidentifikasi cluster di Google Cloud.
- GKE On-Prem API (
Pilih versi Google Distributed Cloud untuk cluster pengguna Anda. Cluster pengguna harus berupa versi minor yang sama dengan cluster admin atau satu versi minor yang lebih rendah dari cluster admin.
Sebagai pembuat cluster, Anda diberi hak istimewa admin cluster ke cluster tersebut. Atau, masukkan alamat email pengguna lain yang akan mengelola cluster di kolom Admin user.
Saat cluster dibuat, GKE On-Prem API menerapkan kebijakan kontrol akses berbasis peran (RBAC) Kubernetes ke cluster untuk memberi Anda dan pengguna admin lainnya peran
clusterrole/cluster-admin
Kubernetes, yang menyediakan akses penuh ke setiap resource di cluster di semua namespace.Di bagian Node configuration, tentukan hal berikut:
Pod Maksimum per node: Masukkan jumlah maksimum Pod yang dapat dijalankan pada satu node. Nilai yang diizinkan adalah antara
32
–250
, inklusif. Kubernetes menetapkan blok Classless Inter-Domain Routing (CIDR) ke setiap node sehingga setiap pod dapat memiliki alamat IP yang unik. Ukuran blok CIDR sesuai dengan jumlah maksimum pod per node. Untuk mengetahui informasi selengkapnya tentang cara menetapkan jumlah maksimum pod per node, Networking pod.Runtime container: containerd adalah satu-satunya runtime container yang tersedia untuk cluster Anda.
Klik Berikutnya untuk membuka bagian Jaringan.
Networking
Di bagian ini, Anda akan menentukan alamat IP untuk node, Pod, dan Service cluster. Jika Anda menggunakan load balancing yang dipaketkan dengan MetalLB, Anda juga dapat mengonfigurasinya.
Di bagian node Bidang kontrol, masukkan alamat IPv4 untuk setiap node bidang kontrol. Node bidang kontrol menjalankan beban kerja sistem. Biasanya, mesin ini dapat berupa satu mesin jika menggunakan deployment minimum atau tiga mesin jika menggunakan deployment ketersediaan tinggi (HA). Tentukan jumlah node yang ganjil agar memiliki kuorum mayoritas untuk HA. Kolom ini dapat diubah setiap kali Anda mengupdate atau mengupgrade cluster.
Klik + Tambahkan Alamat IP sesuai kebutuhan untuk memasukkan alamat IP lainnya.
Di bagian Load balancer, pilih load balancer dari daftar Mode yang akan disiapkan untuk cluster Anda. Lihat Ringkasan load balancer untuk mengetahui informasi lebih lanjut.
Sepaket dengan MetalLB
Mengonfigurasi load balancing dengan load balancer MetalLB yang dipaketkan. Dengan opsi ini, Google Distributed Cloud men-deploy load balancer Lapisan 4 yang berjalan pada kumpulan worker node khusus atau pada node yang sama dengan bidang kontrol.
Di bagian kumpulan node load balancer, pilih salah satu opsi berikut:
Gunakan node bidang kontrol: Pilih opsi ini untuk menjalankan load balancer pada node yang sama dengan bidang kontrol.
Buat kumpulan node load balancer: Pilih opsi lanjutan ini jika Anda perlu menjalankan load balancer pada kumpulan node pekerja khusus. Semua node dalam kumpulan node load balancer harus berada di subnet Lapisan 2 yang sama dengan IP virtual (VIP) load balancer yang dikonfigurasi di bagian Kumpulan alamat load balancer.
Di kolom Load balancer node pool IP 1, masukkan alamat IPv4 untuk node di kumpulan node load balancer Anda.
Klik + Add IP address sesuai kebutuhan untuk memasukkan alamat IP tambahan.
Di bagian Kumpulan alamat load balancer, tambahkan satu atau beberapa kumpulan alamat untuk pengontrol MetalLB yang dapat dipilih dan ditetapkan ke Layanan jenis
LoadBalancer
. VIP masuk, yang Anda tentukan di bagian Virtual IP, harus berada dalam salah satu kumpulan ini.Masukkan nama untuk kumpulan alamat.
Masukkan rentang alamat IP dalam notasi CIDR (misalnya: 192.0.2.0/26) atau notasi rentang (misalnya: 192.0.2.64-192.0.2.72). Untuk menentukan satu alamat IP dalam kumpulan, gunakan /32 dalam notasi CIDR (misalnya: 192.0.2.1/32).
Jika VIP masuk tidak berada dalam rentang alamat, pilih + Tambahkan Rentang Alamat IP, lalu masukkan rentang alamat lain yang menyertakan VIP masuk.
Alamat IP di setiap kumpulan tidak boleh tumpang-tindih, dan harus berada di subnet yang sama dengan node cluster.
Di bagian Assignment of IP addresses, pilih salah satu opsi berikut:
- Otomatis: Pilih opsi ini jika Anda ingin pengontrol MetalLB
menetapkan alamat IP secara otomatis dari
kumpulan alamat ke Layanan jenis
LoadBalancer
. - Manual: Pilih opsi ini jika Anda ingin menggunakan
alamat dari kumpulan guna menentukan alamat secara manual untuk
Layanan jenis
LoadBalancer
.
- Otomatis: Pilih opsi ini jika Anda ingin pengontrol MetalLB
menetapkan alamat IP secara otomatis dari
kumpulan alamat ke Layanan jenis
Klik Hindari alamat IP yang berisi bug jika Anda ingin pengontrol MetalLB tidak menggunakan alamat dari kumpulan yang diakhiri dengan .0 atau .255. Hal ini untuk menghindari masalah perangkat konsumen yang memiliki bug dan secara keliru menurunkan traffic yang dikirim ke alamat IP khusus tersebut.
Jika sudah selesai, klik Selesai.
Jika perlu, klik Tambahkan Kumpulan Alamat.
Load balancer manual
Dengan load balancing manual, Anda mengonfigurasi solusi load balancing untuk bidang kontrol dan traffic bidang data. Anda harus mengonfigurasi VIP bidang kontrol pada load balancer eksternal sebelum membuat cluster. Load balancer bidang kontrol eksternal juga dapat digunakan untuk traffic bidang data, atau Anda dapat menyiapkan load balancer terpisah untuk bidang data. Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi load balancing manual.
Di bagian Virtual IPs, masukkan berikut ini:
VIP bidang kontrol: Alamat IP tujuan yang akan digunakan untuk traffic yang dikirim ke server Kubernetes API cluster pengguna. VIP bidang kontrol harus berada di subnet yang sama dengan node load balancer dan tidak boleh berada di rentang alamat mana pun yang digunakan untuk kumpulan alamat load balancer.
Port: Port tujuan yang digunakan untuk traffic yang dikirim ke server Kubernetes API. Defaultnya adalah 443.
VIP Ingress: Alamat IP yang akan dikonfigurasi di load balancer untuk proxy masuk. Masukkan alamat dari salah satu kumpulan alamat load balancer.
Di bagian Service and Pod CIDRs, tentukan Service Kubernetes dan rentang alamat IP Pod dalam notasi CIDR. Keduanya tidak boleh saling tumpang-tindih, atau dengan alamat apa pun di luar cluster yang ingin Anda jangkau dari dalam cluster. Sebaiknya gunakan rentang alamat IP pribadi yang ditentukan oleh RFC 1918. Console menyediakan rentang alamat default berikut, tetapi Anda dapat mengubahnya:
CID Layanan:
10.96.0.0/20
Jika Anda tidak menerima alamat default, masukkan rentang CIDR antara /24 dan /12, dengan /12 yang memberikan alamat IP paling banyak.Pod CIDR:
192.168.0.0/16
Jika Anda tidak menerima nilai default, masukkan rentang CIDR antara /18 dan /8, dengan /8 yang memberikan alamat IP paling banyak.
Di bagian atribut Advanced attributes, tentukan secara opsional hal berikut:
URL proxy: Alamat HTTP server proxy Anda. Sertakan nomor port meskipun sama dengan port default skema, misalnya:
http://my-proxy.example.local:80
URL: Daftar yang dipisahkan koma untuk alamat IP, rentang alamat IP, nama host, dan nama domain yang tidak boleh melewati server proxy. Saat Google Distributed Cloud mengirimkan permintaan ke salah satu alamat, host, atau domain ini, permintaan tersebut akan dikirim langsung.
Klik Next.
Penyimpanan
Google Distributed Cloud menyediakan antarmuka block and file storage. Opsi ini memiliki opsi default, tetapi Anda dapat menyesuaikan konfigurasinya. Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi penyimpanan lokal.
Anda juga dapat mengonfigurasi hal berikut:
Pemasangan node penyedia volume lokal: Menentukan konfigurasi untuk
PersistentVolumes
(PV) lokal yang didukung oleh disk yang terpasang. Anda perlu memformat dan memasang disk ini, yang dapat dilakukan sebelum atau setelah pembuatan cluster.Berbagi penyedia volume lokal: Menentukan konfigurasi untuk
PersistentVolumes
lokal yang didukung oleh subdirektori dalam sistem file bersama. Subdirektori ini dibuat secara otomatis selama pembuatan cluster.
Klik Next.
Fitur
Untuk membantu Anda memantau, memecahkan masalah, dan mengoperasikan cluster, hal berikut diaktifkan secara otomatis dan tidak dapat dinonaktifkan:
- Cloud Logging layanan sistem
- Cloud Monitoring layanan sistem
- Log audit Aktivitas Admin
Membuat node pool
Cluster Anda harus memiliki setidaknya satu kumpulan node untuk node pekerja. Kumpulan node adalah template untuk grup node pekerja yang dibuat dalam cluster ini.
Di konsol, Anda harus mengonfigurasi setidaknya satu node pool (atau menerima nilai default), lalu membuat cluster. Anda dapat menambahkan kumpulan node tambahan setelah cluster dibuat. Dengan gcloud CLI, Anda membuat cluster terlebih dahulu, lalu menambahkan satu atau beberapa node pool ke cluster yang baru dibuat.
Klik kumpulan default di menu navigasi kiri.
Di bagian Default pool node, masukkan Node pool name atau setujui "default-pool" sebagai namanya.
Di bagian Worker nodes, masukkan alamat IP mesin untuk menjalankan cluster.
Di bagian Metadata kumpulan node (opsional), jika Anda ingin menambahkan label dan taint Kubernetes, lakukan hal berikut:
- Klik + Add Kubernetes Labels. Masukkan Kunci dan Nilai untuk label. Ulangi jika perlu.
- Klik + Add Taint. Masukkan Key, Value, dan Effect untuk taint. Ulangi jika perlu.
Klik Verify and Complete untuk membuat cluster pengguna. Perlu waktu 15 menit atau lebih untuk membuat cluster pengguna. Konsol menampilkan pesan status saat memverifikasi setelan dan membuat cluster di pusat data Anda.
Jika ada masalah dengan konfigurasi, konsol akan menampilkan pesan error yang seharusnya cukup jelas bagi Anda untuk memperbaiki masalah konfigurasi, dan mencoba membuat cluster lagi.
gcloud CLI
Gunakan perintah berikut untuk membuat cluster pengguna:
gcloud container bare-metal clusters create
Setelah membuat cluster, Anda perlu membuat setidaknya satu kumpulan node menggunakan perintah berikut:
gcloud container bare-metal node-pools create
Sebagian besar flag untuk membuat cluster dan kumpulan node sesuai dengan kolom pada file konfigurasi cluster pengguna. Untuk membantu memulai, Anda dapat menguji perintah lengkap di bagian Examples. Untuk mengetahui informasi tentang flag ini, lihat bagian yang mengikuti contoh, atau baca referensi gcloud CLI.
Sebelum memulai
Versi Google Distributed Cloud yang Anda pilih saat membuat cluster pengguna harus berupa versi yang didukung oleh cluster admin Anda. Selain itu, versi minor atau patch terbaru tidak tersedia di GKE On-Prem API hingga 7 hingga 10 hari setelah rilis. Anda dapat menjalankan perintah gcloud
untuk mendapatkan daftar
versi yang didukung yang dapat diinstal di cluster pengguna.
Pastikan untuk mengupdate komponen:
gcloud components update
Mendapatkan nama dan lokasi keanggotaan fleet cluster admin Anda:
gcloud container fleet memberships list \ --project=FLEET_HOST_PROJECT_ID
Ganti
FLEET_HOST_PROJECT_ID
dengan ID project tempat cluster admin terdaftar.Outputnya mirip dengan hal berikut ini:
NAME EXTERNAL_ID LOCATION admin-cluster-1 bb7803b4-8438-4b22-859f-4559b4b29072 global admin-cluster-2 ee16ee2b-6ec0-49fc-9413-3c89cbc70854 global admin-cluster-3 fc2b7ef5-39ff-4b63-b919-04c5adc67be4 us-west1
Lokasi menentukan tempat layanan Fleet dan Connect dijalankan. Cluster admin yang dibuat sebelum versi 1.28 dikelola oleh layanan Fleet and Connect global. Pada versi 1.28 dan yang lebih baru, Anda dapat menentukan
global
atau region Google Cloud saat membuat cluster admin. Anda menentukan region di flag--admin-cluster-membership-location
pada contoh perintah yang mengikutinya.Dapatkan daftar versi yang tersedia untuk diinstal di cluster pengguna:
gcloud container bare-metal clusters query-version-config \ --admin-cluster-membership=ADMIN_CLUSTER_NAME \ --admin-cluster-membership-project=FLEET_HOST_PROJECT_ID \ --admin-cluster-membership-location=ADMIN_CLUSTER_REGION \ --location=REGION
Ganti kode berikut:
ADMIN_CLUSTER_NAME
: Nama cluster admin.FLEET_HOST_PROJECT_ID
: ID project tempat cluster admin didaftarkan.ADMIN_CLUSTER_REGION
: Region keanggotaan fisik cluster admin. Opsi ini dapat bersifat global atau region Google Cloud. Gunakan lokasi untuk cluster admin dari outputgcloud container fleet memberships list
.REGION
: Region Google Cloud yang akan Anda gunakan saat membuat cluster. Ini adalah region tempat GKE On-Prem API serta layanan Fleet dan Connect dijalankan. Tentukanus-west1
atau wilayah lain yang didukung.
Output perintah ini akan mirip dengan berikut ini:
versions: - version: 1.16.2 - version: 1.16.1 - version: 1.16.0 - version: 1.15.7 - version: 1.15.6 - version: 1.15.5
Sebaiknya gunakan versi tertinggi yang didukung untuk mendapatkan perbaikan dan peningkatan terbaru.
Contoh
Bagian ini memberikan contoh perintah yang membuat cluster menggunakan load balancer MetalLB dan contoh menggunakan load balancer manual. Informasi yang Anda tentukan bervariasi, bergantung pada jenis load balancer yang akan digunakan. Lihat Ringkasan load balancer untuk mengetahui informasi selengkapnya.
Contoh tersebut membuat cluster tanpa kumpulan node. Setelah cluster berjalan, Anda harus menambahkan kumpulan node sebelum men-deploy workload.
MetalLB
Contoh ini menunjukkan cara membuat cluster pengguna dengan load balancer MetalLB yang dipaketkan.
gcloud container bare-metal clusters create USER_CLUSTER_NAME \ --project=FLEET_HOST_PROJECT_ID \ --admin-cluster-membership=ADMIN_CLUSTER_NAME \ --admin-cluster-membership-project=FLEET_HOST_PROJECT_ID \ --admin-cluster-membership-location=ADMIN_CLUSTER_REGION \ --location=REGION \ --version=VERSION \ --admin-users=YOUR_EMAIL_ADDRESS \ --admin-users=ANOTHER_EMAIL_ADDRESS \ --metal-lb-address-pools='pool=NAME,avoid-buggy-ips=True|False,manual-assign=True|False,addresses=IP_ADDRESS_RANGE_1;IP_ADDRESS_RANGE_2;...' \ --control-plane-node-configs='node-ip=CP_IP_ADDRESS_1,labels=CP_KEY_1.1=CP_VALUE_1.1;CP_KEY_1.2=CP_VALUE_1.2;...' \ --control-plane-vip=CONTROL_PLANE_VIP \ --control-plane-load-balancer-port=CONTROL_PLANE_LB_PORT \ --ingress-vip=INGRESS_VIP \ --island-mode-service-address-cidr-blocks=SERVICE_CIDR_BLOCK \ --island-mode-pod-address-cidr-blocks=POD_CIDR_BLOCK \ --lvp-share-path=/mnt/localpv-share \ --lvp-share-storage-class=local-shared \ --lvp-node-mounts-config-path=/mnt/localpv-disk \ --lvp-node-mounts-config-storage-class=local-disks
Ganti kode berikut:
-
USER_CLUSTER_NAME
: Nama pilihan Anda untuk cluster pengguna. Nama tidak dapat diubah setelah cluster dibuat. Namanya harus:- berisi maksimal 40 karakter
- hanya berisi karakter alfanumerik huruf kecil atau tanda hubung (
-
) - diawali dengan karakter alfabet
- diakhiri dengan karakter alfanumerik
-
FLEET_HOST_PROJECT_ID
: ID project tempat Anda ingin membuat cluster. Project yang ditentukan juga digunakan sebagai project host fleet. Project ini harus sama dengan project yang didaftarkan cluster admin. Setelah dibuat, cluster pengguna akan otomatis didaftarkan ke fleet project yang dipilih. Project host fleet tidak dapat diubah setelah cluster dibuat. -
ADMIN_CLUSTER_NAME
: Nama cluster admin yang mengelola cluster pengguna. Dalam flag--admin-cluster-membership
, Anda dapat menggunakan nama cluster yang ditentukan sepenuhnya, yang memiliki format berikut:projects/FLEET_HOST_PROJECT_ID/locations/ADMIN_CLUSTER_REGION/memberships/ADMIN_CLUSTER_NAME
Atau, Anda dapat menetapkan
--admin-cluster-membership
ke nama cluster admin, seperti dalam perintah contoh. Jika Anda hanya menggunakan nama cluster admin, tetapkan project ID cluster admin dengan--admin-cluster-membership-project
dan lokasi dengan--admin-cluster-membership-location
. Lokasi cluster admin adalahglobal
atau region Google Cloud. Jika Anda perlu menemukan region, jalankangcloud container fleet memberships list
. -
REGION
: Region Google Cloud tempat GKE On-Prem API (gkeonprem.googleapis.com
), layanan Fleet (gkehub.googleapis.com
), dan layanan Connect (gkeconnect.googleapis.com
) dijalankan. Tentukanus-west1
atau wilayah lain yang didukung. Region tidak dapat diubah setelah cluster dibuat. Setelan ini menentukan region tempat hal berikut disimpan:- Metadata cluster pengguna yang diperlukan GKE On-Prem API untuk mengelola siklus proses cluster
- Data Cloud Logging dan Cloud Monitoring komponen sistem
- Log Audit Admin yang dibuat oleh Cloud Audit Logs
Semua nama cluster, project, dan lokasi secara unik mengidentifikasi cluster di Google Cloud.
-
VERSION
: Versi Google Distributed Cloud untuk cluster pengguna Anda. -
YOUR_EMAIL_ADDRESS
danANOTHER_EMAIL_ADDRESS
: Jika tidak menyertakan flag--admin-users
, sebagai pembuat cluster, Anda diberi hak istimewa admin cluster secara default. Namun, jika Anda menyertakan--admin-users
untuk menetapkan pengguna lain sebagai administrator, Anda harus mengganti alamat default dan harus menyertakan alamat email Anda serta alamat email administrator lainnya. Misalnya, untuk menambahkan dua administrator:--admin-users=sara@example.com \ --admin-users=amal@example.com
Saat cluster dibuat, GKE On-Prem API menerapkan kebijakan kontrol akses berbasis peran (RBAC) Kubernetes ke cluster tersebut untuk memberi Anda dan pengguna admin lainnya peran
clusterrole/cluster-admin
Kubernetes, yang menyediakan akses penuh ke setiap resource di cluster di semua namespace.
Kumpulan alamat MetalLB
--metal-lb-address-pools
: Menentukan konfigurasi untuk kumpulan alamat yang akan digunakan oleh load balancer MetalLB. Nilai untuk tanda memiliki format berikut:
'pool=NAME,avoid-buggy-ips=True|False,manual-assign=True|False,addresses=IP_ADDRESS_RANGE_1;IP_ADDRESS_RANGE_2;...' \
Nilai ini memiliki segmen yang diawali dengan kata kunci
pool
, avoid-buggy-ip
, manual-assign
, dan
addresses
. Pisahkan setiap segmen dengan koma.
pool
: Nama pilihan Anda untuk kolam renang.avoid-buggy-ips
: Jika Anda menetapkannya keTrue
, pengontrol MetalLB tidak akan menetapkan alamat IP yang diakhiri dengan .0 atau .255 ke Layanan. Hal ini akan menghindari masalah perangkat konsumen yang memiliki bug, yang secara keliru menurunkan traffic yang dikirim ke alamat IP khusus tersebut. Jika tidak ditentukan, setelan defaultnya adalahFalse
.manual-assign
: Jika Anda tidak ingin pengontrol MetalLB menetapkan alamat IP secara otomatis dari kumpulan ini ke Layanan, tetapkan keTrue
. Kemudian, developer dapat membuat Layanan jenisLoadBalancer
dan menentukan salah satu alamat dari kumpulan secara manual. Jika tidak ditentukan,manual-assign
akan ditetapkan keFalse
.Dalam daftar
addresses
: Setiap alamat harus berupa rentang dalam format CIDR atau rentang dengan tanda hubung. Untuk menentukan satu alamat IP dalam kumpulan (misalnya untuk VIP masuk), gunakan /32 dalam notasi CIDR (misalnya 192.0.2.1/32).
Perhatikan aturan sintaksis berikut:
- Mengapit seluruh nilai dalam tanda kutip tunggal.
- Spasi kosong tidak diizinkan.
- Pisahkan setiap rentang alamat IP dengan titik koma.
Anda dapat menentukan lebih dari satu instance flag, seperti ditunjukkan dalam contoh berikut:
--metal-lb-address-pools='pool=pool1,avoid-buggy-ips=False,manual-assign=True,addresses=192.0.2.0/26;192.0.2.64-192.0.2.72' --metal-lb-address-pools='pool=pool2,avoid-buggy-ips=True,manual-assign=True,addresses=10.251.133.0/24;10.251.134.80/32'
Node MetalLB
Opsional:
--metal-lb-load-balancer-node-configs
: Secara default, load balancer berjalan pada node yang sama dengan bidang kontrol. Jika Anda perlu menjalankan load balancer pada kumpulan node pekerja khusus, tentukan flag ini untuk setiap node. Semua node dalam kumpulan node load balancer harus berada di subnet Lapisan 2 yang sama dengan IP virtual (VIP) load balancer.Nilai untuk tanda memiliki format berikut:
'node-ip=LB_IP_ADDRESS_1,labels=LB_KEY_1.1=LB_VALUE_1.1;LB_KEY_1.2=LB_VALUE_1.2;...' \
Nilai ini memiliki segmen yang dimulai dengan kata kunci
node-ip
danlabels
. Pisahkan setiap segmen dengan koma.node-ip
: Alamat IP node di kumpulan node load balancer. Anda hanya dapat menentukan satunode-ip
per tanda. Jika Anda perlu menentukan lebih dari satu node, sertakan kembali flag untuk setiap node.labels
: Satu atau beberapa key-value pair yang dilampirkan ke node.
Perhatikan aturan sintaksis berikut:
- Mengapit seluruh nilai dalam tanda kutip tunggal.
- Spasi kosong tidak diizinkan.
- Pisahkan setiap pasangan kunci=nilai di segmen
labels
dengan titik koma.
Jika menentukan
--metal-lb-load-balancer-node-configs
, Anda dapat menyertakan tanda berikut secara opsional:--metal-lb-load-balancer-node-labels
: Gunakan tanda ini untuk menambahkan label ke semua node di kumpulan node load balancer. Pisahkan daftar key=value pair dengan koma.--metal-lb-load-balancer-node-labels=KEY_1=VALUE_1,KEY_2=VALUE_2
--metal-lb-load-balancer-node-taints
: Gunakan flag ini untuk menambahkan taint ke semua node di kumpulan node load balancer. Setiap taint adalah pasangan kunci=nilai yang terkait dengan efek, yang harus berupa salah satu dari hal berikut:PreferNoSchedule
,NoSchedule
, atauNoExecute
.--metal-lb-load-balancer-node-taints=KEY_1=VALUE_1:EFFECT_1,KEY_2=VALUE_2:EFFECT_2
Contoh berikut menambahkan tiga node ke kumpulan node load balancer. Semua node diberi label
lb-pool-key=lb-pool-value
dan memilikidedicated=experimental:PreferNoSchedule
taint,--metal-lb-load-balancer-node-configs='node-ip=192.0.2.1' \ --metal-lb-load-balancer-node-configs='node-ip=192.0.2.2,labels=key2.1=value2.1' \ --metal-lb-load-balancer-node-configs='node-ip=192.0.2.3,labels=key3.1=value3.1;key3.2=value3.2' \ --metal-lb-load-balancer-node-labels=lb-pool-key=lb-pool-value \ --metal-lb-load-balancer-node-taints=dedicated=experimental:PreferNoSchedule \
Node bidang kontrol
-
--control-plane-node-configs
: Alamat IPv4 node bidang kontrol. Node bidang kontrol menjalankan workload sistem. Tentukan tanda ini untuk setiap node bidang kontrol. Biasanya, Anda memiliki satu mesin jika menggunakan deployment minimum, atau tiga mesin jika menggunakan deployment ketersediaan tinggi (HA). Tentukan jumlah node ganjil agar memiliki kuorum mayoritas untuk HA. Anda dapat mengubah alamat ini setiap kali mengupdate atau mengupgrade cluster.Nilai untuk tanda memiliki format berikut:
'node-ip=CP_IP_ADDRESS_1,labels=CP_KEY_1.1=CP_VALUE_1.1;CP_KEY_1.2=CP_VALUE_1.2;...' \
Nilai ini memiliki segmen yang dimulai dengan kata kunci
node-ip
danlabels
. Pisahkan setiap segmen dengan koma. -
node-ip
: Alamat IP node bidang kontrol. Anda hanya dapat menentukan satunode-ip
per tanda. Jika Anda perlu menentukan lebih dari satu node, sertakan kembali flag untuk setiap node. -
labels
: Satu atau beberapa key-value pair yang dilampirkan ke node.Perhatikan aturan sintaksis berikut:
- Mengapit seluruh nilai dalam tanda kutip tunggal.
- Spasi kosong tidak diizinkan.
- Pisahkan setiap pasangan kunci=nilai di segmen
labels
dengan titik koma.
Secara opsional, sertakan flag berikut:
-
--control-plane-node-labels
: Gunakan tanda ini untuk menambahkan label ke semua node bidang kontrol. Pisahkan daftar key-value pair dengan koma.--control-plane-node-labels=KEY_1=VALUE_1,KEY_2=VALUE_2
-
--control-plane-node-taints
: Gunakan tanda ini untuk menambahkan taint ke semua node bidang kontrol. Setiap taint adalah pasangan key=value yang terkait dengan efek, yang harus berupa salah satu dari hal berikut:PreferNoSchedule
,NoSchedule
, atauNoExecute
.Contoh berikut menambahkan tiga node ke node bidang kontrol. Semua node diberi label
cp-node-pool-key=cp-node-pool-value
dan memiliki taintdedicated=experimental:PreferNoSchedule
.--control-plane-node-configs='node-ip=192.0.2.1' \ --control-plane-node-configs='node-ip=192.0.2.2,labels=key2.1=value2.1' \ --control-planer-node-configs='node-ip=192.0.2.3,labels=key3.1=value3.1;key3.2=value3.2' \ --control-plane-node-labels=cp-node-pool-key=cp-node-pool-value \ --control-plane-node-taints=dedicated=experimental:PreferNoSchedule \
IP Virtual
-
CONTROL_PLANE_VIP
: Alamat IP yang telah Anda pilih untuk dikonfigurasi pada load balancer untuk server Kubernetes API dari cluster pengguna.Contoh:
--control-plane-vip=203.0.113.3
-
CONTROL_PLANE_LB_PORT
: Port tempat load balancer menyalurkan server Kubernetes API.Contoh:
-control-plane-load-balancer-port=443
-
INGRESS_VIP
: Alamat IP yang telah Anda pilih untuk dikonfigurasi pada load balancer untuk proxy masuknya.Contoh:
--ingress-vip=10.251.134.80
Alamat IP untuk VIP masuk harus berada dalam salah satu kumpulan alamat MetalLB.
Layanan dan CIDR Pod
-
SERVICE_CIDR_BLOCK
: Rentang alamat IP, dalam format CIDR, yang akan digunakan untuk Layanan di cluster Anda. Rentang CIDR harus antara /24 dan /12, dengan /12 memberikan alamat IP terbanyak.Contoh:
--island-mode-service-address-cidr-blocks=10.96.0.0/20
-
POD_CIDR_BLOCK
: Rentang alamat IP, dalam format CIDR, yang akan digunakan untuk Pod di cluster Anda. Rentang CIDR harus antara /18 dan /8, dengan /8 memberikan alamat IP terbanyak.Contoh:
--island-mode-pod-address-cidr-blocks=192.168.0.0/16
Penyimpanan
-
--lvp-share-path
: Ini adalah jalur mesin host tempat subdirektori dapat dibuat. PersistentVolume (PV) lokal dibuat untuk setiap subdirektori. -
--lvp-share-storage-class
: Ini adalah StorageClass yang akan digunakan untuk membuat volume persisten. StorageClass dibuat selama pembuatan cluster. -
--lvp-node-mounts-config-path
: Ini adalah jalur mesin host tempat disk yang terpasang dapat ditemukan. PersistentVolume (PV) lokal dibuat untuk setiap pemasangan. -
--lvp-node-mounts-config-storage
: Kelas penyimpanan yang digunakan untuk membuat PV selama pembuatan cluster.
Untuk mengetahui informasi selengkapnya tentang penyimpanan, lihat Mengonfigurasi penyimpanan lokal.
Manual
Dengan load balancing manual, Anda mengonfigurasi solusi load balancing untuk bidang kontrol dan traffic bidang data. Anda harus mengonfigurasi VIP bidang kontrol pada load balancer eksternal sebelum membuat cluster. Load balancer bidang kontrol eksternal juga dapat digunakan untuk traffic bidang data, atau Anda dapat menyiapkan load balancer terpisah untuk bidang data. Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi load balancing manual.
Pastikan untuk men-scroll jika diperlukan guna mengisi
placeholder ADMIN_CLUSTER_NAME
untuk
flag --admin-cluster-membership
.
gcloud container bare-metal clusters create USER_CLUSTER_NAME \ --project=FLEET_HOST_PROJECT_ID \ --admin-cluster-membership=ADMIN_CLUSTER_NAME \ --admin-cluster-membership-project=FLEET_HOST_PROJECT_ID \ --admin-cluster-membership-location=ADMIN_CLUSTER_REGION \ --location=REGION \ --version=VERSION \ --admin-users=YOUR_EMAIL_ADDRESS \ --admin-users=ANOTHER_EMAIL_ADDRESS \ --enable-manual-lb \ --control-plane-node-configs='node-ip=CP_IP_ADDRESS_1,labels=CP_KEY_1.1=CP_VALUE_1.1;CP_KEY_1.2=CP_VALUE_1.2;...' \ --control-plane-vip=CONTROL_PLANE_VIP \ --control-plane-load-balancer-port=CONTROL_PLANE_LB_PORT \ --ingress-vip=INGRESS_VIP \ --island-mode-service-address-cidr-blocks=SERVICE_CIDR_BLOCK \ --island-mode-pod-address-cidr-blocks=POD_CIDR_BLOCK \ --lvp-share-path=/mnt/localpv-share \ --lvp-share-storage-class=local-shared \ --lvp-node-mounts-config-path=/mnt/localpv-disk \ --lvp-node-mounts-config-storage-class=local-disks
Ganti kode berikut:
-
USER_CLUSTER_NAME
: Nama pilihan Anda untuk cluster pengguna. Nama tidak dapat diubah setelah cluster dibuat. Namanya harus:- berisi maksimal 40 karakter
- hanya berisi karakter alfanumerik huruf kecil atau tanda hubung (
-
) - diawali dengan karakter alfabet
- diakhiri dengan karakter alfanumerik
-
FLEET_HOST_PROJECT_ID
: ID project tempat Anda ingin membuat cluster. Project yang ditentukan juga digunakan sebagai project host fleet. Project ini harus sama dengan project yang didaftarkan cluster admin. Setelah dibuat, cluster pengguna akan otomatis didaftarkan ke fleet project yang dipilih. Project host fleet tidak dapat diubah setelah cluster dibuat. -
ADMIN_CLUSTER_NAME
: Nama cluster admin yang mengelola cluster pengguna. Dalam flag--admin-cluster-membership
, Anda dapat menggunakan nama cluster yang ditentukan sepenuhnya, yang memiliki format berikut:projects/FLEET_HOST_PROJECT_ID/locations/ADMIN_CLUSTER_REGION/memberships/ADMIN_CLUSTER_NAME
Atau, Anda dapat menetapkan
--admin-cluster-membership
ke nama cluster admin, seperti dalam perintah contoh. Jika Anda hanya menggunakan nama cluster admin, tetapkan project ID cluster admin dengan--admin-cluster-membership-project
dan lokasi dengan--admin-cluster-membership-location
. Lokasi cluster admin adalahglobal
atau region Google Cloud. Jika Anda perlu menemukan region, jalankangcloud container fleet memberships list
. -
REGION
: Region Google Cloud tempat GKE On-Prem API (gkeonprem.googleapis.com
), layanan Fleet (gkehub.googleapis.com
), dan layanan Connect (gkeconnect.googleapis.com
) dijalankan. Tentukanus-west1
atau wilayah lain yang didukung. Region tidak dapat diubah setelah cluster dibuat. Setelan ini menentukan region tempat hal berikut disimpan:- Metadata cluster pengguna yang diperlukan GKE On-Prem API untuk mengelola siklus proses cluster
- Data Cloud Logging dan Cloud Monitoring komponen sistem
- Log Audit Admin yang dibuat oleh Cloud Audit Logs
Semua nama cluster, project, dan lokasi secara unik mengidentifikasi cluster di Google Cloud.
-
VERSION
: Versi Google Distributed Cloud untuk cluster pengguna Anda. -
YOUR_EMAIL_ADDRESS
danANOTHER_EMAIL_ADDRESS
: Jika tidak menyertakan flag--admin-users
, sebagai pembuat cluster, Anda diberi hak istimewa admin cluster secara default. Namun, jika Anda menyertakan--admin-users
untuk menetapkan pengguna lain sebagai administrator, Anda harus mengganti alamat default dan harus menyertakan alamat email Anda serta alamat email administrator lainnya. Misalnya, untuk menambahkan dua administrator:--admin-users=sara@example.com \ --admin-users=amal@example.com
Saat cluster dibuat, GKE On-Prem API menerapkan kebijakan kontrol akses berbasis peran (RBAC) Kubernetes ke cluster tersebut untuk memberi Anda dan pengguna admin lainnya peran
clusterrole/cluster-admin
Kubernetes, yang menyediakan akses penuh ke setiap resource di cluster di semua namespace.
Node bidang kontrol
-
--control-plane-node-configs
: Alamat IPv4 node bidang kontrol. Node bidang kontrol menjalankan workload sistem. Tentukan tanda ini untuk setiap node bidang kontrol. Biasanya, Anda memiliki satu mesin jika menggunakan deployment minimum, atau tiga mesin jika menggunakan deployment ketersediaan tinggi (HA). Tentukan jumlah node ganjil agar memiliki kuorum mayoritas untuk HA. Anda dapat mengubah alamat ini setiap kali mengupdate atau mengupgrade cluster.Nilai untuk tanda memiliki format berikut:
'node-ip=CP_IP_ADDRESS_1,labels=CP_KEY_1.1=CP_VALUE_1.1;CP_KEY_1.2=CP_VALUE_1.2;...' \
Nilai ini memiliki segmen yang dimulai dengan kata kunci
node-ip
danlabels
. Pisahkan setiap segmen dengan koma. -
node-ip
: Alamat IP node bidang kontrol. Anda hanya dapat menentukan satunode-ip
per tanda. Jika Anda perlu menentukan lebih dari satu node, sertakan kembali flag untuk setiap node. -
labels
: Satu atau beberapa key-value pair yang dilampirkan ke node.Perhatikan aturan sintaksis berikut:
- Mengapit seluruh nilai dalam tanda kutip tunggal.
- Spasi kosong tidak diizinkan.
- Pisahkan setiap pasangan kunci=nilai di segmen
labels
dengan titik koma.
Secara opsional, sertakan flag berikut:
-
--control-plane-node-labels
: Gunakan tanda ini untuk menambahkan label ke semua node bidang kontrol. Pisahkan daftar key-value pair dengan koma.--control-plane-node-labels=KEY_1=VALUE_1,KEY_2=VALUE_2
-
--control-plane-node-taints
: Gunakan tanda ini untuk menambahkan taint ke semua node bidang kontrol. Setiap taint adalah pasangan key=value yang terkait dengan efek, yang harus berupa salah satu dari hal berikut:PreferNoSchedule
,NoSchedule
, atauNoExecute
.Contoh berikut menambahkan tiga node ke node bidang kontrol. Semua node diberi label
cp-node-pool-key=cp-node-pool-value
dan memiliki taintdedicated=experimental:PreferNoSchedule
.--control-plane-node-configs='node-ip=192.0.2.1' \ --control-plane-node-configs='node-ip=192.0.2.2,labels=key2.1=value2.1' \ --control-planer-node-configs='node-ip=192.0.2.3,labels=key3.1=value3.1;key3.2=value3.2' \ --control-plane-node-labels=cp-node-pool-key=cp-node-pool-value \ --control-plane-node-taints=dedicated=experimental:PreferNoSchedule \
IP Virtual
-
CONTROL_PLANE_VIP
: Alamat IP yang telah Anda pilih untuk dikonfigurasi pada load balancer untuk server Kubernetes API dari cluster pengguna.Contoh:
--control-plane-vip=203.0.113.3
-
CONTROL_PLANE_LB_PORT
: Port tempat load balancer menyalurkan server Kubernetes API.Contoh:
-control-plane-load-balancer-port=443
-
INGRESS_VIP
: Alamat IP yang telah Anda pilih untuk dikonfigurasi pada load balancer untuk proxy masuknya.Contoh:
--ingress-vip=10.251.134.80
Alamat IP untuk VIP masuk harus berada dalam salah satu kumpulan alamat MetalLB.
Layanan dan CIDR Pod
-
SERVICE_CIDR_BLOCK
: Rentang alamat IP, dalam format CIDR, yang akan digunakan untuk Layanan di cluster Anda. Rentang CIDR harus antara /24 dan /12, dengan /12 memberikan alamat IP terbanyak.Contoh:
--island-mode-service-address-cidr-blocks=10.96.0.0/20
-
POD_CIDR_BLOCK
: Rentang alamat IP, dalam format CIDR, yang akan digunakan untuk Pod di cluster Anda. Rentang CIDR harus antara /18 dan /8, dengan /8 memberikan alamat IP terbanyak.Contoh:
--island-mode-pod-address-cidr-blocks=192.168.0.0/16
Penyimpanan
-
--lvp-share-path
: Ini adalah jalur mesin host tempat subdirektori dapat dibuat. PersistentVolume (PV) lokal dibuat untuk setiap subdirektori. -
--lvp-share-storage-class
: Ini adalah StorageClass yang akan digunakan untuk membuat volume persisten. StorageClass dibuat selama pembuatan cluster. -
--lvp-node-mounts-config-path
: Ini adalah jalur mesin host tempat disk yang terpasang dapat ditemukan. PersistentVolume (PV) lokal dibuat untuk setiap pemasangan. -
--lvp-node-mounts-config-storage
: Kelas penyimpanan yang digunakan untuk membuat PV selama pembuatan cluster.
Untuk mengetahui informasi selengkapnya tentang penyimpanan, lihat Mengonfigurasi penyimpanan lokal.
Sebelum menjalankan perintah gcloud
untuk membuat cluster, Anda mungkin ingin
menyertakan --validate-only
untuk memvalidasi konfigurasi yang Anda tentukan dalam
flag ke perintah gcloud
. Jika sudah siap membuat cluster,
hapus flag ini dan jalankan perintah.
Output dari perintah ini mirip dengan berikut ini:
Waiting for operation [projects/example-project-12345/locations/us-west1/operations/operation-1679543737105-5f7893fd5bae9-942b3f97-75e59179] to complete.
Pada contoh output, string operation-1679543737105-5f7893fd5bae9-942b3f97-75e59179
adalah OPERATION_ID
dari operasi yang berjalan lama. Anda dapat mengetahui status operasi ini dengan perintah berikut:
gcloud container bare-metal operations describe OPERATION_ID \ --project=FLEET_HOST_PROJECT_ID \ --location=REGION
Perlu waktu 15 menit atau lebih untuk membuat cluster pengguna. Anda dapat melihat cluster ini di Konsol Google Cloud di halaman Cluster GKE.
Untuk mengetahui daftar lengkap flag dan deskripsinya, baca referensi gcloud CLI.
Membuat node pool
Setelah cluster dibuat, Anda perlu membuat minimal satu kumpulan node sebelum men-deploy workload. Kumpulan node adalah template untuk grup worker node yang dibuat dalam cluster ini. Dengan gcloud CLI, Anda membuat cluster terlebih dahulu, lalu menambahkan satu atau beberapa node pool ke cluster yang baru dibuat.
gcloud container bare-metal node-pools create NODE_POOL_NAME \ --cluster=USER_CLUSTER_NAME \ --project=FLEET_HOST_PROJECT_ID \ --location=REGION \ --node-configs='node-ip=NP_IP_ADDRESS_1,labels=NP_KEY_1.1=NP_VALUE_1.1;NP_KEY_1.2=NP_VALUE_1.2;...'
Ganti kode berikut:
NODE_POOL_NAME
: Nama pilihan Anda untuk kumpulan node. Namanya harus:- berisi maksimal 40 karakter
- hanya berisi karakter alfanumerik huruf kecil atau tanda hubung (
-
) - diawali dengan karakter alfabet
- diakhiri dengan karakter alfanumerik
USER_CLUSTER_NAME
: Nama cluster pengguna yang baru dibuat.FLEET_HOST_PROJECT_ID
: ID project tempat cluster didaftarkan.REGION
: Region Google Cloud yang Anda tentukan saat membuat cluster.--node-configs
: Alamat IPv4 mesin node pekerja. Tentukan flag ini untuk setiap node. Nilai untuk tanda memiliki format berikut:'node-ip=NP_IP_ADDRESS_1,labels=NP_KEY_1.1=NP_VALUE_1.1;NP_KEY_1.2=NP_VALUE_1.2;...' \
Nilai ini memiliki segmen yang dimulai dengan kata kunci
node-ip
danlabels
. Pisahkan setiap segmen dengan koma.node-ip
: Alamat IP node pekerja. Anda hanya dapat menentukan satunode-ip
per flag. Tambahkan flag ini lagi untuk setiap node di kumpulan node.labels
: Satu atau beberapa key-value pair yang dilampirkan ke node.
Perhatikan aturan sintaksis berikut:
- Mengapit seluruh nilai dalam tanda kutip tunggal.
- Spasi kosong tidak diizinkan.
- Pisahkan setiap pasangan kunci=nilai di segmen
labels
dengan titik koma.
Secara opsional, Anda dapat menentukan hal berikut:
--node-labels=KEY=VALUE,...
: Daftar yang dipisahkan koma untuk label Kubernetes (key=value pair) yang diterapkan ke setiap node dalam kumpulan.--node-taints=KEY=VALUE:EFFECT,...
Daftar taint Kubernetes yang dipisahkan koma yang diterapkan ke setiap node dalam kumpulan. Taint adalah key-value pair yang terkait dengan suatu efek. Taint digunakan dengan toleransi untuk penjadwalan Pod. Tentukan salah satu hal berikut untukEFFECT
:NoSchedule
,PreferNoSchedule
,NoExecute
.
Contoh berikut membuat kumpulan node yang disebut default-pool
pada
user-cluster-
, dan menambahkan dua node ke kumpulan node. Semua
kedua node diberi label node-pool-key=node-pool-value
dan
memiliki dedicated=experimental:PreferNoSchedule
taint,
gcloud container bare-metal node-pools create default-pool \ --cluster=user-cluster-1 \ --project=example-project-12345 \ --location=us-west1 \ --node-configs='node-ip=10.200.0.10' \ --node-configs='node-ip=10.200.0.11,labels=key2.1=value2.1' \ --node-labels=node-pool-key=node-pool-value \ --node-taints=dedicated=experimental:PreferNoSchedule
Untuk mengetahui informasi lebih lanjut, baca referensi gcloud CLI.
Terraform
Sebelum memulai
Versi Google Distributed Cloud yang Anda pilih saat membuat cluster pengguna harus berupa versi yang didukung oleh cluster admin Anda. Selain itu, versi minor atau patch terbaru tidak tersedia di GKE On-Prem API hingga 7 hingga 10 hari setelah rilis. Anda dapat menjalankan perintah gcloud
untuk mendapatkan daftar
versi yang didukung yang dapat diinstal di cluster pengguna.
Pastikan untuk mengupdate komponen:
gcloud components update
Mendapatkan nama dan lokasi keanggotaan fleet cluster admin Anda:
gcloud container fleet memberships list \ --project=FLEET_HOST_PROJECT_ID
Ganti
FLEET_HOST_PROJECT_ID
dengan ID project tempat cluster admin terdaftar.Outputnya mirip dengan hal berikut ini:
NAME EXTERNAL_ID LOCATION admin-cluster-1 bb7803b4-8438-4b22-859f-4559b4b29072 global admin-cluster-2 ee16ee2b-6ec0-49fc-9413-3c89cbc70854 global admin-cluster-3 fc2b7ef5-39ff-4b63-b919-04c5adc67be4 us-west1
Lokasi menentukan tempat layanan Fleet dan Connect dijalankan. Cluster admin yang dibuat sebelum versi 1.28 dikelola oleh layanan Fleet and Connect global. Pada versi 1.28 dan yang lebih baru, Anda dapat menentukan
global
atau region Google Cloud saat membuat cluster admin. Anda menentukan region di flag--admin-cluster-membership-location
pada contoh perintah yang mengikutinya.Dapatkan daftar versi yang tersedia untuk diinstal di cluster pengguna:
gcloud container bare-metal clusters query-version-config \ --admin-cluster-membership=ADMIN_CLUSTER_NAME \ --admin-cluster-membership-project=FLEET_HOST_PROJECT_ID \ --admin-cluster-membership-location=ADMIN_CLUSTER_REGION \ --location=REGION
Ganti kode berikut:
ADMIN_CLUSTER_NAME
: Nama cluster admin.FLEET_HOST_PROJECT_ID
: ID project tempat cluster admin didaftarkan.ADMIN_CLUSTER_REGION
: Region keanggotaan fisik cluster admin. Opsi ini dapat bersifat global atau region Google Cloud. Gunakan lokasi untuk cluster admin dari outputgcloud container fleet memberships list
.REGION
: Region Google Cloud yang akan Anda gunakan saat membuat cluster. Ini adalah region tempat GKE On-Prem API serta layanan Fleet dan Connect dijalankan. Tentukanus-west1
atau wilayah lain yang didukung.
Output perintah ini akan mirip dengan berikut ini:
versions: - version: 1.16.2 - version: 1.16.1 - version: 1.16.0 - version: 1.15.7 - version: 1.15.6 - version: 1.15.5
Sebaiknya gunakan versi tertinggi yang didukung untuk mendapatkan perbaikan dan peningkatan terbaru.
Contoh
Anda dapat menggunakan contoh konfigurasi dasar berikut untuk membuat cluster pengguna dengan load balancer MetalLB yang dipaketkan. Untuk mengetahui informasi selengkapnya, lihat
dokumentasi referensi google_gkeonprem_bare_metal_cluster
.
Tetapkan variabel di terraform.tfvars
Contoh ini menyediakan contoh file variabel untuk diteruskan ke main.tf
, yang menunjukkan cara mengonfigurasi load balancer MetalLB yang dipaketkan.
Buat clone repositori
anthos-samples
dan ubah ke direktori tempat sampel Terraform berada:git clone https://github.com/GoogleCloudPlatform/anthos-samples cd anthos-samples/anthos-onprem-terraform/abm_user_cluster_metallb
Contoh ini memberikan contoh file variabel untuk diteruskan ke
main.tf
.Buat salinan file
terraform.tfvars.sample
:cp terraform.tfvars.sample terraform.tfvars
Ubah nilai parameter di
terraform.tfvars
dan simpan file tersebut.Daftar berikut menjelaskan variabel:
project_id
: ID project tempat Anda ingin membuat cluster. Project yang ditentukan juga digunakan sebagai project host fleet. Project ini harus sama dengan project yang didaftarkan ke cluster admin. Setelah dibuat, cluster pengguna akan otomatis didaftarkan ke inventaris project yang dipilih. Project host fleet tidak dapat diubah setelah cluster dibuat.region
: Region Google Cloud tempat GKE On-Prem API (gkeonprem.googleapis.com
), layanan Fleet (gkehub.googleapis.com
), dan layanan Connect (gkeconnect.googleapis.com
) dijalankan. Tentukanus-west1
atau wilayah lain yang didukung.
admin_cluster_name
: Nama cluster admin yang mengelola cluster pengguna. Contoh ini mengasumsikan bahwa cluster admin menggunakanglobal
sebagai region. Jika Anda memiliki cluster admin regional:Buka
main.tf
di editor teks.Telusuri
admin_cluster_membership
, yang akan terlihat seperti berikut:admin_cluster_membership = "projects/${var.project_id}/locations/global/memberships/${var.admin_cluster_name}"
Ubah
global
ke region yang digunakan cluster admin dan simpan file tersebut.
bare_metal_version
: Versi Google Distributed Cloud untuk cluster pengguna Anda. Tentukan versi yang sama dengan cluster admin, atau versi yang tidak lebih dari satu versi minor lebih rendah dari cluster admin.admin_user_emails
: Daftar alamat email pengguna yang akan diberi hak istimewa administratif di cluster. Pastikan untuk menambahkan alamat email jika Anda ingin mengelola cluster.Saat cluster dibuat, GKE On-Prem API menerapkan kebijakan kontrol akses berbasis peran (RBAC) Kubernetes ke cluster untuk memberikan peran
clusterrole/cluster-admin
Kubernetes kepada pengguna admin, yang menyediakan akses penuh ke setiap resource di cluster di semua namespace. Hal ini juga memungkinkan pengguna login ke konsol menggunakan identitas Google mereka.cluster_name
: Nama pilihan Anda untuk cluster pengguna. Nama tidak dapat diubah setelah cluster dibuat. Namanya harus:- berisi maksimal 40 karakter
- hanya berisi karakter alfanumerik huruf kecil atau tanda hubung (
-
) - diawali dengan karakter alfabet
- diakhiri dengan karakter alfanumerik
control_plane_ips
: Daftar satu atau beberapa alamat IPv4 untuk node bidang kontrol. Node bidang kontrol menjalankan beban kerja sistem. Biasanya, Anda memiliki satu mesin jika menggunakan deployment minimum, atau tiga mesin jika menggunakan deployment ketersediaan tinggi (HA). Tentukan jumlah ganjil node agar memiliki kuorum mayoritas untuk HA. Anda dapat mengubah alamat ini setiap kali mengupdate atau mengupgrade cluster.worker_node_ips
: Daftar satu atau beberapa alamat IPv4 untuk mesin node pekerja.control_plane_vip
: Alamat IP virtual (VIP) yang telah Anda pilih untuk dikonfigurasi pada load balancer untuk server Kubernetes API dari cluster pengguna.ingress_vip
: Alamat IP yang telah Anda pilih untuk dikonfigurasi pada load balancer untuk proxy masuk.lb_address_pools
: Daftar peta yang menentukan kumpulan alamat yang akan digunakan oleh load balancer MetalLB. VIP masuknya harus berada di salah satu kolam ini.
Simpan perubahan di
terraform.tfvars
.Lakukan inisialisasi dan buat paket Terraform:
terraform init
Terraform menginstal semua library yang diperlukan, seperti penyedia Google Cloud.
Tinjau konfigurasi dan buat perubahan jika diperlukan:
terraform plan
Terapkan rencana Terraform untuk membuat cluster pengguna:
terraform apply
Perlu waktu 15 menit atau lebih untuk membuat cluster pengguna. Anda dapat melihat cluster ini di Konsol Google Cloud di halaman Cluster GKE.
Menghubungkan ke cluster pengguna
Saat Anda membuat cluster pengguna di konsol, cluster tersebut dikonfigurasi dengan kebijakan kontrol akses berbasis peran (RBAC) Kubernetes sehingga Anda dapat login ke cluster menggunakan Google Cloud Identity. Saat Anda membuat cluster pengguna dengan gcloud CLI, secara default Anda diberi kebijakan RBAC ini jika Anda tidak menyertakan flag --admin-users
. Jika Anda menyertakan
--admin-users
untuk menetapkan pengguna lain sebagai administrator, Anda dapat mengganti
alamat default dan harus menyertakan alamat email serta
alamat email administrator lainnya. Untuk mengetahui informasi lebih lanjut tentang kebijakan IAM dan RBAC yang diperlukan, lihat Menyiapkan autentikasi identitas Google.
Semua cluster memiliki endpoint kanonis. Endpoint mengekspos server Kubernetes API
yang digunakan kubectl
dan layanan lainnya untuk berkomunikasi dengan
bidang kontrol cluster Anda melalui TCP port 443. Endpoint ini tidak dapat diakses
di internet publik. Jika memiliki akses ke endpoint pribadi cluster melalui VPC, Anda dapat terhubung langsung ke endpoint pribadi dan membuat file kubeconfig
secara langsung. Jika tidak, Anda dapat menggunakan
Hubungkan gateway.
Untuk mengakses cluster pengguna dari command line, Anda memerlukan file kubeconfig
.
Ada dua cara untuk mendapatkan file kubeconfig
:
Gunakan gateway Connect untuk mengakses cluster dari komputer yang telah menginstal Google Cloud CLI. Dalam hal ini,
kubectl
menggunakankubeconfig
gateway Connect, yang meneruskan traffic ke endpoint pribadi dengan aman untuk Anda.Untuk akses langsung ke endpoint pribadi, buat file
kubeconfig
di workstation admin dan kelola cluster dari workstation admin Anda.
Pastikan Anda menunggu hingga konsol Google Cloud menunjukkan bahwa status cluster pengguna responsif.
Hubungkan gateway
initialize gcloud CLI untuk digunakan dengan project host fleet, atau jalankan perintah berikut untuk login dengan Akun Google Anda, tetapkan project host fleet Anda sebagai default, dan perbarui komponen:
gcloud auth login gcloud config set project PROJECT_ID gcloud components update
Ambil kredensial cluster yang digunakan untuk berinteraksi dengan gateway Connect. Dalam perintah berikut, ganti
MEMBERSHIP_NAME
dengan nama cluster Anda. Di Google Distributed Cloud, nama keanggotaan sama dengan nama cluster.gcloud container fleet memberships get-credentials MEMBERSHIP_NAME
Perintah ini akan menampilkan Connect khusus gateway
kubeconfig
yang memungkinkan Anda terhubung ke cluster melalui gateway.
Setelah memiliki kredensial yang diperlukan, Anda dapat menjalankan perintah menggunakan
kubectl
seperti yang biasa Anda lakukan untuk cluster Kubernetes mana pun, dan tidak perlu
menentukan nama file kubeconfig
, misalnya:
kubectl get namespaces
Workstation admin
Gunakan perintah bmctl get credentials
untuk mengambil file kubeconfig
bagi
cluster pengguna yang baru dibuat.
bmctl get credentials --cluster CLUSTER_NAME --admin-kubeconfig ADMIN_KUBECONFIG_PATH
Ganti kode berikut:
CLUSTER_NAME: nama cluster pengguna target.
ADMIN_KUBECONFIG_PATH: jalur ke file
kubeconfig
cluster admin.
kubeconfig
dengan kredensial cluster pengguna ditulis ke file,
bmctl-workspace/CLUSTER_NAME/CLUSTER_NAME-TIMESTAMP-kubeconfig
.
TIMESTAMP dalam nama file menunjukkan tanggal dan waktu file
dibuat.
Karena file ini berisi kredensial autentikasi untuk cluster Anda, sebaiknya simpan di lokasi yang aman dengan akses terbatas.