Men-deploy ke GKE

Halaman ini menjelaskan cara men-deploy aplikasi ke Kubernetes menggunakan Cloud Build.

Cloud Build menyediakan builder gke-deploy yang memungkinkan Anda men-deploy aplikasi dalam container ke cluster GKE.

gke-deploy adalah wrapper di sekitar kubectl, antarmuka command line untuk Kubernetes. Hal ini menerapkan praktik yang direkomendasikan Google untuk men-deploy aplikasi ke Kubernetes dengan:

• Memperbarui file resource Kubernetes aplikasi untuk menggunakan ringkasan image container, bukan tag.

• Menambahkan label yang direkomendasikan ke file resource Kubernetes.

• Mengambil kredensial untuk cluster GKE tempat Anda men-deploy image.

• Menunggu file resource Kubernetes yang dikirimkan siap.

Jika ingin men-deploy aplikasi menggunakan kubectl secara langsung dan tidak memerlukan fungsi tambahan, Cloud Build juga menyediakan builder kubectl yang dapat Anda gunakan untuk men-deploy aplikasi ke cluster GKE.

Sebelum memulai

• Buat cluster GKE jika Anda belum memilikinya.

• Siapkan aplikasi dalam container Anda dalam bentuk kode sumber dan Dockerfile. Kode sumber Anda harus disimpan di repositori, seperti Cloud Source Repositories, GitHub, atau Bitbucket.

• Anda memerlukan setidaknya satu file resource Kubernetes yang menjelaskan resource Kubernetes yang digunakan untuk menjalankan aplikasi Anda. Jika Anda tidak memiliki file resource Kubernetes, gunakan langkah-langkah berikut untuk membuatnya bagi aplikasi Anda:

  1. Buka halaman cluster Kubernetes Engine di konsol Google Cloud .
  2. Di halaman cluster Kubernetes Engine, klik Deploy.
  3. Pilih penampung Anda, lalu klik Lanjutkan. Anda akan melihat bagian Konfigurasi.
  4. Di bagian Configuration YAML, klik View YAML untuk mendapatkan contoh file resource Kubernetes.
  Catatan: Jika Anda sudah memiliki file resource Kubernetes ber-template dalam bentuk lain seperti chart Helm atau resource dalam format Kustomize, lihat Helm Builder atau Kustomize Builder untuk mengetahui contoh konfigurasi build yang dapat Anda gunakan untuk deployment.

Perhatian: Mulai 17 Juni 2024, Cloud Source Repositories tidak tersedia untuk pelanggan baru. Jika organisasi Anda belum pernah menggunakan Cloud Source Repositories, Anda tidak dapat mengaktifkan API atau menggunakan Cloud Source Repositories. Project baru yang tidak terhubung ke organisasi tidak dapat mengaktifkan Cloud Source Repositories API. Organisasi yang telah menggunakan Cloud Source Repositories sebelum 17 Juni 2024 tidak terpengaruh oleh perubahan ini.

Izin IAM yang diperlukan

Tambahkan peran Google Kubernetes Engine Developer ke akun Anda:

1. Di konsol Google Cloud , buka halaman Izin Cloud Build:

   Buka Izin

2. Tetapkan status peran Developer Kubernetes Engine ke Aktif.

Men-deploy image container bawaan

Untuk men-deploy versi tertentu aplikasi Anda dengan gke-deploy:

1. Pastikan file resource Kubernetes Anda merujuk ke tag atau ringkasan image container yang benar.

2. Tambahkan langkah gke-deploy di file konfigurasi build:

   YAML

   steps:
   ...
   # deploy container image to GKE
   - name: "gcr.io/cloud-builders/gke-deploy"
     args:
     - run
     - --filename=KUBERNETES_RESOURCE_FILE
     - --location=CLUSTER_LOCATION
     - --cluster=CLUSTER
   

   JSON

   {
     "steps": [
       {
         "name": "gcr.io/cloud-builders/gke-deploy",
         "args": [
           "run",
           "--filename=KUBERNETES_RESOURCE_FILE",
           "--location=CLUSTER_LOCATION",
           "--cluster=CLUSTER"
         ]
       }
     ]
   }
   

   Dengan:

   • KUBERNETES_RESOURCE_FILE adalah jalur file resource Kubernetes Anda atau jalur direktori yang berisi file resource Kubernetes Anda.
   • CLUSTER_LOCATION adalah region cluster.
   • CLUSTER adalah nama cluster GKE tempat aplikasi akan di-deploy.

   Untuk mengetahui informasi selengkapnya tentang tanda yang tersedia, lihat tanda gke-deploy run.

   Catatan: Saat men-deploy ke beberapa cluster GKE, Cloud Build mempertahankan direktori beranda di seluruh langkah build, yang berarti konteks kubectl dari langkah sebelumnya akan digunakan oleh langkah berikutnya secara default. Untuk menghindarinya, tambahkan deklarasi variabel lingkungan, KUBECONFIG=/tmp/kubeconfig, ke setiap langkah file konfigurasi build Anda.

