Megosztás a következőn keresztül:


Szolgáltatáshook-fogyasztók

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2020

Szolgáltatáshook használatával műveletet hajthat végre egy fogyasztói szolgáltatáson, ha egy Azure DevOps-projektben esemény történik. A szolgáltatáshook például értesítheti a felhasználót, ha egy build meghiúsul.

Szolgáltatáshook konfigurálásához létre kell hoznia egy előfizetést, amely meghatározza az eseményt, a fogyasztót és a műveletet. Egyes felhasználók esetében a fogyasztói szolgáltatásban hozhat létre előfizetést, nem pedig az Azure DevOpsban. Ez a cikk tájékoztatást nyújt arról, hogy milyen fogyasztói beállításokat használ, amikor programozott módon hoz létre előfizetést az Azure DevOpsban.

Az előfizetés Azure DevOpsban való létrehozásakor a következő felhasználók közül választhat:

Ezekről a fogyasztókról és a szolgáltatáshookokkal integrálható más felhasználókról további információt az Elérhető szolgáltatások című témakörben talál.

Azure Service Bus

A Service Bus egy üzenetkezelési szolgáltatás, amely megkönnyíti az alkalmazások és szolgáltatások közötti aszinkron kommunikációt. Szolgáltatáshook-fogyasztóként integrációt biztosít a Service Bus-üzenetsorokkal és -témakörökkel, valamint az Azure Notification Hubs szolgáltatással is.

Üzenet küldése értesítési központba

Ez a művelet általános sablonértesítést küld a Notification Hubs egy adott példányának.

  • Fogyasztói azonosító: azureServiceBus

  • Műveletazonosító: serviceBusNotificationHubSend

  • Támogatott események: Minden esemény

  • Beállítások:

    Bemeneti azonosító Név Leírás Adattípus Kötelező
    connectionString SAS-kapcsolati karakterlánc A Service Bushoz való csatlakozáshoz használandó közös hozzáférési aláírás (SAS) kapcsolati karakterlánc. Ez a kapcsolati sztring az Azure Portalon érhető el. string Igen
    notificationHubName Értesítési központ neve Annak az értesítési központnak a neve, amelybe el szeretné küldeni az értesítést. A név csak betűket, számokat, pontokat, kötőjeleket, perjeleket és aláhúzásjeleket tartalmazhat. A névnek betűvel vagy számmal kell kezdődnie és végződnie. A központnak már léteznie kell. string Igen
    tagsExpression Címkék Egy címkekifejezés, amely egy adott eszközkészletet céloz meg. További információért lásd: Útválasztás és címkekifejezések. string Nem

Üzenet küldése a Service Bus üzenetsorba

Ez a művelet egy esemény JSON-sztring-ábrázolását küldi el egy adott Service Bus-üzenetsorba. További információért lásd: Service Bus üzenetsorok, témakörök és előfizetések.

  • Fogyasztói azonosító: azureServiceBus

  • Műveletazonosító: serviceBusQueueSend

  • Támogatott események: Minden esemény

  • Beállítások:

    Bemeneti azonosító Név Leírás Adattípus Kötelező
    AuthenticationMechanismInputId Hitelesítési mód A használni kívánt hitelesítési mód: kapcsolati sztring vagy szolgáltatáskapcsolat. string Nem
    ServiceConnectionInputId Azure Resource Manager-kapcsolatok Egy szolgáltatáskapcsolat azonosítója. string Nem
    ServiceBusHostNameInputId Service Bus-gazdagép neve A gazdagép neve az Azure Portalon, formátumban sb://<Service-Bus-name>.servicebus.windows.net. string Nem
    connectionString SAS-kapcsolati karakterlánc A Service Bushoz való csatlakozáshoz használandó SAS kapcsolati sztring. Ez a kapcsolati sztring az Azure Portalon érhető el. string Nem
    queueName Üzenetsor neve Annak az üzenetsornak a neve, amelybe az üzenetet el szeretné küldeni. A név csak betűket, számokat, pontokat, kötőjeleket, perjeleket és aláhúzásjeleket tartalmazhat. A névnek betűvel vagy számmal kell kezdődnie és végződnie. Ha az üzenetsor nem létezik, akkor akkor jön létre, ha a megadott kapcsolati sztring rendelkezik a szükséges engedélyekkel. string Igen
    bypassSerializer Küldés nemszerializált karakterláncként Lehetőség arra, hogy az üzeneteket a Service Busba nem szerializált sztringként, hanem nem .NET szerializált sztringként küldje el. Akkor válassza ezt a beállítást, ha a fogadó nem .NET-ügyfél, például amikor az ügyfél az Azure Client Library for Node-t használja. boolean Nem
    resourceDetailsToSend Elküldendő erőforrás részletei Az üzenetsorba küldendő erőforrásmezők száma. A lehetőségek a következők: összes mező, minimális szám és egyik sem. string Nem
    messagesToSend Elküldendő üzenetek Az üzenetsorba küldendő üzenetek típusai. string Nem
    detailedMessagesToSend Részletes elküldendő üzenetek Az üzenetsorba küldendő részletes üzenetek típusai. string Nem

