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

Материал из ALT Linux Wiki
Нет описания правки
Строка 14: Строка 14:
=== Цель создания ===
=== Цель создания ===
AMC позволяет устанавливать и удалять компоненты.   
AMC позволяет устанавливать и удалять компоненты.   
Компонент представляет собой набор пакетов, предоставляющих определенную функциональность, и некоторую последовательность действий (deploy) для его конфигурации. AMC должен запускаться при первом запуске системы, но доступен всегда, т.е. набор установленных компонент можно поменять в любой момент.
Компонент представляет собой набор пакетов, предоставляющих определенную функциональность, и некоторую последовательность действий (deploy) для его конфигурации. AMC должен запускаться при первом запуске системы, но доступен всегда, т.е. набор установленных компонентов можно поменять в любой момент.


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


Предназначен для:
Предназначен для:
Строка 23: Строка 23:
# Продвинутых пользователей
# Продвинутых пользователей
Возможности программы:
Возможности программы:
* Установка компонент.
* Установка компонентов.
* Удаление компонент.
* Удаление компонентов.
* Проверка наличия компонент.
* Проверка наличия компонентов.


=== Условия применения ===
=== Условия применения ===
Строка 55: Строка 55:
=== Интерфейс ===
=== Интерфейс ===
Пользовательский интерфейс программы состоит из секций:  
Пользовательский интерфейс программы состоит из секций:  
* Компоненты - представлен список компонент по категориям.
* Компоненты - представлен список компонентов по категориям.
* Описание - выводится информация о компонентах.
* Описание - выводится информация о компонентах.


Строка 64: Строка 64:


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


== Руководство администратора ==
== Руководство администратора ==
=== Создание компонент ===
=== Создание компонентов ===
Для создания компоненты необходимо сформировать три файла:
Для создания компонента необходимо сформировать три файла:
* '''.backend'''
* '''.backend'''
* '''.component'''
* '''.component'''
Строка 108: Строка 108:


==== Создание категории ====
==== Создание категории ====
Категории компонент являются сущностями [https://gitlab.basealt.space/alt/alterator-entry/-/blob/specification/doc/README.md?ref_type=heads#введение Alterator Entry] и описываются файлами ''.category'' в каталоге '''/usr/share/alterator/components/'''. Имена этих файлов имеют формат '''<номер>-<имя>.category''', содержат секцию ''Alterator Entry'' и следующие параметры:
Категории компонентов являются сущностями [https://gitlab.basealt.space/alt/alterator-entry/-/blob/specification/doc/README.md?ref_type=heads#введение Alterator Entry] и описываются файлами ''.category'' в каталоге '''/usr/share/alterator/components/'''. Имена этих файлов имеют формат '''<номер>-<имя>.category''', содержат секцию ''Alterator Entry'' и следующие параметры:
* Type - тип сущности, всегда <code>Category</code>;
* Type - тип сущности, всегда <code>Category</code>;
* Name -  
* Name -  
Строка 123: Строка 123:
</pre>
</pre>


==== Создание компоненты ====
==== Создание компонента ====
Каждая компонента представлена следующими файлами:
Каждый компонент представлен следующими файлами:
* /usr/share/alterator/backends/samba.backend
* /usr/share/alterator/backends/samba.backend
* /usr/share/alterator/components/20-server-apps.category
* /usr/share/alterator/components/20-server-apps.category

Версия от 14:46, 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бросить.

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

Создание компонентов

Для создания компонента необходимо сформировать три файла:

  • .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 

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