W&B Platform をオンプレミスでデプロイする

オンプレミス インフラストラクチャー での W&B Server のホスティング

W&B では、W&B Multi-tenant Cloud または W&B 専用クラウド デプロイメントタイプのような、フルマネージドなデプロイメントオプションを推奨しています。W&B のフルマネージドサービスは、設定をほとんど、あるいは全く必要とせず、シンプルかつ安全に使用できます。

関連するご質問については、W&B セールスチーム（[e-mail]）までお問い合わせください。

​

インフラストラクチャー ガイドライン

W&B のデプロイを開始する前に、ハードウェアのサイジングに関する推奨事項を含む、完全なインフラストラクチャー要件について リファレンスアーキテクチャー を参照してください。

​

バージョン要件

Software	Minimum version
Kubernetes	v1.32 or newer (Supported Kubernetes versions)
Helm	v3.x
MySQL	v8.0.x is required, v8.0.32 or newer; v8.0.44 or newer is recommended. Aurora MySQL 3.x releases, must be v3.05.2 or newer
Redis	v7.x

​

ハードウェア要件

CPU Architecture: W&B runs on Intel (x86) CPU architecture only. ARM is not supported.

Sizing: For CPU, memory, and disk sizing recommendations for Kubernetes nodes and MySQL, see the Sizing section in the reference architecture. Requirements vary based on whether you’re running Models, Weave, or both.

​

MySQL データベース

W&B requires an external MySQL database.

For production, W&B strongly recommends using managed database services:

• AWS RDS Aurora MySQL
• Google Cloud SQL for MySQL
• Azure Database for MySQL

Managed database services provide automated backups, monitoring, high availability, patching, and reduce operational overhead.

See the reference architecture for complete MySQL requirements, including sizing recommendations and configuration parameters. For database creation SQL, see the bare-metal guide. For questions about your deployment’s database configuration, contact support or your AISE.

MySQL のバージョン要件については、上記の バージョン要件 セクションを参照してください。

セルフマネージドインスタンス向けの MySQL 設定パラメータについては、リファレンスアーキテクチャーの MySQL 設定セクション を参照してください。

​

データベースの作成

Create a database and a user with the following SQL commands. Replace SOME_PASSWORD with a secure password of your choice:

CREATE USER 'wandb_local'@'%' IDENTIFIED BY 'SOME_PASSWORD';
CREATE DATABASE wandb_local CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
GRANT ALL ON wandb_local.* TO 'wandb_local'@'%' WITH GRANT OPTION;

SSL/TLS 証明書の要件については、以下の SSL/TLS セクション を参照してください。

​

Redis

W&B depends on a single-node Redis 7.x deployment used by W&B’s components for job queuing and data caching. For convenience during testing and development of proofs of concept, W&B Self-Managed includes a local Redis deployment that is not appropriate for production deployments.

For production deployments, W&B can connect to a Redis instance in the following environments:

• AWS Elasticache
• Google Cloud Memory Store
• Azure Cache for Redis
• Redis deployment hosted in your cloud or on-premise infrastructure

​

オブジェクトストレージ

W&B requires object storage with pre-signed URL and CORS support.

For production deployments, W&B recommends using managed object storage services:

• Amazon S3: Object storage service offering industry-leading scalability, data availability, security, and performance.
• Google Cloud Storage: Managed service for storing unstructured data at scale.
• Azure Blob Storage: Cloud-based object storage solution for storing massive amounts of unstructured data.
• CoreWeave AI Object Storage: High-performance, S3-compatible object storage service optimized for AI workloads.

For self-hosted object storage options, see the bare-metal guide object storage section for detailed setup instructions including CORS configuration and enterprise alternatives.

MinIO Open Source is in maintenance mode with no active development or pre-compiled binaries. For production deployments, W&B recommends using managed object storage services or enterprise-grade S3-compatible solutions.

See the reference architecture object storage section for complete requirements.

​

セルフホスト型オブジェクトストレージの設定

オブジェクトストアは、署名付き URL をサポートしている Amazon S3 互換のオブジェクトストアであれば、外部でホストすることが可能です。こちらのスクリプト を実行して、お使いのオブジェクトストアが署名付き URL をサポートしているか確認してください。MinIO オープンソースのステータスに関する重要な情報については、以下の MinIO のセットアップセクション を参照してください。

さらに、オブジェクトストアには以下の CORS ポリシーを適用する必要があります。

<?xml version="1.0" encoding="UTF-8"?>
<CORSConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
<CORSRule>
    <AllowedOrigin>http://YOUR-W&B-SERVER-IP</AllowedOrigin>
    <AllowedMethod>GET</AllowedMethod>
    <AllowedMethod>PUT</AllowedMethod>
    <AllowedMethod>HEAD</AllowedMethod>
    <AllowedHeader>*</AllowedHeader>
</CORSRule>
</CORSConfiguration>

オブジェクトストレージの設定は、システムコンソール を通じて行うか、W&B カスタムリソース（CR）仕様で直接設定します。

​

AWS S3 の設定

AWS S3 バケットの場合、W&B CR に以下の設定を行います。

