Topgrade — как обновлять весь Linux одной командой

Зачем читать это руководство

Если вы тратите время вручную на отдельные менеджеры пакетов, инструменты и SDK, Topgrade может объединить эти действия в одну последовательность. Это полезно как для домашних пользователей, так и для администраторов, которые хотят быстро поддерживать отдельные машины в актуальном состоянии перед развёртыванием или отладкой.

В этой статье вы найдёте:

• Краткое объяснение того, что делает Topgrade.
• Поддерживаемые дистрибутивы и менеджеры пакетов.
• Пошаговую установку и настройку $PATH для Bash/Zsh.
• Полное руководство по основным опциям и сценарию автоматизации (systemd timer и cron).
• Руководство по конфигурации, распространённым ошибкам и способам восстановления.
• Чек-листы для разных ролей и рекомендации по безопасности.

Что такое Topgrade

Topgrade — утилита CLI, написанная на Rust, которая последовательно запускает команды обновления для множества системных и сторонних менеджеров пакетов и инструментов. Она не «изобретает» свои собственные обновления: Topgrade запускает нативные команды (apt, dnf, pacman, snap, flatpak, pip, npm и т. п.) и объединяет их в удобный единый рабочий процесс.

Определение в одну строку: инструмент-обёртка, автоматизирующий исполнение команд обновления для широкого набора менеджеров и утилит.

Какие компоненты умеет обновлять Topgrade

Topgrade поддерживает большинство популярных дистрибутивов и наборов инструментов:

• Дистрибутивы: Debian/Ubuntu, RHEL/Fedora, Arch Linux, openSUSE, Gentoo, Clear Linux, Void Linux.
• Сторонние менеджеры: Snap, Flatpak, Homebrew (Linuxbrew), Cargo, Pip, NPM/Yarn, SDKMAN/Flutter, VSCode/Extensions, tmux, Vim/Neovim, Pi-hole и др.

Важно: поддержка конкретного пакета определяется списком «проверок» (checks) внутри Topgrade. Если нужного check нет, его можно добавить в конфигурации как пользовательскую команду.

Как установить Topgrade на Linux

Основной способ установки — через Cargo (менеджер пакетов для Rust). Ниже — варианты и дополнительные примечания по правам доступа.

Важно: если у вас нет Rust/Cargo, установка потребует зависимостей (compilers/ssl dev-пакетов) и прав на запись в ~/.cargo/bin.

Установка зависимостей (пример для Debian/Ubuntu)

Откройте терминал и выполните:

sudo apt update
sudo apt install cargo libssl-dev pkg-config build-essential

Примечание: на других дистрибутивах установка зависимостей будет отличаться (dnf/zygote/pacman). Для Fedora используйте dnf install cargo openssl-devel pkgconf-pkg-config, для Arch — pacman -S cargo openssl pkgconf и т.д.

Установка Topgrade через Cargo

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

cargo install topgrade

По окончании сборки Cargo сообщит путь установки, обычно ~/.cargo/bin/topgrade, и при необходимости предложит добавить этот путь в переменную окружения $PATH.

Если вы хотите временно добавить путь в текущую сессию (однократно), выполните:

export PATH=$PATH:/home/username/.cargo/bin

Для постоянного добавления — откройте ~/.profile, ~/.bashrc или ~/.zshrc и добавьте ту же строку, заменив /home/username на ваш домашний путь. После правки перезагрузите сессию или выполните source ~/.bashrc.

Альтернатива: если вы используете пакетную систему дистрибутива и Topgrade есть в репозитории, предпочтительнее установить из пакета. Также возможна сборка из исходников через GitHub-репозиторий Topgrade.

Базовое использование Topgrade

Запуск без аргументов инициирует полный проход по всем проверкам и обновлениям. Просто выполните:

topgrade

Вы увидите последовательность проверок. При каждом действии Topgrade может предлагать подтверждение. Для подтверждения нажмите Y, для пропуска — N. Для отмены выполнения нажмите Ctrl+C, затем в появившемся промпте введите q.

Полезные флаги и примеры

• Только посмотреть, что будет сделано (dry run):

topgrade --dry-run

Этот режим полезен для оценки действий без выполнения изменений.

• Отключить конкретную проверку (исключить пакет или утилиту):

topgrade --disable vim

• Обновить только одну проверку (например, vim):

topgrade --only vim

• Очистить временные и старые файлы, которые Topgrade может удалить:

