Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Cloud Build memungkinkan Anda mengonfigurasi pemicu yang tidak langsung mengeksekusi build, tetapi menandai build sebagai tertunda hingga disetujui. Jika pengguna dengan izin menyetujui build yang menunggu keputusan, build akan dimulai. Jika persetujuan ditolak,
build tidak akan dimulai.
Halaman ini menjelaskan cara menyetujui atau menolak build secara manual.
Untuk mempelajari cara mengonfigurasi pemicu yang memerlukan persetujuan, lihat Membuat pemicu build.
Jika belum, buat pemicu build yang dikonfigurasi untuk memerlukan persetujuan.
Memberikan izin
Jika pengguna memiliki peran Cloud Build Editor, pengguna tersebut memiliki
izin untuk memperbarui pemicu agar memerlukan atau tidak memerlukan persetujuan. Untuk mempelajari lebih lanjut izin Cloud Build, lihat IAM dan izin. Untuk memberikan izin kepada pengguna agar dapat menyetujui build dalam project Anda, pengguna tersebut harus memiliki peran Cloud Build Approver.
Di bagian Add principals, tambahkan pengguna untuk memberi mereka izin guna
memberikan persetujuan untuk build yang tertunda dalam project Anda.
Anda harus menambahkan satu atau beberapa akun utama di bagian ini. Jika Anda menambahkan diri Anda sebagai
kepala sekolah, perhatikan bahwa Anda tetap harus menyetujui build yang tertunda secara manual
jika pemicu Anda dibatasi oleh persetujuan.
Di bagian Assign roles, pilih Cloud Build > Cloud Build Approver.
Pengguna yang Anda tentukan kini memiliki akses untuk menyetujui atau menolak build yang tertunda.
Menyetujui build
Konsol
Untuk menyetujui build yang tertunda di konsol Google Cloud :
Buka halaman Cloud Build Dashboard di konsol Google Cloud .
Jika ada build yang perlu disetujui, Anda akan melihat pesan di bagian atas halaman
dengan jumlah build yang menunggu persetujuan Anda. Di sebelah kanan pesan, klik Lihat Build untuk melihat daftar build yang menunggu persetujuan Anda.
Klik kotak centang pada build yang ingin Anda setujui.
Anda dapat memilih beberapa build untuk disetujui atau satu build untuk disetujui.
Di bagian atas halaman, klik Setujui untuk menyetujui build yang Anda pilih.
Sebelum build dimulai, Anda akan melihat kotak dialog Approve build.
Dalam kotak dialog, Anda dapat menambahkan pesan opsional dan URL yang akan ditampilkan bersama persetujuan build. Untuk menyertakan URL, klik
Tampilkan opsi tambahan untuk memasukkan URL.
Di kotak dialog, klik Setujui untuk menyetujui build.
Setelah Anda menyetujui, pembuatan akan segera dimulai. Jika kebijakan organisasi (constraints/cloudbuild.allowedIntegrations) menolak akses ke repositori yang terhubung, kebijakan tersebut akan menggantikan persetujuan. Untuk mempelajari lebih lanjut, lihat Mengatur build berdasarkan kebijakan organisasi.
gcloud
Untuk menyetujui build yang tertunda menggunakan gcloud commands, jalankan perintah berikut di jendela terminal:
Ganti nilai placeholder dalam perintah di atas dengan nilai berikut:
BUILD_ID adalah ID build yang ingin Anda
setujui.
PROJECT_ID adalah project ID Anda.
[Opsional] URL adalah URL yang berisi informasi
tentang persetujuan, seperti link ke tiket JIRA.
[Opsional] COMMENT adalah pesan yang ingin Anda tampilkan
setelah build disetujui.
Setelah Anda menyetujui, pembuatan akan segera dimulai. Jika kebijakan organisasi untuk menentukan build untuk integrasi yang diizinkan (constraints/cloudbuild.allowedIntegrations) ditetapkan, kebijakan tersebut akan menggantikan persetujuan. Untuk mempelajari lebih lanjut, lihat Menerapkan kebijakan organisasi ke pemicu build.
Menolak build
Konsol
Untuk menolak build yang menunggu keputusan di konsol Google Cloud :
Buka halaman Cloud Build Dashboard di konsol Google Cloud .
Jika ada build yang perlu disetujui, Anda akan melihat pesan di bagian atas halaman
dengan jumlah build yang menunggu persetujuan Anda. Di sebelah kanan pesan, klik Lihat Build untuk melihat daftar build yang menunggu persetujuan Anda.
Anda dapat memilih beberapa build untuk ditolak atau satu build individual untuk ditolak. Klik kotak centang pada build yang ingin Anda tolak.
Klik Tolak di bagian atas halaman untuk menolak build.
Jika Anda menolak build, build tidak akan dimulai.
gcloud
Untuk menolak build yang tertunda menggunakan gcloud commands, jalankan perintah berikut
di jendela terminal Anda:
Ganti nilai placeholder dalam perintah di atas dengan nilai berikut:
BUILD_ID adalah ID build yang ingin Anda tolak.
PROJECT_ID adalah project ID Anda.
[Opsional] URL adalah URL yang berisi informasi tentang penolakan, seperti link ke tiket JIRA.
[Opsional] COMMENT adalah pesan yang ingin Anda tampilkan saat build ditolak.
Jika Anda menolak build, build tidak akan pernah dimulai.
Menerima notifikasi untuk build yang menunggu persetujuan
Anda dapat menggunakan notifikasi Cloud Build untuk menerima notifikasi tentang build yang tertunda menggunakan notifikasi yang dikelola Cloud Build, seperti server Slack atau SMTP, atau dengan membuat notifikasi Anda sendiri.
Untuk mengonfigurasi notifikasi:
Ikuti petunjuk di salah satu halaman berikut untuk mengonfigurasi notifikasi untuk layanan yang Anda inginkan:
Saat mengonfigurasi notifikasi menggunakan salah satu halaman di atas, Anda harus
mengonfigurasi notifikasi untuk memfilter build dengan status PENDING.
Anda akan menerima notifikasi tentang build yang menunggu persetujuan.
Dalam contoh file konfigurasi notifikasi SMTP berikut, kolom filter menggunakan Common Expression Language (CEL) untuk memfilter peristiwa build dengan status PENDING:
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Sulit dipahami","hardToUnderstand","thumb-down"],["Informasi atau kode contoh salah","incorrectInformationOrSampleCode","thumb-down"],["Informasi/contoh yang saya butuhkan tidak ada","missingTheInformationSamplesINeed","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 2025-09-01 UTC."],[[["\u003cp\u003eCloud Build allows builds to be marked as pending, requiring manual approval before they start.\u003c/p\u003e\n"],["\u003cp\u003eUsers with the Cloud Build Approver role can approve or reject pending builds, either through the Google Cloud console or using gcloud commands.\u003c/p\u003e\n"],["\u003cp\u003eApproving a build initiates the build process immediately, while rejecting a build prevents it from ever starting.\u003c/p\u003e\n"],["\u003cp\u003eNotifications for pending builds can be configured through Cloud Build notifiers, allowing users to be alerted when builds are awaiting approval, and can be set up through services such as BigQuery, HTTP, Slack, SMTP and others.\u003c/p\u003e\n"],["\u003cp\u003eUsers will need to create a build trigger configured to require approval before they can approve or reject pending builds.\u003c/p\u003e\n"]]],[],null,["# Gate builds on approval\n\nCloud Build enables you to configure triggers that do not\nimmediately execute a build but instead mark a build as pending\nuntil approved. If a user with permissions approves a pending\nbuild, the build will start. If the approval is denied,\nthe build will not start.\n\nThis page explains how you can manually approve or reject builds.\nTo learn how to configure a trigger that requires approval, see [Creating a build trigger](/build/docs/automating-builds/create-manage-triggers#console).\n| **Note:** You can't approve or reject pending builds older than 2 months. For details, see [Troubleshooting](/build/docs/troubleshooting#pending_build).\n\nBefore you begin\n----------------\n\n-\n\n\n Enable the Cloud Build API.\n\n\n [Enable the API](https://console.cloud.google.com/flows/enableapi?apiid=cloudbuild.googleapis.com&redirect=https://cloud.google.com/build/docs/automating-builds/approve-builds)\n\n\u003c!-- --\u003e\n\n- Install [Google Cloud CLI](/sdk/docs/install-sdk).\n\n | **Note:** If you've already installed gcloud CLI previously, make sure you have the latest available version by running `gcloud components update`.\n- If you have not already, [create a build trigger](/build/docs/automating-builds/create-manage-triggers#console) configured to require approval.\n\n### Granting permissions\n\nIf a user has the **Cloud Build Editor role** , the user has\npermissions to update a trigger to require or not require approval. To learn more\nabout Cloud Build permissions, see [IAM and\npermissions](/build/docs/iam-roles-permissions). In order to grant\na user permission to approve builds within your project, the user\nmust have the **Cloud Build Approver** role.\n\nTo add the **Cloud Build Approver** role:\n\n1. Open the **IAM** page in the Google Cloud console.\n\n [Open the IAM page](https://console.cloud.google.com/iam-admin/iam)\n2. Click **Grant access**.\n\n You will see the **Grant access** panel.\n3. In the **Add principals** section, add users to give them permission to\n grant approval for pending builds within your project.\n\n You *must* add one or more principals in this section. If you add yourself as\n a principal, note that you will still need to manually approve a pending\n build if your trigger is gated by an approval.\n4. In the **Assign roles** section, select **Cloud Build** \\\u003e **Cloud Build Approver**.\n\nThe users you specified now have access to approve or reject pending builds.\n\nApproving builds\n----------------\n\n### Console\n\nTo approve a pending build in the Google Cloud console:\n\n1. Open the **Cloud Build Dashboard** page in the Google Cloud console.\n\n [Open the Cloud Build Dashboard page](https://console.cloud.google.com/cloud-build/dashboard)\n2. If you have builds to approve, you will see a message at the top of the page\n with the number of builds awaiting your approval. To the right of the message,\n click **View Builds** to view the list of builds awaiting your approval.\n\n3. Click on the checkboxes of the builds you'd like to approve.\n You can select multiple builds to approve or one individual build to\n approve.\n\n4. At the top of the page, click **Approve** to approve your selected builds.\n\n5. Before the build starts, you will see the **Approve build** dialog box.\n In the dialog box, you can add an optional message and a URL to be\n displayed along with the build's approval. To include a URL, click\n **Show additional options** to enter a URL.\n\n6. In the dialog box, click **Approve** to approve the build.\n\nOnce you approve, the build will start immediately. If the organization\npolicy\n(`constraints/cloudbuild.allowedIntegrations`) denies access to\nthe connected repository, the policy will\noverride the approval. To learn more, see [Gate builds on organization policy](/build/docs/securing-builds/gate-builds-organization-policy).\n\n### gcloud\n\nTo approve a pending build using `gcloud commands`, run the following command\nin your terminal window: \n\n gcloud builds approve \u003cvar translate=\"no\"\u003eBUILD_ID\u003c/var\u003e \\\n --project=\u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e \\\n --url=\u003cvar translate=\"no\"\u003eURL\u003c/var\u003e \\\n --comment=\u003cvar translate=\"no\"\u003eCOMMENT\u003c/var\u003e\n\nReplace the placeholder values in the above commands with the following:\n\n- \u003cvar translate=\"no\"\u003eBUILD_ID\u003c/var\u003e is the ID of the build you'd like to approve.\n- \u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e is your project ID.\n- \\[Optional\\] \u003cvar translate=\"no\"\u003eURL\u003c/var\u003e is the URL containing information about the approval, such as a link to a JIRA ticket.\n- \\[Optional\\] \u003cvar translate=\"no\"\u003eCOMMENT\u003c/var\u003e is the message you want displayed upon approval of the build.\n\nOnce you approve, the build will start immediately. If the organization\npolicy to define builds for allowed integrations\n(`constraints/cloudbuild.allowedIntegrations`) is set, the policy will\noverride the approval. To learn more, see [Applying organization\npolicy to build triggers](/build/docs/securing-builds/apply-organization-policy-triggers).\n\nRejecting builds\n----------------\n\n### Console\n\nTo reject a pending build in the Google Cloud console:\n\n1. Open the **Cloud Build Dashboard** page in the Google Cloud console.\n\n [Open the Cloud Build Dashboard page](https://console.cloud.google.com/cloud-build/dashboard)\n2. If you have builds to approve, you will see a message at the top of the page\n with the number of builds awaiting your approval. To the right of the message,\n click **View Builds** to view the list of builds awaiting your approval.\n\n3. You can select multiple builds to reject or one individual build to\n reject. Click on the checkboxes of the builds you'd like to reject.\n\n4. Click **Reject** at the top of the page to reject the build.\n\nIf you reject a build, the build will not start.\n\n### gcloud\n\nTo reject a pending build using `gcloud commands`, run the following command\nin your terminal window: \n\n gcloud builds reject \u003cvar translate=\"no\"\u003eBUILD_ID\u003c/var\u003e \\\n --project=\u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e \\\n --url=\u003cvar translate=\"no\"\u003eURL\u003c/var\u003e \\\n --comment=\u003cvar translate=\"no\"\u003eCOMMENT\u003c/var\u003e\n\nReplace the placeholder values in the above commands with the following:\n\n- \u003cvar translate=\"no\"\u003eBUILD_ID\u003c/var\u003e is the ID of the build you'd like to reject.\n- \u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e is your project ID.\n- \\[Optional\\] \u003cvar translate=\"no\"\u003eURL\u003c/var\u003e is the URL containing information about the rejection, such as a link to a JIRA ticket.\n- \\[Optional\\] \u003cvar translate=\"no\"\u003eCOMMENT\u003c/var\u003e is the message you want displayed upon rejection of the build.\n\nIf you reject a build, the build will never start.\n\nReceiving notifications for builds waiting for approval\n-------------------------------------------------------\n\nYou can use Cloud Build notifiers to receive notifications about\npending builds using a Cloud Build maintained notifier,\nsuch as [Slack](/build/docs/configuring-notifications/configure-slack) or [SMTP](/build/docs/configuring-notifications/configure-smtp) server, or by\n[creating your own notifier](/build/docs/configuring-notifications/create-notifier).\n\nTo configure notifications:\n\n1. Follow the instructions on one of following pages to\n configure notifications for your desired service:\n\n - [BigQuery](/build/docs/configuring-notifications/configure-bigquery)\n - [HTTP](/build/docs/configuring-notifications/configure-http)\n - [Slack](/build/docs/configuring-notifications/configure-slack)\n - [SMTP](/build/docs/configuring-notifications/configure-smtp)\n - [Creating your own notifier](/build/docs/configuring-notifications/create-notifier)\n2. When configuring notifications using one of the pages above, you must\n configure your notifier to filter builds with a *PENDING* status.\n This will send you notifications on builds waiting for approval.\n In the following example SMTP notifier configuration file, the filter field\n uses [Common Expression Language](https://github.com/google/cel-spec) (CEL) to filter build events with a PENDING status:\n\n apiVersion: cloud-build-notifiers/v1\n kind: SMTPNotifier\n metadata:\n name: example-smtp-notifier\n spec:\n notification:\n filter: build.status == Build.Status.PENDING\n delivery:\n server: example.gmail.com\n port: 0000\n sender: sender@example.com\n ...\n\n To view the full example, see the [notifier configuration file for the SMTP notifier](https://github.com/GoogleCloudPlatform/cloud-build-notifiers/blob/master/smtp/smtp.yaml.example).\n3. To deploy your notifier, run the `gcloud run` command in your terminal.\n The following example deploys the SMTP notifier using Cloud Run.\n\n gcloud run deploy example.gmail.com \\\n --image=us-east1-docker.pkg.dev/gcb-release/cloud-build-notifiers/smtp:latest \\\n --update-env-vars=CONFIG_PATH=smtp.yaml, PROJECT_ID=my-project\n\nYou should now receive notifications for pending builds to your service.\n\nWhat's next\n-----------\n\n- Learn how to [create and manage build triggers](/build/docs/automating-builds/create-manage-triggers).\n- Learn how to [view build results for build triggers](/build/docs/view-build-results#viewing_build_results_for_build_triggers)"]]
