Google Cloud Storage
Tujuan
Siapkan sanitasi file otomatis di Google Cloud Storage menggunakan Glasswall Halo API melalui layanan Google Cloud Run dan Eventarc.
Panduan Integrasi Google Cloud Storage
- Prasyarat
- Langkah 1 – Penyiapan
- Langkah 2 – Deploy Google Cloud Run
- Langkah 3 – Siapkan peristiwa penyimpanan
- Langkah 4 – Uji aplikasi
Prasyarat
- Akun Google Cloud Console
- Bucket Google Cloud sumber
- Bucket Google Cloud tujuan
- Google Cloud CLI
- kode contoh Glasswall
Catatan:
- Sebelum memulai, pastikan semua parameter konfigurasi diberi nama dengan benar dan ditambahkan ke aplikasi Google Cloud Run, karena ketidaksesuaian apa pun akan menyebabkan kegagalan.
- Kode contoh yang disediakan hanya mendemonstrasikan kasus penggunaan ini. Kode tersebut menangani file datar dan tidak menyertakan mekanisme logging lanjutan.
Langkah 1 – Penyiapan
Google menyediakan skenario serupa yang dapat digunakan untuk memulai. Ikuti panduan Before you begin untuk izin, akun layanan, dan penyiapan command-line.
Setelah selesai, Anda seharusnya siap untuk men-deploy kode contoh.
Pastikan juga bahwa Anda telah menyelesaikan langkah-langkah berikut:
- Masuk ke Google Cloud Console.
- Clone kode contoh ke direktori kerja.
- Jalankan perintah berikut:
cd ./GCloudStorageEvents/dotnet
gcloud auth login
gcloud config set project "${PROJECT_ID}"
PROJECT_ID dapat ditemukan di halaman sambutan konsol Google Cloud Platform.
Langkah 2 – Deploy Google Cloud Run
Pada langkah-langkah berikut, ganti ${SERVICE_NAME} dengan nama yang diinginkan untuk aplikasi Cloud Run yang di-deploy.
- Untuk melakukan deploy dari command line, gunakan perintah
gcloud run deploy:
gcloud run deploy "${SERVICE_NAME}" --source . --region "${SERVICE_REGION}" --set-env-vars OutputBucket="${OUTPUT_BUCKET_NAME}" --set-env-vars HALO_URL="${HALO_URL}" --set-env-vars HALO_USERNAME="${HALO_USERNAME}" --set-env-vars HALO_PASSWORD="${HALO_PASSWORD}"
- Konfigurasi dilakukan selama deployment. Ganti variabel yang diapit dalam
${}dengan nilai yang sesuai.
| Kunci | Nilai |
|---|---|
| Service_name | Nama layanan Cloud Run yang akan dibuat |
| Service_region | Region tempat layanan Cloud Run akan di-deploy |
| Output_bucket_name | Nama bucket penyimpanan tujuan (harus sudah ada) |
| Halo_url | URL untuk endpoint file CDR (misalnya, https://api.glasswall.com/api/v3/cdr-file) |
| Halo_username | Nama pengguna untuk autentikasi dasar Halo API |
| Halo_password | Kata sandi untuk autentikasi dasar Halo API |
Lihat dokumentasi deployment Google Cloud Run untuk detail selengkapnya.
Langkah 3 – Siapkan peristiwa penyimpanan
Untuk mengonfigurasi peristiwa penyimpanan, buat trigger Google Eventarc menggunakan perintah berikut:
gcloud eventarc triggers create "${SERVICE_NAME}" --destination-run-service="${SERVICE_NAME}" --destination-run-region="${SERVICE_REGION}" --destination-run-path="/" --location="${SERVICE_REGION}" --event-filters="type=google.cloud.storage.object.v1.finalized" --event-filters="bucket=${INPUT_BUCKET_NAME}" --service-account="${PROJECT_NUMBER}[email protected]"
Langkah 4 – Uji aplikasi
Untuk menguji aplikasi, unggah file yang didukung ke bucket input. File yang berhasil diproses akan muncul di bucket output.