1. Уеб дизайн и разработкаКакво искания за изтегляне на GitHub?

От Сара Гутълс

Заявката за изтегляне на име е объркваща за някои хора. „Какво точно искам да бъда изтеглен?“ Добър въпрос. Искане за изтегляне в GitHub е искане към поддръжника на хранилище да изтегли някакъв код.

Когато напишете някакъв код, който искате да добавите в хранилище, създавате и изпращате заявка за изтегляне. Кодът ви съдържа някои предложени промени в целевото хранилище. Искането за изтегляне е вашият начин да предложите тези промени на поддръжника на хранилището. Тя дава възможност на поддръжниците на хранилището да преглеждат промените и да ги приемат, да ги отхвърлят или да поискат повече промени.

Натискане на код към GitHub

За да избутате код към GitHub, се нуждаете от хранилище. Отворете хранилището по ваш избор.

Първото нещо, което трябва да направите, е да създадете нов клон. Създаването на нов клон преди писане на нов код е стандартна операционна процедура с Git.

Искането за изтегляне не се състои от произволен набор от промени или ангажименти. Искането за изтегляне винаги е свързано с клон. С други думи, искане за изтегляне е искане за сливане на един клон в друг.

Въпреки че е вярно, че заявката за изтегляне може да е насочена към всеки клон (с изключение на самия него), най-често срещаният сценарий е да се насочите към главния клон на хранилище, обикновено с име master.

Тази връзка между заявките за изтегляне и клоните е причината да създадете нов клон, когато започвате нова работа. Ние даваме име на клона new-work за този пример, но не се колебайте да го наречете каквото искате, като замените new-work със собственото си име на клона в следната команда:

$ git checkout -b нова работа

Сега, когато имаме клон, трябва да създадем ангажимент в този клон. За този пример конкретното съдържание на ангажимента не е важно. Можете да изберете всеки файл и да направите някои редакции във файла, като например да добавите малко текст до края. Или ръчно редактирайте файла README.md ръчно или изпълнете следната команда, за да добавите текст в края на файла:

$ echo "\ n ## Инсталация" >> README.md

Сега, когато имате файл с някои промени, извършете тези промени. Можете да използвате следната команда, например, за да извършите всичките си промени. Тук не е важно съобщението за ангажиране. Важното е да имаш ангажимент в клон, за да работиш с това не е в главния клон.

$ git add -A

$ git commit -m "Добавяне на текст към README"

Сега натиснете този нов клон към GitHub.com (заменете нова работа с името на вашия клон):

$ git push -u произход ново творчество

Командата git push казва на Git да натисне локални ангажименти към отдалечен хранилище. Флагът -u указва къде да го натиснете - в този случай към клон, наречен също така new-work на отдалеченото име на произход.

Флагът -u е необходим само при първото натискане на нов клон към сървъра. От този момент нататък, новият клон на вашата локална машина е свързан с новия работен клон на GitHub.com и всички последващи натискания към този клон не се нуждаят от знамето.

Как да отворите заявка за изтегляне

Преди да можете да отворите заявка за изтегляне, вашето GitHub.com хранилище трябва да има поне един клон, различен от този по подразбиране. Ако следвате предходните стъпки, имате клон, който все още не е обединен в главен. В нашия случай клонът е наречен клон за ново работно място, но може би сте кръстили нещо друго. Посетете хранилището на GitHub.com, за да отворите заявка за изтегляне.

Когато посетите хранилището на GitHub.com, виждате ново съобщение в секцията, озаглавена Вашите наскоро избутани клонове, както е показано.

Начална страница на хранилището на GitHub

Щракнете върху бутона Сравняване и изтегляне на заявка, за да отворите страницата Отваряне на заявка за изтегляне, както е показано на следващата фигура. Целевият клон (клонът, в който искате да изтеглите промените си) е клонът по подразбиране за репо. Вашият клон е посочен до целевия клон и до него може да се добави състояние дали вашият клон може да бъде обединен в целевия клон. Заглавието на заявката за изтегляне е същото като най-новото съобщение за ангажиране - в този пример Добавете текст към README - и вашето описание е празно. Следващата фигура показва примерно описание.

Искане за изтегляне на GitHub

Можете да промените клона по подразбиране, като изберете раздел Настройки → Клонове на вашето хранилище.

Искането за изтегляне

От страницата Отваряне на заявка за изтегляне можете да въведете обобщение и описание. Повечето конвенции за съобщения за ангажиране също се поддържат в заявка за изтегляне - например споменаване на хора, използващи формата @USERNAME. В предишния въпрос споменавам @ sarah-wecan. Когато създавам заявка за изтегляне, @ sarah-wecan получава известие.

