Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Invia un messaggio al bus di servizio di Azure usando una connessione al servizio (non è necessario alcun agente).
Questa versione dell'attività supporta l'ID Entra e la federazione delle identità del carico di lavoro tramite l'input di connessione al servizio Azure Resource Manager (azureSubscription
). Per altre informazioni, vedere la sezione osservazioni seguente.
Sintassi
# Publish To Azure Service Bus v2
# Sends a message to Azure Service Bus using an Azure Resource Manager service connection (no agent is required).
- task: PublishToAzureServiceBus@2
inputs:
azureSubscription: # string. Alias: connectedServiceName. Required. Azure Resource Manager service connection.
serviceBusQueueName: # string. Required. Azure Service Bus Queue name.
serviceBusNamespace: # string. Required. Azure Service Bus Namespace.
#messageBody: # string. Message body.
#waitForCompletion: false # boolean. Wait for task completion. Default: false.
#useDataContractSerializer: true # boolean. Use .NET data contract serializer. Default: true.
# Advanced
#sessionId: # string. Session Id.
#signPayload: false # boolean. Sign the Message. Default: false.
#certificateString: # string. Required when signPayload = true. Certificate Variable.
#signatureKey: 'signature' # string. Optional. Use when signPayload = true. Signature Property Key. Default: signature.
Ingressi dati
azureSubscription
-
Connessione al servizio Azure Resource Manager
Alias di input: connectedServiceName
.
string
. Obbligatorio.
Specifica una connessione al servizio Azure Resource Manager.
serviceBusQueueName
-
Nome coda del bus di servizio di Azure
string
. Obbligatorio.
Specificare il nome della coda a cui è destinato il messaggio.
serviceBusNamespace
-
Spazio dei nomi del bus di servizio di Azure
string
. Obbligatorio.
Specificare lo spazio dei nomi del bus di servizio di Azure.
messageBody
-
corpo del messaggio
string
.
Specifica il messageBody
JSON .
sessionId
-
id sessione
string
.
Specifica l'ID sessione con cui viene pubblicato il messaggio. Per le code basate su sessione, la pubblicazione ha esito negativo se non viene specificato un valore. Per le code non basate su sessione, non è necessario specificare un valore.
signPayload
-
Firmare il messaggio
boolean
. Valore predefinito: false
Se impostato su true
, al messaggio verrà aggiunto un certificato privato.
certificateString
-
variabile di certificato
string
. Obbligatorio quando signPayload = true
.
Specifica la variabile segreta che contiene il contenuto del certificato. Può anche trattarsi di un certificato archiviato in un insieme di credenziali delle chiavi di Azure collegato a un gruppo di variabili usato dalla pipeline di versione.
signatureKey
-
della chiave della proprietà della firma
string
. Opzionale. Usare quando signPayload = true
. Valore predefinito: signature
In Proprietà messaggio specifica la chiave in cui si trova la firma. Se lasciato vuoto, il valore predefinito è signature
.
waitForCompletion
-
Attendere il completamento dell'attività
boolean
. Valore predefinito: false
Se impostato su true
, questa attività attenderà l'evento TaskCompleted per il timeout dell'attività specificato.
useDataContractSerializer
-
Usare il serializzatore del contratto dati .NET
boolean
. Valore predefinito: true
Impostare useDataContractSerializer
su false
se si vuole passare il messaggio come flusso anziché come oggetto .
Opzioni di controllo delle attività
Tutte le attività dispongono di opzioni di controllo oltre ai relativi input attività. Per altre informazioni, vedere Opzioni di controllo e proprietà comuni delle attività.
Variabili di uscita
Nessuno.
Osservazioni:
Usare questa attività in un processo senza agente di una pipeline di versione per inviare un messaggio a un bus di servizio di Azure usando una connessione al servizio (senza usare un agente).
Annotazioni
Può essere usato solo in un processo senza agente di una pipeline di versione.
Accedere al bus di servizio di Azure da Pipelines usando l'autenticazione Entra ID
È ora possibile usare l'autenticazione Entra ID per accedere al bus di servizio di Azure da Azure Pipelines. In questo modo è possibile sfruttare la federazione delle identità del carico di lavoro per rimuovere la gestione dei segreti e il controllo degli accessi in base al ruolo di Azure per il controllo degli accessi con granularità fine.
Alle identità che accedono al bus di servizio di Azure dovrà essere concesso uno dei ruoli predefiniti di Azure per il bus di servizio di Azure nel bus di servizio a cui si accede.
L'attività PublishToAzureServiceBus@2
può essere configurata usando una connessione al servizio Azure Resource Manager. Creare una connessione al servizio Azure Resource Manager e popolare le serviceBusQueueName
proprietà e serviceBusNamespace
dell'attività:
- task: PublishToAzureServiceBus@2
inputs:
azureSubscription: my-azure-service-connection
serviceBusQueueName: my-service-bus-queue
serviceBusNamespace: my-service-bus-namespace
useDataContractSerializer: false
messageBody: |
{
"property": "value"
}
Dove deve essere completato un segnale di attività?
Per segnalare il completamento, il servizio esterno deve inviare i dati di completamento POST all'endpoint REST delle pipeline seguente.
{planUri}/{projectId}/_apis/distributedtask/hubs/{hubName}/plans/{planId}/events?api-version=2.0-preview.1
**Request Body**
{ "name": "TaskCompleted", "taskId": "taskInstanceId", "jobId": "jobId", "result": "succeeded" }
Per informazioni specifiche, vedere questa semplice applicazione cmdline.
Inoltre, è disponibile una libreria helper C# per abilitare la registrazione in tempo reale e gestire lo stato dell'attività per le attività senza agente. Altre informazioni su attività senza agente HTTP asincrone.
Requisiti
Requisito | Descrizione |
---|---|
Tipi di pipeline | YAML, build classica, versione classica |
Viene eseguito in | Servidor |
Richieste | Nessuno |
Funzionalità | Questa attività non soddisfa alcuna richiesta di attività successive nel processo. |
restrizioni dei comandi | Qualunque |
variabili impostabili | Qualunque |
Versione agente | Tutte le versioni dell'agente supportate. |
Categoria attività | Utilità |