エージェントテンプレートの更新¶
エージェントのワークフローやフレームワークが積極的に開発され、改良されています。 これらのテンプレートで使用されているフレームワーク、ライブラリ、ツールの最新バージョンをサポートするため、ベースイメージを定期的に更新しています。 フレームワークは、あなたのエージェントを強化するために、変更を加えたり、機能を廃止したり、新しい機能を追加したりすることがあります。 最新の機能を利用し、DataRobotの最新バージョンとの互換性を確保するために、エージェントのテンプレートを定期的に更新し、最新の変更を含める必要があります。 新しいエージェントワークフローを積極的に開発するには、使用されているテンプレートを定期的に更新するだけです。
構築済みエージェントのDockerイメージ
構築済みのエージェントDockerイメージは定期的に更新され、最新のバグフィックスと改善が含まれています。 これらのベースイメージとの互換性を確保するために、エージェンティックのテンプレートを最新のコードに更新することを強くお勧めします。 古いテンプレートは予期せぬ動作やエラーを引き起こす可能性があります。
デプロイ済みエージェント
デプロイされたエージェントとエージェントワークフローは、常に固定のDockerベースイメージを使用します。 ローカルのテンプレートを更新しても、これらが自動的に更新されることはありません。 エージェントを最新のベースイメージにアップグレードするには、エージェントを再構築して再デプロイする必要があります。 これらのデプロイを更新したくない場合は、そのままにしておくこともできます。
アップデートの手順¶
-
datarobot-agent-applicationリポジトリのローカルコピーに移動します。
-
更新したいブランチ(例:
main)にいることを確認します。 -
リモートリポジトリから最新の変更内容をプルします。
git pull origin main # If you are using a different release, replace 'main' with your release branch name # e.g., git pull origin release/11.3 for on-premise users -
テンプレートに加えられた変更と更新を確認します。
git logとgit diffを使って変更内容を確認できます。 -
テンプレートに独自のカスタマイズを加えた場合、これらの変更を最新の更新内容に手動でマージする必要が生じる可能性があります。
-
以下のコマンドを実行して、ローカルの依存関係を更新し、開発環境をリフレッシュします。
task install -
更新したテンプレートをテストして、最新バージョンのDataRobotで期待どおりに動作するか確認します。 別のブランチで作業している場合は、自分のブランチを最新の
mainブランチにリベースする必要があるかもしれません。git checkout your-branch git fetch origin git rebase origin/main # If you are using a different release, replace 'origin/main' with your release branch name # e.g., git rebase origin/release/11.3 for on-premise users
トラブルシューティング¶
テンプレートはユーザー向けのファイル(たとえばcustom.py、agent.py、Dockerfileなど)への変更を最小限にするように開発されています。 ほとんどのアップデートは、基礎となるフレームワークのコード、イメージの依存関係、ヘルパークラスで行われます。 これらのファイルを変更した場合は、手動で変更をマージする必要があります。
-
アップデートの過程でマージの競合が発生した場合は、競合するファイルを確認し、どの変更を残すかを決定することで、慎重に競合を解決してください。
-
特定の依存関係や設定を無期限に維持する必要がある場合は、いつでもカスタムビルドイメージを使用できます。 デフォルトでは
docker_contextディレクトリは含まれていません。 カスタムDockerイメージが必要な場合は、まずtask agent:create-docker-contextを使ってDockerコンテキストを作成してから、task agent:build-docker-contextを使って構築します。 Dockerコンテキストの使用の詳細については、Pythonパッケージの追加に関するドキュメントを参照してください。 -
テンプレートを更新したら、必ず
task installを実行してローカルの開発環境をリフレッシュしてください。 -
アップデート後に問題が発生した場合は、DataRobotコミュニティやサポートにご相談ください。