Men-deploy image container

Halaman ini menjelaskan cara men-deploy layanan baru dan revisi baru ke penayangan Knative.

Sebelum memulai

Untuk menggunakan Google Cloud CLI, Anda harus terlebih dahulu menyiapkan dan mengonfigurasi alat command line.

Menghubungkan ke cluster GKE

Sebelum dapat men-deploy layanan ke penayangan Knative, Anda harus login untuk menghubungkan ke cluster GKE.

Untuk mengetahui informasi selengkapnya tentang cara terhubung ke cluster GKE, termasuk opsi tambahan, lihat:

• Login dari konsol Google Cloud.
• Login dari command line.

Izin yang diperlukan untuk men-deploy

Anda memerlukan izin untuk membuat, memperbarui, dan menghapus di apiGroup serving.knative.dev dan jenis Service, dan selain itu, Anda harus memiliki SATU dari peran Identity and Access Management berikut:

• Pemilik
• Editor
• Kubernetes Engine Admin
• Kubernetes Engine Developer

Image yang dapat Anda deploy

Tidak ada batas ukuran yang berlaku untuk image container yang dapat Anda deploy.

Anda dapat menggunakan container dari registry container mana pun, seperti Docker Hub. Untuk informasi tentang cara men-deploy image pribadi dari registry yang berbeda dengan Container Registry atau Artifact Registry, lihat Men-deploy image container pribadi dari registry container lainnya.

Perhatian: Container Registry tidak digunakan lagi dan dijadwalkan untuk dihentikan. Organisasi yang belum menggunakan Container Registry sebelum 8 Januari 2024 memiliki repositori gcr.io baru yang dihosting di Artifact Registry secara default. Mulai 15 Mei 2024, project Google Cloud yang sebelumnya tidak menggunakan Container Registry hanya akan mendukung hosting dan pengelolaan image untuk domain gcr.io di Artifact Registry.

Container Registry dijadwalkan untuk dihentikan pada 18 Maret 2025. Untuk mengetahui detail penghentian penggunaan ini, lihat Penghentian penggunaan Container Registry.

Men-deploy layanan baru

Anda dapat menentukan image penampung dengan tag (misalnya, gcr.io/my-project/my-image:latest) atau dengan ringkasan yang tepat (misalnya, gcr.io/my-project/my-image@sha256:41f34ab970ee...).

Revisi pertama akan dibuat saat Anda men-deploy ke layanan untuk pertama kalinya. Perlu diperhatikan bahwa revisi tidak dapat diubah. Jika Anda men-deploy dari tag image container, tag tersebut akan di-resolve menjadi ringkasan dan revisi akan selalu menyalurkan ringkasan khusus ini.

Anda dapat men-deploy penampung menggunakan konsol Google Cloud, Google Cloud CLI, atau dari file konfigurasi YAML.

Klik tab untuk mendapatkan petunjuk cara menggunakan alat pilihan Anda.

Konfigurasi lokasi gcloud default

Jika sebelumnya Anda mengonfigurasi lokasi di konfigurasi default Google Cloud CLI, perintah gcloud akan menggunakan nilai tersebut secara default, termasuk:

• compute/region
• compute/zone
• run/cluster
• run/cluster_location
• run/platform
• run/region

Jalankan perintah gcloud config berikut untuk melihat setelan Anda untuk konfigurasi default:

gcloud config configurations describe default

Oke

Konsol

Untuk men-deploy image container:

1. Buka penayangan Knative di konsol Google Cloud:

   Buka Inferensi Knative

2. Klik Buat layanan untuk menampilkan halaman Buat layanan.

   Di dalam formulir:

   1. Dari menu dropdown, pilih salah satu cluster GKE yang tersedia untuk layanan Anda.

   2. Masukkan nama layanan yang diinginkan. Nama layanan harus unik per region dan project atau per cluster. Nama layanan tidak dapat diubah nanti.

   3. Di bagian Konektivitas:

      • Pilih Internal jika Anda ingin membatasi akses hanya ke layanan atau layanan penayangan Knative lainnya di cluster Anda yang menggunakan Istio.
      • Pilih Eksternal untuk mengizinkan akses eksternal ke layanan Anda

      Perhatikan bahwa Anda dapat mengubah opsi konektivitas kapan saja, seperti yang dijelaskan dalam Mengubah setelan konektivitas layanan.

   4. Klik Berikutnya untuk melanjutkan ke halaman kedua formulir pembuatan layanan.

      Di dalam formulir:

      1. Di kotak teks Container image URL, berikan URL gambar dari registry yang didukung, misalnya: us-docker.pkg.dev/cloudrun/container/hello:latest

      2. Secara opsional, klik Tampilkan Setelan Lanjutan dan tab berikutnya untuk menetapkan:

         • Konfigurasi Container
         • Serentak
         • Waktu tunggu permintaan
         • Alokasi CPU
         • Batas memori
         • Instance maksimum
         • Variabel lingkungan

      3. Klik Create untuk men-deploy image ke layanan Knative dan tunggu deployment selesai.

   Anda baru saja men-deploy layanan ke cluster yang mengaktifkan inferensi Knative.

Command line

Untuk men-deploy image container:

1. Jalankan perintah gcloud run deploy:

   gcloud run deploy SERVICE --image IMAGE_URL

   • Ganti SERVICE dengan nama layanan yang ingin Anda deployment. Jika layanan yang ditentukan tidak ada, layanan baru akan dibuat.

   • Ganti IMAGE_URL dengan referensi ke image container, contohnya, gcr.io/cloudrun/hello.

   • Opsi deployment tambahan:

     • Untuk men-deploy ke namespace selain default, Anda harus menentukan namespace tersebut menggunakan parameter --namespace.

     • Untuk men-deploy ke lokasi selain konfigurasi default, Anda harus menentukan name dan location cluster dengan parameter --cluster dan --cluster-location:

       gcloud run deploy SERVICE --cluster CLUSTER-NAME --cluster-location CLUSTER-LOCATION

     • Anda dapat menetapkan opsi konektivitas dengan tanda --connectivity seperti yang dijelaskan dalam Mengubah setelan konektivitas layanan untuk menentukan akses internal atau eksternal.

     • Untuk penayangan Knative di VMware, Anda harus menyertakan parameter --kubeconfig dan menentukan file konfigurasi:

       gcloud run deploy SERVICE --image IMAGE_URL --kubeconfig KUBECONFIG-FILE

2. Tunggu hingga deployment selesai. Setelah berhasil diselesaikan, pesan berhasil akan ditampilkan beserta URL layanan yang di-deploy.

YAML

Anda dapat menyimpan spesifikasi layanan dalam file YAML, lalu men-deploy-nya menggunakan Google Cloud CLI.

1. Buat file service.yaml baru dengan konten ini:

   apiVersion: serving.knative.dev/v1
   kind: Service
   metadata:
     name: SERVICE
   spec:
     template:
       spec:
         containers:
         - image: IMAGE

   Ganti

   • SERVICE dengan nama layanan penayangan Knative Anda
   • IMAGE dengan URL image container Anda.

   Anda juga dapat menentukan lebih banyak konfigurasi seperti variabel lingkungan atau batas memori.

2. Deploy layanan baru menggunakan perintah berikut:

   gcloud run services replace service.yaml

Men-deploy revisi baru dari layanan yang ada

Anda dapat men-deploy revisi baru menggunakan Google Cloud Console, command line gcloud, atau file konfigurasi YAML.

Perhatikan bahwa mengubah setelan konfigurasi akan menyebabkan pembuatan revisi baru, meskipun tidak ada perubahan pada image container. Setiap revisi yang dibuat tidak dapat diubah.

Klik tab untuk mendapatkan petunjuk cara menggunakan alat pilihan Anda.

Konsol

Untuk men-deploy revisi baru dari layanan yang sudah ada:

1. Buka penayangan Knative di konsol Google Cloud:

   Buka Inferensi Knative

2. Temukan layanan yang ingin Anda update dalam daftar layanan, lalu klik untuk membuka detail layanan tersebut.

3. Klik EDIT & DEPLOY NEW REVISION. Tindakan ini akan menampilkan formulir deployment revisi:

4. Jika diperlukan, berikan URL ke image container baru yang ingin Anda deploy.

5. Secara opsional, tetapkan:

   • Konfigurasi Container
   • Serentak
   • Waktu tunggu permintaan
   • Alokasi CPU
   • Batas memori
   • Instance maksimum
   • Variabel lingkungan

