Установка GitHub CLI на Linux

Что такое GitHub CLI

GitHub CLI — это официальный инструмент командной строки от GitHub, который расширяет возможности Git и даёт доступ ко всем основным операциям GitHub из терминала. Кратко: упрощает работу с issue, pull request, релизами и проверками без открытия веб-интерфейса.

Важно: GitHub CLI не заменяет Git как систему контроля версий. Оно интегрируется с git и ускоряет взаимодействие с сервисом GitHub.

Почему использовать терминал вместо GUI

• Меньше контекстных переключений: всё в одном окне терминала.
• Скрипты и автоматизация: команды можно включать в CI/CD или в локальные скрипты.
• Быстрая навигация по репозиторию и метаданным проекта.

Установка GitHub CLI по дистрибуциям

Ниже — официальные команды установки. Выполняйте их в своём терминальном эмуляторе.

Debian, Ubuntu и производные

curl -fsSL https://cli.github.com/packages/githubcli-archive-keyring.gpg | sudo gpg --dearmor -o /usr/share/keyrings/githubcli-archive-keyring.gpg  
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/githubcli-archive-keyring.gpg] https://cli.github.com/packages stable main" | sudo tee /etc/apt/sources.list.d/github-cli.list > /dev/null  
sudo apt update  
sudo apt install gh

Arch Linux, Manjaro и производные

sudo pacman -S github-cli

Fedora, CentOS и RHEL

sudo dnf config-manager --add-repo https://cli.github.com/packages/rpm/gh-cli.repo  
sudo dnf install gh

openSUSE / SUSE Linux

sudo zypper addrepo https://cli.github.com/packages/rpm/gh-cli.repo  
sudo zypper ref  
sudo zypper install gh

Дополнительно: можно скачать предсобранные бинарники со страницы релизов GitHub CLI. Существует snap-пакет от сообщества, но GitHub официально не рекомендует его к использованию.

Проверка установки и быстрая авторизация

1. Проверьте версию:

gh --version

Ожидаемая реакция — вывод версии gh и список используемых компонентов.

2. Войдите в аккаунт GitHub:

gh auth login

Вас попросят выбрать метод (браузер или ввести токен). Для автоматизации используйте Personal Access Token (PAT) с нужными правами.

Быстрый справочник команд (cheat sheet)

• Клонирование репозитория (git clone остаётся стандартом):

gh repo clone owner/name

• Создание pull request:

gh pr create --base main --head feature-branch --title "Заголовок" --body "Описание"

• Просмотр и управление issue:

gh issue list
gh issue view 123

• Просмотр статуса PR в браузере:

gh pr view --web

• Список команд и подсказки:

gh help

Типичные сценарии и когда gh не подойдёт

Counterexamples/когда не подходит:

• Если вы работаете с приватными сервисами Git, не интегрированными с GitHub (например, внутренний GitLab без интеграции), gh бесполезен.
• Для низкоуровневых операций git (сложный rebase, тонкая настройка индексов) оставайтесь с git.

Альтернативы:

• GitHub Desktop — GUI для десктопа.
• git + API-скрипты на curl/HTTP для специфической автоматизации.
• Интеграции CI/CD (GitHub Actions, GitLab CI) для серверных задач.

Практическая методология установки (мини-процесс)

1. Выберите команду установки для вашей дистрибуции.
2. Установите пакет и выполните gh –version.
3. Авторизуйтесь через gh auth login.
4. Проверьте рабочий цикл: создать ветку, запушить, открыть PR.
5. Добавьте команду в ваши скрипты/alias при необходимости.

Рольные чек-листы

Для разработчика:

• Установлен gh и git
• Авторизация в аккаунте GitHub
• Настроены SSH-ключи для push
• Тест создания PR из локальной ветки

Для DevOps:

• PAT для автоматизации с минимальными правами
• Скрипты релизов используют gh release
• Мониторинг ошибок при автоматическом создании issue

Для владельца репозитория:

• Настроены branch protection
• Проверки CI запускаются на PR
• Права доступа ревьюеров заданы корректно

Безопасность и приватность

• Для автоматизации используйте Personal Access Token с минимумом прав. Если можно — применяйте GitHub Apps.
• Храните токены в менеджере секретов, а не в репозитории.
• При входе через браузер gh создаёт OAuth-сессии; завершайте сессию командой gh auth logout на общих машинах.

Частые проблемы и их решения

• Ошибка: “gh: command not found” — убедитесь, что пакет установлен и путь к бинарю в PATH.
• Ошибка авторизации — проверьте сетевые прокси и доступ к api.github.com.
• Проблемы с правами при установке — используйте sudo или установку от root.

Критерии приёмки

• gh запускается и возвращает версию
• Успешный вход: gh auth status показывает авторизованный аккаунт
• Создание тестового PR проходит без ошибок

Резюме

GitHub CLI упрощает большинство операций с GitHub из терминала и удобен для разработчиков, которые ценят скорость и автоматизацию. Установка проста и отличается лишь по пакетному менеджеру дистрибуции. После установки проверьте версию, авторизуйтесь и прогоните базовый сценарий создания PR.

Важно: храните ключи и PAT в безопасном месте и используйте минимально необходимые права.