22.5. SR-IOV 이더넷 네트워크 연결 구성

22.5.1. 이더넷 장치 구성 오브젝트

SriovNetwork 오브젝트를 정의하여 이더넷 네트워크 장치를 구성할 수 있습니다.

다음 YAML은 SriovNetwork 오브젝트를 설명합니다.

apiVersion: sriovnetwork.openshift.io/v1
kind: SriovNetwork
metadata:
  name: <name> 1
  namespace: openshift-sriov-network-operator 2
spec:
  resourceName: <sriov_resource_name> 3
  networkNamespace: <target_namespace> 4
  vlan: <vlan> 5
  spoofChk: "<spoof_check>" 6
  ipam: |- 7
    {}
  linkState: <link_state> 8
  maxTxRate: <max_tx_rate> 9
  minTxRate: <min_tx_rate> 10
  vlanQoS: <vlan_qos> 11
  trust: "<trust_vf>" 12
  capabilities: <capabilities> 13

1: 오브젝트의 이름입니다. SR-IOV Network Operator는 동일한 이름으로 NetworkAttachmentDefinition 오브젝트를 생성합니다.
2: SR-IOV Network Operator가 설치된 네임스페이스입니다.
3: 이 추가 네트워크에 대한 SR-IOV 하드웨어를 정의하는 SriovNetworkNodePolicy 오브젝트의 spec.resourceName 매개변수 값입니다.
4: SriovNetwork 오브젝트의 대상 네임스페이스입니다. 대상 네임스페이스의 포드만 추가 네트워크에 연결할 수 있습니다.
5: 선택사항: 추가 네트워크의 VLAN(Virtual LAN) ID입니다. 정수 값은 0에서 4095 사이여야 합니다. 기본값은 0입니다.
6: 선택사항: VF의 스푸핑 검사 모드입니다. 허용되는 값은 문자열 "on" 및 "off"입니다.
중요
SR-IOV Network Operator가 지정한 값을 따옴표로 묶거나 오브젝트를 거부해야 합니다.
7: YAML 블록 스칼라로서의 IPAM CNI 플러그인의 구성 오브젝트입니다. 플러그인은 연결 정의에 대한 IP 주소 할당을 관리합니다.
8: 선택사항: VF(가상 기능)의 링크 상태입니다. 허용되는 값은 enable, disable 및 auto입니다.
9: 선택사항: VF의 경우 최대 전송 속도(Mbps)입니다.
10: 선택사항: VF의 경우 최소 전송 속도(Mbps)입니다. 이 값은 최대 전송 속도보다 작거나 같아야 합니다.
참고
인텔 NIC는 minTxRate 매개변수를 지원하지 않습니다. 자세한 내용은 BZ#1772847에서 참조하십시오.
11: 선택사항: VF의 IEEE 802.1p 우선순위 수준입니다. 기본값은 0입니다.
12: 선택사항: VF의 신뢰 모드입니다. 허용되는 값은 문자열 "on" 및 "off"입니다.
중요
지정한 값을 따옴표로 묶어야 합니다. 그렇지 않으면 SR-IOV Network Operator에서 오브젝트를 거부합니다.
13: 선택사항: 이 추가 네트워크에 구성할 수 있는 기능입니다. '{ "ips": true }' 를 지정하여 IP 주소 지원을 활성화하거나 '{ "mac": true}' 를 지정하여 MAC 주소 지원을 활성화할 수 있습니다.

22.5.1.1. 추가 네트워크에 대한 IP 주소 할당 구성

IP 주소 관리(IPAM) CNI(Container Network Interface) 플러그인은 다른 CNI 플러그인의 IP 주소를 제공합니다.

다음 IP 주소 할당 유형을 사용할 수 있습니다.

정적 할당
DHCP 서버를 통한 동적 할당. 지정한 DHCP 서버는 추가 네트워크에서 연결할 수 있어야 합니다.
Whereabouts IPAM CNI 플러그인을 통한 동적 할당

