ライフサイクル管理
このガイドでは、Oracle AI Database Private Agent Factoryプロジェクトの管理に使用できるMakefileターゲットについて説明します。Makefileは、一般的なコマンドの便利なショートカットを提供し、アプリケーションの構築やデプロイからアンインストールまでのライフサイクル全体を簡素化します。
構成変数
これらの変数は、Makefileターゲットの動作を制御します。これらのデフォルト値は、コマンドラインから直接上書きできます。
| 変数 | デフォルト値 | 説明 |
|---|---|---|
PROJECT_NAME |
applied-ai-studio |
Podmanコンテナおよびイメージの命名に使用される接頭辞。 |
COMPOSE_FILE_PROD |
podman-compose-prod.yaml |
本番デプロイメント用のソース構成ファイル。 |
COMPOSE_FILE_QUICKSTART |
podman-compose-quickstart.yaml |
クイックスタートまたは開発デプロイメント用のソース構成ファイル。 |
COMPOSE_FILE_ACTIVE |
podman-compose.yaml |
ほとんどのターゲットで使用されるアクティブな構成ファイル。通常は、deploy.shスクリプトによって作成および管理されます。 |
AAI_CONTAINER_NAME |
oracle-applied-ai-label |
logsaaiおよびstartターゲットで使用される特定のコンテナ名。 |
上書きの例:
make PROJECT_NAME=my-project upMakefileターゲット
ターゲットは、makeで実行できるコマンドです。ターゲットを実行するには、次の構文を使用します:
make PROJECT_NAME=my-project upノート: 次に示すすべてのmakeコマンドは、アプリケーションのステージング・ディレクトリから実行する必要があります。
ターゲット別サマリー
使用可能なすべてのターゲットの簡単な概要を次に示します。
| カテゴリ | ターゲット | 説明 |
|---|---|---|
| ライフサイクル | up |
メイン・デプロイメント・スクリプト(deploy.sh)を実行して、アプリケーションを起動します。 |
| ライフサイクル | deploy |
アクティブな構成ファイル(podman-compose.yaml)を使用してアプリケーションをデプロイします。 |
| ライフサイクル | down |
すべてのアプリケーション・コンテナを停止および削除します。 |
| ライフサイクル | start |
以前に停止したコンテナを再作成せずに開始します。 |
| ライフサイクル | stop |
コンテナを削除せずに実行を停止します。 |
| ライフサイクル | restart |
コンテナを停止してから起動します。 |
| ライフサイクル | clean |
コンテナを停止し、メイン・プロジェクト・イメージを削除します。 |
| ライフサイクル | uninstall |
スクリプトを実行して、アプリケーションを完全にアンインストールします。 |
| ビルド | build |
スクリプトを介して必要なすべてのコンテナ・イメージをビルドします。 |
| ビルド | buildaai |
AAIサービス・イメージのみをビルドします。 |
| ビルド | buildollama |
Ollamaサービス・イメージのみをビルドします。 |
| ビルド | build23ai |
Oracle AI Database 26ai Freeイメージ(db23aifree)のみをビルドします。 |
| 診断 | logs |
実行中のすべてのサービスからログを監視します。 |
| 診断 | logsaai |
AAIサービス・コンテナからのログのみを監視します。 |
| 診断 | diagnose |
診断スクリプトを実行してデプロイメントの健全性をチェックします。 |
ターゲットの詳細説明
アプリケーション・ライフサイクル・ターゲット
all
デフォルトのターゲット。単にmake upを実行してアプリケーションを起動します。
make all
up
deploy.shスクリプトを実行して、アプリケーション・スタック全体を起動します。このスクリプトは、デプロイメント・モードを選択して環境を設定するためのロジックを処理します。
make up
deploy
COMPOSE_FILE_ACTIVE (podman-compose.yaml)を使用してpodman-compose upを実行する下位レベルのターゲット。通常、これは直接実行する必要はありません。かわりにmake upを使用してください。
down
アクティブな構成ファイルに定義されているすべてのコンテナ、ネットワークおよびボリュームを停止および削除します。これは、アプリケーションを停止する適切な方法です。
ノート: このターゲットはDBスキーマを削除しません。完全なクリーン・アップには、make uninstallを使用することをお薦めします。
make down
start
以前に作成されたが、現在停止しているコンテナを起動します(たとえば、make stopの使用後)。また、crondサービスがAAIコンテナ内で実行されていることを確認するコマンドも実行します。
make start
stop
実行中のコンテナを削除せずにすべて停止します。データおよびコンテナの状態は保持されます。make startを使用して再開します。
make stop
restart
make stopの後にmake startを実行する便利なショートカット。
make restart
clean
部分的なクリーン・アップを実行します。最初にmake downを実行してコンテナを停止して削除し、次にメイン・プロジェクト・コンテナ・イメージ(applied-ai-studioなど)の削除を試みます。
ノート: このターゲットでは、Ollamaやデータベースなどの他のイメージは削除されません。完全クリーン・アップの場合は、make uninstallを使用します。
make clean
uninstall
uninstall.shスクリプトを実行して、アプリケーションの完全な削除を実行します。これは、環境をクリーン・アップするための最も徹底的な方法です。
警告: これは、すべてのコンテナ、イメージを削除し、データベース・スキーマをクリアする破壊的な操作です。DBスキーマをクリーン・アップするには、Yを入力してください。
make uninstall
イメージ・ビルド・ターゲット
build
build-image.shスクリプトを実行して、必要なすべてのサービス・イメージをビルドします。これにより、AAI、Ollamaおよびデータベース・イメージがビルドされます。
make build
buildaai / buildollama / build26ai
適切なパラメータ(aai、ollama、db26aifreeなど)を使用してbuild-image.shスクリプトをコールすることで、指定されたサービス・イメージを個別にビルドします。
make buildaai
診断およびロギング・ターゲット
diagnose
diagnose.shスクリプトを実行して、デプロイメントの一般的な問題のトラブルシューティングに役立てます。これにより、さらに分析するためのログおよび構成詳細を含むチップが作成されます。
make diagnose
logs
アクティブな構成ファイルに定義されている実行中のすべてのサービスからログをストリーミングします。[Ctrl]+[C]を押して終了します。
make logs
logsaai
直接podman logsコマンドを使用して、AAIコンテナ(oracle-applied-ai-label)のログのみをストリーミングします。[Ctrl]+[C]を押して終了します。
make logsaai