adt-virt-ssh - Online in der Cloud

PROGRAMM:

NAME/FUNKTION

adt-virt-ssh - autopkgtest Virtualisierungsserver mit SSH

ZUSAMMENFASSUNG

adt-virt-ssh [Optionen] [-- -Setup Skript Optionen ...]

BESCHREIBUNG

adt-virt-ssh stellt einen autopkgtest-Virtualisierungsserver mit SSH bereit.

Normalerweise adt-virt-ssh wird aufgerufen von Werbung.

adt-virt-ssh

kann ein bereits vorhandenes ssh-Target verwenden oder ein Setup-Skript aufrufen, um eine Testumgebung zu erstellen/einzurichten
und der SSH-Server.

WARNUNG! adt-virt-ssh modifiziert das Zielsystem, indem es Pakete installiert und ausführt
beliebiger Testcode, also Sie sind für ihren Verlust verantwortlich. für Zurücksetzen die Testbed du selbst insbesondere
ohne Setup-Skript. Verwenden Sie dies also mit Vorsicht.

VORAUSSETZUNGEN

adt-virt-ssh nimmt in Bezug auf den Zielhost nichts anderes an als das angegebene
SSH-Verbindung (und Netzwerk) bleiben die ganze Zeit verfügbar. Sie können zur Verfügung stellen
Anmeldeinformationen auf der Befehlszeile für bereits funktionierende SSH-Hosts oder verwenden Sie ein Setup-Skript, um
Bereiten Sie den Host für die Verbindung vor (siehe SETUP SCRIPT unten für weitere Informationen), für
Beispiel, um eine Weiterleitungsregel zu erstellen, um über ssh auf einen ADB-Host zuzugreifen oder eine Cloud zu starten
Beispiel.

OPTIONAL

-h|--help
Hilfenachricht anzeigen und beenden

-d|--debuggen
Debugging-Ausgabe aktivieren

-H hostname | --hostname=hostname
Verbindet und loggt sich mit dem angegebenen Hostnamen oder der IP-Adresse ein

-l Benutzer | --login=Benutzer
Gibt den Benutzer an, der sich auf dem Remote-Computer anmelden soll.

-i Identität | --identität=Identität
Wählt eine Datei aus, aus der die Identität (privater Schlüssel) für die Authentifizierung mit öffentlichem Schlüssel
ist gelesen. Sollte normalerweise sein ~/.ssh/id_rsa, aber Sie könnten erwägen, eine andere zu verwenden
Schlüssel für Tests.

-P Passwort | --Passwort=Passwort
Gibt das sudo-Kennwort auf dem Remote-Host an.

Dies kann das Passwort im Klartext oder eine Datei sein, die das Passwort enthält. Dies
Passwort wird verwendet, um $SUDO_ASKPASS einzurichten, falls sudo ein Passwort erfordert.
Der Runner prüft, ob der Benutzer sudo-Zugriff mit und ohne Passwort hat. Wenn
die Prüfung fehlschlägt, ist die Fähigkeit "root-on-testbed" nicht verfügbar. Wenn sudo
funktioniert, dann haben Tests, die als Benutzer ausgeführt werden, $SUDO_ASKPASS in ihrer Umgebung, also
dass sie laufen können sudo -A wenn benötigt.

-p port | --port=port
ssh-Port zum Verbinden mit dem Host

-o Optionen | --optionen=Optionen
Wörtlich an ssh übergeben; siehe Mann ssh_config

-r|- Neustart
Weisen darauf hin, dass rebooten kann im Prüfstand verwendet werden. Dies ist nützlich beim Laufen
Neustarten von Tests ohne ein Setup-Skript (das bereits Fähigkeiten deklarieren kann).

-s setup_script | --setup-script=setup_script
Setup-Skript zum Vorbereiten von Testbed und SSH-Verbindung (Siehe SETUP SCRIPT unten für mehr
Information). Dateinamen werden sowohl im aktuellen Verzeichnis als auch in . gesucht
/usr/share/autopkgtest/ssh-setup/ Sie müssen also nicht den vollständigen Pfad angeben für
Setup-Skripte, die mit autopkgtest geliefert werden.

--timeout-ssh=Sekunden
Timeout für das Warten auf eine SSH-Verbindung in Sekunden. Der Standardwert ist 300.

-- [erstellen Skript Argumente]
Alle verbleibenden Argumente folgen -- wird wörtlich an das Setup übergeben
Skript zum Konfigurieren des Hosts.

CONFIGURATION DATEIEN

Wenn Sie viele Optionen oder Hosts verwenden, können Sie Teile oder die gesamte Befehlszeile in
eine Textdatei mit einer Zeile pro Option. Z.B. Sie können eine Datei erstellen testhost.cfg mit
Inhalte wie

-Htest.example.com
-ltestuser
-Ps3kr1t

und dann rennen

adt-run [...] --- adt-virt-ssh @testhost.cfg

Der Inhalt der Konfigurationsdatei wird an Ort und Stelle erweitert, als ob Sie dies getan hätten
seinen Inhalt in der Befehlszeile angegeben. Bitte stellen Sie sicher, dass Sie nicht Ort Räume zwischen
Short-Optionen und ihre Werte, würden sie Teil des Argumentwerts werden.

EINGANG, AUSGABE UND EXIT STATUS

