アプリケーションソースの管理¶
アプリケーションソースには、アプリケーションを構築できるファイル、依存関係、および環境が含まれます。 レジストリで、アプリケーションのソースタイルを選択して、アプリケーションを構築できるすべてのソースを表示します。
アプリケーションソースの追加¶
新しいアプリケーションソースを追加するには、レジストリ > アプリケーションのソースに移動し、+ 新しいアプリケーションソースを追加をクリックするか、ドロップダウンからオプションを選択します。
新しいアプリケーションソースが、直ちにレジストリに追加されます。
アプリケーションソースの設定¶
アプリケーションソースを作成または選択後、その基本環境を選択し、ソースにファイルをアップロードして、ランタイムパラメーターを作成できます。
アプリケーションソースのこれらのコンポーネントのいずれかを編集する場合、ソースの新しいバージョンを作成します。 バージョンドロップダウンから、ソースの任意のバージョンを選択できます。
アプリケーションのバージョンに加えられた変更の履歴を表示するには、左側の列のリストからアプリケーションのバージョンを選択します。 次に、履歴アイコン の横にある右側の列を展開して、変更履歴を表示します。
環境¶
アプリケーションは環境（Dockerコンテナ）内で実行されます。 環境には、アプリケーションで使用されるパッケージ、言語、およびシステムライブラリが含まれます。 環境ヘッダーの下にあるドロップダウンから、DataRobotが提供するアプリケーションソースの環境を選択します。 DataRobotは[Experimental] Python 3.9 Streamlitという定義済みの基本環境を提供しています。
ファイル¶
ファイルセクションでは、アプリケーションソースを構成するファイルをまとめることができます。 ボックスにファイルをドラッグするか、このセクションのオプションを使用して、カスタムジョブの構築に必要なファイルを作成またはアップロードします。
| オプション | 説明 |
|---|---|
| ソース／アップロードから選択 | 既存のカスタムジョブファイル（run.sh、metadata.yaml、など）をローカルファイルまたはローカルフォルダーとしてアップロードします。 |
| 作成 | 空のファイルまたはテンプレートを含んだファイルとして新しいファイルを作成し、カスタムジョブに保存します。
|
空白のテキストファイル作成を選択する場合、ファイルに情報を入力し、完全なパス（そのファイルに属するフォルダおよびファイル拡張子を含む）を使用して名前を付け、保存をクリックします。
アプリスクリプトの構築¶
アプリケーションソースに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の担当者または管理者にお問い合わせください。
機能フラグ：リソースのバンドルを有効にする
アプリケーションソースを作成した後、アプリケーションが消費するリソースを設定して、本番環境での潜在的な環境エラーを最小限に抑えることができます。 DataRobotでは、リソース制限とレプリカ数をカスタマイズできます。 リソースバンドルを編集するには：
- アプリケーションソースを選択します。 リソースセクションで、編集 をクリックします。
-
リソースを更新ダイアログボックスで、次の設定を行います。
設定 説明 バンドル ドロップダウンからリソースバンドルを選択し、アプリケーションに割り当てることができるメモリーとCPUの最大量を決定します。 レプリカ アプリケーションの実行時にワークロードのバランスを取るために、並行して実行するレプリカの数を設定します。 デフォルト値は 1 で、最大値は4です。 セッションアフィニティを有効にする 同じレプリカにリクエストを送信します。 たとえば、チャット履歴をドキュメントに保存し、それを参照できるアプリのような、ローカルファイルシステムやメモリーにデータを保存するステートフルなアプリでは、これを有効にする必要があります。 複数のレプリカが使用可能な場合、file_uploaderなどの一部のStreamlitコンポーネントは、この設定を有効にしないとエラーをスローします。 ルートパスでアプリを内部実行 アプリを /apps/{ID}の代わりに/で実行できるようにします。 アプリが（GunicornやStreamlitを使用するなどして）自動的にパス設定を処理する場合、この設定は必要ありません。 すべてのルートを/apps/{ID}/で動作させるソリューションがないWebフレームワーク（R-Shinyなど）には便利です。 -
アプリケーションソースのリソース設定が完了したら、保存をクリックします。
ランタイムパラメーター¶
In the Runtime parameters section, create runtime parameters to supply different values to application code at runtime, making your application easier to reuse. If you defined any runtime parameters in a metadata.yaml file, you can manage them here as well. Runtime parameters are injected into containers as environment variables (accessible through os.getenv). Parameters created via the UI persist and merge when you upload new code versions, ensuring a seamless development flow.
Runtime parameter considerations
The system uses a blocklist of reserved patterns (e.g., DRUM_*, MLOPS_*, KUBERNETES_*), managed in the dynamic configuration. Matching supports the * wildcard (not full regular expression syntax). Reserved names aren't blocked entirely: if a runtime parameter uses a reserved name, the UI displays a warning. How the variable is exposed depends on the context:
- Custom models: Only in prefixed (
MLOPS_RUNTIME_PARAM_*) and JSONified format—not as a raw (unprefixed) environment variable, to prevent system conflicts. - Custom apps: Prefixed, but values are not packed into a JSON payload (except for credentials).
- Custom jobs: No prefix and no JSON payload (except for credential types); the variable is available as a raw environment variable.
For credential-type runtime parameters, the system automatically unpacks JSON fields into separate environment variables rather than a single string. For example, a credential named MAIN_AWS_CREDENTIAL with the following JSON structure:
{"awsAccessKeyId": "<your-key-id>", "awsSecretAccessKey": "<your-access-key>"}
is unpacked into the following environment variables, combining the parameter name + JSON key, in uppercase:
MAIN_AWS_CREDENTIAL_AWS_ACCESS_KEY_ID="<your-key-id>"
MAIN_AWS_CREDENTIAL_AWS_SECRET_ACCESS_KEY="<your-access-key>"
For single-field credential types (for example, api_token, bearer, or gcp), the injected environment variable uses the bare runtime parameter name (MY_CRED), not the parameter name plus the credential field name (for example, not MY_CRED_API_TOKEN). Multi-field JSON-encoded runtime parameter variables (for example, MLOPS_RUNTIME_PARAMETERS_OPEN_AI_API) are unchanged; only the flat variable for a single-field secret uses the bare parameter name.
Click + Add runtime parameter to define a new runtime parameter by providing a Name, Type, Value, and, optionally, a Description.
Alternatively define runtime parameters in a metadata.yaml file. A template for this file is available from the Files > Create dropdown.
For existing runtime parameters, click Edit to edit parameter values, remove parameters, or reset parameter values.
Access runtime parameters in containers
For programmatic access to runtime parameters in containers, use DataRobotAppFrameworkBaseSettings as documented in the SDK API reference.
Codespaceでのアプリケーションソースの変更¶
Codespaceでアプリケーションソースを開いて管理し、ソースのファイルを直接編集したり、新しいファイルをアップロードしたりできます。
Codespaceでアプリケーションソースを開くには、レジストリ > アプリケーションのソースページでソースに移動します。 ソースを選択してその内容を表示し、Codespaceで開くをクリックします。
アプリケーションソースがcodespaceで開き、既存のファイルを直接編集したり、新しいファイルをアップロードしたり、 codespaceの機能を使用したりできます。
Codespaceでアプリケーションソースの変更作業が終了したら、保存をクリックします。 アプリケーションソースバージョンは、変更で更新されます。 変更するアプリケーションソースのバージョンを以前にデプロイしている場合、保存すると新しいソースバージョンが作成されます。 それ以外の場合、同じソースバージョンを維持したまま保存します。 保存したくない場合は、キャンセルをクリックします。 それ以外の場合は、続行をクリックします。
Codespaceを保存すると、アプリケーションのソースページに戻り、新しいソースバージョンがバージョンドロップダウンに表示されます。
アプリケーションソースの置換¶
アプリケーションを使用した後、そのソースを置き換えることができます。 アプリケーションソースを置換すると、元のアプリケーションから以下のものが引き継がれます。
- アプリケーションコード
- 基盤となる実行環境
- レプリカの数
- ランタイムパラメーターとシークレットのコピー
- コンテナのサイズ（small、medium、large）
アプリケーションソースを置き換えるには、アプリケーションページでアプリケーションを見つけ、アクションメニュー を開き、ソースの置換をクリックします。
モーダルで、ドロップダウンからアプリケーションソースを選択して、アプリケーションが現在使用しているものを置き換えます。 各ソースはそのソースバージョンを示します。 検索バーを使用して、アプリケーションソースを指定できます。 置換ソースを選択後、確認をクリックします。
ソースが置換される際、アプリケーションにアクセスできるすべてのユーザーは、置換中に開くボタンが無効になっていても、引き続きアプリケーションを使用できます。