Можете да препращате към проблеми и други заявки за изтегляне, като използвате формата #ISSUEID. И, разбира се, можете да добавите емоджи, като: sparkles:.

В този раздел обхващаме какво да напиша тук по-подробно. Има много неща, които влизат в добра заявка за изтегляне.

Как да добавите рецензенти

Вдясно от полетата за обобщение и описание на заявката за изтегляне е набор от опции за заявката за изтегляне.

Първият, Рецензенти, ви позволява да посочите един или повече хора, които искате да прегледате молбата си за изтегляне. За да добавите рецензенти:

  1. Кликнете върху предавката, за да видите списък с хора, които можете да споменете. За хранилища с голям брой потребители можете да започнете да пишете, за да филтрирате набора от потребители. Кликнете върху всеки потребител, за да ги добавите към списъка с рецензенти. Когато добавите рецензент, те веднага биват уведомявани, когато приключите със създаването на заявката за изтегляне. Следващата фигура показва списъка с рецензенти с избрани двама рецензенти.
GitHub списък на рецензенти

Как да посочите правоприемници

Следващата опция след Рецензенти е опция за посочване на правоприемници. Правоприемник е лицето, което трябва да предприеме действия по искането за изтегляне. Често заявката за изтегляне представлява незавършена работа, а не краен резултат от някаква работа. Ако трябва да се свърши повече работа при заявка за изтегляне, вие ще зададете заявката за изтегляне на лицето, което трябва да свърши работата.

За да посочите правоприемниците:

  1. Щракнете върху предавката, за да видите списък на правоприемниците. Диалоговият прозорец на правоприемника работи точно като диалоговия прозорец за рецензенти. Тя ви позволява да изберете един или повече правоприемници. Кликнете върху всеки потребител, за да ги добавите към списъка с рецензенти.

В повечето случаи е най-добре просто да назначите един човек, който ще бъде отговорен за следващата стъпка. Назначаването на един човек намалява шансовете, че множество правоприемници смятат, че другите правоприемници са отговорни за работата.

Как да посочите етикети

Етикетите са начин да разберете какво да работите по-нататък. Етикетите работят по същия начин за заявките за изтегляне. Те осигуряват удобно групиране и контекст, за да ви помогнат да решите върху какво да работите по-нататък или какво да прегледате по-нататък.

Наборът от етикети, които можете да използвате при проблеми и изтегляне на заявки, е един и същ, но някои етикети имат по-голям смисъл за проблемите, отколкото исканията за изтегляне и обратно. Например, много хранилища имат етикет „готов за преглед“, специално за заявки за изтегляне.

Посочете проекти и основни етапи

Последните две опции ви позволяват да укажете дъската на проекта и основната стъпка, към която принадлежи тази заявка за изтегляне.

Как да създадете заявката за изтегляне

След като напишете заявката за изтегляне и посочите всички опции за заявка за изтегляне, щракнете върху бутона Създаване на заявка за изтегляне, за да запазите цялата си работа и създайте заявката за изтегляне. Тази фигура показва заявка за изтегляне, създадена в моето хранилище.

Искане за изтегляне на GitHub
  1. Уеб дизайн и разработка предприемете действия с GitHub действия

От Сара Гутълс

GitHub има функция, която премахва необходимостта да хостваме нашето приложение извън GitHub, което може да намали броя на движещите се части при разширяване на GitHub. Тази функция се нарича GitHub Actions.

GitHub Actions е една от най-новите и вълнуващи функции на GitHub. По време на писането това все още е бета функция. Действията на GitHub правят възможно създаването на персонализирани работни процеси в GitHub. Тя ви позволява да прилагате персонализирана логика, за да реагирате на събития в GitHub. В предишния раздел написахме приложение на GitHub, за да направим това. С GitHub Actions не е необходимо да създаваме персонализирано приложение. Можем да изградим работни процеси, като използваме съществуващи действия, които други са написали, или можем да напишем собствени действия, които се изпълняват в контейнер на Docker.

Да се ​​надяваме, че до момента, когато прочетете това, GitHub Actions са общодостъпни. Но в случай, че те все още са в бета версия, изпратете имейл на support@github.com и поискайте да участвате в бета програмата на GitHub Actions.

За да демонстрирате GitHub Действия, помислете за следния сценарий. Когато обедините заявка за изтегляне в собственото си хранилище, клона за заявката за изтегляне се придържа. GitHub представя бутон за изтриване на клона, но много хора забравят да го направят и оставят тези клони да се придържат наоколо.

