Memecahkan masalah error build dan lainnya

Halaman ini menyediakan strategi pemecahan masalah serta solusi untuk beberapa pesan error umum yang mungkin Anda lihat saat menjalankan build.

Apakah Anda sudah melihat log build?

Gunakan log build Logging atau Cloud Storage untuk mendapatkan informasi selengkapnya tentang error build. Log yang ditulis ke stdout atau stderr dapat dilihat menggunakan konsol Google Cloud dan gcloud CLI.

Build manual gagal karena pengguna tidak memiliki akses ke log build

Anda akan melihat error berikut saat mencoba menjalankan build secara manual:

AccessDeniedAccess denied. [EMAIL_ADDRESS] does not have storage.objects.get access to the Google Cloud Storage object.

Anda melihat error ini karena Cloud Build mengharuskan pengguna yang menjalankan build manual dan menggunakan bucket log Cloud Storage default memiliki peran IAM Project Viewer selain peran Cloud Build Editor. Untuk mengatasi error ini, Anda dapat melakukan salah satu tindakan berikut:

Build gagal karena tidak memiliki izin iam.serviceAccounts.actAs

Anda akan melihat error berikut saat mencoba men-deploy build menggunakan layanan terkelola seperti Cloud Run atau App Engine:

Missing necessary permission iam.serviceAccounts.actAs for [USER] on the service account [SERVICE ACCOUNT]

Untuk mengatasi error ini, konfigurasikan akun layanan Cloud Build yang ditentukan atau akun layanan Cloud Build default untuk meniru akun layanan dari layanan terkelola yang Anda gunakan untuk build Anda. Untuk mengetahui informasi selengkapnya tentang tugas ini, lihat Mengonfigurasi peniruan akun layanan Cloud Build untuk layanan terkelola.

Untuk mengetahui informasi tambahan tentang akun layanan dan izin, lihat topik berikut:

Error izin ditolak saat men-deploy di Cloud Run Functions

Anda melihat error berikut saat mencoba menggunakan Cloud Run Functions:

ResponseError: status=[403], code=[Ok], message=[Permission 'cloudfunctions.functions.get' denied]

Untuk mengatasi error ini, berikan peran Developer Cloud Run Functions ke akun layanan build Anda.

Pemicu build gagal karena tidak memiliki izin cloudbuild.builds.create

Anda akan melihat error seperti berikut saat menjalankan pemicu build:

Failed to trigger build: Permission 'cloudbuild.builds.create' denied on resource 'projects/xxxxxxxx' (or it may not exist)

Pemicu build menggunakan akun layanan untuk membuat build. Error ini menunjukkan bahwa akun layanan tidak memiliki izin IAM cloudbuild.builds.create, yang diperlukan agar akun layanan dapat menjalankan pemicu build. Anda dapat mengatasi error ini dengan memberikan peran IAM Cloud Build Service Account ke akun layanan yang ditentukan pengguna atau akun layanan default.

Kegagalan pengiriman build karena tidak ada izin agen layanan

Jika agen layanan Cloud Build dihapus atau tidak memiliki izin, hal ini dapat menyebabkan error berikut saat mengirimkan build.

Caller does not have required permission to use project $PROJECT_ID. Grant the caller the roles/serviceusage.serviceUsageConsumer role, or a custom role with the serviceusage.services.use permission, by visiting https://console.developers.google.com/iam-admin/iam/project?project=$PROJECT_ID and then retry. Propagation of the new permission may take a few minutes.

Pemanggil dalam skenario ini adalah agen layanan Cloud Build. Untuk menyelesaikan masalah izin ini, ikuti langkah-langkah berikut:

  1. Pastikan agen layanan Cloud Build ada. Anda dapat melihat agen layanan untuk project dengan membuka halaman IAM di konsol Google Cloud dan mencentang kotak Show google managed service accounts. Jika tidak ada, Anda dapat membuatnya dengan menjalankan perintah gcloud CLI berikut:

    gcloud beta services identity create --service=cloudbuild.googleapis.com \
        --project=PROJECT_ID
    
  2. Selanjutnya, berikan peran IAM roles/cloudbuild.serviceAgent ke agen layanan Cloud Build:

    gcloud projects add-iam-policy-binding PROJECT_ID \
        --member="serviceAccount:service-PROJECT_NUMBER@gcp-sa-cloudbuild." \
        --role="roles/cloudbuild.serviceAgent"
    

Jika Anda ingin memverifikasi identitas IAM yang berpotensi menyebabkan masalah izin agen layanan, ikuti langkah-langkah berikut:

  1. Buka Logs Explorer di konsol Google Cloud :

    Buka Logs Explorer

  2. Masukkan teks berikut di kolom kueri:

    resource.type="project"
    log_name="projects/PROJECT_ID/logs/cloudaudit.googleapis.com%2Factivity"
    "service-PROJECT_NUMBER@gcp-sa-cloudbuild."
    
  3. Jika Anda melihat entri log setelah menggunakan kueri ini, periksa apakah ada entri log yang menghapus izin dari agen layanan (service-PROJECT_NUMBER@gcp-sa-cloudbuild.). Jika demikian, lihat protoPayload.authenticationInfo.principalEmail di log tersebut untuk menentukan identitas IAM yang bertanggung jawab untuk menghapus izin atau peran roles/cloudbuild.serviceAgent yang berisi izin yang tercantum dalam pesan error.

Pemicu gagal dengan error Couldn't read commit

Anda melihat error berikut saat menjalankan pemicu build:

  Failed to trigger build: Couldn't read commit

Cloud Build menampilkan pesan ini jika Anda mencoba memicu build menggunakan cabang yang tidak ada. Tinjau ejaan dan konsistensi nama direktori Anda. Untuk mengetahui petunjuk tentang penyiapan pemicu, lihat Membuat dan mengelola pemicu build.

Tidak dapat membuat pemicu Pub/Sub

Anda melihat error berikut saat membuat pemicu Pub/Sub:

  Failed to create trigger: Request is prohibited by organization's policy

Error ini menunjukkan bahwa Pub/Sub API dibatasi di project Anda. Project yang membatasi Pub/Sub API akan membatasi kemampuan untuk membuat Langganan Push. Anda dapat menghapus Pub/Sub untuk sementara dari layanan yang dibatasi di perimeter Anda, membuat pemicu, dan membatasi Pub/Sub API lagi untuk mengatasi error.

Tidak dapat Menarik atau Mengambil cabang dari repositori pribadi karena error: fatal: could not read Username

Anda akan melihat error berikut saat mencoba melakukan git pull atau git fetch pada cabang jarak jauh dari repositori pribadi:

fatal: could not read Username for '<REMOTE_URL>': No such device or address

Error ini diperkirakan terjadi pada repositori pribadi, karena helper kredensial git sengaja dihapus setelah cloning awal repositori. Untuk mengambil cabang jarak jauh dari repositori pribadi, siapkan kredensial otorisasi (Token API, Kunci SSH) secara manual sebagai langkah build. Pelajari lebih lanjut cara mengakses repositori GitHub pribadi.

Build gagal karena otorisasi ssh tidak valid

Anda melihat error berikut saat menjalankan build:

Could not parse ssh: [default]: invalid empty ssh-agent socket, make sure SSH_AUTH_SOCK is set

Error ini menunjukkan masalah pada otorisasi SSH. Contoh umumnya adalah error otorisasi SSH yang terjadi saat mengakses repositori GitHub pribadi dengan Cloud Build. Untuk mengetahui petunjuk cara menyiapkan SSH untuk GitHub, lihat Mengakses repositori GitHub pribadi.

Build gagal karena error No route to host

Anda akan melihat error berikut atau yang serupa saat menjalankan build di pool pribadi:

Unable to connect to the server: dial tcp 192.168.10.XX:<port>: connect: no route to host

