메인 콘텐츠로 건너뛰기
W&B는 W&B Multi-tenant Cloud 또는 W&B Dedicated Cloud와 같은 완전 관리형 배포 옵션을 권장합니다. W&B 완전 관리형 서비스는 설정이 거의 필요 없거나 전혀 필요 없어, 간편하고 안전하게 사용할 수 있습니다.
관련 문의 사항이 있으면 W&B 영업팀에 연락하세요: contact@wandb.com.

인프라 지침

W&B 배포를 시작하기 전에 하드웨어 규모 산정 권장 사항을 포함한 전체 인프라 요구 사항은 reference architecture를 참고하십시오.

버전 요구 사항

소프트웨어최소 버전
Kubernetesv1.32 이상 (지원되는 Kubernetes 버전)
Helmv3.x
MySQLv8.0.x가 필요하며, 최소 v8.0.32 이상이어야 합니다. v8.0.44 이상을 권장합니다.
Aurora MySQL 3.x 릴리스는 v3.05.2 이상이어야 합니다.
Redisv7.x

하드웨어 요구사항

CPU 아키텍처: W&B는 Intel(x86) CPU 아키텍처에서만 실행됩니다. ARM은 지원되지 않습니다. 사이징: Kubernetes 노드와 MySQL에 대한 CPU, 메모리, 디스크 사이징 권장 사항은 레퍼런스 아키텍처의 사이징 섹션을 참고하십시오. 요구 사항은 Models와 Weave를 각각 또는 함께 실행하는지에 따라 달라집니다.

MySQL 데이터베이스

W&B는 외부 MySQL 데이터베이스가 필요합니다. 운영(프로덕션) 환경에서는 관리형 데이터베이스 서비스를 사용할 것을 W&B에서 강력히 권장합니다: 관리형 데이터베이스 서비스는 자동 백업, 모니터링, 고가용성, 패치 적용 등을 제공하며 운영 부담을 줄여줍니다. 사이징 권장 사항 및 구성 파라미터를 포함한 전체 MySQL 요구 사항은 참조 아키텍처를 참조하세요. 데이터베이스 생성용 SQL은 베어 메탈 가이드를 확인하세요. 배포 환경의 데이터베이스 구성에 대한 질문이 있는 경우 support 또는 담당 AISE에 문의하세요. MySQL 버전 요구사항은 위의 버전 요구사항 섹션을 참조하세요. 자가 관리형 인스턴스의 MySQL 구성 매개변수는 참조 아키텍처 MySQL 구성 섹션을 참조하세요.

데이터베이스 생성

다음 SQL 명령어를 사용하여 데이터베이스와 사용자를 생성합니다. SOME_PASSWORD를 임의로 정한 안전한 비밀번호로 바꾸십시오:
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는 작업 큐 처리와 데이터 캐싱을 위해 W&B 구성 요소에서 사용하는 단일 노드 Redis 7.x 배포에 의존합니다. 개념 검증(PoC)의 테스트 및 개발 편의를 위해 W&B Self-Managed에는 프로덕션 배포 환경에는 적합하지 않은 로컬 Redis 배포가 포함되어 있습니다. 프로덕션 배포 환경의 경우, W&B는 다음 환경의 Redis 인스턴스에 연결할 수 있습니다:

객체 스토리지

W&B는 pre-signed URL 및 CORS를 지원하는 오브젝트 스토리지가 필요합니다. 프로덕션 배포 시 W&B는 다음과 같은 매니지드 오브젝트 스토리지 서비스 사용을 권장합니다:
  • Amazon S3: 업계 최고 수준의 확장성, 데이터 가용성, 보안 및 성능을 제공하는 오브젝트 스토리지 서비스.
  • Google Cloud Storage: 비정형 데이터를 대규모로 저장하기 위한 매니지드 서비스.
  • Azure Blob Storage: 대량의 비정형 데이터를 저장하기 위한 클라우드 기반 오브젝트 스토리지 솔루션.
  • CoreWeave AI Object Storage: AI 워크로드에 최적화된 고성능 S3 호환 오브젝트 스토리지 서비스.
자가 호스팅 오브젝트 스토리지 옵션에 대해서는 CORS 구성과 엔터프라이즈 대안을 포함한 자세한 설정 방법을 보려면 베어메탈 가이드 오브젝트 스토리지 섹션을 참고하십시오.
MinIO Open Source는 활성 개발 및 사전 컴파일된 바이너리 없이 유지 관리 모드에 있습니다. 프로덕션 배포의 경우, W&B는 매니지드 오브젝트 스토리지 서비스 또는 엔터프라이즈급 S3 호환 솔루션 사용을 권장합니다.
전체 요구 사항은 레퍼런스 아키텍처 오브젝트 스토리지 섹션을 참고하십시오.

