
=begin html

<img src="virt-builder.svg" width="250"
  style="float: right; clear: right;" />

=end html

=head1 НАЗВА

virt-builder-repository — засіб для полегшення побудови сховищ початкових даних  virt-builder

=head1 КОРОТКИЙ ОПИС

 virt-builder-repository /шлях/до/сховища
    [-i|--interactive] [--gpg-key ІДЕНТИФІКАТОР_КЛЮЧА]

=head1 ОПИС

Virt-builder — засіб для швидкої побудови нових віртуальних машин. Його можна налаштувати на використання сховищ шаблонів. Втім, створення і супровід сховища включає багато завдань, які можна автоматизувати. virt-builder-repository — саме той інструмент, який допоможе вам у керуванні такими сховищами.

Virt-builder-repository циклічно обробляє файли у каталозі, вказаному за допомогою аргументу команди, стискає файли із назвою, яка завершується суфіксом C<qcow2>, C<raw>, C<img>, або файли без суфікса назви, видобуває дані з цих файлів і створює або оновлює файл C<index> (покажчик).

Деякі з потрібних для побудови файла покажчика даних, пов'язаних із образом, не можна визначати на основі файла образу. virt-builder-repository спочатку намагається знайти ці дані у наявному файлі покажчика. Якщо після цієї спроби буде виявлено нестачу певних даних, програма попросить користувача вказати їх у інтерактивному режимі. Якщо ж отримати ці дані не вдасться, буде показано повідомлення про помилку.

Якщо вказано C<ІДЕНТИФІКАТОР_КЛЮЧА>, створений файл покажчика буде підписано цим ключем GPG.

=head1 ПРИКЛАДИ

=head2 Створення початкового сховища

Створіть теку і скопіюйте до неї файли шаблонів образів дисків.  Дані віддайте команду, подібну до такої:

 virt-builder-repository --gpg-key "joe@hacker.org" -i /шлях/до/теки

Зауважте, що вказана у нашому прикладі команда працюватиме у інтерактивному режимі. Щоб її було виконано у автоматизованому режимі, слід створити перед відданням команди мінімальний файл покажчика, який міститиме розділи, подібні до такого:

 [ідентифікатор_шаблона]
 file=назва_файла_шаблона.qcow.xz

Значення file має збігатися із назвою образу із додаванням суфікса C<.xz>, якщо не вказано параметра I<--no-compression>, або назвою образу, якщо стискання не використовується. Можна попередньо вказати інші необов'язкові дані. Типові значення буде визначено шляхом аналізу образу диска. Щоб дізнатися більше, ознайомтеся із розділом L<virt-builder(1)/Створення і підписування файла покажчика>.

=head2 Оновлення образів у наявному сховищі

У цьому випадку до сховища слід додати новий образ або нову модифікацію наявного образу. Розташуйте відповідні файли шаблонів образів у теці сховища.

Щоб оновити модифікацію образу, файл повинен мати таку саму назву, що і наявний (без суфікса назви C<xz>).

Як і у випадку створення сховища, для автоматизації процесу до файла покажчика можна додати мінімальний фрагмент. Зробити це можна для підписаного покажчика, хоча це і може видатися доволі дивною ідеєю, — файл буде знову підписано самою програмою.

Щоб вилучити файл образу зі сховища, просто вилучіть відповідний файл образу до запуску virt-builder-repository.

Далі віддайте таку команду, щоб доповнити і оновити файл покажчика:

 virt-builder-repository --gpg-key "joe@hacker.org" -i /шлях/до/теки

virt-builder-repository працює у тимчасовій теці у теці сховища. Якщо під час роботи програми трапиться якась прикра несподіванка, сховище лишиться незміненим.

=head1 ПАРАМЕТРИ

=over 4

=item B<--help>

Показати довідкове повідомлення.

=item B<--gpg> GPG

Вказати альтернативний виконуваний файл L<gpg(1)> (GNU Privacy Guard). Ви можете скористатися цим параметром для додавання параметрів до основної програми gpg, наприклад, для визначення альтернативного домашнього каталогу:

 virt-builder-repository --gpg "gpg --homedir /tmp" [...]