Cloud Build menjalankan Cloud Builder-nya di virtual machine dalam project yang dikelola Google menggunakan container Docker. Antarmuka bridge Docker (dan akibatnya container yang terhubung ke antarmuka ini) diberi rentang IP 192.168.10.0/24, sehingga komunikasi dengan host eksternal di subnet yang sama tidak dapat dilakukan. Saat mengalokasikan rentang IP untuk resource dalam project Anda selama konfigurasi pool pribadi, sebaiknya pilih rentang di luar 192.168.10.0/24. Untuk mengetahui petunjuknya, lihat Menyiapkan lingkungan untuk pool pribadi.

Build gagal dengan pesan error: "Expired", dan tidak menampilkan log apa pun

Anda memicu atau mengirimkan build dan build tersebut gagal, menampilkan error "Expired", dan tidak ada log yang dibuat.

Periksa hal berikut dalam konfigurasi Anda:

  • Anda telah mengonfigurasi nilai queueTtl yang lebih rendah (misalnya, 20 dtk).

    Tingkatkan nilai dalam skema Anda dan jalankan build lagi. Lihat queueTtl untuk mengetahui informasi selengkapnya.

  • Anda telah mencapai kuota untuk build serentak.

    Anda dapat meminta penambahan kuota melalui halaman Quota di konsol Google Cloud . Untuk mengetahui detail selengkapnya, lihat Kuota dan Batas.

  • Anda menggunakan pool pribadi dan telah memilih mesin non-default.

    Build dapat memerlukan waktu lebih lama untuk dimulai karena mungkin perlu menunggu virtual machine baru dimulai. Lihat Jenis mesin untuk mengetahui informasi selengkapnya.

    Anda dapat mencoba mengubah jenis mesin.

  • Anda menggunakan pool pribadi dan telah menentukan rentang IP untuk pool tersebut.

    Rentang fisik IP menentukan jumlah worker VM dalam pool, sehingga menentukan batas build serentak, meskipun lebih rendah dari kuota Build Serentak. Build akan diantrekan jika tidak ada worker VM yang tersedia di pool.

    Hal ini terjadi jika alamat IP yang tersedia dalam subnet yang ditetapkan telah digunakan sepenuhnya, sehingga tidak ada alamat yang dapat dialokasikan untuk worker Cloud Build baru. Coba tingkatkan rentang di subnet dan jalankan ulang build.

Koneksi ke resource eksternal gagal karena tidak ada IP eksternal yang diaktifkan

Anda melihat error berikut saat menghubungkan ke resource eksternal dari pool pribadi:

 Failed to connect to <external_domain>: Connection timed out

Pool pribadi menggunakan IP eksternal untuk mengakses resource di internet publik, seperti repositori eksternal. Saat membuat atau memperbarui pool pribadi, centang kotak untuk menetapkan IP eksternal ke pool pribadi Anda. Untuk mengetahui petunjuk tentang cara Membuat atau memperbarui kolom dalam pool pribadi, lihat Membuat dan mengelola pool pribadi.

Error waktu tunggu I/O habis

Anda melihat error berikut saat menjalankan build:

Timeout - last error: dial tcp IP_ADDRESS: i/o timeout

Error ini dapat terjadi saat build Anda mencoba mengakses resource di jaringan pribadi, tetapi gagal. Secara default, build yang dijalankan menggunakan Cloud Build dapat mengakses resource pribadi di internet publik, seperti resource dalam repositori atau registry. Namun, build hanya dapat mengakses resource di jaringan pribadi jika Anda menggunakan pool pribadi dan mengonfigurasinya untuk mengakses jaringan pribadi. Lihat Menggunakan Cloud Build di jaringan pribadi.

Worker pool pribadi mengalami waktu tunggu habis saat melakukan cloning dari server GitHub Enterprise internal

Saat menjalankan build di pool pribadi yang meng-clone kode sumber dari server GitHub Enterprise internal atau lokal, langkah build akan gagal dengan error waktu tunggu koneksi habis yang mirip dengan berikut ini:

