Alt-components: различия между версиями

Материал из ALT Linux Wiki
Нет описания правки
Строка 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


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

AMC - Alterator (Module) Components - alterator-components - приложение с графическим интерфейсом для управления наборами пакетов, называемых компонентами.

Цель создания

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

Назначение

Приложение alterator-components предназначено для управления группами пакетов под названием компоненты. Использование компонентов позволяет работать с функциональными подсистемами без необходимости самостоятельного поиска отдельных пакетов. Для работы достаточно выбрать желаемый компонент, после чего alterator-components установит недостающие пакеты или удалит избыточные. Приложение ориентировано на корпоративную инфраструктуру.

Предназначен для:

  1. Администраторов
  2. Продвинутых пользователей

Возможности программы:

  • Установка компонентов.
  • Удаление компонентов.
  • Проверка наличия компонентов.

Условия применения

Приложение Alterator Components может использоваться как на серверах, так и на рабочих станциях. Для корректной работы alterator-components требуется apt, сконфигурированный на работу с репозиториями, содержащими необходимые RPM-пакеты и доступ к этим репозиториям.

Установка

Для установки alterator-components из задания (таски), воспользуйтесь поиском.

Команды установки

# apt-repo add <номер задания>
# apt-get update
# apt-get install alterator-application-components

Запуск

Вызов инструмента Alterator Components возможен через графическое меню либо через терминал.

Через графическое окружение

  1. Запустить Alterator Browser из меню приложений.
  2. Ввести пароль учетной записи root.
  3. Выбрать пункт Управление компонентами.

Через терминал

Выполнить команду

$ alterator-application-components

Внешний вид программы

Интерфейс

Пользовательский интерфейс программы состоит из секций:

  • Компоненты - представлен список компонентов по категориям.
  • Описание - выводится информация о компонентах.

Спецификация

Руководство пользователя

  • Чтобы раскрыть список компонентов в категории, необходимо нажать на её имя.
  • Чтобы увидеть информацию о компоненте, необходимо нажать на его имя.
  • Чтобы установить/удалить компонент, необходимо установить/снять галочку рядом с его именем.
  • Чтобы установить/удалить все компоненты из одной категории, необходимо установить/снять галочку рядом с именем категории.
  • Чтобы изменения вступили в силу, необходимо нажать Применить.
  • Чтобы отменить не примененные изменения, необходимо нажать Cбросить.

Руководство администратора

Принцип работы

Приложение alterator-components представлено объектом на шине межпроцессного взаимодействия D-Bus. Этот объект создает сервис alterator-manager, выполнив инструкции файлов типа "alterator entry":

  • .backend - описывает интерфейс компоненты на D-BUS, обеспечивающий взаимодействие с D-Bus. В нем же описаны методы интерфейса:
    • Description - выводит описание компоненты;
    • Info - выводит содержимое файла .component;
    • Status - Проверяет, установлены пакеты компоненты или нет (возвращает 0 при положительном результате);
  • .component - Описывает компоненту. Содержит название компоненты и список пакетов компоненты;

Также для компоненты необходим файл с описанием в формате html.

Порядок обработки составляющих alterator-components:

  1. alterator-module-executor собирает информацию из файлов .backend обо всех компонентах, и создает объекты на D-Bus с именами вида org.altlinux.alterator.<Имя компоненты>;
    Файл:D-feet-mini.png
  2. alterator-application-components обращается к D-Bus, чтобы получить информацию о существующих компонентах;
  3. Чтобы получить описание определенной компоненты alterator-application-components вызывает метод Description;
  4. Чтобы получить список пакетов определенной компоненты alterator-application-components вызывает метод Info;
  5. Чтобы проверить, установлены ли пакеты для определенной компоненты 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 

Планируются "редакции" - наборы компонентов.