Не изтриването на клона не е непременно лошо нещо, освен ако не сте типът човек, който обича нещата да бъдат подредени и не може да издържи да има клон, който вече не е нужно да се задържи наоколо. Ако сте такъв тип човек, имате късмет. Jesse Frazelle също е този тип хора и тя написа GitHub Action, която можете да използвате в собствените си работни процеси. Нейната публикация в блога, „Животът на GitHub Action“, е добро четиво, за да разберете повече подробности за жизнения цикъл на GitHub действие.

Създаване на работен процес на действие на GitHub

Ако сте били приети в бета програмата на GitHub Actions или тя е станала по-широко достъпна, трябва да видите допълнителен раздел в горната част с етикети Действия, когато преглеждате хранилище.

Следващите стъпки преминават през процеса за създаване на работен процес на GitHub за хранилище.

Работни процеси на GitHubПрости работни процеси в GitHub

Тестване на GitHub Action

След като ангажирате този файл във вашето хранилище, работният процес е активен. Можете да го тествате, като създадете нова заявка за изтегляне и след това я обедините. Няколко секунди или минути по-късно трябва да видите, че клона на заявката за изтегляне е изтрит. Актуализация на заявката за изтегляне казва нещо подобно

github-Actions bot изтри клона с името на клона преди 1 минута

Можете да създавате доста полезни и сложни работни процеси, като използвате съществуващите действия. Можете да инсталирате действия от GitHub Marketplace или да ги препратите, като посочите към хранилище, което съдържа действие. Можете също да пишете персонализирани действия. Как да направите това е извън обхвата на тази статия, но можете да разгледате действието, което Джеси написа, за да добиете представа за това, което е необходимо.

С GitHub Actions можете да персонализирате GitHub по ваш вкус по почти неограничен начин.

  1. Уеб дизайн и разработкаGitHub приложения и Probot

От Сара Гутълс

Приложенията в GitHub ви позволяват да разширите GitHub по мощни начини. Приложенията на GitHub са уеб приложения, които могат да реагират на събития в GitHub. Тези абонаменти за събития се наричат ​​уеб куки. Когато на GitHub се случи събитие, за което приложението се интересува, GitHub отправя HTTP заявка към приложението с информация за събитието. След това приложението може да отговори на това събитие по някакъв начин, което често води до обратно повикване до GitHub чрез API на GitHub.

Тук ще преминете през изграждането на просто GitHub приложение, което носи малко лекота на дискусиите във вашия проблем. Има стар мем под формата на анимиран gif с малко момиче, което задава въпроса „Защо нямаме и двете?“ Типичното приложение на този мем е в отговор на въпрос, който представя фалшива дихотомия. С други думи, когато някой представи въпрос с два избора, някой може да отговори с това изображение.

Представяме Probot на GitHub

Приложенията на GitHub са уеб приложения, които трябва да слушат HTTP заявки. Имате много важни подробности, за да получите точно при изграждането на HTTP заявка, като какъв е форматът на данните, публикувани в приложението? Всички тези подробности могат да бъдат объркващи и отнемащи време, за да се коригират при изграждането на приложението на GitHub от нулата. Да знаеш откъде да започнеш е трудно.

Рамбовата рамка на GitHub е полезна, когато започнете с приложението GitHub. Probot борави с голяма част от котлона и с ниски подробности за изграждането на GitHub приложение. Това е рамка за изграждане на GitHub приложения с помощта на Node.js. Той предоставя много удобни методи за слушане на събития в GitHub и за извикване в GitHub API.

Probot улеснява създаването на приложение за GitHub, но не решава проблема къде да хоствате приложението.

Хостинг на приложението GitHub

Приложението на GitHub може да приеме много форми. Това може да е приложение Node.js, работещо в Heroku, приложение за ASP.NET Core, работещо в Azure, приложение Django, работещо в Google Cloud - няма значение. Просто трябва да бъде постоянен и достъпен чрез публичния Интернет, за да може GitHub да го достигне с полезни товари.

Настройването на всичко това може да отнеме много време, затова за нашите цели използваме Glitch за внедряване на бързо и мръсно приложение на GitHub.

Представяне на бъг

Glitch е хостинг платформа за уеб приложения, която премахва голяма част от триенето с стартиране и работа на уеб приложение. Всяко приложение, което създавате в Glitch, се разпространява на живо в мрежата от самото начало. Не е нужно да мислите как планирате да внедрите кода, тъй като всяка промяна, която направите, се запазва автоматично и се разгръща автоматично.

