16장. Ingress [config.openshift.io/v1]

appsDomain

string

appsDomain은 명시적 호스트를 지정하지 않고 경로가 생성될 때 도메인 필드에 지정된 대신 사용할 선택적 도메인입니다. appsDomain이 비어 있지 않은 경우 이 값은 경로의 기본 호스트 값을 생성하는 데 사용됩니다. domain과 달리 appsDomain은 설치 후 수정할 수 있습니다. 이는 새 ingresscontroller가 와일드카드 인증서로 설정되었다고 가정합니다.

componentRoutes

array

componentRoutes는 cluster-admin이 호스트 이름 및 제공 인증서를 구성할 수 있는 OpenShift 구성 요소에서 관리하는 선택적 경로 목록입니다. 이 목록에 있는 각 경로의 네임스페이스 및 이름은 status.componentRoutes 목록의 기존 항목과 일치해야 합니다. 구성 가능한 경로 세트를 확인하려면 .status.componentRoutes 목록의 네임스페이스 및 항목 이름을 확인합니다. 여기서 참여 Operator는 구성 가능한 경로의 상태를 작성합니다.

componentRoutes[]

object

ComponentRouteSpec을 사용하면 경로의 호스트 이름 및 인증서를 제공할 수 있습니다.

domain

string

도메인은 경로의 호스트 이름이 비어 있을 때 경로에 대한 기본 호스트 이름을 생성하는 데 사용됩니다. 생성된 호스트 이름은 "<route-name>.<route-namespace>.<domain>" 패턴을 따릅니다. 또한 수신에 대한 기본 와일드카드 도메인 접미사로 사용됩니다. 기본 ingresscontroller 도메인은 "*.<domain>" 패턴을 따릅니다. 설정한 후에는 도메인 변경이 현재 지원되지 않습니다.

loadBalancer

object

LoadBalancer에는 현재 클러스터의 기본 인프라 공급자뿐만 아니라 OpenShift에서 작업하는 데 필요한 로드 밸런서 세부 정보가 포함되어 있습니다.

requiredHSTSPolicies

array

requiredHSTSPolicies는 정책에 지정된 domainPattern/s 및 namespaceSelector/s와 일치하는 새로 생성 또는 업데이트된 경로에 설정해야 하는 HSTS 정책을 지정합니다. 각 requiredHSTSPolicy에는 경로 HSTS 정책 경로 주석을 검증하고 경로 승인에 영향을 미치는 domainPattern 및 maxAge가 있어야 합니다. HSTS 정책 경로 주석이 있는 경우 HSTS 정책에 대해 후보 경로를 확인합니다. "haproxy.router.openshift.io/hsts_header" E.g. haproxy.openshift.io/hsts_header: max-age=31536000;preload;includeSubDomains - 필요한HSTSPolicy domainPatern 및 선택적 namespaceSelector와 일치하는 경우 그런 다음 maxAge, preloadPolicy 및 includeSubdomainsPolicy를 허용하려면 유효해야 합니다. 그렇지 않으면 경로가 거부됩니다. - RequiredHSTSPolicies의 순서에 따라 domainPattern 및 선택적 namespaceSelector에 의해 첫 번째 일치는 경로의 승인 상태를 결정합니다. - candidate 경로가 requiredHSTSPolicy domainPattern 및 optional namespaceSelector와 일치하지 않는 경우 모든 HSTS 정책 주석을 사용할 수 있습니다. 경로가 이미 생성된 후 HSTS 정책 구성이 변경될 수 있습니다. 업데이트된 경로가 업데이트된 HSTS 정책 구성을 준수하지 않으면 이전에 승인한 경로에 대한 업데이트가 실패할 수 있습니다. 그러나 HSTS 정책 구성을 변경하면 이미 작동하지 않는 경로가 발생하지 않습니다. RequiredHSTSPolicies가 없는 경우 경로의 HSTS 정책 주석이 유효합니다.

requiredHSTSPolicies[]

object

hostname

string

hostname은 경로에서 사용해야 하는 호스트 이름입니다.

name

string

name은 사용자 지정할 경로의 논리 이름입니다. 이 componentRoute의 네임스페이스 및 이름은 경로를 사용자 지정할 경우 status.componentRoutes 목록의 해당 항목과 일치해야 합니다.

