Docker Compose のデプロイメント

このガイドでは、Docker Compose を使用した HagiCode のデプロイについて説明します。ほとんどのユーザーにとって、これは開発、テスト、運用環境にわたるデフォルトの展開パスです。

ビデオチュートリアル

最初に完全なフローを確認したい場合は、ビデオ チュートリアルから始めてください。

Bilibili でビデオチュートリアルを見る

ビデオコンテンツには以下が含まれます:

• Docker Compose デプロイメントプロセスの完全なデモ
• 構成ファイルの生成と変更の手順
• サービスの起動と検証の手順
• よくある問題と解決策

動画の長さ：約15分

Docker Compose ビルダー

Docker Compose Builder は、スタンドアロン ツールとして次から入手できるようになりました。 https://builder.hagicode.com/。そのサイトを、同じクラスの構成ファイルを生成するためのメイン ソースとして使用します。

:::ヒント[設定ジェネレーターを使用する] 使用できます Docker Compose Builder (スタンドアロン サイト) 生成する docker-compose.yml 直接的に。

ジェネレーターは以下をサポートします。

• カスタムポート、コンテナ名、その他の基本設定
• 内蔵または外部データベースの選択
• 自動 Windows / Linux プラットフォームの違い
• 一般的なファイル権限の処理
• ネットワーク環境に基づいた画像ソースの選択

発電機を開く → :::

:::tip【おすすめの方法】 ほとんどの場合、Docker Compose がデフォルトのデプロイメント パスです。その理由は次のとおりです。

• 環境の分離により依存関係の競合が軽減されます
• サポートされているHagiCodeサービススタックは一緒に開始できます
• 構成、アップグレード、メンテナンスの一貫性を維持しやすくなります。
• ローカルでのトライアル、テスト、チーム展開に適しています。 :::

デフォルトのデータストレージについて

現在サポートされている Docker Compose テンプレートは、デフォルトのローカル SQLite パスを通じてデータを保持します。ほとんどの場合、ホスト マシン上に別のデータベース サービスをプロビジョニングする必要はありません。

前提条件

開始する前に、システムに Docker と Docker Compose がインストールされていることを確認してください。

Dockerをインストールする

窓

ダウンロードしてインストールする Windows 用 Docker デスクトップ

インストール後、Docker Desktop が実行されていることを確認します。

macOS

ダウンロードしてインストールする Mac 用 Docker デスクトップ

インストール後、Docker Desktop が実行されていることを確認します。

Linux

パッケージ マネージャーを使用して Docker をインストールします。

Install Docker on Ubuntu/Debian

sudo apt-get update
sudo apt-get install docker.io docker-compose-plugin

インストール後、Docker サービスを開始します。

sudo systemctl start docker
sudo systemctl enable docker

インストールの検証

インストール後、次のコマンドを実行して、Docker と Docker Compose が正しくインストールされていることを確認します。

docker --version
docker compose version

クイックスタート

1. Docker Compose 構成ファイルを生成する

:::ヒント[設定ジェネレーターを使用する] 使用を推奨します Docker Compose Builder (スタンドアロン サイト) 設定ファイルを生成します。

ジェネレーターは以下をサポートします。

• 複数の API プロバイダー オプション (Zhipu AI、Anthropic Official、カスタム API)
• API URLとトークンの自動設定
• カスタムポート、コンテナ名、その他の基本構成
• 永続データと作業ディレクトリのパスを構成する
• Windows/Linux プラットフォームの違いを自動的に構成する
• ファイル権限の問題をインテリジェントに処理する
• 画像ソースの選択: ネットワーク環境に基づいて、適切な画像ソースを選択します。

🚀 すぐに発電機を使用してください → :::

1. 開く Docker Compose Builder (スタンドアロン サイト)
2. 必要に応じて構成を入力します。
   • API プロバイダーの選択 (Zhipu AI、Anthropic Official、またはカスタム API)
   • ポート、データベース、作業ディレクトリ、その他のオプションを構成する
   • 画像ソースの選択: ネットワーク環境に基づいて適切な画像ソースを選択します
3. 生成ボタンをクリックして、 docker-compose.yml 構成
4. 生成された構成を docker-compose.yml ファイル
5. 必要に応じて、 .env 機密情報を構成するファイル

画像ソースの選択

ジェネレーターは 3 つの画像ソース オプションをサポートしています。

Docker ハブ

• 画像アドレス: newbe36524/hagicode:{tag}
• 該当するシナリオ: Docker Hub ミラー アクセラレーションを使用するユーザーに適しています
• 利点: 公式画像ソース、タイムリーな更新、安定したアクセス
• 注意: 一部の地域ではミラーの加速を設定する必要がある場合があります

Azure Container Registry (ACR)

• 画像アドレス: hagicode.azurecr.io/hagicode:{tag}
• 該当するシナリオ: Docker Hub にローカルでアクセスできないユーザーに適しています
• 利点: 代替画像ソースを提供し、ネットワーク アクセスの問題を解決します。
• 注意: イメージは Docker Hub と同期されたままですが、短時間の遅延が発生する場合があります。

Alibaba Cloud Container Registry (ACR)

• 画像アドレス: registry.cn-hangzhou.aliyuncs.com/hagicode/hagicode:{tag}
• 適用可能なシナリオ: 国内ユーザーに適しており、安定した高速ネットワーク アクセスが可能です。
• 利点: Alibaba Cloud国内ノード、高速アクセス、高い安定性
• 注意: Alibaba ACR イメージは、通常 30 分以内に Docker Hub と同期したままになります。

画像ソース選択の推奨事項

• 国内ユーザーは Alibaba Cloud ACR を推奨: 国内ユーザーの場合、高速で安定したアクセスのために Alibaba Cloud ACR イメージ ソースの使用を優先することをお勧めします。
• 代替の Docker Hub: ネットワーク環境が Docker Hub にアクセスできる場合は、イメージ ソースとして Docker Hub を選択することもできます。
• 代替 Azure ACR: 他のイメージ ソースにアクセスできない場合は、Azure ACR イメージ ソースのみを選択してください
• イメージの同期: Alibaba Cloud ACR イメージは、通常 30 分以内に Docker Hub と同期されます。
• バージョンの一貫性: 画像タグは 3 つの画像ソースすべてで一貫しているため、バージョンの問題を心配する必要はありません。

APIトークンの取得

ハギコードを使用するには、Claude API トークンを構成する必要があります。

Zhipu AI (推奨): APIトークンを取得 →

• 国内安定アクセス、迅速な対応
• コストパフォーマンスが高く、デイリーユースに最適

人類関係者: APIトークンを取得 →

• Anthropic のサービスの直接使用

2. サービスの開始

ディレクトリで次のコマンドを実行します。 docker-compose.yml は次の場所にあります:

docker compose up -d

このコマンドは次のことを行います。

• 生成されたテンプレートで定義されたHagiCodeコンテナをダウンロードして起動します
• ネットワークの作成と構成
• デフォルトのデータディレクトリとランタイムの依存関係を初期化します。

3. サービスステータスの確認

コンテナが実行されているかどうかを確認します。

docker compose ps

生成されたテンプレートで定義されたサービスが「実行中」ステータスで表示されるはずです。

サービスログの表示

すべてのサービス ログを表示するには:

# View all service logs
docker compose logs

# View HagiCode service logs
docker compose logs hagicode

# Real-time log following
docker compose logs -f hagicode

設定手順

構成を変更する必要がある場合 (ポートの変更、API プロバイダーの切り替えなど)、次のことができます。

1. を使用して新しい構成を再生成します Docker Compose Builder (スタンドアロン サイト)
2. 手動で編集する docker-compose.yml そして .env ファイル
3. サービスを再起動して構成を有効にします。

docker compose restart

アプリケーションにアクセスする

ウェブインターフェース

サービスが正常に起動したら、ブラウザからアクセスします。

http://localhost:45000

データの永続性

サポートされている Docker Compose パスは、デフォルトで永続ボリュームを持つ SQLite データ ファイルを使用します。マウント ポイントを検査したり、バックアップを計画したりする必要がある場合は、生成されたファイル内のボリュームとデータ ディレクトリのマッピングを確認してください。 docker-compose.yml.

次のステップ

これで、HagiCode が正常にデプロイされました。次に、Web インターフェイスで実際のプロジェクトを接続し、次の手順に進みます。 ウィザードのセットアップ または 提案セッションの作成.

デスクトップ アプリケーションの展開方法を希望する場合は、以下を参照してください。 デスクトップインストールガイド.