Membangun dan membuat tugas Shell di Cloud Run
Sebelum memulai
- 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.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
Aktifkan Cloud Run Admin API dan Cloud Build API:
gcloud services enable run.googleapis.com \ cloudbuild.googleapis.com
Setelah Cloud Run Admin API diaktifkan, akun layanan default Compute Engine akan otomatis dibuat.
- Agar Cloud Build dapat mem-build sumber Anda, berikan peran Cloud Build Service Account ke akun layanan default Compute Engine dengan menjalankan perintah berikut:
gcloud projects add-iam-policy-binding PROJECT_ID \ --member=serviceAccount:PROJECT_NUMBER-compute@developer.gserviceaccount.com \ --role=roles/cloudbuild.builds.builder
Ganti
PROJECT_NUMBER
dengan nomor project Google Cloud Anda, danPROJECT_ID
dengan project ID Google Cloud Anda. Untuk petunjuk mendetail tentang cara menemukan project ID dan nomor project, lihat Membuat dan mengelola project.Pemberian peran Akun Layanan Cloud Build ke akun layanan default Compute Engine memerlukan waktu beberapa menit untuk disebarkan.
Menulis contoh tugas
Menulis tugas Cloud Run yang menjalankan skrip Shell:
Buat sebuah direktori baru bernama
jobs
dan ubah ke direktori tersebut:mkdir jobs cd jobs
Buat file Dockerfile dengan konten berikut:
Dalam direktori yang sama, buat file
script.sh
untuk kode tugas yang sebenarnya. Salin baris contoh berikut ke dalamnya:Tugas Cloud Run mengizinkan pengguna untuk menentukan jumlah tugas yang akan dijalankan oleh tugas tersebut. Kode contoh ini menunjukkan cara menggunakan variabel lingkungan
CLOUD_RUN_TASK_INDEX
bawaan. Setiap tugas mewakili satu salinan container yang berjalan. Perhatikan bahwa tugas-tugas biasanya dijalankan secara paralel. Menggunakan beberapa tugas akan berguna jika setiap tugas dapat memproses subset data Anda secara independen.Setiap tugas mengetahui indeksnya, yang disimpan dalam variabel lingkungan
CLOUD_RUN_TASK_INDEX
. Variabel lingkunganCLOUD_RUN_TASK_COUNT
bawaan berisi jumlah tugas yang disediakan pada waktu eksekusi tugas melalui parameter--tasks
.Kode yang ditampilkan juga menunjukkan cara mencoba ulang tugas, menggunakan variabel lingkungan
CLOUD_RUN_TASK_ATTEMPT
bawaan yang berisi berapa kali tugas ini telah dicoba ulang, mulai dari 0 untuk upaya pertama dan bertambah 1 untuk setiap percobaan ulang berturut-turut yang berhasil, hingga--max-retries
.Kode ini juga memungkinkan Anda menghasilkan kegagalan sebagai cara untuk menguji percobaan ulang dan membuat log error sehingga Anda dapat melihat seperti apa tampilannya.
Kode Anda telah lengkap dan siap untuk dikemas dalam container.
Bangun container tugas, kirim ke Artifact Registry, lalu deploy ke Cloud Run
Penting: Panduan memulai ini mengasumsikan bahwa Anda memiliki peran pemilik atau editor dalam project yang Anda gunakan untuk panduan memulai tersebut. Atau, lihat peran Developer Sumber Cloud Run untuk mengetahui izin yang diperlukan guna men-deploy resource Cloud Run dari sumber.
Panduan memulai ini menggunakan deploy dari sumber, yang membuat container, mengunggahnya ke Artifact Registry, dan men-deploy tugas tersebut ke Cloud Run:
gcloud run jobs deploy job-quickstart \ --source . \ --tasks 50 \ --set-env-vars SLEEP_MS=10000 \ --set-env-vars FAIL_RATE=0.1 \ --max-retries 5 \ --region REGION \ --project=PROJECT_ID
dengan PROJECT_ID sebagai project ID Anda dan REGION adalah region Anda
, misalnya, us-central1
. Perhatikan bahwa Anda dapat mengubah berbagai
parameter menjadi nilai apa pun yang Anda ingin gunakan untuk tujuan pengujian Anda.
SLEEP_MS
menyimulasikan pekerjaan dan FAIL_RATE
menyebabkan X
% tugas gagal sehingga Anda
dapat bereksperimen dengan paralelisme dan mencoba ulang tugas yang gagal.
Menjalankan tugas di Cloud Run
Untuk menjalankan tugas yang baru saja Anda buat:
gcloud run jobs execute job-quickstart --region REGION
Ganti REGION dengan region yang Anda gunakan saat membuat dan men-deploy
tugas, misalnya us-central1
.
Langkah berikutnya
Untuk informasi lebih lanjut dalam mem-build container dari kode sumber dan penerapan untuk repositori, lihat: