Membuat cluster dasar

Halaman ini adalah bagian kedua dari panduan yang memandu Anda melalui penginstalan kecil bukti konsep GDCV untuk Bare Metal. Bagian pertama, Menyiapkan infrastruktur minimal, menunjukkan cara menyiapkan hardware, merencanakan alamat IP, dan menyiapkan infrastruktur Google Cloud yang diperlukan. Dokumen ini dibuat berdasarkan penyiapan dan perencanaan dari bagian sebelumnya, serta menunjukkan cara membuat cluster admin dan cluster pengguna. Anda kemudian dapat membuka Membuat Layanan dan Ingress.

Panduan ini membantu Anda membuat GKE minimal pada penginstalan Bare Metal. Penginstalan minimal ini mungkin tidak cocok dengan kebutuhan produksi dan kasus penggunaan Anda yang sebenarnya. Untuk mengetahui informasi tentang penginstalan produksi, lihat panduan penginstalan.

Sebelum memulai

  1. Pastikan Anda telah menyiapkan hardware dan merencanakan alamat IP seperti yang dijelaskan di bagian sebelumnya dalam panduan ini, Menyiapkan infrastruktur minimal. Atau, gunakan perencana persyaratan jaringan di bagian Prasyarat dari alur Create a GKE on Bare Metal admin cluster di Konsol Google Cloud.

  2. Jika ingin menggunakan Terraform untuk membuat cluster pengguna, Anda memerlukan Terraform di workstation admin Anda atau di komputer lain.

    1. Pastikan Anda telah menginstal komponen Google Cloud CLI terbaru:

      gcloud components update

  3. Lakukan langkah-langkah berikut untuk mengaktifkan dan menggunakan GKE On-Prem API:

    1. Aktifkan API di project Anda:

      gcloud services enable \
    --project PROJECT_ID \
    gkeonprem.googleapis.com

      Ganti PROJECT_ID dengan project ID project host fleet Anda.

      Jika Anda mendapatkan error PERMISSION_DENIED, periksa kembali project ID yang Anda masukkan. Jika project ID sudah benar, jalankan gcloud auth login untuk login ke Google Cloud CLI dengan akun yang memiliki akses ke project.

    2. Jika ini adalah pertama kalinya Anda mengaktifkan GKE On-Prem API di project, Anda harus menginisialisasi API. Anda dapat melakukannya dengan memanggil perintah gcloud CLI yang menampilkan versi yang tersedia, yang dapat digunakan untuk membuat cluster:

      gcloud container bare-metal clusters query-version-config \
    --project=PROJECT_ID \
    --location="us-central1"

Ringkasan prosedur

Membuat cluster dasar terdiri dari langkah-langkah utama berikut:

  1. Kumpulkan informasi yang digunakan untuk menentukan konfigurasi cluster Anda.

  2. Buat cluster admin untuk mengelola cluster pengguna Anda.

  3. Buat cluster pengguna yang dapat menjalankan beban kerja Anda.

1. Mengumpulkan informasi

Gunakan informasi yang Anda siapkan dalam Menyiapkan infrastruktur minimal atau dari Network Planner untuk mengisi setiap placeholder dalam tabel berikut. Placeholder sesuai dengan nilai kolom dalam file konfigurasi cluster untuk penginstalan minimal satu cluster admin dan satu cluster pengguna. Beberapa placeholder ditetapkan ke nilai yang diisi otomatis dari file konfigurasi cluster yang dihasilkan, tetapi semua placeholder dapat diedit.

Informasi cluster dasar
Nama cluster admin yang Anda buat. Lokasi dan penamaan artefak cluster di workstation admin didasarkan pada nama cluster. Namespace cluster berasal dari nama cluster. ADMIN_CLUSTER_NAME
Nama cluster pengguna yang Anda buat. Lokasi dan penamaan artefak cluster di workstation admin didasarkan pada nama cluster. Namespace cluster berasal dari nama cluster. USER_CLUSTER_NAME
Versi bmctl yang Anda download di bagian pertama panduan ini. CLUSTER_VERSION
Informasi akun
Jalur ke file kunci pribadi SSH di workstation admin Anda. Secara default, jalurnya adalah
/home/USERNAME/.ssh/id_rsa.		 SSH_PRIVATE_KEY_PATH
ID project Google Cloud yang ingin Anda gunakan untuk menghubungkan cluster ke Google Cloud dan melihat log serta metrik. Project ini juga disebut sebagai project host armada. PROJECT_ID
Alamat email yang terkait dengan akun Google Cloud Anda. Misalnya: alex@example.com. GOOGLE_ACCOUNT_EMAIL
Alamat IP mesin node
Satu alamat IP untuk node bidang kontrol cluster admin. ADMIN_CP_NODE_IP
Satu alamat IP untuk node bidang kontrol cluster pengguna. USER_CP_NODE_IP
Satu alamat IP untuk node pekerja cluster pengguna. USER_WORKER_NODE_IP
Alamat VIP
VIP untuk server Kubernetes API dari cluster admin. ADMIN_CP_VIP
VIP untuk server Kubernetes API cluster pengguna. USER_CP_VIP
Satu VIP untuk digunakan sebagai alamat eksternal untuk proxy masuk. USER_INGRESS_VIP
Rentang sepuluh alamat IP untuk digunakan sebagai alamat IP eksternal untuk Service jenis LoadBalancer. Perhatikan bahwa rentang ini mencakup VIP ingress, yang diperlukan oleh MetalLB. Tidak ada alamat IP lain yang dapat tumpang-tindih dengan rentang ini. START_IP-END_IP
CIDR Pod dan Service
Rentang alamat IP dalam notasi blok CIDR untuk digunakan oleh Pod di cluster admin. Nilai awal yang direkomendasikan, yang sudah diisi sebelumnya dalam file konfigurasi cluster yang dihasilkan adalah 192.168.0.0/16. 192.168.0.0/16
Rentang alamat IP dalam notasi blok CIDR untuk digunakan oleh Layanan di cluster admin. Nilai awal yang direkomendasikan, yang sudah diisi sebelumnya dalam file konfigurasi cluster yang dihasilkan adalah 10.96.0.0/20. 10.96.0.0/20
Rentang alamat IP dalam notasi blok CIDR untuk digunakan oleh Pod di cluster pengguna. Nilai awal yang direkomendasikan, yang telah diisi otomatis dalam file konfigurasi cluster yang dihasilkan dan merupakan nilai default di konsol adalah 192.168.0.0/16. 192.168.0.0/16
Rentang alamat IP dalam notasi blok CIDR untuk digunakan oleh Layanan di cluster pengguna. Nilai awal yang direkomendasikan, yang telah diisi otomatis dalam file konfigurasi cluster yang dihasilkan dan merupakan nilai default di konsol adalah 10.96.0.0/20. 10.96.0.0/20

2. Membuat cluster admin

Langkah-langkah berikut akan membuat cluster admin untuk cluster admin dan penginstalan cluster pengguna minimal. Pastikan Anda telah memberikan nilai untuk setiap placeholder dalam tabel di bagian Mengumpulkan informasi sebelumnya sebelum melanjutkan.

Jika GKE On-Prem API (gkeonprem.googleapis.com) diaktifkan untuk project Anda, cluster yang baru dibuat akan otomatis didaftarkan dengan API. Pendaftaran terjadi meskipun spec.gkeOnPremAPI tidak ditentukan dalam file konfigurasi cluster. Dengan mendaftar ke API yang dihosting Google Cloud, Anda dapat mengelola siklus proses cluster menggunakan Konsol Google Cloud atau gcloud CLI.

Untuk menonaktifkan pendaftaran otomatis, hapus tanda komentar pada bagian spec.gkeOnPremAPI di file konfigurasi cluster dan tetapkan spec.gkeOnPremAPI.enabled ke false sebelum Anda membuat cluster. Kolom spec.gkeOnPremAPI.enabled dapat diubah, sehingga Anda dapat membatalkan pendaftaran cluster kapan saja setelah dibuat.

