Közzétéve Gáspár Attila | 2016-05-09

A különbség aközött, hogy egy vagy két Atlassian alkalmazást használnunk nagyon nem csak abban nyilvánul meg, hogy második alkalmazás funkciókészlete is rendelkezésünkre áll. Az egyik legjelentősebb ereje az Atlassian ökoszisztémának a különféle integrációs megoldások. Ez az írás megpróbálja összefoglalni a legfontosabbakat a HipChat szemszögéből.

Az integrációt megelőzően

Eldöntendő, hogy globális vagy szoba alapú integrációt szeretnénk megvalósítani. A globális integráció minden szobára érvényes, a szoba szintű csak arra a szobára, melyben telepítésre kerül.

  • Globális integráció telepítése a Group admin > Integrations részben lehetséges. Itt a Find New oldalon a már meglévő integrációk is áttekinthetőek.
  • Szoba szintű integrációt a Group admin > Rooms > Integrations menü alatt hozhatunk létre.

Eszköz

Integrációs lehetőségek

Konfigurációs segédlet

JIRA Core
  • HipChat szobába értesítések érkezhetnek egy feladattal kapcsolatban
    • Létrehozáskor
    • A felelős megváltozásakor
    • Megjegyzés írásakor
    • Egy állapotátmenetet követően
  • Lehetőség van a JIRA-ban egy feladathoz kapcsolódó egyeztetések számára dedikált HipChat szoba létrehozására
  • JIRA feladatok, és Service Desk kérések előnézeti módban megtekinthetőek a HipChat szobában, ha valaki megemlíti őket

A JIRA és HipChat integráció a JIRA 6.4 és későbbi verziókban már elérhető. Korábbi verziók esetében vagy a legfrissebb integrációs plugin letöltéséhez a HipChat for JIRA segédlet nyújt támogatást.

Első lépésként bizonyosodjunk meg arról, hogy a JIRA és a HipChat szerver ugyanazon tűzfal mögött található (az integráció használja mind a pull, mind a push irányokat). A kapcsolati státusz a két alkalmazás között ellenőrizhető (Összekapcsolt, Korlátozott, Nincs kapcsolat, Ismeretlen)

Ezt követően a JIRA és a HipChat az alábbi lépések segítségével integrálható

  1. Lépjünk be JIRA vagy Projekt Adminisztrátorként
  2. JIRA administration console > Applications
  3. Integration részben válasszuk a HipChat-et
  4. Válasszuk a linket a Connect HipChat alatt
  5. Kövessük az instrukciókat a JIRA és a HipChat összekötéséhez
  6. Ha készen állunk akkor összeköthetőek a JIRA projektek HipChat szobákkal

JIRA projektek összeköthetőek egy vagy több HipChat szobával, így amikor egy feladat frissül, létrejön, értesítést kaphatunk a HipChat szobába.

  1. Lépjünk be JIRA vagy Projekt Adminisztrátorként
  2. Adminisztráció > Projektek részben
  3. Válasszuk a Projekteket
  4. A Projekt Adminisztráció részben a HipChat Integration opciót
  5. Válasszuk ki a megfelelő HipChat szobát, és kattintsunk a Hozzáad gombra
  6. Adjuk meg a feladat típusát, prioritását, vagy válasszuk a Haladó szekciót ahol JQL feltételt is megadhatunk
  7. Adjuk meg az eseményeket, melyek hatására értesítéseket szeretnénk kapni (feladat létrehozása, felelős módosítása, új megjegyzés, állapotátmenetek)
  8. WEB és IOS kliensek esetében lehetőség van a felhasználók figyelmeztetésére is (hangjelzéssel, felugró ablakokkal, flugró ikonnal).
  9. A változtatások automatikusan elmentésre kerülnek

Privát szobák

Meghívás alapú privát szobák esetében szükség van egy extra engedélyezésre a HipChat integrációs felületen. Amikor ez az extra autorizációs fázis megtörtént, akkor látszanak az olyan privát szobák a legördülőben, melynek az aktuális felhasználó tagja.Ha az integrációs megvalósult, akkor mindenki, aki a szoba tagja látni fogja az értesítéseket.

Ezen felül az alábbi beállítási lehetőségek végezhetőek el:

  • Előnézeti mód engedélyezése minden projektben
    • Ez a beállítás a Projet Adminisztráció részben felülbírálható
  • Előnézeti mód engeélyezése a vendég szobák számára
JIRA Software Hasonló funkcionalitás érhető el, mint JIRA Core esetében

Nem igényel JIRA Software specifikus beállításokat

Planning Poker (https://www.planningpoker.com/) for HipChat egy hamarosan kiadásra kerülő addon, mely nagyon izgalmas lehet agilis csapatok számára.

JIRA Service Desk Hasonló funkcionalitás érhető el, mint JIRA Core esetében Nem igényel Service Desk specifikus beállításokat.
Confluence
  • Munkaterület - Szoba szintű lehetőségek tekintetében értesítést kaphat egy szoba, ha
    • Egy oldal létrejön
    • Egy blogbejegyzés létrejön
  • Ki érhető el
    • Amennyiben egy felhasználó linkké alakított neve vagy megemlítésése fölé húzzuk az egeret megtudhatjuk, hogy elérhető-e HipChaten. A zöld, sárga és piros ikonok jelzik, hogy elérhető, távol van, vagy épp azt szeretné, hogy ne zavarják.
  • Első lépésként kössük össze a HipChat-et a Confluence-vel
    • Ehhez adminisztrátor joggal kell rendelkeznünk HipChat oldalon is
    • Confluence adminisztrátorként az Adminisztráció > General Configuration > HipChat Integration szekcióban kattintsunk a Connect HipChat linkre.
    • Munkaterület adminisztrátorként a Space Tools > Integration > HipChat a beállítások helye
      • Amennyiben a munkaterület a Documentation theme-t használja, akkor Browse > Space Admin > HipChat
    • Eközben a HipChatben Csoport Adminisztrátorként bejelentkezve kell lennünk
  • Munkaterület Adminisztrátor jogosultság szükséges az integrációhoz, valamint ha privát szobával szeretnénk integrálni a munkaterületet be kell jelentkeznünk a HipChat-be az integrációs felületen is.
  • A kapcsolat kiépítése után az értesítések beállítására a Space Tools > Integration > HipChat részben van lehetőség a kiválasztott szoba hozzáadásával
Bamboo

Az alábbi esetekben érkezhetnek értesítések a Bamboo felől egy szobába:

  • amikor egy build sikeresen vegződik vagy hibára fut
  • amikor a build felelősét kell értesíteni
  • amikor a korábban hibára futott build javítása sikeres volt
  • amikor a build egy kézi indítású lépését el kell indítani
  • amikor a Bamboo az automatizált telepítést elkezdi vagy befejezi

...és számos egyéb esemény hatására is.

A Bambbo értesítések beállításhoz az alábbi lépésekre van szükség:

  1. Adjuk meg a hipchat.api.url rendszer változóban a HipChat szerver elérhetőségét
  2. Állítsuk be az értesítéseket a Bambooban HipChat "Recipient type" segítségével
Bitbucket Server

A HipChat - Bitbucket Server integráció segítségével az alábbi események hatására kaphatunk értesítéseket a szobákban:

  • Pull requesteket
    • létrehozunk
    • megjegyzéssel látunk el
    • összefésülünk (merge)
    • visszautasítunki (decline)
  • Commitokat
    • végrehajtunk (push)
    • megjegyzéssel látunk el
  • A beállításokhoz válasszuk az Administration Settings > HipChat integration
  • Alul a Connect HipChat gombot megnyomva, adjuk meg a HipChat URL-jét, majd kattintsunk a Connect HipChat-re.
  • Jelentkezzünk be egy olyan HipChat felhasználóval, melynek adminisztrátor jogai vannak.
  • Kattintsunk az Install-ra, mellyel befejezzük a telepítést.
  • Válasszuk ki a repository-t melyből az értesítéseket küldeni akarjuk, és a HipChat szobát, ahová az értesítések érkezzenek.
    • Akár több szoba is megadható, de ezeket egyesével kell felvenni.
    • Ismételjük meg ezt a lépéssorozatot minden repository-nál, melyekről értesítéseket szeretnénk kapni.
Bitbucket Cloud

Bitbucket az alábbi esetekben tud értesítéseket küldeni egy HipChat szobába

  • Pull Requesteket
    • létrehozunk
    • megjegyzéssel látunk el
    • összefésülünk (merge)
    • visszautasítunk (decline)
  • Commitokat
    • végrehajtunk (push)
    • megjegyzéssel látunk el
  • Feladatokat
    • létrehozunk
    • módosítunk
    • megjegyzéssel látunk el
  • Bitbucket és HipChat integráció megvalósításához az alábbiak szükségesek:
    • HipChat hozzáférés ahhoz a szobához, ahol az értesítéseket szeretnénk megkapni
    • Bitbucket hozzáérés, mely rendelkezik az alábbiak egyikével
      • Egyéni hozzáférés: a repository tulajdonosának kell lennie nem elegendő az adminisztrátor jogosultság
      • Csapat hozzáférés: adminisztrátori hozzáférés szükséges a csapathoz ami a tulajdonosa a repository-nak , mellyel kapcsolatban az értesítéseket be akarjuk állítani.
  • Lehetséges integrációk
    • Csapat számára az integráció beállítására a Select Teams szekcióban a csapat nevének kiválasztását követően a Manage team részben van lehetőség, vagy a repository beállításokban.
    • Egyéni hozzáférés esetén az integráció a repository beállításokban valósítható meg.
    • Amennyiben midn csapat, mind egyéni hozzáféréssel rendelkezünk ne feledjük el beállítani mindkét esetben az integrációt
  • Az integráció lépései
    • Kattintsunk a HipChat integrációra
    • Majd az Install integration részen kövessük az instrukciókat
    • Válasszuk ki a repositoryt melyből az értesítéseket szeretnénk küldeni és a HipChat szobát, ahová ezek érkezzenek
      • Több szoba is kiválasztható, ahová az értesítések érkezzenek, de ezeket egyesével szükséges beállítani
      • Ismételjük meg ezeket a lépéseket az összes olyan repository-val, melyekről értesítést szeretnénk küldeni
    • Adjuk meg a kívánt értesítéseket

További információ

Az alábbi Atlassian dokumentációkban érhetőek el:

Ezeket a cikkeket is ajánljuk neked: