openqa-cli POST-Beispiele¶
Diese Seite bietet einen kurzen Überblick über einige grundlegende openqa-cli POST-Beispiele.
System-/Zugriffsanforderungen¶
Um eines der Beispiele durchzuarbeiten, führen Sie bitte die im Dokument openQA - Rocky Production Access beschriebenen API POST-Zugriffsschritte durch.
Basic POST¶
Für jede der standardmäßigen Testsuiten für die verschiedenen Rocky Linux-Medien, die zur Verfügung gestellt werden, kann ein einfacher POST-Request verwendet werden. Die folgenden Beispiele zeigen einige dieser Standard-POST-Anfragen, die von unserem Team häufig verwendet werden und anhand derer einige kleinere Variationen veranschaulicht werden.
FLAVOR=boot-iso¶
Dieser erste POST-Aufruf ist der einfachste und stellt lediglich die minimalen Variablen bereit, die erforderlich sind, um die Standard-Testsuite für das Rocky Linux 9.6 Boot-ISO auf OpenQA-Workern für die x86_64-Architektur auszulösen. Alle Tests der Testsuite sind vordefiniert und auf dem openQA-Server konfiguriert. Da die Boot-ISO keine Pakete enthält, handelt es sich bei dieser Testsuite effektiv um eine Netzwerkinstallation von Standard-Repository-Servern Rocky Linux und/oder Spiegelservern.
$ openqa-cli api -X POST isos ISO=Rocky-9.6-x86_64-boot.iso ARCH=x86_64 \
DISTRI=rocky FLAVOR=boot-iso VERSION=9.6 CURRREL=9 BUILD=20250604-Rocky-9.6-x86_64.0
FLAVOR=minimal-iso¶
Dieser POST-Request demonstriert, wie ein anderer Medientyp, in diesem Fall das minimale ISO-Format, für eine alternative Rocky Linux Version, in diesem Fall Rocky Linux 8.10, ausgelöst werden kann. Wie aus diesem und dem vorherigen POST-Befehl hervorgeht, bezeichnet die Variable BUILD typischerweise das Datum, die Version und die Architektur der Testsuite. Da das minimale ISO alle Pakete enthält, die für eine minimale Installation von Rocky Linux erforderlich sind, entspricht dies dem Verhalten dieser Testsuite.
$ openqa-cli api -X POST isos ISO=Rocky-8.10-x86_64-minimal.iso ARCH=x86_64 \
DISTRI=rocky FLAVOR=minimal-iso VERSION=8.10 CURRREL=8 BUILD=20250527-Rocky-8.10-x86_64.0
FLAVOR=package-set¶
Dieser POST demonstriert die Spezifikation des endgültigen normalen Medientyps, der DVD-ISO, zusammen mit einem sogenannten FLAVOR, in diesem Fall einem package-set für die Architektur x86_64 und Rocky Linux 9.6. Da die DVD-ISO alle Pakete enthält, die zum Zeitpunkt der Veröffentlichung einer bestimmten Version oder Rocky Linux verfügbar sind, testet die Testsuite package-set die Installation aller primären Installationstypen von Rocky Linux, die nicht in der oben genannten Testsuite minimal-iso enthalten sind.
$ openqa-cli api -X POST isos ISO=Rocky-9.6-x86_64-dvd.iso ARCH=x86_64 \
DISTRI=rocky FLAVOR=package-set VERSION=9.6 CURRREL=9 BUILD=20250604-Rocky-9.6-x86_64.0
Diese drei Testreihen gewährleisten das Mindesttesting aller ISOs, die für eine bestimmte Version von Rocky Linux erstellt werden.
Advanced POST¶
Zusätzlich zu den oben beschriebenen Basic POSTs gibt es weitere Standardtest-Suites, die das DVD-ISO-Medium verwenden und wesentlich mehr Testfälle enthalten. Dazu zählen:
- Installation in grafischer, textbasierter und serieller Konsole
- Installation für Standard-BIOS und UEFI
- Validierung des Anaconda-Hilfesystems
- Verschiedene Festplattenlayout-Varianten, einschließlich LVM, RAID, Partitionsverkleinerung und/oder -vergrößerung, iSCSI und LUKS
- PXE-Installation von verschiedenen Netzwerkquellen
- Installation in verschiedenen Sprachen
Die Standard-POST-Anfragen für diese Test-Suites ähneln sehr den oben genannten grundlegenden POST-Anfragen und werden im Folgenden dargestellt...
FLAVOR=dvd-iso¶
$ openqa-cli api -X POST isos ISO=Rocky-9.6-x86_64-dvd.iso ARCH=x86_64 \
DISTRI=rocky FLAVOR=dvd-iso VERSION=9.6 CURRREL=9 BUILD=20250604-Rocky-9.6-x86_64.0
FLAVOR=universal¶
$ openqa-cli api -X POST isos ISO=Rocky-9.6-x86_64-dvd.iso ARCH=x86_64 \
DISTRI=rocky FLAVOR=universal VERSION=9.6 CURRREL=9 BUILD=20250604-Rocky-9.6-x86_64.0
Sammlung von Testsuiten nach BUILD¶
Eine Besonderheit von openQA ist, dass für eine bestimmte Jobgruppe Testsuiten, die denselben BUILD-Identifikator verwenden, in einer einzigen Ansicht in der Web-Benutzeroberfläche zusammengefasst werden.
Daher werden die oben gezeigten Beispiele, die alle BUILD=20250604-Rocky-9.6-x86_64.0 verwenden, alle in einer einzigen Ansicht angezeigt. Diese Ansicht ist außerdem über eine vorhersehbare URI zugänglich, beispielsweise https://openqa.rockylinux.org/tests/overview?build=20250604-Rocky-9.6-x86_64.0, wie unten dargestellt...
Referenzen¶
Additional Information
If you have questions with respect to this content or to report concerns regarding the use or misuse content please do not hesitate to contact us at info@rockylinux.org.
Rocky Linux and the Rocky Enterprise Software Foundation (RESF) does not make any express or implied warranties, including but not limited to the warranties of non-infringement of any third party intellectual property rights. RESF does not warrant that any pending trademark applications for trademarks of RESF will result in any granted trademark protection. RESF shall not be liable for any claims relating to user's activities falling within the scope of the permission and user hereby agrees to indemnify, defend and hold RESF and its contributors harmless against any such claim.
This content is licensed under under Attribution-Share Alike 4.0 International license unless otherwise noted.
Author: Trevor Cooper