Untuk membuat cluster admin bagi penginstalan minimal:

  1. Tetapkan kredensial default yang dapat digunakan GKE di Bare Metal untuk membuat cluster dengan perintah berikut:

    gcloud auth application-default login

  2. Untuk membuat file konfigurasi cluster, jalankan perintah berikut dari direktori /baremetal di workstation admin Anda:

    bmctl create config -c ADMIN_CLUSTER_NAME \
    --enable-apis --create-service-accounts --project-id=PROJECT_ID

  3. Verifikasi file konfigurasi cluster admin:

    File konfigurasi cluster berikut diisi dengan nilai yang Anda masukkan dalam tabel perencanaan di bagian sebelumnya. Selain nilai yang Anda masukkan, perhatikan perbedaan berikut dengan file konfigurasi yang dihasilkan:

    • Komentar telah dihapus dari sampel ini agar lebih mudah dibaca.
    • Spesifikasi NodePool telah dihapus. Node pekerja tidak diizinkan untuk cluster admin.
    gcrKeyPath: bmctl-workspace/.sa-keys/PROJECT_ID-anthos-baremetal-gcr.json
sshPrivateKeyPath: SSH_PRIVATE_KEY_PATH
gkeConnectAgentServiceAccountKeyPath: bmctl-workspace/.sa-keys/PROJECT_ID-anthos-baremetal-connect.json
gkeConnectRegisterServiceAccountKeyPath: bmctl-workspace/.sa-keys/PROJECT_ID-anthos-baremetal-register.json
cloudOperationsServiceAccountKeyPath: bmctl-workspace/.sa-keys/PROJECT_ID-anthos-baremetal-cloud-ops.json
---
apiVersion: v1
kind: Namespace
metadata:
  name: cluster-ADMIN_CLUSTER_NAME
---
apiVersion: baremetal.cluster.gke.io/v1
kind: Cluster
metadata:
  name: ADMIN_CLUSTER_NAME
  namespace: cluster-ADMIN_CLUSTER_NAME
spec:
  type: admin
  profile: default
  anthosBareMetalVersion: CLUSTER_VERSION
  gkeConnect:
    projectID: PROJECT_ID
  controlPlane:
    nodePoolSpec:
      nodes:
      - address: ADMIN_CP_NODE_IP
  clusterNetwork:
    pods:
      cidrBlocks:
      - 192.168.0.0/16
    services:
      cidrBlocks:
      - 10.96.0.0/20
  loadBalancer:
    mode: bundled
    ports:
      controlPlaneLBPort: 443
    vips:
      controlPlaneVIP: ADMIN_CP_VIP
  clusterOperations:
    projectID: PROJECT_ID
    location: us-central1
  storage:
    lvpNodeMounts:
      path: /mnt/localpv-disk
      storageClassName: local-disks
    lvpShare:
      path: /mnt/localpv-share
      storageClassName: local-shared
      numPVUnderSharedPath: 5
  nodeConfig:
    podDensity:
      maxPodsPerNode: 250
  # GKEOnPremAPI (Optional) Specify if you wish to explicitly enable/disable the cloud hosted gkeonprem
  # API to enable/disable cluster lifecycle management from gcloud UI and Terraform.
  # gkeOnPremAPI:
    # enabled: false
    # location is the Cloud location for the cluster resource metadata where the cluster will be enrolled.
    # location: us-central1

  4. Ganti konten file konfigurasi yang dihasilkan di workstation admin Anda dengan konten dari contoh sebelumnya.

    Buka file yang dihasilkan, bmctl-workspace/ADMIN_CLUSTER_NAME/ADMIN_CLUSTER_NAME.yaml, dan ganti kontennya dengan konten contoh yang telah Anda verifikasi pada langkah sebelumnya.

  5. Untuk membuat cluster admin, jalankan perintah berikut dari direktori /baremetal di workstation admin Anda:

    bmctl create cluster -c ADMIN_CLUSTER_NAME

    Perintah bmctl menampilkan output ke layar saat menjalankan pemeriksaan preflight dan membuat cluster. Informasi panjang ditulis ke log di folder baremetal/bmctl-workspace/ADMIN_CLUSTER_NAME/log di workstation admin.

    Proses pembuatan cluster dapat memerlukan waktu beberapa menit.

  6. Pastikan cluster Anda telah dibuat dan berjalan:

    kubectl --kubeconfig bmctl-workspace/ADMIN_CLUSTER_NAME/ADMIN_CLUSTER_NAME-kubeconfig \
    get nodes

    Jika cluster sedang berjalan, responsnya akan terlihat seperti ini:

    NAME     STATUS  ROLES          AGE  VERSION
