カスタムアプリケーションの管理¶

レジストリのアプリケーションページには、すべてのアプリケーションタブから使用できるすべてのカスタムアプリケーションが一覧表示されます。 次の表は、このページの要素と使用可能なアクションを示します。

アプリケーションの共有¶

共有機能は権限を管理し、ユーザー、グループ、組織、およびDataRobot以外の受信者とアプリケーションを共有できます。 この機能は、アプリケーションを作成するための専門知識のないユーザーに既存のアプリケーションの使用を許可する場合などに便利です。

アプリワークショップのアクションメニューから共有機能にアクセスできます。 共有するアプリケーションの横にあるアクションメニュー をクリックして共有 を選択します。

これにより共有ウィンドウが開き、ユーザーとその役割がリストされます。 エディターは、1つ以上のユーザーまたはグループ、組織全体でアプリケーションを共有できます。 さらに、共有リンクを使ってアプリケーションを外部と共有できます。

ユーザーグループと組織外部共有

1. 新しいユーザーを追加するには、次と共有：フィールドにそのユーザー名を入力します。

   

2. ドロップダウンからロールを選択します。

   

3. 通知を送信を選択してEメール通知を送信し、メモを追加を選択して通知に詳細を追加します。

   

4. 共有をクリックします。

1. 共有ウィンドウでグループまたは組織タブを選択します。

   

2. 次と共有フィールドにグループ名または組織名を入力します。

3. 権限のロールを決めます。
4. 共有をクリックします。 アプリが共有され、役割は指定されたグループまたは組織のすべてのメンバーに適用されます。

DataRobot以外のユーザーとカスタムアプリケーションを共有するには、外部共有を有効にするをオンに切り替えます。 トグルの下に表示されるリンクを使用すると、DataRobotにアクセスできないエンドユーザーとカスタムを共有できます。 そのリンクをエンドユーザーと共有する前に、アプリケーションへのアクセスを許可するEメールドメインとアドレスを指定する必要があります。 招待メールは、ユーザーに送信されてから1時間後に有効期限が切れます。 ユーザーが認証を承認後、作成された認証トークンは14日後に有効期限が切れます。 このリストを変更することで、共有リンクへのアクセスを取り消すことができます。 アプリケーションにアクセスしなくなったドメインまたはアドレスを削除します。

Self-managed external sharing

For self-managed users externally sharing an application, note that you need to configure a Simple Mail Transfer Protocol (SMTP) server in order to share the application with external users.

DRApps CLIを使用して、カスタムアプリケーションをプログラムで共有することもできます。

共有ダイアログでは、次のアクションも使用できます。

• ユーザーを削除するには、削除するユーザーの役割の右側にある「X」ボタンをクリックします。

• ユーザーの役割を再度割り当てるには、割り当てられた役割をクリックして、ドロップダウンから新しい役割を割り当てます。

  

ユースケースへのリンク¶

カスタムアプリケーションをワークベンチの ユースケースにリンクするには、アプリケーションのアクションメニュー で、 ユースケースへのリンクをクリックします。

ユースケースへのリンクモーダルで、次のいずれかのオプションを選択します。