3. Mulai build Anda:

   gcloud builds submit --region=LOCATION --project=PROJECT --config BUILD_CONFIG
   

   Dengan:

   • LOCATION adalah salah satu lokasi build yang didukung.
   • PROJECT adalah ID untuk project Anda.
   • BUILD_CONFIG adalah nama file konfigurasi build Anda.

Membangun dan men-deploy image container baru

Untuk membuat image container baru dan men-deploy image container baru:

1. Perbarui file resource Kubernetes Anda dengan image penampung baru menggunakan atribut --image:

   YAML

   steps:
     # build the container image
   - name: "gcr.io/cloud-builders/docker"
     args: ["build", "-t", "LOCATION-docker.pkg.dev/PROJECT/REPOSITORY/IMAGE_NAME:TAG", "."]
     # push container image
   - name: "gcr.io/cloud-builders/docker"
     args: ["push", "LOCATION-docker.pkg.dev/PROJECT/REPOSITORY/IMAGE_NAME:TAG"]
     # deploy container image to GKE
   - name: "gcr.io/cloud-builders/gke-deploy"
     args:
     - run
     - --filename=KUBERNETES_RESOURCE_FILE
     - --image=LOCATION-docker.pkg.dev/PROJECT/REPOSITORY/IMAGE_NAME:TAG
     - --location=CLUSTER_LOCATION
     - --cluster=CLUSTER
   

   JSON

   {
     "steps": [
       {
         "name": "gcr.io/cloud-builders/docker",
         "args": [
           "build",
           "-t",
           "LOCATION-docker.pkg.dev/PROJECT/REPOSITORY/IMAGE_NAME:TAG",
           "."
         ]
       },
       {
         "name": "gcr.io/cloud-builders/docker",
         "args": [
           "push",
           "LOCATION-docker.pkg.dev/PROJECT/REPOSITORY/IMAGE_NAME:TAG"
         ]
       },
       {
         "name": "gcr.io/cloud-builders/gke-deploy",
         "args": [
           "run",
           "--filename=KUBERNETES_RESOURCE_FILE",
           "--image=LOCATION-docker.pkg.dev/PROJECT/REPOSITORY/IMAGE_NAME:TAG",
           "--location=CLUSTER_LOCATION",
           "--cluster=CLUSTER"
         ]
       }
     ]
   }
   

   Dengan:

   • LOCATION adalah salah satu lokasi build yang didukung.
   • PROJECT adalah ID untuk project Anda.
   • IMAGE_NAME adalah nama yang Anda inginkan untuk image penampung, biasanya nama aplikasi.
   • TAG adalah tag image container.
     • Jika Anda membuat image container baru dengan setiap commit, sebaiknya gunakan SHA singkat commit sebagai tag. Cloud Build menyediakan hal ini sebagai penggantian default, $SHORT_SHA.
   • KUBERNETES_RESOURCE_FILE adalah jalur file resource Kubernetes Anda atau jalur direktori yang berisi file resource Kubernetes Anda.
   • CLUSTER adalah nama cluster GKE tempat aplikasi akan di-deploy.
   • CLUSTER_LOCATION adalah region tempat cluster akan di-deploy.
   Catatan: gke-deploy hanya dapat mereferensikan satu gambar dalam file konfigurasi build Anda. Jika file resource Kubernetes Anda berisi beberapa referensi image, hanya image yang diawali dengan LOCATION-docker.pkg.dev/PROJECT/REPOSITORY/IMAGE_NAME:TAG yang akan diupdate untuk mereferensikan tag yang ditentukan.

