33.2. MetalLB Operator 설치
클러스터 관리자는 Operator가 클러스터에서 MetalLB 인스턴스의 라이프사이클을 관리할 수 있도록 MetallB Operator를 추가할 수 있습니다.
MetalLB 및 IP 페일오버가 호환되지 않습니다. 클러스터에 IP 페일오버를 구성한 경우 Operator를 설치하기 전에 IP 페일오버를 제거하는 단계를 수행합니다.
33.2.1. 웹 콘솔을 사용하여 OperatorHub에서 MetalLB Operator 설치
클러스터 관리자는 OpenShift Container Platform 웹 콘솔을 사용하여 MetalLB Operator를 설치할 수 있습니다.
사전 요구 사항
-
cluster-admin
권한이 있는 사용자로 로그인합니다.
절차
-
OpenShift Container Platform 웹 콘솔에서 Operator
OperatorHub로 이동합니다. 키워드로 필터링 상자에 키워드 를 입력하거나 원하는 Operator를 찾습니다. 예를 들어
metallb
를 입력하여 MetalLB Operator를 찾습니다.인프라 기능에서 옵션을 필터링할 수 있습니다. 예를 들어, 연결이 끊긴 환경 (제한된 네트워크 환경이라고도 함)에서 작업하는 Operator를 표시하려면 Disconnected를 선택합니다.
- Operator 설치 페이지에서 기본값을 수락하고 설치를 클릭합니다.
검증
설치에 성공했는지 확인하려면 다음을 수행하십시오.
-
Operator
설치된 Operator 페이지로 이동합니다. -
Operator가
openshift-operators
네임스페이스에 설치되어 있고 해당 상태가Succeeded
인지 확인합니다.
-
Operator
Operator가 성공적으로 설치되지 않은 경우 Operator 상태를 확인하고 로그를 확인합니다.
-
Operator
설치된 Operator 페이지로 이동하여 Status
열에 오류 또는 실패가 있는지 점검합니다. -
워크로드
Pod 페이지로 이동하여 openshift-operators
프로젝트에서 문제를 보고하는 Pod의 로그를 확인합니다.
-
Operator
33.2.2. CLI를 사용하여 OperatorHub에서 설치
OpenShift Container Platform 웹 콘솔을 사용하는 대신 CLI를 사용하여 OperatorHub에서 Operator를 설치할 수 있습니다. OpenShift CLI(oc
)를 사용하여 MetalLB Operator를 설치할 수 있습니다.
Operator를 metallb-system
네임스페이스에 설치하는 CLI를 사용하는 것이 좋습니다.
사전 요구 사항
- 클러스터가 베어 메탈 하드웨어에 설치되어 있어야 합니다.
-
OpenShift CLI(
oc
)를 설치합니다. -
cluster-admin
권한이 있는 사용자로 로그인합니다.
절차
다음 명령을 입력하여 MetalLB Operator의 네임스페이스를 생성합니다.
$ cat << EOF | oc apply -f - apiVersion: v1 kind: Namespace metadata: name: metallb-system EOF
네임스페이스에 Operator group CR(사용자 정의 리소스)을 생성합니다.
$ cat << EOF | oc apply -f - apiVersion: operators.coreos.com/v1 kind: OperatorGroup metadata: name: metallb-operator namespace: metallb-system EOF
Operator group이 네임스페이스에 설치되어 있는지 확인합니다.
$ oc get operatorgroup -n metallb-system
출력 예
NAME AGE metallb-operator 14m
서브스크립션
CR을 생성합니다.Subscription
CR을 정의하고 YAML 파일(예:metallb-sub.yaml
)을 저장합니다.apiVersion: operators.coreos.com/v1alpha1 kind: Subscription metadata: name: metallb-operator-sub namespace: metallb-system spec: channel: stable name: metallb-operator source: redhat-operators 1 sourceNamespace: openshift-marketplace
- 1
redhat-operators
값을 지정해야 합니다.
서브스크립션
CR을 생성하려면 다음 명령을 실행합니다.$ oc create -f metallb-sub.yaml
선택 사항: BGP 및 BFD 지표가 Prometheus에 표시되도록 하려면 다음 명령과 같이 네임스페이스에 라벨을 지정할 수 있습니다.
$ oc label ns metallb-system "openshift.io/cluster-monitoring=true"
검증
확인 단계에서는 MetalLB Operator가 metallb-system
네임스페이스에 설치되어 있다고 가정합니다.
설치 계획이 네임스페이스에 있는지 확인합니다.
$ oc get installplan -n metallb-system
출력 예
NAME CSV APPROVAL APPROVED install-wzg94 metallb-operator.4.13.0-nnnnnnnnnnnn Automatic true
참고Operator를 설치하는 데 몇 초가 걸릴 수 있습니다.
Operator가 설치되었는지 확인하려면 다음 명령을 입력합니다.
$ oc get clusterserviceversion -n metallb-system \ -o custom-columns=Name:.metadata.name,Phase:.status.phase
출력 예
Name Phase metallb-operator.4.13.0-nnnnnnnnnnnn Succeeded
33.2.3. 클러스터에서 MetalLB 시작
Operator를 설치한 후 MetalLB 사용자 정의 리소스의 단일 인스턴스를 구성해야 합니다. 사용자 정의 리소스를 구성한 후 Operator는 클러스터에서 MetalLB를 시작합니다.
사전 요구 사항
-
OpenShift CLI(
oc
)를 설치합니다. -
cluster-admin
권한이 있는 사용자로 로그인합니다. - MetalLB Operator를 설치합니다.
절차
이 절차에서는 MetalLB Operator가 metallb-system
네임스페이스에 설치되어 있다고 가정합니다. 웹 콘솔을 사용하여 설치한 경우 네임스페이스의 openshift-operators
를 대체합니다.
MetalLB 사용자 지정 리소스의 단일 인스턴스를 생성합니다.
$ cat << EOF | oc apply -f - apiVersion: metallb.io/v1beta1 kind: MetalLB metadata: name: metallb namespace: metallb-system EOF
검증
MetalLB 컨트롤러 및 MetalLB 발표자의 데몬 세트가 실행 중인지 확인합니다.
컨트롤러의 배포가 실행 중인지 확인합니다.
$ oc get deployment -n metallb-system controller
출력 예
NAME READY UP-TO-DATE AVAILABLE AGE controller 1/1 1 1 11m
speaker의 데몬 세트가 실행 중인지 확인합니다.
$ oc get daemonset -n metallb-system speaker
출력 예
NAME DESIRED CURRENT READY UP-TO-DATE AVAILABLE NODE SELECTOR AGE speaker 6 6 6 6 6 kubernetes.io/os=linux 18m
예제 출력은 6개의 발표자 pod를 나타냅니다. 클러스터의 발표자 Pod 수는 예제 출력과 다를 수 있습니다. 출력에 클러스터의 각 노드에 하나의 pod가 표시되는지 확인합니다.
33.2.4. MetalLB의 배포 사양
MetalLB
사용자 정의 리소스를 사용하여 MetalLB의 인스턴스를 시작할 때 MetalLB
사용자 정의 리소스에서 배포 사양을 구성하여 컨트롤러
또는 발표자
Pod가 클러스터에서 배포 및 실행되는 방법을 관리할 수 있습니다. 이러한 배포 사양을 사용하여 다음 작업을 관리합니다.
- MetalLB Pod 배포로 노드를 선택합니다.
- Pod 우선순위 및 Pod 유사성을 사용하여 예약을 관리합니다.
- MetalLB Pod의 CPU 제한을 할당합니다.
- MetalLB Pod에 대한 컨테이너 RuntimeClass를 할당합니다.
- MetalLB Pod의 메타데이터를 할당합니다.
33.2.4.1. 발표자 Pod를 특정 노드로 제한
기본적으로 MetalLB Operator를 사용하여 MetalLB를 시작하면 Operator는 클러스터의 각 노드에서 speaker
Pod 인스턴스를 시작합니다. speaker
pod가 있는 노드만 로드 밸런서 IP 주소를 알릴 수 있습니다. 노드 선택기를 사용하여 MetalLB
사용자 정의 리소스를 구성하여 speaker
Pod를 실행하는 노드를 지정할 수 있습니다.
speaker
pod를 특정 노드로 제한하는 가장 일반적인 이유는 특정 네트워크의 네트워크 인터페이스가 있는 노드만 로드 밸런서 IP 주소를 알리는 것입니다. 실행 중인 speaker
pod가 있는 노드만 로드 밸런서 IP 주소의 대상으로 표시됩니다.
speaker
Pod를 특정 노드로 제한하고 서비스의 외부 트래픽 정책에 대해 local
을 지정하는 경우 서비스의 애플리케이션 Pod가 동일한 노드에 배포되었는지 확인해야 합니다.
발표자 Pod를 작업자 노드로 제한하는 구성 예
apiVersion: metallb.io/v1beta1 kind: MetalLB metadata: name: metallb namespace: metallb-system spec: nodeSelector: <.> node-role.kubernetes.io/worker: "" speakerTolerations: <.> - key: "Example" operator: "Exists" effect: "NoExecute"
<.> 예제 구성은 speaker Pod를 작업자 노드에 할당하도록 지정하지만 노드 또는 유효한 노드 선택기에 할당한 라벨을 지정할 수 있습니다. <.> 이 예제 구성에서는 Operator
를 사용하여 키
값 및 effect
값과 일치하는 테인트를 허용하도록 이 허용 오차가 연결된 Pod입니다.
spec.nodeSelector
필드를 사용하여 매니페스트를 적용한 후 oc get daemonset -n metallb-system speaker
명령을 사용하여 Operator가 배포한 Pod 수를 확인할 수 있습니다. 마찬가지로 oc get nodes -l node-role.kubernetes.io/worker=
와 같은 명령을 사용하여 레이블과 일치하는 노드를 표시할 수 있습니다.
선택 옵션으로 노드에서 선호도 규칙을 사용하여 예약해야 하는 발표자 Pod를 제어하도록 허용할 수 있습니다. 허용 오차 목록을 적용하여 이러한 Pod를 제한할 수도 있습니다. 유사성 규칙, 테인트 및 허용 오차에 대한 자세한 내용은 추가 리소스를 참조하십시오.
33.2.4.2. MetalLB 배포에서 Pod 우선순위 및 Pod 유사성 구성
필요한 경우 MetalLB
사용자 정의 리소스를 구성하여 컨트롤러
및 speaker
Pod에 Pod 우선순위 및 Pod 유사성 규칙을 할당할 수 있습니다. Pod 우선순위는 노드에서 Pod의 상대적 중요도를 나타내며 이 우선 순위에 따라 Pod를 예약합니다. 컨트롤러
또는 발표자
Pod에서 높은 우선 순위를 설정하여 노드의 다른 Pod보다 우선 순위를 유지합니다.
Pod 유사성은 Pod 간 관계를 관리합니다. 컨트롤러
또는 발표자
Pod에 Pod 유사성을 할당하여 스케줄러가 Pod 관계 컨텍스트에서 Pod를 배치하는 노드를 제어합니다. 예를 들어 Pod 유사성 규칙을 사용하여 특정 Pod가 동일한 노드 또는 노드에 위치하도록 할 수 있으므로 네트워크 통신을 개선하고 해당 구성 요소 간의 대기 시간을 줄일 수 있습니다.
사전 요구 사항
-
cluster-admin
권한이 있는 사용자로 로그인합니다. - MetalLB Operator가 설치되어 있습니다.
- 클러스터에서 MetalLB Operator를 시작했습니다.
절차
우선 순위 수준을 구성하기 위해
my
사용자 정의 리소스를 생성합니다. 이 예제에서는 값이PriorityClass
.yaml과 같은 PriorityClass1000000
인high-priority
라는PriorityClass
를 정의합니다. 이 우선순위 클래스가 할당된 Pod는 우선순위가 낮은 Pod에 비해 예약 중에 더 높은 우선 순위로 간주됩니다.apiVersion: scheduling.k8s.io/v1 kind: PriorityClass metadata: name: high-priority value: 1000000
PriorityClass
사용자 정의 리소스 구성을 적용합니다.$ oc apply -f myPriorityClass.yaml
MetalLB
PodConfig.yamlpriorityClassName
및podAffinity
값을 지정합니다.apiVersion: metallb.io/v1beta1 kind: MetalLB metadata: name: metallb namespace: metallb-system spec: logLevel: debug controllerConfig: priorityClassName: high-priority 1 affinity: podAffinity: 2 requiredDuringSchedulingIgnoredDuringExecution: - labelSelector: matchLabels: app: metallb topologyKey: kubernetes.io/hostname speakerConfig: priorityClassName: high-priority affinity: podAffinity: requiredDuringSchedulingIgnoredDuringExecution: - labelSelector: matchLabels: app: metallb topologyKey: kubernetes.io/hostname
MetalLB
사용자 정의 리소스 구성을 적용합니다.$ oc apply -f MetalLBPodConfig.yaml
검증
metallb-system
네임스페이스에서 Pod에 할당한 우선순위 클래스를 보려면 다음 명령을 실행합니다.$ oc get pods -n metallb-system -o custom-columns=NAME:.metadata.name,PRIORITY:.spec.priorityClassName
출력 예
NAME PRIORITY controller-584f5c8cd8-5zbvg high-priority metallb-operator-controller-manager-9c8d9985-szkqg <none> metallb-operator-webhook-server-c895594d4-shjgx <none> speaker-dddf7 high-priority
스케줄러가 Pod 유사성 규칙에 따라 Pod를 배치했는지 확인하려면 다음 명령을 실행하여 Pod 노드 또는 노드의 메타데이터를 확인합니다.
$ oc get pod -o=custom-columns=NODE:.spec.nodeName,NAME:.metadata.name -n metallb-system
33.2.4.3. MetalLB 배포에서 Pod CPU 제한 구성
필요한 경우 MetalLB
사용자 정의 리소스를 구성하여 컨트롤러
및 발표
Pod에 Pod CPU 제한을 할당할 수 있습니다. 컨트롤러
또는 발표자
Pod에 대한 CPU 제한을 정의하면 노드에서 컴퓨팅 리소스를 관리할 수 있습니다. 이렇게 하면 노드의 모든 Pod에 워크로드 및 클러스터 하우스키핑을 관리하는 데 필요한 컴퓨팅 리소스가 있습니다.
사전 요구 사항
-
cluster-admin
권한이 있는 사용자로 로그인합니다. - MetalLB Operator가 설치되어 있습니다.
절차
CPULimits.yaml
과 같은MetalLB
사용자 정의 리소스 파일을 생성하여컨트롤러
및발표자
Pod의cpu
값을 지정합니다.apiVersion: metallb.io/v1beta1 kind: MetalLB metadata: name: metallb namespace: metallb-system spec: logLevel: debug controllerConfig: resources: limits: cpu: "200m" speakerConfig: resources: limits: cpu: "300m"
MetalLB
사용자 정의 리소스 구성을 적용합니다.$ oc apply -f CPULimits.yaml
검증
Pod의 컴퓨팅 리소스를 보려면 다음 명령을 실행하여 <
pod_name
>을 대상 Pod로 교체합니다.$ oc describe pod <pod_name>