Примечание. Ваш GitHub App будет иметь доступ ко всем репозиториям, которые создает приложение, даже если кто-то установит ваше приложение только в выбранных репозиториях.
Установка частного приложения GitHub в репозитории
Создав частное приложение GitHub, вы можете установить его в один из своих организационных или пользовательских репозиториев. Дополнительные сведения см. в разделе Поток частной установки.
- На странице параметров приложений GitHub выберите свое приложение.
- На боковой панели слева щелкните Установка приложения.
- Щелкните Установить рядом с организацией или личной учетной записью, содержащей правильный репозиторий.
- Установите приложение во всех репозиториях или выберите репозитории.
- После установки вы увидите параметры конфигурации для приложения в выбранной учетной записи. Здесь можно внести изменения или повторить предыдущие действия, чтобы установить приложение в другой учетной записи.
Разрешение пользователям устанавливать общедоступное приложение в своем репозитории
Можно разрешить другим пользователям устанавливать ваше общедоступное приложение, указав URL-адрес установки в таких местах, как домашняя страница вашего приложения. Затем можно указать домашнюю страницу своего приложения с целевой страницы на GitHub.
При переходе с приложения OAuth на приложение GitHub можно использовать параметры запроса для предварительного выбора репозиториев и учетной записи при установке приложения GitHub. Дополнительные сведения см. в разделе Миграция с приложений OAuth в приложения GitHub.
В этих инструкциях предполагается, что вы создали GitHub App:
- На странице параметров приложений GitHub выберите общедоступное приложение, которое необходимо настроить, чтобы другие пользователи могли его установить.
- В поле "URL-адрес домашней страницы" введите URL-адрес домашней страницы приложения и щелкните Сохранить изменения.
- GitHub предоставляет целевую страницу для приложения, которая содержит ссылку на "URL-адрес домашней страницы" приложения. Чтобы посетить целевую страницу на GitHub, скопируйте URL-адрес из "Общедоступной ссылки" и вставьте его в браузер.
- Создайте домашнюю страницу для приложения, включающую URL-адрес для установки приложения:
http(s)://HOSTNAME/apps/<app name>/installations/new.
Авторизация пользователей во время установки
Процесс авторизации можно упростить, выполнив его во время установки приложения. Для этого выберите Запросить авторизацию пользователя (OAuth) во время установки при создании или изменении приложения в GitHub. Дополнительные сведения см. в разделе Создание приложения GitHub.
После установки приложения потребуется получить маркер доступа для пользователя. Дополнительные сведения см. в шагах 2 и 3 в разделе Идентификация пользователей на вашем сайте.
Сохранение состояния приложения во время установки
Можно указать параметр state в URL-адресе установки для приложения, чтобы сохранить состояние страницы приложения и вернуть людей в это состояние после установки, проверки подлинности или принятия обновлений для приложения GitHub. Например, можно использовать state для корреляции установки с пользователем или учетной записью.
Чтобы сохранить состояние, добавьте в URL-адрес установки:
http(s)://HOSTNAME/apps/<app name>/installations/new?state=AB12t