Skip to content

Commit 35aa2d6

Browse files
committed
Update outdated files dev-1.25-ko.1 (M22-M33)
1 parent e454944 commit 35aa2d6

12 files changed

+128
-823
lines changed

content/ko/docs/concepts/scheduling-eviction/resource-bin-packing.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -54,8 +54,8 @@ profiles:
5454
할당된 리소스의 구성된 기능에 따라 노드를 선호하게 한다. `NodeResourcesFit`점수 기능의
5555
`RequestedToCapacityRatio` 동작은 [scoringStrategy](/docs/reference/config-api/kube-scheduler-config.v1beta3/#kubescheduler-config-k8s-io-v1beta3-ScoringStrategy)필드를
5656
이용하여 제어할 수 있다.
57-
`scoringStrategy` 필드에서 `requestedToCapacityRatioParam`와 `resources`라는 두 개의 파라미터를
58-
구성할 수 있다. `requestedToCapacityRatioParam`파라미터의
57+
`scoringStrategy` 필드에서 `requestedToCapacityRatio`와 `resources`라는 두 개의 파라미터를
58+
구성할 수 있다. `requestedToCapacityRatio`파라미터의
5959
`shape`를 사용하면 `utilization`과 `score` 값을 기반으로
6060
최소 요청 혹은 최대 요청된 대로 기능을 조정할 수 있게 한다.
6161
`resources` 파라미터는 점수를 매길 때 고려할 리소스의 `name` 과
@@ -77,7 +77,7 @@ profiles:
7777
weight: 3
7878
- name: intel.com/bar
7979
weight: 3
80-
requestedToCapacityRatioParam:
80+
requestedToCapacityRatio:
8181
shape:
8282
- utilization: 0
8383
score: 0

content/ko/docs/concepts/scheduling-eviction/topology-spread-constraints.md

Lines changed: 68 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -48,7 +48,8 @@ weight: 40
4848

4949
## `topologySpreadConstraints` 필드
5050

51-
파드 API에 `spec.topologySpreadConstraints` 필드가 있다. 예시는 다음과 같다.
51+
파드 API에 `spec.topologySpreadConstraints` 필드가 있다. 이 필드는 다음과 같이
52+
쓰인다.
5253

5354
```yaml
5455
---
@@ -60,14 +61,18 @@ spec:
6061
# 토폴로지 분배 제약 조건을 구성한다.
6162
topologySpreadConstraints:
6263
- maxSkew: <integer>
63-
minDomains: <integer> # 선택 사항이며, v1.24에서 알파 기능으로 도입되었다.
64+
minDomains: <integer> # 선택 사항이며, v1.25에서 베타 기능으로 도입되었다.
6465
topologyKey: <string>
6566
whenUnsatisfiable: <string>
6667
labelSelector: <object>
68+
matchLabelKeys: <list> # 선택 사항이며, v1.25에서 알파 기능으로 도입되었다.
69+
nodeAffinityPolicy: [Honor|Ignore] # 선택 사항이며, v1.25에서 알파 기능으로 도입되었다.
70+
nodeTaintsPolicy: [Honor|Ignore] # 선택 사항이며, v1.25에서 알파 기능으로 도입되었다.
6771
### 파드의 다른 필드가 이 아래에 오게 된다.
6872
```
6973

70-
`kubectl explain Pod.spec.topologySpreadConstraints` 명령을 실행하여 이 필드에 대해 좀 더 알아볼 수 있다.
74+
`kubectl explain Pod.spec.topologySpreadConstraints` 명령을 실행하거나 파드에 관한 API 레퍼런스의
75+
[스케줄링](/docs/reference/kubernetes-api/workload-resources/pod-v1/#scheduling) 섹션을 참조해서 이 필드에 대해 좀 더 알아볼 수 있다.
7176

7277
### 분배 제약 조건 정의
7378

@@ -81,10 +86,10 @@ kube-scheduler가 어떻게 클러스터 내에서 기존 파드와의 관계를
8186

8287
- `whenUnsatisfiable: DoNotSchedule`을 선택했다면,
8388
`maxSkew`는 대상 토폴로지에서 일치하는 파드 수와
84-
_전역 최솟값(global minimum)_ (토폴로지 도메인에서 레이블 셀렉터와 일치하는 최소 파드 수)
89+
_전역 최솟값(global minimum)_ (적절한 도메인 내에서 일치하는 파드의 최소 수, 또는 적절한 도메인의 수가 `minDomains`보다 작은 경우에는 0)
8590
사이의 최대 허용 차이를 나타낸다.
86-
예를 들어, 3개의 존에 각각 2, 4, 5개의 일치하는 파드가 있으면,
87-
전역 최솟값은 2이며 시스템은 이 숫자를 `maxSkew`와 비교한다.
91+
예를 들어, 3개의 존에 각각 2, 2, 1개의 일치하는 파드가 있으면,
92+
`maxSkew`는 1로 설정되고 전역 최솟값은 1로 설정된다.
8893
- `whenUnsatisfiable: ScheduleAnyway`를 선택하면,
8994
스케줄러는 차이(skew)를 줄이는 데 도움이 되는 토폴로지에 더 높은 우선 순위를 부여한다.
9095

@@ -93,9 +98,8 @@ kube-scheduler가 어떻게 클러스터 내에서 기존 파드와의 관계를
9398
도메인의 노드가 노드 셀렉터에 매치되면 그 도메인은 적합한 도메인이다.
9499

95100
{{< note >}}
96-
`minDomains` 필드는 1.24에서 추가된 알파 필드이다.
97-
이를 사용하려면 `MinDomainsInPodToplogySpread`
98-
[기능 게이트](/ko/docs/reference/command-line-tools-reference/feature-gates/)를 활성화해야 한다.
101+
`minDomains` 필드는 1.25에서 기본적으로 사용하도록 설정된 베타 필드이다. 사용을 원하지 않을 경우
102+
`MinDomainsInPodToplogySpread` [기능 게이트](/ko/docs/reference/command-line-tools-reference/feature-gates/)를 비활성화한다.
99103
{{< /note >}}
100104

101105
- `minDomains` 값을 명시하는 경우, 이 값은 0보다 커야 한다.
@@ -108,10 +112,12 @@ kube-scheduler가 어떻게 클러스터 내에서 기존 파드와의 관계를
108112
이 값은 스케줄링에 영향을 미치지 않는다.
109113
- `minDomains`를 명시하지 않으면, 분배 제약 조건은 `minDomains`가 1이라고 가정하고 동작한다.
110114

111-
- **topologyKey**[노드 레이블](#node-labels)의 키(key)이다.
112-
만약 두 노드가 이 키로 레이블이 지정되고 레이블이 동일한 값을 가진다면,
113-
스케줄러는 두 노드를 같은 토폴로지에 있는 것으로 여기게 된다.
114-
스케줄러는 각 토폴로지 도메인에 균형잡힌 수의 파드를 배치하려고 시도한다.
115+
- **topologyKey**[노드 레이블](#node-labels)의 키(key)이다. 이 키와 동일한 값을 가진
116+
레이블이 있는 노드는 동일한 토폴로지에 있는 것으로 간주된다.
117+
토폴로지의 각 인스턴스(즉, <키, 값> 쌍)를 도메인이라고 한다. 스케줄러는
118+
각 도메인에 균형잡힌 수의 파드를 배치하려고 시도할 것이다.
119+
또한, 노드가 nodeAffinityPolicy 및 nodeTaintsPolicy의 요구 사항을 충족하는 도메인을
120+
적절한 도메인이라고 정의한다.
115121

116122
- **whenUnsatisfiable** 는 분산 제약 조건을 만족하지 않을 경우에 파드를 처리하는 방법을 나타낸다.
117123
- `DoNotSchedule`(기본값)은 스케줄러에 스케줄링을 하지 말라고 알려준다.
@@ -123,6 +129,54 @@ kube-scheduler가 어떻게 클러스터 내에서 기존 파드와의 관계를
123129
자세한 내용은
124130
[레이블 셀렉터](/ko/docs/concepts/overview/working-with-objects/labels/#레이블-셀렉터)를 참조한다.
125131

132+
- **matchLabelKeys** 는 분배도(spreading)가 계산될 파드를 선택하기 위한 파드 레이블
133+
키 목록이다. 키는 파드 레이블에서 값을 조회하는 데 사용되며, 이러한 키-값 레이블은 `labelSelector`와 AND 처리되어 들어오는 파드(incoming pod)에 대해 분배도가 계산될 기존 파드 그룹의 선택에 사용된다. 파드 레이블에 없는 키는 무시된다. null 또는 비어 있는 목록은 `labelSelector`와만 일치함을 의미한다.
134+
135+
`matchLabelKeys`를 사용하면, 사용자는 다른 리비전 간에 `pod.spec`을 업데이트할 필요가 없다. 컨트롤러/오퍼레이터는 다른 리비전에 대해 동일한 `label`키에 다른 값을 설정하기만 하면 된다. 스케줄러는 `matchLabelKeys`를 기준으로 값을 자동으로 가정할 것이다. 예를 들어 사용자가 디플로이먼트를 사용하는 경우, 디플로이먼트 컨트롤러에 의해 자동으로 추가되는 `pod-template-hash`로 키가 지정된 레이블을 사용함으로써 단일 디플로이먼트에서 서로 다른 리비전을 구별할 수 있다.
136+
137+
```yaml
138+
topologySpreadConstraints:
139+
- maxSkew: 1
140+
topologyKey: kubernetes.io/hostname
141+
whenUnsatisfiable: DoNotSchedule
142+
matchLabelKeys:
143+
- app
144+
- pod-template-hash
145+
```
146+
147+
{{< note >}}
148+
`matchLabelKeys` 필드는 1.25에서 추가된 알파 필드이다. 이 필드를 사용하려면
149+
`MatchLabelKeysInPodTopologySpread` [기능 게이트](/ko/docs/reference/command-line-tools-reference/feature-gates/)
150+
를 활성화시켜야 한다.
151+
{{< /note >}}
152+
153+
- **nodeAffinityPolicy**는 파드 토폴로지의 스프레드 스큐(spread skew)를 계산할 때
154+
파드의 nodeAffinity/nodeSelector를 다루는 방법을 나타낸다. 옵션은 다음과 같다.
155+
- Honor: nodeAffinity/nodeSelector와 일치하는 노드만 계산에 포함된다.
156+
- Ignore: nodeAffinity/nodeSelector는 무시된다. 모든 노드가 계산에 포함된다.
157+
158+
옵션의 값이 null일 경우, Honor 정책과 동일하게 동작한다.
159+
160+
{{< note >}}
161+
`nodeAffinityPolicy` 필드는 1.25에서 추가된 알파 필드이다. 이 필드를 사용하려면
162+
`NodeInclusionPolicyInPodTopologySpread` [기능 게이트](/ko/docs/reference/command-line-tools-reference/feature-gates/)
163+
를 활성화시켜야 한다.
164+
{{< /note >}}
165+
166+
- **nodeTaintsPolicy**는 파드 토폴로지의 스프레드 스큐(spread skew)를 계산할 때 노드 테인트(taint)를
167+
다루는 방법을 나타낸다. 옵션은 다음과 같다.
168+
- Honor: 테인트가 없는 노드, 그리고 노드가 톨러레이션이 있는 들어오는 파드(incoming pod)를 위한 테인트가 설정된
169+
노드가 포함된다.
170+
- Ignore: 노드 테인트는 무시된다. 모든 노드가 포함된다.
171+
172+
옵션의 값이 null일 경우, Ignore 정책과 동일하게 동작한다.
173+
174+
{{< note >}}
175+
`nodeTaintsPolicy` 필드는 1.25에서 추가된 알파 필드이다. 이 필드를 사용하려면
176+
`NodeInclusionPolicyInPodTopologySpread` [기능 게이트](/ko/docs/reference/command-line-tools-reference/feature-gates/)
177+
를 활성화시켜야 한다.
178+
{{< /note >}}
179+
126180
파드에 2개 이상의 `topologySpreadConstraint`가 정의되어 있으면,
127181
각 제약 조건은 논리 AND 연산으로 조합되며,
128182
kube-scheduler는 새로운 파드의 모든 제약 조건을 만족하는 노드를 찾는다.
@@ -557,6 +611,7 @@ profiles:
557611
예를 들어 노드 풀(또는 노드 그룹)이 0으로 스케일 다운되고,
558612
클러스터가 다시 스케일 업 되기를 기대하는 경우,
559613
해당 토폴로지 도메인은 적어도 1개의 노드가 존재하기 전에는 고려가 되지 않을 것이다.
614+
560615
이를 극복하기 위해, 파드 토폴로지 분배 제약 조건과
561616
전반적인 토폴로지 도메인 집합에 대한 정보를 인지하고 동작하는
562617
클러스터 오토스케일링 도구를 이용할 수 있다.

content/ko/docs/concepts/security/overview.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -58,6 +58,7 @@ IaaS 공급자 | 링크 |
5858
Alibaba Cloud | http://www.alibabacloud.com/trust-center |
5959
Amazon Web Services | http://aws.amazon.com/security/ |
6060
Google Cloud Platform | http://cloud.google.com/security/ |
61+
Huawei Cloud | http://www.huaweicloud.com/securecenter/overallsafety.html |
6162
IBM Cloud | http://www.ibm.com/cloud/security |
6263
Microsoft Azure | http://docs.microsoft.com/en-us/azure/security/azure-security |
6364
Oracle Cloud Infrastructure | http://www.oracle.com/security/ |

0 commit comments

Comments
 (0)