Цим також можна скористатися, щоб засоби gpg не просили ввести пароль до ключа:

 virt-builder-repository --gpg "gpg --passphrase-file /tmp/pass --batch" [...]

=item B<-K> ІДЕНТИФІКАТОР_КЛЮЧА

=item B<--gpg-key> ІДЕНТИФІКАТОР_КЛЮЧА

Вказати ключ GPG, який буде використано для підписування файла покажчика сховища. Якщо ключ не вказано, файл покажчика підписано не буде. C<ІДЕНТИФІКАТОР_КЛЮЧА> використовується для визначення ключа GPG, яким слід скористатися. Це значення передається до параметра I<--default-key> gpg, а отже може бути адресою електронної пошти або відбитком.

B<ЗАУВАЖЕННЯ>: типово, virt-builder-repository виконує пошук ключа у сховищі ключів GPG користувача.

=item B<-i>

=item B<--interactive>

Надсилати запит щодо даних, яких не вистачатиме. Типові значення визначатимуться за образом диска.

У запитах щодо даних введення C<-> відповідає порожньому значенню. Цим можна скористатися, щоб уникнути встановлення автоматично визначеного значення.

=item B<--no-compression>

Не стискати образи шаблонів.

=item B<--machine-readable>

=item B<--machine-readable>=формат

За допомогою цього параметра можна зробити виведені дані придатнішими для обробки комп'ютером, якщо для цієї обробки використовуються інші програми. Див. L</ПРИДАТНЕ ДО ЧИТАННЯ КОМП'ЮТЕРОМ ВИВЕДЕННЯ> нижче.

=item B<--colors>

=item B<--colours>

Використовувати послідовності символів ANSI для розфарбовування повідомлень. Ці послідовності типово використовуються, якщо дані виводяться на термінал tty.  Якщо дані, виведені програмою, спрямовуються до файла, послідовності визначення кольорів ANSI буде вимкнено, якщо ви не додасте до команди цей параметр.

=item B<-q>

=item B<--quiet>

Не виводити звичайних повідомлень щодо поступу.

=item B<-v>

=item B<--verbose>

Увімкнути діагностичні повідомлення і/або режим докладних повідомлень.

Коли повідомлятимете про вади, скористайтеся цим параметром і долучіть усі виведені дані до звіту щодо вади.

=item B<-V>

=item B<--version>

Показати дані щодо версії і завершити роботу.

=item B<--wrap>

Wrap error, warning, and informative messages.  This is the default when the output is a tty.  If the output of the program is redirected to a file, wrapping is disabled unless you use this option.

=item B<-x>

Увімкнути трасування викликів програмного інтерфейсу libguestfs.

=back

=head1 ПРИДАТНЕ ДО ЧИТАННЯ КОМП'ЮТЕРОМ ВИВЕДЕННЯ

Для виведення даних у зручному для машинної обробки форматі можна скористатися параметром I<--machine-readable>. Додавання цього параметра робить зручним використання virt-builder-repository з інших програм, графічних інтерфейсів тощо.

Скористайтеся цим параметром окремо, щоб опитати систему щодо можливостей виконуваного файла virt-builder-repository.  Типово виведені дані виглядатимуть якось так:

 $ virt-builder-repository --machine-readable
 virt-builder-repository

Виводиться список можливостей, по одній на рядок, і програма завершує роботу зі станом 0.

Можна вказати рядок форматування для керування виведенням, див. L<guestfs(3)/РОЗШИРЕНЕ ПРИДАТНЕ ДО ЧИТАННЯ КОМП'ЮТЕРОМ ВИВЕДЕННЯ>.

=head1 СТАН ВИХОДУ

Ця програма повертає значення 0 у разі успішного завершення і ненульове значення, якщо сталася помилка.

=head1 ТАКОЖ ПЕРЕГЛЯНЬТЕ

L<virt-builder(1)> L<http://libguestfs.org/>.

=head1 АВТОР

Cédric Bosdonnat L<mailto:cbosdonnat@suse.com>

=head1 АВТОРСЬКІ ПРАВА

Copyright (C) 2016-2025 SUSE Inc.

