Memigrasikan layanan penayangan Knative ke Cloud Run

Gunakan panduan ini untuk memigrasikan workload Anda ke Cloud Run. Secara umum, untuk memigrasikan workload, Anda harus melakukan port-over pada salah satu fitur berbasis Kubernetes, lalu men-deploy ulang setiap layanan yang ada ke Cloud Run.

Manfaat utama migrasi ke Cloud Run:

• Produk serverless terkelola sepenuhnya yang mengimplementasikan spesifikasi Knative Serving API dan mematuhi kontrak penampung.

• Admin API v1 Cloud Run dirancang untuk memaksimalkan portabilitas dengan layanan Knative.

• Pengalaman pengguna serupa di seluruh penayangan Cloud Run dan Knative:

  • Grup perintah gcloud run digunakan di kedua produk tersebut.
  • Tata letak dan perilaku antarmuka pengguna yang serupa di konsol Google Cloud .

Sebelum memulai

Fitur Google Kubernetes Engine berikut tidak didukung di Cloud Run, termasuk:

• Fitur cluster dan pod, misalnya Pemeriksaan Startup, Keaktifan, dan Kesiapan, serta Penemuan Layanan.
• Konfigurasi:
  • ConfigMaps - Anda dapat mengubah ConfigMap menjadi secret dengan Secret Manager.
  • GPU NVIDIA

• Kontrol akses:

  • Peran IAM khusus GKE
  • Workload Identity
  • Multi-tenancy cluster

  Anda dapat menggunakan IAM di Cloud Run untuk mendapatkan kontrol yang sama atas akses ke resource Anda. Pertimbangkan juga untuk menggunakan Identitas layanan.

Pertimbangan migrasi

Anda harus meninjau dan memahami perbedaan berikut di seluruh produk untuk memastikan bahwa Anda dapat melakukan port semua dependensi dan persyaratan.

Rahasia

Di Cloud Run, Anda dapat memilih untuk memasang secret sebagai variabel atau volume lingkungan, tetapi secret dengan informasi sensitif harus disimpan di Secret Manager.

Perbedaan penting antara secret di Secret Manager dan secret Kubernetes:

Fitur	Secret Manager secrets	Secret Kubernetes
Karakter yang diizinkan dalam nama	[a-zA-Z0-9_-]{1,255}	[a-z0-9-.]{1,253}
Pembuatan Versi	Secret memiliki versi	Tidak ada dukungan
Payload Rahasia	Single []byte	Peta: <string, string>

Pelajari cara menggunakan Secret Manager untuk membuat secret berversi untuk kunci secret layanan penayangan Knative Anda.

Jaringan

Gunakan informasi berikut untuk membantu Anda melakukan transfer konfigurasi jaringan yang ada ke Cloud Run.

Endpoint Layanan

Kubernetes Endpoints layanan penayangan Knative Anda tidak didukung di Cloud Run. Pelajari lebih lanjut endpoint unik di Cloud Run.

Pemetaan Domain

DomainMapping API Cloud Run kompatibel dengan layanan Knative. Namun, Cloud Run menawarkan pemetaan domain dalam subset lokasi Cloud Run yang tersedia. Alternatif yang direkomendasikan adalah memanfaatkan Global HTTP(S) Load Balancer untuk domain kustom Anda.

Konektivitas VPC

Layanan Cloud Run berada di luar VPC Anda. Untuk berkomunikasi dengan resource dalam VPC, Anda harus menggunakan Konektor Akses VPC Serverless.

Kontrol traffic masuk

Jika layanan penayangan Knative Anda dikonfigurasi untuk jaringan internal pribadi dan menggunakan load balancer internal (ILB), Anda dapat mengonfigurasi layanan Cloud Run ke Ingress = Internal. Mengonfigurasi layanan ke internal akan membatasi akses ke dalam VPC atau layanan Cloud Run lainnya. Pelajari komunikasi layanan ke layanan lebih lanjut.

Memigrasikan layanan

Untuk memigrasikan layanan, Anda harus mengekspor layanan penayangan Knative, mengedit file YAML yang diekspor, lalu men-deploy layanan yang dikonfigurasi ulang ke Cloud Run.

Catatan: Jika Anda mendapatkan dan menggunakan file konfigurasi YAML asli yang awalnya dibuat untuk penayangan Knative, Anda dapat melewati langkah ekspor dan perubahan. Dengan file konfigurasi YAML asli, Anda cukup men-deploynya langsung ke Cloud Run untuk membuat layanan.

1. Ekspor layanan penayangan Knative Anda ke file YAML lokal dengan menjalankan perintah berikut:

   gcloud run services describe SERVICE --format export --namespace NAMESPACE --cluster CLUSTER --platform gke > FILENAME.yaml
   

   Ganti:

   • SERVICE dengan nama layanan penayangan Knative Anda.
   • NAMESPACE dengan namespace tempat layanan Anda berjalan.
   • CLUSTER dengan nama cluster tempat layanan Anda berjalan.
   • FILENAME dengan nama file unik pilihan Anda.

2. Ubah file FILENAME.yaml yang diekspor untuk Cloud Run:

   • Anda harus menelusuri dan mengganti namespace Kubernetes dengan project IDGoogle Cloud . Misalnya, Anda harus mengganti namespace:default dengan namespace:my-unique-id.
   • Anda harus memperbarui semua konfigurasi untuk salah satu fitur yang tidak didukung.

   • Anda harus menghapus salah satu atribut berikut beserta nilainya:

     • metadata.annotations.kubectl.kubernetes.io/last-applied-configuration
     • metadata.managedFields
     • spec.template.spec.containers.readinessProbes
     • spec.template.spec.enableServiceLinks

     Misalnya, Anda mungkin perlu menghapus konfigurasi berikut dari atribut spec: > template: > spec: > containers::

     ...
      readinessProbe:
        successThreshold: 1
        tcpSocket: {}
     ...
     

3. Deploy file .yaml yang diubah ke Cloud Run menggunakan flag --platform managed. Pelajari lebih lanjut cara men-deploy.

   Perhatikan bahwa Anda dapat menggunakan project Google Cloud yang sama untuk Cloud Run.

   gcloud run services replace FILENAME.yaml --platform managed --region REGION
   

   Ganti:

   • FILENAME dengan nama file konfigurasi yang diekspor yang Anda buat.
   • REGION dengan lokasi Cloud Run yang didukung. Misalnya: us-central1

4. Konfigurasikan akses ke layanan Cloud Run Anda:

   • Secara default, layanan Cloud Run tidak dapat diakses secara eksternal. Untuk mengekspos layanan secara publik ke internet dan mengizinkan permintaan yang tidak diautentikasi, Anda harus mengizinkan akses publik (tidak diautentikasi).

   • Untuk mengonfigurasi layanan ini untuk akses khusus internal pribadi seperti antara layanan Cloud Run Anda, lihat Mengautentikasi layanan-ke-layanan.

5. Di konsol Google Cloud , dalam halaman layanan, Anda dapat mengklik link URL yang ditampilkan untuk membuka endpoint yang unik dan stabil dari layanan yang di-deploy.

   Buka Cloud Run

Memigrasikan traffic ke layanan Anda

Setelah menguji layanan yang baru di-deploy dan siap memigrasikan semua traffic produksi, Anda dapat mengonfigurasi domain kustom dan memperbarui data DNS dengan registrar. Ikuti petunjuk di Memetakan domain kustom.