1.15. 배치 API (v1beta1)

1.15.1. 개요

이 문서는 Red Hat Advanced Cluster Management for Kubernetes의 배치 리소스에 대한 것입니다. 배치 리소스에는 생성, 쿼리, 삭제 및 업데이트의 네 가지 요청이 있습니다. placement는 배치 네임스페이스에 바인딩된 ManagedClusterSets에서 ManagedClusterSets 집합을 선택하는 규칙을 정의합니다. 이 배치에서 선택한 ManagedCluster를 나타내기 위해 cluster.open-cluster-management.io/placement={placement name} 레이블이 있는 PlacementDecisions 슬라이스가 생성됩니다.

1.15.1.1. 버전 정보

버전 : 2.12.0

1.15.1.2. URI 스키마

BasePath : /kubernetes/apis
Schemes : HTTPS

1.15.1.3. 태그

cluster.open-cluster-management.io : 배치 생성 및 관리

1.15.2. 경로

1.15.2.1. 모든 배치 쿼리

GET /cluster.open-cluster-management.io/v1beta1/namespaces/{namespace}/placement

1.15.2.1.1. 설명

자세한 내용은 배치를 쿼리합니다.

1.15.2.1.2. 매개 변수

유형	이름	설명	스키마
헤더	COOKIE 필요	권한 부여: Bearer {ACCESS_TOKEN}; ACCESS_TOKEN은 사용자 액세스 토큰입니다.	string

1.15.2.1.3. 응답

HTTP 코드	설명	스키마
200	성공	콘텐츠 없음
403	액세스 금지	콘텐츠 없음
404	리소스를 찾을 수 없음	콘텐츠 없음
500	내부 서비스 오류	콘텐츠 없음
503	서비스를 사용할 수 없음	콘텐츠 없음

1.15.2.1.4. 사용

placement/yaml

1.15.2.1.5. 태그

cluster.open-cluster-management.io

1.15.2.2. 배치 생성

POST /cluster.open-cluster-management.io/v1beta1/namespaces/{namespace}/placements

1.15.2.2.1. 설명

배치를 생성합니다.

1.15.2.2.2. 매개 변수

유형	이름	설명	스키마
헤더	COOKIE 필요	권한 부여: Bearer {ACCESS_TOKEN}; ACCESS_TOKEN은 사용자 액세스 토큰입니다.	string
본문	본문 필요	생성할 배치 바인딩을 설명하는 매개변수입니다.	배치

1.15.2.2.3. 응답

HTTP 코드	설명	스키마
200	성공	콘텐츠 없음
403	액세스 금지	콘텐츠 없음
404	리소스를 찾을 수 없음	콘텐츠 없음
500	내부 서비스 오류	콘텐츠 없음
503	서비스를 사용할 수 없음	콘텐츠 없음

1.15.2.2.4. 사용

placement/yaml

1.15.2.2.5. 태그

cluster.open-cluster-management.io

1.15.2.2.6. HTTP 요청의 예

1.15.2.2.6.1. 요청 본문

{
  "apiVersion" : "cluster.open-cluster-management.io/v1beta1",
  "kind" : "Placement",
  "metadata" : {
    "name" : "placement1",
    "namespace": "ns1"
  },
  "spec": {
    "predicates": [
      {
        "requiredClusterSelector": {
          "labelSelector": {
            "matchLabels": {
              "vendor": "OpenShift"
            }
          }
        }
      }
    ]
  },
  "status" : { }
}

1.15.2.3. 단일 배치 쿼리

GET /cluster.open-cluster-management.io/v1beta1/namespaces/{namespace}/placements/{placement_name}

1.15.2.3.1. 설명

자세한 내용은 단일 배치를 쿼리합니다.

1.15.2.3.2. 매개 변수

유형	이름	설명	스키마
헤더	COOKIE 필요	권한 부여: Bearer {ACCESS_TOKEN}; ACCESS_TOKEN은 사용자 액세스 토큰입니다.	string
경로	placement_name required	쿼리할 배치의 이름입니다.	string

1.15.2.3.3. 응답

HTTP 코드	설명	스키마
200	성공	콘텐츠 없음
403	액세스 금지	콘텐츠 없음
404	리소스를 찾을 수 없음	콘텐츠 없음
500	내부 서비스 오류	콘텐츠 없음
503	서비스를 사용할 수 없음	콘텐츠 없음

1.15.2.3.4. 태그

cluster.open-cluster-management.io

1.15.2.4. 배치 삭제

DELETE /cluster.open-cluster-management.io/v1beta1/namespaces/{namespace}/placements/{placement_name}

1.15.2.4.1. 설명

단일 배치를 삭제합니다.

1.15.2.4.2. 매개 변수

유형	이름	설명	스키마
헤더	COOKIE 필요	권한 부여: Bearer {ACCESS_TOKEN}; ACCESS_TOKEN은 사용자 액세스 토큰입니다.	string
경로	placement_name required	삭제할 배치의 이름입니다.	string

1.15.2.4.3. 응답

HTTP 코드	설명	스키마
200	성공	콘텐츠 없음
403	액세스 금지	콘텐츠 없음
404	리소스를 찾을 수 없음	콘텐츠 없음
500	내부 서비스 오류	콘텐츠 없음
503	서비스를 사용할 수 없음	콘텐츠 없음

1.15.2.4.4. 태그

cluster.open-cluster-management.io

1.15.3. 정의

1.15.3.1. 배치

이름	설명	스키마
apiVersion 필요	배치의 버전이 지정된 스키마입니다.	string
종류 필요	REST 리소스를 나타내는 문자열 값입니다.	string
메타데이터 필요	배치의 메타데이터입니다.	object
사양 필요	배치의 사양입니다.	spec

spec

이름	설명	스키마
clusterSets 선택 사항	`ManagedClusters 가 선택된 ManagedClusterSet의 서브 세트` 입니다. `ManagedClusterSet` 이 비어 있으면 `ManagedCluster` Sets가 배치 네임스페이스에 바인딩된 `ManagedClusterSets` 에서 선택됩니다. `ManagedClusterSet` 에 `ManagedClusters` 가 포함된 경우 이 하위 집합의 교집합에서`ManagedClusters` 가 선택됩니다. 선택한 `ManagedClusterSets` 는 배치 네임스페이스에 바인딩됩니다.	문자열 배열
numberOfClusters optional	선택할 `ManagedCluster` 수입니다.	정수(int32)
서술자 선택 사항	`ManagedClusters` 를 선택하는 클러스터 서술자의 하위 집합입니다. 조건부 논리는 또는 입니다.	clusterPredicate 배열
prioritizerPolicy optional	우선순위의 정책입니다.	prioritizerPolicy
허용 오차 선택 사항	허용하지만 필요하지 않은 값은 허용 오차가 일치하는 배치를 통해 특정 테인트가 있는 관리 클러스터를 선택할 수 있습니다.	톨러레이션 어레이

clusterPredicate

이름	설명	스키마
requiredClusterSelector optional	레이블 및 클러스터 클레임이 있는 `ManagedClusters` 를 선택하는 클러스터 선택기입니다.	clusterSelector

clusterSelector

이름	설명	스키마
labelSelector optional	라벨별 `ManagedClusters` 선택기입니다.	object
claimSelector optional	클레임에 의한 `ManagedCluster의` 선택기입니다.	clusterClaimSelector

clusterClaimSelector

이름	설명	스키마
matchExpressions optional	클러스터 클레임 선택기 요구 사항의 하위 집합입니다. 조건부 논리는 AND 입니다.	< object > array

prioritizerPolicy

이름	설명	스키마
모드 선택 사항	`Exact`,`Additive` 또는 "" 중 하나입니다. 기본값 ""은 `Additive` 입니다.	string
구성 선택 사항	prioritizer의 구성입니다.	prioritizerConfig 배열

prioritizerConfig

이름	설명	스키마
scoreCoordinate required	prioritizer 및 score 소스의 구성입니다.	scoreCoordinate
가중치 선택 사항	우선 순위 점수의 가중치입니다. 값은 [-10,10] 범위 내에 있어야 합니다.	int32

scoreCoordinate

이름	설명	스키마
유형 필수	우선순위가 있는 점수의 유형입니다. 유효한 값은 "builtIn" 또는 "AddOn"입니다.	string
builtIn optional	다음 옵션의 `BuiltIn` 우선순위의 이름: 1) 클러스터 간 결정의 균형 조정. 2) 안정화: 기존 결정이 안정화되었는지 확인합니다. 3) ResourceAllocatableCPU & ResourceAllocatableMemory: 할당 가능한 리소스를 기반으로 클러스터를 정렬합니다. 4) spread: 토폴로지에 균등하게 워크로드를 확장합니다.	string
addOn optional	type이 `AddOn` 인 경우`AddOn` 은 리소스 이름과 점수 이름을 정의합니다.	object

톨러레이션

이름	설명	스키마
키 선택 사항	허용 오차가 적용되는 테인트 키입니다. 비어있는 것은 모든 테인트 키와 일치함을 의미합니다.	string
Operator 선택 사항	값에 대한 키의 관계입니다. 유효한 연산자는 `Exists` 및 `Equal` 입니다. 기본값은 `Equal` 입니다.	string
값 선택 사항	톨러레이션과 일치하는 테인트 값입니다.	string
effect 선택 사항	일치시킬 테인트 효과입니다. 비어있는 것은 모든 테인트 효과와 일치하는 것을 의미합니다. 지정된 경우 허용되는 값은 `NoSelect`,`PreferNoSelect`, `NoSelectIfNew` 입니다.	string
tolerationSeconds 선택 사항	테인트가 허용되는 시간이며 그 후에는 테인트가 허용되지 않습니다. 기본값은 nil이며, 이는 테인트를 허용하는 기간에 대한 시간 제한이 없음을 나타냅니다.	int64