Das Verhalten von adt-virt-ssh ist wie von der AutomatedTesting-Virtualisierung beschrieben
Regimespezifikation.

ANMERKUNG

Werbung läuft nicht apt-get Aktualisierung zu Beginn eines Paketerstellungsvorgangs, was zu a
Buildfehler, wenn Sie eine Entwicklungsserienvorlage verwenden. Du musst laufen apt-get
Aktualisierung in der Vorlage selbst (z. B. mit --setup-Befehle).

SETUP SCRIPT

adt-virt-ssh akzeptiert ein Setup-Skript als Argument, um das Testbed und die ssh . vorzubereiten
Verbindung. Ein Setup-Skript ist eine ausführbare Datei, die mit einem Befehl als erstes aufgerufen wird
-Argument und zusätzliche Optionen für diesen Befehl.

Befehl: XNUMXh geöffnet
Beim Aufruf mit "open" muss das Skript ggf. ein Testbed erstellen, ssh konfigurieren,
ssh-Schlüssel hineinkopieren, sudo konfigurieren usw.

Es gibt dann die folgenden Informationen zur Standardausgabe mit dem Formular zurück Schlüssel=Wert, eins
Linie pro Paar. Diese spiegeln meistens die Befehlszeilenoptionen, wenn kein Skript verwendet wird.

Benötigte Felder:

* Login Benutzername

* Hostname: Hostname oder IP-Adresse

Optionale Felder:

* Identität: Pfad zum privaten Schlüssel

* password: sudo-Passwort für den Benutzernamen, um Root-Rechte zu erhalten. Wenn nicht gegeben,
und passwortloses sudo nicht funktioniert, hat das Testbed keine Root-Rechte.

* port: SSH-Port auf Hostname, falls anders als 22

* Fähigkeiten: zusätzliche Testbed-Fähigkeiten wie "Isolation-Machine" oder "Revert", siehe
README.virtualisierung-server.rst

Wenn das Testbed unter Beibehaltung des Status neu gestartet werden kann, sollte das Skript ankündigen
"Neustart".

* Optionen: wörtlich an ssh übergeben, siehe man ssh_config

* extraopts: wörtlich an andere Befehle übergeben; Dies ermöglicht zusätzliche Status (wie
temporäre Verzeichnisnamen, VM-Kennungen usw.), die an die Bereinigung übergeben werden

Befehl: Aufräumarbeiten
Wird beim Schließen des Testbeds aufgerufen; sollte die installierten Dinge so weit wie möglich wiederherstellen / entfernen
möglich, wenn das Testbed nicht ephemer ist. Dies wird mit allen Optionen aufgerufen, die sich öffnen
wurde mit angerufen, plus Extraoptionen.

Befehl: zurückkehren
Wenn es eine Möglichkeit gibt, das Testbed in seinen ursprünglichen Zustand zurückzusetzen (z. B. mithilfe von VM-Snapshots
oder ephemere Testbeds neu erstellen), sollte das Skript "revert" setzen (und ggf.
"revert-full-system") in die Fähigkeiten und implementieren diesen Befehl. Das kann
Geben Sie optional einige oder alle ssh-Konfigurationsschlüssel von open() aus, um die
Konfiguration, falls sich der Hostname/die IP ändert.

Befehl: warte-neustart
Dies kann implementiert werden, wenn Fähigkeiten "Neustart" ankündigen und Sie etwas tun müssen
aufwendiger als nur darauf zu warten, dass der SSH-Port herunterfährt und danach wieder hochkommt
Aufruf von "Neustart". Dies muss warten, bis das Testbed heruntergefahren, gestartet und erneut vorbereitet wird
Testumgebung für SSH-Login.

Befehl: Debug-Fehler
Dies wird aufgerufen, wenn das Setup-Skript mit einem Wert ungleich Null oder bei Timeouts beim Warten auf ssh oder . fehlschlägt
Neustart. Falls verfügbar, sollte dies einige Debugging-Informationen ausgeben, z. B. das Boot-Log
von der seriellen Konsole. Die Implementierung ist optional.

Im Preis inbegriffen Skripte
autopkgtest bietet Setup-Skripte für gängige Arten von Testbeds in
/usr/share/autopkgtest/ssh-setup/. Bitte lesen Sie die Kommentare in diesen Skripten, um zu erfahren, wie es geht
benutze sie. Erwägen Sie auch die Verwendung von /usr/share/autopkgtest/ssh-setup/SKELETON als Grundlage
zum selber schreiben.

Beispiele:

Führen Sie die Tests des libpng-Quellpakets auf einem vorhandenen "mytesthost" aus:

adt-run libpng --- ssh -H mytesthost -l joe -P /tmp/joe_password

Führen Sie die Tests eines Klickpakets auf einem Ubuntu-Telefon mit einer SSH-Verbindung über ADB aus, indem Sie
das Setup-Skript, mit der Angabe einer Option für das Setup-Skript, um ein bestimmtes auszuwählen
Seriennummer:

adt-run ./ubuntu-calculator-app ./com.ubuntu.calculator_1.3.283_all.click \
--- ssh -s /usr/share/autopkgtest/ssh-setup/adb -- -s 0123456789abcdef

Verwenden Sie adt-virt-ssh online mit den onworks.net-Diensten