node-01  Ready   control-plane  16h  v1.25.7-gke.1000

  7. Untuk memberi akun pengguna Anda peran clusterrole/cluster-admin Kubernetes di cluster, jalankan perintah gcloud berikut:

    gcloud container fleet memberships generate-gateway-rbac \
    --membership=ADMIN_CLUSTER_NAME \
    --role=clusterrole/cluster-admin \
    --users=GOOGLE_ACCOUNT_EMAIL \
    --project=PROJECT_ID \
    --kubeconfig=bmctl-workspace/ADMIN_CLUSTER_NAME/ADMIN_CLUSTER_NAME-kubeconfig \
    --context=ADMIN_CLUSTER_NAME-admin@ADMIN_CLUSTER_NAME \
    --apply

    Output perintah ini mirip dengan berikut ini, yang dipotong agar mudah dibaca:

    Validating input arguments.
Specified Cluster Role is: clusterrole/cluster-admin
Generated RBAC policy is:
--------------------------------------------
...

Applying the generate RBAC policy to cluster with kubeconfig: /root/bmctl-workspace/<var class="edit"scope="ADMIN_CLUSTER_NAME">ADMIN_CLUSTER_NAME</var>/<var class="edit"scope="ADMIN_CLUSTER_NAME">ADMIN_CLUSTER_NAME</var>-kubeconfig, context: <var class="edit"scope="ADMIN_CLUSTER_NAME">ADMIN_CLUSTER_NAME</var>-admin@<var class="edit"scope="ADMIN_CLUSTER_NAME">ADMIN_CLUSTER_NAME</var>
Writing RBAC policy for user: GOOGLE_ACCOUNT_EMAIL to cluster.
Successfully applied the RBAC policy to cluster.

    Di antara hal lainnya, kebijakan RBAC memungkinkan Anda login ke cluster di Konsol Google Cloud untuk melihat detail cluster selengkapnya.

3. Membuat cluster pengguna

Langkah-langkah berikut akan membuat cluster pengguna untuk cluster admin dan penginstalan cluster pengguna minimal. Pastikan Anda telah memberikan nilai untuk setiap placeholder dalam tabel di bagian Mengumpulkan informasi sebelumnya sebelum melanjutkan.

Untuk membuat cluster pengguna bagi penginstalan minimal:

bmctl

Jika GKE On-Prem API (gkeonprem.googleapis.com) diaktifkan untuk project Anda, cluster yang baru dibuat akan otomatis didaftarkan dengan API. Pendaftaran terjadi meskipun spec.gkeOnPremAPI tidak ditentukan dalam file konfigurasi cluster. Saat cluster Anda terdaftar dengan API yang dihosting Google Cloud ini, Anda dapat menggunakan Konsol Google Cloud atau gcloud CLI untuk mengelola siklus proses cluster.

Untuk menonaktifkan pendaftaran otomatis, hapus tanda komentar pada bagian spec.gkeOnPremAPI di file konfigurasi cluster dan tetapkan spec.gkeOnPremAPI.enabled ke false sebelum Anda membuat cluster. Kolom spec.gkeOnPremAPI.enabled dapat berubah, sehingga Anda dapat membatalkan pendaftaran cluster kapan saja setelah dibuat.

  1. Buat file konfigurasi cluster:

    bmctl create config -c USER_CLUSTER_NAME \
  --project-id=PROJECT_ID

  2. Verifikasi file konfigurasi cluster pengguna:

    File konfigurasi cluster berikut diisi dengan nilai yang Anda masukkan dalam tabel perencanaan sebelumnya. Selain nilai yang Anda masukkan, perhatikan perbedaan berikut dengan file konfigurasi yang dihasilkan:

    • Komentar telah dihapus dari sampel ini agar lebih mudah dibaca.
    • Jenis cluster, spec.type, telah ditetapkan ke user.
    • Kolom spec.clusterSecurity.authorization.clusterAdmin.gcpAccounts telah ditambahkan untuk memberikan clusterrole/cluster-admin ke akun Anda. Di antara hal lainnya, kolom ini memungkinkan Anda login ke cluster di Konsol Google Cloud untuk melihat detail cluster selengkapnya.
    ---
