NodePool 생성

VPC 환경에서 이용 가능합니다.

클러스터 안에 워커 노드의 개수, 사양 등을 설정하는 노드풀을 생성합니다.

요청

요청 형식을 설명합니다. 요청 형식은 다음과 같습니다.

메서드	URI
POST	/clusters/{uuid}/node-pool

요청 헤더

Ncloud Kubernetes Service API에서 공통으로 사용하는 헤더에 대한 자세한 내용은 Ncloud Kubernetes Service 공통 헤더를 참조해 주십시오.

요청 경로 파라미터

파라미터에 대한 설명은 다음과 같습니다.

필드	타입	필수 여부	설명
`uuid`	String	Required	클러스터의 UUID 클러스터 목록 조회를 통해 확인

요청 구문

요청 구문은 다음과 같습니다.

{
  "name": "np4",
  "nodeCount": 2,
  "softwareCode": "SW.VSVR.OS.LNX64.UBNTU.SVR22.WRKND.G003",
  "serverSpecCode": "s2-g3",
  "storageSize": 100,
  "autoscale": {
    "enabled": false,
    "max": 3,
    "min": 1
  },
  "labels": [
    {
      "key": "label_key",
      "value": "value"
    }
  ],
  "taints": [
    {
      "key": "taints_key",
      "value": "value",
      "effect": "NoExecute"
    }
  ],
  "serverRoleId": "string"

}

요청 바디

요청 바디에 대한 설명은 다음과 같습니다.

필드	타입	필수 여부	설명
`name`	String	Required	노드풀 이름
`nodeCount`	Integer	Required	등록될 노드 개수 1~250
`softwareCode`	String	Optional	서버 이미지 코드
`serverSpecCode`	String	Optional	서버 스펙 코드
`storageSize`	Integer	Optional	스토리지 크기
`autoscale`	Array	Optional	오토스케일 옵션
`autoscale.enabled`	Boolean	Optional	오토스케일 가능 여부 `true` \| `false` `true`: 오토스케일 사용 `false`: 오토스케일 사용 안 함
`autoscale.max`	Integer	Optional	오토스케일 가능 최대 노드 수 250 이하
`autoscale.min`	Integer	Optional	오토스케일 가능 최소 노드 수 1 이상
`labels[]`	Array	Optional	노드풀에 속한 모든 노드에 적용할 레이블
`labels[].key`	String	Conditional	레이블의 키 레이블 설정 시 필수
`labels[].value`	String	Conditional	레이블의 값 레이블 설정 시 필수
`taints[]`	Array	Optional	스케줄러가 특정 파드의 노드를 사용하지 않도록 관리
`taints[].key`	String	Conditional	taint의 키 taint 설정 시 필수
`taints[].value`	String	Optional	taint의 값 taint 설정 시에도 선택 입력
`taints[].effect`	String	Conditional	스케줄러 관리 방식 `NoSchedule` \| `PreferNoSchedule` \| `NoExecute` taint 설정 시 필수
`serverRoleId`	String	Optional	노드풀 서버의 역할을 부여하기 위한 ID 콘솔 또는 Role 목록 조회 액션을 통해 확인

요청 예시

요청 예시는 다음과 같습니다.

curl --location 'https://nks.apigw.gov-ntruss.com/vnks/v2/clusters/{uuid}/node-pool' \
--header 'x-ncp-apigw-timestamp: {timestamp}' \
--header 'x-ncp-iam-access-key: {access key}' \
--header 'x-ncp-apigw-signature-v2: {API gateway signature}' \
--data '{
  "name": "np4",
  "nodeCount": 2,
  "softwareCode": "SW.VSVR.OS.LNX64.UBNTU.SVR22.WRKND.G003",
  "serverSpecCode": "s2-g3",
  "storageSize": 100,
  "autoscale": {
    "enabled": true,
    "max": 2,
    "min": 1
  },
  "labels": [
    {
      "key": "label_key",
      "value": "value"
    }
  ],
  "taints": [
    {
      "key": "taints_key",
      "value": "value",
      "effect": "NoExecute"
    }
  ]
}'

응답

응답 형식을 설명합니다.

응답 상태 코드

Ncloud Kubernetes Service API에서 공통으로 사용하는 응답 상태 코드에 대한 자세한 내용은 Ncloud Kubernetes Service 응답 상태 코드를 참조해 주십시오.