Men-deploy ke App Engine

Halaman ini menjelaskan cara men-deploy aplikasi ke App Engine menggunakan Cloud Build. Jika Anda baru menggunakan Cloud Build, baca panduan memulai dan ringkasan konfigurasi build terlebih dahulu.

App Engine adalah platform serverless yang terkelola sepenuhnya untuk mengembangkan dan menghosting aplikasi web dalam skala besar. Untuk mengetahui informasi selengkapnya tentang App Engine, baca dokumentasi App Engine.

Sebelum memulai

  • Aktifkan App Engine API:

    Mengaktifkan App Engine API

  • Siapkan kode sumber aplikasi Anda. Kode sumber Anda harus disimpan di repositori seperti GitHub atau Bitbucket.

  • Untuk menjalankan perintah gcloud di halaman ini, instal Google Cloud CLI.

Izin Identity and Access Management yang diperlukan

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

    Buka Izin

  2. Untuk akun layanan Cloud Build yang ditentukan atau akun layanan Cloud Build default, tetapkan status peran berikut ke Diaktifkan:

    • Admin App Engine (roles/appengine.appAdmin) | Mengizinkan Cloud Build men-deploy versi baru ke App Engine.
    • Admin Penyimpanan (roles/storage.admin) | Memungkinkan membaca dan menulis dari Cloud Storage.
    • Penulis Artifact Registry (roles/artifactregistry.writer) | Mengizinkan penarikan image dari dan penulisan ke Artifact Registry.
    • Penulis Log (roles/logging.logWriter) | Mengizinkan entri log ditulis ke Cloud Logging.
    • Cloud Build Editor (roles/cloudbuild.builds.editor) | Mengizinkan akun layanan Anda menjalankan build.

Mengonfigurasi deployment

Cloud Build memungkinkan Anda menggunakan image container yang tersedia secara publik untuk menjalankan tugas. Anda dapat melakukannya dengan menentukan image dalam build step di file konfigurasi Cloud Build.

App Engine menyediakan perintah gcloud app deploy, yang mem-build image dengan kode sumber Anda dan men-deploy image tersebut di App Engine. Anda dapat menggunakan image cloud-sdk sebagai langkah build dalam file konfigurasi untuk memanggil perintah gcloud dalam image. Argumen yang diteruskan ke langkah build ini diteruskan langsung ke gcloud CLI, sehingga Anda dapat menjalankan perintah gcloud apa pun dalam image ini.

Untuk men-deploy aplikasi ke App Engine, ikuti langkah-langkah berikut:

  1. Buat file konfigurasi Cloud Build bernama cloudbuild.yaml atau cloudbuild.json.

  2. Di file konfigurasi:

    • Tambahkan kolom name untuk menentukan langkah build cloud-sdk.
    • Tambahkan kolom entrypoint untuk menggunakan alat bash saat cloud-sdk dipanggil.

    • Di kolom args, panggil perintah gcloud app deploy dan tetapkan timeout untuk App Engine yang akan digunakan saat memanggil Cloud Build. Hal ini diperlukan karena langkah-langkah build dan build Cloud Build memiliki waktu tunggu default 10 menit dan deployment App Engine dapat memerlukan waktu lebih lama untuk diselesaikan. Menentukan waktu tunggu yang lebih lama akan memastikan bahwa build tidak mengalami waktu tunggu habis jika gcloud app deploy memerlukan waktu lebih dari 10 menit untuk selesai.

      Error waktu tunggu saat menggunakan lingkungan standar App Engine: Anda hanya dapat mengonfigurasi waktu tunggu seperti yang dijelaskan di sini saat menggunakan lingkungan fleksibel App Engine. Lingkungan standar App Engine tidak mengizinkan konfigurasi waktu tunggu build. Jika Anda menggunakan Cloud Build untuk men-deploy di lingkungan standar App Engine, dan build Anda gagal dengan error waktu tunggu, pertimbangkan untuk menggunakan lingkungan fleksibel App Engine atau Cloud Run, sebagai pengganti lingkungan standar App Engine.

    • Tambahkan nilai build timeout lebih dari 10 menit.

    YAML 

    steps:
- name: 'gcr.io/google.com/cloudsdktool/cloud-sdk'
  entrypoint: 'bash'
  args: ['-c', 'gcloud config set app/cloud_build_timeout 1600 && gcloud app deploy']
timeout: '1600s'

    JSON 

    {
  "steps": [
  {
    "name": "gcr.io/google.com/cloudsdktool/cloud-sdk",
    "entrypoint": "bash",
    "args": [
      "-c",
      "gcloud config set app/cloud_build_timeout 1600 && gcloud app deploy"
     ]
  }
  ],
  "timeout": "1600s"
}

  3. Mulai build, dengan SOURCE_DIRECTORY adalah jalur atau URL ke kode sumber dan REGION adalah salah satu region build yang didukung untuk memulai build:

     gcloud builds submit --region=REGION SOURCE_DIRECTORY

Deployment berkelanjutan

Anda dapat mengotomatiskan deployment software ke App Engine dengan membuat pemicu Cloud Build. Anda dapat mengonfigurasi pemicu untuk mem-build dan men-deploy image setiap kali Anda mengupdate kode sumber.

Untuk mengotomatiskan deployment ke App Engine:

  1. Di repositori Anda, tambahkan file konfigurasi dengan langkah-langkah untuk memanggil perintah gcloud app deploy:

    YAML 

    steps:
- name: 'gcr.io/google.com/cloudsdktool/cloud-sdk'
  entrypoint: 'bash'
  args: ['-c', 'gcloud config set app/cloud_build_timeout 1600 && gcloud app deploy']
timeout: '1600s'

    JSON 

    {
  "steps": [
  {
    "name": "gcr.io/google.com/cloudsdktool/cloud-sdk",
    "entrypoint": "bash",
    "args": [
      "-c",
      "gcloud config set app/cloud_build_timeout 1600 && gcloud app deploy"
     ]
  }
  ],
  "timeout": "1600s"
}

  2. Buat pemicu build dengan file konfigurasi yang dibuat pada langkah sebelumnya:

    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.

      5. Konfigurasi: Pilih file konfigurasi build yang Anda buat sebelumnya.

    5. Klik Buat untuk menyimpan pemicu build Anda.

Setiap kali Anda mengirim kode baru ke repositori, Anda akan otomatis memulai build dan men-deploy di App Engine.

Untuk mengetahui informasi selengkapnya tentang cara membuat pemicu Cloud Build, lihat Membuat dan mengelola pemicu build.

Langkah berikutnya