34.5. IP 주소 풀 광고 정보

IP 주소가 계층 2 프로토콜, BGP 프로토콜 또는 둘 다로 알려지도록 MetalLB를 구성할 수 있습니다. 계층 2에서 MetalLB는 내결함성 외부 IP 주소를 제공합니다. BGP를 사용하면 MetalLB는 외부 IP 주소 및 로드 밸런싱에 대한 내결함성을 제공합니다.

MetalLB는 동일한 IP 주소 세트에 L2 및 BGP를 사용한 알림을 지원합니다.

MetalLB는 특정 BGP 피어에 주소 풀을 네트워크 상의 노드 서브 세트에 효과적으로 할당할 수 있는 유연성을 제공합니다. 이를 통해 더 복잡한 구성(예: 노드의 격리 또는 네트워크 분할)이 가능합니다.

34.5.1. BGPAdvertisement 사용자 정의 리소스 정보

BGPAdvertisements 오브젝트의 필드는 다음 표에 정의되어 있습니다.

표 34.3. BGPAdvertisements 구성

필드유형설명

metadata.name

string

BGP 알림의 이름을 지정합니다.

metadata.namespace

string

BGP 알림의 네임스페이스를 지정합니다. MetalLB Operator에서 사용하는 동일한 네임스페이스를 지정합니다.

spec.aggregationLength

integer

선택 사항: 32비트 CIDR 마스크에 포함할 비트 수를 지정합니다. 발표자가 BGP 피어에 알리는 경로를 집계하기 위해 마스크는 여러 서비스 IP 주소의 경로에 적용되며, 발표자는 집계된 경로를 알립니다. 예를 들어 집계 길이가 24 인 경우 발표자는 여러 10.0.1.x/32 서비스 IP 주소를 집계하고 단일 10.0.1.0/24 경로를 알릴 수 있습니다.

spec.aggregationLengthV6

integer

선택 사항: 128비트 CIDR 마스크에 포함할 비트 수를 지정합니다. 예를 들어 집계 길이가 124 인 경우 발표자는 여러 fc00:f853:0ccd:e799::x/128 서비스 IP 주소를 집계하고 단일 fc00:f853:0ccd:e799::0/124 경로를 알릴 수 있습니다.

spec.communities

string

선택 사항: 하나 이상의 BGP 커뮤니티를 지정합니다. 각 커뮤니티는 콜론 문자로 구분된 두 개의 16비트 값으로 지정됩니다. 잘 알려진 커뮤니티는 16비트 값으로 지정해야 합니다.

  • NO_EXPORT: 65535:65281
  • NO_ADVERTISE: 65535:65282
  • NO_EXPORT_SUBCONFED: 65535:65283

    참고

    문자열과 함께 생성된 커뮤니티 오브젝트를 사용할 수도 있습니다.

spec.localPref

integer

선택 사항: 이 알림의 로컬 기본 설정을 지정합니다. 이 BGP 속성은 Autonomous System 내의 BGP 세션에 적용됩니다.

spec.ipAddressPools

string

선택 사항: 이 광고와 함께 광고할 IPAddressPools 목록(이름으로 선택됨).

spec.ipAddressPoolSelectors

string

선택 사항: 이 광고와 함께 알리는 IPAddressPools 의 선택기입니다. 이름 자체 대신 IPAddressPool 에 할당된 레이블을 기반으로 IPAddressPool 을 알림에 연결하는 것입니다. 이 또는 목록에서 IPAddressPool 을 선택하지 않으면 모든 IPAddressPool 에 대한 경고가 적용됩니다.

spec.nodeSelectors

string

선택 사항: NodeSelector 를 사용하면 로드 밸런서 IP의 다음 홉으로 알리는 노드를 제한할 수 있습니다. 비어 있으면 모든 노드가 다음 홉으로 표시됩니다.

spec.peers

string

선택 사항: 피어는 BGP 피어를 제한하여 선택한 풀의 IP를 다음과 같이 알립니다. 비어 있으면 로드 밸런서 IP가 구성된 모든 BGP 피어에 표시됩니다.

34.5.2. BGP 알림 및 기본 사용 사례를 사용하여 MetalLB 구성

피어 BGP 라우터가 서비스에 할당되는 각 로드 밸런서 IP 주소에 대해 하나의 203.0.113.200/32 경로와 하나의 fc00:f853:ccd:e799::1/128 경로를 수신하도록 CloudEvent를 다음과 같이 구성합니다. localPref 및 community 필드가 지정되지 않으므로 localPref 가 0으로 설정되고 BGP 커뮤니티가 없는 경로가 표시됩니다.

34.5.2.1. 예: BGP를 사용하여 기본 주소 풀 구성 확인

IPAddressPool 이 BGP 프로토콜에 알릴 수 있도록 다음과 같이 CloudEvent를 구성합니다.

사전 요구 사항

  • OpenShift CLI(oc)를 설치합니다.
  • cluster-admin 권한이 있는 사용자로 로그인합니다.

절차

  1. IP 주소 풀을 만듭니다.

    1. 다음 예와 같은 콘텐츠를 사용하여 ipaddresspool.yaml 과 같은 파일을 생성합니다.

      apiVersion: metallb.io/v1beta1
      kind: IPAddressPool
      metadata:
        namespace: metallb-system
        name: doc-example-bgp-basic
      spec:
        addresses:
          - 203.0.113.200/30
          - fc00:f853:ccd:e799::/124
    2. IP 주소 풀에 대한 구성을 적용합니다.

      $ oc apply -f ipaddresspool.yaml
  2. BGP 알림을 생성합니다.

    1. 다음 예와 같은 콘텐츠와 함께 bgpadvertisement.yaml 과 같은 파일을 생성합니다.

      apiVersion: metallb.io/v1beta1
      kind: BGPAdvertisement
      metadata:
        name: bgpadvertisement-basic
        namespace: metallb-system
      spec:
        ipAddressPools:
        - doc-example-bgp-basic
    2. 설정을 적용합니다.

      $ oc apply -f bgpadvertisement.yaml

34.5.3. BGP 알림 및 고급 사용 사례를 사용하여 MetalLB 구성

203.0.113.200203.0.113.203fc00:f853:ccd:e799::0 및 fc00:f853:e799::f . f 간의 범위에서 IP 주소를 로드 밸런서 서비스에 할당합니다.

두 개의 BGP 알림을 설명하려면 CloudEvent에서 203.0.113.200 의 IP 주소를 서비스에 할당할 때 인스턴스를 고려하십시오. 이 IP 주소를 예로 들어, 발표자는 BGP 피어에 대한 두 개의 경로를 알립니다.

  • 203.0.113.200/32 localPref100 으로 설정되고 커뮤니티는 NO_ADVERTISE 커뮤니티의 숫자 값으로 설정됩니다. 이 사양은 이 경로를 사용할 수 있다는 피어 라우터에 표시되지만 이 경로에 대한 정보를 BGP 피어에 전파해서는 안 됩니다.
  • 203.0.113.200/30 은 CloudEvent에 의해 할당된 로드 밸런서 IP 주소를 단일 경로로 집계합니다. CloudEvent는 커뮤니티 특성이 8000:800 으로 설정된 BGP 피어에 대한 집계된 경로를 알립니다. BGP 피어는 203.0.113.200/30 경로를 다른 BGP 피어에 전파합니다. 트래픽이 speaker가 있는 노드로 라우팅되면 203.0.113.200/32 경로는 트래픽을 클러스터로 전달하고 서비스와 연결된 Pod로 전달합니다.

풀에서 더 많은 서비스를 추가할 때 피어 라우터는 203.0.113.20 x/32 및 203.0.113. 200/30 집계 경로와 함께 하나의 로컬 경로인 203.0.113.20x/32를 수신합니다. 추가하는 각 서비스는 /30 경로를 생성하지만 CloudEvent는 피어 라우터와 통신하기 전에 하나의 BGP 광고에 대한 경로를 중복 제거합니다.

34.5.3.1. 예: BGP를 사용하여 고급 주소 풀 구성 확인

IPAddressPool 이 BGP 프로토콜에 알릴 수 있도록 다음과 같이 CloudEvent를 구성합니다.

사전 요구 사항

  • OpenShift CLI(oc)를 설치합니다.
  • cluster-admin 권한이 있는 사용자로 로그인합니다.

절차

  1. IP 주소 풀을 만듭니다.

    1. 다음 예와 같은 콘텐츠를 사용하여 ipaddresspool.yaml 과 같은 파일을 생성합니다.

      apiVersion: metallb.io/v1beta1
      kind: IPAddressPool
      metadata:
        namespace: metallb-system
        name: doc-example-bgp-adv
        labels:
          zone: east
      spec:
        addresses:
          - 203.0.113.200/30
          - fc00:f853:ccd:e799::/124
        autoAssign: false
    2. IP 주소 풀에 대한 구성을 적용합니다.

      $ oc apply -f ipaddresspool.yaml
  2. BGP 알림을 생성합니다.

    1. 다음 예와 같은 콘텐츠와 함께 bgpadvertisement1.yaml 과 같은 파일을 생성합니다.

      apiVersion: metallb.io/v1beta1
      kind: BGPAdvertisement
      metadata:
        name: bgpadvertisement-adv-1
        namespace: metallb-system
      spec:
        ipAddressPools:
          - doc-example-bgp-adv
        communities:
          - 65535:65282
        aggregationLength: 32
        localPref: 100
    2. 설정을 적용합니다.

      $ oc apply -f bgpadvertisement1.yaml
    3. 다음 예제와 같은 콘텐츠와 함께 bgpadvertisement2.yaml 과 같은 파일을 생성합니다.

      apiVersion: metallb.io/v1beta1
      kind: BGPAdvertisement
      metadata:
        name: bgpadvertisement-adv-2
        namespace: metallb-system
      spec:
        ipAddressPools:
          - doc-example-bgp-adv
        communities:
          - 8000:800
        aggregationLength: 30
        aggregationLengthV6: 124
    4. 설정을 적용합니다.

      $ oc apply -f bgpadvertisement2.yaml

34.5.4. 노드 서브 세트에서 IP 주소 풀을 표시

특정 노드 집합에서만 IP 주소 풀에서 IP 주소를 공개하려면 BGPAdvertisement 사용자 정의 리소스에서 .spec.nodeSelector 사양을 사용합니다. 이 사양은 IP 주소 풀을 클러스터의 노드 세트와 연결합니다. 이는 클러스터의 다른 서브넷에 있는 노드가 있고 특정 서브넷의 주소 풀에서 IP 주소를 알리려는 경우 유용합니다(예: 공용 서브넷).

사전 요구 사항

  • OpenShift CLI(oc)를 설치합니다.
  • cluster-admin 권한이 있는 사용자로 로그인합니다.

절차

  1. 사용자 정의 리소스를 사용하여 IP 주소 풀을 생성합니다.

    apiVersion: metallb.io/v1beta1
    kind: IPAddressPool
    metadata:
      namespace: metallb-system
      name: pool1
    spec:
      addresses:
        - 4.4.4.100-4.4.4.200
        - 2001:100:4::200-2001:100:4::400
  2. BGPAdvertisement 사용자 정의 리소스에 .spec.nodeSelector 값을 정의하여 cluster의 IP 주소를 pool1 에서 알리는 노드를 제어합니다.

    apiVersion: metallb.io/v1beta1
    kind: BGPAdvertisement
    metadata:
      name: example
    spec:
      ipAddressPools:
      - pool1
      nodeSelector:
      - matchLabels:
          kubernetes.io/hostname: NodeA
      - matchLabels:
          kubernetes.io/hostname: NodeB