bucket:
  kmsKey: <kms key arn>  # オプション：暗号化用の KMS キー
  name: <bucket name>    # 例: wandb
  path: ""               # 空の文字列のままにします
  provider: s3
  region: <region>       # 例: us-east-1

AWS S3 接続では、デフォルトで TLS が有効になっています。

​

S3 互換ストレージの設定

S3 互換ストレージ（MinIO など）の場合は、以下の設定を使用します。

bucket:
  kmsKey: null
  name: <s3 endpoint>    # 例: s3.example.com:9000
  path: <bucket name>    # 例: wandb
  provider: s3
  region: <region>       # 例: us-east-1

S3 互換ストレージで TLS を使用するには、バケットパスに ?tls=true を追加します。

bucket:
  kmsKey: null
  name: "s3.example.com:9000"
  path: "wandb?tls=true"
  provider: "s3"
  region: "us-east-1"

証明書の要件については、以下の SSL/TLS セクション を参照してください。証明書は信頼されている必要があります。自己署名証明書には追加の設定が必要です。

独自のオブジェクトストアを運用する際に考慮すべき最も重要な事項は以下の通りです。

1. ストレージ容量とパフォーマンス: 磁気ディスクを使用しても問題ありませんが、ディスク容量を監視する必要があります。W&B の平均的な利用では数十から数百 GB の結果となりますが、ヘビーな利用ではペタバイト規模のストレージを消費する可能性があります。
2. フォールトトレランス（耐障害性）: 最低限、オブジェクトを保存する物理ディスクは RAID アレイ上に構成する必要があります。S3 互換ストレージを使用する場合は、分散構成や高可用性構成の検討をお勧めします。
3. 可用性: ストレージが利用可能であることを確認するためのモニタリングを設定する必要があります。

独自のオブジェクトストレージサービスを運用する代わりに、以下のような多くのエンタープライズ向け代替手段があります。

1. Amazon S3 on Outposts
2. NetApp StorageGRID

​

MinIO のセットアップ

MinIO オープンソースは メンテナンスモード であり、アクティブな開発は行われていません。ビルド済みのバイナリは提供されなくなり、重大なセキュリティ修正のみがケースバイケースで検討されます。プロダクション環境のデプロイメントには、マネージドオブジェクトストレージサービスまたは MinIO Enterprise (AIStor) の使用を推奨します。

既存の MinIO デプロイメントまたは MinIO Enterprise を使用している場合は、MinIO クライアントを使用してバケットを作成できます。

# クライアントの設定
mc config host add local http://$MINIO_HOST:$MINIO_PORT "$MINIO_ACCESS_KEY" "$MINIO_SECRET_KEY" --api s3v4
# バケットの作成
mc mb --region=us-east1 local/local-files

新規デプロイの場合は、上記のエンタープライズ向け代替手段、またはマネージドクラウドオブジェクトストレージサービスを検討してください。

​

W&B サーバーアプリケーションの Kubernetes へのデプロイ

推奨されるインストールメソッドは、Helm 経由でデプロイされる W&B Kubernetes Operator を使用することです。

完全なインストール手順については、Run W&B Server on Kubernetes (Operator) を参照してください。以下の内容をカバーしています：

• Helm CLI によるデプロイ
• Helm Terraform モジュールによるデプロイ
• W&B クラウド Terraform モジュール

以下のセクションでは、オンプレミスやデータセンターでのデプロイメントに特有の考慮事項を説明します。

​

OpenShift

W&B はオンプレミス環境の OpenShift Kubernetes クラスターへのデプロイをサポートしています。詳細については リファレンスアーキテクチャー を、オンプレミスの OpenShift デプロイメントに合わせて調整可能な具体的な設定手順については Operator ガイドの OpenShift セクション を参照してください。

​

ネットワーク

ネットワーク要件、ロードバランサーのオプション、および設定例（nginx を含む）については、リファレンスアーキテクチャーのネットワーキングセクション を参照してください。

​

インストールの確認

To verify the installation, W&B recommends using the W&B CLI. The verify command executes several tests that verify all components and configurations.

This step assumes that the first admin user account is created with the browser.

Follow these steps to verify the installation:

1. Install the W&B CLI:

pip install wandb

2. Log in to W&B:

wandb login --host=https://YOUR_DNS_DOMAIN

For example:

wandb login --host=https://wandb.company-name.com

3. Verify the installation:

wandb verify

A successful installation and fully working W&B deployment shows the following output:

Default host selected:  https://wandb.company-name.com
Find detailed logs for this test at: /var/folders/pn/b3g3gnc11_sbsykqkm3tx5rh0000gp/T/tmpdtdjbxua/wandb
Checking if logged in...................................................✅
Checking signed URL upload..............................................✅
Checking ability to send large payloads through proxy...................✅
Checking requests to base url...........................................✅
Checking requests made over signed URLs.................................✅
Checking CORs configuration of the bucket...............................✅
Checking wandb package version is up to date............................✅
Checking logged metrics, saving and downloading a file..................✅
Checking artifact save and download workflows...........................✅

Contact W&B Support if you encounter errors.