Menyiapkan tim untuk armada Anda

gcloud

Membuat cakupan tim

Untuk membuat cakupan tim baru di armada, jalankan perintah berikut, dengan SCOPE_NAME adalah nama identifikasi unik yang telah Anda pilih untuk cakupan baru:

gcloud container fleet scopes create SCOPE_NAME

Menambahkan cluster ke cakupan tim

Hanya anggota fleet yang sudah ada yang dapat ditambahkan ke cakupan tim. Petunjuk ini mengasumsikan bahwa cluster yang ingin Anda tambahkan ke cakupan sudah menjadi anggota fleet. Jika Anda perlu menambahkan cluster ke fleet, ikuti petunjuk untuk jenis cluster Anda di Membuat fleet untuk mendaftarkan cluster. Pastikan cluster yang baru didaftarkan dikonfigurasi untuk menggunakan Google Grup untuk kontrol akses, seperti yang dijelaskan sebelumnya.

Cluster anggota fleet dapat ditambahkan ke sejumlah cakupan tim dalam project host fleet-nya.

Untuk menambahkan cluster ke cakupan tim, jalankan perintah berikut:

gcloud container fleet memberships bindings create BINDING_NAME \
  --membership MEMBERSHIP_NAME \
  --scope  SCOPE_NAME \
  --location MEMBERSHIP_LOCATION

Ganti kode berikut:

• BINDING_NAME: nama yang merepresentasikan hubungan antara cluster dan cakupan tim. Sebaiknya gunakan MEMBERSHIP_NAME-SCOPE_NAME.
• MEMBERSHIP_NAME: ID unik cluster dalam fleet (biasanya nama cluster).
• (opsional) MEMBERSHIP_LOCATION: lokasi keanggotaan cluster. Jika Anda menghilangkannya, nilainya adalah global, yang merupakan nilai default untuk pendaftaran cluster.

Membuat namespace fleet

Untuk membuat namespace dalam cakupan tim, jalankan perintah berikut:

gcloud container fleet scopes namespaces create NAMESPACE_NAME --scope=SCOPE_NAME

Ganti kode berikut:

• NAMESPACE_NAME: nama unik yang telah Anda pilih untuk namespace dalam fleet. Pastikan NAMESPACE_NAME tidak bertentangan dengan batasan penamaan namespace fleet.
• SCOPE_NAME: cakupan tim tempat Anda ingin menggunakan namespace.

Perintah ini akan membuat namespace Kubernetes bernama NAMESPACE_NAME di setiap cluster dalam cakupan tim. Anggota tim dapat menggunakan NAMESPACE_NAME seperti namespace Kubernetes lainnya setelah Anda memberi mereka akses ke cakupannya. Jika Anda sudah memiliki namespace Kubernetes bernama NAMESPACE_NAME dalam cakupan tim, namespace tersebut dianggap sebagai bagian dari namespace fleet baru. Tindakan ini terkadang disebut sebagai mengaktifkan namespace.

Memberi anggota tim akses ke cakupan tim

gcloud beta container fleet scopes add-app-operator-binding SCOPE_ID
        --role=ROLE --group=TEAM_EMAIL --project PROJECT_ID

gcloud beta container fleet scopes add-app-operator-binding SCOPE_ID
        --role=ROLE --user=USER_EMAIL --project PROJECT_ID

gcloud container fleet rbacrolebindingactuation update --allowed-custom-roles CUSTOM_ROLE --project PROJECT_ID

gcloud beta container fleet scopes add-app-operator-binding SCOPE_ID
        --custom-role=CUSTOM_ROLE --group=TEAM_EMAIL --project PROJECT_ID

gcloud beta container fleet scopes add-app-operator-binding SCOPE_ID
        --custom-role=CUSTOM_ROLE --user=USER_EMAIL --project PROJECT_ID

Konsol

Membuat cakupan tim

1. Setelah project host armada Anda dipilih, buka bagian Teams di konsol Google Cloud .

   Buka Tim

2. Di bagian atas halaman, klik Buat Cakupan Tim.

3. Di halaman Dasar-Dasar Tim, untuk Nama, masukkan nama unik untuk cakupan tim Anda. Anda tidak akan dapat mengubah nama ini setelah cakupan tim dibuat.

4. Untuk menambahkan anggota tim ke cakupan, klik Tambahkan Anggota Tim.

   • Untuk Jenis, pilih Pengguna untuk menambahkan anggota tim satu per satu, atau Grup untuk menambahkan Grup Google (direkomendasikan).
   • Untuk Pengguna atau Grup, ketik alamat email anggota tim atau grup.
   • Untuk Peran, pilih Admin Cakupan, Editor Cakupan, atau Pelihat Cakupan, yang mengonfigurasi beberapa binding IAM dan RBAC pada cakupan dan fleet, seperti yang dijelaskan dalam Memilih izin akses tim.

5. Untuk membuat cakupan tim tanpa menambahkan cluster dan namespace pada tahap ini, klik Buat Cakupan Tim. Jika tidak, lanjutkan ke bagian berikut untuk menambahkan cluster ke cakupan.

Menambahkan cluster ke cakupan tim

Untuk mengaitkan cluster dengan cakupan tim, cluster harus berupa anggota fleet yang sudah ada. Jika Anda perlu menambahkan cluster ke fleet, ikuti petunjuk untuk jenis cluster Anda di Membuat fleet untuk mendaftarkan cluster. Pastikan cluster yang baru didaftarkan dikonfigurasi untuk menggunakan Google Grup untuk kontrol akses, seperti yang dijelaskan sebelumnya.

Cluster anggota fleet dapat ditambahkan ke sejumlah cakupan tim dalam project host fleet-nya, sehingga tim yang berbeda dapat menjalankan workload di cluster yang sama.

1. Di halaman Dasar-Dasar Tim, setelah menambahkan anggota tim ke cakupan Anda, klik Lanjutkan.
2. Di halaman Clusters, Anda dapat memilih cluster fleet untuk dikaitkan dengan cakupan tim ini. Di drop-down Cluster, centang cluster yang ingin Anda tambahkan, lalu klik Oke.

Membuat namespace fleet

Anggota tim dapat menggunakan namespace fleet seperti namespace Kubernetes lainnya. Saat Anda membuat namespace fleet, namespace Kubernetes yang sesuai akan dibuat di semua cluster dalam cakupan tim, jika belum ada.

1. Di halaman Cluster, setelah menambahkan cluster ke cakupan tim Anda, klik Lanjutkan.
2. Di halaman Namespaces, klik Add Namespace.
   • Untuk Nama, masukkan nama unik untuk namespace dalam armada, atau nama namespace yang ada jika Anda ingin mengaktifkan namespace tersebut. Pastikan nama tidak bertentangan dengan batasan penamaan namespace armada.
3. Untuk menambahkan lebih banyak namespace armada ke cakupan, ulangi langkah sebelumnya.
4. Untuk membuat cakupan tim, klik Buat Cakupan Tim. Setelah cakupan tim dibuat, Anda dapat melihat dan mengedit cakupan tim jika perlu dengan mengklik namanya di bagian Tim.

Terraform

Bagian ini menunjukkan cara menyiapkan tim baru menggunakan Terraform. Untuk informasi selengkapnya dan contoh lainnya, lihat dokumentasi referensi untuk resource berikut:

• google_gke_hub_scope
• google_gke_hub_membership_binding
• google_gke_hub_namespace
• google_gke_hub_scope_rbac_role_binding
• google_gke_hub_feature_rbacrolebindingactuation

Membuat cakupan tim

Untuk membuat cakupan tim, Anda dapat menggunakan blok berikut dalam konfigurasi Terraform.

  resource "google_gke_hub_scope" "TF_SCOPE_RESOURCE_NAME" {
    scope_id = "SCOPE_NAME"
  }

Ganti kode berikut:

• TF_SCOPE_RESOURCE_NAME: nama yang Anda pilih untuk mengidentifikasi resource Terraform google_gke_hub_scope yang dibuat oleh blok ini secara unik.
• SCOPE_NAME: nama identifikasi unik untuk cakupan tim Anda.

Menambahkan cluster ke cakupan

Hanya anggota fleet yang sudah ada yang dapat ditambahkan ke cakupan tim. Jika Anda perlu menambahkan cluster ke fleet, ikuti petunjuk untuk jenis cluster Anda di Membuat fleet untuk mendaftarkan cluster. Pastikan cluster yang baru didaftarkan dikonfigurasi untuk menggunakan Google Grup untuk kontrol akses, seperti yang dijelaskan sebelumnya.

Untuk menambahkan cluster ke cakupan tim, gunakan blok berikut dalam konfigurasi Anda:

  resource "google_gke_hub_membership_binding" "TF_MEMBERSHIP_BINDING_RESOURCE_NAME" {
    membership_binding_id = "BINDING_NAME"
    scope = SCOPE_NAME
    membership_id = MEMBERSHIP_NAME
    location = "MEMBERSHIP_LOCATION"
  }

Ganti kode berikut:

• TF_MEMBERSHIP_BINDING_RESOURCE_NAME: nama untuk mengidentifikasi resource google_gke_hub_membership_binding yang dibuat oleh blok ini.
• BINDING_NAME: nama yang merepresentasikan hubungan antara cluster dan cakupan. Sebaiknya gunakan MEMBERSHIP_NAME-SCOPE_NAME.
• SCOPE_NAME: nama cakupan tim Anda.
• MEMBERSHIP_NAME: ID unik cluster dalam fleet (biasanya nama cluster).
• MEMBERSHIP_LOCATION: lokasi keanggotaan cluster.

Membuat namespace fleet

Anggota tim dapat menggunakan namespace fleet seperti namespace Kubernetes lainnya. Anda dapat membuat namespace baru, atau mengaktifkan namespace yang sudah ada. Saat Anda membuat namespace fleet, namespace Kubernetes yang sesuai akan dibuat di semua cluster dalam cakupan tim, jika belum ada.

Untuk membuat namespace fleet, gunakan blok berikut dalam konfigurasi Anda:

  resource "google_gke_hub_namespace" "TF_NAMESPACE_RESOURCE_NAME" {
    scope_namespace_id = "NAMESPACE_NAME"
    scope_id = SCOPE_NAME
    scope = SCOPE_NAME
  }

Ganti kode berikut:

• TF_NAMESPACE_RESOURCE_NAME: nama untuk mengidentifikasi resource google_gke_hub_namespace yang dibuat oleh blok ini.
• NAMESPACE_NAME: nama unik yang telah Anda pilih untuk namespace fleet. Pastikan nama ini tidak bertentangan dengan batasan penamaan namespace fleet.
• SCOPE_NAME: nama cakupan tim tempat namespace fleet dibuat.

Memberikan akses cakupan

module "TF_SCOPE_RESOURCE_NAME_USER_EMAIL" {
  source           = "terraform-google-modules/kubernetes-engine/google//modules/fleet-app-operator-binding"

  scope_id = "SCOPE_NAME"
  user = "USER_EMAIL"
  role = "ROLE"
}

resource "google_gke_hub_feature" "rbacrolebindingactuation" {
  name = "rbacrolebindingactuation"
  location = "global"
  spec {
    rbacrolebindingactuation {
      allowed_custom_roles = ["CUSTOM_ROLE"]
    }
  }
}

resource "google_gke_hub_scope_rbac_role_binding" "BINDING_NAME" {
  scope_id = "SCOPE_NAME"
  user = "USER_EMAIL"
  role {
    custom_role = "CUSTOM_ROLE"
  }
  depends_on = [google_gke_hub_feature.rbacrolebindingactuation]
}

gcloud

Mencantumkan cakupan tim

Untuk mencantumkan semua cakupan dalam armada, jalankan perintah berikut:

gcloud container fleet scopes list

Untuk mencantumkan semua cakupan yang terkait dengan cluster, jalankan perintah berikut:

gcloud container fleet memberships bindings list --membership MEMBERSHIP_NAME

Menghapus cluster dari cakupan tim

Untuk menghapus cluster dari cakupan, jalankan perintah berikut:

gcloud container fleet memberships bindings delete BINDING_NAME --membership MEMBERSHIP_NAME

Menghapus cakupan tim

Untuk menghapus cakupan dari armada Anda, jalankan perintah berikut:

gcloud container fleet scopes delete SCOPE_NAME

Konsol

Mencantumkan cakupan tim

Untuk melihat semua cakupan dalam fleet, dengan project host fleet yang dipilih, buka bagian Teams di konsol Google Cloud .

Buka Tim

Halaman Teams menampilkan daftar semua cakupan tim yang dibuat untuk fleet Anda. Untuk setiap cakupan, Anda dapat melihat ringkasan pemanfaatan resource selama jangka waktu yang ditentukan, serta perkiraan biaya bulanan, jumlah error, dan jumlah mulai ulang penampung.

Anda dapat melihat metrik pemanfaatan terkait biaya yang lebih mendetail dengan mengklik Pengoptimalan Biaya.

Melihat detail cakupan tim

Untuk setiap cakupan tim, Anda dapat melihat detail termasuk label yang terkait dengan cakupan tersebut, anggota tim, dan log cakupan tim.

1. Di halaman Tim, klik cakupan tim yang detailnya ingin Anda lihat.
2. Di tab Tim, Anda dapat melihat label cakupan, jika ada, dan melihat anggota tim.
3. Klik tab Monitoring untuk melihat metrik pemanfaatan resource untuk tim.
4. Klik tab Cluster untuk melihat cluster cakupan tim.
5. Klik tab Namespaces untuk melihat namespace armada dalam cakupan tim ini.
6. Klik tab Logs untuk melihat log cakupan tim.

Menambahkan atau menghapus cluster dalam cakupan tim

Untuk menambahkan atau menghapus cluster dalam cakupan tim yang ada:

1. Buka halaman Teams di konsol Google Cloud :

   Buka Tim

2. Pilih cakupan tim tempat Anda ingin menambahkan atau menghapus cluster. Tab Cluster menampilkan daftar cluster yang saat ini terikat ke cakupan.

Untuk menambahkan cluster ke cakupan tim:

1. Di bagian atas halaman, klik Tambahkan Kelompok.
2. Di drop-down Clusters, pilih cluster yang ingin Anda tambahkan ke cakupan, lalu klik OK.
3. Klik Perbarui Cakupan Tim.

Untuk menghapus cluster dari cakupan tim:

1. Pilih tab Clusters yang menampilkan daftar cluster yang saat ini terikat ke cakupan.
2. Klik ikon Sampah di samping kelompok yang ingin Anda hapus, lalu klik Hapus untuk mengonfirmasi penghapusan.

Menghapus cakupan

1. Buka halaman Teams di konsol Google Cloud :

   Buka Tim

2. Pilih cakupan tim yang ingin Anda hapus.

3. Untuk menghapus cakupan, di bagian atas halaman, klik Hapus.

4. Konfirmasi penghapusan dengan memasukkan nama cakupan Anda, lalu klik Hapus lagi.

gcloud

Gunakan perintah berikut untuk mengelola namespace dalam cakupan tim.

Mencantumkan namespace fleet

Untuk mencantumkan semua namespace yang dibuat menggunakan fleet scopes namespaces create dalam cakupan, jalankan perintah berikut:

gcloud container fleet scopes namespaces list --scope=SCOPE_NAME

Menghapus namespace fleet

Untuk menghapus namespace armada, jalankan perintah berikut:

gcloud container fleet scopes namespaces delete NAMESPACE_NAME --scope=SCOPE_NAME

Perhatikan bahwa hal yang terjadi saat Anda menghapus namespace armada bergantung pada cara Anda menambahkan namespace:

• Jika Anda membuat namespace fleet baru: Perintah ini akan menghapus namespace fleet. Hal ini juga menghapus semua namespace Kubernetes yang dibuat sebagai hasil dari pembuatan namespace fleet, beserta workload-nya.
• Jika Anda mengaktifkan namespace Kubernetes yang ada: Perintah ini akan menghapus namespace armada. Namespace asli yang Anda aktifkan tidak dihapus.

Konsol

Untuk mengelola namespace fleet dalam cakupan tim Anda:

1. Buka halaman Teams di konsol Google Cloud :

   Buka Tim

2. Pilih cakupan tim yang namespace armada ingin Anda kelola.

Mencantumkan namespace fleet

Di cakupan tim, pilih tab Namespace yang menampilkan daftar namespace yang dibuat dalam cakupan ini.

Melihat detail namespace

Untuk setiap namespace armada, Anda dapat melihat label yang terkait dengan namespace tersebut, serta workload dan log yang difilter menurut namespace.

1. Pilih tab Namespaces yang menampilkan daftar namespace armada yang dibuat dalam cakupan tim.
2. Klik namespace armada yang detailnya ingin Anda lihat.
3. Di tab Detail, Anda dapat melihat namespace armada dan label cakupan.
   • Untuk melihat beban kerja untuk namespace ini, klik Lihat Beban Kerja.
   • Di halaman Workloads, Anda dapat melihat workload yang sudah difilter berdasarkan namespace dan cluster yang terkait dengan cakupan tim untuk namespace tersebut.
4. Di tab Logs, Anda dapat melihat log cakupan armada menurut namespace.

Menambahkan namespace fleet ke cakupan tim

1. Untuk menambahkan namespace fleet baru, di bagian atas halaman, klik Tambahkan Namespace.
2. Masukkan nama namespace fleet baru, pastikan nama tersebut tidak bertentangan dengan batasan penamaan namespace fleet. Untuk menambahkan namespace lainnya, klik Tambahkan Namespace.
3. Klik Perbarui Cakupan Tim.

Menghapus namespace fleet

1. Pilih tab Namespaces yang menampilkan daftar namespace fleet yang dibuat dalam cakupan tim.
2. Klik ikon Sampah di samping namespace yang ingin Anda hapus.
3. Konfirmasi penghapusan dengan memasukkan nama namespace Anda, lalu klik Hapus lagi.

Perhatikan bahwa apa yang terjadi saat Anda melakukan tindakan ini bergantung pada cara Anda menambahkan namespace:

• Jika Anda membuat namespace fleet baru: Namespace fleet akan dihapus. Namespace Kubernetes yang dibuat sebagai hasil dari pembuatan namespace fleet juga akan dihapus, bersama dengan workload-nya.
• Jika Anda mengaktifkan namespace Kubernetes yang ada: Namespace fleet akan dihapus. Namun, namespace asli yang Anda aktifkan tidak dihapus.

Memperbarui nama namespace armada

Anda tidak dapat mengedit namespace armada setelah dibuat. Jika Anda perlu memperbarui nama namespace armada, hapus namespace, lalu buat yang baru dalam cakupan tim.

gcloud

Mencantumkan anggota tim

Untuk mencantumkan semua anggota tim yang diberi akses ke cakupan tim dengan perintah add-app-operator-binding, beserta persona izin mereka, gunakan perintah berikut:

gcloud beta container fleet scopes list-app-operator-bindings SCOPE_NAME

Ganti kode berikut:

• SCOPE_NAME: ID unik cakupan tim.

Menghapus anggota tim

Untuk menghapus akses cakupan anggota tim (diberikan dengan add-app-operator-binding), gunakan perintah berikut:

gcloud beta container fleet scopes remove-app-operator-binding SCOPE_NAME \
   --group=TEAM_EMAIL

atau

gcloud beta container fleet scopes remove-app-operator-binding SCOPE_NAME \
   --user=USER_EMAIL

Ganti kode berikut:

• SCOPE_NAME: ID unik cakupan tim.
• TEAM_EMAIL atau USER_EMAIL: alamat email grup atau pengguna yang ingin Anda hapus dari tim.

Jika anggota tim diberi akses dengan perintah rbacrolebindings create, gunakan perintah rbacrolebindings delete untuk menghapus anggota tim.

Memperbarui akses cakupan tim

Untuk memperbarui akses cakupan tim (misalnya, untuk memberikan peran yang berbeda kepada anggota tim, atau untuk memperbarui alamat email grup), hapus anggota tim dari cakupan seperti yang dijelaskan di bagian sebelumnya, lalu berikan akses lagi kepada mereka dengan detail baru.

Jika anggota tim diberi akses dengan perintah rbacrolebindings create, Anda dapat menggunakan perintah rbacrolebindings update sebagai gantinya untuk memperbarui akses anggota.

Konsol

Menambahkan atau menghapus anggota tim

Untuk mengelola anggota tim dalam cakupan tim:

1. Buka halaman Teams di konsol Google Cloud :

   Buka Tim

2. Pilih cakupan tim yang anggotanya ingin Anda kelola.

Untuk menambahkan anggota tim baru ke cakupan:

1. Di bagian atas halaman, klik Tambahkan Anggota Tim. Ikuti petunjuk seperti yang dijelaskan di bagian Membuat cakupan tim.
2. Klik Perbarui Cakupan Tim.

Untuk menghapus anggota tim dari cakupan:

1. Di tab Tim, klik ikon Sampah di samping anggota tim yang ingin Anda hapus dari cakupan tim.
2. Klik Delete untuk mengonfirmasi penghapusan.

Anda tidak dapat mengedit detail anggota tim di konsol Google Cloud . Untuk memperbarui akses cakupan di konsol Google Cloud (misalnya, untuk memberikan peran yang berbeda kepada anggota tim, atau untuk memperbarui alamat email grup), hapus anggota tim dari cakupan, lalu tambahkan lagi dengan detail baru.