31장. UserDefinedNetwork [k8s.ovn.org/v1]


설명
UserDefinedNetwork는 네임스페이스에 대한 네트워크 요청을 설명합니다.
유형
object
필수 항목
  • spec

31.1. 사양

Expand
속성유형설명

apiVersion

string

APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

kind

string

kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

메타데이터

ObjectMeta

표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

spec

object

UserDefinedNetworkSpec은 UserDefinedNetworkSpec의 원하는 상태를 정의합니다.

status

object

UserDefinedNetworkStatus에는 UserDefinedNetwork의 관찰된 상태가 포함됩니다.

31.1.1. .spec

설명
UserDefinedNetworkSpec은 UserDefinedNetworkSpec의 원하는 상태를 정의합니다.
유형
object
필수 항목
  • 토폴로지
Expand
속성유형설명

layer2

object

Layer2는 Layer2 토폴로지 구성입니다.

layer3

object

Layer3은 Layer3 토폴로지 구성입니다.

토폴로지

string

토폴로지는 네트워크 구성을 설명합니다.

허용되는 값은 "Layer3", "Layer2"입니다. Layer3 토폴로지는 노드당 계층 2 세그먼트를 생성합니다. 각각 다른 서브넷을 사용합니다. 계층 3 라우팅은 노드 서브넷을 상호 연결하는 데 사용됩니다. Layer2 토폴로지는 모든 노드에서 공유하는 하나의 논리 스위치를 생성합니다.

31.1.2. .spec.layer2

설명
Layer2는 Layer2 토폴로지 구성입니다.
유형
object
필수 항목
  • role
Expand
속성유형설명

ipam

object

IPAM 섹션에는 네트워크에 대한 IPAM 관련 구성이 포함되어 있습니다.

joinSubnets

배열(문자열)

JoinSubnets는 OVN 네트워크 토폴로지 내에서 사용됩니다.

듀얼 스택 클러스터는 2개의 서브넷(IP 제품군마다 하나씩)을 설정할 수 있으며, 그렇지 않으면 서브넷은 1개만 허용됩니다. 이 필드는 "기본" 네트워크에만 허용됩니다. OVN 네트워크 토폴로지에 대한 명시적 필요 및 이해없이 이 필드를 설정하지 않는 것이 좋습니다. 생략하면 플랫폼은 시간이 지남에 따라 변경될 수 있는 적절한 기본값을 선택합니다.

mtu

integer

MTU는 네트워크의 최대 전송 단위입니다. MTU는 선택 사항이며 제공되지 않는 경우 네트워크에 전역적으로 구성된 OVN-Kubernetes 값(기본값: 1400)이 사용됩니다.

role

string

역할은 Pod의 네트워크 역할을 설명합니다.

허용되는 값은 "Secondary"입니다. 보조 네트워크는 k8s.v1.cni.cncf.io/networks 주석을 사용하여 지정된 네트워크를 선택하는 Pod에만 할당됩니다.

subnets

배열(문자열)

서브넷은 클러스터 전체의 pod 네트워크에 사용됩니다. 듀얼 스택 클러스터는 2개의 서브넷(IP 제품군마다 하나씩)을 설정할 수 있으며, 그렇지 않으면 서브넷은 1개만 허용됩니다.

형식은 표준 CIDR 표기법과 일치해야 합니다(예: "10.128.0.0/16"). ipam.modeDisabled 인 경우 이 필드를 생략해야 합니다.

31.1.3. .spec.layer2.ipam

설명
IPAM 섹션에는 네트워크에 대한 IPAM 관련 구성이 포함되어 있습니다.
유형
object
Expand
속성유형설명

라이프 사이클

string

라이프사이클은 IP 주소 관리 라이프사이클을 제어합니다.

허용되는 값은 Persistent입니다. 설정하면 OVN Kubernetes 할당된 IP 주소가 ipamclaims.k8s.cni.cncf.io 오브젝트에 유지됩니다. 요청된 경우 다른 Pod에서 이러한 IP 주소를 재사용합니다. 모드가 활성화된 경우에만 지원됩니다.

mode

string

모드는 OVN에서 관리할 IP 구성의 양을 제어합니다. 활성화하면 OVN-Kubernetes가 SDN 인프라에 IP 구성을 적용하고 선택한 서브넷의 IP도 개별 Pod에 할당합니다. 비활성화됨 은 OVN-Kubernetes가 MAC 주소만 할당하고 계층 2 통신을 제공하여 사용자가 Pod의 IP 주소를 구성할 수 있음을 의미합니다. 비활성화 는 보조 네트워크에서만 사용할 수 있습니다. IPAM을 비활성화하면 IP를 통해 Pod를 선택하는 데 의존하는 Kubernetes 기능이 더 이상 작동하지 않습니다(예: 네트워크 정책, 서비스 등). 또한 이 네트워크에 연결된 인터페이스에 대해 IP 포트 보안도 비활성화됩니다. 기본값은 enabled입니다.

