
=head1 НАЗВА

virt-v2v-output-openstack — використання virt-v2v для перетворення гостьових систем із виведенням даних до OpenStack

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

 virt-v2v [параметри -i*] -o openstack
                        -oo server-id=СЕРВЕР
                        [-oo guest-id=ГОСТЬОВА_СИСТЕМА]
                        [-oo verify-server-certificate=false]
                        [-oo os-username=admin] [-oo os-*=*]

ifelse(ENABLE_GLANCE, yes, `
 virt-v2v [-i* options] -o glance
')

=head1 ОПИС

This page documents how to use L<virt-v2v(1)> to convert guests to run on OpenStack.

ifelse(ENABLE_GLANCE, yes, ` There are two output modes you can select, but only I<-o openstack> should be used normally.  ')

=over 4

=item B<-o openstack> B<-oo server-id=>СЕРВЕР [...]

Повний опис: L</ВИВЕДЕННЯ ДО OPENSTACK>

Це сучасний метод для вивантаження даних до OpenStack за допомогою програмного інтерфейсу REST. Гостьові системи можна безпосередньо перетворити на томи Cinder.

ifelse(ENABLE_GLANCE, yes, `

=item B<-o glance>

Повний опис: L</ВИВЕДЕННЯ ДО GLANCE>

This is the old method for uploading to Glance.  Unfortunately Glance is not well suited to storing converted guests (since virt-v2v deals with "pets" not templated "cattle"), so this method is not recommended unless you really know what you are doing.  ')

=back

=head1 ВИВЕДЕННЯ ДО OPENSTACK

Щоб вивести дані до OpenStack, скористайтеся параметром I<-o openstack>.

=head2 OpenStack: Налаштовування базової системи для перетворення

При перетворенні за допомогою virt-v2v до формату OpenStack незвичною особливістю є те, що virt-v2v B<має> бути запущено у віртуальній машині, яка працює на «хмарі» OpenStack. Ця віртуальна машина називається «базовою системою перетворення» («conversion appliance»). Зауважте, що ця віртуальна машина не пов'язана із гостьовою системою, перетворення якої виконується.

Це спричинено тим, що для створення томів Cinder, які міститимуть дані гостьової системи (перетвореної програмою) нам доведеться долучити ці томи Cinder до якоїсь віртуальної машини OpenStack.

У базовій системі слід ініціалізувати команду C<openstack>. Ми використовуємо цю команду для обміну даними з OpenStack.

Коли virt-v2v працюватиме у базовій системі перетворення, вам слід вказати назву або UUID цієї базової системи перетворення virt-v2v. Приклад:

 $ openstack server list
 +--------------------------------------+-----------+--------+
 | ID                                   | Name      | Status |
 +--------------------------------------+-----------+--------+
 | bbb0147a-44b9-4d19-9a9d-10ca9a984744 | test1     | ACTIVE |
 +--------------------------------------+-----------+--------+

 # virt-v2v [...] \
       -o openstack -oo server-id=bbb0147a-44b9-4d19-9a9d-10ca9a984744

або:

 # virt-v2v [...] -o openstack -oo server-id=test1

Якщо потрібно, ви можете запустити декілька паралельних перетворень у одній базовій системі перетворення, якщо у ній достатньо для цього ресурсів. Втім, сам OpenStack накладає обмеження, які слід враховувати: OpenStack не здатен долучати більше за приблизно 25 дисків [точна кількість залежить від конфігурації системи] до однієї базової системи. Це обмежує кількість гостьових систем, які можна перетворювати паралельно, оскільки на час копіювання кожен з дисків гостьової системи слід долучити до базової системи.

=head2 OpenStack: Розпізнавання

Перетворювання до формату OpenStack потребує доступу до тимчасових (неадміністративних) точок доступу до програмного інтерфейсу. Вам доведеться або налаштувати ваші змінні середовища C<$OS_*>, або скористатися параметрами виведення у рядку команди virt-v2v для проходження розпізнавання на OpenStack.

Приклад:

 export OS_USERNAME=admin

або:

 virt-v2v [...] -o openstack -oo os-username=admin

дають той самий результат і працюють так само, як I<--os-username> у рядку команди програмних інструментів OpenStack.

Зазвичай, має бути файл, який називається F<overcloudrc> або F<keystonerc_admin>, яким ви C<можете скористатися> для налаштовування.

Якщо вам потрібно скопіювати F<overcloudrc> на інший комп'ютер, перевіте, чи посилається він на змінну середовища C<OS_CLOUD>. Якщо це так, можливо, вам доведеться також скопіювати файл F<clouds.yaml> з F</etc/openstack/> або F<$HOME/.config/openstack/> на інший комп'ютер. Див. розділ "CLOUD CONFIGURATION" у підручнику з командного інтерфейсу openstack.

=head2 OpenStack: Запуск від імені root

Оскільки virt-v2v має отримувати доступ до томів Cinder, які представляються як пристрої F</dev> у базовій системі перетворення, зазвичай у режимі I<-o openstack> virt-v2v слід запускати від імені користувача root.

Якщо ви використовуєте C<sudo> для запуску virt-v2v і використовуєте змінні середовища для розпізнавання, не забудьте скористатися параметром C<sudo -E> для того, щоб зберігати середовище.

=head2 OpenStack: Ідентифікатор гостьової системи

 virt-v2v [...] -o openstack -oo guest-id=123-456-7890

Крім того, ви можете додатково вказати у рядку команди I<-oo guest-id=...>. Цей ідентифікатор (який може бути довільним рядком) зберігається на кожному томі Cinder у властивості тому C<virt_v2v_guest_id>.

Цим можна скористатися для пошуку дисків, які пов'язано із гостьовою системою, або встановлення взаємної відповідності дисків із гостьовими системами при одночасному перетворенні декількох гостьових систем.

=head2 OpenStack: Ігнорування сертифіката сервера

За допомогою I<-oo verify-server-certificate=false> ви можете повідомити клієнту openstack про те, що слід ігнорувати сертифікат сервера при з'єднанні із кінцевими точками програмного інтерфейсу OpenStack. Це матиме такі самі наслідки, як додавання параметра I<--insecure> до команди C<openstack>.

=head2 OpenStack: Перетворення гостьової системи

Остаточною командою для перетворення гостьової системи, яку слід віддавати від імені користувача root, є такою:

 # virt-v2v [-i параметри ...] \
       -o openstack -oo server-id=НАЗВА|UUID [-oo guest-id=ІДЕНТИФІКАТОР]

Якщо ви хочете включити параметри розпізнавання до рядка команди, команда буде такою:

 # virt-v2v [-i параметри ...] \
       -o openstack -oo server-id=НАЗВА|UUID -oo os-username=admin [тощо]

=head2 OpenStack: Завантаження гостьової системи

Гостьові системи перетворюються як томи Cinder (один том на диск початкової гостьової системи). Щоб завантажити з них систему, скористайтеся параметром C<openstack server create --volume>:

 $ openstack volume list
 +--------------------------------------+---------------+-----------+
 | ID                                   | Name          | Status    |
 +--------------------------------------+---------------+-----------+
 | c4d06d15-22ef-462e-9eff-ab54ab285a1f | fedora-27-sda | available |
 +--------------------------------------+---------------+-----------+
 $ openstack server create \
       --flavor x1.small \
       --volume c4d06d15-22ef-462e-9eff-ab54ab285a1f \
       myguest
 $ openstack console url show myguest

=head2 OpenStack: Інші параметри перетворення

Для визначення типу тому Cinder скористайтеся параметром I<-os>. Якщо параметр не буде вказано, припускатиметься, що немає ніякого типу тому Cinder.

Підтримки таких параметрів для OpenStack B<не> передбачено: I<-oa>, I<-of>.

ifelse(ENABLE_GLANCE, yes, `

=head1 ВИВЕДЕННЯ ДО GLANCE

Зауважте, що цей варіант вважається застарілим. У більшості випадків вам слід використовувати L</ВИВЕДЕННЯ ДО OPENSTACK>.

Щоб вивести дані до OpenStack Glance, скористайтеся параметром I<-o glance>.

Команда запустить керовану з командного рядка програму L<glance(1)>, яку має бути встановлено на сервері перетворення virt-v2v. Щоб спрацювало розпізнавання, вам слід встановити змінні середовища C<OS_*>. Див. L</OpenStack: Розпізнавання> вище.

Virt-v2v додає метадані щодо гостьової системи до Glance, описуючи такі речі, як назва гостьової операційної системи і список потрібних їй драйверів. Команда C<glance image-show> покаже метадані як поля «Property», зокрема C<os_type> і C<hw_disk_bus>.

=head2 Glance і розрідженість

Glance image upload doesn’t appear to correctly handle sparseness.  For this reason, using qcow2 will be faster and use less space on the Glance server. Use the virt-v2v S<I<-of qcow2>> option.

=head2 Glance і робота з декількома дисками

Якщо у гостьовій системі єдиний диск, назва цього диску у Glance буде назвою гостьової системи. Керувати назвою можна за допомогою параметра I<-on>.

Glance doesn’t have a concept of associating multiple disks with a single guest, and Nova doesn’t allow you to boot a guest from multiple Glance disks either.  If the guest has multiple disks, then the first (assumed to be the system disk) will have the name of the guest, and the second and subsequent data disks will be called C<I<guestname>-disk2>, C<I<guestname>-disk3> etc. It may be best to leave the system disk in Glance, and import the data disks to Cinder.  ')

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

L<virt-v2v(1)>, ifelse(ENABLE_GLANCE, yes, L<glance(1)>,) L<https://docs.openstack.org/python-openstackclient/latest/cli/man/openstack.html>.

=head1 АВТОР

Richard W.M. Jones

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

Copyright (C) 2009-2025 Red Hat Inc.

