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 informasi selengkapnya tentang App Engine, baca dokumentasi App Engine.

Sebelum memulai

  • Aktifkan App Engine API:

    Mengaktifkan App Engine API

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

  • Siapkan kode sumber aplikasi yang ingin Anda build dan deploy ke App Engine. Kode sumber Anda harus disimpan di repositori, seperti Cloud Source Repositories, GitHub, atau Bitbucket.

Izin IAM yang diperlukan

  1. Di konsol Google Cloud, pilih project Anda.

  2. Berikan peran Akun Layanan Cloud Build ke akun layanan default App Engine. Jika akun layanan tidak muncul dalam daftar, temukan akun layanan di halaman Service Accounts.

    Buka Akun Layanan

  3. Berikan peran App Engine Admin dan Service Account User ke akun layanan build:

    1. Buka halaman Setelan Cloud Build:

      Buka halaman Setelan Cloud Build

    2. Tetapkan status peran App Engine Admin dan peran Service Account User ke Enabled.

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, gunakan langkah-langkah berikut:

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

  2. Dalam 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 digunakan App Engine saat memanggil Cloud Build. Hal ini diperlukan karena langkah build dan build Cloud Build memiliki waktu tunggu default 10 menit dan deployment App Engine dapat memerlukan waktu lebih lama untuk diselesaikan. Dengan menentukan waktu tunggu yang lebih lama, build tidak akan mengalami waktu tunggu habis jika gcloud app deploy memerlukan waktu lebih dari 10 menit untuk diselesaikan.

      Error waktu tunggu saat menggunakan lingkungan standar App Engine: Anda dapat mengonfigurasi waktu tunggu seperti yang dijelaskan di sini hanya saat menggunakan lingkungan fleksibel App Engine. Lingkungan standar App Engine tidak mengizinkan waktu tunggu build dikonfigurasi. Jika Anda menggunakan Cloud Build untuk men-deploy di lingkungan standar App Engine, dan build Anda gagal dengan error waktu tunggu habis, pertimbangkan untuk menggunakan lingkungan fleksibel App Engine atau Cloud Run, bukan 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 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 di 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 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. Configuration: Pilih file konfigurasi build yang Anda buat sebelumnya.

    5. Klik Buat untuk menyimpan pemicu build Anda.

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

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

Langkah selanjutnya