Docker（Linux）でMilvusを実行する
このページでは、Docker で Milvus インスタンスを起動する方法について説明します。
前提条件
- Dockerをインストールしてください。
- インストール前に、ハードウェアおよびソフトウェアの要件を確認してください。
Docker での Milvus のインストール
Milvusには、Dockerコンテナとしてインストールするためのインストールスクリプトが用意されています。このスクリプトはMilvusのリポジトリから入手できます。新しいデプロイを開始する前に、スクリプトをダウンロードして内容を確認してください:
# Download the installation script
$ curl -sfL https://raw.githubusercontent.com/milvus-io/milvus/master/scripts/standalone_embed.sh -o standalone_embed.sh
# Inspect the Docker image selected by the script
$ grep -n "milvusdb/milvus:" standalone_embed.sh
# Start the Docker container
$ bash standalone_embed.sh start
スクリプトは、Milvusのmaster ブランチからダウンロードされます。Dockerイメージのタグはスクリプト内で定義されており、v3.0.3とは異なる場合があります。その特定のリリースをインストールするには、「Docker ComposeでMilvusを実行する」に記載されているバージョン指定の設定を使用してください。
この Docker デプロイでは、Woodpecker をローカルファイルシステムを WAL バックエンドとして実行するため、外部のメッセージキューサービスは必要ありません。Woodpecker を参照してください。
Backupをスタンドアロン展開モードで使用する場合は、Docker Composeによる展開方法を使用することを推奨します。
イメージの取得で問題が発生した場合は、問題の詳細を明記の上、community@zilliz.comまでご連絡ください。必要なサポートを提供いたします。
インストールスクリプトの実行後：
- 「milvus-standalone」という名前の Docker コンテナがポート19530 で起動しました。
- Milvus とともに、同じコンテナ内に埋め込み型の etcd がインストールされ、ポート2379 で動作しています。その設定ファイルは、現在のフォルダ内のembedEtcd.yamlにマッピングされています。
- Milvusのデフォルト設定を変更するには、現在のフォルダ内のuser.yamlファイルに設定を追加し、サービスを再起動してください。
- Milvusのデータボリュームは、現在のフォルダ内のvolumes/milvusにマッピングされています。
実際のイメージと正常性を確認してください:
docker inspect --format '{{.Config.Image}}' milvus-standalone
docker inspect --format '{{.State.Health.Status}}' milvus-standalone
クイックスタートの手順に進む前に、healthy が表示されるまでお待ちください。このサーバーを使用する場合は、SDKをhttp://localhost:19530 に接続してください。ローカルの.db URIに接続すると、代わりにMilvus Liteが起動します。
http://127.0.0.1:9091/webui/ から Milvus WebUI にアクセスして、お使いの Milvus インスタンスに関する詳細を確認できます。詳細については、Milvus WebUI を参照してください。
（オプション）Milvusの設定を更新する
現在のフォルダにあるuser.yamlファイルで Milvus の設定を変更できます。たとえば、proxy.healthCheckTimeout を1000 ms に変更するには、次のようにファイルを編集します。
cat << EOF > user.yaml
# Extra config to override default milvus.yaml
proxy:
healthCheckTimeout: 1000 # ms, the interval that to do component healthy check
EOF
その後、次のようにサービスを再起動します:
$ bash standalone_embed.sh restart
適用可能な設定項目については、「システム設定」を参照してください。
Milvusのアップグレード
スクリプトの `upgrade ` コマンドは、master からスクリプトをダウンロードし、そのスクリプトで選択されたイメージを使用してコンテナを再作成します。このコマンドは、サポートされているソースからターゲットへのバージョンパスを検証せず、生成された設定ファイルを再作成する場合があります。任意の古いデプロイメントが v3.0.3 へ安全にアップグレードできることを保証するものではないため、そのように扱わないでください。
アップグレードの前に、メタデータ、永続データ、embedEtcd.yaml 、およびuser.yaml をバックアップしてください。ターゲットバージョン、メッセージキュー、ストレージの互換性を確認し、本番環境以外で復旧動作を検証してください。Docker Compose で管理されているデプロイメントについては、「Docker Compose を使用した Milvus スタンドアロンのアップグレード」の手順に従ってください。スクリプトで管理されているコンテナには、その手順を直接適用しないでください。
Milvusの停止と削除
このコンテナは、次のように停止および削除できます
# Stop Milvus
$ bash standalone_embed.sh stop
# Delete Milvus data
$ bash standalone_embed.sh delete
オプションの依存関係
デフォルトでは、このデプロイメントはメッセージキューとしてWoodpecker（ローカルファイルシステム WAL）を、メタデータ用に組み込みの etcdを実行します。他にインストールする必要はありません。別のメッセージキューを使用する場合、または外部オブジェクトストレージ／メタデータに接続する場合は、以下を参照してください：
- メッセージキュー：Woodpecker（デフォルト） ·Pulsar·Kafka·RocksMQ
- オブジェクトストレージ：MinIO（デフォルト） ·AWS S3·Azure Blob·GCP Cloud Storage·Aliyun OSS·Tencent COS·Huawei OBS·S3互換
- メタデータ:etcd
Storage V3はデフォルトで無効になっています。Storage V3に依存する機能を使用する前に、有効にしてください。要件および互換性に関する注意事項については、「Storage V3」を参照してください。
次の手順
Docker に Milvus をインストールしたら、次のことができます:
「クイックスタート」を参照して、Milvusの機能を確認してください。
Milvusの基本的な操作を学びましょう：
Milvusのバージョンを変更する前に、このページに記載されているアップグレードに関する注意事項をご確認ください。
クラウド上に Milvus クラスターをデプロイします：
Milvusの可観測性と管理のための直感的なWebインターフェース「Milvus WebUI」をご覧ください。
Milvusデータのバックアップを行うオープンソースツール「Milvus Backup」をご覧ください。
Milvusのデバッグや動的な構成更新を行うためのオープンソースツール「Birdwatcher」をご覧ください。
直感的な Milvus 管理のためのオープンソース GUI ツール「Attu」をご覧ください。
