Просмотр кода страницы Alteratorctl/components module

[[Category:Sisyphus]]
[[Category:Alterator_на_D-Bus]]

{| style="border:1px solid #AAA; background:#F9F9F9; width:200px; margin: 0 0 1em 1em; padding:.2em; text-align:center; float: right;" class=noprint
|-
|[[Image:stub.png]]
|-
| '''Данная страница находится в [[:Категория:Неоконченные страницы|разработке]]'''.<br /><small style="line-height:1.1em;">Эта страница ещё не закончена. Информация, представленная здесь, может оказаться неполной или неверной.</small>
|}
<noinclude>[[Категория:Неоконченные страницы|{{PAGENAME}}]]</noinclude>

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

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

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

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

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

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

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

=== Использование модуля ===
Модуль предусматривает использование следующих команд и опций:
<pre>
Формат использования:
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.
</pre>

=== Примеры использования модуля ===
# Отображение категорий и компонентов.
#* Команда <code>alteratorctl components -g</code> выведет компоненты в виде дерева с псевдографикой:
#: [[Файл:Alteratorctl-components1.png|600px|alteratorctl-components1.png]]
#: В данном случае команда <code>alteratorctl components -g</code> будет аналогичная команде <code>alteratorctl components</code>
#* Команда <code>alteratorctl components -t</code> выводит компоненты в виде простого дерева:
#: [[Файл:Alteratorctl-components2.png|600px|alteratorctl-components2.png]]
#* Команда <code>alteratorctl components -l</code> выводит компоненты в виде списка:
#: [[Файл:Alteratorctl-components3.png|600px|alteratorctl-components3.png]]
#* Также можно вывести список компонентов с отображением их имён, а не только имён объектов при помощи команды <code>alteratorctl components -l —show-display-name</code>:
#: [[Файл:Alteratorctl-components4.png|600px|alteratorctl-components4.png]]
#* Команда <code>alteratorctl components list -p</code> выводит пути объектов компонентов на D-Bus в виде дерева с псевдографикой:
#: [[Файл:Alteratorctl-components5.png|600px|alteratorctl-components5.png]]
# Отображение статусов компонентов.
#* Команда <code>alteratorctl components list -l -i</code> выведет список установленных на данный момент компонентов:
#: [[Файл:Alteratorctl-components9.png|600px|alteratorctl-components9.png]]
#* Команда <code>alteratorctl components list -l -u</code> выведет список не установленных компонентов:
#: [[Файл:Alteratorctl-components6.png|600px|alteratorctl-components6.png]]
# Установка и удаление компонентов.
#* Команда <code>alteratorctl components description</code> samba-dc позволит посмотреть описание компонента samba-dc, а команда <code>alteratorctl components install samba-dc</code> позволит его установить:
#: [[Файл:Alteratorctl-components7.png|600px|alteratorctl-components7.png]]
#* Команда <code>alteratorctl components remove samba-dc</code> позволит удалить компонент samba-dc:
#: [[Файл:Alteratorctl-components8.png|600px|alteratorctl-components8.png]]