Исправление: add-apt-repository — команда не найдена

Кратко: Если при добавлении репозитория вы видите «add-apt-repository: command not found», это означает, что инструмент находится в пакете software-properties-common и не установлен. Установите его и затем повторите команду; ниже — подробная инструкция, альтернативы и проверки.

Что значит сообщение «add-apt-repository: command not found»

На системах на базе Debian (включая Ubuntu) управление программным обеспечением обычно выполняется через APT (Advanced Package Tool). APT ищет, устанавливает, обновляет и удаляет пакеты из репозиториев — удалённых коллекций пакетов.

Типичные команды для установки и удаления пакетов:

sudo apt install package-name
sudo apt remove package-name
sudo apt purge package-name

Список репозиториев, настроенных в системе, можно посмотреть так:

cat /etc/apt/sources.list
ls /etc/apt/sources.list.d/

Если нужного пакета нет в стандартных репозиториях, вы добавляете новый репозиторий командой add-apt-repository. Например, чтобы добавить PPA для QuiteRSS, выполняют:

sudo add-apt-repository ppa:quiterss/quiterss
sudo apt update
sudo apt install quiterss

Если при попытке запустить add-apt-repository вы видите:

это значит, что утилита не установлена в системе. На большинстве современных Debian/Ubuntu эта утилита входит в пакет software-properties-common.

Как исправить ошибку

1. Обновите индекс пакетов и установите нужный пакет:

sudo apt update
sudo apt install software-properties-common

2. Повторите добавление репозитория:

sudo add-apt-repository ppa:quiterss/quiterss
sudo apt update
sudo apt install quiterss

Если напрямую пытаться установить пакет с именем add-apt-repository, APT выдаст «Unable to locate package add-apt-repository», потому что такой отдельный пакет отсутствует — это часть software-properties-common.

Быстрая проверка и типичные проблемы

• Убедитесь, что у вас есть подключение к интернету и обновлённый индекс пакетов (sudo apt update).
• Проверьте, что вы запускаете команду с sudo или как root.
• На очень старых дистрибутивах утилита могла находиться в пакете python-software-properties; в современных — software-properties-common.
• Если apt жалуется на блокировку, дождитесь завершения другой операции apt или завершите зависший процесс (осторожно).

Альтернативные способы добавить репозиторий

• Ручное добавление файла в /etc/apt/sources.list.d/: создайте файл с расширением .list и добавьте туда строку репозитория. Затем выполните sudo apt update.
• Использовать графический интерфейс «Программы и обновления» (Software & Updates) в Ubuntu — удобно для настольных пользователей.
• Если репозиторий поставляется в виде .deb, можно скачать пакет и установить через sudo dpkg -i package.deb (после этого выполнить sudo apt -f install для исправления зависимостей).

Important: всегда проверяйте источник репозитория. PPA предназначены для Ubuntu; на Debian их использование может быть рискованным.

Когда это решение не сработает

• Репозиторий больше недоступен или содержит неправильные метаданные — тогда add-apt-repository успешно выполнится, но apt update выдаст ошибки.
• Вы работаете в сильно ограниченном окружении без доступа к сети или с прокси, блокирующим запросы.
• На кастомных сборках Linux инструмент управления пакетами может отличаться (не APT).

Ошибки и способы устранения (мини-руководство)

• Ошибка: «E: Unable to locate package software-properties-common» — убедитесь в подключении к интернету и что у вас включены стандартные репозитории в /etc/apt/sources.list.
• Ошибка: «The following signatures couldn’t be verified» — репозиторий не подписан или ключ не добавлен; добавьте ключ через apt-key (устаревший) или gpg и разместите его в /etc/apt/trusted.gpg.d/ (рекомендуется проверить документацию конкретного репозитория).
• Ошибка: блокировка apt (Could not get lock) — проверьте процессы apt/dpkg и дождитесь их завершения или аккуратно завершите, если это безопасно.

Роль-based чеклист

• Пользователь (настольный):

  • Убедиться, что нужна именно PPA или внешний репозиторий.
  • Установить software-properties-common и добавить репозиторий.
  • Выполнить sudo apt update и установить пакет.

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

  • Проверить совместимость репозитория с версией дистрибутива.
  • Проверить подписи и политики безопасности.
  • Документировать изменения и, при необходимости, добавить репозиторий через конфигурационное управление (Ansible/Chef/Puppet).

• DevOps/CI:

  • Включить установку software-properties-common в образ или в скрипт подготовки.
  • Проверить, что сборка не зависит от интерактивного запроса лицензий.

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

• После установки software-properties-common команда add-apt-repository выполняется без ошибки.
• Репозиторий успешно добавлен в /etc/apt/sources.list.d/ или в sources.list.
• sudo apt update проходит без критических ошибок и пакет устанавливается.

Краткий словарь

• APT — система управления пакетами для Debian-подобных систем.
• Репозиторий — удалённое хранилище пакетов.
• PPA — Personal Package Archive, обычно для Ubuntu.

Итог

Утилита add-apt-repository — удобный способ добавить внешний репозиторий, но она не всегда предустановлена. Установка пакета software-properties-common решает проблему в большинстве случаев. Перед добавлением репозитория проверяйте его происхождение и совместимость с вашим дистрибутивом.

Примечание: безопасность репозиториев — ваша ответственность. Всегда проверяйте источники и подписи перед установкой ПО.