Azure-adattárak a Slacktel
Azure DevOps Services
Ha a Slacket használja, az Azure Repos alkalmazással könnyedén monitorozhatja az Azure-adattárakat. Beállíthatja és kezelheti az előfizetéseket, hogy értesítéseket kapjanak a csatornán a kód leküldésekor vagy beadásakor, valamint a lekéréses kérelmek (PR) létrehozásakor, frissítésekor vagy egyesítésekor. Ez az alkalmazás támogatja a Git és a Team Foundation verziókövetési (TFVC) eseményeit is.
Előfeltételek
- Ha előfizetéseket szeretne létrehozni egy Slack-csatornán az adattárral kapcsolatos eseményekhez, a Project Rendszergazda istrators csoport tagjának kell lennie, vagy csapatadminisztrátornak kell lennie. A hozzáadáshoz lásd: Projektszintű engedélyek módosítása vagy Csoportadminisztrátor hozzáadása.
- Az értesítések fogadásához engedélyezni kell a külső alkalmazás OAuth-beállításon keresztüli elérését a szervezet számára. További információ: Alkalmazáshozzáférési szabályzatok módosítása a szervezet számára.
Feljegyzés
- Az Azure Repos-alkalmazást a Slackhez jelenleg csak az Azure DevOps Services szolgáltatásban üzemeltetett projekthez kapcsolhatja.
- Az értesítések jelenleg nem támogatottak a közvetlen üzenetekben.
Az Azure Repos alkalmazás hozzáadása a Slack-munkaterülethez
Nyissa meg az Azure Repos Slack alkalmazást, és válassza a Hozzáadás a Slackhez lehetőséget.
A hozzáadás után a következő üdvözlőüzenethez hasonló üzenet érkezik.
Használja a
/azrepos
Slack-leírót az alkalmazással való interakcióhoz. A parancsok teljes listáját a jelen cikk Parancsok hivatkozási szakasza tartalmazza.
az Azure Repos alkalmazás Csatlakozás az adattárakba
Csatlakozás és hitelesítse magát az Azure Reposban parancs használatával
/azrepos signin
.Válassza a Bejelentkezés lehetőséget.
Fogadja el az Azure Repos Slack-integrációt.
Megjelenik egy ellenőrző kód a csevegőalkalmazásban a hitelesítés befejezéséhez.
Másolja ki a hitelesítési kódot.
Válassza az Enter code,illessze be a kódot, majd válassza a Küldés lehetőséget.
A bejelentkezés visszaigazolása a csevegésen belül.
A projekt összes Git-adattárának figyeléséhez használja a következő perjel parancsot egy csatornán belül:
/azrepos subscribe [project url]
A projekt URL-címe a projekt bármely oldalára lehet (kivéve az adattárak URL-címeit). Példa:
/azrepos subscribe https://dev.azure.com/myorg/myproject/
Egy adott adattárat az alábbi paranccsal is figyelhet:
/azrepos subscribe [repository url]
Az adattár URL-címe az adattár bármely olyan lapjára lehet, amely rendelkezik az adattár nevével. Git-adattárak esetén például használja a következőt:
/azrepos subscribe https://dev.azure.com/myorg/myproject/_git/myrepository
TFVC-adattárak esetén használja a következőt:
/azrepos subscribe https://dev.azure.com/myorg/myproject/_versionControl
Feljegyzés
Csak nyilvános adattárakra iratkozhat fel.
A feliratkozási parancs egy alapértelmezett előfizetéssel kezdi. A Git-adattárak esetében a csatorna előfizet a lekéréses kérelem által létrehozott eseményre (célág = fő), a TFVC-adattárak esetében pedig a csatorna előfizet az eseményben ellenőrzött kódra.
Előfizetések kezelése
Egy csatorna előfizetéseinek megtekintéséhez, hozzáadásához vagy eltávolításához használja a következő subscriptions
parancsot:
/azrepos subscriptions
Ez a parancs felsorolja a csatorna összes aktuális előfizetését, és lehetővé teszi új előfizetések hozzáadását vagy a meglévők eltávolítását. Előfizetések hozzáadásakor testre szabhatja a kapott értesítéseket különböző szűrők használatával, az alábbi szakaszban leírtak szerint.
Feljegyzés
A csapatgazdák nem távolíthatják el és nem módosíthatják a Projektgazdák által létrehozott előfizetéseket.
Előfizetések testreszabása szűrők használatával
Amikor egy felhasználó a parancs használatával /azrepos subscribe
előfizet egy adattárra, létrejön egy alapértelmezett előfizetés. A felhasználóknak gyakran testre kell szabni ezeket az előfizetéseket. Előfordulhat például, hogy a felhasználók csak akkor szeretnének értesítést kapni, ha a PRS-ek egy adott véleményezővel rendelkeznek.
Az alábbi lépések bemutatják, hogyan szabhatja testre az előfizetéseket.
- Futtassa a következő parancsot:
/azrepos subscriptions
. - Az előfizetések listájában, ha van egy nem kívánt vagy módosítani kívánt előfizetés (például: zaj létrehozása a csatornában), válassza az Eltávolítás gombot.
- Válassza az Előfizetés hozzáadása gombot.
- Válassza ki a szükséges adattárat és a kívánt eseményt.
- Válassza ki a megfelelő szűrőket.
Példa: Értesítések lekérése csak akkor, ha a csapatom szerepel a lekéréses kérelem véleményezői listájában
Példa: Mondja el, ha az egyesítési kísérletek szabályzatsértés miatt meghiúsulnak
Feljegyzés
- Az összes szűrő általában legördülő lista. Ha azonban a legördülő lista több mint 100 elemet tartalmaz, a felhasználóknak manuálisan kell megadniuk az értékeket.
- A beadott TFVC-kód esetében az Elérési út alatt szűrőnek formátumnak
$/myproject/path
kell lennie.
Lekéréses kérelem URL-címeinek előnézete
Amikor egy felhasználó beilleszti a lekéréses kérelem URL-címét, a következő képhez hasonló előnézet jelenik meg, amely segít a pr-hez kapcsolódó beszélgetések kontextusának és pontosságának megőrzésében.
Miután a felhasználók bejelentkeztek, ez a funkció a munkaterület összes csatornájához használható.
Előfizetések és adattárak eltávolítása egy csatornáról
Az alábbi paranccsal törölheti a csatornát az adattárak és előfizetések eltávolításával.
/azrepos unsubscribe all [project url]
A következő parancs például törli a projekt bármely adattárához kapcsolódó előfizetést, és eltávolítja az adattárakat a csatornáról. Ezt a parancsot csak a projektgazdák futtathatják.
/azrepos unsubscribe all https://dev.azure.com/myorg/myproject
Parancshivatkozás
Az alábbi táblázat felsorolja a /azrepos commands
Slack-csatornában használható összes funkciót.
Perjel parancs | Funkciók |
---|---|
/azrepos subscribe [adattár URL-címe/ projekt URL-címe] | Előfizetés egy adattárra vagy egy projekt összes adattárára értesítésekért |
/azrepos-előfizetések | Előfizetések hozzáadása vagy eltávolítása ehhez a csatornához |
/azrepos signin | Bejelentkezés az Azure Repos-szervezetbe |
/azrepos signout | Kijelentkezés az Azure Repos-szervezetből |
/azrepos visszajelzés | Probléma bejelentése vagy szolgáltatásra való javaslat |
/azrepos unsubscribe all [project URL] | Távolítsa el az összes (projekthez tartozó) adattárat és a hozzájuk tartozó előfizetéseket egy csatornáról |
Értesítések privát csatornákon
Az Azure Repos alkalmazással a privát csatornákon is figyelheti az adattáreseményeket. Hívja meg a robotot a privát csatornára a következő használatával /invite @azrepos
: . Ezután ugyanúgy kezelheti az értesítéseket, mint egy nyilvános csatornán.
Hibaelhárítás
Ha az Azure Repos 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.
- A konfiguráció nem sikerült. Győződjön meg arról, hogy a(z) {szervezet neve} szervezet létezik, és hogy rendelkezik-e megfelelő engedélyekkel.
Sajnáljuk, hiba történt. Próbálkozzon újra.
Az Azure Repos-alkalmazás az OAuth hitelesítési protokollt használja, és a szervezet engedélyezéséhez külső alkalmazáshozzáférést igényel az OAuthon keresztül. A beállítás engedélyezéséhez keresse meg a Szervezeti Gépház> Biztonsági>szabályzatokat, és állítsa be a külső gyártótól származó alkalmazások OAuthon keresztüli hozzáférését a szervezeti beállításhoz Be értékre.
A konfiguráció nem sikerült. Győződjön meg arról, hogy a(z) {szervezet neve} szervezet létezik, és hogy rendelkezik-e megfelelő engedélyekkel.
Jelentkezzen ki az Azure DevOpsból a böngésző használatára való navigálással https://aka.ms/VsSignout
.
Nyisson meg egy privát vagy inkognitó böngészőablakot, és keresse meg https://aex.dev.azure.com/me
és jelentkezzen be. A bal oldali profilikon alatti legördülő listában válassza ki azt a címtárat, amely tartalmazza azt az adattárat, amelyre elő szeretne fizetni.
Ugyanabban a böngészőben nyisson meg egy új lapot, navigáljon https://slack.com
, és jelentkezzen be a munkaterületre (webügyfél használata). Futtassa a /azrepos signout
parancsot, majd a /azrepos signin
parancsot.
Válassza ki a Sign in
gombot, és a rendszer átirányítja egy hozzájárulási lapra, mint az alábbi példában. Győződjön meg arról, hogy az e-mail mellett látható könyvtár megegyezik az előző lépésben kiválasztott könyvtárral. Fogadja el és fejezze be a bejelentkezési folyamatot.
Ha ezek a lépések nem oldják meg a hitelesítési problémát, forduljon hozzánk a Fejlesztői közösségnél.