Alteratorctl/components module

Материал из ALT Linux Wiki


Stub.png
Данная страница находится в разработке.
Эта страница ещё не закончена. Информация, представленная здесь, может оказаться неполной или неверной.

Alteratorctl components — модуль консольного приложения alteratorctl, позволяющий устанавливать, удалять компоненты и узнавать различную информацию о них.

Основная информация

Компоненты — целостный набор пакетов, обеспечивающий функциональные возможности продукта. Для управления компонентами используется приложение alt-components и данный модуль приложения alteratorctl.

Модуль использует интерфейс org.altlinux.alterator.component1 объектов установленных компонентов.

Модуль позволяет:

  • Просматривать список компонентов;
  • Просматривать информацию о компонентах (статус, описание, состав);
  • Устанавливать/удалять компоненты.

Для работы некоторых команд модуля могут потребоваться права администратора.

Использование модуля

Модуль предусматривает использование следующих команд и опций: 

$ alteratorctl components --help
Использование:
  alteratorctl components     Вывод всех компонентов в виде дерева с
                              псевдографикой
  alteratorctl components [КОМАНДА [аргументы]] [ОПЦИИ] [ПАРАМЕТРЫ <аргументы...>]

Команды:
  description <компонент>     Вывести описание компонента
  list [ОПЦИИ] [ПАРАМЕТРЫ <аргументы..>] Вывод всех компонентов с категориями
  info <компонент>            Вывести информацию о компоненте
  install <компонент>         Установить компонент
  remove <компонент>          Удалить компонент
  status <компонент>          Посмотреть статус установки компонента
  search <компонент>          Найти компонент по имени или пути на D-Bus

Параметры:
  -c, --category <категория>  Вывести список компонентов выбранной категории
  -s, --sections <section1> [section2 ...]
                              Отобразить только выбранные разделы
Опции для форматирования вывода:
  -v, --verbose               Добавить вывод путей к компонентам на DBus
  -d, --display-name-only     Показать только отображаемые имена компонентов и
                              категорий
  -D, --no-display-name       Скрыть отображаемые имена компонентов и категорий
  -e, --enable-display-name   Показать отображаемые имена компонентов и
                              категорий при выводе в виде списка
  -p, --path-only             Отобразить только пути к объектам компонентов на
                              D-Bus
  -n, --name-only             Отобразить только имена объектов компонентов
  -N, --no-name               Скрыть отображение имен компонентов и категорий

Опции для форматирования вывода списка компонентов:
  --draft                     Добавить отображение черновых компонентов
  -g, --graphic-tree          Вывести компоненты с категориями в виде дерева
                              с псевдографикой (выводится по умолчанию)
  -t, --simple-tree           Вывести компоненты с категориями в виде простого
                              дерева
  -l, --list                  Вывести компоненты с категориями в виде списка.
                              Для вывода отображаемых имён используйте опцию
                              --show-display-name (её можно использовать лишь в
                              данном представлении вывода)
  -i, --installed             Отобразить только установленные компоненты
  -u, --not-installed         Отобразить только неустановленные компоненты
  -I, --ignore-sections       Вывести все компоненты игнорируя секции текущей
                              редакции
  -L, --ignore-legend         Скрыть описание условных обозначений при выводе
                              компонентов
  -H, --hide-installation-markers
                              Скрыть маркеры со статусом установки
                              компонента/категории

Опции для установки и удаления компонентов:
  --force-yes                 Автоматическое подтверждение удаления или
                              установки компонента. Применяйте опцию с
                              осторожностью. Данное действие может привести
                              к немедленному удалению значимых для системы
                              пакетов. Используйте опцию только при полном
                              понимании последствий!

Опции для удаления компонентов:
  --allow-remove-manually     Разрешить удаление установленных вручную пакетов.
                              Использование этой опции может привести к
                              случайному удалению пакетов, необходимых для
                              работы системы
  -b, --allow-remove-base     Разрешить удаление пакетов, содержащихся в
                              базовых компонентах

Опции синхронизации с пакетной базой:
  --no-update                 Не обновлять списки пакетов перед установкой или
                              удалением компонентов

Справка:
  -h, --help                  Вызов справки модуля components
Важно! Термин «базовые компоненты» применим только в случае наличия установленной редакции. Под базовыми компонентами подразумеваются компоненты, относящиеся к одноимённому разделу текущей редакции. По умолчанию удаление базовых компонентов запрещено, равно как и удаление компонентов, содержащих пакеты, входящие в любой базовый компонент. Для удаления таких компонентов используйте опцию --allow-remove-base.

«Установленные вручную» пакеты — это пакеты, помеченные системой apt как manual. Получить список таких пакетов можно, выполнив команду apt-mark showmanual. Этот список содержит множество важных для работы системы пакетов, поэтому их удаление по умолчанию запрещено. Для удаления компонентов, включающих такие пакеты, используйте опцию --allow-remove-manually. Помните, что удаление подобных компонентов может нарушить работоспособность системы. Используйте эту опцию только при полном понимании возможных последствий!


Примечание: apt-mark showmanual выводит пакеты, помеченные как установленные вручную, то есть те, которые администратор установил явно, а не как зависимости других пакетов.

Это не значит, что пакет был установлен вручную «человеком» — флаг мог быть выставлен:

  • скриптом;
  • meta-пакетом;
  • во время установки системы.


Примеры вывода компонентов

Вывод компонентов в виде дерева с псевдографикой: 

$ alteratorctl components -g
Обозначения:
  [*] Установлен(а)
  [ ] Не установлен(а)
  [~] Частично установлен(а)
  [?] Черновой элемент (--draft) или неизвестный статус установки

Базовые компоненты (base):
┌─[ ] Документация (docs)
│  └─[ ] Документация Альт Сервер (alt-server-docs)
├─[~] Инфраструктурные решения (infra)
│  ├─[~] Доменная инфраструктура (domain-infra)
│  │  ├─[ ] FreeIPA - клиент (freeipa-client)
│  │  ├─[*] FreeIPA - сервер (freeipa-server)
│  │  ├─[ ] Samba AD - клиент (sssd) (samba-ad-client-sssd)
│  │  ├─[ ] Samba AD - клиент (winbind) (samba-ad-client-winbind)
│  │  ├─[ ] Samba AD - контроллер домена (samba-dc)
│  │  ├─[ ] Samba AD - поддержка клиентской инфраструктуры (samba-ad-client-support)
│  │  └─[ ] Шаблоны групповых политик (admx-templates)

Вывод путей объектов компонентов на D-Bus в виде дерева с псевдографикой: 

$ alteratorctl components list -p
Обозначения:
  [*] Установлен(а)
  [ ] Не установлен(а)
  [~] Частично установлен(а)
  [?] Черновой элемент (--draft) или неизвестный статус установки

Базовые компоненты (base):
┌─[~] apps
│  ├─[ ] admin-apps
│  │  └─[ ] /org/altlinux/alterator/component_samba_ad_admin_tools
│  └─[*] alterator
│     └─[*] /org/altlinux/alterator/component_alterator_base
├─[ ] docs
│  └─[ ] /org/altlinux/alterator/component_alt_server_docs
├─[~] infra
│  ├─[ ] containers
│  │  └─[ ] /org/altlinux/alterator/component_cgroup
│  ├─[~] domain-infra
│  │  ├─[ ] /org/altlinux/alterator/component_admx_templates
│  │  ├─[ ] /org/altlinux/alterator/component_freeipa_client
│  │  ├─[*] /org/altlinux/alterator/component_freeipa_server
│  │  ├─[ ] /org/altlinux/alterator/component_samba_ad_client_sssd
│  │  ├─[ ] /org/altlinux/alterator/component_samba_ad_client_support
│  │  ├─[ ] /org/altlinux/alterator/component_samba_ad_client_winbind
│  │  └─[ ] /org/altlinux/alterator/component_samba_dc

Вывод списка установленных компонентов: 

$ alteratorctl components list -l -i
Обозначения:
  [*] Установлен(а)
  [ ] Не установлен(а)
  [~] Частично установлен(а)
  [?] Черновой элемент (--draft) или неизвестный статус установки

base:
[*] /apps/alterator/alterator-base
[*] /system/archiving/cpio
[*] /system/archiving/p7zip
[*] /system/archiving/unzip
[*] /system/boot/boot-utils
[*] /system/boot/grub
[*] /system/core/base
[*] /system/core/init-other

Вывод статуса компонента: 

$ alteratorctl components status samba-dc
Компонент: Samba AD - контроллер домена
Категория: Доменная инфраструктура
Статус: не установлен
Список пакетов, входящих в компонент:
[*] bind-utils
[ ] samba-winbind-clients
[ ] task-samba-dc

Установка и удаление компонентов

Установка компонента (установка может занять какое-то время): 

# alteratorctl components install samba-dc
Устанавливаемые пакеты:
task-samba-dc
samba-winbind-clients

Удаление компонента: 

# alteratorctl components remove samba-dc
Удаляемые пакеты:
bind-utils
task-samba-dc
samba-winbind-clients