apiVersion: v1
kind: Namespace
metadata:
  name: cluster-USER_CLUSTER_NAME
---
apiVersion: baremetal.cluster.gke.io/v1
kind: Cluster
metadata:
  name: USER_CLUSTER_NAME
  namespace: cluster-USER_CLUSTER_NAME
spec:
  type: user
  profile: default
  anthosBareMetalVersion: CLUSTER_VERSION
  gkeConnect:
    projectID: PROJECT_ID
  controlPlane:
    nodePoolSpec:
      nodes:
      - address: USER_CP_NODE_IP
  clusterNetwork:
    pods:
      cidrBlocks:
      - 192.168.0.0/16
    services:
      cidrBlocks:
      - 10.96.0.0/20
  loadBalancer:
    mode: bundled
    ports:
      controlPlaneLBPort: 443
    vips:
      controlPlaneVIP: USER_CP_VIP
      ingressVIP: USER_INGRESS_VIP
    addressPools:
    - name: pool1
      addresses:
      - START_IP-END_IP
  clusterOperations:
    projectID: PROJECT_ID
    location: us-central1
  clusterSecurity:
    authorization:
      clusterAdmin:
        gcpAccounts:
        - GOOGLE_ACCOUNT_EMAIL
  storage:
    lvpNodeMounts:
      path: /mnt/localpv-disk
      storageClassName: local-disks
    lvpShare:
      path: /mnt/localpv-share
      storageClassName: local-shared
      numPVUnderSharedPath: 5
  nodeConfig:
    podDensity:
      maxPodsPerNode: 250
  # GKEOnPremAPI (Optional) Specify if you wish to explicitly enable/disable the cloud hosted gkeonprem
  # API to enable/disable cluster lifecycle management from gcloud UI and Terraform.
  # gkeOnPremAPI:
    # enabled: false
    # location is the Cloud location for the cluster resource metadata where the cluster will be enrolled.
    # location: us-central1
---
apiVersion: baremetal.cluster.gke.io/v1
kind: NodePool
metadata:
  name: node-pool-1
  namespace: cluster-USER_CLUSTER_NAME
spec:
  clusterName: USER_CLUSTER_NAME
  nodes:
  - address: USER_WORKER_NODE_IP

  3. Ganti konten file konfigurasi yang dihasilkan di workstation admin Anda dengan konten dari contoh sebelumnya.

    Buka file yang dihasilkan, bmctl-workspace/USER_CLUSTER_NAME/USER_CLUSTER_NAME.yaml, dan ganti kontennya dengan konten contoh yang telah Anda verifikasi pada langkah sebelumnya.

  4. Buat cluster pengguna:

    bmctl create cluster -c USER_CLUSTER_NAME \
--kubeconfig bmctl-workspace/ADMIN_CLUSTER_NAME/ADMIN_CLUSTER_NAME-kubeconfig

    Perintah bmctl menampilkan output ke layar saat menjalankan pemeriksaan preflight dan membuat cluster. Informasi panjang ditulis ke log di folder baremetal/bmctl-workspace/USER_CLUSTER_NAME/log di workstation admin.

    Proses pembuatan cluster dapat memerlukan waktu beberapa menit.

  5. Pastikan cluster Anda telah dibuat dan berjalan:

    kubectl --kubeconfig bmctl-workspace/USER_CLUSTER_NAME/USER_CLUSTER_NAME-kubeconfig \
  get nodes

    Jika cluster sedang berjalan, responsnya akan terlihat seperti ini:

    NAME    STATUS   ROLES           AGE     VERSION
nuc-3   Ready    control-plane   4m32s   v1.26.2-gke.1001
nuc-4   Ready    worker          2m2s    v1.26.2-gke.1001

Konsol

Lakukan langkah-langkah berikut untuk membuat cluster pengguna di konsol:

  1. Di konsol, buka halaman Create a GKE on Bare Metal cluster.

    Buka Create a GKE pada cluster Bare Metal

  2. Pastikan daftar project Google Cloud telah memilih PROJECT_ID.

  3. Di bagian Pilih jenis cluster Anda, pilih Buat cluster pengguna untuk cluster admin yang ada

  4. Klik Next.

Dasar-dasar cluster

  1. Masukkan USER_CLUSTER_NAME sebagai nama cluster pengguna atau gunakan default.

  2. Pastikan cluster admin yang baru dibuat dipilih.

  3. Di GCP API Location, pilih us-central1.

  4. Di GDCV for Bare Metal versi, pilih CLUSTER_VERSION atau gunakan default. Anda dapat menggunakan default untuk setelan lainnya di halaman ini.

  5. Klik Networking di menu navigasi sebelah kiri.

Networking

  1. Di bagian Control bidang, masukkan perintah berikut di kolom Control plane node IP 1:

    USER_CP_NODE_IP

  2. Di bagian Load balancer, gunakan load balancer default, Bundled with MetalLB.

  3. Buka bagian Kumpulan alamat baru. Masukkan rentang alamat IP di kolom IP address range 1:

    10.200.0.51-10.200.0.70

  4. Klik Done.

  5. Di bagian Virtual IP, masukkan alamat IP untuk Control Plane VIP:

    USER_CP_VIP

  6. Masukkan alamat IP untuk Ingress VIP:

    USER_INGRESS_VIP

  7. Di bagian Service and Pod CIDRs, jika Anda tidak mengubah CIDR Pod dan Layanan di planner, Anda dapat menggunakan default.

    Jika Anda mengubah CIDR, masukkan CIDR yang ingin digunakan:

    • CIDR layanan:
    10.96.0.0/20
    • CIDR Pod:
    192.168.0.0/16

  8. Klik kumpulan default di menu navigasi sebelah kiri.

Membuat node pool

Cluster Anda harus memiliki minimal satu kumpulan node untuk node pekerja. Kumpulan node adalah template untuk grup node pekerja yang dibuat di cluster ini.

Masukkan alamat IP node pekerja cluster pengguna di kolom Nodes address 1:

USER_WORKER_NODE_IP

Membuat cluster

  1. Klik Verifikasi dan Buat untuk membuat cluster pengguna.

    Perlu waktu 15 menit atau lebih untuk membuat cluster pengguna. Console akan menampilkan pesan status saat memverifikasi setelan dan membuat cluster.

    Jika ada masalah dengan konfigurasi, konsol akan menampilkan pesan error yang seharusnya cukup jelas bagi Anda untuk memperbaiki masalah konfigurasi, lalu mencoba lagi untuk membuat cluster.

    Untuk melihat informasi tambahan tentang proses pembuatan, klik Show details untuk menampilkan panel samping. Klik untuk menutup panel detail.

    Saat cluster dibuat, Status cluster: berjalan akan ditampilkan.

    Cluster screenshot siap

  2. Setelah cluster dibuat, klik Cluster untuk kembali ke halaman Clusters.

gcloud CLI