31.1.4. .spec.layer3

설명
Layer3은 Layer3 토폴로지 구성입니다.
유형
object
필수 항목
  • role
  • subnets
Expand
속성유형설명

joinSubnets

배열(문자열)

JoinSubnets는 OVN 네트워크 토폴로지 내에서 사용됩니다.

듀얼 스택 클러스터는 2개의 서브넷(IP 제품군마다 하나씩)을 설정할 수 있으며, 그렇지 않으면 서브넷은 1개만 허용됩니다. 이 필드는 "기본" 네트워크에만 허용됩니다. OVN 네트워크 토폴로지에 대한 명시적 필요 및 이해없이 이 필드를 설정하지 않는 것이 좋습니다. 생략하면 플랫폼은 시간이 지남에 따라 변경될 수 있는 적절한 기본값을 선택합니다.

mtu

integer

MTU는 네트워크의 최대 전송 단위입니다.

MTU는 선택 사항이며 제공되지 않는 경우 네트워크에 전역적으로 구성된 OVN-Kubernetes 값(기본값: 1400)이 사용됩니다.

role

string

역할은 Pod의 네트워크 역할을 설명합니다.

허용되는 값은 "기본" 및 "Secondary"입니다. 기본 네트워크는 동일한 네임스페이스에서 생성된 모든 pod에 자동으로 할당됩니다. 보조 네트워크는 k8s.v1.cni.cncf.io/networks 주석을 사용하여 지정된 네트워크를 선택하는 Pod에만 할당됩니다.

subnets

array

서브넷은 클러스터 전체의 pod 네트워크에 사용됩니다.

듀얼 스택 클러스터는 2개의 서브넷(IP 제품군마다 하나씩)을 설정할 수 있으며, 그렇지 않으면 서브넷은 1개만 허용됩니다. 지정된 서브넷은 모든 노드의 더 작은 서브넷으로 나뉩니다.

subnets[]

object

 

31.1.5. .spec.layer3.subnets

설명

서브넷은 클러스터 전체의 pod 네트워크에 사용됩니다.

듀얼 스택 클러스터는 2개의 서브넷(IP 제품군마다 하나씩)을 설정할 수 있으며, 그렇지 않으면 서브넷은 1개만 허용됩니다. 지정된 서브넷은 모든 노드의 더 작은 서브넷으로 나뉩니다.

유형
array

31.1.6. .spec.layer3.subnets[]

설명
유형
object
필수 항목
  • cidr
Expand
속성유형설명

cidr

string

CIDR은 모든 노드의 작은 서브넷으로 분할되는 L3Subnet을 지정합니다.

hostSubnet

integer

HostSubnet은 모든 노드의 서브넷 크기를 지정합니다.

설정하지 않으면 자동으로 할당됩니다.

31.1.7. .status

설명
UserDefinedNetworkStatus에는 UserDefinedNetwork의 관찰된 상태가 포함됩니다.
유형
object
Expand
속성유형설명

conditions

array

 

conditions[]

object

condition에는 이 API 리소스의 현재 상태에 대한 한 가지 측면에 대한 세부 정보가 포함되어 있습니다.

31.1.8. .status.conditions

설명
유형
array

31.1.9. .status.conditions[]

설명
condition에는 이 API 리소스의 현재 상태에 대한 한 가지 측면에 대한 세부 정보가 포함되어 있습니다.
유형
object
필수 항목
  • lastTransitionTime
  • message
  • reason
  • status
  • type
Expand
속성유형설명

lastTransitionTime

string

lastTransitionTime은 조건이 한 상태에서 다른 상태로 전환된 마지막 시간입니다. 이는 기본 조건이 변경된 시점이어야 합니다. 이를 알 수 없는 경우 API 필드가 변경된 시간을 사용합니다.

message

string

메시지는 전환에 대한 세부 정보를 나타내는 사람이 읽을 수 있는 메시지입니다. 빈 문자열일 수 있습니다.

observedGeneration

integer

observedGeneration은 조건이 설정된 .metadata.generation을 나타냅니다. 예를 들어, .metadata.generation이 현재 12이지만 .status.conditions[x].observedGeneration이 9인 경우 해당 조건은 인스턴스의 현재 상태를 기준으로 오래되었습니다.

reason

string

reason에는 조건의 마지막 전환에 대한 이유를 나타내는 프로그래밍 식별자가 포함되어 있습니다. 특정 조건 유형의 생산자는 이 필드에 대한 예상 값과 의미를 정의하고, 해당 값이 보장된 API로 간주되는지 여부를 결정할 수 있습니다. 값은 CamelCase 문자열이어야 합니다. 이 필드는 비어 있을 수 없습니다.

status

string

조건의 상태는 True, False, Unknown 중 하나입니다.

type

string

CamelCase 또는 foo.example.com/CamelCase의 조건 유형입니다.

맨 위로 이동
Red Hat logoGithubredditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

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

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

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

Red Hat 소개

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

Theme

© 2025 Red Hat