ローカル環境での実行（Docker Compose利用）

1. 前提条件

---

2. プロジェクトディレクトリの作成

bash
mkdir ~/weaviate-local
cd ~/weaviate-local

---

3. docker-compose.yml の最小構成例

yaml
version: "3.9"
services:
  weaviate:
    image: cr.weaviate.io/semitechnologies/weaviate:1.31.1
    command: ["--host","0.0.0.0","--port","8080","--scheme","http"]
    ports:
      - "8080:8080"     # REST / GraphQL
      - "50051:50051"   # gRPC
    environment:
      QUERY_DEFAULTS_LIMIT: 25
      AUTHENTICATION_ANONYMOUS_ACCESS_ENABLED: "true"
      PERSISTENCE_DATA_PATH: "/var/lib/weaviate"
      ENABLE_API_BASED_MODULES: "true"   # OpenAI など API ベースのモジュールを許可
      CLUSTER_HOSTNAME: "node1"
    volumes:
      - weaviate_data:/var/lib/weaviate      # 永続化ボリューム
    restart: on-failure:0
volumes:
  weaviate_data:

このファイルは公式ドキュメントの Sample Docker Compose file を簡略化したものです。weaviate.io

ポイント

• Weaviate 本体だけを起動するシングルノード構成

• 匿名アクセスを許可 (AUTHENTICATION_ANONYMOUS_ACCESS_ENABLED=true)

• データはホスト側 weaviate_data ボリュームに永続化

---

4. 起動と停止

bash
# バックグラウンドで起動
docker compose up -d

# ログをフォロー（必要に応じて）
docker compose logs -f weaviate

Weaviate が 8080 にバインドされ、/v1/meta エンドポイントが 200 OK を返せば起動成功です。weaviate.io

停止は docker compose down、データを残したくない場合は docker compose down -v を使用します。

---

5. 動作確認

ブラウザまたは curl で確認：

bash
curl http://localhost:8080/v1/meta | jq

レスポンスにバージョンや modules が表示されれば正常です。Python なら

python
import weaviate
client = weaviate.connect_to_local()
print(client.get_meta())
client.close()

---

6. 主要環境変数の意味（抜粋）

詳細は公式「環境変数リスト」を参照してください。weaviate.io

---

7. ベクトル化モジュールを追加する場合（text2vec-transformers の例）

1. Weaviate 本体の ENABLE_MODULES を設定

2. 推論用コンテナ を追加（下記例では t2v-transformers）

yaml
services:
  weaviate:
    # 省略…
    environment:
      ENABLE_MODULES: "text2vec-transformers"
      TRANSFORMERS_INFERENCE_API: "http://t2v-transformers:8080"
  t2v-transformers:
    image: cr.weaviate.io/semitechnologies/transformers-inference:sentence-transformers-all-MiniLM-L6-v2
    environment:
      ENABLE_CUDA: 0   # GPU を使う場合は 1

TRANSFORMERS_INFERENCE_API により Weaviate が別コンテナのエンベッディング API を呼び出します。weaviate.io

---

8. 永続化・バックアップ・アップグレード

---

9. よくあるトラブルと対策

---

まとめ

Docker Compose を用いると、1 ファイル・1 コマンドでローカルに Weaviate を用意できます。必要に応じてモジュールを追記し、永続化ボリュームでデータを安全に保持してください。ローカル開発で構成に慣れた後は、同じ YAML を Kubernetes Helm へ移植することで本番環境へスムーズに移行できます。