Zainstaluj ManageIQ w oVirt

Ta rola została przeniesiona do oVirt Ansible Collection, użyj najnowszej wersji stamtąd. To repozytorium jest teraz tylko do odczytu i nie jest już używane do aktywnego rozwoju

Rola ovirt.manageiq pobiera obraz QCOW ManageIQ/CloudForms i wdraża go w oVirt/Red Hat Virtualization (RHV).

Rola umożliwia również utworzenie wirtualnej maszyny, dołączenie dysku ManageIQ, a następnie oczekiwanie na inicjalizację systemu ManageIQ oraz zarejestrowanie oVirt jako dostawcy infrastruktury.

Uwaga

Proszę pamiętać, że instalując tę rolę z Ansible Galaxy, musisz uruchomić następujące polecenie:

$ ansible-galaxy install ovirt.manageiq

Pobierze to rolę do katalogu o tej samej nazwie, którą podałeś w wierszu poleceń, w tym przypadku ovirt.manageiq. Pamiętaj, że jest to wrażliwe na wielkość liter, więc jeśli podasz na przykład OVIRT.manageiq, pobierze tę samą rolę, ale doda ją do katalogu o nazwie OVIRT.manageiq, co oznacza, że zawsze musisz używać tej roli z prefiksem wielkimi literami. Bądź więc ostrożny, jak podajesz nazwę roli w wierszu poleceń.

Podczas instalacji RPM instalujemy trzy starsze nazwy oVirt.manageiq, ovirt.manageiq i ovirt-manageiq. Możesz użyć dowolnej z tych nazw. Ta dokumentacja i przykłady w tym repozytorium używają nazwy ovirt.manageiq. Nazwy ról oVirt.manageiq i ovirt-manageiq są przestarzałe.

Wymagania

• oVirt musi być w wersji 4.0.4 lub wyższej.
• Ansible musi być w wersji 2.9 lub wyższej.
• ovirt-imageio musi być zainstalowane i uruchomione.
• oVirt Python SDK w wersji 4.

Dodatkowo, wykonaj następujące kontrole, aby upewnić się, że wymagane procesy są uruchomione.

• Sprawdź, czy ovirt-imageio-proxy działa na silniku:

systemctl status ovirt-imageio-proxy

• Sprawdź, czy ovirt-imageio-daemon działa na hostach:

systemctl status ovirt-imageio-daemon

Będziesz również potrzebować certyfikatu CA silnika. Aby to zrobić, skonfiguruj zmienną ovirt_ca z ścieżką do certyfikatu CA.

Ograniczenia

• Nie wspieramy trybu sprawdzania Ansible (Dry Run), ponieważ ta rola używa kilku modułów (moduł poleceń), które go nie wspierają. Gdy wszystkie moduły używane przez tę rolę będą go wspierać, my również to zrobimy.

Zmiennie roli

Zmienne QCOW:

Nazwa	Wartość domyślna	Opis
miq_qcow_url	http://releases.manageiq.org/manageiq-ovirt-hammer-6.qc2	URL obrazu QCOW ManageIQ.
miq_image_path	/tmp/	Ścieżka, do której pobierany będzie obraz QCOW2. Jeśli katalog, używana będzie domyślna nazwa URL z serwera zdalnego.
miq_image_checksum	UNDEF	Jeśli zdefiniowano sumę kontrolną, wartość skrótu pliku docelowego zostanie obliczona po pobraniu, aby zapewnić jego integralność. Format: :, np. checksum="sha256:D98291AC[...]B6DC7B97".

Zmiennie logowania do silnika:

Nazwa	Wartość domyślna	Opis
engine_user	UNDEF	Użytkownik do uzyskania dostępu do silnika.
engine_password	UNDEF	Hasło użytkownika 'engine_user'.
engine_fqdn	UNDEF	FQDN silnika.
engine_ca	UNDEF	Ścieżka do certyfikatu CA silnika.

Zmiennie dla wirtualnej maszyny:

Nazwa	Wartość domyślna	Opis
miq_vm_name	manageiq_gaprindashvili-3	Nazwa wirtualnej maszyny ManageIQ.
miq_vm_cluster	Default	Klastr wirtualnej maszyny.
miq_vm_memory	16GiB	Pamięć systemowa wirtualnej maszyny.
miq_vm_memory_guaranteed	UNDEF	Minimalna zagwarantowana pamięć wirtualnej maszyny.
miq_vm_memory_max	UNDEF	Górna granica pamięci wirtualnej maszyny.
miq_vm_cpu	4	Liczba rdzeni CPU w wirtualnej maszynie.
miq_vm_cpu_shares	UNDEF	Ustal udziały CPU dla tej wirtualnej maszyny.
miq_vm_cpu_sockets	UNDEF	Liczba gniazd CPU wirtualnej maszyny.
miq_vm_cpu_threads	UNDEF	Liczba wątków CPU wirtualnej maszyny.
miq_vm_os	rhel_7x64	System operacyjny wirtualnej maszyny.
miq_vm_root_password	miq_app_password	Hasło roota dla wirtualnej maszyny.
miq_vm_cloud_init	UNDEF	Słownik inicjalizacji w chmurze do przekazania do wirtualnej maszyny.
miq_vm_high_availability	true	Jeśli tak, maszyna wirtualna ManageIQ będzie ustawiona jako wysoko dostępna.
miq_vm_high_availability_priority	50	Określa priorytet wirtualnej maszyny w kolejce uruchomień i migracji. Wyższa wartość oznacza wyższy priorytet.
miq_vm_delete_protected	true	Jeśli tak, maszyna wirtualna ManageIQ będzie oznaczona jako chroniona przed usunięciem.
miq_debug_create	false	Jeśli prawda, loguje wrażliwe dane, przydatne do debugowania.
miq_wait_for_ip_version	v4	Określa, na którą wersję IP należy czekać. Może być v4 lub v6.
miq_wait_for_ip_timeout	240	Maksymalny czas, przez jaki playbook powinien czekać na potwierdzenie IP.

Podstawowe zmienne dysków wirtualnej maszyny (np. system operacyjny):

Nazwa	Wartość domyślna	Opis
miq_vm_disk_name	miq_vm_name	Nazwa dysku wirtualnej maszyny.
miq_vm_disk_storage	UNDEF	Docelowa jednostka pamięci dla dysku.
miq_vm_disk_size	Rozmiar dysku qcow	Rozmiar dysku wirtualnej maszyny.
miq_vm_disk_interface	virtio_scsi	Typ interfejsu dysku wirtualnej maszyny.
miq_vm_disk_format	cow	Format dysku wirtualnej maszyny.

Dodatkowe dyski wirtualnej maszyny (np. baza danych, logi, tymczasowe): słownik o nazwie miq_vm_disks pozwala opisać każdy z dodatkowych dysków (patrz przykładowy playbook). Uwaga, to działa tylko z CFME. Dla każdego dysku można ustawić następujące atrybuty:

Nazwa	Wartość domyślna	Opis
name	miq_vm_name_type	Nazwa dysku wirtualnej maszyny.
size	UNDEF	Rozmiar dysku wirtualnej maszyny (XXGiB).
interface	virtio_scsi	Typ interfejsu dysku wirtualnej maszyny (virtio lub virtio_scsi). Zalecane jest virtio_scsi, ponieważ virtio ma niską limitację liczby dysków.
format	UNDEF	Format dysku wirtualnej maszyny (raw lub cow).
timeout	UNDEF	Czas oczekiwania na utworzenie dysku.

Zmiennie NIC dla wirtualnej maszyny:

Nazwa	Wartość domyślna	Opis
miq_vm_nics	{'name': 'nic1', 'profile_name': 'ovirtmgmt', 'interaface': 'virtio'}	Lista słowników definiujących interfejsy sieciowe wirtualnej maszyny.

Element listy miq_vm_nics może zawierać następujące atrybuty:

Nazwa	Wartość domyślna
name	UNDEF	Nazwa interfejsu sieciowego.
interface	UNDEF	Typ interfejsu sieciowego.
mac_address	UNDEF	Niestandardowy adres MAC interfejsu sieciowego, domyślnie jest uzyskiwany z puli MAC.
profile_name	UNDEF	Profil wirtualnego interfejsu sieciowego, który ma być podłączony do interfejsu VM.

Zmiennie ManageIQ:

Nazwa	Wartość domyślna	Opis
miq_app_username	admin	Nazwa użytkownika używana do logowania do ManageIQ.
miq_app_password	smartvm	Hasło użytkownika określonego w nazwie użytkownika do logowania do ManageIQ.
miq_username	admin	Alias miq_app_username dla wstecznej kompatybilności.
miq_password	smartvm	Alias miq_app_password dla wstecznej kompatybilności.
miq_db_username	root	Nazwa użytkownika do połączenia z bazą danych.
miq_db_password	miq_app_password	Hasło użytkownika określonego w nazwie użytkownika do połączenia z bazą danych.
miq_region	0	Region ManageIQ utworzony w bazie danych. Uwaga: Działa tylko z CFME.
miq_company	My Company	Nazwa firmy urządzenia.
miq_disabled_roles	[]	Lista ról serwera ManageIQ do wyłączenia na urządzeniu.
miq_enabled_roles	[]	Lista ról serwera ManageIQ do włączenia na urządzeniu.

Domyślnie na ManageIQ i CloudForms włączone są następujące role serwera:

• automate - Silnik automatyzacji
• database_operations - Operacje na bazie danych
• event - Monitorowanie zdarzeń
• ems_inventory - Inwentarz dostawcy
• ems_operations - Operacje dostawcy
• reporting - Raportowanie
• scheduler - Harmonogram
• smartstate - Analiza SmartState
• user_interface - Interfejs użytkownika
• websocket - Websocket
• web_services - Usługi internetowe

Zmiennie dostawcy RHV i metryki RHV:

Nazwa	Wartość domyślna	Opis
miq_rhv_provider_name	RHV provider	Nazwa dostawcy RHV, która ma być wyświetlana w ManageIQ.
metrics_fqdn	UNDEF	FQDN metryk oVirt/RHV.
metrics_user	engine_history	Użytkownik do połączenia z serwerem metryk.
metrics_password	""	Hasło użytkownika metrics_user.
metrics_port	5432	Port do połączenia z metrykami oVirt/RHV.
metrics_db_name	ovirt_engine_history	Nazwa bazy danych dla metryk silnika oVirt.

Zależności

Brak.

Przykład Playbooka

Pamiętaj, aby dla haseł używać Ansible vault.

Oto przykład wdrożenia CFME:

    - name: Wdróż CFME do silnika oVirt
      hosts: localhost
      gather_facts: no

      vars_files:
        # Zawiera zaszyfrowaną zmienną `engine_password` używającą ansible-vault
        - passwords.yml

      vars:
        engine_fqdn: ovirt-engine.example.com
        engine_user: admin@internal

        miq_qcow_url: https://cdn.example.com/cfme-rhevm-5.9.1.2-1.x86_64.qcow2
        miq_vm_name: cfme_59
        miq_vm_cluster: mycluster
        miq_vm_cloud_init:
          host_name: "{{ miq_vm_name }}"
        miq_vm_disks:
          database:
            name: "{{ miq_vm_name }}_database"
            size: 10GiB
            interface: virtio_scsi
            format: raw
          log:
            name: "{{ miq_vm_name }}_log"
            size: 10GiB
            interface: virtio_scsi
            format: cow
          tmp:
            name: "{{ miq_vm_name }}_tmp"
            size: 10GiB
            interface: virtio_scsi
            format: cow
        miq_disabled_roles:
          - smartstate
        miq_enabled_roles:
          - notifier
          - ems_metrics_coordinator
          - ems_metrics_collector
          - ems_metrics_processor
          - embedded_ansible

      roles:
        - ovirt.manageiq

Oto przykład wdrożenia ManageIQ:

---
- name: Wdrożenie ManageIQ w oVirt
  hosts: localhost
  connection: local
  gather_facts: false

  vars_files:
    # Zawiera zaszyfrowane zmienne `engine_password` i `metrics_password`
    # używające ansible-vault
    - passwords.yml

  vars:
    engine_fqdn: ovirt.example.com
    engine_user: admin@internal
    engine_cafile: /etc/pki/ovirt-engine/ca.pem

    miq_qcow_url: http://releases.manageiq.org/manageiq-ovirt-hammer-6.qc2
    miq_vm_name: manageiq_hammer6
    miq_vm_cluster: mycluster

    metrics_fqdn: metrics.example.com
    metrics_port: 8443
    metrics_user: admin

  roles:
    - ovirt.manageiq