Bagian ini menunjukkan cara membuat cluster pengguna dan kumpulan node menggunakan gcloud CLI.

  1. Jalankan perintah berikut untuk membuat cluster pengguna:

    gcloud container bare-metal clusters create USER_CLUSTER_NAME \
  --project=PROJECT_ID \
  --location=us-central1 \
  --admin-cluster-membership=ADMIN_CLUSTER_NAME \
  --admin-cluster-membership-project=PROJECT_ID \
  --admin-cluster-membership-location=global \
  --version=CLUSTER_VERSION \
  --admin-users=GOOGLE_ACCOUNT_EMAIL \
  --island-mode-service-address-cidr-blocks=10.96.0.0/20 \
  --island-mode-pod-address-cidr-blocks=192.168.0.0/16 \
  --metal-lb-address-pools='pool=lb-pool-1,manual-assign=True,addresses=START_IP-END_IP' \
  --control-plane-node-configs='node-ip=USER_CP_NODE_IP' \
  --control-plane-vip=USER_CP_VIP \
  --control-plane-load-balancer-port=443 \
  --ingress-vip=USER_INGRESS_VIP \
  --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

    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.

    Dalam contoh output, string operation-1679543737105-5f7893fd5bae9-942b3f97-75e59179 adalah OPERATION_ID dari operasi yang berjalan lama. Anda dapat mengetahui status operasi dengan perintah berikut:

    gcloud container bare-metal operations describe OPERATION_ID \
  --project=PROJECT_ID \
  --location=us-central1

    Perlu waktu sekitar 15 menit atau lebih untuk membuat cluster. Saat cluster sedang dibuat, Anda dapat menjalankan perintah sebelumnya sesering mungkin untuk mendapatkan status saat ini.

    Saat cluster dibuat, Anda akan melihat output seperti berikut:

    Created Anthos cluster on bare metal [https://gkeonprem.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/bareMetalClusters/USER_CLUSTER_NAME].

  2. Setelah cluster dibuat, jalankan perintah berikut untuk membuat kumpulan node pada cluster yang baru dibuat.

    gcloud container bare-metal node-pools create node-pool-1 \
  --cluster=USER_CLUSTER_NAME \
  --project=PROJECT_ID \
  --location=us-central1 \
  --node-configs node-ip=USER_WORKER_NODE_IP

Untuk informasi selengkapnya dan contoh lainnya, lihat referensi berikut:

Terraform

Bagian ini menunjukkan cara membuat cluster pengguna dan kumpulan node menggunakan Terraform.

  1. Membuat direktori dan file baru dalam direktori tersebut. Nama file harus memiliki ekstensi .tf. Dalam panduan ini, file tersebut disebut main.tf.

    mkdir DIRECTORY && cd DIRECTORY && touch main.tf

  2. Verifikasi resource Terraform cluster pengguna:

    Contoh resource Terraform berikut diisi dengan nilai yang Anda masukkan dalam tabel perencanaan di bagian sebelumnya.

    resource "google_gkeonprem_bare_metal_cluster"  "cluster-basic" {
  provider = google-beta
  name = "USER_CLUSTER_NAME"
  project = "PROJECT_ID"
  location = "us-central1"
  admin_cluster_membership = "projects/PROJECT_ID/locations/global/memberships/ADMIN_CLUSTER_NAME"
  bare_metal_version = "CLUSTER_VERSION"
  network_config {
    island_mode_cidr {
      service_address_cidr_blocks = ["10.96.0.0/20"]
      pod_address_cidr_blocks = ["192.168.0.0/16"]
    }
  }
  control_plane {
    control_plane_node_pool_config {
      node_pool_config {
        labels = {}
        operating_system = "LINUX"
        node_configs {
          labels = {}
          node_ip = "USER_CP_NODE_IP"
        }
      }
    }
  }
  load_balancer {
    port_config {
      control_plane_load_balancer_port = 443
    }
    vip_config {
      control_plane_vip = "USER_CP_VIP"
      ingress_vip = "USER_INGRESS_VIP"
    }
    metal_lb_config {
      address_pools {
        pool = "pool1"
        addresses = [
          "START_IP-END_IP"
        ]
        avoid_buggy_ips = true
        manual_assign = true
      }
    }
  }
  storage {
    lvp_share_config {
      lvp_config {
        path = "/mnt/localpv-share"
        storage_class = "local-shared"
      }
      shared_path_pv_count = 5
    }
    lvp_node_mounts_config {
      path = "/mnt/localpv-disk"
      storage_class = "local-disks"
    }
  }
  security_config {
    authorization {
      admin_users {
        username = "GOOGLE_ACCOUNT_EMAIL"
      }
    }
  }
}

resource "google_gkeonprem_bare_metal_node_pool" "node-pool-default" {
  provider = google-beta
  name =  "node-pool-1"
  bare_metal_cluster = google_gkeonprem_bare_metal_cluster.cluster-basic.name
  project = "PROJECT_ID"
  location = "us-central1"
  node_pool_config {
    operating_system = "LINUX"
    node_configs {
      node_ip = "USER_WORKER_NODE_IP"
    }
  }
}

  3. Salin resource Terraform ke main.tf dan simpan file tersebut.

  4. Lakukan inisialisasi dan buat paket Terraform:

    terraform init

    Terraform menginstal semua library yang diperlukan, seperti penyedia Google Cloud.

  5. Tinjau konfigurasi dan buat perubahan jika diperlukan:

    terraform plan

  6. Terapkan paket Terraform untuk membuat cluster pengguna:

    terraform apply

    Saat diminta, masukkan yes.

    Perlu waktu sekitar 15 menit (atau lebih bergantung pada jaringan Anda) untuk membuat cluster pengguna dan kumpulan node dasar.

  7. Untuk membuat file kubeconfig bagi cluster pengguna, jalankan perintah berikut di workstation admin:

    bmctl get credentials --cluster USER_CLUSTER_NAME \
--admin-kubeconfig bmctl-workspace/ADMIN_CLUSTER_NAME/ADMIN_CLUSTER_NAME-kubeconfig

    Output dari perintah ini menampilkan nama file kubeconfig untuk cluster pengguna, misalnya:

    bmctl-workspace/USER_CLUSTER_NAME/USER_CLUSTER_NAME-TIMESTAMP-kubeconfig

    TIMESTAMP dalam nama file menunjukkan tanggal dan waktu file dibuat.

    Karena file ini berisi kredensial autentikasi untuk cluster, Anda harus menyimpannya di lokasi yang aman dengan akses yang dibatasi.

  8. Pastikan cluster Anda telah dibuat dan berjalan:

    kubectl --kubeconfig bmctl-workspace/USER_CLUSTER_NAME/USER_CLUSTER_NAME-TIMESTAMP-kubeconfig \
    get nodes

    Jika cluster sedang berjalan, responsnya akan terlihat seperti ini:

    NAME    STATUS   ROLES           AGE     VERSION
nuc-3   Ready    control-plane   4m32s   v1.26.2-gke.1001
nuc-4   Ready    worker          2m2s    v1.26.2-gke.1001

Untuk informasi selengkapnya dan contoh lainnya, lihat referensi berikut:

Menghubungkan ke cluster pengguna

Apa pun alat yang digunakan untuk membuat cluster pengguna, alamat email Anda akan diberi kebijakan role-based access control (RBAC) yang memungkinkan Anda terhubung ke cluster dengan hak istimewa administratif penuh. Tempat menentukan alamat email Anda bergantung pada alatnya:

  • bmctl: Alamat email Anda disertakan di bagian clusterSecurity pada contoh file konfigurasi pengguna.

  • Terraform: Alamat email Anda disertakan di bagian security_config pada contoh resource google_gkeonprem_bare_metal_cluster.

  • Konsol: Sebagai pembuat cluster, alamat email Anda secara otomatis disertakan di halaman Dasar-dasar cluster di bagian Authorization.

Meskipun hanya alamat email yang ditentukan, Anda dapat menyertakan alamat email lain untuk memberikan akses administratif ke cluster kepada pengguna lain.

Kebijakan RBAC yang diberikan ke alamat email Anda melakukan hal-hal berikut:

  • Memberi Anda peran clusterrole/cluster-admin Kubernetes di cluster.

  • Biarkan Anda login ke cluster di Konsol Google Cloud menggunakan identitas Google Anda. Anda dapat melihat cluster di halaman Cluster GKE di konsol.

  • Memungkinkan Anda menjalankan perintah kubectl di komputer lokal menggunakan kubeconfig gateway koneksi.

Untuk mendapatkan kubeconfig gateway yang terhubung, jalankan perintah berikut dari komputer lokal Anda:

  1. Dapatkan entri kubeconfig yang dapat mengakses cluster melalui gateway koneksi.

    gcloud container fleet memberships get-credentials USER_CLUSTER_NAME  \
--project=PROJECT_ID

    Outputnya mirip dengan hal berikut ini:

    Starting to build Gateway kubeconfig...
Current project_id: PROJECT_ID
A new kubeconfig entry "connectgateway_PROJECT_ID_global_USER_CLUSTER_NAME" has been generated and set as the current context.

  2. Anda kini dapat menjalankan perintah kubectl melalui gateway koneksi:

    kubectl get nodes

    Outputnya mirip dengan hal berikut ini:

    NAME    STATUS   ROLES           AGE     VERSION
nuc-3   Ready    control-plane   4m32s   v1.26.2-gke.1001
nuc-4   Ready    worker          2m2s    v1.26.2-gke.1001

    Banyak perintah kubectl yang memerlukan kubeconfig untuk cluster admin. Anda harus menjalankan perintah tersebut di workstation admin.

Langkah selanjutnya