6. Untuk mengirim semua traffic ke revisi baru, centang kotak berlabel Segera sajikan revisi ini. Untuk meluncurkan revisi baru secara bertahap, hapus centang pada kotak tersebut: tindakan ini akan menghasilkan deployment tanpa traffic yang dikirim ke revisi baru. Ikuti petunjuk untuk peluncuran bertahap setelah Anda melakukan deployment.

7. Klik DEPLOY dan tunggu hingga deployment selesai.

Command line

Untuk men-deploy image container:

1. Jalankan perintah gcloud run services update:

   gcloud run services update SERVICE --image IMAGE_URL

   • Akhiran revisi ditetapkan secara otomatis untuk setiap revisi. Jika Anda ingin menentukan akhiran revisi Anda sendiri, tambahkan parameter --revision-suffix.

   • Ganti SERVICE dengan nama layanan yang ingin Anda deployment. Jika layanan yang ditentukan tidak ada, layanan baru akan dibuat.

   • Ganti IMAGE_URL dengan referensi ke image container, contohnya, gcr.io/cloudrun/hello.

   • Opsi deployment tambahan:

     • Untuk men-deploy ke namespace selain default, Anda harus menentukan namespace tersebut menggunakan parameter --namespace.

     • Untuk men-deploy ke lokasi selain konfigurasi default, Anda harus menentukan name dan location cluster dengan parameter --cluster dan --cluster-location:

       gcloud run deploy SERVICE --cluster CLUSTER-NAME --cluster-location CLUSTER-LOCATION

     • Anda dapat menetapkan opsi konektivitas dengan tanda --connectivity seperti yang dijelaskan dalam Mengubah setelan konektivitas layanan untuk menentukan akses internal atau eksternal.

     • Untuk penayangan Knative di VMware, Anda harus menyertakan parameter --kubeconfig dan menentukan file konfigurasi:

       gcloud run deploy SERVICE --image IMAGE_URL --kubeconfig KUBECONFIG-FILE

2. Tunggu hingga deployment selesai. Setelah berhasil diselesaikan, pesan berhasil akan ditampilkan beserta URL layanan yang di-deploy.

YAML

Perhatian: Men-deploy perubahan konfigurasi menggunakan file YAML akan mengganti konfigurasi layanan yang ada. Karena file YAML sepenuhnya menimpa semua konfigurasi, Anda harus menghindari penggunaan beberapa metode untuk mengubah layanan. Misalnya, jangan gunakan file YAML bersama dengan konsol Google Cloud atau perintah gcloud.

Anda dapat mendownload konfigurasi layanan yang ada ke dalam file YAML dengan perintah gcloud run services describe menggunakan tanda --format=export. Kemudian, Anda dapat mengubah file YAML tersebut dan men-deploy perubahan tersebut dengan perintah gcloud run services replace. Anda harus memastikan bahwa Anda hanya mengubah atribut yang ditentukan.

1. Download konfigurasi layanan Anda ke file bernama service.yaml di ruang kerja lokal:

   gcloud run services describe SERVICE --format export > service.yaml

   Ganti SERVICE dengan nama layanan penayangan Knative Anda.

   1. Di file lokal, perbarui setelan revisi di atribut turunan spec.template.

   2. Deploy revisi baru:

      gcloud run services replace service.yaml

Men-deploy image dari project Google Cloud lainnya

Anda dapat men-deploy image container dari project Google Cloud lainnya jika Anda menetapkan izin IAM yang benar:

1. Di konsol Google Cloud, buka project untuk layanan penayangan Knative Anda.

2. Buka halaman IAM

3. Dapatkan info akun layanan Anda:

   • Untuk cluster di Google Cloud, salin email akun layanan default Compute Engine. Akun ini memiliki akhiran @developer.gserviceaccount.com

   • Untuk cluster lain, buat akun layanan Google Cloud dan download kredensial. Tambahkan kredensial ini sebagai imagePullSecrets default Akun Layanan Kubernetes.

4. Buka project yang memiliki container registry yang ingin Anda gunakan.

5. Buka halaman IAM.

6. Klik Add untuk menambahkan akun utama baru.

7. Di kotak teks New principals, tempel alamat email akun layanan yang telah Anda salin sebelumnya.

