Panduan memulai: Deploy ke Cloud Run dari repositori Git

Halaman ini menampilkan cara men-deploy berkelanjutan dari repositori Git ke Cloud Run.


Untuk mengikuti panduan langkah demi langkah tugas ini langsung di Google Cloud konsol, klik Pandu saya:

Pandu saya


Petunjuk lengkap untuk proses ini dapat ditemukan di Deployment berkelanjutan dari Git menggunakan Cloud Build.

Sebelum memulai

  1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  3. Verify that billing is enabled for your Google Cloud project.

  4. Make sure that you have the following role or roles on the project: Cloud Run Admin, Cloud Run Source Developer, Logs Viewer

    Check for the roles

    1. In the Google Cloud console, go to the IAM page.

      Go to IAM
    2. Select the project.
    3. In the Principal column, find all rows that identify you or a group that you're included in. To learn which groups you're included in, contact your administrator.

    4. For all rows that specify or include you, check the Role column to see whether the list of roles includes the required roles.

    Grant the roles

    1. In the Google Cloud console, go to the IAM page.

      Buka IAM
    2. Pilih project.
    3. Klik Berikan akses.
    4. Di kolom Akun utama baru, masukkan ID pengguna Anda. Biasanya berupa alamat email untuk Akun Google.

    5. Di daftar Pilih peran, pilih peran.
    6. Untuk memberikan peran tambahan, klik Tambahkan peran lain, lalu tambahkan setiap peran tambahan.
    7. Klik Simpan.
  5. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  6. Verify that billing is enabled for your Google Cloud project.

  7. Make sure that you have the following role or roles on the project: Cloud Run Admin, Cloud Run Source Developer, Logs Viewer

    Check for the roles

    1. In the Google Cloud console, go to the IAM page.

      Go to IAM
    2. Select the project.
    3. In the Principal column, find all rows that identify you or a group that you're included in. To learn which groups you're included in, contact your administrator.

    4. For all rows that specify or include you, check the Role column to see whether the list of roles includes the required roles.

    Grant the roles

    1. In the Google Cloud console, go to the IAM page.

      Buka IAM
    2. Pilih project.
    3. Klik Berikan akses.
    4. Di kolom Akun utama baru, masukkan ID pengguna Anda. Biasanya berupa alamat email untuk Akun Google.

    5. Di daftar Pilih peran, pilih peran.
    6. Untuk memberikan peran tambahan, klik Tambahkan peran lain, lalu tambahkan setiap peran tambahan.
    7. Klik Simpan.
  8. Enable the Cloud Build API.

    Enable the API

  9. Jika Anda dikenai kebijakan organisasi pembatasan domain yang membatasi pemanggilan yang tidak diautentikasi untuk project, Anda perlu mengakses layanan yang di-deploy seperti yang dijelaskan di bagian Menguji layanan pribadi.

  10. Pastikan Anda memiliki peran Pengguna Akun Layanan yang diberikan pada identitas layanan. Secara default, identitas layanan adalah akun layanan default Compute Engine.

    Memberikan peran

    Untuk memberikan akses pada resource identitas layanan, gunakan perintah gcloud iam service-accounts add-iam-policy-binding, dengan mengganti variabel yang ditandai dengan nilai yang sesuai:

          gcloud iam service-accounts add-iam-policy-binding SERVICE_ACCOUNT_EMAIL \
              --member="PRINCIPAL" \
              --role="roles/iam.serviceAccountUser"
          

    Ganti kode berikut:

    • SERVICE_ACCOUNT_EMAIL: alamat email akun layanan yang Anda gunakan sebagai identitas layanan, seperti:
      • Akun layanan default Compute Engine: PROJECT_NUMBER-compute@developer.gserviceaccount.com
      • Akun layanan yang Anda buat: SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com
    • PRINCIPAL: ID pengguna. Biasanya berupa alamat email untuk Akun Google.
  11. Membuat repositori dari template

    Untuk membuat repositori:

    1. Buka template repositori:

    2. Klik Gunakan template ini.

    3. Pilih Create a new repository.

    4. Pada formulir, masukkan nama repositori.

    5. Klik buat repository dari template.

    Men-deploy dari repositori

    Untuk men-deploy dari repositori:

    1. Di konsol Google Cloud , buka halaman Cloud Run:

      Buka Cloud Run

    2. Pilih Layanan dari menu, lalu klik Deploy container.

    3. Di Create service, pastikan opsi Continuously deploy from a repository dipilih.

    4. Di formulir, klik Set up Cloud Build.

    5. Di panel kanan:

      1. Di bagian Repositori, pilih repositori yang baru dibuat. Jika belum melakukan autentikasi, Anda mungkin akan diminta untuk melakukannya. Gunakan link autentikasi di kolom Repository Provider.

      2. Periksa konfirmasi perjanjian tentang interaktivitas GitHub dan Google Cloud .

      3. Klik Berikutnya.

      4. Di bagian Build Type, pilih Google Cloud Buildpacks.

      5. Klik Simpan.

    6. Di formulir Create service:

      1. Konfirmasi nama layanan. Kolom ini akan otomatis terisi dengan nama repositori.

      2. Di menu pull-down Region, pilih region tempat Anda ingin layanan Anda berada.

      3. Di bagian Authentication, pilih Allow public access. Jika Anda tidak memiliki izin (peran Admin Cloud Run) untuk memilih opsi ini, layanan akan di-deploy dan memerlukan autentikasi.

      4. Klik Create untuk men-deploy contoh repositori ke Cloud Run dan tunggu deployment selesai.

    7. Klik link URL yang ditampilkan untuk menjalankan container yang di-deploy.

    Lokasi Cloud Run

    Cloud Run bersifat regional, berarti infrastruktur yang menjalankan layanan Cloud Run Anda terletak di region tertentu dan dikelola oleh Google agar tersedia secara redundan di semua zona dalam region tersebut.

    Memenuhi persyaratan latensi, ketersediaan, atau ketahanan adalah faktor utama untuk memilih region tempat layanan Cloud Run dijalankan. Pada umumnya, Anda dapat memilih region yang paling dekat dengan pengguna Anda, tetapi Anda harus mempertimbangkan lokasi produk Google Cloud lainnya yang digunakan oleh layanan Cloud Run Anda. Menggunakan Google Cloud produk secara bersamaan di beberapa lokasi dapat memengaruhi latensi serta biaya layanan Anda.

    Cloud Run tersedia di region berikut:

    Tergantung harga Tingkat 1

    • asia-east1 (Taiwan)
    • asia-northeast1 (Tokyo)
    • asia-northeast2 (Osaka)
    • asia-south1 (Mumbai, India)
    • europe-north1 (Finlandia) ikon daun CO2 Rendah
    • europe-north2 (Stockholm) ikon daun CO2 Rendah
    • europe-southwest1 (Madrid) ikon daun CO2 Rendah
    • europe-west1 (Belgia) ikon daun CO2 Rendah
    • europe-west4 (Belanda) ikon daun CO2 Rendah
    • europe-west8 (Milan)
    • europe-west9 (Paris) ikon daun CO2 Rendah
    • me-west1 (Tel Aviv)
    • northamerica-south1 (Meksiko)
    • us-central1 (Iowa) ikon daun CO2 Rendah
    • us-east1 (South Carolina)
    • us-east4 (North Virginia)
    • us-east5 (Columbus)
    • us-south1 (Dallas) ikon daun CO2 Rendah
    • us-west1 (Oregon) ikon daun CO2 Rendah

    Tergantung harga Tingkat 2

    • africa-south1 (Johannesburg)
    • asia-east2 (Hong Kong)
    • asia-northeast3 (Seoul, Korea Selatan)
    • asia-southeast1 (Singapura)
    • asia-southeast2 (Jakarta)
    • asia-south2 (Delhi, India)
    • australia-southeast1 (Sydney)
    • australia-southeast2 (Melbourne)
    • europe-central2 (Warsawa, Polandia)
    • europe-west10 (Berlin) ikon daun CO2 Rendah
    • europe-west12 (Turin)
    • europe-west2 (London, Inggris Raya) ikon daun CO2 Rendah
    • europe-west3 (Frankfurt, Jerman)
    • europe-west6 (Zurich, Swiss) ikon daun CO2 Rendah
    • me-central1 (Doha)
    • me-central2 (Dammam)
    • northamerica-northeast1 (Montreal) ikon daun CO2 Rendah
    • northamerica-northeast2 (Toronto) ikon daun CO2 Rendah
    • southamerica-east1 (Sao Paulo, Brasil) ikon daun CO2 Rendah
    • southamerica-west1 (Santiago, Cile) ikon daun CO2 Rendah
    • us-west2 (Los Angeles)
    • us-west3 (Salt Lake City)
    • us-west4 (Las Vegas)

    Jika sudah membuat layanan Cloud Run, Anda dapat melihat region di dasbor Cloud Run di Google Cloud konsol.

    Memperbarui layanan

    Untuk melakukan perubahan ke layanan:

    1. Kirimkan commit ke cabang utama repositori.

    2. Muat ulang layanan Cloud Run untuk melihat status update.

    Cloud Run otomatis menskalakan instance container Anda berdasarkan permintaan, dan Anda hanya membayar untuk CPU, memori, dan jaringan yang terpakai selama pemrosesan permintaan.

    Langkah berikutnya