2. Mulai build Anda:

   gcloud builds submit --region=LOCATION --project=PROJECT --config BUILD_CONFIG
   

   Dengan:

   • LOCATION adalah salah satu wilayah build yang didukung.
   • PROJECT adalah ID untuk project Anda.
   • BUILD_CONFIG adalah nama file konfigurasi build Anda.

Mengotomatiskan deployment

Anda dapat mengotomatiskan deployment aplikasi ke GKE dengan membuat pemicu di Cloud Build. Anda dapat mengonfigurasi pemicu untuk membangun dan men-deploy image setiap kali Anda mengirim perubahan ke kode.

Untuk membuat pemicu build:

1. Buka halaman Pemicu di konsol Google Cloud :

   Buka halaman Pemicu

2. Pilih project Anda dari menu drop-down pemilih project di bagian atas halaman.

3. Klik Buka.

4. Klik Create trigger.

   Di halaman Buat pemicu, masukkan setelan berikut:

   1. Masukkan nama untuk pemicu Anda.

   2. Pilih peristiwa repositori untuk memulai pemicu Anda.

   3. Pilih repositori yang berisi kode sumber dan file konfigurasi build Anda.

   4. Tentukan ekspresi reguler untuk nama cabang atau tag yang akan memulai pemicu Anda.

   5. Pilih Konfigurasi untuk pemicu Anda.

      Jika memilih file konfigurasi Cloud Build, Anda dapat menentukan Variabel penggantian dengan memberikan nama variabel dan nilai yang ingin dikaitkan dengan variabel tersebut. Dalam contoh berikut, variabel penggantian yang ditentukan pengguna _CLOUDSDK_CONTAINER_CLUSTER menentukan cluster yang akan di-deploy, dan variabel penggantian yang ditentukan pengguna _CLOUDSDK_COMPUTE_ZONE menentukan lokasinya. Jika ingin men-deploy ke cluster lain, Anda dapat menggunakan konfigurasi build yang sama dan hanya perlu mengubah nilai variabel penggantian:

      YAML

      steps:
      ...
      # deploy container image to GKE
      - name: "gcr.io/cloud-builders/gke-deploy"
        args:
        - run
        - --filename=KUBERNETES_RESOURCE_FILE
        - --image=LOCATION-docker.pkg.dev/PROJECT/REPOSITORY/IMAGE_NAME:TAG
        - --location=${_CLOUDSDK_COMPUTE_ZONE}
        - --cluster=${_CLOUDSDK_CONTAINER_CLUSTER}
      

      JSON

      {
        "steps": [
          {
            "name": "gcr.io/cloud-builders/gke-deploy",
            "args": [
              "run",
              "--filename=KUBERNETES_RESOURCE_FILE",
              "--image=LOCATION-docker.pkg.dev/PROJECT/REPOSITORY/IMAGE_NAME:TAG",
              "--location=${_CLOUDSDK_COMPUTE_ZONE}",
              "--cluster=${_CLOUDSDK_CONTAINER_CLUSTER}"
            ]
          }
        ]
      }
      

      Dengan:

      • KUBERNETES_RESOURCE_FILE adalah jalur file konfigurasi Kubernetes Anda atau jalur direktori yang berisi file resource Kubernetes Anda.
      • PROJECT adalah ID untuk project Anda.
      • IMAGE_NAME adalah nama yang Anda inginkan untuk image container, biasanya nama aplikasi.
      • TAG adalah tag image container.

      Untuk mempelajari lebih lanjut cara menentukan penggantian untuk file konfigurasi build, lihat Menggunakan penggantian yang ditentukan pengguna.

5. Klik Buat untuk menyimpan pemicu build Anda.

Saat Anda mengirimkan kode ke repositori, Cloud Build akan otomatis memicu build. Untuk mempelajari lebih lanjut pemicu build, lihat Membuat dan mengelola pemicu build.

Langkah berikutnya

• Pelajari cara mengonfigurasi deployment otomatis untuk workload Anda di GKE.
• Pelajari cara membuat pipeline CI/CD bergaya GitOps yang di-deploy ke GKE dengan Cloud Build.
• Pelajari opsi gke-deploy tambahan.
• Pelajari cara melakukan deployment biru-hijau di Compute Engine.
• Pelajari Cloud builder tambahan.
• Pelajari cara memecahkan masalah error build.