22.5.1.1.1. 고정 IP 주소 할당 구성

다음 표에서는 고정 IP 주소 할당 구성에 대해 설명합니다.

표 22.4. IPAM 고정 구성 오브젝트
필드	유형	설명
`type`	`string`	IPAM 주소 유형입니다. `static` 값이 필요합니다.
`주소`	`array`	가상 인터페이스에 할당할 IP 주소를 지정하는 오브젝트의 배열입니다. IPv4 및 IPv6 IP 주소가 모두 지원됩니다.
`routes`	`array`	Pod 내부에서 구성할 경로를 지정하는 오브젝트의 배열입니다.
`dns`	`array`	선택 사항: DNS 구성을 지정하는 오브젝트 배열입니다.

address 배열에는 다음 필드가 있는 오브젝트가 필요합니다.

표 22.5. IPAM.addresses[] 배열
필드	유형	설명
`address`	`string`	지정하는 IP 주소 및 네트워크 접두사입니다. 예를 들어 `10.10.21.10/24`를 지정하면 추가 네트워크에 IP 주소 `10.10.21.10`이 할당되고 넷마스크는 `255.255.255.0`입니다.
`gateway`	`string`	송신 네트워크 트래픽을 라우팅할 기본 게이트웨이입니다.

표 22.6. ipam.routes[] array
필드	유형	설명
`dst`	`string`	CIDR 형식의 IP 주소 범위(예: 기본 경로의 경우 `192.168.17.0/24` 또는 `0.0.0.0/0` )입니다.
`GW`	`string`	네트워크 트래픽이 라우팅되는 게이트웨이입니다.

표 22.7. IPAM.dns 오브젝트
필드	유형	설명
`네임서버`	`array`	DNS 쿼리를 보낼 하나 이상의 IP 주소로 이루어진 배열입니다.
`domain`	`array`	호스트 이름에 추가할 기본 도메인입니다. 예를 들어 도메인이 `example.com`으로 설정되면 `example-host`에 대한 DNS 조회 쿼리가 `example-host.example.com`으로 다시 작성됩니다.
`search`	`array`	DNS 조회 쿼리 중에 규정되지 않은 호스트 이름(예: `example-host`)에 추가할 도메인 이름 배열입니다.

고정 IP 주소 할당 구성 예

{
  "ipam": {
    "type": "static",
      "addresses": [
        {
          "address": "191.168.1.7/24"
        }
      ]
  }
}

22.5.1.1.2. DHCP(Dynamic IP 주소) 할당 구성

다음 JSON은 DHCP를 사용한 동적 IP 주소 할당 구성을 설명합니다.

DHCP 리스 갱신

pod는 생성될 때 원래 DHCP 리스를 얻습니다. 리스는 클러스터에서 실행되는 최소 DHCP 서버 배포를 통해 주기적으로 갱신되어야 합니다.

SR-IOV Network Operator는 DHCP 서버 배포를 생성하지 않습니다. Cluster Network Operator자는 최소 DHCP 서버 배포를 생성합니다.

DHCP 서버 배포를 트리거하려면 다음 예와 같이 Cluster Network Operator 구성을 편집하여 shim 네트워크 연결을 만들어야 합니다.

shim 네트워크 연결 정의 예

apiVersion: operator.openshift.io/v1
kind: Network
metadata:
  name: cluster
spec:
  additionalNetworks:
  - name: dhcp-shim
    namespace: default
    type: Raw
    rawCNIConfig: |-
      {
        "name": "dhcp-shim",
        "cniVersion": "0.3.1",
        "type": "bridge",
        "ipam": {
          "type": "dhcp"
        }
      }
  # ...

표 22.8. IPAM DHCP 구성 오브젝트
필드	유형	설명
`type`	`string`	IPAM 주소 유형입니다. `dhcp` 값은 필수입니다.