네임스페이스

string

네임스페이스는 사용자 지정할 경로의 네임스페이스입니다. 이 componentRoute의 네임스페이스 및 이름은 경로를 사용자 지정할 경우 status.componentRoutes 목록의 해당 항목과 일치해야 합니다.

servingCertKeyPairSecret

object

servingCertKeyPairSecret은 openshift-config 네임스페이스에 있는 kubernetes.io/tls 유형의 보안에 대한 참조입니다. 제공 인증서/키 쌍은 일치하고 Operator가 이 이름으로 제공하려는 의도를 이행하기 위해 사용해야 합니다. 사용자 정의 호스트 이름이 클러스터의 기본 라우팅 접미사를 사용하는 경우 제공 인증서에 대한 Secret 사양이 필요하지 않습니다.

name

string

name은 참조된 보안의 metadata.name입니다.

platform

object

플랫폼에는 인그레스 로드 밸런서의 기본 인프라 공급자와 관련된 구성이 있습니다. 생략하면 사용자에게 의견이 없으며 플랫폼은 합리적인 기본값을 선택할 수 있습니다. 이러한 기본값은 시간에 따라 변경될 수 있습니다.

AWS

object

AWS에는 Amazon Web Services 인프라 공급자와 관련된 설정이 포함되어 있습니다.

type

string

type은 클러스터의 기본 인프라 공급자입니다. 허용되는 값은 "AWS", "Azure", "BareMetal", "GCP", "Libvirt", "OpenStack", "VSphere", "oVirt", "KubeVirt", "EquinixMetal", "PowerVS", "AlibabaCloud", "Nutanix" 및 "None"입니다. 개별 구성 요소는 모든 플랫폼을 지원하지 않을 수 있으며, 해당 플랫폼을 지원하지 않는 경우 인식되지 않은 플랫폼을 None으로 처리해야 합니다.

type

string

type을 사용하면 사용자가 로드 밸런서 유형을 설정할 수 있습니다. 이 필드를 설정하면 기본 ingresscontroller가 지정된 LBType을 사용하여 생성됩니다. 이 필드를 설정하지 않으면 LBType Classic의 기본 수신 컨트롤러가 생성됩니다. 유효한 값은 * "Classic": 전송 계층(TCP/SSL) 또는 애플리케이션 계층(HTTP/HTTPS)에서 라우팅을 결정하는 Classic Load Balancer입니다. 자세한 내용은 https://docs.aws.amazon.com/AmazonECS/latest/developerguide/load-balancer-types.html#clb * "NLB": 전송 계층(TCP/SSL)에서 라우팅을 결정하는 네트워크 로드 밸런서 장치입니다. 자세한 내용은 다음을 참조하십시오. https://docs.aws.amazon.com/AmazonECS/latest/developerguide/load-balancer-types.html#nlb

domainPatterns

배열(문자열)

domainPatterns는 원하는 HSTS 주석이 필요한 도메인 목록입니다. domainPatterns가 지정되고 도메인 중 하나와 일치하는 spec.host로 경로가 생성되는 경우 경로는 일치하는 RequiredHSTSPolicy에 설명된 HSTS 정책 구성 요소를 지정해야 합니다. 다음과 같이 와일드카드를 사용할 수 있습니다. .foo.com은 foo.com 아래의 모든 항목과 일치하므로 foo.com과 그 아래의 모든 항목을 포함하려면 *를 지정해야 합니다.

includeSubDomainsPolicy

string

includeSubDomainsPolicy는 HSTS 정책이 호스트 도메인 이름의 모든 하위 도메인에 적용되어야 함을 의미합니다. 따라서 호스트 bar.foo.com의 경우 includeSubDomainsPolicy가 RequireIncludeSubDomains로 설정된 경우 - 호스트 app.bar.foo.com은 bar.foo.com의 HSTS 정책을 상속합니다 - host bar.foo.com은 bar.foo.com의 HSTS 정책을 상속합니다. foo.com은 bar.foo.com의 HSTS 정책을 상속하지 않습니다.

maxAge

object