Glitch се фокусира върху общностния аспект на изграждането на приложения. Всеки файл може да бъде редактиран от множество хора в реално време по същия начин, по който можете да редактирате документ в Google Документи. И всеки проект може да бъде ремиксиран с натискане на бутон. Това насърчава много споделяне на код и учене един от друг, което е полезно, когато изграждаме собствено приложение GitHub.

Преди да продължите, не забравяйте да създадете акаунт в Glitch, ако вече нямате такъв.

Създайте приложение за Probot Glitch

След като сте разбрали грубо с Probot и сте настроили Glitch акаунт, можете да изградите Probot приложение на Glitch. Glitch ви позволява да ремиксирате съществуващи приложения, а добрата новина е, че Glitch вече има приложение Probot, което можете да ремиксирате. Това означава, че можете да създадете приложението си Probot с едно щракване и няколко персонализации.

За да създадете приложението си, въведете следния URL адрес в браузъра си: https://glitch.com/edit/#!/remix/probot-hello-world.

Тази команда създава съвсем ново приложение в Glitch въз основа на пример probot-hello-world с произволно генериран URL адрес, както е показано. Както можете да видите, моето приложение се нарича бонбони-шафери.

Приложението GitHub Glitch Probot

Левият прозорец показва списъка с файлове в приложението ви. Файлът README.md съдържа инструкции стъпка по стъпка за настройка на приложението hello-world Probot. Следвайте внимателно тези инструкции, за да настроите примерното приложение GitHub.

В една от инструкциите се споменава изпълнението на следната команда:

котка my-app-name.2018-06-20.private-key.pem | pbcopy

Целта на предишната команда е да копира съдържанието на вашия файл с личен ключ в клипборда, така че да можете да го поставите във файла Glitch. Тази команда обаче работи само на Mac. В Windows бихте изпълнили следната команда (промяна на името на файла, за да съответства на вашето):

напишете my-app-name.2018-06-20.private-key.pem | клипс

Когато приключите, инсталирайте приложението в хранилище, което притежавате, и след това създайте нов проблем. Няколко секунди по-късно трябва да видите коментар, създаден от вашия бот, с думите „Hello World!“.

Персонализирайте приложението

След като създадете приложение Probot в Glitch и го инсталирате на GitHub, можете да персонализирате как приложението реагира на коментари. Когато следвате стъпките в README, вие се абонирахте за издаване на събития. Тези събития не включват, когато се създават нови коментари. Трябва да се абонираме и за да публикуваме коментари.

Вижте списък с вашите приложения тук. Кликнете върху бутона „Редактиране“, за да отворите приложението си. След това в лявата навигация щракнете върху Разрешения и събития и превъртете надолу до секцията Абониране за събития. Поставете отметка в квадратчето за издаване на коментар, както е показано.

Абонаменти за събития в GitHub

Кликнете върху бутона Запиши промените в долната част, за да завършите тези промени.

Сега трябва да промените приложението си за бъг, за да слушате коментари за нови проблеми и да отговорите по подходящ начин. Редактирайте файла index.js и заменете съдържанието на файла със следния код:

module.exports = (app) => {

// Слуша коментари за ново издание

app.on ('issue_comment.create', async context => {

// Извлича текста на коментара

const message = context.payload.comment.body

ако (message.indexOf ('или')> -1) {

const params = context.issue ({

body: '! [защо не и двете момичета] (https://media3.giphy.com/media/3o85xIO33l7RlmLR4I/giphy.gif)'

})

// Създава коментар с изображение на маркировка

връщане контекст.github.isissue.createComment (парами)

}

})

}

Този код слуша нови коментари за издаване, търси думата или заобиколен от интервали и ако я намери, създава нов коментар с изображение на маркировка.

Този подход не е много умен. Опитайте този малко по-добър подход. Ще бъде още по-добре, ако можем да използваме някакъв изкуствен интелект (AI) под формата на обработка на естествен език (NLP). Но това е извън моя набор от умения и извън обхвата на тази книга.

Инсталиране на приложението

След като създадете приложението и го накарате да работи, други могат да го инсталират и да го използват. Можете да го инсталирате, като отидете в списъка с приложения на GitHub и щракнете върху големия зелен бутон Install в горния десен ъгъл.

Инсталирайте го в хранилище и след това отидете да създадете коментар за проблем в хранилището, който задава въпрос с думата или в него. Примерно взаимодействие е показано тук.

Приложението GitHub Защо не
  1. Уеб дизайн и развитиеHackathons и други мрежови събития за разработчици на софтуер на GitHub

От Сара Гутълс

GitHub е домакин и спонсорира няколко конференции през цялата година. Много видове събития се фокусират върху разработчиците на софтуер. Те варират от неформалната среща или група потребители до структурираната многодневна международна софтуерна конференция.

Вижте кои събития в GitHub предстоят. Тази страница изброява предстоящите събития на GitHub, както и събития, които спонсорира.

GitHub хакатон графика

Срещи и групи потребители за разработчици на софтуер

Група за срещи или потребители е неформално събиране на разработчици за обхващане на тема. Много от тях са планирани ежемесечно и се организират от местна компания или група за софтуерни интереси.

Тези събития обикновено са чудесен начин да потопите върха на крака в събитията на разработчиците на софтуер. Те са склонни да са малки събития от хора във вашия район. Всеки месец присъства местен говорител, който говори по тема, свързана с групата. (Някои групи потребители и срещи въвеждат оратори отвън, но обикновено те се фокусират върху подчертаването на местните говорители.)

Meetups.com е чудесен начин да намерите среща, свързана с вашите интереси. Можете да търсите срещи по местоположение на meetups.com. Например, проверете срещите на JavaScript за района в Сиатъл Вашингтон.

Няколко примера за местни срещи включват

  • Бруклин JS: Бруклин, Ню Йорк .NET Сао Пауло: Сао Пауло, Бразилия SD Ruby: Сан Диего, Калифорния

Регионални конференции за разработчици на софтуер

Регионалната конференция е сравнително малка конференция, при която лектори и участници извън местната зона са добре дошли, но фокусът на конференцията е да се осигури място за местните разработчици и оратори да се свържат и представят своята работа.

Често тези конференции са един или два дни. Мнозина ще имат един запис на разговори, или най-много два. Те са увеличаване на размера и структурата от среща и обикновено се случват веднъж годишно, за разлика от месечните.

Някои от тях често предлагат семинари преди или след конференцията. Тези семинари обикновено струват допълнително, но предлагат по-задълбочено обучение за конкретен набор от умения или технология. Например, често можете да намерите целодневен семинар, посветен на подобряването на вашите Git умения. Ако можете да си го позволите и намерите такъв, който учи на умение, което искате да подобрите, работилниците често си струват инвестицията.

Някои страхотни примери за местни конференции включват

  • .NET ресни: Портланд, Орегон JSConf Hawaii: Хонолулу, Хавай GoRuCo: Ню Йорк, Ню Йорк

маратони по програмиране

Хакатонът е много различен от конференцията. Докато конференциите се фокусират повече върху това лекторите да преподават тема чрез беседа, хакатоните се фокусират върху изграждането. Хакатонът е събитие, което може да продължи няколко дни, при което групи от хора да формират екипи, които да работят заедно и да пишат код, за да решат някакъв проблем.

Обичайният формат е някакъв проблем и се представя задача на екипите да изграждат решение. Технологичният стек, който могат да използват, често зависи от фокуса на хакатон. Например, хакатон за мобилни разработки ще изисква от участниците да изграждат мобилно приложение, за да решат проблема.

Хакатон е пристанище на думите хак и маратон. Мнозина стигат до крайност аспекта на маратона, като екипите работят денонощно с много малко сън. Други се опитват да създадат баланс на работното време и часовете за сън, като принуждават състезателите да напуснат работното пространство.

Хакатоните често са много приобщаващи начинаещи. Например, SD Hacks е отворен за всеки гимназиал или колеж в света, който е на 18 или повече години. Не е нужно винаги да имате екип, когато се регистрирате за хакатон. Често можете да намерите такъв, когато стигнете до там. Най-добре е да разгледате често задаваните въпроси за конкретния хакатон, за да научите повече за подробностите.

Един от най-големите хакатони в световен мащаб е насочен към студенти от колежа. Това е Microsoft Imagine Cup. Победителите в Imagine Cup могат да спечелят менторство от Сатя Надела (CEO) на Microsoft, да пътуват до световното първенство и да получат безвъзмездни средства на Azure и 100 000 долара.

Посещението на хакатони може да бъде чудесен начин да бъдете запознати с нова технология. Целта не е да създадете и внедрите краен продукт, а по-скоро да хакнете заедно битове и парчета, за да постигнете напредък в идеята, която имате. Крайният продукт трябва да прилича повече на прототип, отколкото на полирано приложение. Често пъти хакатоните ще имат ментори, които познават определена технология, от която можете да се научите. Помислете за хакатона като посветен час и място за експериментиране и учене.

Въпреки че посещението на официален хакатон ще ви осигури ментори, място, а понякога и награди, винаги можете също да се съберете с приятели, за да направите един и сами! Просто изберете време, място и цел и се опитайте да хакнете заедно прототип на идея, която имате! Не боли да го изстреляш!

