Red Hat Summit Red Hat Summit지원콘솔개발자평가판 시작연락처

1.11. 예제: IP 관리

다음 예제 구성 조각은 IP 관리의 다양한 방법을 보여줍니다.

이 예제에서는 ethernet 인터페이스 유형을 사용하여 예제를 단순화하면서 정책 구성에 관련 컨텍스트를 표시합니다. 이러한 IP 관리 예제는 다른 인터페이스 유형과 함께 사용할 수 있습니다.

1.11.1. 고정
링크 복사

다음 스니펫은 이더넷 인터페이스에서 IP 주소를 정적으로 구성합니다. 

# ...
    interfaces:
    - name: eth1
      description: static IP on eth1
      type: ethernet
      state: up
      ipv4:
        dhcp: false
        address:
        - ip: 192.168.122.250
1 

          prefix-length: 24
        enabled: true
# ...
Copy to Clipboard Toggle word wrap
1
이 값을 인터페이스의 고정 IP 주소로 교체합니다.

1.11.2. IP 주소 없음
링크 복사

다음 스니펫에서는 인터페이스에 IP 주소가 없습니다. 

# ...
    interfaces:
    - name: eth1
      description: No IP on eth1
      type: ethernet
      state: up
      ipv4:
        enabled: false
# ...
Copy to Clipboard Toggle word wrap
중요

인터페이스를 비활성화하려면 ipv4.enabled 및 ipv6.enabled 매개변수를 모두 false 로 설정하는 경우 항상 state 매개변수를 up 으로 설정하세요. 이 구성에서 state: down 을 설정하면 자동 DHCP 할당으로 인해 인터페이스가 DHCP IP 주소를 받습니다.

1.11.3. 동적 호스트 구성
링크 복사

다음 스니펫에서는 동적 IP 주소, 게이트웨이 주소, DNS를 사용하는 이더넷 인터페이스를 구성합니다. 

# ...
    interfaces:
    - name: eth1
      description: DHCP on eth1
      type: ethernet
      state: up
      ipv4:
        dhcp: true
        enabled: true
# ...
Copy to Clipboard Toggle word wrap

다음 스니펫에서는 동적 IP 주소를 사용하지만 동적 게이트웨이 주소 또는 DNS를 사용하지 않는 이더넷 인터페이스를 구성합니다. 

# ...
    interfaces:
    - name: eth1
      description: DHCP without gateway or DNS on eth1
      type: ethernet
      state: up
      ipv4:
        dhcp: true
        auto-gateway: false
        auto-dns: false
        enabled: true
# ...
Copy to Clipboard Toggle word wrap

1.11.4. 미디어 액세스 제어(MAC) 주소
링크 복사

네트워크 인터페이스 이름 대신 MAC 주소를 사용하여 네트워크 인터페이스를 식별할 수 있습니다. 네트워크 인터페이스 이름은 운영 체제 구성 변경 등 다양한 이유로 변경될 수 있습니다. 그러나 모든 네트워크 인터페이스에는 변경되지 않는 고유한 MAC 주소가 있습니다. 즉, MAC 주소를 사용하면 특정 네트워크 인터페이스를 식별하는 데 더 영구적인 방법이 됩니다.

식별자 매개변수에 지원되는 값에는 기본 이름 값과 mac-address 값이 포함됩니다. 이름 값은 지정된 인터페이스 이름을 보유하는 인터페이스에 구성을 적용합니다.

식별자 매개변수에 MAC 주소 값을 사용하면 MAC 주소가 네트워크 인터페이스의 식별자라는 것을 나타냅니다. 식별자 값을 mac-address 로 설정하는 경우 다음 mac-address 매개변수 필드에 특정 MAC 주소를 입력해야 합니다.

참고

name 매개변수에 대한 값을 지정할 수는 있지만, identifier: mac-address 값을 설정하면 MAC 주소가 네트워크 인터페이스의 기본 식별자로 사용된다는 의미입니다. 잘못된 MAC 주소를 지정하면 nmstate는 잘못된 인수 오류를 보고합니다.

다음 스니펫은 8A:8C:92:1A:F6:98 의 MAC 주소를 갖는 eth1 이라는 이더넷 장치의 기본 식별자로 지정합니다. 

# ...
interfaces:
- name: eth1
  profile-name: wan0
  type: ethernet
  state: up
  identifier: mac-address
  mac-address: 8A:8C:92:1A:F6:98
# ...
Copy to Clipboard Toggle word wrap

1.11.5. DNS
링크 복사

기본적으로 nmstate API는 DNS 값을 네트워크 인터페이스에 저장하는 대신 전역적으로 저장합니다. 특정 상황에서는 DNS 값을 저장하기 위해 네트워크 인터페이스를 구성해야 합니다.

작은 정보

DNS 구성을 설정하는 것은 /etc/resolv.conf 파일을 수정하는 것과 같습니다.

네트워크 인터페이스에 대한 DNS 구성을 정의하려면 먼저 네트워크 인터페이스의 YAML 구성 파일에서 dns-resolver 섹션을 지정해야 합니다. 네트워크 인터페이스에 NNCP 구성을 적용하려면 oc apply -f <nncp_file_name> 명령을 실행해야 합니다.

다음 예에서는 DNS 값을 전역적으로 저장하는 기본 상황을 보여줍니다.

  • 네트워크 인터페이스 없이 정적 DNS를 구성합니다. 호스트 노드에서 /etc/resolv.conf 파일을 업데이트할 때 NodeNetworkConfigurationPolicy (NNCP) 매니페스트에서 인터페이스(IPv4 또는 IPv6)를 지정할 필요가 없습니다.

    DNS 값을 전역적으로 저장하는 네트워크 인터페이스에 대한 DNS 구성 예

    apiVersion: nmstate.io/v1
kind: NodeNetworkConfigurationPolicy
metadata:
 name: worker-0-dns-testing
spec:
  nodeSelector:
    kubernetes.io/hostname: <target_node>
  desiredState:
    dns-resolver:
      config:
        server:
        - 2001:db8:f::1
        - 192.0.2.251
        search:
        - example.com
        - example.org
# ...
    Copy to Clipboard Toggle word wrap

    중요

    다음 예에서 보여준 것처럼 NNCP 파일의 dns-resolver.config 섹션에서 DNS 옵션을 지정할 수 있습니다. 

    # ...
desiredState:
    dns-resolver:
      config:
        options:
         - timeout:2
         - attempts:3
# ...
    Copy to Clipboard Toggle word wrap

    네트워크 인터페이스에서 DNS 옵션을 제거하려면 다음 구성을 NNCP에 적용한 다음 oc apply -f <nncp_file_name> 명령을 실행하세요. 

    # ...
    dns-resolver:
      config: {}
    interfaces: []
# ...
    Copy to Clipboard Toggle word wrap

다음 예에서는 DNS 값을 저장하기 위해 네트워크 인터페이스를 구성해야 하는 상황을 보여줍니다.

  • 정적 DNS 이름 서버를 동적 DNS 이름 서버보다 순위를 매기려면 네트워크 인터페이스 YAML 구성 파일에서 동적 호스트 구성 프로토콜(DHCP) 또는 IPv6 자동 구성( autoconf ) 메커니즘을 실행하는 인터페이스를 정의합니다.

    DHCPv4 네트워크 프로토콜에서 검색된 DNS 이름 서버에 192.0.2.1을 추가하는 구성 예

    # ...
dns-resolver:
  config:
    server:
    - 192.0.2.1
interfaces:
  - name: eth1
    type: ethernet
    state: up
    ipv4:
      enabled: true
      dhcp: true
      auto-dns: true
# ...
    Copy to Clipboard Toggle word wrap

  • DNS 값을 전역적으로 저장하기 위해 nmstate API를 사용하는 기본 방식 대신 DNS 값을 저장하도록 네트워크 인터페이스를 구성해야 하는 경우, 네트워크 인터페이스 YAML 파일에서 정적 DNS 값과 정적 IP 주소를 설정할 수 있습니다.

    중요

    네트워크 인터페이스 수준에서 DNS 값을 저장하면 인터페이스를 OVS(Open vSwitch) 브리지, Linux 브리지 또는 본드와 같은 네트워크 구성 요소에 연결한 후 이름 확인 문제가 발생할 수 있습니다.

    인터페이스 수준에서 DNS 값을 저장하는 구성 예

    # ...
dns-resolver:
  config:
    server:
    - 2001:db8:1::d1
    - 2001:db8:1::d2
    - 192.0.2.1
    search:
    - example.com
    - example.org
interfaces:
  - name: eth1
    type: ethernet
    state: up
    ipv4:
      address:
      - ip: 192.0.2.251
        prefix-length: 24
      dhcp: false
      enabled: true
    ipv6:
      address:
      - ip: 2001:db8:1::1
        prefix-length: 64
      dhcp: false
      enabled: true
      autoconf: false
# ...
    Copy to Clipboard Toggle word wrap

  • 네트워크 인터페이스에 대한 정적 DNS 검색 도메인과 정적 DNS 이름 서버를 설정하려면 네트워크 인터페이스 YAML 구성 파일에서 DHCP(동적 호스트 구성 프로토콜) 또는 IPv6 자동 구성( autoconf ) 메커니즘을 실행하는 정적 인터페이스를 정의합니다.

    중요

    네트워크 인터페이스 YAML 파일에서 다음 dns-resolver 구성을 지정하면 재부팅 시 경쟁 조건이 발생하여 클러스터에서 실행되는 Pod에 NodeNetworkConfigurationPolicy (NNCP)가 적용되지 않을 수 있습니다.

    • 네트워크 인터페이스에 대한 정적 DNS 검색 도메인과 동적 DNS 이름 서버를 설정합니다.
    • 검색 매개변수에 도메인 접미사를 지정하고 서버 매개변수에 IP 주소를 설정하지 않습니다.

    example.com 및 example.org 정적 DNS 검색 도메인과 정적 DNS 이름 서버 설정을 설정하는 예제 구성

    # ...
dns-resolver:
  config:
    server:
    - 2001:db8:f::1
    - 192.0.2.251
    search:
    - example.com
    - example.org
interfaces:
  - name: eth1
    type: ethernet
    state: up
    ipv4:
      enabled: true
      dhcp: true
      auto-dns: true
    ipv6:
      enabled: true
      dhcp: true
      autoconf: true
      auto-dns: true
# ...
    Copy to Clipboard Toggle word wrap

1.11.6. 고정 라우팅
링크 복사

다음 스니펫에서는 eth1 인터페이스에 고정 경로와 고정 IP를 구성합니다. 

dns-resolver:
  config:
# ...
interfaces:
  - name: eth1
    description: Static routing on eth1
    type: ethernet
    state: up
    ipv4:
      dhcp: false
      enabled: true
      address:
      - ip: 192.0.2.251
1 

        prefix-length: 24
routes:
  config:
  - destination: 198.51.100.0/24
    metric: 150
    next-hop-address: 192.0.2.1
2 

    next-hop-interface: eth1
    table-id: 254
# ...
Copy to Clipboard Toggle word wrap
1
이더넷 인터페이스의 고정 IP 주소입니다.
2
노드 트래픽에 대한 다음 홉 주소입니다. 이더넷 인터페이스에 설정된 IP 주소와 동일한 서브넷에 있어야 합니다.
중요

사용자 지정 br- ex 브리지를 수동으로 구성하지 않는 한 정적 경로를 구성할 때 OVN-Kubernetes br- ex 브리지를 다음 홉 인터페이스로 사용할 수 없습니다.

자세한 내용은 베어 메탈에 설치 관리자 프로비저닝 클러스터 배포 문서 또는 베어 메탈에 사용자 프로비저닝 클러스터 설치 문서에서 "사용자 지정 br-ex 브리지를 포함하는 매니페스트 개체 만들기"를 참조하세요.

맨 위로 이동
Red Hat logoGithubredditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

Red Hat을 사용하는 고객은 신뢰할 수 있는 콘텐츠가 포함된 제품과 서비스를 통해 혁신하고 목표를 달성할 수 있습니다. 최신 업데이트를 확인하세요.

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat은 코드, 문서, 웹 속성에서 문제가 있는 언어를 교체하기 위해 최선을 다하고 있습니다. 자세한 내용은 다음을 참조하세요.Red Hat 블로그.

Red Hat 소개

Red Hat은 기업이 핵심 데이터 센터에서 네트워크 에지에 이르기까지 플랫폼과 환경 전반에서 더 쉽게 작업할 수 있도록 강화된 솔루션을 제공합니다.

Theme

© 2025 Red Hat