DHCP(Dynamic IP 주소) 할당 구성 예

{
  "ipam": {
    "type": "dhcp"
  }
}

22.5.1.1.3. Whereabouts를 사용한 동적 IP 주소 할당 구성

Whereabouts CNI 플러그인을 사용하면 DHCP 서버를 사용하지 않고도 IP 주소를 추가 네트워크에 동적으로 할당할 수 있습니다.

Whereabouts CNI 플러그인은 별도의 NetworkAttachmentDefinitions 내에서 동일한 CIDR 범위의 중복 IP 주소 범위 및 구성을 여러 번 지원합니다. 이를 통해 멀티 테넌트 환경에서 유연성 및 관리 기능이 향상됩니다.

22.5.1.1.3.1. 동적 IP 주소 구성 오브젝트

다음 표에서는 Whereabouts를 사용하여 동적 IP 주소 할당을 위한 구성 오브젝트를 설명합니다.

표 22.9. IPAM 위치 설정 오브젝트
필드	유형	설명
`type`	`string`	IPAM 주소 유형입니다. 여기서about `s` 값이 필요합니다.
`range`	`string`	CIDR 표기법의 IP 주소 및 범위입니다. IP 주소는 이 주소 범위 내에서 할당됩니다.
`exclude`	`array`	선택 사항: CIDR 표기법의 0개 이상의 IP 주소 및 범위 목록입니다. 제외된 주소 범위 내의 IP 주소는 할당되지 않습니다.
`network_name`	`string`	선택 사항: Pod의 각 그룹 또는 도메인이 동일한 IP 주소 범위를 공유하는 경우에도 자체 IP 주소 집합을 갖도록 합니다. 이 필드를 설정하는 것은 특히 다중 테넌트 환경에서 네트워크를 분리하고 정리하는 데 중요합니다.

22.5.1.1.3.2. Whereabouts를 사용하는 동적 IP 주소 할당 구성

다음 예제에서는 Whereabouts를 사용하는 동적 주소 할당 구성을 보여줍니다.

Whereabouts dynamic IP address assignment

{
  "ipam": {
    "type": "whereabouts",
    "range": "192.0.2.192/27",
    "exclude": [
       "192.0.2.192/30",
       "192.0.2.196/32"
    ]
  }
}

22.5.1.1.3.3. IP 주소 범위가 겹치는 Whereabouts를 사용하는 동적 IP 주소 할당

다음 예제에서는 다중 테넌트 네트워크에 겹치는 IP 주소 범위를 사용하는 동적 IP 주소 할당을 보여줍니다.

NetworkAttachmentDefinition 1

{
  "ipam": {
    "type": "whereabouts",
    "range": "192.0.2.192/29",
    "network_name": "example_net_common", 1
  }
}

1: 선택 사항: 설정된 경우 NetworkAttachmentDefinition 2의 network_name 과 일치해야 합니다.

NetworkAttachmentDefinition 2

{
  "ipam": {
    "type": "whereabouts",
    "range": "192.0.2.192/24",
    "network_name": "example_net_common", 1
  }
}

1: 선택 사항: 설정된 경우 NetworkAttachmentDefinition 1의 network_name 과 일치해야 합니다.

22.5.1.2. 동적으로 듀얼 스택 IP 주소 할당을 위한 구성 생성

듀얼 스택 IP 주소 할당은 다음과 같은 ipRanges 매개변수를 사용하여 구성할 수 있습니다.

IPv4 주소
IPv6 주소
여러 IP 주소 할당

프로세스

type 을 whereabouts로 설정합니다.

다음 예와 같이 ipRanges 를 사용하여 IP 주소를 할당합니다.

cniVersion: operator.openshift.io/v1
kind: Network
=metadata:
  name: cluster
