В этом руководстве описана настройка учетной записи GitHubи начало работы с функциями GitHub Enterprise Server для совместной работы и сообщества.
Часть 1. Настройка учетной записи GitHub
Первые шаги при работе с GitHub Enterprise Server предназначены для доступа к вашей учетной записи, настройки двухфакторной проверки подлинности и просмотра профиля.
У каждого пользователя, который использует GitHub Enterprise Server, есть личная учетная запись, которая может быть частью нескольких организаций и команд. Ваша личная учетная запись является вашим удостоверением в экземпляр GitHub Enterprise Server и представляет вас как физическое лицо.
1. Доступ к вашей учетной записи
Администратор экземпляра GitHub Enterprise Server уведомит вас о том, как пройти проверку подлинности и получить доступ к вашей учетной записи. Процесс зависит от режима проверки подлинности, настроенного для экземпляра.
2. Настройка двухфакторной проверки подлинности
Двухфакторная проверка подлинности — это дополнительный слой обеспечения безопасности, используемый при входе на веб-сайты или в приложения. Мы настоятельно рекомендуем настроить 2FA для безопасности вашей учетной записи. Дополнительные сведения см. в разделе Двухфакторная проверка подлинности.
3. Просмотр вашего профиля GitHub и диаграммы вкладов
В вашем профиле GitHub отображается история вашей работы с помощью репозиториев и списков, которые вы закрепили, о членстве в организациях, которые вы выбрали для публикации, о внесенных вами вкладах и созданных вами проектах. Дополнительные сведения см. в разделах Сведения о профиле и Просмотр вкладов в профиле.
Часть 2. Использование инструментов и процессов GitHub Enterprise Server
Чтобы наилучшим образом использовать GitHub Enterprise Server, вам необходимо настроить Git. Git отвечает за все, что связано с GitHub и происходит локально на вашем компьютере. Для эффективной совместной работы в GitHub Enterprise Server вы будете писать в задачах и запросах на вытягивание, используя GitHub Flavored Markdown.
1. Изучение Git
Совместный подход GitHub к разработке зависит от публикации фиксаций из вашего локального репозитория в GitHub Enterprise Server для просмотра, извлечения и обновления другими людьми с помощью Git. Дополнительные сведения о Git см. в руководстве по Git. Дополнительные сведения об использовании Git в GitHub Enterprise Server см. в разделе GitHub Flow.
2. Настройка Git
Если вы планируете использовать Git локально на своем компьютере, будь то через командную строку, IDE или текстовый редактор, вам необходимо будет установить и настроить Git. Дополнительные сведения см. в разделе Настройка Git.
Если вы предпочитаете использовать визуальный интерфейс, вы можете скачать и использовать GitHub Desktop. GitHub Desktop поставляется в комплекте с Git, поэтому нет необходимости устанавливать Git отдельно. Дополнительные сведения см. в разделе Начало работы с GitHub Desktop.
После установки Git вы можете подключаться к репозиториям GitHub Enterprise Server со своего локального компьютера, будь то ваш собственный репозиторий или вилка другого пользователя. При подключении к репозиторию на экземпляр GitHub Enterprise Server из Git необходимо пройти проверку подлинности с помощью GitHub Enterprise Server по протоколу HTTPS или SSH. Дополнительные сведения см. в разделе Сведения об удаленных репозиториях.
3. Выбор способа взаимодействия с GitHub Enterprise Server
У каждого есть свой уникальный рабочий процесс взаимодействия с GitHub. Интерфейсы и методы, которые вы используете, зависят от ваших предпочтений и от того, что лучше всего подходит для ваших нужд.
Дополнительные сведения о проверке подлинности в GitHub Enterprise Server с помощью каждого из этих методов см. в разделе Сведения о проверке подлинности в GitHub.
Метод | Описание | Варианты использования |
---|---|---|
Перейдите на GitHub.com | Если вам не нужно работать с файлами локально, GitHub Enterprise Server позволяет выполнять большинство действий, связанных с Git, прямо в браузере — от создания и разветвления репозиториев до редактирования файлов и открытия запросов на вытягивание. | Этот метод полезен, если вам нужен визуальный интерфейс и вам нужно быстро внести небольшие изменения, не требующие локальной работы. |
GitHub Desktop | GitHub Desktop позволяет расширить и упростить рабочий процесс GitHub.com за счет визуального интерфейса вместо текстовых команд в командной строке. Дополнительные сведения о начале работы с GitHub Desktop см. в разделе Начало работы с GitHub Desktop. | Этот метод лучше всего подходит, если вам нужно или вы хотите работать с файлами локально, но предпочитаете использовать визуальный интерфейс для использования Git и взаимодействия с GitHub Enterprise Server. |
IDE или текстовый редактор | Вы можете настроить текстовый редактор по умолчанию, например Visual Studio Code , для открытия и редактирования файлов с помощью Git, использования расширений и просмотра структуры проекта. Дополнительные сведения см. в разделе Связывание текстовых редакторов с Git. | Это удобно, если вы работаете с более сложными файлами и проектами и хотите, чтобы все было в одном месте, так как текстовые редакторы или IDE часто позволяют напрямую обращаться к командной строке в редакторе. |
Командная строка с GitHub CLI или без нее | Для наиболее детального контроля и настройки использования Git и взаимодействия с GitHub Enterprise Server можно использовать командную строку. Дополнительные сведения об использовании команд Git см. в разделе Памятка по GIT. GitHub CLI — это отдельный инструмент командной строки, который можно установить и который выдает запросы на вытягивание, проблемы, GitHub Actions и другие функции GitHub в ваш терминал, чтобы вы могли выполнять всю свою работу в одном расположении. Дополнительные сведения см. в разделе Сведения о GitHub CLI. | Это наиболее удобно, если вы уже работаете из командной строки, что позволяет избежать переключения контекста, или если вам удобнее использовать командную строку. |
GitHub Enterprise Server API | GitHub имеет REST API и API GraphQL, которые можно использовать для взаимодействия с GitHub Enterprise Server. Дополнительные сведения см. в разделе Сведения об API GitHub. | API GitHub Enterprise Server будут наиболее полезны, если необходимо автоматизировать обычные задачи, резервное копирование данных или создание интеграций, расширяющих GitHub. |
4. Написание содержимого на GitHub Enterprise Server
Чтобы ваше общение относительно проблем и запросов на вытягивание было понятным и организованным, вы можете использовать GitHub Flavored Markdown для форматирования, которое сочетает в себе простой для чтения и написания синтаксис с некоторыми пользовательскими функциями. Дополнительные сведения см. в разделе Сведения о написании и форматировании текста на GitHub.
Вы можете изучить GitHub Flavored Markdown с помощью курса Общение с использованием Markdown на GitHub Skills.
5. Поиск на GitHub Enterprise Server
Наш встроенный поиск позволяет вам найти необходимые сведения среди множества репозиториев, пользователей и строк кода на GitHub Enterprise Server. Вы можете осуществлять глобальный поиск по всем GitHub Enterprise Server или ограничить поиск определенным репозиторием или организацией. Дополнительные сведения о типах поисковых запросов, которые можно выполнять в GitHub Enterprise Server, см. в разделе Сведения о поиске в GitHub.
Наш синтаксис поиска позволяет вам составлять запросы, используя квалификаторы, чтобы указать, что необходимо найти. Дополнительные сведения о синтаксисе поиска для использования в поиске см. в разделе Поиск в GitHub.
6. Управление файлами в GitHub Enterprise Server
С помощью GitHub Enterprise Server вы можете создавать, редактировать, перемещать и удалять файлы в своем репозитории или любом репозитории, к которому у вас есть доступ на запись. Вы также можете отслеживать историю изменений в файле построчно. Дополнительные сведения см. в разделе Управление файлами.
Часть 3. Совместная работа над GitHub Enterprise Server
В репозиториях GitHub Enterprise Server может работать вместе любое количество людей. Вы можете настраивать параметры, создавать доски проектов и управлять своими уведомлениями, чтобы способствовать эффективному сотрудничеству.
1. Работа с репозиториями
Создание репозитория
Репозиторий подобен папке для вашего проекта. У вас может быть сколько угодно публичных и приватных репозиториев в вашей личной учетной записи. Репозитории могут содержать папки и файлы, изображения, видео, электронные таблицы и наборы данных, а также журнал изменений для всех файлов в репозитории. Дополнительные сведения см. в разделе Сведения о репозиториях.
При создании нового репозитория необходимо инициализировать репозиторий с файлом README, чтобы сообщить людям о вашем проекте. Дополнительные сведения см. в разделе Создание репозитория.
Клонирование репозитория
Вы можете клонировать имеющийся репозиторий из GitHub Enterprise Server на свой локальный компьютер, чтобы упростить добавление или удаление файлов, устранение конфликтов объединения или выполнение сложных фиксаций. При клонировании репозитория извлекается полная копия всех данных репозитория, которые GitHub содержит на данный момент времени, включая все версии каждого файла и папки для проекта. Дополнительные сведения см. в разделе Клонирование репозитория.
Создание вилки репозитория
Вилка — это копия репозитория, которым вы управляете, где любые изменения, которые вы вносите, не повлияют на исходный репозиторий, если только вы не отправите запрос на вытягивание владельцу проекта. Чаще всего вилки используются либо для того, чтобы предложить изменения в чужом проекте, либо для того, чтобы использовать чужой проект в качестве отправной точки для вашей собственной идеи. Дополнительные сведения см. в разделе Работа с вилками.
2. Импорт ваших проектов
При наличии проектов, которые необходимо перенести в GitHub Enterprise Server, вы можете импортировать проекты с помощью GitHub Importer, командной строки или внешних инструментов переноса. Дополнительные сведения см. в разделе Импорт исходного кода.
3. Управление участниками совместной работы и разрешениями
Вы можете совместно работать над своим проектом с другими, используя проблемы вашего репозитория, запросы на вытягивание и доски проектов. Вы можете пригласить других людей в свой репозиторий в качестве участников совместной работы на вкладке Участники совместной работы в настройках репозитория. Дополнительные сведения см. в разделе Приглашение участников совместной работы в личный репозиторий.
Вы являетесь владельцем любого репозитория, созданного вами в учетной записи, и имеете полный контроль над ним. Участники совместной работы имеют доступ на запись в ваш репозиторий, что ограничивает их имеющиеся разрешения. Дополнительные сведения см. в разделе Уровни разрешений для репозитория личной учетной записи.
4. Управление параметрами репозитория
Как владелец репозитория, вы можете настроить несколько параметров, включая видимость репозитория, темы и предварительный просмотр в социальных сетях. Дополнительные сведения см. в разделе Управление параметрами и функциями репозитория.
5. Настройка вашего проекта для действенных вкладов
Добавляя в репозиторий такие файлы, как рекомендации по внесению вклада, правила поведения и ресурсы поддержки, вы можете создать окружение, в котором участникам совместной работы будет легче вносить значимый и полезный вклад. Дополнительные сведения см. в разделе Настройка проекта для внесения действенных вкладов.
6. Использование проблем и досок проектов GitHub
Вы можете использовать проблемы GitHub для организации своей работы с проблемами и запросами на вытягивание, а также для управления рабочим процессом с помощью досок проектов. Дополнительные сведения см. в разделах О проблемах и Сведения о project boards.
7. Управление уведомлениями
Уведомления предоставляют обновления о действиях на GitHub, на который вы подписаны или в котором участвовали. Если вам больше не интересна беседа, вы можете отменить подписку, отменить отслеживание или настроить типы уведомлений, которые вы будете получать в будущем. Дополнительные сведения см. в разделе Об уведомлениях.
8. Работа с GitHub Pages
GitHub Pages можно использовать для создания и размещения веб-сайта непосредственно из репозитория в экземпляр GitHub Enterprise Server. Дополнительные сведения см. в разделе Описание GitHub Pages.
Часть 4: Настройка и автоматизация работы с GitHub Enterprise Server
Вы можете использовать средства из GitHub Marketplace, API GitHub Enterprise Server и существующие функции GitHub Enterprise Server, чтобы настроить и автоматизировать свой процесс работы.
1. Использование API GitHub Enterprise Server
Существуют две версии API GitHub Enterprise Server: REST API и API GraphQL. Вы можете использовать API-интерфейсы GitHub Enterprise Server для автоматизации распространенных задач, резервного копирования данных или создания интеграций, расширяющих возможности GitHub Enterprise Server. Дополнительные сведения см. в разделе Сведения об API GitHub.
2. Building GitHub Actions
С помощью GitHub Actions можно автоматизировать и настроить рабочий процесс разработки экземпляр GitHub Enterprise Serverв GitHub Enterprise Server. Вы можете создавать собственные действия, а также использовать и настраивать действия, которые предоставляются сообществом GitHub. Дополнительные сведения см. в разделе Изучение GitHub Actions.
3. Публикация и управление GitHub Packages
GitHub Packages — это служба размещения программных пакетов, которая позволяет размещать программные пакеты частным или открытым способом и использовать их в качестве зависимостей в проектах. Дополнительные сведения см. в разделе Введение в GitHub Packages.
Часть 5. Безопасное создание в GitHub Enterprise Server
GitHub Enterprise Server обладает множеством функций безопасности, которые помогают защитить код и секреты в репозиториях. Некоторые функции доступны для всех репозиториев, а другие доступны только для общедоступных репозиториев и репозиториев с лицензией GitHub Advanced Security. Общие сведения о функциях безопасности GitHub Enterprise Server см. в разделе Функции безопасности GitHub.
1. Защита вашего репозитория
Как администратор репозитория, вы можете защитить свои репозитории, настроив параметры безопасности репозитория. К ним относятся управление доступом к вашему репозиторию, настройка политики безопасности и управление зависимостями. Для общедоступных репозиториев и для частных репозиториев, принадлежащих организациям, в которых включен GitHub Advanced Security, вы также можете настроить сканирование кода и секретов для автоматического выявления уязвимостей и защиты маркеров и ключей.
Дополнительные сведения о действиях, которые можно предпринять для защиты репозиториев, см. в разделе Защита репозитория.
Часть 6. Участие в сообществе GitHub
Существует множество способов для участия в жизни сообщества GitHub. Вы можете участвовать в проектах с открытым кодом, взаимодействовать с людьми в GitHub Community Support или учиться с помощью GitHub Skills.
1. Участие в проектах с открытым кодом
Участие в проектах с открытым кодом на GitHub может оказаться полезным при обучении и накоплении опыта для приобретения любых нужных вам навыков. Дополнительные сведения см. в разделе Участие в проектах с открытым кодом в руководствах по открытому исходному коду.
Вы можете найти персонализированные рекомендации для проектов и хороших первых вопросов на основе ваших прошлых вкладов, звезд и других действий в обзоре.
2. Взаимодействие с GitHub Community Support
Вы можете общаться с разработчиками по всему миру, задавать вопросы и отвечать на них, учиться и взаимодействовать с сотрудниками GitHub Enterprise Server напрямую. Сведения о том, как начать беседу, см. в разделе «GitHub Community Support».
3. Информация о GitHub Enterprise Server on GitHub Docs
Вы можете прочитать документацию, в которой описаны доступные функции на GitHub Enterprise Server. Дополнительные сведения см. в разделе Сведения о версиях документации GitHub.
4. Обучение с GitHub Skills
Вы можете научиться новым навыкам, реализуя интересные и реалистичные проекты в собственном репозитории GitHub с помощью GitHub Skills. Каждый курс — это практический урок, созданный сообществом GitHub и проводимый удобным ботом.
Дополнительные сведения см. в разделе Обучающие ресурсы по Git и GitHub.