fatal: unable to access 'https://github.example.com/org/repo.git/': Failed to connect to github.example.com port 443: Connection timed out

atau:

fatal: unable to access 'https://github.example.com/org/repo.git/': Could not resolve host: github.example.com

Untuk mengatasi waktu tunggu koneksi antara worker pool pribadi dan server GitHub Enterprise internal Anda, verifikasi prasyarat jaringan dan pemilihan rute berikut:

  • Ekspor rute kustom di seluruh peering Jaringan Layanan: Pool pribadi berjalan di jaringan produsen layanan yang dikelola Google yang di-peering dengan jaringan Virtual Private Cloud (VPC) Anda menggunakan Jaringan Layanan (servicenetworking-googleapis-com). Secara default, Peering Jaringan VPC hanya bertukar rute subnet. Jika server GitHub Enterprise Anda dihosting secara lokal atau di jaringan eksternal yang dijangkau menggunakan Cloud VPN atau Cloud Interconnect, rute dinamis yang dipelajari oleh Cloud Router atau rute kustom statis di jaringan VPC Anda tidak akan otomatis dibagikan ke pool pribadi.

    Pastikan konfigurasi peering jaringan VPC Anda mengekspor rute kustom ke jaringan produsen layanan:

    gcloud compute networks peerings update servicenetworking-googleapis-com \
        --network=VPC_NETWORK \
        --export-custom-routes
    

    Ganti VPC_NETWORK dengan nama jaringan VPC yang di-peering dengan pool pribadi. Untuk mengetahui informasi selengkapnya, lihat Opsi pertukaran rute.

  • Mengonfigurasi resolusi DNS internal untuk nama host pribadi: VM worker pool pribadi tidak dapat me-resolve nama host pribadi yang dihosting di zona Cloud DNS pribadi atau server DNS lokal tanpa peering DNS:

  • Verifikasi aturan firewall dan daftar IP yang diizinkan GitHub Enterprise:

    • Firewall perimeter dan VPC: Pastikan aturan firewall di jaringan VPC Anda dan firewall lokal perantara mengizinkan traffic masuk dari rentang alamat IP yang dialokasikan untuk pool pribadi ke server GitHub Enterprise di port TCP 443 (HTTPS) atau port 22 (SSH).
    • Daftar IP yang diizinkan GitHub Enterprise: Jika organisasi atau server GitHub Enterprise Anda menerapkan daftar IP yang diizinkan, tambahkan rentang CIDR yang dialokasikan dari subnet peering pool pribadi Anda ke daftar yang diizinkan. Jika pool pribadi Anda merutekan traffic egress melalui proxy internal atau gateway NAT yang dikelola sendiri, tambahkan alamat IP proxy atau NAT ke daftar yang diizinkan.
  • Mengatasi Peering Jaringan VPC non-transitif: Peering Jaringan VPC bersifat non-transitif. Jika server GitHub Enterprise Anda di-deploy di jaringan VPC sekunder yang di-peering dengan jaringan VPC yang menghosting pool pribadi, pool pribadi tidak dapat menjangkau GitHub Enterprise melalui jaringan VPC perantara. Untuk mengaktifkan konektivitas menyeluruh, hubungkan jaringan menggunakan Cloud VPN, Cloud Interconnect, atau proxy perantara. Untuk mengetahui informasi selengkapnya, lihat Jaringan transit dengan beberapa peering.

Error klien 4xx

Grup error ini menunjukkan bahwa permintaan build tidak berhasil, mungkin karena kesalahan pengguna yang mengirim permintaan. Beberapa contoh error klien 4xx adalah:

  • **Error**: 404 : Requested entity was not found
  • **Error**: 404 : Trigger not found
  • **Error**: 400 : Failed Precondition
  • **Error**: 403 : Permission denied

