샌드박스 정책 설정하기

​

시작하기 전에

​

현재 정책 조회

cwic sandbox runner policy get prod-us-east-1

cwic sandbox runner policy describe prod-us-east-1

curl https://api.coreweave.com/v1/sandbox/managedRunners/prod-us-east-1 \
  -H "Authorization: Bearer $TOKEN"

​

정책 업데이트

cwic sandbox runner policy edit prod-us-east-1

cwic sandbox runner policy edit prod-us-east-1 -f policy.yaml

cwic sandbox runner get prod-us-east-1 -o json > runner.json
jq '.[0].policy' runner.json > policy.json

cwic sandbox runner policy edit prod-us-east-1 -f policy.json \
  --etag "$(jq -r '.[0].etag' runner.json)"

cwic sandbox runner policy edit prod-us-east-1 --print-template

cwic sandbox runner policy validate -f policy.yaml

curl -X PATCH "https://api.coreweave.com/v1/sandbox/managedRunners/prod-us-east-1?updateMask=policy" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "policy": {
      "displayName": "Shared agent pool",
      "constraints": {
        "resources": { "maxCpu": "8", "maxMemory": "32Gi", "requireLimits": true },
        "lifecycle": { "defaultLifetimeSeconds": 3600 }
      }
    },
    "etag": "[ETAG]"
  }'

• 수명은 정책이 아닌 플랫폼에 의해 제한됩니다. 정책은 생성 요청에서 수명을 생략할 때 사용되는 constraints.lifecycle.defaultLifetimeSeconds만 제공합니다. 플랫폼은 생성 시점에 최대값(현재 30일)을 초과하는 수명을 거부합니다. 이전 정책 버전에는 maxLifetimeSeconds 한도가 포함되어 있었으나, 현재 cwic는 이를 포함한 문서를 거부합니다.
• 설정된 정책은 지울 수 없습니다. 삭제 오퍼레이션이 없으며, API는 정책을 null로 설정하는 업데이트를 거부합니다. 보안 태세를 완화하려면 더 관대한 문서로 교체하세요.
• 정책 문서는 인코딩 후 256 KiB로 제한됩니다.

​

소스 IP로 Sandbox API 액세스 제한

1. 편집기에서 현재 정책을 엽니다.
   cwic sandbox runner policy edit prod-us-east-1
   
   편집기 모드는 문서를 열 때 조회한 etag를 유지합니다. 따라서 그 사이에 다른 Admin이 정책을 업데이트한 경우, 해당 변경 사항을 덮어쓰지 않고 충돌이 발생합니다.
2. 현재 정책의 최상위 수준에 다음 코드 조각을 추가합니다. 플레이스홀더를 클라이언트의 실제 공용 이그레스 CIDR로 바꾸세요. 클라이언트가 사용하지 않는 주소 체계는 생략하고, 나머지 정책 필드는 그대로 두세요.
   control_plane_access:
     source_ip_allowlist:
       cidrs:
         - "[PUBLIC-IPV4-CIDR]"
         - "[PUBLIC-IPV6-CIDR]"
   
3. 전체 문서를 저장하고 편집기를 종료합니다. API에서 etag가 오래되었다고 보고하면 현재 정책을 다시 열고 변경 사항을 다시 적용한 다음 저장하세요.

• source_ip_allowlist가 없으면 소스 주소 제한이 적용되지 않습니다.
• 허용 목록이 있으면 관찰된 소스 주소가 하나 이상의 CIDR과 일치해야 합니다.
• 0.0.0.0/0은 모든 IPv4 주소를, ::/0은 모든 IPv6 주소를 허용합니다.
• 입력은 정규화 전 기준으로 CIDR 256개, CIDR 텍스트 16KiB로 제한됩니다. API는 프리픽스를 정규화하고, 중복 항목을 제거하며, 더 넓은 범위의 항목에 포함되는 프리픽스를 제거합니다.

​

정책 변경과 요청 동작

​

제한 없는 소스 액세스 복원

​

새 러너에 대한 기본 정책 설정

• 기본값은 연결이 아닌 스냅샷입니다. 러너에 한 번 적용되면 해당 정책은 일반 러너 정책이 됩니다. 이후 default_runner_policy를 변경해도 이미 정책이 있는 러너에는 반영되지 않습니다. 이러한 러너는 UpdateManagedRunner로 업데이트하세요.
• 기본값이 유효하지 않으면 샌드박스를 생성할 수 없습니다. 게이트웨이는 시작 시 설정된 정책을 검증합니다. 검증에 실패해도 게이트웨이는 시작되지만, 샌드박스 생성은 CWSANDBOX_SERVERLESS_MISCONFIGURED 오류와 함께 실패합니다.

​

컴퓨트 제한

{
  "constraints": {
    "resources": {
      "minCpu": "500m",
      "maxCpu": "8",
      "defaultCpu": "2",
      "minMemory": "1Gi",
      "maxMemory": "32Gi",
      "defaultMemory": "4Gi",
      "maxGpuCount": "2",
      "requireLimits": true
    }
  }
}

​

이미지 제한

{
  "constraints": {
    "image": {
      "allowedRegistries": ["ghcr.io/[GITHUB-ORG]"],
      "allowedImages": ["ghcr.io/[GITHUB-ORG]/agent-base:2024.11"]
    }
  }
}

​

네트워크 액세스 제한

• allowedEgress는 이그레스 허용 목록이며, 샌드박스가 생성될 때 확인됩니다. 비어 있지 않은 경우, 샌드박스가 선언하는 모든 규칙은 그 안에 맞아야 하며, 범위를 벗어나는 규칙은 거부되며 좁혀지지 않습니다. 비어 있으면 무엇이든 선언할 수 있습니다.
• defaultEgress는 요청이 없을 때의 의미입니다. 샌드박스가 자체 이그레스를 선언하지 않고 deny_egress도 설정하지 않은 경우에만 적용됩니다. 어떤 선언이든 이를 완전히 대체합니다.

{
  "constraints": {
    "network": {
      "allowedEgress": [
        { "cidr": { "cidr": "0.0.0.0/0", "except": ["10.0.0.0/8", "169.254.169.254/32"] } },
        { "tenant": "TENANT_SCOPE_SAME_ORG" }
      ],
      "defaultEgress": [
        { "tenant": "TENANT_SCOPE_SAME_ORG" }
      ]
    }
  }
}

​

보안 태세 제한

{
  "constraints": {
    "security": {
      "allowPrivileged": false,
      "allowedCapabilities": ["NET_BIND_SERVICE"],
      "allowedSeccompProfiles": ["RuntimeDefault"],
      "allowedRuntimeClasses": ["kata-qemu"],
      "defaultCpuRuntimeClass": "kata-qemu"
    }
  }
}

​

인스턴스, 수명, 메타데이터, 볼륨 제한

{
  "constraints": {
    "lifecycle": { "defaultLifetimeSeconds": 3600 },
    "volumes": { "allowedMedia": ["STORAGE_MEDIUM_DISK"], "maxSize": "100Gi" }
  }
}

​

기본 레이어

​

다음 단계

• 정책 개요: 샌드박스가 정책에 따라 어떻게 해결되는지, 그리고 프로필에서 변경된 사항.
• 러너 배포 및 관리: 러너 라이프사이클과 나머지 러너 설정.
• 컨트롤 플레인 API 개요: 인증, 필드 마스크, 그리고 엔드포인트 계약.