이 예에서 pool1 의 IP 주소는 NodeANodeB 에서만 알립니다.

34.5.5. L2Advertisement 사용자 정의 리소스 정보

l2Advertisements 오브젝트의 필드는 다음 표에 정의되어 있습니다.

표 34.4. L2 알림 설정

필드유형설명

metadata.name

string

L2 알림의 이름을 지정합니다.

metadata.namespace

string

L2 알림의 네임스페이스를 지정합니다. MetalLB Operator에서 사용하는 동일한 네임스페이스를 지정합니다.

spec.ipAddressPools

string

선택 사항: 이 광고와 함께 광고할 IPAddressPools 목록(이름으로 선택됨).

spec.ipAddressPoolSelectors

string

선택 사항: 이 광고와 함께 알리는 IPAddressPools 의 선택기입니다. 이름 자체 대신 IPAddressPool 에 할당된 레이블을 기반으로 IPAddressPool 을 알림에 연결하는 것입니다. 이 또는 목록에서 IPAddressPool 을 선택하지 않으면 모든 IPAddressPool 에 대한 경고가 적용됩니다.

spec.nodeSelectors

string

선택 사항: NodeSelector 는 로드 밸런서 IP의 다음 홉으로 노드를 알립니다. 비어 있으면 모든 노드가 다음 홉으로 표시됩니다.

중요

다음 홉으로 알릴 노드를 제한하는 것은 기술 프리뷰 기능 전용입니다. 기술 프리뷰 기능은 Red Hat 프로덕션 서비스 수준 계약(SLA)에서 지원되지 않으며 기능적으로 완전하지 않을 수 있습니다. 따라서 프로덕션 환경에서 사용하는 것은 권장하지 않습니다. 이러한 기능을 사용하면 향후 제품 기능을 조기에 이용할 수 있어 개발 과정에서 고객이 기능을 테스트하고 피드백을 제공할 수 있습니다.

Red Hat 기술 프리뷰 기능의 지원 범위에 대한 자세한 내용은 기술 프리뷰 기능 지원 범위를 참조하십시오.

spec.interfaces

string

선택 사항: 로드 밸런서 IP를 알리는 데 사용되는 인터페이스 목록입니다.

34.5.6. L2 알림을 사용하여 MetalLB 구성

IPAddressPool 이 L2 프로토콜에 알릴 수 있도록 다음과 같이 CloudEvent를 구성합니다.

사전 요구 사항

  • OpenShift CLI(oc)를 설치합니다.
  • cluster-admin 권한이 있는 사용자로 로그인합니다.

절차

  1. IP 주소 풀을 만듭니다.

    1. 다음 예와 같은 콘텐츠를 사용하여 ipaddresspool.yaml 과 같은 파일을 생성합니다.

      apiVersion: metallb.io/v1beta1
      kind: IPAddressPool
      metadata:
        namespace: metallb-system
        name: doc-example-l2
      spec:
        addresses:
          - 4.4.4.0/24
        autoAssign: false
    2. IP 주소 풀에 대한 구성을 적용합니다.

      $ oc apply -f ipaddresspool.yaml
  2. L2 알림을 생성합니다.

    1. 다음 예와 같은 콘텐츠를 사용하여 l2advertisement.yaml 과 같은 파일을 생성합니다.

      apiVersion: metallb.io/v1beta1
      kind: L2Advertisement
      metadata:
        name: l2advertisement
        namespace: metallb-system
      spec:
        ipAddressPools:
         - doc-example-l2
    2. 설정을 적용합니다.

      $ oc apply -f l2advertisement.yaml

34.5.7. L2 알림 및 라벨을 사용하여 MetalLB 구성

BGPAdvertisementL2Advertisement 사용자 정의 리소스 정의의 ipAddressPools 필드는 이름 자체 대신 IPAddressPool 에 할당된 레이블을 기반으로 IPAddressPool 을 광고에 연결하는 데 사용됩니다.

이 예제에서는 ipAddressPoolSelectors 필드를 구성하여 IPAddressPool 이 L2 프로토콜에 알릴 수 있도록 CloudEvent를 구성하는 방법을 보여줍니다.

사전 요구 사항

  • OpenShift CLI(oc)를 설치합니다.
  • cluster-admin 권한이 있는 사용자로 로그인합니다.

절차

  1. IP 주소 풀을 만듭니다.

    1. 다음 예와 같은 콘텐츠를 사용하여 ipaddresspool.yaml 과 같은 파일을 생성합니다.

      apiVersion: metallb.io/v1beta1
      kind: IPAddressPool
      metadata:
        namespace: metallb-system
        name: doc-example-l2-label
        labels:
          zone: east
      spec:
        addresses:
          - 172.31.249.87/32
    2. IP 주소 풀에 대한 구성을 적용합니다.

      $ oc apply -f ipaddresspool.yaml
  2. ipAddressPoolSelectors 를 사용하여 L2 알림 IP를 만듭니다.

    1. 다음 예와 같은 콘텐츠를 사용하여 l2advertisement.yaml 과 같은 파일을 생성합니다.

      apiVersion: metallb.io/v1beta1
      kind: L2Advertisement
      metadata:
        name: l2advertisement-label
        namespace: metallb-system
      spec:
        ipAddressPoolSelectors:
          - matchExpressions:
              - key: zone
                operator: In
                values:
                  - east
    2. 설정을 적용합니다.

      $ oc apply -f l2advertisement.yaml

34.5.8. 선택한 인터페이스에 대한 L2 알림을 사용하여 ScanSetting 구성

기본적으로 서비스에 할당된 IP 주소 풀의 IP 주소는 모든 네트워크 인터페이스에서 알립니다. L2Advertisement 사용자 정의 리소스 정의의 interfaces 필드는 IP 주소 풀을 알리는 네트워크 인터페이스를 제한하는 데 사용됩니다.

이 예제에서는 IP 주소 풀이 모든 노드의 interfaces 필드에 나열된 네트워크 인터페이스에서만 노출되도록 CloudEvent를 구성하는 방법을 보여줍니다.

사전 요구 사항

  • OpenShift CLI(oc)를 설치했습니다.
  • cluster-admin 권한이 있는 사용자로 로그인했습니다.

절차

  1. IP 주소 풀을 만듭니다.

    1. ipaddresspool.yaml 과 같은 파일을 생성하고 다음 예와 같은 구성 세부 정보를 입력합니다.

      apiVersion: metallb.io/v1beta1
      kind: IPAddressPool
      metadata:
        namespace: metallb-system
        name: doc-example-l2
      spec:
        addresses:
          - 4.4.4.0/24
        autoAssign: false
    2. 다음 예제와 같이 IP 주소 풀에 대한 구성을 적용합니다.

      $ oc apply -f ipaddresspool.yaml
  2. L2 광고에서 인터페이스 선택기를 사용하여 IP를 알립니다.

    1. l2advertisement.yaml 과 같은 YAML 파일을 생성하고 다음 예와 같은 설정 세부 정보를 입력합니다.

      apiVersion: metallb.io/v1beta1
      kind: L2Advertisement
      metadata:
        name: l2advertisement
        namespace: metallb-system
      spec:
        ipAddressPools:
         - doc-example-l2
         interfaces:
         - interfaceA
         - interfaceB
    2. 다음 예제와 같이 광고의 구성을 적용합니다.

      $ oc apply -f l2advertisement.yaml
중요

인터페이스 선택기는 L2를 사용하여 지정된 IP를 알릴 노드를 선택하는 방법에는 영향을 미치지 않습니다. 노드에 선택된 인터페이스가 없는 경우 선택한 노드는 서비스를 알리지 않습니다.

34.5.9. 추가 리소스