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

GitHub — популярный сервис для размещения кода и управления версиями. Для удобства разработчиков GitHub выпускает официальную утилиту командной строки gh, которая позволяет выполнять большинство операций веб-интерфейса прямо из терминала.

Ниже — пошаговая инструкция по установке GitHub CLI на распространённые дистрибуции Linux, советы по проверке установки и краткая шпаргалка по основным командам.

Как выбрать метод установки

Коротко: используйте системный пакетный менеджер для вашего дистрибутива (APT, DNF, Pacman, Zypper). Если нужна переносимая версия — скачайте предварительно собранный бинарник с релизов. Snap-пакет поддерживается сообществом, но официально не рекомендуется.

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

Установка по дистрибутивам

Обратите внимание: команды нужно выполнять с привилегиями суперпользователя (sudo) там, где это требуется.

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

Если команда curl недоступна, установите её через sudo apt install curl.

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

На RHEL/CentOS возможно потребуется включить соответствующие репозитории EPEL до установки.

openSUSE / SUSE Linux

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

Универсальный вариант: бинарный релиз

Если вы не хотите добавлять репозитории, загрузите нужный архив с релизной страницы GitHub CLI и распакуйте в /usr/local/bin или другой каталог в PATH. Этот метод полезен для изолированных или офлайн-систем.

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

После установки выполните:

gh --version

Ожидаемый вывод содержит версию утилиты: пример “gh version X.Y.Z (архитектура)”.

Затем авторизуйте утилиту для доступа к вашему аккаунту GitHub:

gh auth login

Следуйте подсказкам: можно выбрать HTTPS или SSH и способ авторизации (веб-браузер или токен).

Базовая шпаргалка команд

• gh repo clone <владелец/репозиторий> — клонировать репозиторий
• gh issue list — показать issues
• gh pr list — показать pull request
• gh pr create — создать PR
• gh auth status — статус авторизации
• gh help — помошь и справка по командам

Эти команды сокращают количество переключений между редактором и браузером.

Когда GitHub CLI может не подойти

• Если у вас ограниченные политики безопасности и запрещён доступ к внешним репозиториям — лучше использовать системные mirror-репозитории или вручную скачивать бинарники.
• Для очень старых дистрибутивов пакет может отсутствовать; используйте бинарный релиз.
• Если вы работаете в GUI-ориентированном рабочем процессе и не используете терминал — веб-интерфейс может быть удобнее.

Отладка и типичные проблемы

• Ошибка при добавлении ключа APT: проверьте, что команда curl/gpg установлены и что у вас есть права записи в /usr/share/keyrings.
• Проблемы с DNF/Zypper: убедитесь, что TLS-сертификаты актуальны и сеть разрешает доступ к cli.github.com.
• При невозможности авторизоваться: используйте gh auth login --with-token и создайте персональный токен в настройках GitHub.

Роли и чек-лист установки

Разработчик:

• Проверить версию: gh --version
• Авторизоваться: gh auth login
• Попробовать клонирование: gh repo clone

Системный администратор:

• Проверить добавление репозиториев и ключей (APT/DNF/Zypper)
• Настроить обновления через пакетный менеджер
• Задокументировать источник пакетов для команды

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

• Команда gh --version возвращает номер версии.
• gh auth status показывает авторизацию с корректным пользователем.
• Участник команды может клонировать и создавать PR через gh.

Быстрая методика выбора подхода

1. Узнайте дистрибутив: cat /etc/os-release.
2. Если есть пакет в официальном менеджере — используйте его.
3. Если пакет отсутствует или нужна специфичная версия — скачайте бинарник.
4. Проверьте и задокументируйте команды проверки.

Сводка

GitHub CLI экономит время: большинство операций GitHub можно выполнить из терминала. Установка проста для популярных дистрибутивов и занимает несколько минут. После установки обязательно проверьте версию и авторизацию.

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