Mengelola cluster dari konsol Google Cloud

Anda dapat melihat dan mengelola cluster yang dibuat dengan software Google Distributed Cloud khusus untuk VMware langsung di konsol Google Cloud . Setelah Anda menyiapkan autentikasi dan memberikan peran yang diperlukan, pengguna dapat login ke cluster dan melihat workload mereka. Jika pengelolaan siklus proses cluster diaktifkan, Anda juga dapat mengupgrade, mengupdate, dan menghapus cluster pengguna dari konsol.

Anggota fleet dan konsol

Semua cluster Google Distributed Cloud khusus software untuk VMware harus menjadi anggota fleet—cara terpadu untuk melihat dan mengelola beberapa cluster beserta workload-nya. Setiap fleet cluster dikaitkan dengan project host fleet.

Di software Google Distributed Cloud khusus untuk VMware, cluster admin didaftarkan ke fleet pada waktu pembuatan dengan menentukan project host fleet Anda di bagian gkeConnect pada file konfigurasi cluster. Software Google Distributed Cloud khusus untuk VMware menggunakan informasi tersebut untuk mendaftarkan cluster Anda ke project fleet yang ditentukan. Jika pendaftaran gagal, Anda dapat mencoba mendaftar lagi dengan menjalankan gkectl update credentials register.

Perhatikan bahwa saat mencoba kembali pendaftaran, Anda tidak perlu memperbarui kunci akun layanan connect-register. Dengan kata lain, Anda dapat terus menggunakan akun layanan connect-register asli. Untuk mengetahui informasi selengkapnya tentang perintah ini, lihat Merotasi kunci akun layanan.

Di software Google Distributed Cloud khusus untuk VMware, cluster pengguna didaftarkan ke fleet pada waktu pembuatan:

  • Saat membuat cluster pengguna menggunakan gkectl, Anda menentukan project host fleet di bagian gkeConnect pada file konfigurasi cluster. Software Google Distributed Cloud khusus untuk VMware menggunakan informasi tersebut untuk mendaftarkan cluster Anda ke project fleet yang ditentukan.

  • Saat Anda membuat cluster pengguna menggunakan alat standar (konsol, Google Cloud CLI, atau Terraform), cluster tersebut akan otomatis menjadi anggota fleet dalam project yang Anda tentukan.

Anggota fleet di luar Google Cloud seperti software Google Distributed Cloud khusus untuk VMware ditampilkan di konsol dalam project host fleet Anda, bersama dengan cluster fleet lainnya seperti GKE di Google Cloud. Sejauh mana Anda dapat mengelola software Google Distributed Cloud hanya untuk VMware dari konsol bergantung pada hal berikut:

  • Jika telah menyiapkan autentikasi, Anda dapat login ke cluster dan melihat workload serta detail lainnya.

  • Jika telah mengaktifkan pengelolaan siklus proses cluster untuk cluster, Anda juga dapat mengupgrade, mengupdate, atau menghapus cluster pengguna menggunakan konsol. Jika fitur ini tidak diaktifkan, Anda hanya dapat mengelola siklus proses cluster menggunakan gkectl di workstation admin.

Melihat cluster terdaftar

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

Untuk melihat cluster fleet Anda:

  1. Di konsol, buka halaman ringkasan cluster Google Kubernetes Engine.

    Buka cluster GKE

  2. Pilih project Google Cloud .

    • Jika vm Google Distributed Cloud 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.

Untuk melihat detail selengkapnya tentang cluster, pengguna harus login dan melakukan autentikasi ke cluster. Untuk melakukannya, Anda harus:

Menyiapkan autentikasi

Seperti yang dijelaskan sebelumnya, semua cluster fleet muncul dalam daftar cluster GKE di konsol. Namun, untuk melihat detail selengkapnya seperti node dan workload (serta untuk melakukan tugas pengelolaan siklus proses cluster jika fitur ini diaktifkan), pengguna harus login dan melakukan autentikasi ke cluster. Untuk melakukannya, cluster terdaftar Anda harus disiapkan dengan salah satu metode autentikasi berikut:

  • Google Identity: Opsi ini memungkinkan pengguna login menggunakan identitasGoogle Cloud mereka, yang merupakan alamat email yang terkait dengan akunGoogle Cloud Anda. Gunakan opsi ini jika pengguna sudah memiliki akses ke Google Cloud dengan identitas Google mereka. Jika Anda membuat cluster di konsol, Anda dapat login ke cluster menggunakan identitas Google Anda, tetapi Anda harus mengonfigurasi autentikasi untuk pengguna lain.

    Login dengan Google Identity adalah pendekatan paling sederhana untuk autentikasi di konsol, terutama jika Anda mencoba software Google Distributed Cloud only untuk VMware dengan penginstalan minimal, sehingga kami telah menjelaskan cara menyiapkan ini secara lebih mendetail di bawah ini di bagian Menyiapkan autentikasi Google Identity.

  • OpenID Connect (OIDC): Opsi ini memungkinkan pengguna login ke cluster dari konsol menggunakan identitas mereka dari penyedia identitas OIDC pihak ketiga seperti Okta atau Microsoft AD FS. Anda dapat menggunakan opsi ini jika pengguna Anda sudah memiliki nama pengguna, sandi, dan keanggotaan grup keamanan dari penyedia Anda. Anda dapat mengetahui cara menyiapkan autentikasi OIDC pihak ketiga untuk cluster Anda dalam panduan berikut:

  • Token pemilik: Jika solusi yang disediakan Google sebelumnya tidak sesuai untuk organisasi Anda, Anda dapat menyiapkan autentikasi menggunakan akun layanan Kubernetes dan menggunakan token pemiliknya untuk login. Untuk mengetahui detailnya, lihat Menyiapkan menggunakan token pemilik.

Memberikan peran yang diperlukan

Akses ke konsol dikontrol oleh Identity and Access Management (IAM). Peran IAM ini diperlukan, apa pun metode autentikasi yang Anda pilih. Untuk mengelola siklus proses cluster di konsol, Anda harus memberikan beberapa peran IAM.

  • Untuk mengizinkan pengguna mengakses konsol, minimal Anda harus memberikan peran berikut:

    • roles/container.viewer. Peran ini memungkinkan pengguna melihat halaman Cluster GKE dan resource container lainnya di konsol. Untuk mengetahui detail tentang izin yang disertakan dalam peran ini, atau untuk memberikan peran dengan izin baca/tulis, lihat peran Kubernetes Engine dalam dokumentasi IAM.

    • roles/gkehub.viewer. Peran ini memungkinkan pengguna melihat cluster di luarGoogle Cloud di konsol. Untuk mengetahui detail tentang izin yang disertakan dalam peran ini, atau untuk memberikan peran dengan izin baca/tulis, lihat peran GKE Hub dalam dokumentasi IAM.

  • Untuk mengizinkan pengguna mengelola siklus proses cluster di konsol, berikan peran IAM roles/gkeonprem.admin. Peran roles/gkeonprem.admin memberi pengguna akses administratif ke GKE On-Prem API, yang digunakan konsol untuk mengelola siklus proses cluster. Untuk mengetahui detail tentang izin yang disertakan dalam peran ini, lihat Peran GKE on-prem dalam dokumentasi IAM.

Perintah berikut menunjukkan cara memberikan peran minimal yang diperlukan untuk mengelola siklus proses cluster di konsol:

gcloud projects add-iam-policy-binding FLEET_HOST_PROJECT_ID \
    --member=MEMBER \
    --role=roles/container.viewer

gcloud projects add-iam-policy-binding FLEET_HOST_PROJECT_ID \
    --member=MEMBER \
    --role=roles/gkehub.viewer

gcloud projects add-iam-policy-binding FLEET_HOST_PROJECT_ID \
    --member=MEMBER \
    --role=roles/gkeonprem.admin

dengan:

  • FLEET_HOST_PROJECT_ID adalah project host fleet. Untuk cluster yang dibuat menggunakan gkectl, ini adalah project yang Anda konfigurasi di bagian gkeConnect pada file konfigurasi cluster pengguna. Untuk cluster yang dibuat di konsol, ini adalah project yang Anda pilih saat cluster dibuat.

  • MEMBER adalah alamat email pengguna dalam format user:emailID, misalnya: user:alice@example.com

Mengaktifkan pengelolaan siklus proses cluster di konsol

Cluster pengguna yang dibuat menggunakan alat standar (konsol, gcloud CLI, atau Terraform) akan otomatis didaftarkan di GKE On-Prem API, dan memungkinkan Anda melakukan tugas pengelolaan siklus proses cluster di konsol. Jika Anda ingin mengaktifkan fitur ini untuk cluster pengguna yang dibuat menggunakan gkectl, ikuti langkah-langkah di Mengonfigurasi cluster pengguna agar dikelola oleh GKE On-Prem API. Jika pengelolaan siklus proses cluster diaktifkan, Anda dapat melakukan tugas berikut dari konsol:

Menyiapkan autentikasi Google Identity

Agar pengguna dapat login ke cluster menggunakan Google Identity mereka, Anda perlu mengonfigurasi hal berikut:

Mengonfigurasi otorisasi RBAC

Setiap server Kubernetes API cluster harus dapat mengizinkan permintaan yang berasal dari konsol. Untuk mengonfigurasi otorisasi, Anda perlu mengonfigurasi kebijakan role-based access control (RBAC) Kubernetes di setiap cluster.

Jika Anda menggunakan alat standar untuk membuat cluster pengguna, Anda mungkin sudah diberi kebijakan RBAC yang sesuai yang memberi Anda akses administratif penuh ke cluster. GKE On-Prem API menambahkan Akun Google Anda secara otomatis sebagai administrator dalam kasus berikut:

  • Anda telah membuat cluster pengguna di konsol.

  • Anda membuat cluster pengguna menggunakan gcloud CLI, dan Akun Google Anda ditentukan dalam flag --admin-users di perintah pembuatan cluster.

  • Anda membuat cluster pengguna menggunakan Terraform dan Akun Google Anda ditentukan di kolom authorization.admin_users.username.

Cluster pengguna yang dibuat menggunakan gkectl tidak memberi Anda kebijakan RBAC untuk mengelola cluster menggunakan konsol. Anda harus menambahkan diri Anda sendiri setelah cluster dibuat. Apa pun alat yang Anda gunakan untuk membuat cluster, Anda dapat menambahkan orang lain sebagai administrator setelah cluster dibuat.

Anda dapat menggunakan salah satu cara berikut untuk memberikan akses administratif ke cluster. Tersedia dua perintah gcloud yang berbeda.

  • Perintah gcloud ... generate-gateway-rbac harus dijalankan di workstation admin Anda karena perintah tersebut memerlukan akses ke kubeconfig dan konteks cluster (yang biasanya hanya ada di workstation admin Anda). Perintah generate-gateway-rbac memungkinkan Anda menyesuaikan kebijakan RBAC, tetapi alamat email pengguna tidak akan ditampilkan sebagai administrator di bagian Detail Cluster di konsol.

  • Perintah gcloud ... update dapat dijalankan di workstation admin atau komputer mana pun yang memiliki akses ke GKE On-Prem API.

generate-gateway-rbac

  1. Hubungkan ke workstation admin Anda.

  2. Jalankan perintah berikut untuk mengupdate komponen:

    gcloud components update
    
  3. Buat dan terapkan kebijakan RBAC ke cluster Anda untuk pengguna dan akun layanan:

    gcloud container fleet memberships generate-gateway-rbac  \
        --membership=MEMBERSHIP_NAME \
        --role=ROLE \
        --users=USERS \
        --project=FLEET_HOST_PROJECT_ID \
        --kubeconfig=KUBECONFIG_PATH \
        --context=KUBECONFIG_CONTEXT \
        --apply
    

    Ganti kode berikut:

    • MEMBERSHIP_NAME: nama yang digunakan untuk merepresentasikan cluster secara unik dalam fleet-nya. Di software Google Distributed Cloud khusus untuk VMware, nama keanggotaan dan nama cluster sama.
    • ROLE: peran Kubernetes yang ingin Anda berikan kepada pengguna di cluster. Untuk memberi pengguna akses penuh ke setiap resource di cluster di semua namespace, tentukan clusterrole/cluster-admin. Untuk memberikan akses hanya baca, tentukan clusterrole/view. Anda juga dapat membuat peran khusus, misalnya: role/mynamespace/namespace-reader. Peran khusus harus sudah ada sebelum Anda menjalankan perintah.
    • USERS: alamat email pengguna (akun pengguna atau akun layanan) yang ingin Anda beri izin, sebagai daftar yang dipisahkan koma. Contoh: --users=foo@example.com,test-acct@test-project.iam.gserviceaccount.com.
    • FLEET_HOST_PROJECT_ID: project ID dari project host fleet.
    • KUBECONFIG_PATH: jalur lokal tempat kubeconfig Anda yang berisi entri untuk cluster disimpan.
    • KUBECONFIG_CONTEXT: konteks cluster seperti yang muncul di file kubeconfig. Anda bisa mendapatkan konteks saat ini dari command line dengan menjalankan kubectl config current-context. Baik Anda menggunakan konteks saat ini atau tidak, pastikan konteks tersebut berfungsi untuk mengakses cluster dengan menjalankan perintah sederhana seperti:

      kubectl get namespaces \
        --kubeconfig=KUBECONFIG_PATH \
        --context=KUBECONFIG_CONTEXT

    Setelah menjalankan gcloud container fleet memberships generate-gateway-rbac, Anda akan melihat sesuatu seperti berikut di akhir output, 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: /usr/local/google/home/foo/.kube/config, context: kind-kind
    Writing RBAC policy for user: foo@example.com to cluster.
    Successfully applied the RBAC policy to cluster.
    

    Ini adalah konteks untuk mengakses cluster melalui Connect gateway.

    Untuk mengetahui detail selengkapnya tentang perintah generate-gateway-rbac, lihat panduan referensi gcloud CLI.

update

  1. Jalankan perintah berikut untuk mengupdate komponen:

    gcloud components update
    
  2. Untuk setiap pengguna yang perlu diberi peran clusterrole/cluster-admin, sertakan flag --admin-users dan jalankan perintah berikut. Anda tidak dapat menentukan beberapa pengguna dalam satu flag. Pastikan untuk menyertakan Akun Google Anda dalam perintah karena perintah tersebut akan menimpa daftar pemberian dengan pengguna yang Anda tentukan dalam perintah.

    gcloud container vmware clusters update USER_CLUSTER_NAME \
      --admin-users YOUR_GOOGLE_ACCOUNT \
      --admin-users ADMIN_GOOGLE_ACCOUNT_1
    

Selain memberikan peran clusterrole/cluster-admin Kubernetes, perintah ini memberikan kebijakan RBAC yang diperlukan pengguna untuk mengakses cluster melalui Connect gateway.

Konsol

Untuk menerapkan kebijakan RBAC kepada pengguna, lakukan langkah-langkah berikut di konsol:

  1. Di konsol, buka halaman ringkasan cluster Google Kubernetes Engine.

    Buka cluster GKE

  2. Pilih project Google Cloud tempat cluster pengguna berada.

  3. Di daftar cluster, klik nama cluster untuk menampilkan detailnya.

  4. Di bagian Otorisasi, klik tombol edit pengguna admin.

  5. Masukkan alamat email pengguna yang ingin Anda tambahkan sebagai admin cluster di panel Edit authorization. Untuk menambahkan pengguna admin tambahan, klik Tambahkan pengguna admin.

  6. Setelah selesai menambahkan pengguna, klik Simpan perubahan.

Informasi selengkapnya