Membuat cluster untuk menjalankan workload container

Buat cluster pengguna untuk memungkinkan deployment workload container.

Sebelum memulai

Untuk mendapatkan izin yang diperlukan untuk membuat cluster pengguna, minta Admin IAM Organisasi Anda untuk memberi Anda peran Admin Cluster Pengguna (peran user-cluster-admin).

Membuat cluster pengguna

Untuk mendapatkan izin yang diperlukan untuk membuat cluster pengguna, minta Admin IAM Anda untuk memberi Anda peran Admin Cluster Pengguna (peran user-cluster-admin).

Selesaikan langkah-langkah berikut untuk membuat cluster pengguna:

Konsol

  1. Di menu navigasi, pilih Clusters.

  2. Klik Buat kluster.

  3. Di kolom Name, tentukan nama untuk cluster pengguna.

  4. Pilih versi cluster GDC. Setiap versi dipetakan ke versi Kubernetes yang berbeda.

  5. Klik Berikutnya.

  6. Konfigurasi setelan jaringan untuk cluster Anda. Anda tidak dapat mengubah setelan jaringan ini setelah membuat cluster. Protokol Internet default dan satu-satunya yang didukung untuk cluster pengguna adalah Internet Protocol versi 4 (IPv4).

    1. Jika Anda ingin membuat node load balancer khusus, masukkan jumlah node yang akan dibuat. Secara default, Anda menerima nol node, dan traffic load balancer berjalan melalui node kontrol.

    2. Pilih Service CIDR (Classless Inter-Domain Routing) yang akan digunakan. Layanan yang di-deploy, seperti load balancer, dialokasikan alamat IP dari rentang ini.

    3. Pilih CIDR Pod yang akan digunakan. Cluster mengalokasikan alamat IP dari rentang ini ke pod dan VM Anda.

    4. Klik Berikutnya.

  7. Tinjau detail node pool default yang dibuat otomatis untuk cluster pengguna. Klik Edit untuk mengubah node pool default.

  8. Untuk membuat kumpulan node tambahan, pilih Tambahkan kumpulan node. Saat mengedit node pool default atau menambahkan node pool baru, Anda dapat menyesuaikannya dengan opsi berikut:

    1. Tetapkan nama untuk kumpulan node. Anda tidak dapat mengubah nama setelah membuat node pool.
    2. Tentukan jumlah node pekerja yang akan dibuat di node pool.

    3. Pilih kelas mesin yang paling sesuai dengan persyaratan workload Anda. Lihat daftar setelan berikut:

      • Jenis mesin
      • CPU
      • Memori

    4. Klik Simpan.

  9. Klik Buat untuk membuat cluster pengguna.

API

Untuk membuat cluster pengguna baru menggunakan API secara langsung, terapkan resource kustom ke instance GDC Anda:

  1. Buat resource kustom Cluster dan simpan sebagai file YAML, seperti cluster.yaml:

    apiVersion: cluster.gdc.goog/v1
kind: Cluster
metadata:
  name: CLUSTER_NAME
  namespace: platform
spec:
  clusterNetwork:
    podCIDRSize: POD_CIDR
    serviceCIDRSize: SERVICE_CIDR
  initialVersion:
    kubernetesVersion: KUBERNETES_VERSION
  loadBalancer:
    ingressServiceIPSize: LOAD_BALANCER_POOL_SIZE
  nodePools:
  - machineTypeName: MACHINE_TYPE
    name: NODE_POOL_NAME
    nodeCount: NUMBER_OF_WORKER_NODES
    taints: TAINTS
    labels: LABELS
  releaseChannel:
    channel: UNSPECIFIED

    Ganti kode berikut:

    • CLUSTER_NAME: Nama cluster. Nama cluster tidak boleh diakhiri dengan -system. Akhiran -system dicadangkan untuk cluster yang dibuat oleh GDC.
    • POD_CIDR: Ukuran rentang jaringan tempat alamat IP virtual pod dialokasikan. Jika tidak disetel, nilai default 21 akan digunakan.
    • SERVICE_CIDR: Ukuran rentang jaringan tempat alamat IP virtual layanan dialokasikan. Jika tidak disetel, nilai default 23 akan digunakan.
    • KUBERNETES_VERSION: Versi Kubernetes cluster, seperti 1.26.5-gke.2100. Untuk mencantumkan versi Kubernetes yang tersedia untuk dikonfigurasi, lihat Mencantumkan versi Kubernetes yang tersedia untuk cluster.
    • LOAD_BALANCER_POOL_SIZE: Ukuran kumpulan alamat IP yang tidak tumpang-tindih yang digunakan oleh layanan load balancer. Jika tidak disetel, nilai default 20 akan digunakan.
    • MACHINE_TYPE: Jenis mesin untuk node pekerja node pool. Lihat jenis mesin yang tersedia untuk mengetahui konfigurasi yang tersedia.
    • NODE_POOL_NAME: Nama node pool.
    • NUMBER_OF_WORKER_NODES: Jumlah node pekerja yang akan disediakan di node pool.
    • TAINTS: Taint yang akan diterapkan ke node di node pool ini. Kolom ini bersifat opsional.
    • LABELS: Label yang akan diterapkan ke node node pool ini. Objek ini berisi daftar key-value pair. Kolom ini bersifat opsional.

  2. Terapkan resource kustom ke instance GDC Anda:

    kubectl apply -f cluster.yaml --kubeconfig ADMIN_CLUSTER_KUBECONFIG

    Ganti ADMIN_CLUSTER_KUBECONFIG dengan jalur file kubeconfig cluster admin org.

Mencantumkan versi Kubernetes yang tersedia untuk cluster

Anda dapat mencantumkan versi Kubernetes yang tersedia di instance GDC menggunakan CLI kubectl:

kubectl get userclustermetadata.upgrade.private.gdc.goog \
    -o=custom-columns=K8S-VERSION:.spec.kubernetesVersion \
    --kubeconfig ADMIN_CLUSTER_KUBECONFIG

Ganti ADMIN_CLUSTER_KUBECONFIG dengan jalur file kubeconfig cluster admin.

Outputnya terlihat mirip dengan yang berikut ini:

K8S-VERSION
1.25.10-gke.2100
1.26.5-gke.2100
1.27.4-gke.500

Mendukung resource GPU di cluster pengguna

GDC menyediakan dukungan unit pemrosesan grafis (GPU) NVIDIA untuk cluster pengguna, dan menjalankan perangkat GPU Anda sebagai workload pengguna. Dukungan GPU diaktifkan secara default untuk cluster yang telah disediakan mesin GPU-nya. Pastikan cluster pengguna Anda mendukung perangkat GPU sebelum memanfaatkan Deep Learning Containers. Misalnya, jika Anda ingin menjalankan Deep Learning Containers, pastikan Anda membuat cluster pengguna dengan minimal satu node GPU.

Cluster pengguna dapat dibuat menggunakan konsol GDC atau API secara langsung. Pastikan Anda menyediakan mesin GPU untuk cluster pengguna guna mendukung beban kerja GPU pada container terkaitnya. Untuk mengetahui informasi selengkapnya, lihat Membuat cluster pengguna.

Kartu GPU NVIDIA yang didukung

Cluster GDC mendukung GPU NVIDIA A100 PCIe 80 GB. Untuk mengaktifkan dukungan ini, sediakan jenis mesin a2-ultragpu-1g-gdc di cluster pengguna.