Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Membuat plugin

Halaman ini menjelaskan cara membuat plugin Service Extensions yang dapat Anda gunakan untuk menerapkan ekstensibilitas dengan Google Cloud layanan.

Fitur ini berada dalam Pratinjau untuk Media CDN.

Untuk ringkasan produk, lihat Ringkasan Service Extensions.

Sebelum memulai

Siapkan dan upload file yang diperlukan untuk membuat plugin.
Dapatkan peran dan izin Identity and Access Management (IAM) yang diperlukan.

Aktifkan Network Services API, jika belum diaktifkan.

gcloud services enable networkservices.googleapis.com

Untuk plugin Media CDN, jika Anda ingin mengaktifkan logging, aktifkan Network Actions API.
```
gcloud services enable networkactions.googleapis.com
```

Membuat resource plugin

Membuat resource plugin memerlukan penentuan image yang berisi kode plugin dan penentuan label serta opsi logging untuk plugin.

Konsol

Untuk membuat plugin, ikuti langkah-langkah berikut:

Di Google Cloud konsol, buka halaman Service Extensions.

Buka Service Extensions
Klik tab Plugins.
Klik Create plugin.
Di bagian Basics, lakukan hal berikut:
1. Untuk Scope, pilih Global atau Regional.
  
  Jika Anda menetapkan cakupan sebagai Regional, pilih juga regionnya.
2. Masukkan nama plugin yang unik.
  
  Nama harus diawali dengan huruf kecil, diikuti dengan maksimal 62 huruf kecil, angka, atau tanda hubung, dan tidak boleh diakhiri dengan tanda hubung.
3. Opsional: Masukkan deskripsi singkat tentang plugin menggunakan maksimal 1.024 karakter.
Di bagian Wasm image, lakukan hal berikut:
1. Untuk Plugin version name, tentukan nama untuk versi plugin.
  
  Nama harus diawali dengan huruf kecil, diikuti dengan maksimal 62 huruf kecil, angka, atau tanda hubung, dan tidak boleh diakhiri dengan tanda hubung.
2. Opsional: Untuk Plugin version description, masukkan deskripsi singkat tentang versi plugin menggunakan maksimal 1.024 karakter.
3. Untuk Image URL, masukkan URL untuk artefak umum atau image container yang memiliki modul Wasm dari panel Artifact Registry. Opsi untuk menggunakan repositori umum berada dalam Pratinjau.
  
  Jika ingin menentukan image container di repositori Docker, Anda dapat mengklik Select untuk menjelajahi dan memilihnya. Panel Artifact Registry menampilkan folder di repositori yang terhubung ke project saat ini.
  
  Untuk memilih image dari project lain, pastikan Service Extensions memiliki akses ke image tersebut, lalu klik Change, di samping nama project.
Opsional: Di bagian Plugin configuration, untuk mengaitkan data konfigurasi dengan plugin, centang kotak Add plugin configuration, dan lalu pilih salah satu opsi berikut:
- Upload plugin configuration file. Jika ukuran file Anda kurang dari 900 KiB dan berada di drive lokal, klik Browse untuk menemukan dan memilihnya.
- Select plugin configuration image or artifact from Artifact Registry. Masukkan URL untuk artefak umum atau image container yang memiliki modul Wasm dari panel Artifact Registry. Opsi untuk menggunakan repositori umum berada dalam Pratinjau.
  
  Untuk menentukan image container di repositori Docker, Anda dapat mengklik Select untuk menjelajahi dan memilihnya. Panel Artifact Registry menampilkan folder di repositori yang terhubung ke project saat ini.
Opsional: Di bagian Labels, klik Add label. Kemudian, di baris yang muncul, lakukan hal berikut:
1. Untuk Key, masukkan nama kunci.
2. Untuk Value, masukkan nilai untuk kunci.
Anda dapat menambahkan maksimal 64 pasangan nilai kunci. Untuk menambahkan lebih banyak pasangan nilai kunci, klik Add label.

Untuk mengetahui informasi selengkapnya tentang label, lihat Membuat dan memperbarui label untuk project.
Di bagian Encryption, pilih mekanisme enkripsi untuk plugin. Opsi ini hanya tersedia untuk plugin regional.
- Google-managed encryption key. Enkripsi konten plugin dengan mekanisme enkripsi default Google.
- Cloud KMS key. Enkripsi konten plugin dengan kunci enkripsi yang dikelola pelanggan yang dibuat menggunakan Cloud Key Management Service. Dalam hal ini, untuk Key management type, pilih Cloud KMS. Kemudian, pilih kunci Cloud KMS.
Opsional: Di bagian Logging, pilih Enable logging dan lakukan hal berikut:
- Untuk Sample rate, tentukan nilai antara 0 dan 1. Nilai 0 menunjukkan bahwa pesan log tidak disimpan. Nilai default 1 menunjukkan bahwa semua pesan log disimpan. Nilai floating point antara 0.0 dan 1.0 menunjukkan bahwa persentase pesan log disimpan.
- Untuk Minimum log level, pilih tingkat keparahan minimum pesan log plugin yang akan diekspor ke Cloud Logging. Nilai defaultnya adalah Info and higher.
Klik Create.