Основни конференции за разработчици на софтуер

Една голяма конференция обикновено е голяма и привлича участници от цялата страна, ако не и от целия свят. Броят на участниците е хиляди. Посещението на една от тези конференции изисква малко повече предварително планиране. Това не е само да организирате вашия полет и хотел. Тези конференции са склонни да имат много песни, така че за даден интервал от време може да се наложи да изберете кой разговор искате да видите от пет или повече разговори едновременно.

Подобно на регионална конференция, основните конференции често предлагат набор от предложения за семинари преди или след конференцията. Освен семинари, много от тях включват и ръце в лаборатории по време на конференцията. Обикновено лабораториите са включени в цената на конференцията и предлагат голям шанс да изпробвате всъщност технологиите, за които чувате на конференцията.

Много от тези конференции са хвърлени от големи технологични компании, като Microsoft's Conference Conference и WWDC на Apple.

Няколко примера включват

  • Oscon: Портланд, Орегон Създаване: местоположението се променя всяка година WWDC: Сан Франциско, Калифорния

GitHub Universe

GitHub Universe е водещата конференция за GitHub. Той се провежда ежегодно в града, където е основната централа на GitHub, Сан Франциско, Калифорния. Конференцията обикновено се провежда през есента около октомври или ноември.

Както GitHub го описва,


GitHub Universe е конференция за строителите, планиращите и лидерите, определящи бъдещето на софтуера.

Тази конференция е мястото, където GitHub обикновено прави най-големите си анонси за годината по време на основната тема. Той привлича известни оратори от известни софтуерни компании.

През 2018 г. конференцията имаше около 1800 участници, които присъстваха на три песни на разговори. Цената на конференцията е разумна, около 99 долара на човек или 199 долара, ако също посещавате семинарите.

GitHub Satellite

Сателитните конференции на GitHub са издънка на GitHub Universe. Те носят конференция за универсален стил на GitHub на места по целия свят.

Провежда се веднъж годишно, минали спътници се провеждат на места като Берлин, Токио и Лондон.

GitHub Constellation

GitHub Constellation е поредица от малки обществени събития, провеждани няколко пъти в годината по целия свят. Тези събития се фокусират върху местната общност и често представят местни говорители в района. Обикновено са безплатни и се появяват през една или две вечери. Те не са целодневни конференции като Сателит и Вселена.

Git Merge

Git Merge, е конференция, спонсорирана от GitHub, но фокусирана върху инструмента за контрол на версиите на Git и хората, които го използват всеки ден. Както GitHub казва,


Чрез технически сесии и практически семинари, разработчиците и екипите от всички нива на опит ще намерят нови начини за използване, надграждане и мащабиране на Git.

Конференцията включва практически работен ден от семинари, посветени на различни теми от Git. Тази конференция е чудесна, за да научите повече за Git и да подобрите вашите Git умения.

  1. Уеб дизайн и разработка на пазара GitHub

От Сара Гутълс

Много инструменти разширяват или интегрират с GitHub. Добър начин да намерите инструменти, които да използвате с GitHub, е пазарът на GitHub. GitHub Marketplace е директория с инструменти и приложения, групирани в следните категории:

  • Чат Качество на кода Преглед на кода Непрекъсната интеграция Управление на зависимостта разгръщане Изучаване на Локализация Подвижен мониторинг Управление на проекти издаване Неотдавна добавени Сигурност поддържа Тестване комунални услуги

The Marketplace е чудесен начин да намерите приложение за всяка ситуация в GitHub. Закупуването или инсталирането на приложения през Marketplace има две основни предимства: лекота на фактуриране и инсталиране и процес на проверка.

Фактурирането става лесно на пазара на GitHub

За приложения на GitHub Marketplace, които изискват плащане, инсталирането на приложението през Marketplace е облекчен поток, защото можете да използвате информацията за плащанията си в GitHub. По този начин нямате работа с пет различни доставчици на плащания, когато купувате пет различни приложения, които да използвате с GitHub.

Ако имате безплатен акаунт в GitHub, може да нямате настройка на данните си за плащане в GitHub. За да настроите начин на плащане, щракнете върху вашия аватар в горния десен ъгъл на GitHub.com и щракнете върху Настройки. От тази страница щракнете върху Таксуване от списъка вляво. Тук можете да щракнете върху Добавяне на метод за плащане, както е показано.

Формуляр за фактуриране на GitHub

Процесът на проверка на пазара на GitHub

