Membuat bus untuk merutekan pesan

Konsol

1. Di konsol Google Cloud , buka halaman Eventarc > Bus.

   Buka Bus

2. Klik add_box Create bus.

3. Di halaman Create a bus, lakukan hal berikut:

   1. Masukkan Nama bus. Ini adalah ID untuk bus Anda.
   2. Opsional: Masukkan Nama tampilan bus yang ditampilkan di halaman Detail bus.
   3. Di daftar Region, pilih region yang didukung untuk men-deploy bus Anda.
   4. Dalam daftar Tingkat keparahan log, pilih tingkat keparahan minimum untuk peristiwa yang dijelaskan dalam entri log. Defaultnya adalah Tidak ada. Untuk mengetahui informasi selengkapnya, lihat LogSeverity.
   5. Untuk Encryption, terima Google-managed encryption key default atau pilih Cloud KMS key. Untuk mengetahui informasi selengkapnya, lihat Menggunakan kunci enkripsi yang dikelola pelanggan (CMEK).

   6. Jika Anda memilih Kunci Cloud KMS, lakukan hal berikut:

      1. Dalam daftar Key type, pilih metode untuk mengelola kunci Anda.

         Anda dapat mengelola kunci secara manual atau menggunakan Autokey yang memungkinkan Anda membuat cincin kunci dan kunci sesuai permintaan. Jika opsi Cloud KMS dengan Autokey dinonaktifkan, opsi tersebut belum terintegrasi dengan jenis resource saat ini.

      2. Di Select a Cloud KMS key, pilih kunci.

         Perhatikan bahwa Anda harus memilih region sebelum dapat melihat kunci yang dikelola pelanggan.

      3. Opsional: Untuk memasukkan nama resource kunci secara manual, di daftar Pilih kunci yang dikelola pelanggan, klik Masukkan kunci secara manual, lalu masukkan nama kunci dalam format yang ditentukan.

      4. Jika diminta, berikan peran cloudkms.cryptoKeyEncrypterDecrypter kepada Agen Layanan Eventarc.

   7. Opsional: Untuk menambahkan sumber pesan, klik add Tambahkan sumber.

      1. Di panel Tambahkan sumber pesan, untuk penyedia pesan Google API, terima default google-api-source atau masukkan nama sumber yang berbeda.

      2. Klik Buat.

         Hal ini memungkinkan pengumpulan peristiwa otomatis yang berasal langsung dari sumber Google.

         Perhatikan bahwa hanya peristiwa dari resource dalam project Google Cloud yang sama dengan bus yang dipublikasikan. Untuk mengetahui informasi selengkapnya, lihat Memublikasikan peristiwa dari sumber Google.

   8. Opsional: Untuk menambahkan label, klik add Tambahkan label. Label adalah pasangan nilai kunci yang membantu Anda mengaturGoogle Cloud resource. Untuk mengetahui informasi selengkapnya, lihat Apa yang dimaksud dengan label?

4. Klik Buat.

gcloud

1. Buka terminal.

2. Buat bus menggunakan perintah gcloud beta eventarc message-buses create.

   gcloud beta eventarc message-buses create BUS_NAME \
       --location=REGION
   

   Ganti kode berikut:

   • BUS_NAME: ID atau ID yang memenuhi syarat sepenuhnya dari bus

   • REGION: lokasi yang didukung untuk bus

     Atau, Anda dapat menetapkan properti lokasi Google Cloud CLI:

     gcloud config set eventarc/location REGION
     

   Opsional: Anda juga dapat menggunakan flag berikut:

   • --async untuk segera kembali dari perintah, tanpa menunggu operasi yang sedang berlangsung selesai.
   • --crypto-key untuk menentukan nama yang sepenuhnya memenuhi syarat dari kunci enkripsi yang dikelola pelanggan; jika tidak ditentukan, Google-owned and managed keys akan digunakan.
   • --logging-config untuk mengonfigurasi tingkat keparahan minimum untuk peristiwa yang dijelaskan dalam entri log. Harus berupa salah satu dari berikut: NONE, DEBUG, INFO, NOTICE, WARNING, ERROR, CRITICAL, ALERT, EMERGENCY. Defaultnya adalah NONE. Untuk mengetahui informasi selengkapnya, lihat LogSeverity.

REST API

Untuk membuat bus, gunakan projects.locations.messageBuses.create metode.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

