Cluster GKE dengan Cloud TPU menggunakan VPC Bersama

Peringatan: Konten dalam dokumen ini hanya berlaku untuk TPU yang menggunakan arsitektur Node TPU. Arsitektur TPU Node hanya didukung di GKE pada TPU v2 dan v3. Jika Anda menggunakan arsitektur VM TPU, baca artikel Menjalankan aplikasi TPU di Google Kubernetes Engine (GKE).

Panduan ini menjelaskan cara:

• Siapkan cluster GKE Cloud TPU menggunakan jaringan VPC Bersama.
• Siapkan API dan rentang IP yang diperlukan untuk memastikan komunikasi antara cluster, VPC Bersama, dan Layanan Terkelola Google.
• Buat rentang CIDR sekunder untuk pod dan layanan cluster.

Konsep

Konsep-konsep ini akan sering digunakan di sepanjang panduan ini:

• Project Host: Project yang berisi satu atau beberapa jaringan VPC Bersama. Dalam panduan ini, project ini akan berisi VPC Bersama Anda.

• Project Layanan: Project yang dilampirkan ke Project Host oleh administrator VPC Bersama. Dengan lampiran ini, Anda dapat berpartisipasi di VPC Bersama. Dalam panduan ini, project ini akan berisi cluster Cloud TPU Anda.

Persyaratan

Catatan: Cluster Anda harus menggunakan GKE versi 1.11.3-gke.18 atau yang lebih baru.

Mengaktifkan API

1. Aktifkan API berikut di Google Cloud Console untuk Project Host Anda:

   • Service Networking API

2. Aktifkan API berikut di Google Cloud Console untuk Service Project Anda:

   • Service Networking API
   • API Cloud TPU

Menyiapkan rentang IP untuk Peering VPC ke layanan terkelola Google

Catatan: Langkah-langkah ini harus dilakukan oleh administrator jaringan (peran compute.networkAdmin) Project Host.

Ikuti langkah-langkah berikut untuk mencadangkan rentang IP di jaringan VPC Bersama di Project Host. Rentang tersebut akan digunakan oleh semua layanan terkelola Google di jaringan VPC ini. Cloud TPU adalah salah satu layanan terkelola Google.

1. Menampilkan daftar rentang IP yang ada di jaringan VPC Bersama.

   $ gcloud beta compute networks list-ip-addresses network \
   --project=host-project-id

2. Pilih rentang yang tersedia dan cadangkan di jaringan VPC Bersama.

   $ gcloud beta compute addresses create peering-name \
     --global \
     --prefix-length=16 \
     --network=network \
     --purpose=VPC_PEERING \
     --project=host-project-id

   peering-name menentukan nama koneksi Peering VPC. Nama ini akan digunakan pada langkah berikutnya.

3. Buat koneksi Peering Jaringan VPC antara Project Host dan layanan terkelola Google.

   $ gcloud beta services vpc-peerings connect \
     --service=servicenetworking.googleapis.com \
     --network=network \
     --ranges=peering-name \
     --project=host-project-id

Membuat rentang IP sekunder untuk cluster

Catatan: Langkah-langkah ini harus dilakukan oleh admin jaringan (peran compute.networkAdmin) Project Host.

Di jaringan VPC Bersama, pilih atau buat subnetwork dan tambahkan dua rentang CIDR sekunder untuk pod dan layanan cluster.

• Membuat subnet VPC dengan rentang CIDR sekunder

• Menambahkan rentang CIDR sekunder ke subnet VPC yang ada

Rentang ini ditujukan untuk pod dan layanan cluster Anda. Nama rentang akan digunakan dalam langkah-langkah berikut.

• subnet akan menjadi subjaringan di network Project Host Anda.

• tier-1-name akan menjadi nama rentang sekunder yang digunakan oleh Pod GKE di subnet.

• tier-2-name akan menjadi nama rentang sekunder yang digunakan oleh Layanan GKE di subnet.

Membuat cluster GKE dengan Cloud TPU

Perintah berikut menunjukkan cara membuat GKE menggunakan rentang CIDR yang ada di jaringan VPC Bersama Anda, sehingga mengaktifkan Cloud TPU:

$ gcloud beta container clusters create cluster-name \
  --enable-ip-alias \
  --network projects/host-project-id/global/networks/network \
  --subnetwork projects/host-project-id/regions/region/subnetworks/subnet \
  --cluster-secondary-range-name tier-1-name \
  --services-secondary-range-name tier-2-name \
  --scopes=cloud-platform \
  --enable-tpu \
  --enable-tpu-service-networking \
  --project=service-project-id

• Lihat panduan referensi perintah gcloud beta container clusters create untuk mengetahui detail lebih lanjut tentang flag ini.

Ikuti langkah-langkah Spesifikasi Pod dalam panduan Menjalankan aplikasi Cloud TPU di GKE untuk mem-build tugas yang menggunakan resource Cloud TPU.

Pembersihan

Setelah menyelesaikan Cloud TPU di GKE, bersihkan resource agar tidak menimbulkan biaya tambahan pada akun Penagihan Cloud Anda.

1. Menghapus rentang IP peering yang dicadangkan.

   $ gcloud beta compute addresses delete peering-name \
     --global \
     --project=host-project-id

2. Ikuti petunjuk tentang Pembersihan tentang Menyiapkan Cluster dengan VPC Bersama untuk menghapus cluster dan resource jaringan.