Üzenet küldése Service Bus-témakörnek

Ez a művelet egy esemény JSON-sztring-ábrázolását küldi el egy adott Service Bus-témakörnek. További információ: Service Bus-témakör és előfizetések létrehozása az Azure Portalon.

  • Fogyasztói azonosító: azureServiceBus

  • Műveletazonosító: serviceBusTopicSend

  • Támogatott események: Minden esemény

  • Beállítások:

    Bemeneti azonosító Név Leírás Adattípus Kötelező
    AuthenticationMechanismInputId Hitelesítési mód A használni kívánt hitelesítési mód. string Nem
    ServiceConnectionInputId Azure Resource Manager-kapcsolatok Egy szolgáltatáskapcsolat azonosítója. string Nem
    ServiceBusHostNameInputId Service Bus-gazdagép neve A gazdagép neve az Azure portálon, az alábbi formában: sb://{Service-Bus-name}.servicebus.windows.net. string Nem
    connectionString SAS-kapcsolati karakterlánc A Service Bushoz való csatlakozáshoz használandó SAS kapcsolati sztring. Ez a kapcsolati sztring az Azure Portalon érhető el. string Nem
    topicName Témakör neve Annak a témakörnek a neve, amelybe el szeretné küldeni az üzenetet. A név csak betűket, számokat, pontokat, kötőjeleket, perjeleket és aláhúzásjeleket tartalmazhat. A névnek betűvel vagy számmal kell kezdődnie és végződnie. Ha a témakör nem létezik, akkor akkor jön létre, ha a megadott kapcsolati sztring rendelkezik a szükséges engedélyekkel. string Igen
    bypassSerializer Küldés mint nemszerializált karakterlánc Lehetőség arra, hogy az üzeneteket a Service Busba nem szerializált sztringként küldje el, ahelyett hogy .NET szerializált sztringként küldené. Akkor válassza ezt a beállítást, ha a fogadó nem .NET-ügyfél, például amikor az ügyfél az Azure Client Library for Node-t használja. boolean Nem
    resourceDetailsToSend Elküldendő erőforrás részletei A témakörbe küldendő erőforrásmezők száma. A lehetőségek mind mezők, minimális szám és egyik sem. string Nem
    messagesToSend Elküldendő üzenetek A témakörbe küldendő üzenetek típusai. string Nem
    detailedMessagesToSend Részletes elküldendő üzenetek A témakörbe küldendő részletes üzenetek típusai. string Nem

Azure Storage

A storage egy felhőalapú tárolási megoldás különböző típusú adatokhoz. Az Azure Queue Storage a Storage része, amely olyan üzenetsorokat biztosít, amelyek szolgáltatáshook-fogyasztóként működhetnek.

Üzenet beszúrása a Storage üzenetsorba

