ManageIQ in oVirt bereitstellen

Diese Rolle wurde in die oVirt Ansible Collection migriert. Bitte verwenden Sie die neueste Version dort. Dieses Repository ist jetzt nur noch lesbar und wird nicht mehr aktiv weiterentwickelt.

Die Rolle ovirt.manageiq lädt ein ManageIQ/CloudForms QCOW-Image herunter und stellt es in oVirt/Red Hat Virtualization (RHV) bereit.

Die Rolle ermöglicht es auch, eine virtuelle Maschine zu erstellen und das ManageIQ-Laufwerk anzuhängen. Danach wartet sie, bis das ManageIQ-System initialisiert ist und registriert oVirt als Infrastruktur-Anbieter.

Hinweis

Bitte beachten Sie, dass Sie beim Installieren dieser Rolle aus Ansible Galaxy aufgefordert werden, den folgenden Befehl auszuführen:

$ ansible-galaxy install ovirt.manageiq

Dies wird die Rolle in das Verzeichnis herunterladen, das den gleichen Namen hat wie der, den Sie in der Befehlszeile angegeben haben, in diesem Fall ovirt.manageiq. Beachten Sie jedoch, dass dies Groß- und Kleinschreibung beachtet, also wenn Sie beispielsweise OVIRT.manageiq angeben, wird die gleiche Rolle heruntergeladen, aber in das Verzeichnis mit dem Namen OVIRT.manageiq. Daher müssen Sie diese Rolle später immer mit dem Großbuchstaben-Präfix verwenden. Seien Sie vorsichtig, wie Sie den Namen der Rolle in der Befehlszeile angeben.

Für die RPM-Installation verwenden wir drei veraltete Namen: oVirt.manageiq, ovirt.manageiq und ovirt-manageiq. Sie können also jeden dieser Namen verwenden. Diese Dokumentation und die Beispiele in diesem Repository verwenden den Namen ovirt.manageiq. Die Rollennamen oVirt.manageiq und ovirt-manageiq sind veraltet.

Voraussetzungen

• oVirt muss Version 4.0.4 oder höher sein.
• Ansible muss Version 2.9 oder höher sein.
• ovirt-imageio muss installiert und aktiv sein.
• oVirt Python SDK Version 4.

Zusätzlich sollten Sie die folgenden Überprüfungen durchführen, um sicherzustellen, dass die erforderlichen Prozesse laufen.

• Überprüfen Sie, ob ovirt-imageio-proxy auf dem Engine läuft:

systemctl status ovirt-imageio-proxy

• Überprüfen Sie, ob ovirt-imageio-daemon auf den Hosts läuft:

systemctl status ovirt-imageio-daemon

Sie benötigen auch das CA-Zertifikat der Engine. Konfigurieren Sie dazu die Variable ovirt_ca mit dem Pfad zum CA-Zertifikat.

Einschränkungen

• Wir unterstützen nicht den Ansible Check Mode (Trockenlauf), da diese Rolle einige Module (Befehlsmodul) verwendet, die dies nicht unterstützen. Sobald alle von dieser Rolle verwendeten Module dies unterstützen, werden wir dies unterstützen.

Rollenvariablen

QCOW-Variablen:

Name	Standardwert	Beschreibung
miq_qcow_url	http://releases.manageiq.org/manageiq-ovirt-hammer-6.qc2	Die URL des ManageIQ QCOW-Images.
miq_image_path	/tmp/	Pfad, in den das QCOW2-Image heruntergeladen wird. Wenn ein Verzeichnis angegeben wird, wird der Basisname der URL auf dem Remote-Server verwendet.
miq_image_checksum	UNDEF	Wenn eine Prüfziffer definiert ist, wird der Hash des Ziel-Links berechnet, nachdem er heruntergeladen wurde, um die Integrität sicherzustellen und zu überprüfen, dass der Transfer erfolgreich abgeschlossen wurde. Format: :, z.B. checksum="sha256:D98291AC[...]B6DC7B97".

Variablen für den Engine-Login:

Name	Standardwert	Beschreibung
engine_user	UNDEF	Der Benutzer für den Zugriff auf die Engine.
engine_password	UNDEF	Das Passwort des 'engine_user'.
engine_fqdn	UNDEF	Der FQDN der Engine.
engine_ca	UNDEF	Der Pfad zum CA-Zertifikat der Engine.

