Alteratorctl/components module: различия между версиями
Savelevsa (обсуждение | вклад) |
Мария (обсуждение | вклад) |
||
(не показано 7 промежуточных версий 1 участника) | |||
Строка 10: | Строка 10: | ||
<noinclude>[[Категория:Неоконченные страницы|{{PAGENAME}}]]</noinclude> | <noinclude>[[Категория:Неоконченные страницы|{{PAGENAME}}]]</noinclude> | ||
'''Alteratorctl components''' — модуль консольного приложения [[Alteratorctl|alteratorctl]], позволяющий устанавливать, удалять компоненты и узнавать различную информацию о них. | '''Alteratorctl components''' — модуль консольного приложения [[Alteratorctl|alteratorctl]], позволяющий устанавливать, удалять '''компоненты''' и узнавать различную информацию о них. | ||
=== Основная информация === | === Основная информация === | ||
'''Компоненты''' — целостный набор пакетов, обеспечивающий функциональные возможности продукта. Для управления компонентами используется приложение [[Alt-components|'''alt-components''']] и данный модуль приложения alteratorctl. | |||
Модуль использует интерфейс <tt>org.altlinux.alterator.component1</tt> объектов установленных компонентов. | Модуль использует интерфейс <tt>org.altlinux.alterator.component1</tt> объектов установленных '''компонентов'''. | ||
Модуль позволяет: | Модуль позволяет: | ||
* Просматривать список компонентов; | * Просматривать список '''компонентов'''; | ||
* Просматривать информацию о компонентах (статус, описание, состав); | * Просматривать информацию о '''компонентах''' (статус, описание, состав); | ||
* Устанавливать/удалять компоненты. | * Устанавливать/удалять '''компоненты'''. | ||
Для работы некоторых команд модуля могут потребоваться права администратора. | Для работы некоторых команд модуля могут потребоваться права администратора. | ||
=== Использование модуля === | === Использование модуля === | ||
Модуль предусматривает использование следующих команд и опций: | Модуль предусматривает использование следующих команд и опций: | ||
< | <source lang="text" highlight="1"> | ||
$ alteratorctl components --help | |||
alteratorctl components | Использование: | ||
alteratorctl components [КОМАНДА [аргументы]] [ОПЦИИ] [ПАРАМЕТРЫ < | alteratorctl components Вывод всех компонентов в виде дерева с | ||
псевдографикой | |||
alteratorctl components [КОМАНДА [аргументы]] [ОПЦИИ] [ПАРАМЕТРЫ <аргументы...>] | |||
Команды: | Команды: | ||
description < | description <компонент> Вывести описание компонента | ||
list [ОПЦИИ] [ПАРАМЕТРЫ < | list [ОПЦИИ] [ПАРАМЕТРЫ <аргументы..>] Вывод всех компонентов с категориями | ||
info < | info <компонент> Вывести информацию о компоненте | ||
install < | install <компонент> Установить компонент | ||
remove < | remove <компонент> Удалить компонент | ||
status < | status <компонент> Посмотреть статус установки компонента | ||
Параметры: | Параметры: | ||
-c, --category < | -c, --category <категория> Вывести список компонентов выбранной категории | ||
Опции: | Опции: | ||
--draft | --draft Добавить отображение черновых компонентов | ||
-I, --ignore-sections | -I, --ignore-sections Вывести все компоненты игнорируя секции текущей | ||
-L, --ignore-legend | редакции | ||
-g, --graphic-tree | -L, --ignore-legend Скрыть описание условных обозначений при выводе | ||
-t, --simple-tree | компонентов | ||
-l, --list | -g, --graphic-tree Вывести компоненты с категориями в виде дерева | ||
с псевдографикой (выводится по умолчанию) | |||
-t, --simple-tree Вывести компоненты с категориями в виде простого | |||
дерева | |||
- | -l, --list Вывести компоненты с категориями в виде списка | ||
-d, --display-name-only | Для вывода отображаемых имён используйте опцию | ||
-D, --no-display-name | --show-display-name (её можно использовать лишь в | ||
- | данном представлении вывода) | ||
-n, --name-only | -v, --verbose Добавить вывод путей к компонентам на DBus | ||
-N, --no-name | -d, --display-name-only Показать только отображаемые имена компонентов и | ||
- | категорий | ||
-D, --no-display-name Скрыть отображаемые имена компонентов и категорий | |||
-p, --path-only Отобразить только пути к объектам компонентов | |||
-n, --name-only Отобразить только имена объектов компонентов | |||
-N, --no-name Скрыть отображение имён компонентов и категорий | |||
--no-update Не обновлять списки пакетов перед установкой или | |||
удалением компонента | |||
=== Примеры | -s, --show-display-name Показать отображаемые имена компонентов и | ||
Вывод компонентов в виде дерева с псевдографикой: | категорий при выводе в виде списка | ||
-i, --installed Отобразить только установленные компоненты | |||
-u, --not-installed Отобразить только неустановленные компоненты | |||
-h, --help Вызов справки модуля components | |||
</source> | |||
=== Примеры вывода компонентов === | |||
Вывод '''компонентов''' в виде дерева с псевдографикой: | |||
<source lang="text" highlight="1"> | <source lang="text" highlight="1"> | ||
$ alteratorctl components -g | $ alteratorctl components -g | ||
Строка 92: | Строка 99: | ||
</source> | </source> | ||
Вывод путей объектов '''компонентов''' на D-Bus в виде дерева с псевдографикой: | |||
Вывод путей объектов компонентов на D-Bus в виде дерева с псевдографикой: | |||
<source lang="text" highlight="1"> | <source lang="text" highlight="1"> | ||
$ alteratorctl components list -p | $ alteratorctl components list -p | ||
Строка 168: | Строка 129: | ||
</source> | </source> | ||
Вывод списка установленных компонентов: | Вывод списка установленных '''компонентов''': | ||
<source lang="text" highlight="1"> | <source lang="text" highlight="1"> | ||
$ alteratorctl components list -l -i | $ alteratorctl components list -l -i | ||
Строка 187: | Строка 148: | ||
[*] /system/core/init-other | [*] /system/core/init-other | ||
</source> | </source> | ||
Вывод статуса '''компонента''': | |||
<source lang="text" highlight="1,10,17,22"> | <source lang="text" highlight="1,10,17,22"> | ||
$ alteratorctl components status samba-dc | $ alteratorctl components status samba-dc | ||
Строка 217: | Строка 159: | ||
[ ] samba-winbind-clients | [ ] samba-winbind-clients | ||
[ ] task-samba-dc | [ ] task-samba-dc | ||
</source> | |||
=== Установка и удаление компонентов === | |||
Установка '''компонента''' (установка может занять какое-то время): | |||
<source lang="text" highlight="1,10,17,22"> | |||
# alteratorctl components install samba-dc | # alteratorctl components install samba-dc | ||
Устанавливаемые пакеты: | Устанавливаемые пакеты: | ||
task-samba-dc | task-samba-dc | ||
samba-winbind-clients | samba-winbind-clients | ||
</source> | </source> | ||
Удаление компонента: | Удаление '''компонента''': | ||
<source lang="text" highlight="1,7"> | <source lang="text" highlight="1,7"> | ||
# alteratorctl components remove samba-dc | # alteratorctl components remove samba-dc | ||
Строка 247: | Строка 178: | ||
task-samba-dc | task-samba-dc | ||
samba-winbind-clients | samba-winbind-clients | ||
</source> | </source> |
Текущая версия от 14:37, 4 июня 2025
Alteratorctl components — модуль консольного приложения alteratorctl, позволяющий устанавливать, удалять компоненты и узнавать различную информацию о них.
Основная информация
Компоненты — целостный набор пакетов, обеспечивающий функциональные возможности продукта. Для управления компонентами используется приложение alt-components и данный модуль приложения alteratorctl.
Модуль использует интерфейс org.altlinux.alterator.component1 объектов установленных компонентов.
Модуль позволяет:
- Просматривать список компонентов;
- Просматривать информацию о компонентах (статус, описание, состав);
- Устанавливать/удалять компоненты.
Для работы некоторых команд модуля могут потребоваться права администратора.
Использование модуля
Модуль предусматривает использование следующих команд и опций:
$ alteratorctl components --help
Использование:
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 (её можно использовать лишь в
данном представлении вывода)
-v, --verbose Добавить вывод путей к компонентам на DBus
-d, --display-name-only Показать только отображаемые имена компонентов и
категорий
-D, --no-display-name Скрыть отображаемые имена компонентов и категорий
-p, --path-only Отобразить только пути к объектам компонентов
-n, --name-only Отобразить только имена объектов компонентов
-N, --no-name Скрыть отображение имён компонентов и категорий
--no-update Не обновлять списки пакетов перед установкой или
удалением компонента
-s, --show-display-name Показать отображаемые имена компонентов и
категорий при выводе в виде списка
-i, --installed Отобразить только установленные компоненты
-u, --not-installed Отобразить только неустановленные компоненты
-h, --help Вызов справки модуля components
Примеры вывода компонентов
Вывод компонентов в виде дерева с псевдографикой:
$ 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