ユースケースの選択ユースケースの作成リンクされたユースケースの管理 (#)

アプリケーションの削除¶

適切な権限がある場合、アクションメニュー をクリックし、削除（）をクリックすることで、アプリケーションを削除できます。

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

アプリケーションソースには、カスタムアプリケーションを構築できるファイル、依存関係、および環境が含まれます。 アプリケーションページで、アプリケーションソースタブを選択して、カスタムアプリケーションを構築できるすべてのソースを表示します。

特定のアプリケーションのアプリケーションソースを表示するには、アプリケーションのアクションメニューを選択し、ソースに移動をクリックします。

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

アプリケーションページから新しいアプリケーションソースを作成するには、追加 > 新しいアプリケーションソースをクリックします。

新しいアプリケーションソースが、直ちにページに追加されます。 新しいアプリケーションソースを選択して、設定を開始します。

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

アプリケーションソースを選択後、その基本環境を選択し、ソースにファイルをアップロードして、ランタイムパラメーターを作成できます。

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

アプリケーションのバージョンに加えられた変更の履歴を表示するには、左側の列のリストからアプリケーションのバージョンを選択します。 次に、履歴アイコン（）の横にある右側の列を展開して、変更履歴を表示します。

環境¶

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

ファイル¶

ファイルセクションでは、カスタムアプリケーションソースを構成するファイルを構築できます。 ボックスにファイルをドラッグするか、このセクションのオプションを使用して、カスタムジョブの構築に必要なファイルを作成またはアップロードします。

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

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

アプリケーションソースにrequirements.txtファイルを提供すると、アプリ構築時にPythonの依存関係がインストールされます。 ただし、Python以外の依存関係をインストールすることもできます。 これらの依存関係をインストールするために、アプリケーションソースにbuild-app.shスクリプトを含めることができます。このスクリプトは、初めてアプリケーションを構築するときにDataRobotによって呼び出されます。 build-app.shスクリプトはnpm installまたはyarn buildを実行できるため、カスタムアプリケーションはJavaScriptベースのアプリケーションでの依存関係のインストールに対応できます。

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

#!/usr/bin/env sh
cd client

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

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

リソース¶

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

1. アプリケーションソースを選択します。 リソースセクションで () 編集をクリックします。

   

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

   

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

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

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

実行時にカスタムアプリケーションで使用されるスクリプトとタスクにさまざまな値を供給するためのランタイムパラメーターを作成して定義します。

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

ランタイムパラメーターを定義するには、以下のruntimeParameterDefinitionsをmetadata.yamlに追加できます。

name: runtime-parameter-example
type: inference
targetType: regression

runtimeParameterDefinitions:
- fieldName: my_first_runtime_parameter
  type: string
  description: My first runtime parameter.

- fieldName: runtime_parameter_with_default_value
  type: string
  defaultValue: Default
  description: A string-type runtime parameter with a default value.

- fieldName: runtime_parameter_boolean
  type: boolean
  defaultValue: true
  description: A boolean-type runtime parameter with a default value of true.

- fieldName: runtime_parameter_numeric
  type: numeric
  defaultValue: 0
  minValue: -100
  maxValue: 100
  description: A boolean-type runtime parameter with a default value of 0, a minimum value of -100, and a maximum value of 100.

- fieldName: runtime_parameter_for_credentials
  type: credential
  allowEmpty: false
  description: A runtime parameter containing a dictionary of credentials. 

credentialランタイムパラメータータイプは、DataRobot REST APIで使用可能な任意のcredentialType値をサポートします。 以下の例に示すように、含まれる資格情報はcredentialTypeに依存します。

basic:
  credentialType: basic
  description: string
  name: string
  password: string
  user: string
        

azure:
  credentialType: azure
  description: string
  name: string
  azureConnectionString: string
        

gcp:
  credentialType: gcp
  description: string
  name: string
  gcpKey: string
        

s3:
  credentialType: s3
  description: string
  name: string
  awsAccessKeyId: string
  awsSecretAccessKey: string
  awsSessionToken: string
        

api_token:
  credentialType: api_token
  apiToken: string
  name: string
        

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

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

Codespaceでアプリケーションソースを開くには、アプリケーション > アプリケーションのソースページでソースに移動します。 ソースを選択してその内容を表示し、Codespaceで開くをクリックします。

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

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

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

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

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

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

アプリケーションソースを置換するには、すべてのアプリケーションタブでアプリケーションを検索して、アクションメニューを開き、ソースの置換を選択します。

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

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

アプリケーションログ¶

DataRobotでは、カスタムアプリケーションのために2種類のログを記録します。ビルドおよびランタイムログとアクセスログです。 これらのログを通じて、アプリケーションのビルドおよびランタイムタスクを監視し、アプリケーションのユーザーアクセス履歴を確認できます。

ビルドログとランタイムログ¶

カスタムアプリケーションのビルドおよびランタイムタスクの履歴を詳細に記録したログを閲覧できます。 アプリケーションページから、ログを表示したいアプリのアクションメニュー を開き、ログを表示をクリックします。

ログモーダルには、カスタムアプリケーションのコンパイル、構築、および実行の履歴の詳細が表示されます。 これには、依存関係のチェック、パッケージ化、および発生した警告やエラーが含まれます。

アクセスログ¶

アクセスログを閲覧して、カスタムアプリケーションを開いたり操作したりしたユーザーの履歴を監視します。 アクセスログを表示するには、アプリケーションページに移動して、ログを表示したいアプリのアクションメニュー を開き、アクセスログを表示をクリックします。

また、アプリケーションソースから直接アクセスログを表示することもできます。 アプリケーションのソースページに移動して、カスタムアプリケーションのアプリケーションソースを見つけ、ドロップダウンを展開して、ソースから構築されたアプリケーションを表示します。 次に、アクセスログを表示したいカスタムアプリケーションをクリックすると、詳細表示にアクセスできます。

カスタムアプリケーションの詳細表示から、アクセスログセクションまでスクロールダウンします。

アクセスログには、電子メール、ユーザーID、アクセス日時、アプリケーションに対するユーザーのロールなど、ユーザーによるアプリケーションへのアクセスの詳細が記録されます。