Creare un bus per instradare i messaggi

Console

1. Nella console Google Cloud , vai alla pagina Eventarc > Bus.

   Vai a Bus

2. Fai clic su add_box Crea bus.

3. Nella pagina Crea un bus:

   1. Inserisci un nome bus. Questo è l'ID del tuo autobus.
   2. (Facoltativo) Inserisci un Nome visualizzato del bus che viene visualizzato nella pagina Dettagli del bus.
   3. Nell'elenco Regione, seleziona una regione supportata in cui eseguire il deployment del bus.
   4. Nell'elenco Gravità log, seleziona la gravità minima per gli eventi descritti nelle voci di log. Il valore predefinito è Nessuno. Per ulteriori informazioni, vedi LogSeverity.
   5. Per la crittografia, accetta il valore predefinito Google-managed encryption key o seleziona Chiave Cloud KMS. Per saperne di più, consulta Utilizzare le chiavi di crittografia gestite dal cliente (CMEK).

   6. Se selezioni Chiave Cloud KMS, procedi nel seguente modo:

      1. Nell'elenco Tipo di chiave, seleziona un metodo per gestire le chiavi.

         Puoi gestire le chiavi manualmente o utilizzare Autokey, che ti consente di generare chiavi e chiavi automatizzate on demand. Se l'opzione Cloud KMS con Autokey è disabilitata, significa che non è ancora integrata nel tipo di risorsa attuale.

      2. In Seleziona una chiave Cloud KMS, seleziona una chiave.

         Tieni presente che devi selezionare una regione prima di poter visualizzare le chiavi gestite dal cliente.

      3. (Facoltativo) Per inserire manualmente il nome della risorsa della chiave, nell'elenco Seleziona una chiave gestita dal cliente, fai clic su Inserisci chiave manualmente e inserisci il nome della chiave nel formato specificato.

      4. Se richiesto, concedi il ruolo cloudkms.cryptoKeyEncrypterDecrypter all'agente di servizio Eventarc.

   7. (Facoltativo) Per aggiungere un'origine del messaggio, fai clic su add Aggiungi origine.

      1. Nel riquadro Aggiungi origine messaggio, per il fornitore di messaggi dell'API Google, accetta il valore predefinito google-api-source o inserisci un nome di origine diverso.

      2. Fai clic su Crea.

         In questo modo viene attivata la raccolta automatica degli eventi provenienti direttamente dalle origini Google.

         Tieni presente che vengono pubblicati solo gli eventi delle risorse nello stesso Google Cloud progetto del bus. Per ulteriori informazioni, vedi Pubblicare eventi da origini Google.

   8. (Facoltativo) Per aggiungere etichette, fai clic su add Aggiungi etichetta. Le etichette sono coppie chiave/valore che ti aiutano a organizzare le tue risorseGoogle Cloud . Per saperne di più, vedi Che cosa sono le etichette?

4. Fai clic su Crea.

gcloud

1. Apri un terminale.

2. Crea un bus utilizzando il comando gcloud beta eventarc message-buses create.

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

   Sostituisci quanto segue:

   • BUS_NAME: l'ID o l'identificatore completo del bus

   • REGION: una località supportata per l'autobus

     In alternativa, puoi impostare la proprietà della località di Google Cloud CLI:

     gcloud config set eventarc/location REGION
     

   (Facoltativo) Puoi anche utilizzare i seguenti flag:

   • --async per tornare immediatamente dal comando, senza attendere il completamento dell'operazione in corso.
   • --crypto-key per specificare il nome completo di una chiave di crittografia gestita dal cliente; se non specificato,vengono utilizzati Google-owned and managed keys .
   • --logging-config per configurare la gravità minima per gli eventi descritti nelle voci di log. Deve essere uno dei seguenti valori: NONE, DEBUG, INFO, NOTICE, WARNING, ERROR, CRITICAL, ALERT, EMERGENCY. Il valore predefinito è NONE. Per ulteriori informazioni, vedi LogSeverity.

API REST

Per creare un bus, utilizza il metodo projects.locations.messageBuses.create.

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

• BUS_NAME: il nome visualizzato del tuo bus, ad esempio my_bus.
• LABEL_KEY e LABEL_VALUE: facoltativi. Una mappa di coppie chiave-valore di etichette che ti aiutano a organizzare le tue Google Cloud risorse. Per saperne di più, vedi Che cosa sono le etichette?
• ANNOTATION_KEY e ANNOTATION_VALUE: facoltativi. Una mappa di coppie chiave-valore di annotazione di testo in formato libero. Puoi utilizzarli per allegare informazioni arbitrarie associate alla risorsa. Per ulteriori informazioni, consulta la sezione Annotazioni.
• ENCRYPT_KEY: facoltativo. Una chiave Cloud KMS che il bus deve utilizzare per la crittografia dei dati nel formato projects/PROJECT_NAME/locations/LOCATION/keyRings/RING_NAME/cryptoKeys/KEY_NAME. Per saperne di più, vedi Utilizzare le chiavi di crittografia gestite dal cliente.
• PROJECT_ID: il tuo ID progetto Google Cloud.
• LOCATION: la regione in cui creare il bus, ad esempio us-central1.
• LOG_SEVERITY: facoltativo. La gravità minima dell'evento descritto in una voce di log. Uno tra: NONE, DEBUG, INFO, NOTICE, WARNING, ERROR, CRITICAL, ALERT, EMERGENCY. Il valore predefinito è NONE. Per ulteriori informazioni, vedi LogSeverity.

Corpo JSON della richiesta:

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

Per inviare la richiesta, espandi una di queste opzioni:

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

In caso di esito positivo, il corpo della risposta contiene un'istanza appena creata di Operation:

{
  "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
}

Console

1. Nella console Google Cloud , vai alla pagina Eventarc > Bus.

   Vai a Bus

   Viene visualizzata la pagina Dettagli bus.

2. Fai clic su delete Elimina.

3. Quando ti viene chiesto di eliminare il bus, per confermare che le origini dei messaggi configurate per utilizzare il bus non potranno più farlo, seleziona la casella di controllo Vuoi procedere?.

4. Per confermare l'eliminazione, inserisci Delete.

5. Fai clic su Elimina.

gcloud

1. Apri un terminale.

2. Elimina un bus utilizzando il comando gcloud beta eventarc message-buses delete.

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

   Sostituisci quanto segue:

   • BUS_NAME: l'ID o l'identificatore completo del bus
   • REGION: la località supportata per l'autobus

API REST

Per eliminare un bus, utilizza il metodo projects.locations.messageBuses.delete.

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

• PROJECT_ID: il tuo ID progetto Google Cloud.
• LOCATION: la regione in cui viene creato il bus, ad esempio us-central1.
• BUS_NAME: il nome del bus che vuoi eliminare.

Per inviare la richiesta, espandi una di queste opzioni:

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

In caso di esito positivo, il corpo della risposta contiene un'istanza appena creata di Operation:

{
  "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
}