topgrade --cleanup

• Подробный вывод действий:

topgrade --verbose

Verbose вывод показывает, какие команды запускает Topgrade, их stdout/stderr и код возврата.

• Редактирование конфигурации:

topgrade --edit-config

Это откроет файл конфигурации в редакторе по умолчанию (обычно $EDITOR). Если редактор не настроен, можно явно указать переменную окружения EDITOR, например export EDITOR=nano.

Структура и примеры конфигурации Topgrade

Конфигурационный файл Topgrade обычно находится в ~/.config/topgrade.toml или похожем пути и содержит список checks, секции Custom Commands и pre-commands.

Ключевые моменты конфигурации:

• Каждая проверка может быть включена или отключена с помощью символа # (комментарий).
• Можно добавлять собственные команды, которые будут запускаться как отдельные шаги.
• Можно указать порядок выполнения через разделы pre/post.

Пример минимального фрагмента конфигурации (toml):

# пример ~/.config/topgrade.toml

[checks.vim]
enabled = true

[checks.pip]
enabled = true

[custom-commands]
# команда будет запущена как отдельный шаг
my_backup = "rsync -av --delete /etc /backup/etc"

[pre-commands]
# команда, которая выполнится перед основными проверками
prepare = "systemctl stop my-service"

[post-commands]
restore = "systemctl start my-service"

Совет: добавляйте критичные pre-commands (остановка сервисов) только в явной конфигурации и документируйте их. Всегда тестируйте конфигурацию в dry-run перед применением на рабочей системе.

Автоматизация: когда и как запускать Topgrade автоматически

Topgrade удобно запускать как фоновую задачу по расписанию. Ниже — рекомендации для одного хоста.

Важно: автоматическое обновление — это компромисс между актуальностью и стабильностью. На production-системах лучше применять staged-обновления и тестирование.

Systemd timer (рекомендуется для систем с systemd)

Создайте юнит /etc/systemd/system/topgrade.timer:

[Unit]
Description=Topgrade periodic run

[Timer]
OnCalendar=daily
Persistent=true

[Install]
WantedBy=timers.target

И сопутствующий сервис /etc/systemd/system/topgrade.service:

[Unit]
Description=Run topgrade

[Service]
Type=oneshot
User=yourusername
Environment=HOME=/home/yourusername
ExecStart=/home/yourusername/.cargo/bin/topgrade --cleanup --only package

Замените yourusername и путь к topgrade на ваши значения. Включите и запустите таймер:

sudo systemctl daemon-reload
sudo systemctl enable --now topgrade.timer

Преимущества systemd timer: логирование в journal, гибкость расписания, контроль пользователя.

Cron (альтернатива)

Для простых задач можно добавить запись в crontab пользователя:

0 3 * * * /home/yourusername/.cargo/bin/topgrade --cleanup --disable snap > /home/yourusername/topgrade.log 2>&1

Cron проще, но менее интегрирован с современными системными инструментами.

Типичные ошибки и как их решать

• Проблема: topgrade не найден после установки через cargo.

  • Решение: добавьте ~/.cargo/bin в $PATH для текущего пользователя и/или в профиль оболочки.

• Проблема: check завершается с ошибкой разрешений при попытке обновить системный пакет.

  • Решение: запускайте Topgrade от имени пользователя, а команды, требующие sudo, выполняйте при явном подтверждении или настройте sudoers для безопасного безпарольного выполнения отдельных команд (требует осторожности).

• Проблема: конфликтующие зависимости после обновления.

  • Решение: откатить изменения для проблемного менеджера (пример: apt-get install –reinstall пакет или использовать снапшоты LVM/Btrfs/VM) и вручную решить зависимостную задачу.

• Проблема: автоматический запуск ломает службу.

  • Решение: используйте pre- и post-commands в конфиге для корректной остановки/запуска сервисов или держите Topgrade в dry-run режиме до подтверждения.

Когда Topgrade не подходит

• Масштабная инфраструктура: для сотен или тысяч хостов лучше использовать Ansible, Salt, Puppet, Chef или платформы управления конфигурацией, где имеется аудит и контроль изменений.
• Критичные production-системы: автоматические обновления без тестирования могут привести к простоям; используйте staged-пайплайн и тестовые среды.
• Если требуется атомарность и откат всех обновлений одновременно — Topgrade запускает независимые команды и не обеспечивает централизованный откат.

Альтернативные подходы

