Membuat cluster dasar

Halaman ini adalah bagian kedua dari panduan yang memandu Anda dalam menggunakan Google Distributed Cloud (khusus software) di bare metal (sebelumnya dikenal sebagai Google Distributed Cloud Virtual, sebelumnya dikenal sebagai cluster Anthos di bare metal) untuk membuat penginstalan proof of concept kecil dari cluster GKE di hardware bare metal Anda. 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 dan menunjukkan cara membuat cluster admin dan cluster pengguna. Kemudian, Anda dapat melanjutkan ke Membuat Layanan dan Ingress.

Halaman ini ditujukan untuk Admin, arsitek, dan Operator yang menyiapkan, memantau, dan mengelola siklus proses infrastruktur teknologi yang mendasarinya. Untuk mempelajari lebih lanjut peran umum dan contoh tugas yang kami referensikan dalam konten Google Cloud, lihat Peran dan tugas pengguna GKE Enterprise umum.

Panduan ini membantu Anda membuat penginstalan Google Distributed Cloud minimal. Penginstalan minimum ini mungkin tidak sesuai dengan kebutuhan produksi dan kasus penggunaan Anda yang sebenarnya. Untuk 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 dalam alur Membuat cluster admin bare metal di konsol Google Cloud.

  2. Jika ingin menggunakan Terraform untuk membuat cluster pengguna, Anda memerlukan Terraform di workstation admin atau 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 untuk 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 melakukan inisialisasi API. Anda dapat melakukannya dengan memanggil perintah gcloud CLI yang menampilkan versi yang tersedia dan dapat Anda gunakan untuk membuat cluster:

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

Ringkasan prosedur

Pembuatan 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 di Menyiapkan infrastruktur minimal atau dari perencana jaringan 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 telah diisi sebelumnya 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 fleet. 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 cluster admin. ADMIN_CP_VIP
VIP untuk server Kubernetes API cluster pengguna. USER_CP_VIP
Satu VIP yang akan digunakan sebagai alamat eksternal untuk proxy masuk. USER_INGRESS_VIP
Rentang sepuluh alamat IP untuk digunakan sebagai alamat IP eksternal untuk Layanan jenis LoadBalancer. Perhatikan bahwa rentang ini mencakup VIP masuk, yang diperlukan oleh MetalLB. Tidak ada alamat IP lain yang dapat tumpang-tindih dengan rentang ini. START_IP-END_IP
CIDR Pod dan Layanan
Rentang alamat IP dalam notasi blok CIDR untuk digunakan oleh Pod di cluster admin. Nilai awal yang direkomendasikan, yang telah diisi otomatis 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 telah diisi otomatis 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 sebelumnya di 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 sebelumnya di 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 penginstalan cluster admin dan cluster pengguna yang 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 terdaftar dengan API. Pendaftaran terjadi meskipun spec.gkeOnPremAPI tidak ditentukan dalam file konfigurasi cluster. Dengan mendaftar ke API yang dihosting Google Cloud ini, Anda dapat mengelola siklus proses cluster menggunakan konsol Google Cloud atau gcloud CLI.

Untuk menonaktifkan pendaftaran otomatis, hapus 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 cluster dibuat.

Untuk membuat cluster admin untuk penginstalan minimal:

  1. Tetapkan kredensial default yang dapat digunakan Google Distributed Cloud 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 dari file konfigurasi yang dihasilkan:

    • Komentar telah dihapus dari contoh ini untuk meningkatkan keterbacaan.
    • 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 sampel yang Anda verifikasi di 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.

    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 Anda berjalan, responsnya akan terlihat seperti ini:

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

  7. Untuk memberikan peran clusterrole/cluster-admin Kubernetes ke akun pengguna 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 dipangkas 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 membuat cluster pengguna untuk cluster admin minimal dan penginstalan cluster pengguna. Pastikan Anda telah memberikan nilai untuk setiap placeholder dalam tabel di bagian Mengumpulkan informasi sebelumnya sebelum melanjutkan.

Untuk membuat cluster pengguna untuk penginstalan minimal:

bmctl

Jika GKE On-Prem API (gkeonprem.googleapis.com) diaktifkan untuk project Anda, cluster yang baru dibuat akan otomatis terdaftar 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 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 cluster 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 di tabel perencanaan sebelumnya. Selain nilai yang Anda masukkan, perhatikan perbedaan berikut dari file konfigurasi yang dihasilkan:

    • Komentar telah dihapus dari contoh ini untuk meningkatkan keterbacaan.
    • Jenis cluster, spec.type, telah ditetapkan ke user.
    • Kolom spec.clusterSecurity.authorization.clusterAdmin.gcpAccounts 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 lainnya.
    ---
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 sampel yang Anda verifikasi di 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.

    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 Anda 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 bare metal cluster.

    Buka Membuat cluster bare metal

  2. Pastikan daftar project Google Cloud telah memilih PROJECT_ID.

  3. Klik Create Cluster.

  4. Dalam dialog, klik On-premises.

  5. Di samping Bare metal, klik Configure. Halaman Prasyarat akan ditampilkan.

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

  7. Klik Berikutnya.

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 Versi Google Distributed Cloud, pilih CLUSTER_VERSION atau gunakan default. Anda dapat menggunakan setelan default untuk setelan lainnya di halaman ini.

  5. Klik Networking di menu navigasi sebelah kiri.

Jaringan

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

    USER_CP_NODE_IP

  2. Di bagian Load balancer, gunakan load balancer default, Disertakan dengan MetalLB.

  3. Buka bagian Pembentukan 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 IPs, masukkan alamat IP untuk Control Plane VIP:

    USER_CP_VIP

  6. Masukkan alamat IP untuk VIP Ingress:

    USER_INGRESS_VIP

  7. Di bagian Service and Pod CIDRs, jika tidak mengubah Service dan Pod CIDRs di perencana, Anda dapat menggunakan setelan 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 default pool di menu navigasi sebelah kiri.

Membuat node pool

Cluster Anda harus memiliki minimal satu node pool untuk node pekerja. Node pool 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.

    Pembuatan cluster pengguna memerlukan waktu 15 menit atau lebih. Konsol menampilkan pesan status saat memverifikasi setelan dan membuat cluster.

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

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

    Saat cluster dibuat, Status cluster: berjalan akan ditampilkan.

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

gcloud CLI

Bagian ini menunjukkan cara membuat cluster pengguna dan node pool 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 akan 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 dibuat, Anda dapat menjalankan perintah sebelumnya setiap saat 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 node pool di 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 node pool menggunakan Terraform.

  1. Buat direktori dan file baru di 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 di 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.

  4. Lakukan inisialisasi dan buat rencana Terraform:

    terraform init

    Terraform menginstal library yang diperlukan, seperti penyedia Google Cloud.

  5. Tinjau konfigurasi dan buat perubahan jika diperlukan:

    terraform plan

  6. Terapkan rencana 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 dasar dan node pool.

  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 aman dengan akses terbatas.

  8. Pastikan cluster Anda telah dibuat dan berjalan:

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

    Jika cluster Anda 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 Anda gunakan untuk membuat cluster pengguna, alamat email Anda akan diberikan kebijakan kontrol akses berbasis peran (RBAC) yang memungkinkan Anda terhubung ke cluster dengan hak istimewa administratif penuh. Tempat alamat email Anda ditentukan bergantung pada alat:

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

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

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

Meskipun hanya alamat email Anda 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 berikut:

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

  • Memungkinkan 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 koneksi, 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. Sekarang Anda dapat menjalankan perintah kubectl melalui gateway connect:

    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 memerlukan kubeconfig untuk cluster admin. Anda harus menjalankan perintah tersebut di workstation admin.

Langkah selanjutnya