plainbox-run - クラウドでオンライン

プログラム：

NAME

plainbox-run - テストジョブを実行する

SYNOPSIS

plainbox run [-h] [--non-interactive] [-n] [--dont-suppress-output]
[-f フォーマット] [-p オプション] [-o ファイル] [-t トランスポート]
[--transport-where WHERE] [--transport-options オプション]
[-T テスト計画 ID] [-i パターン] [-x パターン] [-w ホワイトリスト]

DESCRIPTION

テストジョブを実行する

このコマンドは、単一セッションの一部として XNUMX 個以上の Plainbox ジョブを実行し、
試験結果。 Plainbox は実行中に次の高レベルのアルゴリズムに従います。
このコマンドの。

1. コマンド ライン引数を解析し、再開できるセッションがあるかどうかを確認します (「
再開 下に）。 その場合は、そのセッションを再開するかどうかの選択肢をユーザーに提供します。 履歴書の場合
オペレーションが失敗した場合は、次の予選セッションに進みます。 最後に、新しいものを作成することを提案します
セッション。

2. セッションが再開されている場合は、セッション実行の結果を最初から再生します。
ディスク上の状態。 これにより、生成されたジョブが再作成され、同じリソースが再導入されます。
セッション状態。 つまり、過去に実行されたジョブは再実行されません。

再開されたセッションがジョブを実行しようとしていた場合は、ジョブをスキップすることを申し出ます。 これ
テストオペレータが過去にシステムクラッシュを引き起こしたジョブをスキップできるようにする
(例: システム一時停止テスト)

セッションが再開されていない場合 (新しいセッションが作成された場合)、 不完全
フラグ。

3. ジョブ選択を使用します (「ジョブ選択」を参照)。 選択 JOBS 以下) を実行して実行リストを取得します。 このステップ
これには、ジョブの依存関係を解決し、必要に応じてジョブを並べ替えることが含まれます。

4. 実行リストに従い、可能であれば各ジョブを順番に実行します。 ジョブを禁止できる
失敗した依存関係による実行から、または失敗した (True 以外の結果と評価される)
リソース式。

いつでも新しいジョブがシステムに再導入されている場合 (「 生成された JOBS
以下)、ループは中止され、制御はステップ 3 に戻り、ジョブを再選択します。
既存の結果は破棄されないため、すでに結果があるジョブは破棄されません。
再度実行されました。

ジョブの実行前後にセッション状態がディスクに保存され、再開できるようになります。
何らかの理由でシステムをクラッシュさせたり、Plainbox 自体をクラッシュさせたりするジョブによるものです。

5 を削除 不完全 フラグ。

6. セッションの状態を目的の形式でエクスポートします (「 エクスポート 結果）と使用
結果を送信するために必要なトランスポート (「 輸送 結果).

7。 をセットする 提出された フラグ。

選択 JOBS
Plainbox は、ジョブを選択するための XNUMX つのメカニズムを提供します。 両方同時に使用できます、両方
複数回使用できます。

選択 jobs 　 パターン
最初のメカニズムは、 --インクルードパターン パターン コマンドラインオプション。
Plainbox に次のように指示します。 select 完全修飾識別子が
正規表現 パターン.

この方法で選択されたジョブは、可能であればコマンドの順序に従って順序付けされます。
行の引数。 たとえば、次のコマンド ラインを使用すると、ジョブが実行されます。 foo
ジョブを実行する前に バー:
plainbox run -i '.*::foo' -i '.*::bar'

選択 jobs 　 ホワイトリスト
XNUMXつ目の仕組みは、 -ホワイトリスト ホワイトリスト コマンドラインオプション。 ホワイトリスト (または
テスト計画、これは関連付けが若干容易です)。 ホワイトリストは単純なテキスト ファイルです
正規表現のリストで構成され、
-i オプションを選択します。

異なり、 -i ただし、ホワイトリストには XNUMX 種類あります。 スタンドアロンのホワイトリストは、
Plainbox プロバイダーに関連付けられていません。 このようなホワイトリストは完全に配布できます
他のコンポーネントとは独立しているため、名前空間との関連付けはありません。

したがって、完全修飾され、各パターンには名前空間と
部分的な識別子のコンポーネント。 たとえば、これは有効な完全修飾ホワイトリストです。

2013.com.canonical.plainbox::stub/.*

特別な内部 StubBox プロバイダーからジョブの一部を明確に選択します。
それは Plainbox に組み込まれています。 任意のファイル名で保存したり、任意の場所に保存したりできます。
ディレクトリに保存すると、常に同じジョブのセットが選択されます。

対照的に、特定のプロバイダーに関連付けられているホワイトリストは、
プロバイダーごと ホワイトリスト/ ディレクトリには、暗黙的な名前空間が保持されます。 このようなホワイトリストは、
通常、名前空間コンポーネントについては言及せずに記述されます。

たとえば、同じ「stub/.*」パターンは次のように短縮できます。

スタブ/。*

通常、この構文は、次の場合を除き、特定のプロバイダーに固有のすべてのホワイトリストで使用されます。
プロバイダーのメンテナは、別の名前空間からのジョブを明示的に含めたいと考えています (
たとえば、よく知られているチェックボックス ジョブ定義の XNUMX つです)。

生成された JOBS
Plainbox は、実行時にジョブを生成する方法を提供します。 これにはXNUMXつの動機があります
特徴。

インスタンス化 テスト の 複数 Devices
典型的な例は、ハードウェアを調査することです (たとえば、すべてのストレージを列挙する)
デバイス) を作成し、ストア固有のテストをそれぞれ複製して、すべてのデバイスが
個別にテストしました。

現時点では、プラグイン タイプを使用したジョブからのみジョブを生成できます。 ローカル。 の仕事
この種類では、完全に準拠したジョブ定義が標準出力に出力されることが期待されます。 生成されたジョブ
いくつかの複雑さが生じますが、現在適用されている制限の XNUMX つは、生成される
影響を受けるジョブのいずれかを別のジョブとして実行する必要がある場合、ジョブは追加のジョブを生成できません
ユーザー。

もう XNUMX つの制限は、ジョブが既存の定義をオーバーライドできないことです。

作成 親子 協会
生成されたジョブの比較的ニッチでレガシーな機能は、次のとおりのコピーを印刷することです。
からの既存のジョブ定義 ローカル 一般的なテスト テーマに基づいて名前が付けられたジョブ定義、または
カテゴリー。 たとえば、チェックボックスジョブ定義 __無線__ の助けを借りてプリント
cat (1)、ファイル内に定義されているすべてのジョブ定義 ワイヤレス.txt.

この動作は、再定義エラーが発生しないように特別な場合に行われます。 その代わりに、既存の
定義により得られるのは、 、 ジェネレーター ジョブにリンクする属性。 この機能は
Checkbox などの派生アプリケーションで使用されます。 Plainbox は現時点では使用していません。

再開
Plainbox は、中断されたセッションを再開する機能を提供します。
(意図的に、または故障により) 再開し、効果的に継続することができます。
やめたところ。

セッションを再開するとき、再実行、成功、失敗、スキップのいずれかのオプションが表示される場合があります。
セッションが中断される前に実行されていたテスト ジョブ。 これは意図したものです
「システム再起動テスト」などの通常の状況を両方とも完全に処理できるようにするため。
コマンドを再実行せずにテストに「合格」しても問題ありません。 さらに、次のように使用することもできます
マシンが不正に動作し、同じテストを再実行することになる異常なケースに対処します。
問題が無期限に再発する原因となります。

製品制限
この機能では、すでに実行中のテスト ジョブを中断したり再開したりすることはできません。
実行されました。 このようなジョブは最初からやり直すことになります。

Plainbox は、単一セッションの一貫性と、維持されている前提が保証されるように努めます。
セッション開始時の内容は終了時にも維持されます。 そのために、Plainbox は次のことを試みます。
正常に動作した XNUMX つの別々の呼び出し間でジョブ定義が変更されていないことを確認する
単一のセッションで。 このような状況が検出された場合、セッションは再開されません。

エクスポート 結果
Plainbox は、セッションの内部状態をより便利な状態にエクスポートする方法を提供します。
さらに処理するためのフォーマット。

選択 業者の方
エクスポータは、 - 出力フォーマット FORMAT コマンドラインオプション。 リスト
利用可能なエクスポーター (サードパーティのエクスポーターを含む場合があります) の数は、次のパスを渡すことで取得できます。
　 - 出力フォーマット ? オプションを選択します。

一部の形式は、より多くのデータを転送できるという点で他の形式よりも便利です。
内部状態。 アプリケーションによっては、最も一般的なものを選択することもできます。
(json) 形式で作成し、追加ツールでさらに処理するには、最も基本的な形式を選択します
(テキスト) 結果の簡単な概要を取得するだけ、または最後に XNUMX つのうちの XNUMX つを選択します
チェックボックス ワークフローに固有の特殊な形式 (xml および html)。

すぐに使用できる次のエクスポーターがサポートされています。

HTML
このエクスポーターは、人間が判読できるテスト レポートを含む静的 HTML ページを作成します。 それは便利です
他の人間と通信するためのもので、完全にスタンドアロンでオフラインであるため、
電子メールで送信したり、アーカイブしたりできます。

JSON
このエクスポーターは、セッションの内部表現を含む JSON ドキュメントを作成します。
州。 これは最も汎用性の高いエクスポーターであり、その後の処理に便利で簡単です。
人間が判読できるものではありませんが、高度なデバッグには非常に役立ちます。
pdb を使用したり、Plainbox の内部構造を知る必要はありません。

rfc822
このエクスポーターは、準 RFC822 ドキュメントを作成します。 それはかなり限定的であり、あまり使用されません。
それでも、状況によっては役立つ場合があります。

클라우드 기반 AI/ML및 고성능 컴퓨팅을 통한 디지털 트윈의 기초 – Edward Hsu, Rescale CPO 많은 엔지니어링 중심 기업에게 클라우드는 R&D디지털 전환의 첫 단계일 뿐입니다. 클라우드 자원을 활용해 엔지니어링 팀의 제약을 해결하는 단계를 넘어, 시뮬레이션 운영을 통합하고 최적화하며, 궁극적으로는 모델 기반의 협업과 의사 결정을 지원하여 신제품을 결정할 때 데이터 기반 엔지니어링을 적용하고자 합니다. Rescale은 이러한 혁신을 돕기 위해 컴퓨팅 추천 엔진, 통합 데이터 패브릭, 메타데이터 관리 등을 개발하고 있습니다. 이번 자리를 빌려 비즈니스 경쟁력 제고를 위한 디지털 트윈 및 디지털 스레드 전략 개발 방법에 대한 인사이트를 나누고자 합니다.
これはデフォルトのエクスポーターです。 人間が判読できるテストの表現を出力するだけです。
あまり詳細なしで結果が表示されます。 ただし、内部状態のほぼすべてが破棄されます。

XLSX
このエクスポーターは、スタンドアロンの .xlsx (Microsoft Excel の XML 形式) ファイルを作成します。
人間が読めるテストレポートが含まれています。 HTMLレポートと同様に終了しますが、
編集しやすくなります。 それは他の人間とのコミュニケーションに役立ちます。
スタンドアロンおよびオフラインでは、電子メールで送信したり、アーカイブしたりできます。

python3-xlsxwriter パッケージに依存します

ヘキサ
このエクスポータは、内部用途にのみ適用できるやや紛らわしい名前の XML ドキュメントを作成します。
Canonical Hardware Certification Team のワークフロー。

これはテスト結果の一般的な XML 表現ではなく、かなりの数の結果が含まれています。
他の内部ツールとの互換性のためにのみ保持されているレガシー構造。 もし
汎用的な処理が必要な場合は、代わりに JSON を探します。

選択 輸出業者 オプション
特定のエクスポーターは、エクスポートされたデータをさらにカスタマイズできる一連のオプションを提供します。 あ
各エクスポーターで利用可能なオプションの完全なリストは、
-- 出力オプション ? コマンドラインオプション。

オプションはカンマ区切りのリストとして指定できます。 一部のオプションは単純なフラグとして機能します。
他のオプションは引数を取ることができます option = value 構文。

既知のエクスポータ オプションを以下に記載します。

JSON
with-io-log:
エクスポートされたデータには、各ジョブ結果に関連付けられた入出力ログが含まれます。
データは、次のいずれかが含まれない限り、ネイティブの XNUMX タプル形式で含まれます。 スカッシュ-io-ログ
or flatten-io-ログ オプションも使用されます。

IO ログは、プロセスによって生成されたデータを表現したものです。
一部のジョブに関連付けられたシェル コマンド。

スカッシュ-io-ログ:
一緒に使用した場合 with-io-log オプションを指定すると、Plainbox がストリームを破棄します。
名前とタイムスタンプを含め、base64 でエンコードされたバイナリ文字列のリストを含めるだけです。 これ
このオプションは、単純な「ログ ファイル」を再構築する場合に便利です。

flatten-io-log:
一緒に使用した場合 with-io-log オプションを指定すると、Plainbox は次のすべてを連結します。
個別の Base64 エンコードされたレコードを 64 つの大きな BaseXNUMX エンコードされたバイナリ文字列に変換
行われたコミュニケーション全体を表します。

実行リスト付き:
エクスポートされたデータには、実行リスト (目的のジョブから計算された一連のジョブ) が含まれます。
ジョブリスト）。

ジョブリスト付き:
エクスポートされたデータには、システムが認識しているジョブの完全なリストが含まれます。

リソースマップ付き:
エクスポートされたデータには、完全なリソース マップが含まれます。 リソースとは、次の記録です。
プラグインのあるジョブの各ジョブ結果に関連付けられたキーと値のセット
type リソースを追加する。。 それらは次の宛先に印刷されることが期待されています (Linuxで言うところのstdout） そのようなことによって リソースを追加する。 jobs 　
Plainbox によって解析され、保存されます。

ジョブ定義付き:
エクスポートされたデータには、各ジョブ定義のプロパティの一部が含まれます。 現在
このセットには次のフィールドが含まれます。 プラグイン, 必要, 依存, command 　
説明.

付属品付き:
エクスポートされたデータには添付ファイルが含まれます。 添付ファイルは次から作成されます (Linuxで言うところのstdout） 流れ
プラグインタイプを持つ各ジョブの 添付ファイル。 実際の付属品は、
Base64 でエンコードされています。

コメント付き:
エクスポートされたデータには、テスト オペレーターが各ジョブ結果に追加したコメントが含まれます
それはそれらを持っています。

ジョブ経由:
エクスポートされたデータには、 、 各ジョブ結果の横にある属性。 経由
属性には、特定のジョブを生成したジョブ定義のチェックサムが含まれます。
ジョブの定義。 これは、プラグインを使用したジョブによって生成されたジョブを追跡するのに役立ちます。
type ローカル.

ジョブハッシュ付き:
エクスポートされたデータには、 ハッシュ 各ジョブ結果の横にある属性。 ハッシュ
属性は、ジョブ定義のデータのチェックサムです。 併用すると便利かもしれません
　 ジョブ経由.

マシン-json:
生成される JSON ドキュメントは最小限になります (オプションの空白は含まれません)。
このオプションは、結果を人間が読み取ることを意図していない場合に使用するのが最適です。
スペースを節約できるからです。

rfc822
すべてのオプションは、 JSON 輸出者: with-io-log,
スカッシュ-io-ログ, flatten-io-ログ, ランリスト付き, ジョブリスト付き, リソースマップ付き,
ジョブ定義あり, アタッチメント付き, コメント付き, ジョブ経由, ジョブハッシュ付き。 唯一の
例外は マシン-json このエクスポーターには存在しないオプションです。

클라우드 기반 AI/ML및 고성능 컴퓨팅을 통한 디지털 트윈의 기초 – Edward Hsu, Rescale CPO 많은 엔지니어링 중심 기업에게 클라우드는 R&D디지털 전환의 첫 단계일 뿐입니다. 클라우드 자원을 활용해 엔지니어링 팀의 제약을 해결하는 단계를 넘어, 시뮬레이션 운영을 통합하고 최적화하며, 궁극적으로는 모델 기반의 협업과 의사 결정을 지원하여 신제품을 결정할 때 데이터 기반 엔지니어링을 적용하고자 합니다. Rescale은 이러한 혁신을 돕기 위해 컴퓨팅 추천 엔진, 통합 데이터 패브릭, 메타데이터 관리 등을 개발하고 있습니다. 이번 자리를 빌려 비즈니스 경쟁력 제고를 위한 디지털 트윈 및 디지털 스레드 전략 개발 방법에 대한 인사이트를 나누고자 합니다.
rfc822と同じです。

XLSX
システム情報付き:
エクスポートされたスプレッドシートには、ハードウェア デバイス ベースの詳細を示すワークシートが含まれます。
lspci、lsusb、udevなどで。

概要付き:
エクスポートされたスプレッドシートにはテスト数値が含まれます。 これには、次の割合が含まれます。
成功したテスト、失敗したテスト、スキップされたテスト、およびその合計数。

ジョブ説明付き:
エクスポートされたスプレッドシートには、別のシートに職務説明が含まれます

テキスト添付ファイル付き:
エクスポートされたスプレッドシートには、別のシートにテキスト添付ファイルが含まれます

XML
クライアント名:
このオプションを使用すると、クライアントは、
XML ドキュメント。 デフォルトでは、その名前は プレーンボックス。 このオプションパスを使用するには
-- 出力オプション クライアント名=他の名前 コマンドラインオプション。

輸送 結果
エクスポートされた結果は、ファイルに保存できます (これは最も基本的なデフォルトのトランスポートです)。
または、さらなる処理のためにいずれかの搬送システムに渡すこともできます。 その考えは、
専門的なユーザーは、独自のトランスポート システム (多くの場合、特定のシステムと組み合わせて) を提供できます。
エクスポーター) テスト結果をテスト対象システムから中央テスト結果に移動します。
リポジトリ。

トランスポートは、 - 輸送 オプション。 繰り返しますが、輸出業者と同様に、
既知のトランスポートは、 - 輸送 ? オプション。 トランスポートには
で指定できるリンク先 URL --transport-where= オプション。 の構文
URL はトランスポートの種類によって異なります。

Plainbox には次のトランスポートが装備されています。

発射台
このトランスポートは、次を使用してエクスポートされた結果を送信できます。 XML Launchpad ハードウェアへのエクスポーター
データベース。 これは、によって提供されるあまり知られていない機能です。 https://launchpad.net/ ウェブサイトをご覧ください。

プロフェッショナル認定
このトランスポートは、 XML Canonical へのエクスポーター
認定ウェブサイト (https://certification.canonical.com).

このトランスポートは、Canonical Hardware Certification Team 以外にはほとんど役に立ちません。
これは Plainbox と Checkbox も維持しますが、完全を期すためにここで説明します。

OPTIONS

オプション 引数：

-非対話型
インタラクティブ性を必要とするテストをスキップする

-n, -ドライラン
ほとんどのジョブを実際には実行しない

--dont-suppress-output
特定のジョブ プラグイン タイプの出力を抑制しない

-f, - 出力フォーマット
テスト結果を指定された形式で保存します (選択肢のリストには ? を渡します)

-p, -- 出力オプション
エクスポートメカニズムのオプションのカンマ区切りのリスト (リストの場合は ? を渡します)
選択肢）

-o, -出力ファイル
テスト結果を指定したファイルに保存します (ファイルが - の場合は標準出力に保存します)。

-t, - 輸送
TRANSPORT を使用して結果をどこかに送信します (選択肢のリストには ? を渡します)

考えられる選択肢: ?

--輸送場所
選択したトランスポートを使用してデータを送信する場所

--トランスポートオプション
トランスポートに渡されるキーと値のオプション (k=v) のカンマ区切りのリスト

-T, --テスト計画
指定されたテスト計画をロードします

-i, --インクルードパターン
指定された正規表現に一致するジョブを含めます

-x, -除外パターン
指定された正規表現に一致するジョブを除外します

-w, -ホワイトリスト
実行パターンを含むホワイトリストをロードする

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