Едно от предимствата на инсталирането на приложение от Marketplace е, че тези приложения трябва да отговарят на определени изисквания, преди GitHub да ги изброи в Marketplace. Изискванията помагат да се гарантира по-висок стандарт за качество и сигурност с приложенията; помагайки да се гарантира, че тези приложения са полезни (няма Fart приложения) и са защитени.

Понастоящем GitHub Action не изисква преглед да бъде изброен на пазара на GitHub, което означава, че инсталирането на действие от човек, за когото не знаете, може да е малко по-рисковано.

Приложението трябва да отговаря на четири основни категории изисквания, преди да бъде изброено на Marketplace:

  • Потребителско изживяване: Този кратък набор от девет изисквания включва неща като приложението трябва да има определен брой потребители и вече се инсталира. Той също така включва някои изисквания относно поведението на приложението, като приложението трябва да включва връзки към документацията, не може активно да убеждава потребителите далеч от GitHub и трябва да предоставя стойност на клиентите. Марка и листинг: Този набор от насоки и препоръки се фокусира върху марката на приложението ви и в списъка на приложението ви. Всяко приложение трябва да включва собствено лого. Ако приложението използва логото на GitHub, то трябва да следва указанията за логотипи и употреби на GitHub. Секцията за марката и списъка на страницата „Изисквания“ съдържа връзки към допълнителни указания за лого и описание. Както можете да видите, GitHub приема сериозно списъка с приложенията на Marketplace. Сигурност: GitHub ще извърши преглед на защитата на приложенията, преди да ги изброи на пазара. Наличен е отделен документ с най-добри практики за сигурност и повече подробности относно прегледа на сигурността. Разплащателни потоци: Всяко приложение на Marketplace трябва да интегрира платежните потоци, използвайки събитието на GitHub Marketplace webhook. Това изискване гарантира, че хората могат да закупят абонамент за вашето приложение и да отменят този абонамент с информацията за плащане, която вече имат в GitHub. Той също така гарантира, че всички промени, направени чрез GitHub, се отразяват незабавно в собствения уебсайт на приложението.

Как да изброите приложението си на пазара на GitHub

Попадането на вашето собствено приложение в списъка на Marketplace може да увеличи потенциалната аудитория за вашето приложение. Описването на приложението ви обаче изисква то да отговаря на изискванията на GitHub и да получи одобрение.

За да започнете процеса на изброяване на приложение, щракнете върху връзката Изпращане на вашия инструмент за преглед в долната част на целевата страница Marketplace или отворете Новата страница на GitHub Marketplace във вашия браузър.

Тази страница изброява вашите приложения, които можете да превърнете в списъци на Marketplace, както е показано на следващата фигура.

Списък на приложения за GitHub

Щракнете върху Създаване на чернова списък до приложението, което искате да изброите на Marketplace, за да стартирате процеса. Това ще ви отведе до страница, на която можете да въведете име за списъка и да изберете една от категориите на пазара за приложението си, както е показано.

Формуляр за приложение на GitHub

Ако запазите черновата на вашата обява, но случайно затворите браузъра си, можете да се върнете към списъка си във вашия браузър.

След като попълните тези данни, щракнете върху Запазване и добавете още подробности, за да запазите чернова на вашия списък и преминете към следващия набор от стъпки, както е показано.

Представяне на GitHub Marketplace

Тези стъпки включват

  1. Добавете вашата информация за контакт. Тази информация е набор от три имейл адреса: Техническа насоченост, маркетинг и финансови клиенти. Попълнете описанието на вашата обява. Тази област е мястото, където попълвате повече подробности, като описание на продукта, лого и екранни снимки. Информацията тук ще бъде показана на страницата Marketplace за вашето приложение. Създайте планове и цени. Тук можете да настроите един или повече ценови планове, включително опцията за създаване на безплатен план, месечен план или месечен план за потребител. Можете също така да определите дали планът включва 14-дневна безплатна пробна версия. Настройте уебхока. Тази стъпка ви позволява да определите URL адрес, където събитията от Marketplace ще бъдат изпращани чрез HTTP POST заявка. Webhook ще ви изпрати информация за събития, като покупки, анулиране и промени като надстройки и понижения. Приемете споразумението за разработчик на пазара. За да изброите приложението си на пазара, трябва да приемете Marketplace Developer Agreement. Кликнете върху бутона Изпращане за преглед. Служителите на GitHub ще прегледат вашата заявка, за да се уверят, че тя отговаря на изискванията, които трябва да бъдат посочени на Marketplace.

Помислете за често инсталирани приложения

Ето някои от най-често срещаните и полезни приложения на GitHub, които може да искате да помислите за инсталиране.

Непрекъсната интеграция

Приложенията за непрекъсната интеграция (CI) автоматично изграждат и тестват кода всеки път, когато го натиснете към GitHub. Ако имате приложение CI, например AppVeyor, инсталирано във вашето хранилище, ще видите състоянието на чека в долната част на всяка заявка за изтегляне, както е показано.

GitHub AppVeyor CI

Ако сте собственик на хранилището, можете също да определите дали трябва да преминат проверки, преди клонът да може да бъде обединен в главния клон. Просто отидете в раздела Настройки. Ако вече имате някакви правила в основния клон, щракнете върху редактиране; в противен случай щракнете върху Добавяне на правило. Оттам можете да превъртите надолу и да изберете Изискване на проверки за състоянието, за да преминете, преди да се обедините.

Качество на кода

Приложенията за качество на кода автоматично преглеждат кода ви със проверки за стил, качество, сигурност и тестове. Тези приложения могат да бъдат наистина полезни, за да гарантирате, че кодът ви е поддържан на висок стандарт. С добре оформен и качествен код е по-малко вероятно да въведете или да пропуснете бъгове. Например, ако се изисква всички къдрави скоби да са на нови линии и да са отрезани с един раздел на вложена скоба, има вероятност да можете да забележите, когато нещо е неправилно. Например, Rubocop проверява стила на вашия Ruby код, докато той се изгражда и ви предоставя обратна връзка със стил, като например корпус за имената на методите.

Друг полезен тип приложения за качество на кода са приложенията за покритие на кода, като Codecov. Показан на следната фигура, Codecov и приложения като него коментират заявки за изтегляне с каква част от кода е обхванат от тестови сценарии, помагайки да се гарантира, че кодът ви остава добре тестван.

Приложението GitHub Codecov

Локализация

Приложенията за локализиране могат да улеснят публикуването на приложението ви на много езици. Например, приложението Crowdin ще свърже вашето хранилище с акаунт в Crowdin, където хората от цял ​​свят могат да ви помогнат да преведете документацията си и всички писмени думи в софтуера си (например, на бутони или в менюта). С повече от 20 000 души, които участват в преводите, приложението Crowdin автоматично ще отвори заявка за изтегляне във вашето хранилище с нови преводи, когато достигне прага на точност, като все пак ще ви даде възможност за преглед и сливане. За проекти с отворен код Crowdin е безплатен!

мониторинг

Приложенията за наблюдение помагат да се измери ефективността, да се проследят грешките и да проследят зависимостите във вашия код. Например Greenkeeper е приложение за уведомяване в реално време, което ви предоставя актуализации и промени за зависимости от JavaScript. Тази фигура показва Greenkeeper в действие, отваряйки заявка за изтегляне за актуализиране на eslint до най-новата версия.

Приложението GitHub Greenkeeper

Управление на зависимостта

Съвременното развитие на приложения днес силно зависи от мениджърите на публични пакети за извличане и управление на зависимости. Типичното приложение може да има десетки, ако не и стотици зависимости. Проследяването на коя от тези зависимости е актуална може да бъде трудно. Приложения на Github като Dependabot проверяват дали вашите зависимости са актуални и изпращат заявки за изтегляне, за да актуализират тези, които не са.

Понякога не искате всичките си зависимости от регистъра на публичните пакети. Например, ако работите в предприятие, може да имате вътрешни пакети, които трябва да останат частни. Инструмент за регистрация на частни пакети, като MyGet, е полезен в този случай. MyGet работи с NuGet пакети и ви позволява да настроите политика, при която бутоните към определен клон ще инициират изграждане и клонът ще бъде разположен в персонализиран NuGet емисия, хостван в MyGet.

Тестване

Тестване на софтуер е важна част от жизнения цикъл на разработката на софтуер. Добрите тестери разработват тестови планове, за да гарантират, че тестерите вършат добра работа при тестване на всяко издание. Управлението на тестовите планове и проследяването на състоянието на пробните проби е важна част от осигуряването на качество. Приложението TestQuality се интегрира с GitHub, за да помогне на разработчиците и тестерите да създават, изпълняват, координират и наблюдават задачи за тестване на софтуер.

Изучаване на

Чудесен начин да научите GitHub е да инсталирате GitHub Learning Lab от Marketplace. Инсталиране на Learning Lab инсталирайте бот, който ще ви преведе през интерактивни уроци за това как да използвате GitHub чрез набор от задачи, които изпълнявате. Лабораторията е безплатна и ви позволява да изпитвате толкова курсове, колкото искате, със собствено темпо.