Alteratorctl/components module

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

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

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

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

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

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

Информация по компонентам

Компонент — набор пакетов, предоставляющих определённую функциональность, и некоторую последовательность действий (deploy) для их конфигурации.

Структура компонента

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

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

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

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

Команды:
description <название компонента>       получить описание выбранного компонента.
list [ОПЦИИ] [ПАРАМЕТРЫ <аргументы…>]   вывести все компоненты с категориями.
info <название компонента>              получить информацию о выбранном компоненте.
install <название компонента>           установить выбранный компонент.
remove <название компонента>            удалить выбранный компонент.
status <название компонента>            узнать статус установки компонента (установлен/не установлен).

Параметры:
-c, --category <название категории>     вывести список всех компонентов выбранной категории.

Опции:
--draft                                 выводить черновые компоненты и категории.
-I, --ignore-sections                   игнорировать секции редакции при выводе компонентов.
-L, --ignore-legend                     игнорировать вывод условных обозначений при выводе компонентов.
-g, --graphic-tree                      вывести компоненты и категории в виде дерева с псевдографикой.
-t, --simple-tree                       вывести компоненты и категории в виде простого дерева.
-l, --list                              вывести компоненты и категории в виде списка.
                                        для вывода отображаемых имён можно использовать опцию --show-display-name 
                                        (опция используется только в данном представлении вывода компонентов).
--no-update                             не обновлять списки пакетов перед установкой или удалением компонента.
-p, --path-only                         отобразить пути объектов компонентов на D-Bus.
-d, --display-name-only                 показать только отображаемые имена компонентов и категорий.
-D, --no-display-name                   скрыть отображаемые имена компонентов и категорий.
-s, --show-display-name                 показывать отображаемые имена компонентов и категорий.
-n, --name-only                         отобразить только имена объектов компонентов.
-N, --no-name                           скрыть отображение имён компонентов и категорий.
-i, --installed                         отображать только установленные компоненты.
-u, --uninstalled                       отображать только неустановленные компоненты.
-h, --help                              вызвать справку модуля components.

Примеры использования модуля

1. Отображение категорий и компонентов.
   • Команда alteratorctl components -g выведет компоненты в виде дерева с псевдографикой:

   

   В данном случае команда alteratorctl components -g будет аналогичная команде alteratorctl components

   • Команда alteratorctl components -t выводит компоненты в виде простого дерева:

   

   • Команда alteratorctl components -l выводит компоненты в виде списка:

   

   • Также можно вывести список компонентов с отображением их имён, а не только имён объектов при помощи команды alteratorctl components -l —show-display-name:

   

   • Команда alteratorctl components list -p выводит пути объектов компонентов на D-Bus в виде дерева с псевдографикой:

   

2. Отображение статусов компонентов.
   • Команда alteratorctl components list -l -i выведет список установленных на данный момент компонентов:

   

   • Команда alteratorctl components list -l -u выведет список не установленных компонентов:

   

3. Установка и удаление компонентов.
   • Команда alteratorctl components description samba-dc позволит посмотреть описание компонента samba-dc, а команда alteratorctl components install samba-dc позволит его установить:

   

   • Команда alteratorctl components remove samba-dc позволит удалить компонент samba-dc: