> ## Documentation Index
> Fetch the complete documentation index at: https://docs.coreweave.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Self-Managed 인프라 요구 사항

> W&B Self-Managed 배포를 위한 인프라 및 소프트웨어 요구 사항

이 페이지에서는 W\&B Self-Managed 배포에 필요한 인프라 및 소프트웨어 요구 사항을 설명합니다. 이 문서는 Self-Managed 설치를 계획하는 플랫폼 및 인프라 엔지니어를 대상으로 합니다. 배포를 시작하기 전에 이 요구 사항을 검토하여 사용 중인 환경이 W\&B Server를 지원할 수 있는지 확인하세요.

<Note>
  W\&B는 [W\&B Multi-tenant Cloud](/ko/products/wandb/platform/hosting/hosting-options/multi_tenant_cloud) 또는 [W\&B Dedicated Cloud](/ko/products/wandb/platform/hosting/hosting-options/dedicated-cloud)와 같은 완전 관리형 배포 옵션을 권장합니다. W\&B 완전 관리형 서비스는 간편하고 안전하게 사용할 수 있으며, 별도의 설정이 거의 필요하지 않습니다.
</Note>

전체 아키텍처 가이드는 [레퍼런스 아키텍처](/ko/products/wandb/platform/hosting/self-managed/ref-arch)를 참조하세요.

<h2 id="software-version-requirements">
  소프트웨어 버전 요구 사항
</h2>

| 소프트웨어 | 최소 버전 |
| - | - |
| Kubernetes | v1.34 이상([지원되는 Kubernetes 버전](https://kubernetes.io/releases/patch-releases/)) |
| Helm | v3.x |
| MySQL | W\&B Self-Managed 배포에서는 보안 패치와 중요 버그 수정이 제공되는, 지원되는 MySQL 버전을 실행해야 합니다. **MySQL 8.4.x**를 설치하거나 해당 버전으로 업그레이드하세요. 또는 공급자가 지원 및 패치 대상으로 명시한 관리형 서비스 버전을 사용하세요.<br />Aurora MySQL의 버전 문자열은 커뮤니티 MySQL 버전과 다릅니다. 전체 엔진 버전 문자열은 `SELECT version()`으로, Aurora 버전은 `SELECT aurora_version()`으로 확인하세요. [Aurora MySQL 버전 3](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/AuroraMySQL.MySQL80.html)은 MySQL 8.0.x와 호환되며 계속 지원됩니다. 대상 버전을 선택할 때는 [Amazon Aurora 버전 관리](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/Aurora.VersionPolicy.Versioning.html) 및 클라우드 제공업체의 문서를 참조하세요. |
| Redis | v7.x |
| ClickHouse | Self-Managed 배포에서 Weave를 사용하려면 필요합니다. Weave를 사용하지 않는 배포에서는 필요하지 않습니다. [업그레이드를 위한 ClickHouse 호환성](/ko/products/wandb/platform/hosting/self-managed/operator#clickhouse-compatibility-for-upgrades) 및 [지원되는 W\&B Server 릴리스](/ko/release-notes/server-releases)를 참조하세요. |

<h2 id="hardware-requirements">
  하드웨어 요구 사항
</h2>

**CPU 아키텍처**: W\&B는 Intel(x86) CPU 아키텍처에서만 실행되며, ARM은 지원하지 않습니다.

**사이징**: Kubernetes 노드와 MySQL의 CPU, 메모리, 디스크 사이징 권장 사항은 레퍼런스 아키텍처의 [사이징 섹션](/ko/products/wandb/platform/hosting/self-managed/ref-arch#sizing)을 참조하세요. 요구 사항은 Models와 Weave 중 하나만 실행하는지, 둘 다 실행하는지에 따라 달라집니다.

사용 사례(Models only, Weave only 또는 둘 다)별 자세한 사이징 권장 사항은 [레퍼런스 아키텍처 사이징 섹션](/ko/products/wandb/platform/hosting/self-managed/ref-arch#sizing)을 참조하세요.

<h2 id="kubernetes">
  Kubernetes
</h2>

W\&B Server는 여러 파드를 관리하는 [Kubernetes Operator](/ko/products/wandb/platform/hosting/self-managed/operator)로 배포됩니다. Kubernetes 클러스터는 다음 요구 사항을 충족해야 합니다.

* **버전**: 앞의 [소프트웨어 버전 요구 사항](#software-version-requirements) 섹션을 참조하세요.
* **Ingress 컨트롤러**: 설정이 완료되어 정상적으로 작동하는 ingress 컨트롤러(Nginx, Istio, Traefik 또는 클라우드 제공업체 ingress)가 필요합니다.
* **영구 볼륨**: 영구 볼륨을 프로비저닝할 수 있어야 합니다.
* **CPU 아키텍처**: Intel 또는 AMD 64비트(ARM은 지원되지 않음)

W\&B는 클라우드, 온프레미스, 에어갭 환경의 [OpenShift Kubernetes 클러스터](https://www.redhat.com/en/technologies/cloud-computing/openshift)에 대한 배포를 지원합니다. 구체적인 설정 방법은 Operator 가이드의 [OpenShift 섹션](/ko/products/wandb/platform/hosting/self-managed/operator#openshift-kubernetes-clusters)을 참조하세요.

로드 밸런서 및 ingress 설정을 포함한 전체 Kubernetes 요구 사항은 [레퍼런스 아키텍처의 Kubernetes 섹션](/ko/products/wandb/platform/hosting/self-managed/ref-arch#kubernetes)을 참조하세요.

<h2 id="mysql-database">
  MySQL 데이터베이스
</h2>

<Important>
  MySQL 8.0.x는 2026년 4월에 지원이 종료(EOL)되었습니다. W\&B Self-Managed 배포는 보안 패치와 중요 버그 수정이 계속 제공되는, 지원 대상 MySQL 버전에서 실행해야 합니다. 커뮤니티 MySQL을 사용하는 경우 **MySQL 8.4.x**를 설치하거나 해당 버전으로 업그레이드하세요. 관리형 서비스를 사용하는 경우 공급자가 지원 및 패치 대상으로 명시한 엔진 버전을 실행하세요(예: Amazon RDS for MySQL, Google Cloud SQL for MySQL, Azure Database for MySQL). W\&B는 MySQL 8.4.0 및 최신 8.4.x 릴리스에서 플랫폼 검증을 완료했습니다. 아직 MySQL 8.0.x를 사용 중이라면 [MySQL을 8.4.x로 업그레이드](/ko/products/wandb/platform/hosting/self-managed/operator#upgrade-mysql-to-84x)에 안내된 단계에 따라 업그레이드를 계획하세요.
</Important>

W\&B에는 외부 MySQL 데이터베이스가 필요합니다.

프로덕션 환경에서는 관리형 데이터베이스 서비스를 사용하는 것이 좋습니다.

* [AWS RDS Aurora MySQL](https://aws.amazon.com/rds/aurora/)
* [Google Cloud SQL for MySQL](https://cloud.google.com/sql/mysql)
* [Azure Database for MySQL](https://azure.microsoft.com/en-us/products/mysql/)

관리형 데이터베이스 서비스는 자동 백업, 모니터링, 고가용성, 패치를 제공하며 운영 부담을 줄여줍니다.

사이징 권장 사항과 설정 매개변수를 포함한 MySQL 요구 사항은 [레퍼런스 아키텍처](/ko/products/wandb/platform/hosting/self-managed/ref-arch#mysql)를 참조하세요. 데이터베이스를 생성하는 SQL은 [베어메탈 가이드](/ko/products/wandb/platform/hosting/self-managed/operator#mysql-database)를 참조하세요. 배포 환경의 데이터베이스 설정에 관한 질문은 [지원팀](mailto:forge-support@coreweave.com) 또는 담당 AISE에 문의하세요.

W\&B는 프로덕션 배포 시 AWS RDS Aurora MySQL, Google Cloud SQL for MySQL, Azure Database for MySQL 등의 관리형 데이터베이스 서비스를 사용할 것을 권장합니다. 관리형 서비스는 자동 백업, 모니터링, 고가용성, 패치 적용 기능을 제공하므로 운영 부담을 줄일 수 있습니다.

<h3 id="mysql-configuration-parameters">
  MySQL 설정 매개변수
</h3>

자체 MySQL 인스턴스를 운영하는 경우 W\&B Server와 호환되도록 MySQL을 다음과 같이 설정하세요.

```ini theme={"system"}
binlog_format = 'ROW'
binlog_row_image = 'MINIMAL'
innodb_flush_log_at_trx_commit = 1
innodb_online_alter_log_max_size = 268435456
max_prepared_stmt_count = 1048576
sort_buffer_size = '67108864'
sync_binlog = 1
```

W\&B는 이 설정의 성능과 안정성을 검증했습니다.

<h3 id="database-creation">
  데이터베이스 생성
</h3>

데이터베이스를 자동으로 프로비저닝하는 관리형 MySQL 서비스를 사용하지 않는다면, 다음 지침에 따라 W\&B Server가 사용할 MySQL 데이터베이스와 사용자를 직접 생성하세요.

다음 SQL 명령어를 사용하여 데이터베이스와 사용자를 생성하세요. `[PASSWORD]`를 안전한 비밀번호로 교체하세요:

```sql theme={"system"}
CREATE USER 'wandb_local'@'%' IDENTIFIED BY '[PASSWORD]';
CREATE DATABASE wandb_local CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
GRANT ALL ON wandb_local.* TO 'wandb_local'@'%' WITH GRANT OPTION;
```

백업, 성능, 모니터링, 가용성 등 그 밖의 고려 사항은 [레퍼런스 아키텍처의 MySQL 섹션](/ko/products/wandb/platform/hosting/self-managed/ref-arch#mysql)을 참조하세요.

<h2 id="redis">
  Redis
</h2>

W\&B Server는 캐싱 및 백그라운드 작업 조정에 Redis를 사용합니다.

W\&B는 단일 노드 Redis 7.x 배포에 의존하며, W\&B의 컴포넌트는 작업 큐잉과 데이터 캐싱에 이를 사용합니다. 테스트 및 개념 증명 작업의 경우, W\&B Self-Managed에는 로컬 Redis 배포가 포함됩니다. 이 번들 배포는 프로덕션 용도로는 적합하지 않습니다.

프로덕션 배포의 경우, W\&B는 다음 환경의 Redis 인스턴스에 연결할 수 있습니다:

* [Amazon ElastiCache](https://aws.amazon.com/elasticache/)
* [Google Cloud Memorystore](https://cloud.google.com/memorystore?hl=en)
* [Azure Cache for Redis](https://azure.microsoft.com/en-us/products/cache)
* 클라우드 또는 온프레미스 인프라에서 자체 호스팅하는 Redis

W\&B는 다음 환경 중 어디에서 실행되는 Redis 인스턴스에든 연결할 수 있습니다.

* [AWS Elasticache](https://aws.amazon.com/pm/elasticache/).
* [Google Cloud Memory Store](https://cloud.google.com/memorystore?hl=en).
* [Azure Cache for Redis](https://azure.microsoft.com/en-us/products/cache).
* 사용자의 클라우드 또는 온프레미스 인프라에서 호스팅되는 Redis 배포.

<h2 id="clickhouse">
  ClickHouse
</h2>

Self-Managed 배포의 W\&B Weave는 ClickHouse를 사용합니다. 단, 모든 Self-Managed 설치에 ClickHouse가 필요한 것은 아닙니다.

W\&B Server를 업그레이드하거나 ClickHouse 버전을 변경하기 전에 Operator 가이드의 [업그레이드 시 ClickHouse 호환성](/ko/products/wandb/platform/hosting/self-managed/operator#clickhouse-compatibility-for-upgrades)과 [지원되는 W\&B Server 릴리스](/ko/release-notes/server-releases)의 호환성 참고 사항을 확인하세요.

배포 절차는 [Self-Managed 환경에 Weave 배포하기](/ko/products/wandb/weave/guides/platform/weave-self-managed)를 참조하세요.

<h2 id="object-storage">
  오브젝트 스토리지
</h2>

W\&B Server에서 아티팩트, 미디어, run 데이터를 저장하려면 오브젝트 스토리지 버킷이 필요합니다.

W\&B를 사용하려면 사전 서명된 URL과 CORS를 지원하는 오브젝트 스토리지가 필요합니다.

W\&B에서 권장하는 스토리지 공급자는 다음과 같습니다.

* [Amazon S3](https://aws.amazon.com/s3/): 확장성, 데이터 가용성, 보안, 성능을 제공하는 오브젝트 스토리지 서비스입니다.
* [Google Cloud Storage](https://cloud.google.com/storage): 대규모 비정형 데이터를 저장하기 위한 관리형 서비스입니다.
* [Azure Blob Storage](https://azure.microsoft.com/en-us/products/storage/blobs): 대규모 비정형 데이터를 위한 클라우드 기반 오브젝트 스토리지입니다.
* [CoreWeave AI Object Storage](/products/storage/object-storage): AI 워크로드에 최적화된 S3 호환 오브젝트 스토리지입니다.
* [MinIO Enterprise (AIStor)](https://www.min.io/product/aistor), [NetApp StorageGRID](https://www.netapp.com/data-storage/storagegrid/) 등의 엔터프라이즈 S3 호환 저장소 또는 기타 엔터프라이즈 솔루션

<Note>
  MinIO 오픈 소스는 [유지 관리 모드](https://github.com/minio/minio)로 전환되어 더 이상 활발히 개발되지 않으며, 사전 컴파일된 바이너리도 제공되지 않습니다. 프로덕션 배포에는 관리형 오브젝트 스토리지 서비스나 MinIO Enterprise (AIStor) 같은 엔터프라이즈 S3 호환 솔루션을 사용할 것을 권장합니다.
</Note>

공급자를 선택했다면 W\&B가 액세스할 수 있도록 버킷을 설정하세요. IAM 정책, CORS 설정, 액세스 설정 등 버킷 프로비저닝에 대한 자세한 방법은 [Bring Your Own Bucket (BYOB) 가이드](/ko/products/wandb/platform/hosting/data-security/secure-storage-connector)를 참조하세요.

용량 및 성능 가이드를 비롯한 오브젝트 스토리지 요구 사항의 전체 목록은 [레퍼런스 아키텍처의 오브젝트 스토리지 섹션](/ko/products/wandb/platform/hosting/self-managed/ref-arch#object-storage)을 참조하세요.

<h3 id="provision-your-storage-bucket">
  저장소 버킷 프로비저닝
</h3>

W\&B를 설정하기 전에 오브젝트 저장소 버킷을 프로비저닝하고 필수 IAM 정책, CORS 설정, 액세스 자격 증명을 구성해야 합니다.

다음 항목별 프로비저닝 절차는 [Bring Your Own Bucket (BYOB) 가이드](/ko/products/wandb/platform/hosting/data-security/secure-storage-connector)에서 단계별로 자세히 확인하세요.

* Amazon S3 (IAM 정책 및 버킷 정책 포함)
* Google Cloud Storage (PubSub 알림 포함)
* Azure Blob Storage (관리 ID 포함)
* CoreWeave AI Object Storage
* S3 호환 저장소 (MinIO Enterprise, NetApp StorageGRID 및 기타 엔터프라이즈 솔루션)

<h3 id="configure-wb-to-use-your-bucket">
  버킷을 사용하도록 W\&B 설정하기
</h3>

버킷을 프로비저닝한 후에는 W\&B Server가 버킷에서 데이터를 읽고 쓸 수 있도록 Operator의 Helm values에서 해당 버킷을 사용하도록 W\&B를 설정해야 합니다. 자세한 내용은 [Operator 오브젝트 스토리지 설정 섹션](/ko/products/wandb/platform/hosting/self-managed/operator#object-storage-bucket)을 참조하세요.

<h2 id="networking">
  네트워킹
</h2>

네트워킹 설정을 통해 사용자와 머신러닝 워크로드가 W\&B Server에 접근할 수 있습니다. 다음 섹션에서는 DNS, 로드 밸런서, ingress 요구 사항을 설명합니다.

네트워크에 연결된 배포에서는 설치 시와 런타임 모두 다음 엔드포인트로의 이그레스(egress) 트래픽을 허용하세요.

* `https://deploy.wandb.ai`
* `https://charts.wandb.ai`
* `https://quay.io` (Prometheus 이미지에 사용)

<Note>
  배포 설정에 따라 추가 컨테이너 레지스트리가 필요할 수 있습니다.

  * Weave 온라인 평가를 위해 Bufstream과 etcd를 배포하는 경우: `https://gcr.io`
</Note>

에어갭 배포에 대한 자세한 내용은 [에어갭 인스턴스용 Kubernetes operator](/ko/products/wandb/platform/hosting/self-managed/on-premises-deployments/kubernetes-airgapped)를 참고하세요.

트레이닝 인프라와 각 실험 추적 시스템이 W\&B 및 오브젝트 저장소에 액세스할 수 있도록 권한을 부여하세요.

<h3 id="dns">
  DNS
</h3>

W\&B 배포의 완전 수식된 도메인 이름(FQDN)은 A 레코드를 통해 ingress 또는 로드 밸런서의 IP 주소로 확인되어야 합니다.

<h3 id="load-balancer-and-ingress">
  로드 밸런서 및 ingress
</h3>

W\&B Kubernetes Operator는 Kubernetes ingress 컨트롤러를 사용해 서비스를 노출하며, 이 컨트롤러는 URL 경로에 따라 트래픽을 서비스 엔드포인트로 라우팅합니다. 머신러닝 페이로드를 실행하거나 웹 브라우저로 서비스에 액세스하는 모든 머신에서 ingress 컨트롤러에 액세스할 수 있어야 합니다.

로드 밸런서 옵션, ingress 컨트롤러 요구 사항, 설정 예시에 대한 자세한 내용은 [레퍼런스 아키텍처의 로드 밸런서 섹션](/ko/products/wandb/platform/hosting/self-managed/ref-arch#load-balancer-and-ingress)을 참조하세요.

<h2 id="ssltls">
  SSL/TLS
</h2>

W\&B는 클라이언트와 서버 간의 보안 통신을 위해 유효한 서명된 SSL/TLS 인증서가 필요합니다. SSL/TLS 종료는 ingress 또는 로드 밸런서에서 이루어져야 합니다. W\&B Server 애플리케이션은 SSL 또는 TLS 연결을 종료하지 않습니다.

<Warning>
  W\&B는 자체 서명된 인증서 또는 맞춤형 CA를 지원하지 않습니다. 자체 서명된 인증서는 사용자에게 문제를 일으키며 지원되지 않습니다.
</Warning>

가능하면 [Let's Encrypt](https://letsencrypt.org)와 같은 서비스를 사용하여 로드 밸런서에 신뢰할 수 있는 인증서를 제공하세요. Caddy 및 Cloudflare와 같은 서비스는 SSL을 관리해 줍니다.

보안 정책에서 신뢰할 수 있는 네트워크 내에서 SSL 통신이 필요한 경우, Istio 및 [sidecar containers](https://istio.io/latest/docs/reference/config/networking/sidecar/)와 같은 도구 사용을 고려하세요.

<h2 id="license">
  라이선스
</h2>

모든 Self-Managed 배포에는 유효한 W\&B Server 라이선스가 필요합니다. 라이선스가 없으면 W\&B Server가 시작되지 않습니다.

W\&B Self-Managed를 배포하려면 W\&B 라이선스가 필요합니다. 이 절차는 라이선스를 획득하는 방법을 보여줍니다.

1. W\&B 계정이 없다면 계정을 만드세요.
2. 기업용 평가판 라이선스가 필요하다면, [요청을 제출하세요](https://wandb.ai/site/for-enterprise/self-hosted-trial) 또는 담당 W\&B 팀에 문의하세요. 기업용 평가판 라이선스는 중요한 보안 및 기타 엔터프라이즈 친화적 기능에 대한 지원을 포함합니다.
3. 그렇지 않으면 무료 평가판 라이선스를 생성하기 위해 [Deploy Manager](https://deploy.wandb.ai/deploy)를 여세요. URL은 **W\&B Local용 라이선스 조회** 양식으로 리디렉션됩니다. 다음 정보를 제공하세요:
   * 라이선스 소유자.
   * 배포 유형.
   * 인스턴스의 이름과 선택적 설명.
4. **라이선스 키 생성**을 클릭하세요.

배포 개요와 연결된 라이선스가 있는 페이지가 나타납니다.

<h2 id="next-steps">
  다음 단계
</h2>

인프라가 이러한 요구 사항을 충족하는지 확인한 후, 사용 중인 환경에 맞는 배포 가이드를 진행하세요.

* **클라우드 및 온프레미스 배포**: Helm 및 Terraform 배포 옵션은 [Kubernetes Operator로 W\&B 배포](/ko/products/wandb/platform/hosting/self-managed/operator)를 참조하세요.
* **에어갭 배포**: 네트워크가 분리된 환경에서는 [에어갭 Kubernetes에 배포](/ko/products/wandb/platform/hosting/self-managed/on-premises-deployments/kubernetes-airgapped)를 참조하세요.
* **모든 배포 방법**: 기본 operator 배포 가이드는 [Kubernetes Operator로 배포](/ko/products/wandb/platform/hosting/self-managed/operator)를 참조하세요.
