サードパーティ製アプリケーションの構築

サードパーティ製アプリケーションの構築を開始する前に、JET SDK for Junos OS EvolvedとJET Toolkit for Junos OS Evolvedをダウンロードしてインストールします。これらのファイルは、 Juniper Extension Toolkit(Junos Evolved用) のページにあります。

• Junos OS Evolved向けJET SDK: jet-junos-evo-sdk--releaseEVO.deb

• Junos OS Evolved用JETツールキット: jet-junos-evo-toolkit--releaseEVO.tar.gz

メイクファイルは、サードパーティアプリケーションの構築とインストールに必要なファイルです。メイクファイルには、SRC ファイル、構成ファイル .yaml 、ファイルなどの他のファイルのパスを含める必要があります。また、必要なファイルのインストール場所も制御します。

SRCファイルには、アプリケーションのソースコードが含まれています。SRCファイルは、C、C ++、またはPythonで記述できます。これらのファイルは、サードパーティアプリケーションの機能に必要です。

スクリプト ファイルには、インストール前、インストール後、およびアンインストール前のスクリプトが含まれます。これらのオプション・ファイルは、アプリケーションのニーズに合わせてカスタマイズできるシェル・スクリプトです。

• インストール前のスクリプトは、サードパーティパッケージをインストールする前に実行されます。これらのスクリプトは通常、デバイスのさまざまな要因をテストおよびチェックするために使用されます。例えば、インストール前のスクリプトを作成して、インストールを開始する前に、実行中のJunos OS Evolvedのバージョンを確認することができます。

• インストール後のスクリプトは、サードパーティパッケージのインストール後に実行されます。これらのスクリプトには、インストールの完了後に実行するコマンドが含まれています。たとえば、追加のログ ファイルやパッケージのログ ディレクトリを作成します。

• アンインストール前スクリプトは、サードパーティパッケージをアンインストールする前に実行されます。これらのスクリプトは通常、サードパーティパッケージのインストール中に作成されたフォルダーとファイルをクリーンアップするために使用されます。

メモ：

すべてのスクリプトは、正常に実行されると 0 を返し、失敗すると 0 以外を返す必要があります。

スクリプトは任意のフォルダに作成できます。ツールを使用した Jet-evo サードパーティのパッケージ作成プロセス中に、各タイプのスクリプトへのパスを入力すると、デバイスの/ data/var/external/current-evo-version/ フォルダーにインストールされます。このツールの詳細については Jet-evo 、「 Jet-evo ツールの構成」を参照してください。

メモ：

カスタム スクリプトを作成する場合は、追加の CLI 出力を作成するコマンドは使用 bash しないことをお勧めします。CLI出力を独自のログファイルにリダイレクトできます。

サービスファイルは、管理対象アプリケーションに必須のファイル systemd です。これらのファイルは、アプリケーション ポリシーを制御し、アプリケーションが実行されるノードとルーティング エンジンを決定します。

サービスファイルは、パッケージのディレクトリの etc/ systemd/system/ フォルダ root-fs 内に配置する必要があります。

次の例は、 .service という名前の Sample Appアプリケーションのファイルです。この .service ファイルは、アプリケーションを起動するパスと、アプリケーションの実行に必要なシステム状態を定義します。

次のフィールドは必須であり、サンプル ファイルと同じ構文で使用する必要があります。

• 後

• 以前は

• 失敗時

• 作業ディレクトリ

• エグゼクティブスタート

• エグゼストップポスト

.yamlファイルは、管理対象アプリケーションに必須のファイルSysManです。これらのファイルは、インストール時にベース・サービス・ユニットおよびSysManベース・ポリシーの作成systemdに使用されるアプリケーション固有のポリシーを渡すために使用されます。ファイルは、アプリケーションが稼働するノードやルーティング・エンジンを決定するためにも使用されます。 .yaml

メモ：

同じアプリケーションの と の両方のファイルをパッケージに含める.yaml.serviceと、ファイル属性が優先され、.serviceアプリケーションは管理対象アプリケーションとしてsysman扱われます。

サードパーティのパッケージには、パッケージに複数のサービスをアタッチできます。によってSysMan制御される各アプリケーションは、アタッチされたサービスごとに個別の.yamlファイルを持ち、サービス名をファイル名として.yaml持つ必要があります。サードパーティのパッケージ名は、パッケージに含まれているサービスとは異なる可能性があるため、ファイル名はパッケージ名ではなくサービス名と一致させる必要があります。 .yaml

パッケージのディレクトリ内のroot-fsフォルダー内にusr/confファイルを配置.yamlする必要があります。

ファイルは .yaml 、対応するアプリケーションに関する情報を含む複数のフィールドで構成されています。ファイル・フィールドの定義については、 .yaml 以下のリストを参照してください。

binpath	バイナリ実行可能ファイルへのパスを定義します。
exec-start	アプリケーションの起動に必要なパスや引数など、アプリケーションの起動方法を定義します。この項目は、 ExecStart サービス単位の systemd 項目に対応します。
working-dir	バイナリを含む親ディレクトリへのパスを定義します。
id	アプリケーションの名前を制御します。ファイル名と一致する .yaml 必要があります。
network	ネットワーク タイプを または の値internalexternalで設定します。デバイスの外部と通信するアプリケーションでは、このexternal値を使用する必要があります。
on-exit	終了時にアプリケーションを再起動するための設定を制御します。 restart: 終了時にアプリケーションを再起動するかどうかを または false 値でtrue制御します。
resource	アプリケーションが使用するシステムリソースの制限を設定します。 max-memory: アプリケーションの各インスタンスで消費できるメモリの最大量を制御します。 node-attribute: アプリケーションを実行するノードの種類を、 や などの値-refpcで制御します。 node-type: 実行するアクションのノードの種類を、 や などの値-refpcで制御します。 startup: ユーザー定義の Junos OS Evolved 構成に または false の値がある場合trueに、インストール後にアプリケーションを起動するかどうかを制御します。 instances: アプリケーションが実行されるノードと、実行できるインスタンスの最大数を制御します。 all_nodes: または false 値を持つtrueすべてのノードでアプリケーションを実行するかどうかを制御します。 max_num_of_instances: アプリケーションが実行できるインスタンスの最大数を数値で制御します。

次のサンプル ファイルは、1 つのインスタンスのみを持つプライマリ ルーティング エンジンで実行されるサンプル .yaml アプリケーションの構成を示しています。フィールドfalseを all_nodes に設定すると、アプリケーションがすべてのルーティングエンジンで実行されなくなります。max_number_of_instancesアプリケーションを 1 インスタンスに制限するように1フィールドを設定します。node-attributeフィールド-reを に設定すると、アプリケーションがルーティング エンジンで実行されます。この設定では、プライマリ ルーティング エンジンがダウンした場合、バックアップ ルーティング エンジンでアプリケーションが自動的に起動します。

このツールは Jet-evo 、サードパーティパッケージの名前付け、バージョン番号の設定、インストールスクリプトの実行、およびサードパーティパッケージのインストール場所の設定に使用されます。これらの変数はすべて、コマンドの実行時に jet-evo 設定されるオプションによって制御されます。

メモ：

ツールで使用するJet-evo秘密キーの生成については、署名キーの生成を参照してください。

• 必須の引数
• 省略可能な引数
• 構文例