Az Azure Pipelines használata a Slacktel

Azure DevOps Services

A Slackhez készült Azure Pipelines-alkalmazással a Slack-felhasználók egyszerűen nyomon követhetik a folyamatokon belüli eseményeket. Az alkalmazás lehetővé teszi a felhasználók számára, hogy előfizetéseket hozzanak létre és felügyeljenek különböző folyamateseményekhez, például buildekhez, kiadásokhoz, függőben lévő jóváhagyásokhoz stb. Ezekről az eseményekről a rendszer közvetlenül a felhasználók Slack-csatornáira küldi az értesítéseket

Megjegyzés:

Ez a funkció csak az Azure DevOps Servicesben érhető el. Az új funkciók általában először a felhőszolgáltatásban jelennek meg, majd a helyszínen elérhetővé válnak az Azure DevOps Server következő főverziójában vagy frissítésében. További információkért tekintse meg az Azure DevOps szolgáltatás ütemtervét.

Előfeltételek

  • A Slackben engedéllyel kell rendelkeznie ahhoz, hogy alkalmazást telepítsen a Slack-munkaterületre.
  • Az Azure DevOps esetében a Slack-előfizetés beállításához a Project Collection Rendszergazda istrators vagy Project Rendszergazda istrators csoportjában kell lennie.

Az Azure Pipelines alkalmazás telepítése

Lépjen az Azure Pipelines Slack-alkalmazásra , és telepítse az Azure Pipelines alkalmazást a Slack-munkaterületre. A hozzáadás után megjelenik egy üdvözlő üzenet az alkalmazásból az alábbiak szerint. Használja a /azpipelines leírót az alkalmazással való interakció megkezdéséhez.

A screenshot showing the Azure Pipelines app welcome message.

Csatlakozás a folyamathoz

Miután telepítette az alkalmazást a Slack-munkaterületen, bármely figyelni kívánt folyamathoz csatlakoztathatja az alkalmazást. A parancsok futtatása előtt a rendszer kérni fogja, hogy hitelesítse magát az Azure Pipelinesban.

A screenshot showing the sign-in prompt message.

A projekt összes folyamatának figyeléséhez használja az alábbi perjel parancsot egy csatornán belül:

/azpipelines subscribe [project url]

A projekt URL-címe a projekt bármely oldalára hivatkozhat (kivéve az URL-címeket a folyamatokhoz). Például: /azpipelines subscribe https://dev.azure.com/myorg/myproject/

Egy adott folyamatot az alábbi paranccsal is monitorozhat:

/azpipelines subscribe [pipeline url]

A folyamat URL-címe a folyamat bármely oldalára hivatkozhat, amely rendelkezik vagy szerepel definitionIdbuildId/releaseId az URL-címben. Például: /azpipelines subscribehttps://dev.azure.com/myorg/myproject/_build?definitionId=123 , or: /azpipelines subscribe https://dev.azure.com/myorg/myproject/_release?definitionId=123& view=mine&_a=releases

A feliratkozási parancs alapértelmezés szerint elindít néhány előfizetést. Az alábbi folyamattípushoz engedélyezett alapértelmezett értesítések:

Folyamatok létrehozása Kiadási folyamatok YAML-folyamatok
Befejezett buildértesítés A kiadás üzembe helyezése elindult, a kiadás üzembe helyezése befejeződött, és a kiadás üzembe helyezésének jóváhagyása függőben lévő értesítésekben A futtatási fázis állapota módosult , a futtatási szakasz pedig várakozás a jóváhagyási értesítésekre

A screenshot showing notification example.

Előfizetések kezelése

Egy csatorna előfizetéseinek kezeléséhez használja a következő parancsot: /azpipelines subscriptions

Ez a parancs felsorolja a csatorna összes aktuális előfizetését, és lehetővé teszi előfizetések hozzáadását vagy eltávolítását.

Megjegyzés:

A csapatgazdák nem tudják eltávolítani vagy módosítani a Project-rendszergazdák által létrehozott előfizetéseket.

A screenshot showing a list of subscriptions.

Előfizetések testreszabása

Alapértelmezés szerint egy folyamatra való feliratkozáskor több olyan előfizetés jön létre, amely nem alkalmaz szűrőket. Gyakori azonban, hogy a felhasználók a saját igényeiknek megfelelően szeretnék személyre szabni ezeket az előfizetéseket. Előfordulhat például, hogy a felhasználók csak a sikertelen buildekről vagy az éles környezetben történő üzembe helyezésről szeretnének értesítést kapni. Az Azure Pipelines alkalmazás lehetővé teszi szűrők alkalmazását, így a felhasználók testre szabhatják a csatornájukban kapott üzeneteket. Előfizetés testreszabása:

  1. Futtassa a parancsot az /azpipelines subscriptions összes előfizetés listázásához.

  2. Select Add subscription.

  3. Válassza ki azt az eseményt, amelyre elő szeretne fizetni, majd válassza ki a kívánt konfigurációt.

  4. Ha végzett, válassza a Mentés lehetőséget.

Példa: Értesítések lekérése csak sikertelen buildekhez

A screenshot showing a list how to add a custom new subscription.

Üzemelő példányok jóváhagyása