maxAge는 HSTS 호스트로 간주되는 호스트 중 delta 시간 범위(초)입니다. 0으로 설정하면 효과가 무효화되고 호스트는 HSTS 호스트로 제거됩니다. 0으로 설정하고 includeSubdomains가 지정되면 호스트의 모든 하위 도메인도 HSTS 호스트로 제거됩니다. maxAge는 time-to-live 값이며 이 정책이 클라이언트에서 새로 고쳐지지 않으면 HSTS 정책이 결국 해당 클라이언트에 만료됩니다.

namespaceSelector

object

namespaceSelector는 선택기와 일치하는 라벨이 있고 DomainPatterns 중 하나에 있는 네임스페이스에 있는 네임스페이스에만 정책이 적용되도록 라벨 선택기를 지정합니다. 기본값은 모든 것과 일치하는 빈 LabelSelector입니다.

preloadPolicy

string

preloadPolicy는 클라이언트에서 HSTS 헤더를 가져오기 위해 초기 로드를 수행할 필요가 없도록 호스트 preload 목록에 호스트를 포함하도록 지시합니다(이는 RFC 6797에 정의되어 있지 않으며 따라서 클라이언트 구현에 종속적임).

largestMaxAge

integer

RequiredHSTSPolicy max-age 이 값은 지정되지 않은 상태로 둘 수 있으며 이 경우 상한이 적용되지 않습니다.

smallestMaxAge

integer

RequiredHSTSPolicy max-age Setting max-age=0의 최소 허용된 값(초)에서는 호스트에서 기존 HSTS 헤더를 삭제할 수 있습니다. 이는 관리자가 오류를 신속하게 수정하는 데 필요한 도구입니다. 이 값은 지정되지 않은 상태로 둘 수 있습니다. 이 경우 더 낮은 제한이 적용되지 않습니다.

matchExpressions

array

matchExpressions는 라벨 선택기 요구 사항 목록입니다. 요구 사항은 AND로 설정됩니다.

matchExpressions[]

object

레이블 선택기 요구 사항은 값, 키 및 키와 관련된 연산자를 포함하는 선택기입니다.

matchLabels

오브젝트(문자열)

matchLabels는 {key,value} 쌍으로 구성된 맵입니다. matchLabels 맵의 단일 {key,value}는 키 필드가 "key"이고, 연산자는 "In"이고, values 배열에는 "value"만 포함된 matchExpressions 요소와 동일합니다. 요구 사항은 AND로 설정됩니다.

key

string

key는 선택기가 적용되는 라벨 키입니다.

operator

string

Operator는 일련의 값과의 키 관계를 나타냅니다. 유효한 연산자는 In, NotIn, Exists 및 DoesNotExist입니다.

값

배열(문자열)

값은 문자열 값의 배열입니다. 연산자가 In 또는 NotIn인 경우 값 배열은 비어 있지 않아야 합니다. 연산자가 Exists 또는 DoesNotExist인 경우 값 배열은 비어 있어야 합니다. 이 배열은 전략적 병합 패치 중에 교체됩니다.

componentRoutes

array

componentRoutes는 참여 연산자가 cluster-admin에 의해 호스트 이름 및 제공 인증서를 사용자 지정할 수 있는 경로에 대한 현재 경로 상태를 배치하는 위치입니다.

componentRoutes[]

object

ComponentRouteStatus에는 경로의 호스트 이름 구성 및 제공 인증서를 허용하는 정보가 포함되어 있습니다.

defaultPlacement

string

기본적으로 Ingress 라우터 Pod를 호스팅할 노드를 제어하기 위해 설치 시 defaultPlacement가 설정됩니다. 옵션은 control-plane 노드 또는 작업자 노드입니다. 이 필드는 해당 배포를 생성할 때 IngressController 리소스에서 Cluster Ingress Operator가 설정되지 않은 복제본 및 nodePlacement 필드를 구성하는 방법을 사전 지정하여 작동합니다. 자세한 내용은 IngressController replicas 및 nodePlacement 필드에 대한 설명서를 참조하십시오. 생략하면 기본값은 Workers입니다.

conditions

array

조건은 componentRoutes 항목의 상태를 전달하는 데 사용됩니다. 지원되는 상태에는 Available, Degraded 및 Progressing이 포함됩니다. 사용 가능한 경우 경로에서 제공하는 콘텐츠에 사용자가 액세스할 수 있습니다. 여기에는 cluster-admin에서 지정한 사용자 지정 경로가 구성된 동안 기본값이 계속 콘텐츠를 제공할 수 있는 경우가 포함됩니다. Degraded가 true인 경우 componentRoutes 항목을 처리하려고 하는 데 문제가 발생했습니다. currentHostnames 필드는 적용되거나 적용되지 않을 수 있습니다. Progressing이 true인 경우 구성 요소가 componentRoutes 항목과 관련된 몇 가지 작업을 수행 중임을 의미합니다.

conditions[]

object

condition에는 이 API 리소스의 현재 상태에 대한 세부 정보가 포함됩니다. --- 이 구조는 필드 경로 .status.conditions에서 배열로 직접 사용하기 위한 것입니다. 예를 들어 FooStatus struct{ // foo의 현재 상태의 관찰을 나타냅니다. // knownn .status.conditions.type are: "Available", "Progressing", and "Degraded" // +patchStrategy=merge // +listType=map // +listKey=type // +listKey=type [] omitempty" patchStrategy:"merge" patchMergeKey:"type" protobuf:"bytes,1,rep,name=conditions" // 기타 필드 }

consumingUsers

배열(문자열)

consumingUsers는 servingCertKeyPairSecret 보안에 대한 읽기 권한이 필요한 ServiceAccounts 슬라이스입니다.

currentHostnames

배열(문자열)

currentHostnames는 경로에서 사용하는 현재 이름 목록입니다. 일반적으로 이 목록은 단일 호스트 이름으로 구성되어야 하지만 경로에서 여러 호스트 이름을 지원하는 경우 Operator는 이 목록에 여러 항목을 작성할 수 있습니다.

defaultHostname

string

defaultHostName은 사용자 지정 전에 이 경로의 호스트 이름입니다.

name

string

name은 사용자 지정할 경로의 논리 이름입니다. 경로 리소스의 실제 이름일 필요는 없지만 이름을 변경할 수 없습니다. 이 componentRoute의 네임스페이스 및 이름은 경로를 사용자 지정할 경우 spec.componentRoutes 목록의 해당 항목과 일치해야 합니다.

네임스페이스

string

네임스페이스는 사용자 지정할 경로의 네임스페이스입니다. 실제 네임스페이스여야 합니다. 실제 네임스페이스를 사용하면 두 구성 요소가 충돌하지 않으며 동일한 구성 요소를 여러 번 설치할 수 있습니다. 이 componentRoute의 네임스페이스 및 이름은 경로를 사용자 지정할 경우 spec.componentRoutes 목록의 해당 항목과 일치해야 합니다.

relatedObjects

array

relatedObjects는 spec.componentRoutes가 적용되는 방법을 디버깅하거나 검사할 때 유용한 리소스 목록입니다.

relatedObjects[]

object

ObjectReference에는 참조된 오브젝트를 검사하거나 수정할 수 있는 충분한 정보가 포함되어 있습니다.

lastTransitionTime

string

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

message

string

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

observedGeneration

integer

observedGeneration은 조건에 따라 설정된 .metadata.generation을 나타냅니다. 예를 들어 .metadata.generation이 현재 12이지만 .status.conditions[x].observedGeneration이 9인 경우 현재 인스턴스 상태와 관련된 조건이 최신 상태가 아닙니다.

reason

string

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

status

string

조건의 상태, True, False, 알 수 없음.

type

string

CamelCase 또는 foo.example.com/CamelCase의 조건 유형. --- many .condition.type 값은 Available와 같은 리소스 간에 일관되지만 임의의 조건이 유용할 수 있으므로 (.node.status.conditions 참조), deconflict 기능이 중요합니다. 정규 표현식이 일치하는 정규 표현식은 (dns1123SubdomainFmt/)?(qualifiedNameFmt)입니다.

group

string

추천자 그룹입니다.

name

string

추천자의 이름입니다.

네임스페이스

string

참조의 네임스페이스입니다.

resource

string

참조 항목의 리소스입니다.