Како интегрисати ГитХуб са Слацк-ом користећи Слацк АПИ

Интеграција ГитХуб-а са Слацк-ом ће вам помоћи да поједноставите комуникацију свог тима тако што ћете их информисати о догађајима у спремишту у реалном времену. Ова интеграција помаже ефикаснијој сарадњи, дискусији о променама у контексту базе кода и брзом решавању свих проблема који се могу појавити током развоја.

Штавише, интеграција ГитХуб-а са Слацк-ом омогућава вам да прилагодите обавештења тако да одговарају јединственом току рада вашег тима. Ово минимизира ометања и фокусира се на оно што је заиста важно. Овај прилагођени приступ комуникацији оснажује ваш тим да доноси информисане одлуке и предузме правовремене акције, обезбеђујући резултат највишег квалитета.

Корак 1: Креирајте нову Слацк апликацију

Да бисте то урадили, требало би да вам буде удобно користећи Слацк платформу. Такође би требало да будете упознати са ГитХуб-ом.

Први корак интеграције је креирање нове Слацк апликације. Ова апликација ће бити одговорна за постављање порука на изабраном Слацк каналу када дође до догађаја у спремишту. Да бисте креирали нову апликацију, идите на

Слацк веб локација и пријавите се на свој налог. Затим креирајте нови радни простор. Користићете овај радни простор да тестирате своју апликацију пре него што је инсталирате у радни простор вашег тима.

Идите до Слацк АПИ веб локација у новој картици прегледача.

Кликните на Ваше апликације дугме. На страници која се појави кликните на Креирајте нову апликацију дугме.

Изаберите опцију да направите апликацију од нуле. Затим дајте назив својој апликацији и изаберите радни простор у који желите да је инсталирате.

Кликните на Креирајте апликацију дугме. Ова радња ће креирати вашу нову Слацк апликацију и преусмерити вас на њену контролну таблу.

Корак 2: Подесите Слацк долазни Вебхоок

Слацк Инцоминг Вебхоок вам омогућава да шаљете поруке из спољних извора у ваш Слацк радни простор. Да бисте подесили веб-хук, изаберите Инцоминг Вебхоокс одлика. Обавезно укључите Активирајте Инцоминг Вебхоокс дугме.

Померите се надоле до УРЛ адресе веб-хука за ваш радни простор одељак. Кликните на Додајте нови веб-хук у радни простор дугме.

Слацк ће тражити да изаберете канал на који ће ваша апликација објављивати поруке. Одаберите канал и кликните на Дозволи дугме.

Ово ће додати вашу апликацију на изабрани канал. Вратите се на УРЛ адресе веб-хука за ваш радни простор одељак. Копирајте генерисано Вебхоок УРЛ. Ово је УРЛ на који ће ГитХуб слати обавештења о догађајима у спремишту.

Сада сте завршили са конфигурисањем Слацк стране.

Корак 3: Конфигуришите ГитХуб репо

Идите до Веб локација ГитХуб и пријавите се на свој налог. Идите у спремиште из којег желите да примате обавештења о догађајима. Можете такође креирајте ново спремиште. Кликните на Акције картицу испод имена спремишта.

Затим кликните на сами поставите ток посла линк. Следећа страница која се појављује захтева да креирате ИАМЛ датотеку у ГитХуб директоријуму токова посла. Ова датотека дефинише радни ток ГитХуб Ацтионс одговоран за слање обавештења у ваш Слацк радни простор.

Написаћете ИАМЛ код у интегрисаном уређивачу. Овај код ће интегрисати ГитХуб са Слацк-ом слањем обавештења на Слацк канал када се одређени догађаји догоде у спремишту.

Комплетан изворни код који се користи у овом чланку доступан је у а ГитХуб спремиште.

Корак 4: Напишите ИАМЛ код за интеграцију ГитХуб-а са Слацк-ом

Именујте свој ток посла. Слободно изаберите име по свом укусу.

име:СлацкНотифицатион

Наведите догађаје који ће покренути ток посла. Овде бирате догађаје о којима желите да ваш тим буде обавештен. Додајте или уклоните догађаје у складу са вашим захтевима.

на:
гурати:
пулл_рекуест:
питања:
врсте:
-отворен
-затворено
-поново отворен
-едитед
-избрисан
-закачен
-откачен
-додељен
-нераспоређени
-означене
-неозначено
-прекретница
-демилестонед
иссуе_цоммент:
врсте:[направљен,уредио,избрисан]
Креирај:
избриши:

Конфигуришите свој посао и изаберите виртуелно окружење у којем ће се извршавати. нотифи_слацк је назив посла. Можете га променити по свом укусу.

послови:
нотифи_слацк:
ради на:убунту-најновији