Variablen für die virtuelle Maschine:

Name	Standardwert	Beschreibung
miq_vm_name	manageiq_gaprindashvili-3	Der Name der ManageIQ-Virtualmaschinen.
miq_vm_cluster	Default	Der Cluster der virtuellen Maschine.
miq_vm_memory	16GiB	Der Systemspeicher der virtuellen Maschine.
miq_vm_memory_guaranteed	UNDEF	Die Menge des minimal garantierten Speichers der virtuellen Maschine. Der Parameter miq_vm_memory_guaranteed darf nicht niedriger sein als der Parameter miq_vm_memory.
miq_vm_memory_max	UNDEF	Obergrenze des Arbeitsspeichers der virtuellen Maschine, bis zu der der Arbeitsspeicher erhitzt werden kann.
miq_vm_cpu	4	Die Anzahl der CPU-Kerne der virtuellen Maschine.
miq_vm_cpu_shares	UNDEF	Setzen von CPU-Anteilen für diese virtuelle Maschine.
miq_vm_cpu_sockets	UNDEF	Anzahl der virtuellen CPU-Sockel der virtuellen Maschine.
miq_vm_cpu_threads	UNDEF	Anzahl der virtuellen CPU-Threads der virtuellen Maschine.
miq_vm_os	rhel_7x64	Das Betriebssystem der virtuellen Maschine.
miq_vm_root_password	miq_app_password	Das Root-Passwort für die virtuelle Maschine.
miq_vm_cloud_init	UNDEF	Das Cloud-Init-Dictionary, das der virtuellen Maschine übergeben werden soll.
miq_vm_high_availability	true	Wenn ja, wird die ManageIQ-VM als hochverfügbar eingestellt.
miq_vm_high_availability_priority	50	Gibt die Priorität der virtuellen Maschine innerhalb der Ausführungs- und Migrationswarteschlangen an. Der Wert ist eine Ganzzahl zwischen 0 und 100. Je höher der Wert, desto höher die Priorität.
miq_vm_delete_protected	true	Wenn ja, wird die ManageIQ-VM als schreibgeschützt für Löschung festgelegt.
miq_debug_create	false	Wenn wahr, werden sensible Daten protokolliert, nützlich für Debug-Zwecke.
miq_wait_for_ip_version	v4	Gibt an, auf welche IP-Version gewartet werden soll. Entweder v4 oder v6.
miq_wait_for_ip_timeout	240	Maximale Wartezeit, die das Playbook auf die IP-Übertragung warten sollte.

Variablen für die Hauptlaufwerke der virtuellen Maschine (z.B. Betriebssystem):

Name	Standardwert	Beschreibung
miq_vm_disk_name	miq_vm_name	Der Name des Laufwerks der virtuellen Maschine.
miq_vm_disk_storage	UNDEF	Das Zielspeicherdomain des Laufwerks.
miq_vm_disk_size	Größe des qcow-Laufwerks	Die Größe des Laufwerks der virtuellen Maschine.
miq_vm_disk_interface	virtio_scsi	Der Typ des Laufwerks-Interface der virtuellen Maschine.
miq_vm_disk_format	cow	Das Format des Laufwerks der virtuellen Maschine.

Zusätzliche Laufwerke für die virtuelle Maschine (z.B. Datenbank, Protokoll, tmp): Ein Dict namens miq_vm_disks, das es ermöglicht, jedes zusätzliche Laufwerk zu beschreiben (siehe Beispiel-Playbook). Beachten Sie, dass dies nur mit CFME funktioniert. Für jedes Laufwerk können die folgenden Attribute festgelegt werden:

Name	Standardwert	Beschreibung
name	miq_vm_name_type	Der Name des Laufwerks der virtuellen Maschine.
size	UNDEF	Die Größe des Laufwerks der virtuellen Maschine (XXGiB).
interface	virtio_scsi	Der Typ des Interface des Laufwerks der virtuellen Maschine (virtio oder virtio_scsi). virtio_scsi wird empfohlen, da virtio eine niedrige Begrenzung für die Anzahl der Laufwerke hat.
format	UNDEF	Das Format des Laufwerks der virtuellen Maschine (raw oder cow).
timeout	UNDEF	Timeout für die Erstellung des Laufwerks.

Variablen für die Netzwerkkarten der virtuellen Maschine:

Name	Standardwert	Beschreibung
miq_vm_nics	{'name': 'nic1', 'profile_name': 'ovirtmgmt', 'interface': 'virtio'}	Liste von Dictionaries, die die Netzwerkinterfaces der virtuellen Maschine definieren.

Das Element in der Liste miq_vm_nics kann folgende Attribute enthalten:

Name	Standardwert
name	UNDEF	Der Name des Netzwerkinterfaces.
interface	UNDEF	Typ des Netzwerkinterfaces.
mac_address	UNDEF	Benutzerdefinierte MAC-Adresse des Netzwerkinterfaces, standardmäßig wird diese aus dem MAC-Pool abgefragt.
profile_name	UNDEF	Virtuelles Netzwerk-Interface-Profil, das an die VM-Netzwerkkarte angeschlossen werden soll.

ManageIQ-Variablen:

Name	Standardwert	Beschreibung
miq_app_username	admin	Der Benutzername für den Login zu ManageIQ.
miq_app_password	smartvm	Das Passwort des Benutzers, der im Benutzernamen für den Login zu ManageIQ verwendet wird.
miq_username	admin	Aliases von miq_app_username für die Rückwärtskompatibilität.
miq_password	smartvm	Aliases von miq_app_password für die Rückwärtskompatibilität.
miq_db_username	root	Der Benutzername für die Verbindung zur Datenbank.
miq_db_password	miq_app_password	Das Passwort des Benutzers, der im Benutzernamen zur Verbindung zur Datenbank verwendet wird.
miq_region	0	Die ManageIQ-Region, die in der Datenbank erstellt wurde. Hinweis: Funktioniert nur mit CFME.
miq_company	Mein Unternehmen	Der Firmenname des Appliances.
miq_disabled_roles	[]	Liste der ManageIQ-Serverrollen, die auf dem Appliance deaktiviert werden sollen.
miq_enabled_roles	[]	Liste der ManageIQ-Serverrollen, die auf dem Appliance aktiviert werden sollen.

Sowohl bei ManageIQ als auch bei CloudForms sind die standardmäßig aktivierten Serverrollen:

• automate - Automatisierungs-Engine
• database_operations - Datenbankoperationen
• event - Ereignisüberwachung
• ems_inventory - Anbieter-Inventar
• ems_operations - Anbieteroperationen
• reporting - Berichterstattung
• scheduler - Scheduler
• smartstate - SmartState-Analyse
• user_interface - Benutzeroberfläche
• websocket - Websocket
• web_services - Web-Services

Variablen für den RHV-Anbieter und RHV-Metriken:

Name	Standardwert	Beschreibung
miq_rhv_provider_name	RHV-Anbieter	Name des RHV-Anbieters, der in ManageIQ angezeigt wird.
metrics_fqdn	UNDEF	FQDN der oVirt/RHV-Metriken.
metrics_user	engine_history	Der Benutzer für die Verbindung zum Metrikserver.
metrics_password	""	Das Passwort des metrics_user.
metrics_port	5432	Port zur Verbindung mit den oVirt/RHV-Metriken.
metrics_db_name	ovirt_engine_history	Datenbankname der Metriken-Datenbank der oVirt-Engine.

Abhängigkeiten

Keine.

Beispiel-Playbook

Beachten Sie, dass Sie für Passwörter Ansible-Vault verwenden sollten.

Hier ist ein Beispiel, wie Sie CFME bereitstellen können:

    - name: CFME auf der oVirt-Engine bereitstellen
      hosts: localhost
      gather_facts: no

      vars_files:
        # Enthält das verschlüsselte `engine_password`-Variable, das mit ansible-vault erstellt wurde
        - 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

Hier ist ein Beispiel, wie Sie ManageIQ bereitstellen können:

---
- name: Bereitstellung von oVirt ManageIQ
  hosts: localhost
  connection: local
  gather_facts: false

  vars_files:
    # Enthält die verschlüsselten Variablen `engine_password` und `metrics_password`
    # mit 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