Deployment memungkinkan Anda menjadwalkan kode untuk dijalankan—misalnya, pipeline—yang disimpan di repositori Git jarak jauh. Anda dapat memilih direktori tempat kode Anda berada dan melakukan tindakan berikut:
- Buat dan kelola deployment yang terhubung ke repositori jarak jauh.
- Konfigurasi pemicu untuk menarik kode dari repositori jarak jauh dan menjalankan kode secara rutin.
- Jalankan pipeline sesuai jadwal atau dengan pemicu lain.
- Lihat log eksekusi Anda langsung di konsol Google Cloud . Untuk pemberitahuan, deployment Dataform terintegrasi dengan Cloud Logging dan Cloud Monitoring.
Batasan
- Deployment tidak memiliki pemberitahuan bawaan. Anda harus menggunakan Logging dan Monitoring untuk mengonfigurasi pemberitahuan.
- Autentikasi dengan Developer Connect hanya mendukung koneksi, bukan konektor akun.
Sebelum memulai
Sebelum Anda membuat deployment, selesaikan tugas berikut:
- Pilih untuk menggunakan halaman Pipelines & Connections di konsol Google Cloud .
Aktifkan BigQuery API, Dataform API, dan Developer Connect API:
Hubungkan repositori jarak jauh menggunakan Developer Connect.
Peran yang diperlukan
Untuk mendapatkan izin yang Anda perlukan untuk menyelesaikan tugas dalam dokumen ini, minta administrator Anda untuk memberi Anda peran IAM berikut:
- Admin Dataform (
roles/dataform.admin) di project - BigQuery Job User (
roles/bigquery.jobUser) di project - Developer Connect Viewer (
roles/developerconnect.viewer) di project -
Menggunakan akun layanan kustom untuk menjalankan deployment:
Pengguna Akun Layanan (
roles/iam.serviceAccountUser) di akun layanan kustom
Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.
Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.
Untuk menggunakan akun layanan kustom guna menjalankan deployment, Anda juga harus memberikan
peran BigQuery Data Editor
(roles/bigquery.dataEditor) ke akun layanan kustom.
Membuat deployment
Untuk membuat deployment Dataform, lakukan hal berikut:
Di konsol Google Cloud , buka halaman Pipelines & Connections.
Klik Create > Create deployment.
Pilih jenis autentikasi repositori, lalu pilih salah satu opsi berikut:
Developer Connect
- Pilih repositori dan cabang.
- Masukkan jalur untuk direktori tempat kode berada.
- Masukkan nama untuk deployment.
- Pilih region untuk deployment.
Di bagian Frekuensi jadwal, lakukan tindakan berikut:
- Di menu Repeats, pilih frekuensi jadwal pipeline dijalankan.
- Di kolom At time, masukkan waktu untuk menjalankan pipeline terjadwal.
- Di menu Zona waktu, pilih zona waktu untuk jadwal.
Atau, pilih Sesuai permintaan untuk menjalankan deployment sesuai permintaan.
Opsional: Masukkan Google Cloud project ID.
Opsional: Masukkan akhiran skema.
Opsional: Masukkan awalan tabel.
Opsional: Masukkan skema default.
Opsional: Masukkan variabel kompilasi.
Klik Deploy.
HTTPS
- Masukkan URL repositori Git jarak jauh Anda.
- Pilih cabang.
- Masukkan jalur untuk direktori tempat kode berada.
- Masukkan secret yang berisi token akses pribadi untuk HTTPS remotes. Untuk mengetahui informasi selengkapnya, lihat Menghubungkan repositori jarak jauh melalui HTTPS.
- Masukkan nama untuk deployment.
- Pilih region untuk deployment.
Di bagian Frekuensi jadwal, lakukan tindakan berikut:
- Di menu Repeats, pilih frekuensi jadwal pipeline dijalankan.
- Di kolom At time, masukkan waktu untuk menjalankan pipeline terjadwal.
- Di menu Zona waktu, pilih zona waktu untuk jadwal.
Atau, pilih Sesuai permintaan untuk menjalankan deployment sesuai permintaan.
Opsional: Masukkan Google Cloud project ID.
Opsional: Masukkan akhiran skema.
Opsional: Masukkan awalan tabel.
Opsional: Masukkan skema default.
Opsional: Masukkan variabel kompilasi.
Klik Deploy.
SSH
- Masukkan URL repositori Git jarak jauh Anda.
- Pilih cabang.
- Masukkan jalur untuk direktori tempat kode berada.
- Masukkan rahasia yang berisi kunci pribadi pengguna dan nilai kunci host publik SSH. Untuk mengetahui informasi selengkapnya, lihat Menghubungkan repositori jarak jauh melalui SSH.
- Masukkan nama untuk deployment.
- Pilih region untuk deployment.
Di bagian Frekuensi jadwal, lakukan tindakan berikut:
- Di menu Repeats, pilih frekuensi jadwal pipeline dijalankan.
- Di kolom At time, masukkan waktu untuk menjalankan pipeline terjadwal.
- Di menu Zona waktu, pilih zona waktu untuk jadwal.
Atau, pilih Sesuai permintaan untuk menjalankan deployment sesuai permintaan.
Opsional: Masukkan Google Cloud project ID.
Opsional: Masukkan akhiran skema.
Opsional: Masukkan awalan tabel.
Opsional: Masukkan skema default.
Opsional: Masukkan variabel kompilasi.
Klik Deploy.
Mencantumkan deployment
Untuk mencantumkan deployment yang dibuat, lakukan hal berikut:
Di konsol Google Cloud , buka halaman Pipelines & Connections.
Lihat daftar deployment.
Membuat jadwal deployment
Untuk membuat jadwal deployment, lakukan hal berikut:
Di konsol Google Cloud , buka halaman Pipelines & Connections.
Klik tab Deployments, lalu pilih deployment.
Di halaman Deployment details, di bagian Triggers (workflow configurations), klik Create.
Di panel Create workflow configuration, ikuti langkah-langkah untuk membuat konfigurasi alur kerja.
Menjalankan jadwal deployment
Untuk menjalankan jadwal deployment, lakukan hal berikut:
Di konsol Google Cloud , buka halaman Pipelines & Connections.
Klik tab Deployment, lalu pilih deployment.
Di bagian Pemicu (konfigurasi alur kerja), di samping jadwal deployment yang ingin Anda jalankan, klik Lihat tindakan > Jalankan sekarang.
Menghapus jadwal deployment
Untuk menghapus jadwal deployment, lakukan langkah-langkah berikut:
Di konsol Google Cloud , buka halaman Pipelines & Connections.
Klik tab Deployments, lalu pilih deployment.
Di halaman Deployment details, di bagian Triggers (workflow configurations), di samping jadwal deployment yang ingin Anda hapus, klik View actions > Delete.
Mengonfigurasikan pemberitahuan
Untuk menerima notifikasi saat eksekusi alur kerja gagal, konfigurasi pemberitahuan untuk pemanggilan alur kerja yang gagal.
Langkah berikutnya
- Pelajari cara membuat repositori.
- Pelajari cara menjadwalkan eksekusi.
- Pelajari cara mengonfigurasi pemberitahuan.