Jika Anda melihat error klien 4xx, lihat log build untuk mengetahui apakah log tersebut berisi informasi selengkapnya tentang alasan error. Beberapa penyebab umum error klien meliputi:

  • Lokasi sumber yang Anda tentukan tidak memiliki hal baru untuk di-commit dan hierarki kerja bersih. Dalam hal ini, periksa lokasi kode sumber Anda dan coba bangun lagi.
  • Repositori Anda tidak berisi file konfigurasi build. Jika demikian, upload file konfigurasi build ke repositori Anda dan jalankan build lagi.
  • Anda telah menentukan ID pemicu yang salah.
  • Anda baru saja menambahkan repositori baru setelah menginstal aplikasi GitHub, dan Cloud Build tidak memiliki izin untuk mengakses repositori baru tersebut. Jika demikian, hubungkan repositori baru Anda ke Cloud Build.
  • Anda perlu memberikan izin lain ke akun layanan build Anda.

Build gagal karena pembatasan kuota

Anda akan melihat error berikut yang menunjukkan bahwa build gagal karena pembatasan kuota di region tertentu:

Failed to trigger build: generic::failed_precondition: due to quota restrictions, cannot run builds in this region. Please contact support.

Hubungi Cloud Customer Care untuk meningkatkan kuota Anda untuk region tertentu ini.

Masalah waktu tunggu habis saat mengambil image dari registry Docker

Anda akan melihat error waktu tunggu berikut di log Cloud Build setelah menjalankan build:

Step #0: Pulling image: python:3.8.16-alpine3.17
Step #0: Error response from daemon: Get "https://registry-1.docker.io/v2/": net/http: request canceled while waiting for connection (Client.Timeout exceeded while awaiting headers)

Step 1/7 : FROM python:3.8.16-alpine3.17
Get "https://registry-1.docker.io/v2/": dial tcp 34.205.13.154:443: i/o timeout

Untuk mengatasi error ini, download image Docker menggunakan crane, lalu lanjutkan untuk memuat image ke image Docker Cloud Build.

Tambahkan cuplikan berikut ke file cloudbuild.yaml Anda.

...
  # Crane runs as a regular user so we need to allow it to access the directory where it saves the image.
  - name: gcr.io/cloud-builders/docker
    args:
    - a+w
    - /workspace
    entrypoint: chmod
  # Use crane to download the image through the proxy
  - name: gcr.io/go-containerregistry/crane
    env: - 'HTTPS_PROXY=HTTPS_PROXY'
    args:
    - pull
    - 'python:3.8.16-alpine3.17'
    - /workspace/image.tar
  # Use docker load to add the image into the local Cloud Build registry
  - name: gcr.io/cloud-builders/docker
    args: [load, --input, "/workspace/image.tar"]
      - .
  • HTTPS_PROXY: Alamat proxy HTTP Anda (misalnya, https://proxy.example.com:8888/).

Setelah image dimuat, langkah-langkah cloudbuid.yaml yang ada akan berfungsi seperti biasa, misalnya berikut ini:

...
  - name: python:3.8.16-alpine3.17
    args:
    - echo
    - hello
    entrypoint: bash
  # Or use it internally on a Dockerfile
  - name: gcr.io/cloud-builders/docker
    args:
    - build

Error Unauthenticated untuk langkah Docker yang berjalan lama

Langkah-langkah build yang melibatkan perintah Docker yang berjalan selama lebih dari satu jam (seperti mendorong image besar ke Artifact Registry) mungkin gagal dengan error autentikasi. Cloud Build memperbarui token autentikasi setiap jam, tetapi Docker mungkin gagal mengambil token baru ini sehingga menyebabkan masalah autentikasi. Anda dapat menulis token Anda sendiri dengan masa aktif kustom ke file dan mereferensikannya untuk perintah Docker.

Build dalam antrean di pool pribadi yang di-peering ke jaringan VPC

Saat Anda menjalankan build di pool pribadi yang jaringan produsen layanannya di-peering ke jaringan VPC Anda sendiri, penting untuk memastikan koneksi pribadi antara kedua jaringan ini tetap utuh. Jika Anda menghapus koneksi pribadi yang diandalkan oleh pool pribadi, Anda dapat merusak pool pribadi tersebut. Hal ini dapat muncul sebagai build yang tetap berada dalam antrean hingga akhirnya waktu habis. Oleh karena itu, jika Anda ingin menghapus koneksi pribadi, pastikan Anda juga menghapus semua pool pribadi yang jaringan produsen layanannya terhubung ke jaringan VPC Anda sendiri menggunakan koneksi pribadi ini.

Mencoba menyetujui atau menolak build tertunda yang berusia lebih dari 2 bulan

Anda tidak dapat menyetujui atau menolak build tertunda yang berusia lebih dari 2 bulan. Jika dilakukan, akan muncul pesan error seperti ini:

 404, "message": "Requested entity was not
found.", "status": "NOT_FOUND" } }

Jika hal ini terjadi, coba kirimkan build baru.

Failed to create private pool: Worker pool isn't peered to Service Networking API

Anda mencoba membuat pool pribadi. Namun, Anda menerima pesan error berikut:

Failed to create private pool private-worker-pool: generic::failed_precondition: network "projects/PROJECT_NAME/global/networks/vpc-scmdev-lab-vpc" is not peered to the Service Networking API; please check your configuration and the documentation for troubleshooting and setting up your pool 

Agar build dapat mengakses resource pribadi dari jaringan Virtual Private Cloud, Anda harus menyiapkan koneksi peering antara jaringan Virtual Private Cloud dan jaringan Virtual Private Cloud tempat pool pribadi berada. Untuk mengetahui petunjuknya, lihat Menyiapkan koneksi pribadi antara jaringan VPC Anda dan jaringan produsen layanan.

Gagal membuat private pool: tidak dapat mengakses konfigurasi peered_network

Jika Anda menggunakan VPC Bersama atau sebelumnya telah menghapus agen layanan Service Networking, pembuatan pool pribadi mungkin akan gagal dengan error yang mirip dengan berikut ini:

generic::permission_denied: cannot access peered_network config.

Untuk memperbaiki masalah ini, pastikan agen layanan Service Networking (service-PROJECT_NUMBER@service-networking.) ada di project layanan Anda dan memiliki izin yang diperlukan.

Buat akun layanan jika belum ada:

gcloud beta services identity create \
    --service=servicenetworking.googleapis.com \
    --project=PROJECT_ID

Berikan peran roles/servicenetworking.serviceAgent yang diperlukan ke akun layanan:

gcloud projects add-iam-policy-binding PROJECT_ID \
    --member="serviceAccount:service-PROJECT_NUMBER@service-networking." \
    --role="roles/servicenetworking.serviceAgent"

Langkah berikutnya

Log build muncul tidak berurutan

Anda menjalankan langkah-langkah build yang menghasilkan log dan melihat bahwa log stderr (error) muncul di UI sebelum log stdout (output standar) yang sesuai. Log muncul tidak sesuai urutan kronologis.

Urutan ini adalah perilaku buffering aliran data Docker dan Linux standar. Saat kode berjalan di lingkungan non-TTY, seperti container build, stdout di-buffer blok (ditunda hingga buffer penuh), sedangkan stderr tetap tidak di-buffer (langsung dicetak).

Untuk mengabaikan metode pengurutan ini dan menjamin pengurutan log yang ketat, Anda harus secara eksplisit menonaktifkan buffering di lingkungan eksekusi langkah build.

Python: Tetapkan variabel lingkungan PYTHONUNBUFFERED: yaml steps: - name: 'python:3' env: ['PYTHONUNBUFFERED=1'] script: | python main.py

Skrip C/C++ dan Bash: Gunakan perintah stdbuf untuk memaksa buffering baris: yaml steps: - name: 'ubuntu' script: | stdbuf -oL ./your_binary

Java: Java tidak mendukung penonaktifan buffering secara native menggunakan flag, tetapi Anda dapat memaksa pengosongan langsung dalam kode setelah pernyataan log penting: java System.out.println("Log message"); System.out.flush();