26 libvirt und Ceph #

Erstellen Sie einen Pool. Im folgenden Beispiel wird der Poolname libvirt-pool mit 128 Placement Groups verwendet.

cephuser@adm > ceph osd pool create libvirt-pool 128 128

Verifizieren Sie, dass der Pool vorhanden ist.

cephuser@adm > ceph osd lspools

Erstellen Sie einen Ceph-Benutzer. Das folgende Beispiel verwendet den Ceph-Benutzernamen client.libvirt und verweist auf libvirt-pool.

cephuser@adm > ceph auth get-or-create client.libvirt mon 'profile rbd' osd \
 'profile rbd pool=libvirt-pool'

Verifizieren Sie, dass der Name vorhanden ist.

cephuser@adm > ceph auth list

Anmerkung: Benutzername oder ID

libvirt greift auf Ceph mit der ID libvirt zu, nicht mit dem Ceph-Namen client.libvirt. Unter Abschnitt 30.2.1.1, „Benutzer“ finden Sie eine detaillierte Erklärung zum Unterschied zwischen ID und Name.

Erstellen Sie ein Image in Ihrem RBD-Pool mit QEMU. Das folgende Beispiel verwendet den Image-Namen new-libvirt-image und verweist auf libvirt-pool.

Tipp: Speicherort der Schlüsselbunddatei

Der Benutzerschlüssel libvirt ist in einer Schlüsselbunddatei im Verzeichnis /etc/ceph gespeichert. Die Schlüsselbunddatei muss einen geeigneten Namen aufweisen, der den Namen des Ceph-Clusters enthält, zu dem sie gehört. Für den Standard-Cluster-Namen „ceph“ lautet der Name der Schlüsselbunddatei /etc/ceph/ceph.client.libvirt.keyring.

Wenn der Schlüsselbund nicht vorhanden ist, erstellen Sie ihn mit:

cephuser@adm > ceph auth get client.libvirt > /etc/ceph/ceph.client.libvirt.keyring

# qemu-img create -f raw rbd:libvirt-pool/new-libvirt-image:id=libvirt 2G

Verifizieren Sie, dass das Image vorhanden ist.

cephuser@adm > rbd -p libvirt-pool ls

Installieren Sie einen Manager für virtuelle Maschinen.

# zypper in virt-manager

Bereiten Sie ein Betriebssystem-Image des Systems vor, das Sie virtualisiert ausführen möchten, oder laden Sie es herunter.

Starten Sie den VM-Manager.

virt-manager

Wählen Sie die Verbindung aus der Liste aus, klicken Sie mit der rechten Maustaste darauf und wählen Sie Neu aus.

Importieren Sie das bestehende Festplatten-Image, indem Sie den Pfad zum bestehenden Speicher angeben. Geben Sie den Betriebssystemtyp, die Arbeitsspeichereinstellungen und den Namen der virtuellen Maschine an, beispielsweise libvirt-virtual-machine.

Stellen Sie die Konfiguration fertig und starten Sie die VM.

Verifizieren Sie mit sudo virsh list, dass die neu erstellte Domäne vorhanden ist. Geben Sie die Verbindungszeichenkette wie folgt an, falls erforderlich:

virsh -c qemu+ssh://root@vm_host_hostname/system list
Id    Name                           State
-----------------------------------------------
[...]
 9     libvirt-virtual-machine       running

Melden Sie sich bei der VM an und stoppen Sie sie, bevor Sie sie zur Verwendung mit Ceph konfigurieren.

Öffnen Sie die Konfigurationsdatei mit virsh edit vm-domain-name.

# virsh edit libvirt-virtual-machine

Unter <devices> sollte ein <disk>-Eintrag vorhanden sein.

<devices>
    <emulator>/usr/bin/qemu-system-SYSTEM-ARCH</emulator>
    <disk type='file' device='disk'>
      <driver name='qemu' type='raw'/>
      <source file='/path/to/image/recent-linux.img'/>
      <target dev='vda' bus='virtio'/>
      <address type='drive' controller='0' bus='0' unit='0'/>
    </disk>

Ersetzen Sie /path/to/image/recent-linux.img durch den Pfad zum Betriebssystem-Image.

Wichtig

Verwenden Sie sudo virsh edit anstelle eines Texteditors. Wenn Sie die Konfigurationsdatei unter /etc/qemu mit einem Texteditor ändern, erkennt libvirtlibvirt die Änderung möglicherweise nicht. Wenn eine Diskrepanz zwischen dem Inhalt der XML-Datei unter /etc/libvirt/qemu und dem Ergebnis aus sudo virsh dumpxml vm-domain-name auftritt, funktioniert Ihre VM möglicherweise nicht ordnungsgemäß.

Fügen Sie das vorher erstellte Ceph RBD-Image als <disk>-Eintrag hinzu.

<disk type='network' device='disk'>
        <source protocol='rbd' name='libvirt-pool/new-libvirt-image'>
                <host name='monitor-host' port='6789'/>
        </source>
        <target dev='vda' bus='virtio'/>
</disk>

Ersetzen Sie monitor-host durch den Namen Ihres Hosts und ersetzen Sie den Pool und/oder den Image-Namen wie erforderlich. Sie haben die Möglichkeit, für Ihre Ceph Monitors mehrere <Host>-Einträge hinzuzufügen. Das dev-Attribut ist der logische Gerätename, der unter dem /dev-Verzeichnis Ihrer VM angezeigt wird. Das optionale Busattribut gibt den Typ des zu emulierenden Datenträgergeräts an. Die gültigen Einstellungen sind treiberspezifisch (zum Beispiel ide, scsi, virtio, xen, usb oder sata).

Datei speichern.

Wenn bei Ihrem Ceph-Cluster die Authentifizierung aktiviert ist (was standardmäßig der Fall ist), dann müssen Sie ein Geheimnis generieren. Öffnen Sie den Editor Ihrer Wahl und erstellen Sie eine Datei namens secret.xml mit folgendem Inhalt:

<secret ephemeral='no' private='no'>
        <usage type='ceph'>
                <name>client.libvirt secret</name>
        </usage>
</secret>

Definieren Sie das Geheimnis.

# virsh secret-define --file secret.xml
<uuid of secret is output here>

Rufen Sie den client.libvirt-Schlüssel ab und speichern Sie die Schlüsselzeichenkette in eine Datei.

cephuser@adm > ceph auth get-key client.libvirt | sudo tee client.libvirt.key

Legen Sie die UUID für das Geheimnis fest.

# virsh secret-set-value --secret uuid of secret \
--base64 $(cat client.libvirt.key) && rm client.libvirt.key secret.xml

Sie müssen auch das Geheimnis manuell festlegen. Fügen Sie dazu den folgenden <auth>-Eintrag zum vorher eingegebenen <disk>-Element hinzu (was den UUID-Wert durch das Ergebnis aus dem oben genannten Kommandozeilenbeispiel ersetzt).

# virsh edit libvirt-virtual-machine

Fügen Sie dann das <auth></auth>-Element zur Konfigurationsdatei der Domäne hinzu:

...
</source>
<auth username='libvirt'>
        <secret type='ceph' uuid='9ec59067-fdbc-a6c0-03ff-df165c0587b8'/>
</auth>
<target ...

Anmerkung

Die Beispiel-ID ist libvirt, nicht der Ceph-Name client.libvirt wie in Schritt 2 in Abschnitt 26.1, „Konfigurieren von Ceph mit libvirt“ generiert. Stellen Sie sicher, dass Sie die ID-Komponente des generierten Ceph-Namens verwenden. Wenn Sie aus irgendeinem Grund das Geheimnis neu generieren müssen, dann müssen Sie sudo virsh secret-undefine uuid ausführen, bevor Sie sudo virsh secret-set-value erneut ausführen.

Prüfen Sie, ob Ceph ausgeführt wird:

cephuser@adm > ceph health

Prüfen Sie, ob die VM ausgeführt wird:

# virsh list

Prüfen Sie, ob die VM mit Ceph kommuniziert: Ersetzen Sie vm-domain-name durch den Namen Ihrer VM-Domäne:

# virsh qemu-monitor-command --hmp vm-domain-name 'info block'

Überprüfen Sie, ob das Gerät vom &target dev='hdb' bus='ide'/> unter /dev oder unter /proc/partitions erscheint:

> ls /dev
> cat /proc/partitions