アプリケーションソースの管理¶

アプリケーションソースには、アプリケーションを構築できるファイル、依存関係、および環境が含まれます。 In Registry, select the Application sources tile to view all the sources that you can build applications from.

アプリケーションソースの追加¶

To add a new application source, go to Registry > Application sources and click + Add new application source or select an option from the dropdown.

The new application source is immediately added to Registry.

アプリケーションソースの設定¶

After creating or selecting an application source, you can choose its base environment, upload files to the source, and create runtime parameters.

アプリケーションソースのこれらのコンポーネントのいずれかを編集する場合、ソースの新しいバージョンを作成します。 バージョンドロップダウンから、ソースの任意のバージョンを選択できます。

アプリケーションのバージョンに加えられた変更の履歴を表示するには、左側の列のリストからアプリケーションのバージョンを選択します。 Then, expand the right-hand column next to the history icon to view the history of changes made.

環境¶

アプリケーションは環境（Dockerコンテナ）内で実行されます。 環境には、アプリケーションで使用されるパッケージ、言語、およびシステムライブラリが含まれます。 環境ヘッダーの下にあるドロップダウンから、DataRobotが提供するアプリケーションソースの環境を選択します。 DataRobotは[Experimental] Python 3.9 Streamlitという定義済みの基本環境を提供しています。

ファイル¶

In the Files section, you can assemble the files that make up the application source. ボックスにファイルをドラッグするか、このセクションのオプションを使用して、カスタムジョブの構築に必要なファイルを作成またはアップロードします。

空白のテキストファイル作成を選択する場合、ファイルに情報を入力し、完全なパス（そのファイルに属するフォルダおよびファイル拡張子を含む）を使用して名前を付け、保存をクリックします。

アプリスクリプトの構築¶

アプリケーションソースにrequirements.txtファイルを提供すると、アプリ構築時にPythonの依存関係がインストールされます。 ただし、Python以外の依存関係をインストールすることもできます。 これらの依存関係をインストールするために、アプリケーションソースにbuild-app.shスクリプトを含めることができます。このスクリプトは、初めてアプリケーションを構築するときにDataRobotによって呼び出されます。 build-app.shスクリプトはnpm installまたはyarn buildを実行できるため、アプリケーションはJavaScriptベースのアプリケーションでの依存関係のインストールに対応できます。 このスクリプトでアプリケーションを構築する際、構築プロセス中にエラーが発生した場合は失敗するように、スクリプトにset -eを含める必要があります。

以下の例は、カスタムノードアプリケーション用のサンプルbuild-app.shスクリプトの概要を示しています。

#!/usr/bin/env sh

# add set -e so if the npm install fails, the build will be marked as failed
set -e

cd client

echo "Installing React dependencies from package.json..."
npm install

echo "Building React app..."
yarn run build && rm ./build/index.html 

リソース¶

アプリケーションソースを作成した後、アプリケーションが消費するリソースを設定して、本番環境での潜在的な環境エラーを最小限に抑えることができます。 DataRobotでは、リソース制限とレプリカ数をカスタマイズできます。 リソースバンドルを編集するには：

1. アプリケーションソースを選択します。 In the Resources section, click Edit .

2. リソースを更新ダイアログボックスで、次の設定を行います。

   

   設定	説明
   バンドル	ドロップダウンからリソースバンドルを選択し、アプリケーションに割り当てることができるメモリーとCPUの最大量を決定します。
   レプリカ	アプリケーションの実行時にワークロードのバランスを取るために、並行して実行するレプリカの数を設定します。 デフォルト値は 1 で、最大値は4です。
   セッションアフィニティを有効にする	同じレプリカにリクエストを送信します。 たとえば、チャット履歴をドキュメントに保存し、それを参照できるアプリのような、ローカルファイルシステムやメモリーにデータを保存するステートフルなアプリでは、これを有効にする必要があります。 複数のレプリカが使用可能な場合、file_uploaderなどの一部のStreamlitコンポーネントは、この設定を有効にしないとエラーをスローします。
   ルートパスでアプリを内部実行	アプリを/apps/{ID}の代わりに/で実行できるようにします。 アプリが（GunicornやStreamlitを使用するなどして）自動的にパス設定を処理する場合、この設定は必要ありません。 すべてのルートを/apps/{ID}/で動作させるソリューションがないWebフレームワーク（R-Shinyなど）には便利です。

3. アプリケーションソースのリソース設定が完了したら、保存をクリックします。

ランタイムパラメーター¶

ランタイムパラメーターを作成および定義して、実行時にアプリケーションで使用されるスクリプトとタスクに異なる値を指定することができます。

metadata.yamlファイルに含めることで、アプリケーションにランタイムパラメーターを追加し、アプリケーションを再利用しやすくすることができます。 このファイルのテンプレートは、ファイル > 作成ドロップダウンから使用できます。

Codespaceでのアプリケーションソースの変更¶

Codespaceでアプリケーションソースを開いて管理し、ソースのファイルを直接編集したり、新しいファイルをアップロードしたりできます。

To open an application source in a codespace, navigate to the source on Registry > Application sources page. ソースを選択してその内容を表示し、Codespaceで開くをクリックします。

アプリケーションソースがcodespaceで開き、既存のファイルを直接編集したり、新しいファイルをアップロードしたり、 codespaceの機能を使用したりできます。

Codespaceでアプリケーションソースの変更作業が終了したら、保存をクリックします。 アプリケーションソースバージョンは、変更で更新されます。 変更するアプリケーションソースのバージョンを以前にデプロイしている場合、保存すると新しいソースバージョンが作成されます。 それ以外の場合、同じソースバージョンを維持したまま保存します。 保存したくない場合は、キャンセルをクリックします。 それ以外の場合は、続行をクリックします。

Codespaceを保存すると、アプリケーションのソースページに戻り、新しいソースバージョンがバージョンドロップダウンに表示されます。

アプリケーションソースの置換¶

アプリケーションを使用した後、そのソースを置き換えることができます。 アプリケーションソースを置換すると、元のアプリケーションから以下のものが引き継がれます。

• アプリケーションコード
• 基盤となる実行環境
• レプリカの数
• ランタイムパラメーターとシークレットのコピー
• コンテナのサイズ（small、medium、large）

To replace an application source, find the application on the Applications page, open the Actions menu , and click Replace source.

モーダルで、ドロップダウンからアプリケーションソースを選択して、アプリケーションが現在使用しているものを置き換えます。 各ソースはそのソースバージョンを示します。 検索バーを使用して、アプリケーションソースを指定できます。 置換ソースを選択後、確認をクリックします。

ソースが置換される際、アプリケーションにアクセスできるすべてのユーザーは、置換中に開くボタンが無効になっていても、引き続きアプリケーションを使用できます。