adt-virt-ssh - Online in de cloud

PROGRAMMA:

NAAM

adt-virt-ssh - autopkgtest virtualisatieserver met behulp van SSH

KORTE INHOUD

adt-virt-ssh [opties] [-- setup script opties ​

PRODUCTBESCHRIJVING

adt-virt-ssh biedt een autopkgtest virtualisatieserver die gebruik maakt van SSH.

Normaal adt-virt-ssh zal worden aangeroepen door adt-run.

adt-virt-ssh

kan een reeds bestaand ssh-doel gebruiken, of een installatiescript aanroepen om een ​​testbed te maken/in te stellen
en de ssh-server.

WAARSCHUWING! adt-virt-ssh zal het doelsysteem wijzigen door pakketten te installeren en uit te voeren
willekeurige testcode, dus helpen zijn verantwoordelijk voor betere resetten the proefbank jezelf vooral
zonder een installatiescript. Gebruik dit dus met zorg.

VEREISTEN

adt-virt-ssh veronderstelt niets anders met betrekking tot de doelhost dan het gegeven
ssh-verbinding (en netwerken) blijven altijd beschikbaar. Jij kunt voorzien
referenties op de opdrachtregel voor reeds werkende SSH-hosts of gebruik een installatiescript om dit te doen
bereid de host voor op de verbinding (zie ORGANISATIE SCRIPT hieronder voor meer informatie), voor
om bijvoorbeeld een doorstuurregel te maken om toegang te krijgen tot een adb-host via ssh of om een ​​cloud op te starten
aanleg.

OPTIES

-h|--help
Toon het helpbericht en sluit af

-d|--debuggen
Uitvoer voor foutopsporing inschakelen

-H hostname | --hostnaam=hostname
Maakt verbinding en logt in op de opgegeven hostnaam of IP-adres

-l gebruiker | --inloggen=gebruiker
Specificeert de gebruiker die moet inloggen op de externe machine.

-i identiteit | --identiteit=identiteit
Selecteert een bestand waaruit de identiteit (private sleutel) voor authenticatie met openbare sleutel
is gelezen. Zou normaal gesproken zo moeten zijn ~/.ssh/id_rsa, maar u kunt overwegen een andere te gebruiken
sleutel voor testen.

-P wachtwoord | --wachtwoord=wachtwoord
Specificeert het sudo-wachtwoord op de externe host.

Dit kan het wachtwoord in leesbare tekst zijn of een bestand met het wachtwoord. Dit
wachtwoord zal worden gebruikt om $SUDO_ASKPASS in te stellen in het geval dat sudo een wachtwoord vereist.
De runner controleert of de gebruiker sudo-toegang heeft met en zonder wachtwoord. Als
de controle mislukt, de mogelijkheid "root-on-testbed" zal niet beschikbaar zijn. Als sudo
werkt, dan zullen tests die als gebruiker worden uitgevoerd $SUDO_ASKPASS in hun omgeving hebben
dat ze kunnen rennen sudo -A indien nodig.

-p port | --poort=port
ssh-poort die moet worden gebruikt om verbinding te maken met de host

-o opties | --opties=opties
Letterlijk doorgegeven aan ssh; zie man ssh_config

-r|--herstart
Geef aan dat opnieuw op te starten kan worden gebruikt in het testbed. Dit is handig tijdens het hardlopen
het opnieuw opstarten van tests zonder een installatiescript (dat al mogelijkheden kan declareren).

-s setup_script | --setup-script=setup_script
Installatiescript om testbed- en ssh-verbinding voor te bereiden (zie ORGANISATIE SCRIPT hieronder voor meer
informatie). Er wordt gezocht naar bestandsnamen in zowel de huidige map als in
/usr/share/autopkgtest/ssh-setup/ U hoeft dus niet het volledige pad op te geven
installatiescripts meegeleverd met autopkgtest.

--time-out-ssh=secs
Time-out voor het wachten op een SSH-verbinding, in seconden. Standaard is 300.

-- [opgericht script argumenten]
Alle overige argumenten volgen -- wordt letterlijk doorgegeven aan de opstelling
script om de host te configureren.

CONFIGURATIE FILES

Als u veel opties of hosts gebruikt, kunt u delen van de opdrachtregel of de hele opdrachtregel erin plaatsen
een tekstbestand, met één regel per optie. bijv. je kunt een bestand maken testhost.cfg met
inhoud zoals

-Htest.voorbeeld.com
-ltestgebruiker
-Ps3kr1t

en ren dan

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

De inhoud van het configuratiebestand wordt ter plaatse uitgebreid alsof u dat zou hebben gedaan:
gezien de inhoud ervan op de opdrachtregel. Zorg ervoor dat u niet plaats ruimten tussen
korte opties en hun waarden, zouden ze een onderdeel worden van de argumentwaarde.

INVOER, OUTPUT EN EXIT STATUS

het gedrag van adt-virt-ssh is zoals beschreven door de AutomatedTesting virtualisatie
regime specificatie.

OPMERKINGEN

adt-run loopt niet apt-get -update aan het begin van een pakketopbouw, wat kan leiden tot a
build-fout als u een sjabloon voor een ontwikkelreeks gebruikt. Je moet rennen apt-get
-update zelf in de sjabloon (bijv. met behulp van --setup-commando's).

ORGANISATIE SCRIPT

adt-virt-ssh accepteert een setup-script in argument om het testbed en de ssh voor te bereiden
verbinding. Een installatiescript is een uitvoerbaar bestand dat als eerste wordt aangeroepen met een opdracht
argument en extra opties voor die opdracht.

opdracht: open
Wanneer het wordt aangeroepen met "open", moet het script een testbed maken (indien nodig), ssh configureren,
kopieer de ssh-sleutel ernaar, configureer sudo, enz.

Vervolgens retourneert het de volgende informatie over de standaarduitvoer met het formulier sleutel=waarde, een
lijn per paar. Deze weerspiegelen meestal de opdrachtregelopties wanneer er geen script wordt gebruikt.

Verplichte velden:

* login gebruikersnaam

* hostnaam: hostnaam of IP-adres

Optionele velden:

* identiteit: pad naar de privésleutel

* wachtwoord: sudo-wachtwoord voor de gebruikersnaam om rootrechten te verkrijgen. Indien niet gegeven,
en sudo zonder wachtwoord werkt niet, het testbed heeft geen rootrechten.

* poort: SSH-poort op hostnaam, indien anders dan 22

* mogelijkheden: extra testbedmogelijkheden zoals "isolatie-machine" of "revert", zie
README.virtualisatie-server.rst

Als het testbed opnieuw kan worden opgestart terwijl de status behouden blijft, moet het script adverteren
"opnieuw opstarten".

* opties: letterlijk doorgegeven aan ssh, zie man ssh_config

* extraopts: letterlijk doorgegeven aan andere commando's; dit maakt extra status mogelijk (zoals
tijdelijke directorynamen, VM-ID's, enz.) die moeten worden doorgegeven aan het opruimen

opdracht: schoonmaken
Gebeld bij het sluiten van het testbed; zou dingen die in open zijn geïnstalleerd zo vaak moeten terugdraaien/verwijderen als
mogelijk als het testbed niet kortstondig is. Dit wordt aangeroepen met alle geopende opties
werd gebeld met, plus extraopt.

opdracht: terugkeren
Als er een manier is om het testbed terug te zetten naar de oorspronkelijke staat (zoals het gebruik van VM-snapshots
of het opnieuw opbouwen van kortstondige testbedden), moet het script "revert" plaatsen (en indien van toepassing,
"revert-full-system") in de mogelijkheden en implementeer deze opdracht. Dit kan
voer optioneel enkele of alle ssh-configuratiesleutels uit open() uit om het
configuratie, voor het geval de hostnaam/IP verandert.

opdracht: wacht-herstart
Dit kan worden geïmplementeerd als de mogelijkheden "reboot" adverteren en u iets moet doen
uitgebreider dan alleen maar wachten tot de ssh-poort uitvalt en daarna weer omhoog komt
"opnieuw opstarten" roepen. Dit moet wachten totdat testbed is afgesloten, opgestart en opnieuw is voorbereid
testbed voor ssh-login.

opdracht: foutopsporing
Dit wordt aangeroepen wanneer het installatiescript mislukt met een waarde die niet nul is of bij time-outs die wachten op ssh of
opnieuw opstarten. Indien beschikbaar zou dit enige foutopsporingsinformatie moeten opleveren, zoals het opstartlogboek
vanaf de seriële console. Het implementeren hiervan is optioneel.

Inbegrepen scripts
autopkgtest biedt installatiescripts voor veelvoorkomende typen testbedden in
/usr/share/autopkgtest/ssh-setup/. Zie de opmerkingen in deze scripts voor instructies
gebruik ze. Overweeg ook om het te gebruiken /usr/share/autopkgtest/ssh-setup/SKELETON als basis
voor het schrijven van uw eigen tekst.

Voorbeelden

Voer de tests van het libpng-bronpakket uit op een bestaande "mytesthost":

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

Voer de tests van een klikpakket uit op een Ubuntu-telefoon met een ssh-verbinding via ADB, met behulp van
het setup-script, waarbij een optie voor het setup-script wordt opgegeven om een ​​bepaald script te kiezen
seriële ID:

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

Gebruik adt-virt-ssh online met behulp van onworks.net-services