Mengonfigurasi cluster agar dikelola oleh GKE On-Prem API

GKE On-Prem API adalah API yang dihosting Google Cloud yang memungkinkan Anda mengelola siklus proses cluster lokal menggunakan alat standar:Google Cloud konsol, Google Cloud CLI, atau Terraform. Saat Anda membuat cluster menggunakan salah satu alat ini, API akan menyimpan metadata tentang status cluster Anda di Google Cloud region yang Anda tentukan saat membuat cluster. Metadata ini memungkinkan Anda mengelola siklus proses cluster menggunakan alat standar. Jika ingin menggunakan alat ini untuk melihat detail cluster atau mengelola siklus proses cluster yang dibuat menggunakan gkectl, Anda harus mendaftarkan cluster di GKE On-Prem API.

Terminologi

Mendaftarkan cluster memungkinkan Anda mengelola siklus proses cluster menggunakan konsol, gcloud CLI, atau Terraform.

Mendaftarkan cluster adalah proses terpisah untuk mendaftarkan cluster ke fleet. Fleet adalah pengelompokan logis cluster Kubernetes yang dapat Anda kelola bersama. Semua cluster Google Distributed Cloud terdaftar ke fleet pada waktu pembuatan cluster. Saat Anda membuat cluster menggunakan gkectl, cluster didaftarkan ke Google Cloud project yang Anda tentukan di kolom gkeConnect.projectID dalam file konfigurasi cluster. Project ini disebut sebagai project host fleet. Untuk mempelajari fleet lebih lanjut, termasuk kasus penggunaan, praktik terbaik, dan contoh, lihat dokumentasi Pengelolaan fleet.

Melihat cluster terdaftar

Semua cluster fleet Anda ditampilkan di halaman Cluster GKE di konsol. Hal ini memberi Anda ringkasan seluruh fleet dan, untuk Google Distributed Cloud, memungkinkan Anda melihat cluster mana yang dikelola oleh GKE On-Prem API.

Untuk melihat cluster fleet Anda:

  1. Di konsol, buka halaman cluster GKE.
    Buka cluster GKE
  2. Pilih the Google Cloud project.
    • Jika VMware ditampilkan di kolom Type, cluster dikelola oleh GKE On-Prem API.
    • Jika External ditampilkan di kolom Type, cluster tidak dikelola oleh GKE On-Prem API.

Persyaratan

  • Cluster pengguna harus versi 1.11 atau yang lebih tinggi.

  • Cluster admin harus versi 1.13 atau yang lebih tinggi.

  • Jika Anda bukan pemilik project, Anda harus diberi peran Identity and Access Management roles/gkeonprem.admin di project tersebut. Untuk mengetahui detail izin yang disertakan dalam peran ini, lihat Peran GKE on-prem dalam dokumentasi IAM.

Sebelum memulai

  1. Siapkan gcloud CLI, jika diperlukan.

    1. Jika Anda perlu menginstal gcloud CLI, lihat dokumentasi gcloud CLI.

    2. Perbarui komponen gcloud CLI, jika diperlukan:

      gcloud components update

  2. 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. Ini adalah project ID yang dikonfigurasi di bagian gkeconnect dari file konfigurasi cluster admin atau file konfigurasi cluster pengguna.

      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 tersebut.

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

      gcloud container vmware clusters query-version-config \
    --project=PROJECT_ID \
    --location=REGION

      Ganti REGION dengan us-west1 atau region lain yang didukung.

  3. Jika organisasi Anda telah menyiapkan daftar yang diizinkan yang memungkinkan traffic dari Google API dan alamat lainnya melewati server proxy Anda, tambahkan hal berikut ke daftar yang diizinkan:

    • gkeonprem.googleapis.com
    • gkeonprem.mtls.googleapis.com

    Ini adalah nama layanan untuk GKE On-Prem API.

Mendaftarkan cluster pengguna

gcloud CLI

  1. Buat daftar keanggotaan fleet cluster terdaftar:

    gcloud container fleet memberships list \
    --project=PROJECT_ID

    Ganti PROJECT_ID dengan project ID project host fleet Anda.

    Perhatikan region tempat cluster admin yang mengelola cluster pengguna menjadi anggota karena Anda akan memerlukannya pada langkah berikutnya.

  2. Daftarkan cluster di GKE On-Prem API:

    gcloud container vmware clusters enroll USER_CLUSTER_NAME \
    --project=<var>PROJECT_ID</var> \
    --admin-cluster-membership=projects/PROJECT_ID/locations/MEMBERSHIP_REGION/memberships/ADMIN_CLUSTER_NAME \
    --location=REGION

    Ganti kode berikut:

    • USER_CLUSTER_NAME: nama cluster pengguna yang ingin Anda daftarkan.

    • PROJECT_ID: project ID project host fleet Anda.

    • MEMBERSHIP_REGION: region tempat cluster admin yang mengelola cluster pengguna menjadi anggota. Nilainya dapat berupa global atau a Google Cloud region.

    • ADMIN_CLUSTER_NAME: nama cluster admin yang mengelola cluster pengguna.

      ADMIN_CLUSTER_NAME, MEMBERSHIP_REGION, dan PROJECT_ID membentuk nama cluster yang sepenuhnya ditentukan untuk flag --admin-cluster-membership.

    • REGION: the Google Cloud region tempat GKE On-Prem API berjalan dan menyimpan metadata cluster. Tentukan us-west1 atau region lain yang didukung. Region tidak dapat diubah setelah cluster didaftarkan.

gkectl

Lakukan langkah-langkah berikut di workstation admin Anda.

  1. Tambahkan bagian berikut ke file konfigurasi cluster pengguna:

    gkeOnPremAPI:
  enabled:true
  location:REGION

    Ganti REGION dengan the Google Cloud region di mana GKE On-Prem API berjalan dan menyimpan metadata cluster. Tentukan us-west1 atau region lain yang didukung. Region tidak dapat diubah setelah cluster didaftarkan.

  2. Update cluster:

    gkectl update cluster --kubeconfig ADMIN_CLUSTER_KUBECONFIG --config USER_CLUSTER_CONFIG_FILE

    Ganti kode berikut:

    • ADMIN_CLUSTER_KUBECONFIG: jalur file kubeconfig cluster admin.

    • USER_CLUSTER_CONFIG_FILE: jalur file konfigurasi cluster pengguna Anda.

Mendaftarkan cluster admin

gcloud CLI

  1. Buat daftar keanggotaan fleet cluster terdaftar:

    gcloud container fleet memberships list \
    --project=PROJECT_ID

    Ganti PROJECT_ID dengan project ID project host fleet Anda.

    Perhatikan region tempat cluster admin menjadi anggota karena Anda akan memerlukannya pada langkah berikutnya.

  2. Daftarkan cluster admin di GKE On-Prem API:

    gcloud container vmware admin-clusters enroll ADMIN_CLUSTER_NAME \
    --project=PROJECT_ID \
    --admin-cluster-membership=projects/PROJECT_ID/locations/MEMBERSHIP_REGION/memberships/ADMIN_CLUSTER_NAME \
    --location=REGION

Ganti kode berikut:

  • ADMIN_CLUSTER_NAME: nama cluster admin yang ingin Anda daftarkan.

  • PROJECT_ID project ID project host fleet Anda.

  • MEMBERSHIP_REGION: region tempat cluster admin menjadi anggota. Nilainya dapat berupa global atau a Google Cloud region.

    ADMIN_CLUSTER_NAME, MEMBERSHIP_REGION, dan PROJECT_ID membentuk nama cluster yang sepenuhnya ditentukan untuk flag --admin-cluster-membership.

  • REGION: the Google Cloud region tempat GKE On-Prem API berjalan dan menyimpan metadata cluster. Tentukan us-west1 atau region lain yang didukung. Sebaiknya gunakan region yang sama yang dikonfigurasi di stackdriver.clusterLocation dalam file konfigurasi cluster admin. Region tidak dapat diubah setelah cluster didaftarkan.

gkectl

Lakukan langkah-langkah berikut di workstation admin Anda.

  1. Tambahkan bagian berikut ke file konfigurasi cluster admin:

    gkeOnPremAPI:
  enabled:true
  location:REGION

    Ganti REGION dengan the Google Cloud region di mana GKE On-Prem API berjalan dan menyimpan metadata cluster. Tentukan us-west1 atau region lain yang didukung. Sebaiknya gunakan region yang sama yang dikonfigurasi di stackdriver.clusterLocation. Region tidak dapat diubah setelah cluster didaftarkan.

  2. Update cluster:

    gkectl update admin --kubeconfig ADMIN_CLUSTER_KUBECONFIG --config ADMIN_CLUSTER_CONFIG_FILE

    Ganti kode berikut:

    • ADMIN_CLUSTER_KUBECONFIG: jalur file kubeconfig cluster admin.

    • ADMIN_CLUSTER_CONFIG_FILE: jalur file konfigurasi cluster admin Anda.

Mendapatkan informasi tentang cluster Anda

Setelah cluster didaftarkan, Anda dapat menggunakan perintah berikut untuk mendapatkan informasi tentang cluster Anda:

Cluster pengguna

  • Untuk mendeskripsikan cluster pengguna:
gcloud container vmware clusters describe USER_CLUSTER_NAME \
  --project=PROJECT_ID \
  --location=REGION
  • Untuk membuat daftar cluster pengguna Anda:
gcloud container vmware clusters list \
  --project=PROJECT_ID \
  --location=-

Jika Anda menetapkan --location=-, artinya membuat daftar semua cluster di semua region. Jika Anda perlu mempersempit daftar, tetapkan --location ke region yang Anda tentukan saat mendaftarkan cluster.

Cluster admin

  • Untuk mendeskripsikan cluster admin:
gcloud container vmware admin-clusters describe ADMIN_CLUSTER_NAME \
  --project=PROJECT_ID \
  --location=REGION
  • Untuk membuat daftar cluster admin Anda:
gcloud container vmware admin-clusters list \
  --project=PROJECT_ID \
  --location=-

Jika Anda menetapkan --location=-, artinya membuat daftar semua cluster di semua region. Jika Anda perlu mempersempit daftar, tetapkan --location ke region yang Anda tentukan saat mendaftarkan cluster.

Menghubungkan ke cluster

Setelah cluster didaftarkan dengan GKE On-Prem API, Anda harus memilih dan mengonfigurasi metode autentikasi agar dapat mengelola cluster dari Google Cloud konsol. Metode autentikasi yang Anda pilih juga mengontrol akses ke cluster dari command line. Untuk mengetahui informasi selengkapnya, lihat referensi berikut: