26.4. MetalLB BGP 피어 구성

클러스터 관리자는 BGP(Border Gateway Protocol) 피어를 추가, 수정 및 삭제할 수 있습니다. MetalLB Operator는 BGP 피어 사용자 정의 리소스를 사용하여 MetalLB 스피커 Pod가 BGP 세션을 시작하기 위해 연결하는 피어를 식별합니다. 피어는 MetalLB가 서비스에 할당하는 로드 밸런서 IP 주소에 대한 경로 알림을 수신합니다.

26.4.1. BGP 피어 사용자 정의 리소스 정보

BGP 피어 사용자 지정 리소스의 필드는 다음 표에 설명되어 있습니다.

표 26.3. MetalLB BGP 피어 사용자 정의 리소스

필드유형설명

metadata.name

string

BGP 피어 사용자 정의 리소스의 이름을 지정합니다.

metadata.namespace

string

BGP 피어 사용자 지정 리소스의 네임스페이스를 지정합니다.

spec.myASN

integer

BGP 세션의 로컬 끝에 대한 자동 시스템 번호를 지정합니다. 추가하는 모든 BGP 피어 사용자 정의 리소스에서 동일한 값을 지정합니다. 범위는 0 에서 65535 입니다.

spec.peerASN

integer

BGP 세션의 원격 종료에 대한 자동 시스템 번호를 지정합니다. 범위는 0 에서 65535 입니다.

spec.peerAddress

string

BGP 세션을 설정하기 위해 연결할 피어의 IP 주소를 지정합니다.

spec.sourceAddress

string

선택 사항: BGP 세션을 설정할 때 사용할 IP 주소를 지정합니다. 값은 IPv4 주소여야 합니다.

spec.peerPort

integer

선택 사항: BGP 세션을 설정하기 위해 연락할 피어의 네트워크 포트를 지정합니다. 범위는 0 ~16384 입니다.

spec.holdTime

string

선택 사항: BGP 피어에 제안하는 대기 시간 기간을 지정합니다. 최소 값은 3초(3초)입니다. 공통 단위는 초 및 분 (예: 3s,1m, 5m 30s )입니다. 경로 오류를 더 빠르게 감지하려면 BFD도 구성합니다.

spec.keepaliveTime

string

선택 사항: 유지 관리 메시지를 BGP 피어로 보내는 간격을 지정합니다. 이 필드를 지정하는 경우 holdTime 필드의 값도 지정해야 합니다. 지정된 값이 holdTime 필드 값보다 작아야 합니다.

spec.routerID

string

선택 사항: BGP 피어에 알릴 라우터 ID를 지정합니다. 이 필드를 지정하는 경우 추가하는 모든 BGP 피어 사용자 정의 리소스에서 동일한 값을 지정해야 합니다.

spec.password

string

선택 사항: TCP MD5 인증 BGP 세션을 적용하는 라우터의 피어로 보낼 MD5 암호를 지정합니다.

spec.bfdProfile

string

선택 사항: BFD 프로필의 이름을 지정합니다.

spec.nodeSelectors

object[]

선택 사항: 일치 식 및 일치 레이블을 사용하여 BGP 피어에 연결할 수 있는 노드를 제어하는 선택기를 지정합니다.

spec.ebgpMultiHop

boolean

선택 사항: BGP 피어가 여러 네트워크 홉인지 여부를 지정합니다. BGP 피어가 동일한 네트워크에 직접 연결되지 않은 경우 이 필드가 true 로 설정되지 않은 경우 BGP 세션을 설정할 수 없습니다. 이 필드는 외부 BGP 에 적용됩니다. 외부 BGP는 BGP 피어가 다른 Autonomous 시스템에 속하는 시기를 설명하는 데 사용되는 용어입니다.

26.4.2. BGP 피어 구성

클러스터 관리자는 BGP 피어 사용자 정의 리소스를 추가하여 네트워크 라우터와 라우팅 정보를 교환하고 서비스에 IP 주소를 알릴 수 있습니다.

사전 요구 사항

  • OpenShift CLI(oc)를 설치합니다.
  • cluster-admin 권한이 있는 사용자로 로그인합니다.
  • spec.protocol 필드에 bgp 를 지정하는 MetalLB 주소 풀을 구성합니다.

절차

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

    apiVersion: metallb.io/v1beta1
    kind: BGPPeer
    metadata:
      namespace: metallb-system
      name: doc-example-peer
    spec:
      peerAddress: 10.0.0.1
      peerASN: 64501
      myASN: 64500
      routerID: 10.10.10.10
  2. BGP 피어에 대한 설정을 적용합니다.

    $ oc apply -f bgppeer.yaml

추가 리소스

26.4.3. BGP 피어 구성의 예

26.4.3.1. 예: BGP 피어에 연결된 노드 제한

노드 선택기 필드를 지정하여 BGP 피어에 연결할 수 있는 노드를 제어할 수 있습니다.

apiVersion: metallb.io/v1beta1
kind: BGPPeer
metadata:
  name: doc-example-nodesel
  namespace: metallb-system
spec:
  peerAddress: 10.0.20.1
  peerASN: 64501
  myASN: 64500
  nodeSelectors:
  - matchExpressions:
    - key: kubernetes.io/hostname
      operator: In
      values: [compute-1.example.com, compute-2.example.com]

26.4.3.2. 예: BGP 피어에 대한 BFD 프로필 지정

BGP 피어와 연결할 BFD 프로필을 지정할 수 있습니다. BFD는 BGP가 아닌 피어 간 통신 실패를 보다 신속하게 감지하여 BGP를 제공합니다.

apiVersion: metallb.io/v1beta1
kind: BGPPeer
metadata:
  name: doc-example-peer-bfd
  namespace: metallb-system
spec:
  peerAddress: 10.0.20.1
  peerASN: 64501
  myASN: 64500
  holdTime: "10s"
  bfdProfile: doc-example-bfd-profile-full
참고

BFD(Bidirectional forwarding detection) 프로필을 삭제하고 BGP(Border Gateway Protocol) 피어 리소스에 추가된 bfdProfile 을 제거하면 BFD가 비활성화되지 않습니다. 대신 BGP 피어는 기본 BFD 프로필 사용을 시작합니다. BGP 피어 리소스에서 BFD를 비활성화하려면 BGP 피어 구성을 삭제하고 BFD 프로필없이 다시 생성합니다. 자세한 내용은 BZ#2050824 에서 참조하십시오.

26.4.3.3. 예: 듀얼 스택 네트워킹의 BGP 피어 지정

듀얼 스택 네트워킹을 지원하려면 IPv4에 대한 하나의 BGP 피어 사용자 지정 리소스와 IPv6용 BGP 피어 사용자 지정 리소스를 추가합니다.

apiVersion: metallb.io/v1beta1
kind: BGPPeer
metadata:
  name: doc-example-dual-stack-ipv4
  namespace: metallb-system
spec:
  peerAddress: 10.0.20.1
  peerASN: 64500
  myASN: 64500
---
apiVersion: metallb.io/v1beta1
kind: BGPPeer
metadata:
  name: doc-example-dual-stack-ipv6
  namespace: metallb-system
spec:
  peerAddress: 2620:52:0:88::104
  peerASN: 64500
  myASN: 64500