자체 호스팅 오브젝트 스토리지 설정

오브젝트 스토리지는 서명된 URL을 지원하는 Amazon S3 호환 오브젝트 스토리지라면 외부에서 호스팅할 수 있습니다. 오브젝트 스토리지가 서명된 URL을 지원하는지 확인하려면 다음 스크립트를 실행하세요. MinIO Open Source 상태에 대한 중요한 정보는 아래 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>
System Console을 통해 오브젝트 스토리지를 구성하거나, 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 섹션을 참조하세요. 인증서는 신뢰할 수 있는 인증서여야 합니다. 자체 서명 인증서(Self-signed certificate)를 사용하는 경우 추가 구성이 필요합니다.
자체 오브젝트 스토리지를 운영할 때 주요하게 고려해야 할 사항은 다음과 같습니다:
  1. 스토리지 용량 및 성능. HDD(자기 디스크)를 사용하는 것은 괜찮지만, 해당 디스크의 용량을 지속적으로 모니터링해야 합니다. 일반적인 W&B 사용량은 수십에서 수백 기가바이트에 이릅니다. 사용량이 많은 경우 페타바이트 단위의 스토리지 소비가 발생할 수 있습니다.
  2. 내결함성. 최소한 오브젝트를 저장하는 물리 디스크는 RAID 구성을 사용해야 합니다. S3 호환 스토리지를 사용하는 경우 분산 구성 또는 고가용성 구성을 고려하세요.
  3. 가용성. 스토리지가 항상 사용 가능한지 확인할 수 있도록 모니터링을 구성해야 합니다.
자체 오브젝트 스토리지 서비스를 운영하는 것에 대한 엔터프라이즈 대안으로는 다음과 같은 것들이 있습니다:
  1. Amazon S3 on Outposts
  2. NetApp StorageGRID

MinIO 설정

MinIO Open Source는 현재 maintenance mode에 있으며, 활발한 개발이 이루어지지 않습니다. 사전 컴파일된 바이너리는 더 이상 제공되지 않으며, 중요 보안 패치만 사안별로 검토됩니다. 프로덕션 배포 환경에서는 관리형 오브젝트 스토리지 서비스나 MinIO Enterprise (AIStor) 사용을 W&B에서 권장합니다.
기존 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 Server 애플리케이션 배포

권장 설치 방법은 Helm을 통해 배포하는 W&B Kubernetes Operator를 사용하는 것입니다. 전체 설치 절차는 Kubernetes에서 W&B Server 실행하기 (Operator)를 참조하세요. 이 문서에서는 다음 내용을 다룹니다:
  • Helm CLI 배포
  • Helm Terraform 모듈 배포
  • W&B Cloud Terraform 모듈
아래 섹션에서는 온프레미스/데이터센터 배포에 특화된 고려 사항을 설명합니다.

OpenShift

W&B는 온프레미스 환경의 OpenShift Kubernetes 클러스터 배포를 지원합니다. 자세한 내용은 reference architecture를 참고하고, 온프레미스 OpenShift 배포에 맞게 조정할 수 있는 구체적인 구성 지침은 Operator guide OpenShift section을 참조하십시오.

네트워킹

네트워킹 관련 요구 사항, 로드 밸런서 옵션, nginx를 포함한 구성 예시는 참조 아키텍처의 네트워킹 섹션을 참고하세요.

설치를 확인하세요

설치를 검증하려면 W&B는 W&B CLI 사용을 권장합니다. verify 명령은 모든 구성 요소와 구성을 검증하는 여러 테스트를 실행합니다.
이 단계는 브라우저를 사용해 첫 번째 관리자 사용자 계정을 생성했다고 가정합니다.
다음 단계를 따라 설치를 검증하세요:
  1. W&B CLI를 설치합니다:
pip install wandb
  1. W&B에 로그인하기:
wandb login --host=https://YOUR_DNS_DOMAIN
예를 들어:
wandb login --host=https://wandb.company-name.com
  1. 설치를 확인하세요:
wandb verify
설치가 성공적으로 완료되고 W&B 배포가 정상적으로 동작하면 다음과 같은 출력이 표시됩니다:
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...........................✅
오류가 발생하면 W&B 지원 팀에 문의하세요.