Alt-components: различия между версиями
Нет описания правки |
|||
Строка 72: | Строка 72: | ||
== Руководство администратора == | == Руководство администратора == | ||
=== Принцип работы === | |||
Приложение alterator-components представлено объектом на шине межпроцессного взаимодействия D-Bus. Этот объект создает сервис alterator-manager, выполнив инструкции файлов типа "alterator entry": | |||
* '''.backend''' - описывает интерфейс компоненты на D-BUS, обеспечивающий взаимодействие с D-Bus. В нем же описаны методы интерфейса: | |||
** Description - выводит описание компоненты; | |||
** Info - выводит содержимое файла .component; | |||
** Status - Проверяет, установлены пакеты компоненты или нет (возвращает 0 при положительном результате); | |||
* '''.component''' - Описывает компоненту. Содержит название компоненты и список пакетов компоненты; | |||
Также для компоненты необходим файл с описанием в формате html. | |||
Порядок обработки составляющих alterator-components: | |||
# alterator-module-executor собирает информацию из файлов .backend обо всех компонентах, и создает объекты на D-Bus с именами вида org.altlinux.alterator.<Имя компоненты>;<br>[[Файл:D-feet-mini.png|480x480px]] | |||
# alterator-application-components обращается к D-Bus, чтобы получить информацию о существующих компонентах; | |||
# Чтобы получить описание определенной компоненты alterator-application-components вызывает метод Description; | |||
# Чтобы получить список пакетов определенной компоненты alterator-application-components вызывает метод Info; | |||
# Чтобы проверить, установлены ли пакеты для определенной компоненты alterator-application-components вызывает метод Status; | |||
=== Создание компонентов === | === Создание компонентов === | ||
Для создания компонента необходимо сформировать три файла: | Для создания компонента необходимо сформировать три файла: |
Версия от 14:49, 6 марта 2025
AMC - Alterator (Module) Components - alterator-components - приложение с графическим интерфейсом для управления наборами пакетов, называемых компонентами.
Цель создания
AMC позволяет устанавливать и удалять компоненты. Компонент представляет собой набор пакетов, предоставляющих определенную функциональность, и некоторую последовательность действий (deploy) для его конфигурации. AMC должен запускаться при первом запуске системы, но доступен всегда, т.е. набор установленных компонентов можно поменять в любой момент.
Назначение
Приложение alterator-components предназначено для управления группами пакетов под названием компоненты. Использование компонентов позволяет работать с функциональными подсистемами без необходимости самостоятельного поиска отдельных пакетов. Для работы достаточно выбрать желаемый компонент, после чего alterator-components установит недостающие пакеты или удалит избыточные. Приложение ориентировано на корпоративную инфраструктуру.
Предназначен для:
- Администраторов
- Продвинутых пользователей
Возможности программы:
- Установка компонентов.
- Удаление компонентов.
- Проверка наличия компонентов.
Условия применения
Приложение Alterator Components может использоваться как на серверах, так и на рабочих станциях. Для корректной работы alterator-components требуется apt, сконфигурированный на работу с репозиториями, содержащими необходимые RPM-пакеты и доступ к этим репозиториям.
Установка
Для установки alterator-components из задания (таски), воспользуйтесь поиском.
Команды установки
# apt-repo add <номер задания> # apt-get update # apt-get install alterator-application-components
Запуск
Вызов инструмента Alterator Components возможен через графическое меню либо через терминал.
Через графическое окружение
- Запустить Alterator Browser из меню приложений.
- Ввести пароль учетной записи root.
- Выбрать пункт Управление компонентами.
Через терминал
Выполнить команду
$ alterator-application-components
Интерфейс
Пользовательский интерфейс программы состоит из секций:
- Компоненты - представлен список компонентов по категориям.
- Описание - выводится информация о компонентах.
Спецификация
- Реализация интерфейса component.
- Реализация интерфейса component-categories.
- Документация на Component.
Руководство пользователя
- Чтобы раскрыть список компонентов в категории, необходимо нажать на её имя.
- Чтобы увидеть информацию о компоненте, необходимо нажать на его имя.
- Чтобы установить/удалить компонент, необходимо установить/снять галочку рядом с его именем.
- Чтобы установить/удалить все компоненты из одной категории, необходимо установить/снять галочку рядом с именем категории.
- Чтобы изменения вступили в силу, необходимо нажать Применить.
- Чтобы отменить не примененные изменения, необходимо нажать Cбросить.
Руководство администратора
Принцип работы
Приложение alterator-components представлено объектом на шине межпроцессного взаимодействия D-Bus. Этот объект создает сервис alterator-manager, выполнив инструкции файлов типа "alterator entry":
- .backend - описывает интерфейс компоненты на D-BUS, обеспечивающий взаимодействие с D-Bus. В нем же описаны методы интерфейса:
- Description - выводит описание компоненты;
- Info - выводит содержимое файла .component;
- Status - Проверяет, установлены пакеты компоненты или нет (возвращает 0 при положительном результате);
- .component - Описывает компоненту. Содержит название компоненты и список пакетов компоненты;
Также для компоненты необходим файл с описанием в формате html.
Порядок обработки составляющих alterator-components:
- alterator-module-executor собирает информацию из файлов .backend обо всех компонентах, и создает объекты на D-Bus с именами вида org.altlinux.alterator.<Имя компоненты>;
Файл:D-feet-mini.png - alterator-application-components обращается к D-Bus, чтобы получить информацию о существующих компонентах;
- Чтобы получить описание определенной компоненты alterator-application-components вызывает метод Description;
- Чтобы получить список пакетов определенной компоненты alterator-application-components вызывает метод Info;
- Чтобы проверить, установлены ли пакеты для определенной компоненты alterator-application-components вызывает метод Status;
Создание компонентов
Для создания компонента необходимо сформировать три файла:
- .backend
- .component
- описание
Файлы .backend и .component
Файлы .backend и .component являются текстовыми и содержат описание в виде секций. Имеют следующий синтаксис:
[имя секции1] Поле1 = значение Поле2 = значение ПолеN = значение [имя секции2] Поле1 = значение Поле2 = значение ПолеN = значение [имя секциN] Поле1 = значение Поле2 = значение ПолеN = значение
Принятые правила написания
- все поля чувствительны к регистру и начинаются с большой буквы;
- перед и после знака
=
пробелы; - значения полей указываются без кавычек;
- значения могут содержать пробелы;
- если строка начинается с
#
, то она считается комментарием и при чтении информации из файла игнорируется.
Файл описания
Файл с описанием содержит информацию о компоненте и имеет синтаксис, соответствующий языку html.
Создание категории
Категории компонентов являются сущностями Alterator Entry и описываются файлами .category в каталоге /usr/share/alterator/components/. Имена этих файлов имеют формат <номер>-<имя>.category, содержат секцию Alterator Entry и следующие параметры:
- Type - тип сущности, всегда
Category
; - Name -
- DisplayName - имя категории;
- DisplayName[локаль] - имя категории, которое выводится с использованием указанной в скобках локали.
Пример готового файла
[Alterator Entry] Type=Category Name=centaurus/20-server-apps DisplayName=Server applications DisplayName[ru_RU]=Серверные приложения
Создание компонента
Каждый компонент представлен следующими файлами:
- /usr/share/alterator/backends/samba.backend
- /usr/share/alterator/components/20-server-apps.category
- /usr/share/alterator/components/centaurus/samba/description.html
- /usr/share/alterator/components/centaurus/samba/samba.component
Файл .backend
# cat /usr/share/alterator/backends/samba.backend [Alterator Entry] Type = Backend Module = executor Name = component_centaurus_samba Interface = component1 [Info] execute = cat /usr/share/alterator/components/centaurus/samba/samba.component stdout_strings = enabled [Description] execute = /usr/lib/alterator-interface-component/basic_get_component_description /usr/share/alterator/components/centaurus/samba stdout_strings = enabled [Status] execute = /usr/lib/alterator-interface-component/basic_check_component_installed /usr/share/alterator/components/centaurus/samba/samba.component
Файл .category
# cat /usr/share/alterator/components/20-server-apps.category [Alterator Entry] Type = Component Name = centaurus/samba Category = centaurus/20-server-apps DisplayName = Samba Server DisplayName[ru_RU] = Сервер Samba Packages = samba samba-common-tools samba-usershares samba-client
Файл description.html
# cat /usr/share/alterator/components/centaurus/samba/description.html <ul> <li>samba</li> <li>samba-common-tools</li> <li>samba-usershares</li> <li>samba-client</li> </ul>
Файл samba.component
# cat /usr/share/alterator/components/centaurus/samba/samba.component [Alterator Entry] Type = Component Name = centaurus/samba Category = centaurus/20-server-apps DisplayName = Samba Server DisplayName[ru_RU] = Сервер Samba Packages = samba samba-common-tools samba-usershares samba-client
Планируются "редакции" - наборы компонентов.