adt-virt-ssh - クラウドでオンライン

プログラム：

NAME

adt-virt-ssh - SSH を使用した autopkgtest 仮想化サーバー

SYNOPSIS

adt-virt-ssh [オプション] [- スクリプト オプション ...]

DESCRIPTION

adt-virt-ssh SSH を使用した autopkgtest 仮想化サーバーを提供します。

通常は adt-virt-ssh によって呼び出されます 広告実行.

adt-virt-ssh

既存の SSH ターゲットを使用することも、セットアップ スクリプトを呼び出してテスト ベッドを作成/セットアップすることもできます
そしてsshサーバー。

警告！ adt-virt-ssh は、パッケージをインストールして実行することでターゲット システムを変更します。
任意のテストコードなので、 貴社 　 責任 for リセットする 　 テストベッド あなた自身 特に
セットアップスクリプトなしで。 したがって、これは注意して使用してください。

募集要項

adt-virt-ssh ターゲット ホストに関しては、指定されたもの以外は何も想定しません。
ssh 接続 (およびネットワーク) は常に利用可能です。 提供できます
すでに動作している SSH ホストのコマンド ラインで認証情報を入力するか、セットアップ スクリプトを使用して
ホストの接続を準備します (「 セットアップ SCRIPT 詳細については以下を参照)、
SSH 経由で adb ホストにアクセスするか、クラウドを起動するための転送ルールを作成する例
インスタンス。

OPTIONS

-h| - 助けて
ヘルプメッセージを表示して終了します

-d|- デバッグ
デバッグ出力を有効にする

-H hostname | --ホスト名=hostname
指定されたホスト名または IP アドレスに接続してログインします。

-l user | --ログイン=user
リモート マシンにログインするユーザーを指定します。

-i アイデンティティ | --アイデンティティ=アイデンティティ
公開鍵認証用のID（秘密鍵）の元となるファイルを選択します
読まれます。 通常はそうあるべきです 〜/ .ssh / id_rsa、ただし、別の方法を使用することを検討することもできます。
テスト用のキー。

-P password | --password =password
リモートホストの sudo パスワードを指定します。

クリア テキストのパスワード、またはパスワードを含むファイルを使用できます。 これ
sudo でパスワードが必要な場合、パスワードは $SUDO_ASKPASS のセットアップに使用されます。
ランナーは、ユーザーがパスワードの有無にかかわらず sudo アクセス権を持っているかどうかを確認します。 もし
チェックが失敗すると、「root-on-testbed」機能は使用できなくなります。 sudoの場合
動作すると、ユーザーとして実行されるテストには環境内に $SUDO_ASKPASS が含まれるため、
彼らは走れるということ sudo -A 必要に応じて。

-p ポート | --port =ポート
ホストへの接続に使用する ssh ポート

-o オプション | --options =オプション
そのまま ssh に渡されます。 man ssh_config を参照してください

-r|- リブート
それを示してください リブート テストベッドで使用できます。 これはランニング時に便利です
セットアップ スクリプト (すでに機能を宣言できる) を使用せずにテストを再起動します。

-s セットアップスクリプト | --セットアップスクリプト=セットアップスクリプト
テストベッドと SSH 接続を準備するためのセットアップ スクリプト (「 セットアップ SCRIPT 詳細については以下をご覧ください
情報）。 ファイル名は現在のディレクトリと次のディレクトリの両方で検索されます。
/usr/share/autokgtest/ssh-setup/ したがって、フルパスを指定する必要はありません
autopkgtest に同梱されているセットアップ スクリプト。

--timeout-ssh=ドライ
SSH 接続の待機タイムアウト (秒単位)。 デフォルトは 300 です。

-- [設定 スクリプト 引数]
以下の残りのすべての引数 -- そのままセットアップに渡されます
ホストを構成するためのスクリプト。

CONFIGURATION ファイル

多くのオプションやホストを使用する場合は、コマンド ラインの一部または全体を次のように配置できます。
オプションごとにXNUMX行のテキストファイル。 例： あなたはファイルを作成することができます テストホスト.cfg 　
のような内容

-Htest.example.com
-ltestuser
-PS3kr1t

実行してください

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

構成ファイルの内容は、あたかも持っているかのようにインプレースで展開されます
コマンドラインでその内容を指定します。 あなたが しない 場所 スペース の間に
短いオプションとその値は、引数値の一部になります。

入力、 出力 そして EXIT ステータス

の行動 adt-virt-ssh AutomatedTesting仮想化で説明されているとおりです
レジーム仕様。

注意事項

広告実行 実行されません apt-get update パッケージビルドの開始時に、これにより、
開発シリーズテンプレートを使用している場合、ビルドに失敗します。 実行する必要があります apt-get
update テンプレート内で自分で（例： --setup コマンド).