Подесите корак који ће бити одговоран за слање обавештења у Слацк.

кораци:
-име:ПошаљиСлацкобавештење

Дефинишите променљиву окружења под називом СЛАЦК_ВЕБХООК_УРЛ. Сачуваће Слацк вебхоок УРЛ. Касније ћете додати УРЛ тајнама ГитХубовог спремишта.

енв:
СЛАЦК_ВЕБХООК_УРЛ:${{тајне. СЛАЦК_ВЕБХООК_УРЛ}}

Конфигуришите радња-слабост ГитХуб Ацтион. Што је акција треће стране која управља основном логиком интеракције са Слацк АПИ-јем. Омогућава вам да се фокусирате на конфигурисање порука и догађаја који покрећу обавештења. Ово знатно олакшава процес слања обавештења у Слацк.

користи:8398а7/ацтион-слацк@в3

Овај код користи 8398а7/ацтион-слацк@в3поступак.

Конфигуришите 8398а7/ацтион-слацк@в3 радња са прилагођеним параметрима. Тхе статус параметар поставља статус поруке на обичај. То ће вам омогућити да дефинишете садржај Слацк поруке користећи прилагођено оптерећење. Тхе поља параметар наводи поља која треба укључити у Слацк поруку.

са:
статус:обичај
поља:репо, урезивање, догађај, акција, ток посла, реф, УРЛ

Створити цустом_паилоад који ће прилагодити изглед Слацк поруке тако да одговара вашим жељама.

цустом_паилоад:|
{
"прилози":[
{
"боја":"${{ Пословни статус }}",
"наслов":>-
${{гитхуб.ацтор}}${{гитхуб.евент.пулл_рекуест&&гитхуб.евент.пулл_рекуест.мергед==истина&&'обједињен захтев за повлачење'||гитхуб.евент.пулл_рекуест&&'отворио захтев за повлачење'||гитхуб.евент_наме=='гурати'&&'гурао нове промене'||гитхуб.евент_наме=='Креирај'&&'направио нову грану или ознаку'||гитхуб.евент_наме=='избриши'&&'избрисао грану или ознаку'||гитхуб.евент_наме=='питања'&&гитхуб.евент.ацтион||'покренуо догађај'}},
"текст":>-
:тада:Детаљи догађаја:

-Репозиторијум:${{гитхуб.репоситори}}
-Филијала:${{гитхуб.реф}}
-Порука:${{гитхуб.евент_наме=='гурати'&&гитхуб.евент.хеад_цоммит.мессаге||гитхуб.евент_наме=='питања'&&гитхуб.евент.иссуе.титле||гитхуб.евент_наме=='пулл_рекуест'&&гитхуб.евент.пулл_рекуест.титле||''}}
-:глобе_витх_меридианс:Линк:${{гитхуб.евент.пулл_рекуест.хтмл_урл||гитхуб.евент.иссуе.хтмл_урл||гитхуб.евент.репоситори.хтмл_урл}}
}

]
}

Можете се позвати на 8398а7/ацтион-слацк@в3 прилагођени случај употребе да бисте пронашли сва подржана прилагођавања. Урежите ИАМЛ датотеку да бисте креирали нови ток посла.

Последњи корак интеграције ГитХуб-а са Слацк-ом је додавање нове тајне спремишта. Тајна у овом случају је у Слацк Вебхоок УРЛ копирали сте са Слацк-а. Чувајте овај УРЛ у тајности јер свако ко има приступ може да шаље поруке вашем радном простору.

Идите до подешавања вашег спремишта. Кликните на тајне и променљиве под безбедност одлика. Изаберите Акције опција.

Кликните на Нова тајна спремишта. Додајте име тајне као СЛАЦК_ВЕБХООК_УРЛ. Затим залепите Слацк УРЛ у Тајно поље. На крају, кликните на Додај тајну дугме да сачувате нову тајну.

Сада сте завршили са интеграцијом ГитХуб-а са Слацк-ом. Сваки пут када се догађај деси у вашем спремишту, порука ће бити приказана на вашем каналу. Покушати креирање новог захтева за повлачење. Ово ће покренути пусх догађај.

Снимак екрана испод приказује примере порука на Слацк-у које приказују догађаје који су се десили у спремишту.

Можете да прилагодите садржај поруке тако да укључује друга поља која сматрате потребнима.

Побољшајте своју продуктивност помоћу Слацк интеграција

ГитХуб није једина Слацк интеграција коју можете додати свом радном простору. Постоје бројне интеграције које можете користити да побољшате продуктивност вашег тима и побољшате њихову комуникацију. Упознавање са овим интеграцијама ће вам помоћи да поједноставите радни ток свог тима и да сви буду на истој страници.