virt-dib – Online in der Cloud

PROGRAMM:

NAME/FUNKTION

virt-dib – Diskimage-Builder-Elemente ausführen

ZUSAMMENFASSUNG

virt-dib -B DIB-LIB [Optionen] Elemente...

BESCHREIBUNG

Virt-dib ist ein Tool zur Verwendung der Elemente von „diskimage-builder“ zum Erstellen einer neuen Festplatte
Image erstellen, neue Ramdisk generieren usw.

Virt-dib ist als sicherer Ersatz für „diskimage-builder“ und dessen Funktionen gedacht
„ramdisk-image-create“-Modus finden Sie unter „VERGLEICH MIT DISKIMAGE-BUILDER“ für eine kurze Beschreibung
Vergleich mit der Verwendung von „diskimage-builder“.

„diskimage-builder“ ist Teil des TripleO OpenStack-Projekts:
https://wiki.openstack.org/wiki/TripleO.

Beispiele:

Bauen einfach Bildern of Ausschüttungen
virt-dib \
-B /Pfad/zu/diskimage-builder/lib \
-p /Pfad/zu/diskimage-builder/elements \
--envvar DIB_RELEASE=jessie \
--name debian-jessie \
debian vm

Dadurch wird ein Debian Jessie (8.x)-Disk-Image erstellt, das für die Ausführung als virtuelle Maschine geeignet ist.
gespeichert als debian-jessie.qcow2.

Bauen Ramdisks
virt-dib \
-B /Pfad/zu/diskimage-builder/lib \
-p /Pfad/zu/diskimage-builder/elements \
--ramdisk \
--name Ramdisk \
Ubuntu Deploy-ironisch

Dadurch wird eine Ramdisk für die Ironic OpenStack-Komponente basierend auf der Ubuntu-Distribution erstellt.

OPTIONAL

--help
Hilfe anzeigen.

-B PATH
Legen Sie den Pfad zum Bibliotheksverzeichnis von „diskimage-builder“ fest. Dies ist normalerweise der lib
Unterverzeichnis in den Quellen und bei der Installation, und /usr/share/diskimage-builder/lib
wenn eingebaut / usr.

Dieser Parameter ist Pflichtfeld, da virt-dib es für die Elemente bereitstellen muss (wie einige
von ihnen könnten darin Skripte verwenden). Virt-dib selbst nutzt die Bibliothek nicht
Verzeichnis.

--Bogen ARCHITEKTUR
Verwenden Sie die angegebene Architektur für das Ausgabebild. Der Standardwert ist derselbe wie
Der Host, auf dem virt-dib ausgeführt wird.

Im Moment macht diese Option nichts weiter, als die Umgebungsvariable „ARCH“ festzulegen
für die Elemente, und es liegt an ihnen, ein Bild für die gewünschten Elemente zu erstellen
die Architektur.

--debuggen LEVEL
Setzen Sie die Debug-Ebene auf „LEVEL“, eine nicht negative Ganzzahl. Der Standard
ist 0.

Diese Debug-Ebene unterscheidet sich von dem, was -x und -v gesetzt, und es erhöht das Debugging
Informationen ausgedruckt. Insbesondere werden dadurch „DIB_DEBUG_TRACE“ und ein beliebiger Wert festgelegt
> 0 ermöglicht die Nachverfolgung in den ausgeführten Skripten.

--Antrieb DISK
Fügen Sie die angegebene Festplatte hinzu, die als Hilfslaufwerk zum Zwischenspeichern der Dateien verwendet werden soll
Elemente wie Disk-Images, Distributionspakete usw.

Siehe „HELFER-ANTRIEB“.

-p PATH
--element-path PATH
Fügen Sie einen neuen Pfad mit Elementen hinzu. Pfade werden in der gleichen Reihenfolge wie verwendet -p Parameter
erscheinen, also wird zuerst nach einem Pfad gesucht, der zuerst angegeben wurde, und so weiter.

Natürlich empfiehlt es sich, den Pfad zu den eigenen Elementen von hinzuzufügen
„diskimage-builder“, da die meisten anderen Elemente auf ihnen basieren.

--extra-packages PAKET,...
Installieren Sie zusätzliche Pakete im zu erstellenden Image.

Dies basiert auf der von der Paketverwaltung bereitgestellten Binärdatei „install-packages“.
Elemente.

Diese Option kann mehrmals angegeben werden, jedes Mal mit mehreren Paketen
durch Komma getrennt.

--envvar VARIABLE
--envvar VARIABLE=WERT
Tragen Sie eine Umgebungsvariable für die Elemente oder legen Sie sie fest.

Weitere Informationen zur Interaktion und Verwendung von finden Sie weiter unten unter „UMGEBUNGSVARIABLEN“.
Umgebungsvariablen.

Diese Option kann auf zwei Arten genutzt werden:

--envvar VARIABLE
Tragen Sie die Umgebungsvariable „VARIABLE“. Wenn es nicht gesetzt ist, wird nichts exportiert
zu den Elementen.

--envvar VARIABLE=WERT
Setzen Sie die Umgebungsvariable „VARIABLE“ mit dem Wert „VALUE“ für die Elemente,
unabhängig davon, ob eine Umgebungsvariable mit demselben Namen existiert.

Dies kann nützlich sein, um Umgebungsvariablen zu übergeben, ohne sie in zu exportieren
Umgebung, in der virt-dib ausgeführt wird.

--exclude-element ELEMENT
Ignorieren Sie das angegebene Element.

--exclude-script SCRIPT
Ignorieren Sie alle Elementskripte mit dem Namen „SCRIPT“, unabhängig davon, in welchem ​​Element sie sich befinden.

Dies kann nützlich sein, wenn beispielsweise ein Skript mit virt-dib nicht gut läuft
wenn sie die Umgebung von „diskimage-builder“ wirklich benötigen.

--formate FORMAT,...
Legen Sie die Liste der Ausgabeformate fest und trennen Sie diese durch Kommas.

Unterstützte Formate sind:

„qcow2“ (standardmäßig aktiviert)
QEMUs qcow2.

"roh"
Raw-Festplattenformat.

"Teer"
Ein unkomprimierter Tarball.

„vhd“
Disk-Image „Virtuelle Festplatte“. Dieses Ausgabeformat erfordert das Tool „vhd-util“.

Bitte beachten Sie, dass die Version des Tools „vhd-util“ gepatcht werden muss, um das zu unterstützen
Unterbefehl „convert“ verwenden und bootfähig sein. Der Patch ist hier verfügbar:
https://github.com/emonty/vhd-util/blob/master/debian/patches/citrix.

--fs-Typ DATEISYSTEM
Legen Sie den Dateisystemtyp fest, der für das Root-Dateisystem verwendet werden soll. Der Standardwert ist „ext4“.

Siehe auch „guestfs_filesystem_available“ in Gastfs(3).

--image-cache DIRECTORY
Legen Sie den Pfad im Host fest, in dem die von den Elementen verwendeten Ressourcen zwischengespeichert werden
Phase „extra-data.d“. Die Standardeinstellung ist ~/.cache/image-create.

Bitte beachten Sie, dass die meisten nach „Extra-Data“ abgerufenen Ressourcen im Cache gespeichert werden
das mit angegebene Hilfslaufwerk --Antrieb; siehe auch „HELPER DRIVE“.

--install-type TYP
Geben Sie den Standardinstallationstyp an. Der Standardwert ist „Quelle“.

Auf „Paket“ setzen, um standardmäßig paketbasierte Installationen zu verwenden.

--maschinenlesbar
Diese Option wird verwendet, um die Ausgabe maschinenfreundlicher zu machen, wenn sie von geparst wird
andere Programme. Siehe "MASCHINENLESBARE AUSGABE" unten.

-m MB
- Speichergröße MB
Ändern Sie die der Appliance zugewiesene Speichermenge. Erhöhen Sie dies, wenn Sie das finden
Der virt-dib-Ausführung steht nicht mehr genügend Arbeitsspeicher zur Verfügung.

Die Voreinstellung kann mit diesem Befehl gefunden werden:

Guestfish get-memsize