Ez a művelet egy esemény JSON-sztring-ábrázolását szúrja be egy adott Storage-üzenetsorba. További információ: Mi az Az Azure Queue Storage?

  • Fogyasztói azonosító: azureStorageQueue

  • Műveletazonosító: enqueue

  • Támogatott események: Minden esemény

  • Beállítások:

    Bemeneti azonosító Név Leírás Adattípus Kötelező
    AuthenticationMechanismInputId Hitelesítési mód A használni kívánt hitelesítési mód. string Nem
    ServiceConnectionInputId Azure Resource Manager-kapcsolatok Egy szolgáltatáskapcsolat azonosítója. string Nem
    accountName Tárfiók neve A név, amely a tárfiókhoz társul. Ez a név az Azure Portalon érhető el. string Igen
    accountKey Tárfiók kulcsa A(z) Tárfiókhoz társított kulcs. string Nem
    queueName Üzenetsor neve A tárolón belül használandó üzenetsor neve csak kisbetűket tartalmaz. Ha még nem létezik, létrejön egy ilyen nevű várólista. string Igen
    visiTimeout Üzenet láthatósági időkorlát A lekérdezett üzenet láthatósági időtúllépési értéke másodpercben, a kiszolgáló idejéhez viszonyítva. Az értéknek 0-nál nagyobbnak vagy egyenlőnek kell lennie, és nem lehet nagyobb hét napnál vagy 604 800 másodpercnél. A láthatósági időtúllépést olyan értékre kell állítani, amely kisebb, mint az üzenet élettartamának értéke. number Igen
    ttl Üzenet élettartamának beállítása Az sorban álló üzenet élettartama másodpercben. A maximálisan használható érték hét nap, azaz 604 800 másodperc. number Igen
    resourceDetailsToSend Elküldendő erőforrás részletei Az sorba küldendő erőforrásmezők száma. A lehetőségek: bármilyen mező, minimális szám, és egyik sem. string Nem
    messagesToSend Elküldendő üzenetek Az üzenetsorba küldendő üzenetek típusai. string Nem
    detailedMessagesToSend Részletes elküldendő üzenetek Az üzenetsorba küldendő részletes üzenetek típusai. string Nem

Bambusz

A Bambusz az Atlassian folyamatos integrációs kiszolgálója.

Build hozzáadása a várólistához

Ez a művelet egy Bamboo buildet készenléti sorba állít.

  • Fogyasztói azonosító: bamboo

  • Műveletazonosító: queueBuild

  • Támogatott események: git.push, , build.completetfvc.checkin

  • Beállítások:

    Bemeneti azonosító Név Leírás Adattípus Kötelező
    serverBaseUrl Bambusz alap URL-címe A Bamboo-kiszolgáló hostnevét tartalmazó URI. uri Igen
    basicAuthCredentials Alapvető hitelesítési adatok A bambuszkiszolgálón való hitelesítéshez használt szabványos hitelesítő adatok. A hitelesítő adatok egyszerű szöveges küldésének elkerülése érdekében a HTTPS protokoll használatával titkosíthatja a hitelesítő adatokat a Transport Layer Security (TLS) használatával. Szolgáltatásnevek és felügyelt identitások használatát javasoljuk az Azure DevOpsban. string Igen
    planName Terv Az üzenetsorba felvenni kívánt terv neve. string Igen

Datadog

A Datadog egy monitorozási és elemzési platform felhőkörnyezetekhez.

Esemény közzététele a Datadogban

Ez a művelet létrehoz egy eseményt és a megfelelő metrikákat a Datadogban.

  • Fogyasztói azonosító: datadog

  • Műveletazonosító: postEventInDatadog

  • Támogatott események: Minden esemény

  • Beállítások:

    Bemeneti azonosító Név Leírás Adattípus Kötelező
    apiKey Datadog API-kulcs A Datadog-fiók hozzáférési kulcsa. Az API-kulcsot a Datadog portálon találja. Nyissa meg a profilját, majd válassza a Szervezeti beállítások>API-kulcsokat. string Igen
    accountType Datadog-fiók típusa A Datadog-fiók típusa. A fiók típusát a Datadog-fiók által használt URL-cím állomásneve alapján határozhatja meg:
    - app.datadoghq.com: US
    - app.datadoghq.eu: EU
    - us3.datadoghq.com: US3
    - us5.datadoghq.com: US5
    - ap1.datadoghq.com: AP1
    - app.dog-gov.com: GOV
    string Igen

Grafana

A Grafana egy nyílt forráskódú irányítópult és gráfszerkesztő.

Széljegyzet hozzáadása Grafana-adatbázishoz

Ez a művelet egy széljegyzetet hoz létre a Grafana alkalmazásban.

  • Fogyasztói azonosító: grafana

  • Műveletazonosító: addAnnotation

  • Támogatott események: ms.vss-release.deployment-completed-event

  • Beállítások:

    Bemeneti azonosító Név Leírás Adattípus Kötelező
    url Grafana URL A széljegyzetek Grafana-ban való közzétételéhez használandó URL-cím. uri Igen
    apiToken API-jogkivonat A Grafana-adatbázisba történő jegyzetelés hozzáférési jogkivonata. A jogkivonatok létrehozásával kapcsolatos információkért tekintse meg a Szolgáltatásfiók jogkivonatok és irányítópultok létrehozása szervezetek számára című leírást. string Igen
    tags Címkék A széljegyzetek hozzáadásához használandó címkék vesszővel tagolt listája. string Igen
    annotationDeploymentDurationWindow Az üzembe helyezés időtartamának megjegyzése Lehetőség a széljegyzetek időtartamablakának konfigurálására.
    – Ha ki van választva, a széljegyzet az üzembe helyezés kezdete és befejezése közötti időre vonatkozik.
    – Ha nincs kiválasztva, a megjegyzés az üzembe helyezés befejezésére vonatkozik.
    boolean Nem
    text Szöveg Egyéni leírás egy széljegyzethez. Ha nincs megadva, ez a beállítás a kiadást és az állapotot írja le. Ez a beállítás tartalmazhat hivatkozásokat, például <a href="https://www.contoso.com" target="_blank">Contoso</a>. string Nem
    dashboardId Irányítópult Az annotáció hozzáadásához szükséges az irányítópult azonosítója. Ha nincs megadva azonosító, a széljegyzet globális szinten lesz hozzáadva. string Nem

Jenkins

A Jenkins egy folyamatos integrációs kiszolgáló, amellyel folyamatosan fejleszthet és tesztelhet szoftverprojekteket.

Git-build aktiválása

Ez a művelet a Jenkins Git beépülő modult használja egy Git-adattár buildjének aktiválásához.

  • Fogyasztói azonosító: jenkins

  • Műveletazonosító: triggerGitBuild

  • Támogatott események: git.push, git.pullrequest.merged

  • Beállítások:

    Bemeneti azonosító Név Leírás Adattípus Kötelező
    serverBaseUrl Jenkins alapértelmezett URL-címe A Jenkins-kiszolgáló hostnevét tartalmazó URI. uri Igen
    basicAuthCredentials Alapvető hitelesítési adatok Szabványos HTTP-hitelesítési hitelesítő adatok. A hitelesítő adatok egyszerű szöveges küldésének elkerülése érdekében a HTTPS protokoll használatával titkosítja a hitelesítő adatokat tLS-en keresztül. Szolgáltatásnevek és felügyelt identitások használatát javasoljuk az Azure DevOpsban. string Igen
    useTfsPlugin Integrációs szint A kiválasztott integrációs szint, amely két érték egyike:
    - A beépített Jenkins API
    – Az Azure DevOps Server beépülő modul által biztosított kiterjesztett integráció, ha a beépülő modul telepítve van a Jenkins-kiszolgálón
    string Nem

Általános összeállítás indítása

Ez a művelet elindít egy általános Jenkins-buildet, amely meghívja a Jenkins build URL-címét.

  • Fogyasztói azonosító: jenkins

  • Műveletazonosító: triggerGenericBuild

  • Támogatott események: git.push, git.pullrequest.merged, build.complete, tfvc.checkinms.vss-release.deployment-completed-event

  • Beállítások:

    Bemeneti azonosító Név Leírás Adattípus Kötelező
    serverBaseUrl Jenkins alapértelmezett URL-címe A Jenkins-kiszolgáló gazdagépnevét tartalmazó URI. uri Igen
    basicAuthCredentials Alapvető hitelesítési adatok Szabványos HTTP-hitelesítési hitelesítő adatok. A hitelesítő adatok egyszerű szöveges küldésének elkerülése érdekében a HTTPS protokoll használatával titkosítja a hitelesítő adatokat tLS-en keresztül. Szolgáltatásnevek és felügyelt identitások használatát javasoljuk az Azure DevOpsban. string Igen
    buildName Építés Az aktiválandó build neve. string Igen
    useTfsPlugin Integrációs szint A kiválasztott integrációs szint, amely két érték egyike:
    - A beépített Jenkins API
    – Az Azure DevOps Server beépülő modul által biztosított kiterjesztett integráció, ha a beépülő modul telepítve van a Jenkins-kiszolgálón
    string Nem
    buildAuthToken Építési token Egy build engedélyezési jogkivonata. Csak azok a felhasználók aktiválhatják távolról a buildet, akik ismerik a tokent. string Nem
    buildParameterized Paraméterek elfogadása Egy beállítás, amely meghatározza, hogy a build elfogadja-e a paramétereket. boolean Nem
    buildParams Buildparaméterek Paraméterek összeállítása név-érték párok formájában. Minden párban a nevet és az értéket kettőspont választja el egymástól, például <parameter>:<value>. Minden név-érték pár a saját sorában jelenik meg. string Nem

Slack

A Slack egy kereshető platform a csapatkommunikációhoz.

Üzenet közzététele egy csatornán

Ez a művelet egy eseményről szóló üzenetet tesz közzé egy Slack-csatornán. További információ: Szolgáltatáshook létrehozása az Azure DevOpshoz a Slacktel.

  • Fogyasztói azonosító: slack

  • Műveletazonosító: postMessageToChannel

  • Támogatott események: Minden esemény

  • Beállítások:

    Bemeneti azonosító Név Leírás Adattípus Kötelező
    url Slack webhook URL A Slack által a HTTP POST-kérelmek küldéséhez megadott webhook URL-cím. uri Igen

Trello

A Trello egy projektkezelő eszköz, amely táblákat, listákat és kártyákat használ a csapatok munkafolyamatainak nyomon követéséhez.

Kártya létrehozása

Ez a művelet létrehoz egy kártyát egy meglévő listán Trello-ban. A kártyák feladatokat, problémákat, eseményeket vagy más projekthez kapcsolódó elemeket jelölhetnek. További információ: Szolgáltatáshoom létrehozása az Azure DevOps Serviceshez és a TFS-hez a Trello használatával.

  • Fogyasztói azonosító: trello

  • Műveletazonosító: createCard

  • Támogatott események: Minden esemény

  • Beállítások:

    Bemeneti azonosító Név Leírás Adattípus Kötelező
    userToken Felhasználói jogkivonat Egy felhasználói jogkivonat, amely hozzáférést biztosít a Trello-erőforrásokhoz. Jogkivonat beszerzéséhez lépjen a Trello engedélyezési oldalára. string Igen
    boardId Testület Annak a táblának a neve, amelyen a Trello-kártya létrejön. string Igen
    listId Lista Annak a listának a neve, amelyen a Trello-kártya létrejön. string Igen
    labels Címkék A létrehozott kártyára alkalmazandó címkeszínek vesszővel tagolt listája. Az érvényes címkeszínek a következőkred: , orange, yellow, greenblueés purple. string Nem
    addToTop Létrehozás a lista elején Egy lehetőség, amely jelzi, hogy létre kell-e hozni a kártyát a Trello lista elején vagy végén. Amikor ez a mező true, a kártya az elején kerül létrehozásra. boolean Nem
    cardName Kártya neve Az új kártya neve. Alapértelmezés szerint az esemény szöveges leírása lesz a név. Helyőrzőkkel beszúrhat tartalmat az eseményből a névbe. További információ: Szolgáltatáshoom létrehozása az Azure DevOps Serviceshez és a TFS-hez a Trello használatával. string Nem
    cardDescription Kártya leírása Az új kártya leírása. Alapértelmezés szerint az esemény részletes Markdown-leírása lesz a leírás. Helyőrzőkkel beszúrhat tartalmat az eseményből a leírásba. További információ: Szolgáltatáshoom létrehozása az Azure DevOps Serviceshez és a TFS-hez a Trello használatával. string Nem

Lista létrehozása

Ez a művelet létrehoz egy listát egy meglévő táblán Trello-ban. A listák a kártyák táblán való rendszerezésére szolgálnak, és általában egy állapotot jelölnek. További információ: Szolgáltatáshoom létrehozása az Azure DevOps Serviceshez és a TFS-hez a Trello használatával.

  • Fogyasztói azonosító: trello

  • Műveletazonosító: createList

  • Támogatott események: Minden esemény

  • Beállítások:

    Bemeneti azonosító Név Leírás Adattípus Kötelező
    userToken Felhasználói jogkivonat Egy felhasználói jogkivonat, amely hozzáférést biztosít a Trello-erőforrásokhoz. Jogkivonat beszerzéséhez lépjen a Trello engedélyezési oldalára. string Igen
    boardId Testület Annak a táblának a neve, amelyen a Trello-lista létrejön. string Igen
    addToBottom Hozzon létre a tábla aljára Egy lehetőség, amely azt jelzi, hogy a kártya a tábla elején vagy végén legyen-e létrehozva. Ha ez a mező true, a kártya a végén létrehozásra kerül. boolean Nem
    listName Lista neve Az új lista neve. Alapértelmezés szerint az esemény szöveges leírása lesz a név. Helyőrzőkkel beilleszthet tartalmat az eseményből az elnevezésbe. További információ: Szolgáltatáshoom létrehozása az Azure DevOps Serviceshez és a TFS-hez a Trello használatával. string Nem

Webhookok

A webhookok lehetővé teszik az Azure DevOps-események JSON-ábrázolását bármely nyilvános végponttal rendelkező szolgáltatásnak.

Közzététel HTTP-en keresztül

Ez a művelet egy esemény JSON-objektumábrázolását jeleníti meg egy megadott URL-címre. HTTPS-végpontok ajánlottak az eseményterhelésben található esetleges privát adatok miatt. További információkért lásd: Webhookok.

  • Fogyasztói azonosító: webHooks

  • Műveletazonosító: httpRequest

  • Támogatott események: Minden esemény

  • Beállítások:

    Bemeneti azonosító Név Leírás Adattípus Kötelező
    url URL A HTTP POST küldésének URL-címe. uri Igen
    acceptUntrustedCerts Nem megbízható SSL-tanúsítványok elfogadása Lehetőség arra, hogy ne igényeljön megbízható SSL-tanúsítványt egy végponthoz. Ezt a lehetőséget csak a fejlesztés és tesztelés során használhatja. boolean Nem
    basicAuthCredentials Alapvető hitelesítési adatok Szabványos HTTP-hitelesítési hitelesítő adatok. A hitelesítő adatok egyszerű szöveges küldésének elkerülése érdekében a HTTPS protokoll használatával titkosítja a hitelesítő adatokat tLS-en keresztül. Szolgáltatásnevek és felügyelt identitások használatát javasoljuk az Azure DevOpsban. string Igen
    httpHeaders HTTP-fejlécek HTTP-fejléckulcsok és értékek kulcs-érték párok formájában. Minden párban a kulcsot és az értéket kettőspont választja el egymástól, például <key>:<value>. Minden kulcs-érték pár a saját sorában jelenik meg. Ezeket az értékeket bárki megtekintheti, aki hozzáfér a szolgáltatáshook-előfizetéshez. string Nem
    resourceDetailsToSend Elküldendő erőforrás részletei Az üzenetsorba küldendő erőforrásmezők száma. A lehetőségek mind mezők, minimális szám és egyik sem. string Nem
    messagesToSend Elküldendő üzenetek Az üzenetsorba küldendő üzenetek típusai. string Nem
    detailedMessagesToSend Részletes elküldendő üzenetek Az üzenetsorba küldendő részletes üzenetek típusai. string Nem

Zendesk

A Zendesk egy szolgáltatott szoftvercsomag (SaaS), amely ügyfélszolgálati jegyekkel, problémakövetéssel és ügyfélszolgálati támogatással rendelkezik.

Privát megjegyzés létrehozása jegyben

Ez a művelet létrehoz egy privát megjegyzést egy Zendesk-jegyben.

  • Fogyasztói azonosító: zendesk

  • Műveletazonosító: createPrivateComment

  • Támogatott események: workitem.commented

  • Beállítások:

    Bemeneti azonosító Név Leírás Adattípus Kötelező
    accountName Számla neve A Zendesk-fiók neve. A fiók nevét a Zendesk-fiók URL-címében találja, amelynek formátuma https://<account-name>.zendesk.com. string Igen
    username Felhasználónév Annak a Zendesk-felhasználónak a felhasználóneve, aki frissíti a jegyeket. string Igen
    apiToken API-jogkivonat A Zendesk API-jogkivonat. A jogkivonat megkereséséhez nyissa meg a Zendesk alkalmazást, majd válassza a Felügyeleti>csatornák>API-t. string Igen