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
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
|
=head1 НАЗВА
virt-customize — налаштовування віртуальної машини
=head1 КОРОТКИЙ ОПИС
virt-customize
[ -a диск.img [ -a диск.img ... ] | -d назва домену ]
[--attach файл ISO] [--attach-format ФОРМАТ]
[ -c АДРЕСА | --connect АДРЕСА ] [ -n | --dry-run ]
[ --format ФОРМАТ] [ -m МБ | --memsize МБ ]
[ --network | --no-network ]
[ -q | --quiet ] [--smp N] [ -v | --verbose ] [-x]
__CUSTOMIZE_SYNOPSIS__
virt-customize [ -V | --version ]
=head1 ОПИС
За допомогою virt-customize можна налаштувати віртуальну машину (образ
диска) встановленням пакунків, редагуванням файлів налаштувань тощо.
Virt-customize вносить зміни до гостьової системи або образу диска I<на
місці>. Гостьова система має бути вимкненою. Якщо ви хочете зберегти наявний
вміст гостьової системи, I<вам слід спочатку зробити її знімок, скопіювати
або клонувати її диск>.
Вам I<не потрібно> запускати virt-customize від імені користувача
root. Фактично, запуск у такому режимі є нерекомендованим.
Пов'язані інструменти: L<virt-sysprep(1)> і L<virt-builder(1)>.
=head1 ПАРАМЕТРИ
=over 4
=item B<--help>
Показати коротку довідку.
=item B<-a> файл
=item B<--add> файл
Додати I<файл>, який має бути образом диска з віртуальної машини.
Формат образу диска визначається автоматично. Щоб перевизначити його і
примусово використати певний формат, скористайтеся параметром I<--format>.
=item B<-a> адреса
=item B<--add> адреса
Додати віддалений диск. Формат адреси є сумісним із
guestfish. Див. L<guestfish(1)/ДОДАВАННЯ ВІДДАЛЕНОГО СХОВИЩА>.
=item B<--attach> ФАЙЛ_ISO
Вказаний диск долучається до базової системи libguestfs. Цей диск
використовується для отримання даних додаткових сховищ програмного
забезпечення або інших даних для створення нетипової системи.
Ймовірно, вам варто додати мітки для долучених дисків (або скористатися
назвою тому ISO), щоб надалі монтувати диски за міткою у ваших скриптах
запуску:
mkdir /tmp/mount
mount LABEL=EXTRA /tmp/mount
Параметр I<--attach> можна вказати декілька разів, а форматом може бути
будь-який формат образу (не лише ISO).
=item B<--attach-format> ФОРМАТ
Вказати формат диска для наступного параметра I<--attach>. Значенням
аргументу C<ФОРМАТ> зазвичай є C<raw> або C<qcow2>. Для образів ISO
скористайтеся варіантом C<raw>.
=item B<--colors>
=item B<--colours>
Використовувати послідовності символів ANSI для розфарбовування
повідомлень. Ці послідовності типово використовуються, якщо дані виводяться
на термінал tty. Якщо дані, виведені програмою, спрямовуються до файла,
послідовності визначення кольорів ANSI буде вимкнено, якщо ви не додасте до
команди цей параметр.
=item B<-c> адреса
=item B<--connect> адреса
Якщо використовується libvirt, встановити з’єднання з вказаним I<URI>. Якщо
пропущено, з’єднання буде встановлено з типовим гіпервізором libvirt.
Якщо вказати блокові пристрої гостьових систем безпосередньо (I<-a>),
libvirt не буде використовуватися взагалі.
=item B<-d> гість
=item B<--domain> гість
Додати всі диски з вказаної гостьової системи libvirt. UUID доменів можна
використовувати замість назв.
=item B<-n>
=item B<--dry-run>
Виконати тестову обробку гостьової системи у режимі «лише читання». Буде
виконано дію sysprep, але наприкінці усі зміни до диска буде відкинуто.
=item B<--echo-keys>
Типово, якщо virt-customize попросить вас ввести ключ або пароль, програма
не відтворюватиме введені символи на екрані. Якщо ви не боїтеся
TEMPEST-нападів, або у вашій кімнаті нікого, окрім вас, немає, ви можете
скористатися цим прапорцем, щоб бачити, які саме символи ви вводите.
=item B<--format> raw|qcow2|..
=item B<--format> auto
Типовим значенням для параметра I<-a> є автоматичне визначення формату
образу диска. Використання цього параметра примусово визначає значення
параметрів I<-a> формату диска у наступному рядку команди. Використання
параметра I<--format auto> перемикає програму у режим автоматичного
визначення у наступних параметрах I<-a>.
Приклад:
virt-customize --format raw -a диск.img
примусове встановлення формату без обробки (без автоматичного визначення)
для F<disk.img>.
virt-customize --format raw -a диск.img --format auto -a іще_диск.img
примусове встановлення формату без обробки (без автоматичного визначення)
для F<diskimg> і повернення до автоматичного визначення для F<another.img>.
Якщо ви користуєтеся ненадійними образами гостьових систем у необробленому
форматі, вам слід скористатися цим параметром для визначення формату
диска. Таким чином можна уникнути можливих проблем з захистом для
сформованих зловмисниками гостьових систем (CVE-2010-3851).
__INCLUDE:key-option.pod__
__INCLUDE:keys-from-stdin-option.pod__
=item B<-m> МБ
=item B<--memsize> МБ
Зміна обсягу пам'яті, наданого скриптам I<--run>. Збільште це значення, якщо
виявиться, що для використання скриптів I<--run> або параметра I<--install>
не вистачає пам'яті.
Типові значення можна визначити за допомогою такої команди:
guestfish get-memsize
=item B<--network>
=item B<--no-network>
Увімкнути чи вимкнути доступ до мережі для гостьової системи під час
встановлення.
Типово увімкнено. Скористайтеся параметром I<--no-network>, щоб вимкнути
доступ.
У мережі працюватимуть лише вихідні з'єднання, а також буде декілька інших
незначних обмежень. Див. L<virt-rescue(1)/МЕРЕЖА>.
Якщо ви скористаєтеся параметром I<--no-network>, тоді інші параметри,
зокрема I<--install>, не працюватимуть.
Це не вплине на доступність мережі для гостьової системи після її
завантаження, оскільки така доступність керується вашим гіпервізором або
хмарним середовищем і не має нічого спільного з virt-customize.
Загалом кажучи, вам I<не варто> використовувати I<--no-network>. Але ось
декілька випадків, коли у вас може виникнути потреба у використанні цього
параметра:
=over 4
=item 1.
У модулі обробки libguestfs, яким ви користуєтеся, не передбачено підтримки
мережі. (Див. L<guestfs(3)/МОДУЛЬ>).
=item 2.
Усе програмне забезпечення, яке ви маєте намір встановити, походить з
долученого образу ISO, отже потреби у мережі немає.
=item 3.
Ви не хочете, щоб ненадійний код із гостьової системи намагався отримати
доступ до мережевого з'єднання вашої основної системи під час роботи
virt-customize. Таке, зокрема, може трапитися, якщо ви не довіряєте джерелу
шаблонів операційних систем. (Див. L</БЕЗПЕКА> нижче).
=item 4.
Ви не хочете користуватися мережею основної системи (наприклад, через
захищеність або обмеженість середовища у ній).
=back
=item B<-q>
=item B<--quiet>
Не виводити повідомлення до журналу.
Для вмикання ведення докладного журналу окремих дій з файлами скористайтеся
I<-x>.
=item B<--smp> N
Увімкнути N E<ge> 2 віртуальних процесорів для використання у скриптах
I<--run>.
=item B<-v>
=item B<--verbose>
Увімкнути докладний показ повідомлень з метою діагностики.
=item B<-V>
=item B<--version>
Показати дані щодо версії і завершити роботу.
=item B<-x>
Увімкнути трасування викликів програмного інтерфейсу libguestfs.
=back
=head2 Параметри налаштовування
__CUSTOMIZE_OPTIONS__
=head1 SELINUX
Для гостьових систем, у яких використовується SELinux, може знадобитися
спеціальна обробка, якщо використовуються дії, які створюють нові файли або
вносять зміни до наявних файлів.
Докладніший опис наведено у розділі L<virt-builder(1)/SELINUX>.
=head1 СТАН ВИХОДУ
Ця програма повертає 0, якщо роботу виконано успішно, і 1, якщо сталися
помилки.
=head1 ЗМІННІ СЕРЕДОВИЩА
=over 4
=item C<VIRT_TOOLS_DATA_DIR>
Ця змінна визначає каталог, у якому містяться файли даних, які
використовуються для встановлення Windows з першим завантаженням.
Зазвичай, потреби у встановленні власного значення немає. Якщо значення не
встановлено, буде використано вбудоване типове значення (щось схоже на
F</usr/share/virt-tools>).
Цей каталог може містити такі файли:
=over 4
=item F<rhsrvany.exe>
Це виконуваний файл для Windows RHSrvAny, який використовується для
встановлення скрипту «firstboot» у гостьові системи Windows. Він
знадобиться, якщо ви маєте намір використовувати параметри I<--firstboot> і
I<--firstboot-command> для гостьових операційних систем Windows.
Див. також C<https://github.com/rwmjones/rhsrvany>
=item F<pvvxsvc.exe>
Це виконуваний файл Windows, що постачається разом із VMDP SUSE,
використовується для встановлення скрипту «firstboot» у гостьові системи
Windows. Він знадобиться, якщо ви маєте намір використовувати параметри
I<--firstboot> і I<--firstboot-command> для гостьових операційних систем
Windows.
=back
=back
Опис інших змінних середовища наведено у розділі L<guestfs(3)/ENVIRONMENT
VARIABLES>.
=head1 ТАКОЖ ПЕРЕГЛЯНЬТЕ
L<guestfs(3)>, L<guestfish(1)>, L<virt-builder(1)>, L<virt-clone(1)>,
L<virt-rescue(1)>, L<virt-resize(1)>, L<virt-sparsify(1)>,
L<virt-sysprep(1)>, L<virsh(1)>, L<lvcreate(8)>, L<qemu-img(1)>,
L<scrub(1)>, L<http://libguestfs.org/>, L<http://libvirt.org/>.
=head1 АВТОРИ
Richard W.M. Jones L<http://people.redhat.com/~rjones/>
=head1 АВТОРСЬКІ ПРАВА
Copyright (C) 2011-2020 Red Hat Inc.
|
