Share via

Azure-adattárak a Slacktel

  • Cikk

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

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

  1. Nyissa meg az Azure Repos Slack alkalmazást, és válassza a Hozzáadás a Slackhez lehetőséget.

    Képernyőkép a Slack-alkalmazás könyvtáráról, az Azure-adattárakról és a Hozzáadás a Slackhez gombról.

    A hozzáadás után a következő üdvözlőüzenethez hasonló üzenet érkezik.

    Képernyőkép a Slack üdvözlő üzenetéről.

  2. 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

  1. Csatlakozás és hitelesítse magát az Azure Reposban parancs használatával/azrepos signin.

    Képernyőkép a Slack bejelentkezési kéréséről.

  2. Válassza a Bejelentkezés lehetőséget.

  3. Fogadja el az Azure Repos Slack-integrációt.

    Képernyőkép az Elfogadás gombról, amely a bejelentkezési képernyőt eredményezte.

    Megjelenik egy ellenőrző kód a csevegőalkalmazásban a hitelesítés befejezéséhez.

  4. Másolja ki a hitelesítési kódot.

    Képernyőkép az Azure Repos által biztosított ellenőrző kódról.

  5. Válassza az Enter code,illessze be a kódot, majd válassza a Küldés lehetőséget.

    Képernyőkép a végső hitelesítési képernyőről az ellenőrző kód beillesztésekor, majd a Küldés gomb kiválasztásakor.

    A bejelentkezés visszaigazolása a csevegésen belül.

    Képernyőkép a bejelentkezés megerősítéséről a csevegésben.

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.

Képernyőkép az Alapértelmezett előfizetések létrehozási üzenetről.

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.

Képernyőkép az előfizetések listájának nézetéről.

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.

  1. Futtassa a következő parancsot: /azrepos subscriptions.
  2. 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.
  3. Válassza az Előfizetés hozzáadása gombot.
  4. Válassza ki a szükséges adattárat és a kívánt eseményt.
  5. 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

Képernyőkép: A Véleményező rendelkezik a csapatommal.

Példa: Mondja el, ha az egyesítési kísérletek szabályzatsértés miatt meghiúsulnak

Képernyőkép a sikertelen egyesítési kísérletről – szabályzat megsértése miatt.

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/pathkell 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.

Képernyőkép az URL-cím kibontásról.

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.

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.

Külső alkalmazáshozzáférés engedélyezése OAuth-on keresztül a szervezeti beállításhoz

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.

Válassza ki azt a könyvtárat, amely a projektet tartalmazó szervezetet tartalmazza

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.

Képernyőkép a kért alkalmazásengedélyek jóváhagyásáról.

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.