spec:
  additionalNetworks:
  - name: whereabouts-shim
    namespace: default
    type: Raw
    rawCNIConfig: |-
      {
       "name": "whereabouts-dual-stack",
       "cniVersion": "0.3.1,
       "type": "bridge",
       "ipam": {
         "type": "whereabouts",
         "ipRanges": [
                  {"range": "192.168.10.0/24"},
                  {"range": "2001:db8::/64"}
              ]
       }
      }

Pod에 네트워크를 연결합니다. 자세한 내용은 "추가 네트워크에 Pod 추가"를 참조하십시오.
모든 IP 주소가 할당되었는지 확인합니다.
다음 명령을 실행하여 IP 주소가 메타데이터로 할당되었는지 확인합니다.
```
$ oc exec -it mypod -- ip a
```

추가 리소스

추가 네트워크에 pod 연결

22.5.2. SR-IOV 추가 네트워크 구성

SriovNetwork 오브젝트를 생성하여 SR-IOV 하드웨어를 사용하는 추가 네트워크를 구성할 수 있습니다. SriovNetwork 오브젝트를 생성하면 SR-IOV Network Operator가 NetworkAttachmentDefinition 오브젝트를 자동으로 생성합니다.

참고

SriovNetwork 오브젝트가 running 상태의 Pod에 연결된 경우 해당 오브젝트를 수정하거나 삭제하지 마십시오.

사전 요구 사항

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

프로세스

SriovNetwork 오브젝트를 생성한 다음 <name>.yaml 파일에 YAML을 저장합니다. 여기서 <name>은 이 추가 네트워크의 이름입니다. 오브젝트 사양은 다음 예와 유사할 수 있습니다.

apiVersion: sriovnetwork.openshift.io/v1
kind: SriovNetwork
metadata:
  name: attach1
  namespace: openshift-sriov-network-operator
spec:
  resourceName: net1
  networkNamespace: project2
  ipam: |-
    {
      "type": "host-local",
      "subnet": "10.56.217.0/24",
      "rangeStart": "10.56.217.171",
      "rangeEnd": "10.56.217.181",
      "gateway": "10.56.217.1"
    }

오브젝트를 생성하려면 다음 명령을 입력합니다:
```
$ oc create -f <name>.yaml
```
여기서 <name>은 추가 네트워크의 이름을 지정합니다.
선택사항: 이전 단계에서 생성한 SriovNetwork 오브젝트에 연결된 NetworkAttachmentDefinition 오브젝트가 존재하는지 확인하려면 다음 명령을 입력합니다. <namespace>를 SriovNetwork 오브젝트에 지정한 networkNamespace로 바꿉니다.
```
$ oc get net-attach-def -n <namespace>
```

22.5.3. 다음 단계

SR-IOV 추가 네트워크에 pod 추가

22.5.4. 추가 리소스

SR-IOV 네트워크 장치 구성

22.5. SR-IOV 이더넷 네트워크 연결 구성

22.5.1. 이더넷 장치 구성 오브젝트

22.5.1.1. 추가 네트워크에 대한 IP 주소 할당 구성

22.5.1.1.1. 고정 IP 주소 할당 구성

22.5.1.1.2. DHCP(Dynamic IP 주소) 할당 구성

22.5.1.1.3. Whereabouts를 사용한 동적 IP 주소 할당 구성

22.5.1.1.3.1. 동적 IP 주소 구성 오브젝트

22.5.1.1.3.2. Whereabouts를 사용하는 동적 IP 주소 할당 구성

22.5.1.1.3.3. IP 주소 범위가 겹치는 Whereabouts를 사용하는 동적 IP 주소 할당

22.5.1.2. 동적으로 듀얼 스택 IP 주소 할당을 위한 구성 생성

22.5.2. SR-IOV 추가 네트워크 구성

22.5.3. 다음 단계

22.5.4. 추가 리소스

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

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

Red Hat 소개

Red Hat legal and privacy links

Red Hat legal and privacy links