1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
|
=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-2023 SUSE Inc.
|