A Slack-csatornán belüli üzembe helyezéseket anélkül hagyhatja jóvá, hogy az Azure Pipelines portálra navigálna, ha feliratkozik a kiadás üzembe helyezésének jóváhagyására függő értesítésekre (klasszikus kiadások), vagy a jóváhagyási értesítésekre váró futtatási szakaszra (YAML-folyamatok). A rendszer alapértelmezés szerint mindkét előfizetést létrehozza, amikor feliratkozik egy folyamatra.

A screenshot showing pipeline approval in Slack.

A Slackhez készült Azure Pipelines-alkalmazás lehetővé teszi az Azure Pipelines portálon elérhető összes ellenőrzési és jóváhagyási forgatókönyv kezelését. Ezek közé tartozik az egy jóváhagyó, a több jóváhagyó és a csapatalapú jóváhagyás. A kéréseket egyenként vagy egy csapat nevében is jóváhagyhatja.

A screenshot showing a predeployment pipeline approved in Slack.

Az összes előfizetés eltávolítása

A csatorna zsúfoltságának megszüntetéséhez az alábbi parancsokkal leiratkozhat a projekt összes folyamatáról. Például: /azpipelines unsubscribe all https://dev.azure.com/myorg/myproject.

/azpipelines unsubscribe all [project url]

Fontos

Ezt a parancsot csak projektgazdák hajthatják végre.

Parancsok hivatkozása

A Slackhez készült Azure Pipelines alkalmazás az alábbi parancsokat támogatja:

Perjel parancs Funkciók
/azpipelines subscribe [pipeline URL/project URL] Előfizetés egy folyamatra vagy egy projekt összes folyamatára értesítések fogadásához
/azpipelines-előfizetések Előfizetések hozzáadása vagy eltávolítása ehhez a csatornához
/azpipelines visszajelzés Probléma bejelentése vagy szolgáltatásra való javaslat
/azpipelines súgó Segítség kérése a perjelparancsokkal kapcsolatban
/azpipelines signin Bejelentkezés az Azure Pipelines-fiókba
/azpipelines-kijelentkezés Kijelentkezés az Azure Pipelines-fiókból
/azpipelines unsubscribe all [project URL] Az összes (projekthez tartozó) folyamat és a hozzájuk tartozó előfizetések eltávolítása egy csatornáról

Értesítések privát csatornákon

Az Azure Pipelines alkalmazás segítségével a privát csatornákon is nyomon követheti a folyamatok tevékenységeit. A robotot meg kell hívnia a privát csatornára a használatával /invite @azpipelines. A robot hozzáadása után ugyanúgy konfigurálhatja és szabályozhatja az értesítéseket, mint egy nyilvános csatornán.

Megjegyzés:

  • A Slackhez készült Azure Pipelines alkalmazást jelenleg csak az Azure DevOps Servicesben üzemeltetett projekttel használhatja.
  • A felhasználónak a folyamatot tartalmazó projekt rendszergazdájának kell lennie az előfizetések beállításához
  • Az értesítések jelenleg nem támogatottak a közvetlen üzenetekben
  • Azok az üzembehelyezési jóváhagyások, amelyeknél a jóváhagyási szabályzat végrehajtása előtt a jóváhagyó identitásának újraértékelése történik, nem támogatottak
  • Az "OAuthon keresztüli külső alkalmazáshozzáférést" engedélyezni kell a szervezet értesítéseinek fogadásához az Azure DevOpsban (Szervezet Gépház – Biztonság –>> Szabályzatok)

Hibaelhárítás

Ha az Azure Pipelines App for Slack használatakor a következő hibákat tapasztalja, kövesse az ebben a szakaszban ismertetett eljárásokat.

Sajnáljuk, hiba történt. Próbálkozzon újra

Az Azure Pipelines-alkalmazás az OAuth hitelesítési protokollt használja, és az OAuthon keresztüli külső alkalmazáshozzáférést követel meg. A beállítás engedélyezéséhez keresse meg a Szervezeti Gépház> Biztonsági>szabályzatokat, és kapcsolja be a külső alkalmazáshozzáférést az OAuthon keresztül a szervezet számára.

A screenshot showing how to enable third party access via OAuth.

A konfiguráció nem sikerült. Győződjön meg arról, hogy a szervezet létezik, és hogy rendelkezik-e megfelelő engedélyekkel

Jelentkezzen ki az Azure DevOpsból a következő URL-címre navigálva: https://aka.ms/VsSignout.

Nyisson meg egy privát/inkognitó böngészőablakot, és keresse meg https://aex.dev.azure.com/me és jelentkezzen be. Válassza ki azt a címtárat, amely azt a szervezetet tartalmazza, amelyre a feliratkozni kívánt folyamat található.

A screenshot showing how to select your pipeline directory.

Ugyanazzal a böngészővel nyisson meg egy új lapot, és nyissa meg a következőt https://slack.com: . Jelentkezzen be a munkaterületre a webes ügyféllel, majd futtassa a /azpipelines signout parancsot, majd a /azpipelines signin.

Válassza ki a Sign in gombot, és a rendszer átirányítja egy hozzájárulási oldalra az alábbi példában látható módon. Ellenőrizze, hogy az e-mail-cím mellett megjelenő könyvtár megegyezik-e az előző lépésben kijelölt könyvtárral. A bejelentkezési folyamat befejezéséhez válassza az Elfogadás lehetőséget.

A screenshot showing how to allow pipelines slack integration.