8. Di menu drop-down Select a role, pilih peran yang akan dibaca dari registry:

   • Artifact Registry, termasuk repositori gcr.io di Artifact Registry: Artifact Registry -> Artifact Registry Reader
   • Container Registry: Storage -> Storage Object Viewer

9. Deploy image container ke project yang berisi layanan penayangan Knative Anda.

Untuk keamanan yang lebih kuat, Anda dapat membatasi akses pemberian:

• Artifact Registry: Berikan peran di repositori yang menyimpan image container Anda.
• Container Registry: Berikan peran di bucket Cloud Storage yang menyimpan image container Anda.

Men-deploy image container pribadi dari registry container lain

Bagian ini menjelaskan cara menyiapkan izin yang benar untuk men-deploy image container dari registry pribadi arbitrer ke penayangan Knative. Container registry pribadi memerlukan kredensial untuk mengakses image container. Perhatikan bahwa Anda tidak perlu mengikuti langkah-langkah ini untuk men-deploy image container pribadi dari Container Registry (Tidak digunakan lagi) atau Artifact Registry di project yang sama dengan cluster Anda.

Agar dapat men-deploy image container pribadi, Anda harus membuat secret Kubernetes jenis imagePullSecret dan mengaitkannya dengan akun layanan:

1. Buat secret imagePullSecret bernama container-registry:

   kubectl create secret docker-registry container-registry \
     --docker-server=DOCKER_REGISTRY_SERVER \
     --docker-email=REGISTRY_EMAIL \
     --docker-username=REGISTRY_USER \
     --docker-password=REGISTRY_PASSWORD

   • Ganti DOCKER_REGISTRY_SERVER dengan FQDN registry pribadi Anda (misalnya: https://gcr.io/ untuk Container Registry atau https://hub.docker.com untuk DockerHub).
   • Ganti REGISTRY_EMAIL dengan email Anda.

   • Ganti REGISTRY_USER dengan nama pengguna registry penampung Anda.

     Jika Anda menggunakan Container Registry atau Artifact Registry dan ingin menyimpan serta mengambil kredensial jangka panjang, bukan meneruskan token akses jangka pendek, lihat Metode autentikasi: File kunci JSON.

   • Ganti REGISTRY_PASSWORD dengan sandi registry penampung Anda.

2. Buka akun layanan default Anda:

   kubectl edit serviceaccount default --namespace default

   Setiap namespace di cluster Kubernetes Anda memiliki akun layanan default yang disebut default. Akun layanan default ini digunakan untuk mengambil image container, kecuali jika ditentukan lain saat Anda deploy layanan penayangan Knative.

3. Tambahkan secret imagePullSecret yang baru dibuat ke akun layanan default Anda:

   imagePullSecrets:
   - name: container-registry
   

   Akun layanan Anda sekarang akan terlihat seperti ini:

   apiVersion: v1
   kind: ServiceAccount
   metadata:
     name: default
     namespace: default
     ...
   secrets:
   - name: default-token-zd84v
   # The secret we just created:
   imagePullSecrets:
   - name: container-registry
   

Sekarang, setiap pod baru yang dibuat di namespace default saat ini akan memiliki secret imagePullSecret yang ditentukan.

Men-deploy dengan injeksi sidecar otomatis diaktifkan

Untuk men-deploy layanan dengan injeksi sidecar Istio yang diaktifkan, lihat injeksi sidecar otomatis diaktifkan dalam dokumentasi Cloud Service Mesh.

Men-deploy layanan di jaringan internal

Untuk men-deploy layanan di jaringan internal, Anda harus menyiapkan jaringan internal pribadi.

Langkah selanjutnya

Setelah men-deploy layanan baru, Anda dapat melakukan hal berikut:

• Peluncuran bertahap, revisi rollback, migrasi traffic
• Melihat log layanan
• Memantau performa layanan
• Konfigurasikan layanan Anda. Misalnya, tetapkan batas memori, tetapkan variabel lingkungan, atau ubah konkurensi.
• Kelola:
  • Layanan
  • Revisi

Anda dapat mengotomatiskan build dan deployment layanan penayangan Knative menggunakan Pemicu Cloud Build:

• Siapkan Deployment Berkelanjutan