• BUS_NAME: nama tampilan bus Anda—misalnya, my_bus.
• LABEL_KEY dan LABEL_VALUE: opsional. Peta pasangan nilai dan kunci label yang membantu Anda mengatur resource. Google Cloud Untuk mengetahui informasi selengkapnya, lihat Apa yang dimaksud dengan label?
• ANNOTATION_KEY dan ANNOTATION_VALUE: opsional. Peta pasangan nilai kunci anotasi teks bentuk bebas. Anda dapat menggunakannya untuk melampirkan informasi arbitrer yang terkait dengan resource. Untuk mengetahui informasi selengkapnya, lihat Anotasi.
• ENCRYPT_KEY: optional. Kunci Cloud KMS yang harus digunakan bus untuk enkripsi data dalam format projects/PROJECT_NAME/locations/LOCATION/keyRings/RING_NAME/cryptoKeys/KEY_NAME. Untuk informasi selengkapnya, lihat Menggunakan kunci enkripsi yang dikelola pelanggan.
• PROJECT_ID: project ID Google Cloud Anda.
• LOCATION: region tempat membuat bus—misalnya, us-central1.
• LOG_SEVERITY: optional. Tingkat keparahan minimum peristiwa yang dijelaskan dalam entri log. Salah satu dari: NONE, DEBUG, INFO, NOTICE, WARNING, ERROR, CRITICAL, ALERT, EMERGENCY. Defaultnya adalah NONE. Untuk mengetahui informasi selengkapnya, lihat LogSeverity.

Meminta isi JSON:

{
  "display_name": "BUS_NAME",
  "labels": {"LABEL_KEY":"LABEL_VALUE"},
  "annotations": {"ANNOTATION_KEY":"ANNOTATION_VALUE"},
  "cryptoKeyName": "ENCRYPT_KEY",
  "loggingConfig": {"logSeverity":"LOG_SEVERITY"}
}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

cat > request.json << 'EOF'
{
  "display_name": "BUS_NAME",
  "labels": {"LABEL_KEY":"LABEL_VALUE"},
  "annotations": {"ANNOTATION_KEY":"ANNOTATION_VALUE"},
  "cryptoKeyName": "ENCRYPT_KEY",
  "loggingConfig": {"logSeverity":"LOG_SEVERITY"}
}
EOF

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://eventarc.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/messageBuses?messageBusId=BUS_NAME"

@'
{
  "display_name": "BUS_NAME",
  "labels": {"LABEL_KEY":"LABEL_VALUE"},
  "annotations": {"ANNOTATION_KEY":"ANNOTATION_VALUE"},
  "cryptoKeyName": "ENCRYPT_KEY",
  "loggingConfig": {"logSeverity":"LOG_SEVERITY"}
}
'@  | Out-File -FilePath request.json -Encoding utf8

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://eventarc.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/messageBuses?messageBusId=BUS_NAME" | Select-Object -Expand Content

Jika berhasil, isi respons berisi instance Operation yang baru dibuat:

{
  "name": "projects/PROJECT_ID/locations/LOCATION/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.eventarc.v1.OperationMetadata",
    "createTime": "2024-01-25T17:17:45.782370139Z",
    "target": "projects/PROJECT_ID/locations/LOCATION/messageBuses/BUS_NAME",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

Konsol

1. Di konsol Google Cloud , buka halaman Eventarc > Bus.

   Buka Bus

   Halaman Bus details akan terbuka.

2. Klik delete Hapus.

3. Saat diminta untuk menghapus bus, untuk mengonfirmasi bahwa sumber pesan yang dikonfigurasi untuk menggunakan bus tidak akan dapat menggunakannya lagi, centang kotak Apakah Anda ingin melanjutkan?.

4. Untuk mengonfirmasi penghapusan, masukkan Delete.

5. Klik Hapus.

gcloud

1. Buka terminal.

2. Hapus bus menggunakan perintah gcloud beta eventarc message-buses delete.

   gcloud beta eventarc message-buses delete BUS_NAME \
       --location=REGION
   

   Ganti kode berikut:

   • BUS_NAME: ID atau ID yang memenuhi syarat sepenuhnya dari bus
   • REGION: lokasi yang didukung untuk bus

REST API

Untuk menghapus bus, gunakan metode projects.locations.messageBuses.delete.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

• PROJECT_ID: project ID Google Cloud Anda.
• LOCATION: region tempat bus dibuat—misalnya, us-central1.
• BUS_NAME: nama bus yang ingin Anda hapus.

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

curl -X DELETE \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://eventarc.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/messageBuses/BUS_NAME"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method DELETE `
    -Headers $headers `
    -Uri "https://eventarc.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/messageBuses/BUS_NAME" | Select-Object -Expand Content

Jika berhasil, isi respons berisi instance Operation yang baru dibuat:

{
  "name": "projects/PROJECT_ID/locations/LOCATION/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.eventarc.v1.OperationMetadata",
    "createTime": "2024-01-25T17:17:45.782370139Z",
    "target": "projects/PROJECT_ID/locations/LOCATION/messageBuses/BUS_NAME",
    "verb": "delete",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}