• Distro-native unattended upgrades (например unattended-upgrades в Debian/Ubuntu, dnf-automatic в Fedora) — хороши для сервисных или безопасности-ориентированных обновлений.
• Менеджеры пакетов + lock-файлы и CI/CD-пайплайны: подходят для управляемых развёртываний.
• Инструменты управления конфигурацией (Ansible и т. п.) — для масштабируемых и проверяемых обновлений.

Риски и меры снижения

Риски:

• Непредвиденные конфликты пакетов.
• Изменения конфигурации сервисов при обновлении.
• Неожиданные перезагрузки ядра/сервисов.

Митигаторы:

• Делать резервные копии/снимки перед массовым обновлением.
• Использовать dry-run и verbose перед фактическим запуском.
• Запускать обновления в периоды низкой нагрузки и иметь план отката.

Чек-листы по ролям

Чек-лист для домашнего пользователя:

• Установил Topgrade и добавил в $PATH.
• Прогнал topgrade –dry-run.
• Запустил topgrade вручную и подтвердил критичные действия.
• Настроил периодический запуск в systemd timer (опционально).

Чек-лист для разработчика (локальная рабочая станция):

• Проверил обновления SDK (Flutter, Node) отдельно через –only.
• Убедился, что локальные конфигурации (dotfiles, плагины Vim) не будут затёрты.
• Настроил backup конфигов и точку восстановления.

Чек-лист для системного администратора:

• Оценил влияние обновлений на сервисы (pre/post-commands).
• Добавил мониторинг и алерты для критичных сервисов.
• Тестировал автоматический запуск на непроизводственной машине.

Скорость и порядок действий — эвристики

• Обновляйте рабочие станции еженедельно или по мере необходимости.
• Для серверов безопасности — устанавливайте только критичные патчи как можно быстрее, а остальное — по расписанию с тестированием.
• Всегда сначала dry-run, затем ограниченный run (только ключевые checks), и только после — полный проход.

Пример сценариев восстановления

Если обновление привело к сбою:

1. Остановите дальнейшее выполнение (Ctrl+C) и зафиксируйте вывод verbose.
2. Восстановите конфигурационные файлы из резервной копии.
3. Откатите проблемный пакет (apt/dnf/pacman rollback) или восстановите снапшот тома.
4. Проанализируйте причины: несовместимость, сломанный репозиторий, конфликт зависимостей.
5. Зафиксируйте решение в документации и, при необходимости, внесите исключение (–disable) до исправления.

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

• Topgrade завершил run без ошибок (код возврата 0) или с документированными ожидаемыми предупреждениями.
• Все критичные сервисы успешно перезапущены и прошли health-check.
• Резервные копии и журналы обновлений сохранены для последующего анализа.

Короткая шпаргалка команд (cheat sheet)

• Установить: cargo install topgrade
• Просмотр: topgrade –dry-run
• Полный запуск: topgrade
• Тихая очистка: topgrade –cleanup
• Только конкретный пакет: topgrade –only vim
• Отключить проверку: topgrade –disable snap
• Подробно: topgrade –verbose
• Редактировать конфиг: topgrade –edit-config

Безопасность и конфиденциальность

Topgrade сам по себе запускает системные команды; он не отправляет ваши данные куда-либо удалённо. Тем не менее:

• Не давайте Topgrade полномочий sudo без явной необходимости.
• Избегайте хранения секретов в пользовательских custom-commands.
• Анализируйте и документируйте pre/post-commands, чтобы не раскрывать конфиденциальные данные в логах.

Частые вопросы (mini FAQ)

Что делать, если Topgrade пытается обновить пакет, который ломает систему?

• Используйте –disable для этого check, восстановите систему из снапшота и разберитесь с пакетом вручную.

Можно ли использовать Topgrade в CI/CD?

• Для одиночных машин да, но для массовых и воспроизводимых развёртываний лучше применять специализированные инструменты деплоя.

Короткое резюме

Topgrade — удобный инструмент для сокращения рутины обновлений на отдельной машине: он объединяет множество менеджеров пакетов и утилит в один рабочий процесс. Хорошо подходит для рабочих станций и одиночных серверов, но требует осторожности и тестирования на критичных системах. Используйте dry-run, настройте конфиг и автоматизацию через systemd timer или cron, а в масштабируемой инфраструктуре рассматривайте управление конфигурацией.

Important: прежде чем автоматизировать обновления, убедитесь, что у вас есть план отката и актуальные резервные копии.