--mkfs-options „OPTION STRING“
Fügen Sie die angegebenen Optionen hinzu mkfs(1), um das Root-Dateisystem feinabstimmen zu können
Schaffung. Beachten Sie, dass es nicht möglich ist, den Dateisystemtyp zu überschreiben.

Du solltest benutzen --mkfs-options höchstens einmal. Um mehrere Optionen zu übergeben, trennen Sie diese
mit Leerzeichen, z.B.:

virt-dib ... --mkfs-options '-O someopt -I foo'

--Netzwerk
--kein Netzwerk
Aktivieren oder deaktivieren Sie den Netzwerkzugriff des Gasts während der Installation.

Aktiviert ist die Standardeinstellung. Verwenden --kein Netzwerk um den Zugriff zu deaktivieren.

Das Netzwerk lässt nur ausgehende Verbindungen zu und hat andere kleinere Einschränkungen. Sehen
"NETZWERK" in virt-rettung(1).

Dies hat keinen Einfluss darauf, ob der Gast nach dem Booten auf das Netzwerk zugreifen kann,
weil das von Ihrem Hypervisor oder Ihrer Cloud-Umgebung gesteuert wird und nichts zu tun hat
tun mit virt-dib.

Wenn Du --kein Netzwerk, dann wird die Umgebungsvariable „DIB_OFFLINE“ auf 1 gesetzt,
Signalisierung der Elemente, dass sie nur zwischengespeicherte Ressourcen verwenden sollen, wenn diese verfügbar sind.
Beachten Sie auch, dass Elemente im Gegensatz zu „diskimage-builder“ möglicherweise immer noch dazu in der Lage sind
Der Zugriff auf das Netzwerk ist auch mit „DIB_OFFLINE=" möglich, unter virt-dib ist das Netzwerk vollständig verfügbar
unzugänglich.

--Name NAME/FUNKTION
Legen Sie den Namen der Ausgabebilddatei fest. Der Standardwert ist „Bild“.

Je nach gewähltem Namen befindet sich im aktuellen Verzeichnis Folgendes:

$NAME.ext
Für jedes Ausgabeformat ein Disk-Image, benannt nach dem Ausgabe-Image mit dem
Erweiterung je nach Format; Zum Beispiel: $NAME.qcow2, $NAME.raw, usw.

Gilt nicht im Ramdisk-Modus, siehe „RAMDISK-AUFBAU“.

$NAME.d
Ein Verzeichnis, das beispielsweise alle von den Elementen erstellten Dateien enthält dib-
manifestiert Verzeichnis (erstellt durch das „manifests“-Element), Ramdisks und Kernel in
Ramdisk-Modus usw.

--no-delete-on-failure
Löschen Sie die Ausgabedateien nicht, wenn die Erstellung fehlschlägt. Sie können dies zum Debuggen von Fehlern verwenden
um Skripte auszuführen.

Standardmäßig wird die Ausgabedatei gelöscht, wenn virt-dib fehlschlägt (oder beispielsweise einige
das ausgeführte Skript schlägt fehl).

-q
--ruhig
Drucken Sie keine gewöhnlichen Fortschrittsmeldungen.

--qemu-img-options Option[,Option,...]
Passieren --qemu-img-options Option(en) zum qemu-img(1) Befehl zur Feinabstimmung der Ausgabe
Format. Die verfügbaren Optionen hängen vom Ausgabeformat ab (siehe --formate) und das
Installierte Version des Programms qemu-img.

Du solltest benutzen --qemu-img-options höchstens einmal. Um mehrere Optionen zu übergeben, trennen Sie diese
sie mit Kommas, zB:

virt-dib ... --qemu-img-options cluster_size=512,preallocation=metadata ...

--ramdisk
Legen Sie den Ramdisk-Erstellungsmodus fest.

Siehe „RAMDISK-AUFBAU“.

--ramdisk-element NAME/FUNKTION
Legen Sie den Namen für das zusätzliche Element fest, das im Ramdisk-Erstellungsmodus hinzugefügt wird. Der Standard
ist „Ramdisk“.

Siehe „RAMDISK-AUFBAU“.

--root-label LABEL
Legen Sie die Bezeichnung für das Root-Dateisystem im erstellten Image fest.

Bitte beachten Sie, dass einige Dateisysteme unterschiedliche Einschränkungen hinsichtlich der Länge haben
Etiketten; Beispielsweise dürfen Labels auf „ext2/3/4“-Dateisystemen nicht länger als 16 sein
Zeichen, während sie auf „xfs“ höchstens 12 Zeichen haben.

Der Standardwert hängt vom tatsächlichen Dateisystem für die Root-Partition ab (siehe --fs-Typ):
auf „xfs“ ist „img-rootfs“, während „cloudimg-rootfs“ auf jedem anderen Dateisystem ist.

--Größe GRÖßE
Wählen Sie die Größe des Ausgabedatenträgers aus, wobei die Größe mit allgemeinen Namen angegeben werden kann
wie „32G“ (32 Gigabyte) usw. Die Standardgröße ist „5G“.

Um die Größe in Byte anzugeben, muss der Zahl der Kleinbuchstabe folgen b, z.B:
"--Größe 10737418240b".

Web Link virtuelle Größenänderung(1) zum Ändern der Partitionsgröße eines vorhandenen Disk-Images.

--skip-base
Überspringen Sie die Einbeziehung des Elements „base“.

--smp N
Aktivieren Sie N ≥ 2 virtuelle CPUs für die Verwendung durch Skripte.

-u Komprimieren Sie die resultierenden qcow2-Bilder nicht. Standardmäßig werden sie komprimiert.

-v
- ausführlich
Debugging-Nachrichten aktivieren.

-V
--Version
Versionsnummer anzeigen und beenden.

-x Aktivieren Sie die Ablaufverfolgung von libguestfs-API-Aufrufen.

VARIABLEN

Anders als bei „diskimage-builder“ ist es die Umgebung des Hosts nicht geerbt in der
Appliance, wenn die meisten Elemente ausgeführt werden (d. h. alle anderen als
„extra-data.d“).

Um die Umgebung für die ausgeführten Elemente festzulegen, muss virt-dib angewiesen werden, es zu verwenden
sie, mit der Option --envvar. Mit dieser Option können Sie die Umgebung selektiv exportieren
Variablen beim Ausführen der Elemente und ist die bevorzugte Methode zum Übergeben der Umgebung
Variablen zu den Elementen.

Um es noch einmal zusammenzufassen: Wenn Sie möchten, dass die Umgebungsvariable „MYVAR“ (und ihr Inhalt) verfügbar ist
zu den Elementen können Sie beides tun

export MYVAR #, je nachdem, welcher Wert es ist
virt-dib ... --envvar MYVAR ...

or

virt-dib ... --envvar MYVAR=value_of_it ...

HELPER FAHREN

Virt-dib führt den Großteil des Elements in seiner eigenen Appliance und somit nicht auf dem Host aus. Weil
Aus diesem Grund besteht für Elemente keine Möglichkeit, Ressourcen direkt auf dem Host zwischenzuspeichern.

Um dieses Problem zu lösen, ermöglicht virt-dib die Verwendung eines Hilfslaufwerks zum Speichern im Cache
Ressourcen wie Disk-Images, Distributionspakete usw. Dies bedeutet zwar, dass es eine gibt
Es steht weniger Speicherplatz für das Caching zur Verfügung, zumindest kann der Speicherplatz auf dem Host begrenzt werden
Caches, ohne davon auszugehen, dass Elemente dies selbst tun.

Derzeit muss auf dieser Festplatte entweder eine einzelne oder die erste Partition vorhanden sein
Die darauf befindliche Partition wird verwendet. Eine Festplatte mit der letztgenannten Konfiguration kann problemlos erstellt werden
mit Gastfisch(1) wie folgt:

Guestfish -N Dateiname.img=fs:ext4:10G

Dadurch wird ein Disk-Image mit dem Namen erstellt Dateiname.img, 10G groß, mit einer einzigen Partition
vom Typ ext4; siehe „VORBEREITETE DISK-IMAGES“ in Gastfisch(1).

Es wird empfohlen, dass es ≥ 10G oder sogar mehr ist, da Elemente Disk-Images zwischenspeichern.
Distributionspakete usw. Wie bei jedem Disk-Image kann die Größe der Hilfsdiskette leicht geändert werden
mit automatisierten virtuelle Größenänderung(1) wenn mehr Platz darin benötigt wird.

Auf das Laufwerk kann wie auf jedes andere Disk-Image zugegriffen werden, beispielsweise mit anderen Tools von
libguestfs wie Gastfisch(1):

Guestfish -a Dateiname.img -m /dev/sda1

Wenn kein Hilfslaufwerk mit angegeben ist --Antrieb, alle während eines Virt-Dib zwischengespeicherten Ressourcen
Der Lauf wird verworfen.

RESSOURCEN INSIDE FAHREN
Im Hilfslaufwerk können die folgenden Ressourcen gefunden werden:

/ Home
Dieses Verzeichnis wird während des Builds als Umgebungsvariable „HOME“ festgelegt. Es beinhaltet
Meistens der Bildcache (gespeichert als /home/.cache/image-create) und was auch immer
Die Ressource wird im Home-Verzeichnis des Benutzers zwischengespeichert, der die verschiedenen Tools ausführt.

/virt-dib-*.log
Dies sind die Protokolle der Elemente, die innerhalb der libguestfs-Appliance ausgeführt werden
bedeutet alle Hooks außer „extra-data.d“.

RAMDISK GEBÄUDE-

Virt-dib kann auch „ramdisk-image-create“ emulieren, was eine sekundäre Betriebsart von ist
„Diskimage-Builder“. Anstatt ein anderer Toolname zu sein, bietet virt-dib eine einfache Möglichkeit
Zugriff auf diesen Modus über die --ramdisk Schalter.

In diesem Modus:

· Es wurde ein zusätzliches Ramdisk-Element hinzugefügt (siehe --ramdisk-element)

· Es wird kein Bild erzeugt (so --formate wird ignoriert)

· $NAME.d (sehen --Name) enthält initrd, Kernel usw

VORÜBERGEHEND DIRECTORY

Virt-dib verwendet das standardmäßige temporäre Verzeichnis, das von libguestfs verwendet wird, siehe „UMGEBUNG
VARIABLEN" in Gastfs(3).

Standardmäßig ist dieser Speicherort / Tmp (Standardwert für „TMPDIR“), was auf einigen Systemen der Fall sein kann
auf einem tmpfs-Dateisystem liegen und daher standardmäßig eine maximale Größe von haben Hälfte des physischen RAM.
Wenn virt-dib diesen Wert überschreitet, kann es hängen bleiben oder vorzeitig mit einem Fehler beendet werden. Die Lösung ist
Zeigen Sie „TMPDIR“ auf einen permanenten Standort, der als temporärer Standort verwendet wird, zum Beispiel:

mkdir local-tmp
env TMPDIR=$PWD/local-tmp virt-dib ...
rm -rf local-tmp

EXTRA ABHÄNGIGKEITEN

Da virt-dib die meisten Elemente in seiner eigenen Appliance ausführt, sind alle Tools und
Bibliotheken, die von Elementen verwendet werden, die außerhalb des Gasts ausgeführt werden (normalerweise „root.d“,
„block-device.d“ und „cleanup.d“) müssen ebenfalls in der Appliance vorhanden sein. Falls
Ist dies nicht der Fall, schlagen Skripte meistens mit der Fehlermeldung „Befehl nicht gefunden“ fehl.

Für Tools und Bibliotheken, die in der Distribution enthalten sind, besteht die einfache Lösung darin, dies zu sagen
libguestfs, um zusätzliche Pakete in die Appliance aufzunehmen. Dies ist z. B. machbar
Erstellen einer neuen Datei mit den zusätzlichen Paketen:

# echo wget > /usr/lib64/guestfs/supermin.d/dib-my-extra

Der eigentliche Weg zum supermin.d Verzeichnis hängt von der Distribution ab; zusätzliche Dateien
kann weitere Pakete auflisten, jedes in einer eigenen Zeile.

VERGLEICH MIT DISKIMAGE-BUILDER

Virt-dib ist als sicherer Ersatz für „diskimage-builder“ und dessen Funktionen gedacht
Modus „Ramdisk-Image-Create“; Die für den Benutzer bemerkenswerten Unterschiede bestehen in:

· die Befehlszeilenargumente; Einige der Argumente sind die gleichen wie in
„diskimage-builder“, während einige unterschiedliche Namen haben:

disk-image-create virt-dib
----------------- --------
-a ARCH --arch ARCH
--image-size GRÖSSE --size GRÖSSE
--max-online-resize GRÖSSE machbar mit --mkfs-options
-n --skip-base
-o BILDNAME --name BILDNAME
-p PAKET(E) --extra-packages PAKET(E)
-t FORMAT(S) --formats FORMAT(S)
-x --debug N

· der Speicherort von Nicht-Image-Ausgabedateien (wie Ramdisks und Kernels)

· die Art und Weise, wie einige der zwischengespeicherten Ressourcen gespeichert werden: mithilfe eines Hilfslaufwerks, nicht direkt darauf
die Festplatte, auf der virt-dib ausgeführt wird

· die Notwendigkeit, eine Zielgröße für die Ausgabefestplatte anzugeben, im Gegensatz zu
„diskimage-builder“ berechnet ein optimales

· den Umgang mit Umgebungsvariablen, siehe „UMGEBUNGSVARIABLEN“.

Darüber hinaus gibt es neben den libguestfs-eigenen Umgebungsvariablen (siehe „UMGEBUNG
VARIABLEN" in Gastfs(3)) liest virt-dib keine andere Umgebungsvariable: this
bedeutet, dass alle Optionen und Verhaltensänderungen ausschließlich über den Befehl angegeben werden
Zeilenargumente

· „extra-data.d“-Skripte werden in der Host-Umgebung vor allen anderen (sogar) ausgeführt
"root.d"); Dies bedeutet, dass je nach Konfiguration der Elemente einige von
Sie können aufgrund fehlender Inhalte (normalerweise Verzeichnisse) in „TMP_HOOKS_PATH“ fehlschlagen.

Problemumgehungen hierfür können sein:

· Korrigieren Sie die „extra-data.d“-Skripte, um die fehlenden Verzeichnisse zu erstellen

· Erstellen (und verwenden) Sie ein einfaches Element mit einem „extra-data.d“-Skript namens z. B
00-fehlende-Verzeichnisse erstellen um die fehlenden Verzeichnisse zu erstellen

· Zusätzliche Tools, die für einige Out-of-Chroot-Phasen benötigt werden, müssen in der Appliance verfügbar sein.
siehe „EXTRA ABHÄNGIGKEITEN“.

Die Elemente selbst sollten keinen Unterschied in der Art und Weise bemerken, wie sie ausgeführt werden. Verhalten
Unterschiede können auf falsche Annahmen in den Elementen oder eine nicht korrekte Virt-Dib-Emulation zurückzuführen sein.

Derzeit bekannte Probleme:

· (keiner)

MACHINE LESBAR AUSGABE

Die --maschinenlesbar Option kann verwendet werden, um die Ausgabe maschinenfreundlicher zu machen, was
ist nützlich, wenn virt-dib von anderen Programmen, GUIs usw. aufgerufen wird.

Verwenden Sie die Option allein, um die Funktionen der virt-dib-Binärdatei abzufragen. Typisch
Ausgabe sieht so aus:

$ virt-dib --maschinenlesbar
virt-dib
Ausgabe:qcow2
Ausgabe:tar
Ausgabe:roh
Ausgabe:vhd

Eine Liste von Funktionen wird gedruckt, eine pro Zeile, und das Programm wird mit dem Status 0 beendet.

PRÜFUNG

Virt-dib wurde mit „diskimage-builder“ (und seinen Elementen) ≥ 0.1.43 getestet; von Zeit
zeitweise auch mit „tripleo-image-elements“ und „sahara-image-elements“.

Frühere Versionen funktionieren möglicherweise, es gibt jedoch keine Garantie dafür.

EXIT STATUS

Dieses Programm gibt 0 zurück, wenn es erfolgreich ist, oder ungleich Null, wenn ein Fehler aufgetreten ist.

Verwenden Sie virt-dib online über die Dienste von onworks.net