gcloud

Buat plugin dengan menjalankan perintah gcloud service-extensions wasm-plugins create:
```
gcloud service-extensions wasm-plugins create WASM_PLUGIN \
    --description=PLUGIN_DESCRIPTION \
    --location=LOCATION \
    --labels=[LABELS,...] \
    --log-config=[LOG_CONFIG,...] \
    --image=IMAGE \
    --main-version=MAIN_VERSION \
    --plugin-config=PLUGIN_CONFIG |
        --plugin-config-file=PLUGIN_CONFIG_FILE |
        --plugin-config-uri=PLUGIN_CONFIG_URI \
    --kms-key-name=KEY_NAME
```
Ganti kode berikut:
- WASM_PLUGIN: ID atau nama lengkap plugin
- PLUGIN_DESCRIPTION: deskripsi plugin
- LOCATION: lokasi plugin sebagai global atau region
- LABELS: label dalam bentuk pasangan nilai kunci yang dipisahkan dengan koma
- LOG_CONFIG: opsi logging untuk plugin. Jika opsi enable ditetapkan ke false, log tidak akan diambil untuk plugin. Untuk mengaktifkan logging, tetapkan opsi enable ke true. Kemudian, tentukan detail berikut:
  - sample-rate: frekuensi sampling log aktivitas sebagai nilai antara 0 dan 1. Nilai 0 menunjukkan bahwa pesan log tidak disimpan. Nilai default 1 menunjukkan bahwa semua pesan log disimpan. Nilai floating point antara 0.0 dan 1.0 menunjukkan bahwa persentase pesan log disimpan.
  - min-log-level: tingkat keparahan minimum pesan log plugin yang akan diekspor ke Cloud Logging. Nilai defaultnya adalah INFO.
- IMAGE: URI artefak yang berisi modul Wasm yang disimpan di repositori Artifact Registry. Sebelum menentukan image container dari project lain, pastikan Service Extensions memiliki akses ke image tersebut.
- MAIN_VERSION: ID versi plugin yang akan dibuat dan ditetapkan sebagai versi utama (aktif).
- PLUGIN_CONFIG, PLUGIN_CONFIG_FILE, atau PLUGIN_CONFIG_URI: data konfigurasi opsional, yang dapat ditentukan sebagai teks, file lokal, atau image container di Artifact Registry.
- KEY_NAME: untuk plugin regional, nama lengkap kunci enkripsi yang dikelola pelanggan dalam format berikut: projects/PROJECT/locations/LOCATION/keyRings/KEYRING_NAME/cryptoKeys/KEY_NAME.
  
  Ganti kode berikut:
  - PROJECT: ID project yang berisi kunci
  - LOCATION: lokasi kunci
  - KEYRING_NAME: nama key ring
  - KEY_NAME: nama kunci
  Jika opsi ini tidak ditentukan, mekanisme enkripsi default Google akan digunakan.
Contoh:
```
gcloud service-extensions wasm-plugins create my-plugin \
    --description="This is my plugin." \
    --log-config=enable=true,sample-rate=0.5,min-log-level=INFO \
    --labels=key1=value1,key2=value2 \
    --image=...-docker.pkg.dev/my-project/repository/container:tag \
    --main-version=v1 \
    --plugin-config-file=config.txt
```
Untuk men-deploy versi baru, gunakan perintah gcloud service-extensions wasm-plugins update. Tentukan nama image dan versi baru:
```
gcloud service-extensions wasm-plugins update my-plugin \
    --image=...-docker.pkg.dev/my-project/repository/container:tag \
    --main-version=v2
```

Untuk menjalankan plugin ini, Anda dapat mengonfigurasi ekstensi Cloud Load Balancing dan ekstensi Media CDN.

Mengakses image di project lain

Sebelum dapat memilih image dari project lain, agen layanan Service Extensions harus memiliki akses ke repositori project dan, bergantung pada cara modul Wasm Anda dikemas, salah satu izin berikut di project:

Untuk artefak umum: artifactregistry.files.download
Untuk image container: artifactregistry.repositories.downloadArtifacts

Agen layanan Service Extensions diberi nama sebagai berikut:

service-PROJECT_NUMBER@gcp-sa-networkactions.iam.gserviceaccount.com

Ganti PROJECT_NUMBER dengan nomor project Anda.

Langkah berikutnya

Lihat Load Balancer Aplikasi yang didukung untuk plugin Cloud Load Balancing.
Pelajari cara mengonfigurasi ekstensi edge Cloud Load Balancing , ekstensi rute, dan ekstensi traffic menggunakan plugin.
Pelajari cara melampirkan plugin Media CDN ke rute.
Pelajari cara mengelola plugin.
Lihat Ringkasan Service Extensions.