Men-deploy ke GKE

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

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

gke-deploy adalah wrapper di sekitar kubectl, antarmuka command line untuk Kubernetes. Layanan ini menerapkan praktik terbaik 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 Anda 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 Google Cloud konsol.
  2. Di halaman cluster Kubernetes Engine, klik Deploy.
  3. Pilih container Anda, lalu klik Continue. Anda akan melihat bagian Konfigurasi.
  4. Di bagian YAML Konfigurasi, klik Lihat YAML untuk mendapatkan contoh file resource Kubernetes.
  Catatan: Jika Anda sudah memiliki bentuk file resource Kubernetes yang menggunakan template seperti chart Helm atau resource dalam format Kustomize, lihat helm builder atau kustomize builder untuk 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 Developer Google Kubernetes Engine ke akun Anda:

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

   Buka Permissions

2. Tetapkan status peran Kubernetes Engine Developer ke Enabled.

Men-deploy image container yang telah dibuat sebelumnya

Untuk men-deploy versi tertentu dari 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 Anda:

   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 flag yang tersedia, lihat gke-deploy run flag.

   Catatan: Saat men-deploy ke beberapa cluster GKE, Cloud Build mempertahankan direktori utama 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 membangun image container baru dan men-deploy image container baru:

1. Perbarui file resource Kubernetes Anda dengan image container 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 container image, biasanya nama aplikasi.
   • TAG adalah tag image container.
     • Jika Anda membangun image container baru dengan setiap commit, sebaiknya gunakan SHA singkat commit sebagai tag. Cloud Build makes this available as a default substitution, $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 image dalam file konfigurasi build Anda. Jika file resource Kubernetes Anda berisi beberapa referensi image, hanya image yang dimulai dengan LOCATION-docker.pkg.dev/PROJECT/REPOSITORY/IMAGE_NAME:TAG yang akan diperbarui untuk mereferensikan tag yang ditentukan.

2. Mulai build Anda:

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

   Dengan:

   • LOCATION adalah salah satu region 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 mem-build dan men-deploy image setiap kali Anda mengirimkan perubahan ke kode Anda.

Untuk membuat pemicu build:

1. Buka halaman Triggers di Google Cloud konsol:

   Buka halaman Pemicu

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

3. Klik Open.

4. Klik Create trigger.

   Di halaman Create trigger, 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 Configuration untuk pemicu Anda.

      Jika Anda memilih file konfigurasi Cloud Build, Anda dapat menentukan Substitution variables dengan memberikan nama variabel dan nilai yang ingin Anda kaitkan 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 Anda 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 Anda, 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 Create 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 builder Cloud tambahan.
• Pelajari cara memecahkan masalah error build.