セットアップ SCRIPT

adt-virt-ssh テストベッドと SSH を準備するためのセットアップ スクリプトを引数で受け入れます
繋がり。 セットアップ スクリプトは、最初にコマンドで呼び出される実行可能ファイルです。
引数、およびそのコマンドの追加オプション。

コマンド： 開いた
「open」で呼び出された場合、スクリプトはテストベッドを作成し（必要な場合）、ssh を設定する必要があります。
ssh キーをコピーし、sudo を設定します。

次に、次の情報を標準出力に次の形式で返します。 key = value、 1
ペアごとのライン。 これらは主に、スクリプトを使用しない場合のコマンド ライン オプションを反映しています。

必須フィールド:

* ログイン: ユーザー名

* ホスト名: ホスト名または IP アドレス

オプションのフィールド:

* ID: 秘密鍵へのパス

* パスワード: root 権限を取得するためのユーザー名の sudo パスワード。 与えられなかったら、
パスワードなしの sudo は機能せず、テストベッドには root 権限がありません。

* port: ホスト名の SSH ポート (22 以外の場合)

* 機能: 「isolation-machine」や「revert」などの追加のテストベッド機能。「」を参照してください。
README.virtualisation-server.rst

状態を維持したままテストベッドを再起動できる場合、スクリプトはアドバタイズする必要があります。
"リブート"。

* オプション: そのまま ssh に渡されます。man ssh_config を参照してください。

* extraopts: 他のコマンドにそのまま渡します。 これにより、追加の状態 (たとえば、
クリーンアップに渡される一時ディレクトリ名、VM 識別子など)

コマンド： クリーンアップ
テストベッドを閉じるときに呼び出されます。 開いた状態でインストールされたものをできるだけ元に戻す/削除する必要があります
テストベッドが一時的でない場合は可能です。 これは開いているすべてのオプションとともに呼び出されます
プラスで電話されました エクストラオプト.

コマンド： 元に戻す
テストベッドを元の状態にリセットする方法があるかどうか (VM スナップショットの使用など)
または一時的なテストベッドを再構築する場合）、スクリプトは「revert」を設定する必要があります（必要に応じて、
"revert-full-system") を機能に追加し、このコマンドを実装します。 これはできる
オプションで、open() から ssh 設定キーの一部またはすべてを出力して、
ホスト名/IP が変更された場合に備えて、設定を変更します。

コマンド： 待機、再起動
これは、機能が「再起動」を通知し、何かを行う必要がある場合に実装できます。
SSH ポートがダウンしてから復旧するのをただ待つよりも複雑です。
「再起動」を呼び出します。 これには、テストベッドがシャットダウンして起動し、テストベッドが再準備されるまで待つ必要があります。
SSHログイン用のテストベッド。

コマンド： デバッグ失敗
これは、セットアップ スクリプトがゼロ以外で失敗した場合、または ssh の待機中にタイムアウトが発生した場合に呼び出されます。
リブート。 利用可能な場合は、ブート ログなどのデバッグ情報が出力されます。
シリアルコンソールから。 これの実装はオプションです。

同梱 スクリプト
autopkgtest は、一般的なタイプのテストベッドのセットアップ スクリプトを提供します。
/usr/share/autokgtest/ssh-setup/。 方法については、これらのスクリプトのコメントを参照してください。
それらを使用してください。 ぜひご利用もご検討ください /usr/share/autokgtest/ssh-setup/SKELETON 基礎として
自分で書くため。

例

既存の「mytesthost」で libpng ソース パッケージのテストを実行します。

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

ADB 経由で ssh 接続を使用して、Ubuntu 電話でクリック パッケージのテストを実行します。
セットアップ スクリプト。特定のオプションを選択するセットアップ スクリプトのオプションを指定します。
シリアルID:

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

onworks.net サービスを使用してオンラインで adt-virt-ssh を使用する