W&B 플랫폼 온프레미스 배포하기

온프레미스 인프라에서 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(signed URLs)을 지원하는 모든 Amazon S3 호환 오브젝트 스토리지에서 외부 호스팅이 가능합니다. 다음 스크립트를 run 하여 사용 중인 오브젝트 스토리지가 서명된 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 Custom Resource(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 사용 시 수십에서 수백 기가바이트가 소요됩니다. 사용량이 많으면 페타바이트 단위의 스토리지 소비가 발생할 수 있습니다.
2. 결함 허용(Fault tolerance). 최소한 오브젝트를 저장하는 물리 디스크는 RAID 어레이로 구성되어야 합니다. S3 호환 스토리지를 사용하는 경우 분산 또는 고가용성 설정을 고려하세요.
3. 가용성. 스토리지가 항상 사용 가능한 상태인지 확인하기 위해 모니터링을 설정해야 합니다.

자체 오브젝트 스토리지 서비스를 운영하는 것 대신 다음과 같은 엔터프라이즈 대안들이 있습니다:

1. Amazon S3 on Outposts
2. NetApp StorageGRID

​

MinIO 설정

MinIO 오픈 소스는 현재 유지관리 모드이며 활발한 개발이 이루어지지 않고 있습니다. 사전 컴파일된 바이너리는 더 이상 제공되지 않으며, 심각한 보안 수정 사항만 케이스별로 검토됩니다. 프로덕션 배포의 경우, W&B는 관리형 오브젝트 스토리지 서비스 또는 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

새로 배포하는 경우, 위에 나열된 엔터프라이즈 대안이나 관리형 클라우드 오브젝트 스토리지 서비스를 고려하세요.

​

Kubernetes에 W&B 서버 애플리케이션 배포

권장되는 설치 메소드는 Helm을 통해 배포되는 W&B Kubernetes Operator를 사용하는 것입니다.

전체 설치 가이드는 다음을 포함하는 Kubernetes에서 W&B 서버 실행 (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.