Felix 구성 파트 9

Felix 구성 레퍼런스의 아홉 번째 파트예요. 앞 파트에 이어서 BPF 데이터플레인 설정의 마지막 몇 개가 먼저 나오고, Windows·OpenStack·XDP 가속 관련 설정이 뒤따라요. 후반부에는 VXLAN, IP-in-IP, WireGuard처럼 오버레이 네트워킹을 조정하는 키들이 모여 있어요. 각 항목은 구성 파일 키와 환경 변수 탭으로 각각 확인할 수 있어요.

출처: 문서

본문

탭: 구성 파일

속성	값
키	BPFPolicyDebugEnabled
설명	true이면 Felix가 BPF 정책 프로그램에 대한 상세 정보를 기록해요. 기록된 정보는 calico-bpf 명령줄 도구로 살펴볼 수 있어요.
스키마	불리언: true, 1, yes, y, t는 True로, false, 0, no, n, f는 (대소문자 구분 없이) False로 처리돼요.
기본값	true

탭: 환경 변수

속성	값
키	FELIX_BPFPOLICYDEBUGENABLED
설명	true이면 Felix가 BPF 정책 프로그램에 대한 상세 정보를 기록해요. 기록된 정보는 calico-bpf 명령줄 도구로 살펴볼 수 있어요.
스키마	불리언: true, 1, yes, y, t는 True로, false, 0, no, n, f는 (대소문자 구분 없이) False로 처리돼요.
기본값	true

BPFProfiling

탭: 구성 파일

속성	값
키	BPFProfiling
설명	BPF 프로그램의 프로파일링을 제어해요. 현재는 Disabled 또는 Enabled로 설정할 수 있어요.
스키마	Disabled, Enabled 중 하나
기본값	Disabled

탭: 환경 변수

속성	값
키	FELIX_BPFPROFILING
설명	BPF 프로그램의 프로파일링을 제어해요. 현재는 Disabled 또는 Enabled로 설정할 수 있어요.
스키마	Disabled, Enabled 중 하나
기본값	Disabled

BPFRedirectToPeer

탭: 구성 파일

속성	값
키	BPFRedirectToPeer
설명	트래픽을 워크로드 디바이스의 피어 쪽으로 직접 포워딩할 수 있는지 제어해요. 참고로 예전 방식인 "L2Only" 옵션은 이제 폐기(deprecated)됐고, 설정하면 "Enabled"처럼 취급돼요. 이 옵션을 "Enabled"로 설정하면 직접 리다이렉션이 허용돼요(IPIP 터널이나 WireGuard 같은 L3 호스트 디바이스에서 오는 경우 포함). 리다이렉션 성능은 좋아지지만, 리다이렉트된 패킷이 호스트 쪽 ingress 경로를 우회하게 돼요. 그 결과 워크로드 디바이스의 호스트 쪽에서 동작하는 패킷 캡처 도구(예: tcpdump)는 해당 트래픽을 볼 수 없어요.
스키마	Disabled, Enabled, L2Only 중 하나
기본값	Enabled

탭: 환경 변수

속성	값
키	FELIX_BPFREDIRECTTOPEER
설명	트래픽을 워크로드 디바이스의 피어 쪽으로 직접 포워딩할 수 있는지 제어해요. 참고로 예전 방식인 "L2Only" 옵션은 이제 폐기(deprecated)됐고, 설정하면 "Enabled"처럼 취급돼요. 이 옵션을 "Enabled"로 설정하면 직접 리다이렉션이 허용돼요(IPIP 터널이나 WireGuard 같은 L3 호스트 디바이스에서 오는 경우 포함). 리다이렉션 성능은 좋아지지만, 리다이렉트된 패킷이 호스트 쪽 ingress 경로를 우회하게 돼요. 그 결과 워크로드 디바이스의 호스트 쪽에서 동작하는 패킷 캡처 도구(예: tcpdump)는 해당 트래픽을 볼 수 없어요.
스키마	Disabled, Enabled, L2Only 중 하나
기본값	Enabled

데이터 플레인: Windows

WindowsManageFirewallRules

탭: 구성 파일

속성	값
키	WindowsManageFirewallRules
설명	Felix가 Windows 방화벽 규칙을 프로그래밍할지 설정해요(자체 메트릭 포트로의 인바운드 접근을 허용하기 위해서예요).
스키마	Disabled, Enabled 중 하나
기본값	Disabled

탭: 환경 변수

속성	값
키	FELIX_WINDOWSMANAGEFIREWALLRULES
설명	Felix가 Windows 방화벽 규칙을 프로그래밍할지 설정해요(자체 메트릭 포트로의 인바운드 접근을 허용하기 위해서예요).
스키마	Disabled, Enabled 중 하나
기본값	Disabled

데이터 플레인: OpenStack 지원

EndpointReportingDelaySecs

탭: 구성 파일

속성	값
키	EndpointReportingDelaySecs
설명	Felix가 엔드포인트 상태를 데이터스토어에 보고하기 전에 기다리는 지연 시간이에요. OpenStack 통합에서만 사용돼요.
스키마	초 (부동소수점)
기본값	1 (1s)

탭: 환경 변수

속성	값
키	FELIX_ENDPOINTREPORTINGDELAYSECS
설명	Felix가 엔드포인트 상태를 데이터스토어에 보고하기 전에 기다리는 지연 시간이에요. OpenStack 통합에서만 사용돼요.
스키마	초 (부동소수점)
기본값	1 (1s)

EndpointReportingEnabled

탭: 구성 파일

속성	값
키	EndpointReportingEnabled
설명	Felix가 엔드포인트 상태를 데이터스토어에 보고할지 제어해요. OpenStack 통합에서만 사용돼요.
스키마	불리언: true, 1, yes, y, t는 True로, false, 0, no, n, f는 (대소문자 구분 없이) False로 처리돼요.
기본값	false

탭: 환경 변수

속성	값
키	FELIX_ENDPOINTREPORTINGENABLED
설명	Felix가 엔드포인트 상태를 데이터스토어에 보고할지 제어해요. OpenStack 통합에서만 사용돼요.
스키마	불리언: true, 1, yes, y, t는 True로, false, 0, no, n, f는 (대소문자 구분 없이) False로 처리돼요.
기본값	false

MetadataAddr

탭: 구성 파일

속성	값
키	MetadataAddr
설명	VM의 cloud-init 메타데이터 질의에 응답할 서버의 IP 주소 또는 도메인 이름이에요. OpenStack에서는 nova-api를 실행하는 머신(Ubuntu에서는 nova-api-metadata)에 해당해요. none(대소문자 구분 없음)으로 설정하면 Felix가 메타데이터 경로에 어떤 NAT 규칙도 설정하지 않아요.
스키마	정규식 ^[a-zA-Z0-9_.-]+$과 일치하는 문자열
기본값	127.0.0.1

탭: 환경 변수

속성	값
키	FELIX_METADATAADDR
설명	VM의 cloud-init 메타데이터 질의에 응답할 서버의 IP 주소 또는 도메인 이름이에요. OpenStack에서는 nova-api를 실행하는 머신(Ubuntu에서는 nova-api-metadata)에 해당해요. none(대소문자 구분 없음)으로 설정하면 Felix가 메타데이터 경로에 어떤 NAT 규칙도 설정하지 않아요.
스키마	정규식 ^[a-zA-Z0-9_.-]+$과 일치하는 문자열
기본값	127.0.0.1

MetadataPort

탭: 구성 파일

속성	값
키	MetadataPort
설명	메타데이터 서버의 포트예요. global.MetadataAddr('None'이 아닐 때)와 함께 사용되어 169.254.169.254:80에서 MetadataAddr:MetadataPort로 향하는 NAT 규칙을 설정하는 데 쓰여요. 대부분의 경우 바꿀 필요가 없어요.
스키마	정수: [0,65535]
기본값	8775

탭: 환경 변수

속성	값
키	FELIX_METADATAPORT
설명	메타데이터 서버의 포트예요. global.MetadataAddr('None'이 아닐 때)와 함께 사용되어 169.254.169.254:80에서 MetadataAddr:MetadataPort로 향하는 NAT 규칙을 설정하는 데 쓰여요. 대부분의 경우 바꿀 필요가 없어요.
스키마	정수: [0,65535]
기본값	8775

OpenstackRegion

탭: 구성 파일

속성	값
키	OpenstackRegion
설명	해당 Felix가 속한 리전의 이름이에요. 여러 리전으로 구성된 Calico/OpenStack 배포에서는 각 Felix마다 이 값을 어떤 식으로든 설정해야 해요(데이터모델에서 설정하거나, 각 컴퓨트 노드의 felix.cfg 또는 환경 변수로 설정). 그리고 각 노드의 neutron.conf에 설정된 [calico] openstack_region 값과 일치해야 해요.
스키마	OpenStack 리전 이름 (유효한 DNS 레이블이어야 해요)
기본값	없음

탭: 환경 변수

속성	값
키	FELIX_OPENSTACKREGION
설명	해당 Felix가 속한 리전의 이름이에요. 여러 리전으로 구성된 Calico/OpenStack 배포에서는 각 Felix마다 이 값을 어떤 식으로든 설정해야 해요(데이터모델에서 설정하거나, 각 컴퓨트 노드의 felix.cfg 또는 환경 변수로 설정). 그리고 각 노드의 neutron.conf에 설정된 [calico] openstack_region 값과 일치해야 해요.
스키마	OpenStack 리전 이름 (유효한 DNS 레이블이어야 해요)
기본값	없음

ReportingIntervalSecs

탭: 구성 파일

속성	값
키	ReportingIntervalSecs
설명	Felix가 데이터스토어에 자신의 상태를 보고하는 주기예요. 0으로 설정하면 보고가 꺼져요. OpenStack 배포에서는 0이 아니어야 해요.
스키마	초 (부동소수점)
기본값	30 (30s)

탭: 환경 변수

속성	값
키	FELIX_REPORTINGINTERVALSECS
설명	Felix가 데이터스토어에 자신의 상태를 보고하는 주기예요. 0으로 설정하면 보고가 꺼져요. OpenStack 배포에서는 0이 아니어야 해요.
스키마	초 (부동소수점)
기본값	30 (30s)

ReportingTTLSecs

탭: 구성 파일

속성	값
키	ReportingTTLSecs
설명	프로세스 전체 상태 보고의 time-to-live 설정이에요.
스키마	초 (부동소수점)
기본값	90 (1m30s)

탭: 환경 변수

속성	값
키	FELIX_REPORTINGTTLSECS
설명	프로세스 전체 상태 보고의 time-to-live 설정이에요.
스키마	초 (부동소수점)
기본값	90 (1m30s)

데이터 플레인: iptables 데이터 플레인용 XDP 가속

GenericXDPEnabled

탭: 구성 파일

속성	값
키	GenericXDPEnabled
설명	Generic XDP를 활성화해서 XDP 오프로드나 드라이버 모드를 지원하지 않는 네트워크 카드도 XDP를 사용할 수 있게 해줘요. iptables보다 나은 성능을 내지 못하기 때문에 권장하지는 않아요.
스키마	불리언: true, 1, yes, y, t는 True로, false, 0, no, n, f는 (대소문자 구분 없이) False로 처리돼요.
기본값	false

탭: 환경 변수

속성	값
키	FELIX_GENERICXDPENABLED
설명	Generic XDP를 활성화해서 XDP 오프로드나 드라이버 모드를 지원하지 않는 네트워크 카드도 XDP를 사용할 수 있게 해줘요. iptables보다 나은 성능을 내지 못하기 때문에 권장하지는 않아요.
스키마	불리언: true, 1, yes, y, t는 True로, false, 0, no, n, f는 (대소문자 구분 없이) False로 처리돼요.
기본값	false

XDPEnabled

탭: 구성 파일

속성	값
키	XDPEnabled
설명	적합한 untracked 인바운드 deny 규칙에 XDP 가속을 활성화해요.
스키마	불리언: true, 1, yes, y, t는 True로, false, 0, no, n, f는 (대소문자 구분 없이) False로 처리돼요.
기본값	true

탭: 환경 변수

속성	값
키	FELIX_XDPENABLED
설명	적합한 untracked 인바운드 deny 규칙에 XDP 가속을 활성화해요.
스키마	불리언: true, 1, yes, y, t는 True로, false, 0, no, n, f는 (대소문자 구분 없이) False로 처리돼요.
기본값	true

XDPRefreshInterval

탭: 구성 파일

속성	값
키	XDPRefreshInterval
설명	다른 프로세스가 실수로 Calico의 BPF 맵이나 연결된 프로그램을 망가뜨리지 않았는지 확인하려고 Felix가 XDP 상태 전체를 다시 점검하는 주기예요. 0으로 설정하면 XDP refresh가 꺼져요.
스키마	초 (부동소수점)
기본값	90 (1m30s)

탭: 환경 변수

속성	값
키	FELIX_XDPREFRESHINTERVAL
설명	다른 프로세스가 실수로 Calico의 BPF 맵이나 연결된 프로그램을 망가뜨리지 않았는지 확인하려고 Felix가 XDP 상태 전체를 다시 점검하는 주기예요. 0으로 설정하면 XDP refresh가 꺼져요.
스키마	초 (부동소수점)
기본값	90 (1m30s)

오버레이: VXLAN 오버레이

VXLANEnabled

탭: 구성 파일

속성	값
키	VXLANEnabled
설명	IPv4 VXLAN 네트워킹을 위해 Felix가 VXLAN 터널 디바이스를 생성할지 대신 지정해요. Felix가 기존 IP 풀을 기준으로 판단하기 때문에 생략할 수 있어요.
스키마	불리언: true, 1, yes, y, t는 True로, false, 0, no, n, f는 (대소문자 구분 없이) False로 처리돼요.
기본값	없음

탭: 환경 변수

속성	값
키	FELIX_VXLANENABLED
설명	IPv4 VXLAN 네트워킹을 위해 Felix가 VXLAN 터널 디바이스를 생성할지 대신 지정해요. Felix가 기존 IP 풀을 기준으로 판단하기 때문에 생략할 수 있어요.
스키마	불리언: true, 1, yes, y, t는 True로, false, 0, no, n, f는 (대소문자 구분 없이) False로 처리돼요.
기본값	없음

VXLANMTU

탭: 구성 파일

속성	값
키	VXLANMTU
설명	IPv4 VXLAN 터널 디바이스에 설정할 MTU예요. Felix가 호스트 인터페이스의 MTU를 기준으로 자동 감지하기 때문에 생략할 수 있어요.
스키마	정수
기본값	0

탭: 환경 변수

속성	값
키	FELIX_VXLANMTU
설명	IPv4 VXLAN 터널 디바이스에 설정할 MTU예요. Felix가 호스트 인터페이스의 MTU를 기준으로 자동 감지하기 때문에 생략할 수 있어요.
스키마	정수
기본값	0

VXLANMTUV6

탭: 구성 파일

속성	값
키	VXLANMTUV6
설명	IPv6 VXLAN 터널 디바이스에 설정할 MTU예요. Felix가 호스트 인터페이스의 MTU를 기준으로 자동 감지하기 때문에 생략할 수 있어요.
스키마	정수
기본값	0

탭: 환경 변수

속성	값
키	FELIX_VXLANMTUV6
설명	IPv6 VXLAN 터널 디바이스에 설정할 MTU예요. Felix가 호스트 인터페이스의 MTU를 기준으로 자동 감지하기 때문에 생략할 수 있어요.
스키마	정수
기본값	0

VXLANPort

탭: 구성 파일

속성	값
키	VXLANPort
설명	VXLAN 트래픽에 사용할 UDP 포트 번호예요.
스키마	정수
기본값	4789

탭: 환경 변수

속성	값
키	FELIX_VXLANPORT
설명	VXLAN 트래픽에 사용할 UDP 포트 번호예요.
스키마	정수
기본값	4789

VXLANVNI

탭: 구성 파일

속성	값
키	VXLANVNI
설명	VXLAN 트래픽에 사용할 VXLAN VNI예요. 기본값이 시스템에서 이미 사용 중이라면 바꿔야 할 수 있어요.
스키마	정수
기본값	4096

탭: 환경 변수

속성	값
키	FELIX_VXLANVNI
설명	VXLAN 트래픽에 사용할 VXLAN VNI예요. 기본값이 시스템에서 이미 사용 중이라면 바꿔야 할 수 있어요.
스키마	정수
기본값	4096

오버레이: IP-in-IP

IpInIpEnabled

탭: 구성 파일

속성	값
키	IpInIpEnabled
설명	호스트에 Felix가 IPIP 인터페이스를 구성할지 대신 지정해요. Felix가 기존 IP 풀을 기준으로 판단하기 때문에 생략할 수 있어요.
스키마	불리언: true, 1, yes, y, t는 True로, false, 0, no, n, f는 (대소문자 구분 없이) False로 처리돼요.
기본값	없음

탭: 환경 변수

속성	값
키	FELIX_IPINIPENABLED
설명	호스트에 Felix가 IPIP 인터페이스를 구성할지 대신 지정해요. Felix가 기존 IP 풀을 기준으로 판단하기 때문에 생략할 수 있어요.
스키마	불리언: true, 1, yes, y, t는 True로, false, 0, no, n, f는 (대소문자 구분 없이) False로 처리돼요.
기본값	없음

IpInIpMtu

탭: 구성 파일

속성	값
키	IpInIpMtu
설명	IPIP 터널 디바이스에 설정할 MTU를 제어해요. Felix가 호스트 인터페이스의 MTU를 기준으로 자동 감지하기 때문에 생략할 수 있어요.
스키마	정수
기본값	0

탭: 환경 변수

속성	값
키	FELIX_IPINIPMTU
설명	IPIP 터널 디바이스에 설정할 MTU를 제어해요. Felix가 호스트 인터페이스의 MTU를 기준으로 자동 감지하기 때문에 생략할 수 있어요.
스키마	정수
기본값	0

오버레이: WireGuard

WireguardEnabled

탭: 구성 파일

속성	값
키	WireguardEnabled
설명	IPv4에서 Wireguard를 활성화할지 제어해요(IPv4 언더레이 네트워크 위에서 IPv4 트래픽을 캡슐화해요).
스키마	불리언: true, 1, yes, y, t는 True로, false, 0, no, n, f는 (대소문자 구분 없이) False로 처리돼요.
기본값	false

탭: 환경 변수

속성	값
키	FELIX_WIREGUARDENABLED
설명	IPv4에서 Wireguard를 활성화할지 제어해요(IPv4 언더레이 네트워크 위에서 IPv4 트래픽을 캡슐화해요).
스키마	불리언: true, 1, yes, y, t는 True로, false, 0, no, n, f는 (대소문자 구분 없이) False로 처리돼요.
기본값	false

WireguardEnabledV6

탭: 구성 파일

속성	값
키	WireguardEnabledV6
설명	IPv6에서 Wireguard를 활성화할지 제어해요(IPv6 언더레이 네트워크 위에서 IPv6 트래픽을 캡슐화해요).
스키마	불리언: true, 1, yes, y, t는 True로, false, 0, no, n, f는 (대소문자 구분 없이) False로 처리돼요.
기본값	false

탭: 환경 변수

속성	값
키	FELIX_WIREGUARDENABLEDV6
설명	IPv6에서 Wireguard를 활성화할지 제어해요(IPv6 언더레이 네트워크 위에서 IPv6 트래픽을 캡슐화해요).
스키마	불리언: true, 1, yes, y, t는 True로, false, 0, no, n, f는 (대소문자 구분 없이) False로 처리돼요.
기본값	false

WireguardHostEncryptionEnabled

탭: 구성 파일

속성	값
키	WireguardHostEncryptionEnabled
설명	Wireguard 호스트 간(host-to-host) 암호화를 활성화할지 제어해요.
스키마	불리언: true, 1, yes, y, t는 True로, false, 0, no, n, f는 (대소문자 구분 없이) False로 처리돼요.
기본값	false

탭: 환경 변수

속성	값
키	FELIX_WIREGUARDHOSTENCRYPTIONENABLED
설명	Wireguard 호스트 간(host-to-host) 암호화를 활성화할지 제어해요.
스키마	불리언: true, 1, yes, y, t는 True로, false, 0, no, n, f는 (대소문자 구분 없이) False로 처리돼요.
기본값	false

WireguardInterfaceName

탭: 구성 파일

속성	값
키	WireguardInterfaceName
설명	IPv4 Wireguard 인터페이스에 사용할 이름을 지정해요.
스키마	정규식 ^[a-zA-Z0-9:._+-]{1,15}$과 일치하는 문자열
기본값	wireguard.cali

탭: 환경 변수

속성	값
키	FELIX_WIREGUARDINTERFACENAME
설명	IPv4 Wireguard 인터페이스에 사용할 이름을 지정해요.
스키마	정규식 ^[a-zA-Z0-9:._+-]{1,15}$과 일치하는 문자열
기본값	wireguard.cali

WireguardInterfaceNameV6

탭: 구성 파일

속성	값
키	WireguardInterfaceNameV6
설명	IPv6 Wireguard 인터페이스에 사용할 이름을 지정해요.
스키마	정규식 ^[a-zA-Z0-9:._+-]{1,15}$과 일치하는 문자열
기본값	wg-v6.cali

탭: 환경 변수

속성	값
키	FELIX_WIREGUARDINTERFACENAMEV6
설명	IPv6 Wireguard 인터페이스에 사용할 이름을 지정해요.
스키마	정규식 ^[a-zA-Z0-9:._+-]{1,15}$과 일치하는 문자열
기본값	wg-v6.cali

WireguardListeningPort

탭: 구성 파일

속성	값
키	WireguardListeningPort
설명	IPv4 Wireguard가 사용하는 리스닝 포트를 제어해요.
스키마	정수
기본값	51820

탭: 환경 변수

속성	값
키	FELIX_WIREGUARDLISTENINGPORT
설명	IPv4 Wireguard가 사용하는 리스닝 포트를 제어해요.
스키마	정수
기본값	51820

WireguardListeningPortV6

탭: 구성 파일

속성	값
키	WireguardListeningPortV6
설명	IPv6 Wireguard가 사용하는 리스닝 포트를 제어해요.
스키마	정수
기본값	51821

탭: 환경 변수

속성	값
키	FELIX_WIREGUARDLISTENINGPORTV6
설명	IPv6 Wireguard가 사용하는 리스닝 포트를 제어해요.
스키마	정수
기본값	51821

WireguardMTU

탭: 구성 파일

속성	값
키	WireguardMTU
설명	IPv4 Wireguard 인터페이스의 MTU를 제어해요. Configuring MTU 문서를 참고하세요.
스키마	정수
기본값	0

탭: 환경 변수

속성	값
키	FELIX_WIREGUARDMTU
설명	IPv4 Wireguard 인터페이스의 MTU를 제어해요. Configuring MTU 문서를 참고하세요.
스키마	정수
기본값	0

WireguardMTUV6

탭: 구성 파일

속성	값
키	WireguardMTUV6
설명	IPv6 Wireguard 인터페이스의 MTU를 제어해요. Configuring MTU 문서를 참고하세요.
스키마	정수
기본값	0

탭: 환경 변수

속성	값
키	FELIX_WIREGUARDMTUV6
설명	IPv6 Wireguard 인터페이스의 MTU를 제어해요. Configuring MTU 문서를 참고하세요.
스키마	정수
기본값	0

WireguardPersistentKeepAlive

더 알아보기 (Learn more)

Felix 구성 옵션 전체는 Felix 구성 레퍼런스의 이전·다음 파트에서 이어져요. 오버레이 네트워킹을 구성한다면 VXLAN 관련 키와 WireguardEnabled부터 살펴보고, OpenStack 연동 환경에서는 리포팅 관련 키도 함께 확인해 보세요.