2장. 구성 파일을 사용하여 MicroShift 사용자 정의


MicroShift YAML 파일을 사용하여 기본 설정, 설정 및 매개변수를 사용자 지정합니다.

2.1. 사용자 지정 설정 사용

사용자 지정 구성을 생성하려면 /etc/microshift/ 디렉터리에 config.yaml.default 파일의 사본을 작성하고 config.yaml 의 이름을 변경합니다. 이 파일을 /etc/microshift/ 디렉터리에 보관한 다음 MicroShift를 시작하거나 다시 시작하기 전에 기본값을 재정의하는 지원되는 설정을 변경합니다.

기본 설정을 일부 변경하면 구성 드롭인 스니펫을 대체 방법으로 사용하는 것이 좋습니다.

중요

설정 설정을 변경한 후 MicroShift를 다시 시작하십시오. config.yaml 파일은 MicroShift가 시작될 때만 읽습니다.

2.1.1. 별도의 재시작

노드 전체에서 구성 변경 사항을 적용하려면 MicroShift 노드와 함께 사용되는 애플리케이션 및 기타 선택적 서비스도 별도로 다시 시작해야 할 수 있습니다. 예를 들어 특정 네트워킹 설정을 변경할 때 해당 변경 사항을 적용하려면 서비스 및 애플리케이션 Pod를 중지하고 다시 시작해야 합니다. 자세한 내용은 완료 중인 작업의 각 절차를 참조하십시오.

작은 정보

동시에 필요한 모든 구성을 추가하는 경우 시스템 재시작을 최소화할 수 있습니다.

2.1.2. MicroShift config.yaml 파일의 매개변수 및 값

다음 표에서는 MicroShift 구성 YAML 매개변수 및 각각에 유효한 값을 설명합니다.

표 2.1. MicroShift config.yaml 매개변수
필드유형설명

advertiseAddress

string

API 서버가 노드 구성원에게 알리는 IP 주소를 지정하는 문자열입니다. 기본값은 서비스 네트워크의 주소를 기반으로 계산됩니다.

auditLog.maxFileAge

number

자동 삭제 전에 로그 파일이 저장되는 시간입니다. maxFileAge 매개변수의 기본값 0 은 기간에 따라 로그 파일이 삭제되지 않음을 의미합니다. 이 값을 구성할 수 있습니다.

auditLog.maxFileSize

number

기본적으로 audit.log 파일이 maxFileSize 제한에 도달하면 audit.log 파일이 순환되고 MicroShift가 새 audit.log 파일에 쓰기 시작합니다. 이 값을 구성할 수 있습니다.

auditLog.maxFiles

number

보관 중인 총 로그 파일 수입니다. 기본적으로 MicroShift는 10개의 로그 파일을 유지합니다. 가장 오래된 파일은 초과 파일이 생성될 때 삭제됩니다. 이 값을 구성할 수 있습니다.

auditLog.profile

기본,WriteRequestBodies,AllRequestBodies, 또는 None

읽기 및 쓰기 요청에 대한 메타데이터만 기록합니다. OAuth 액세스 토큰 요청을 제외하고 요청 본문을 기록하지 않습니다. 이 필드를 지정하지 않으면 Default 프로필이 사용됩니다.

namedCertificates

list

사용자 정의 인증 기관을 사용하여 외부에서 생성된 인증서 및 도메인 이름을 정의합니다.

namedCertificates.certPath

path

인증서의 전체 경로입니다.

namedCertificates.keyPath

path

인증서 키의 전체 경로입니다.

namedCertificates.names

list

선택 사항: 명시적 DNS 이름 목록을 추가합니다. 선행 와일드카드가 허용됩니다. 이름을 나열하지 않으면 암시적 이름이 인증서에서 추출됩니다.

subjectAltNames

FQDN(정규화된 도메인 이름), *.domain.com 과 같은 와일드카드 또는 IP 주소

API 서버 인증서의 제목 대체 이름입니다. Sans는 인증서로 보안되는 모든 도메인 이름 및 IP 주소를 나타냅니다.

tls

list

사용되는 TLS(전송 이후 프로토콜)와 허용되는 암호화 제품군을 정의합니다. 노출된 MicroShift API 서버 및 내부 컨트롤 플레인 엔드 포인트에 대한 보안을 제공합니다.

tls.cipherSuites

string

API 서버가 수락하고 제공하는 허용된 암호화 제품군을 나열합니다. 기본값은 tls.minVersion 매개변수에 설정된 TLS 사양으로 허용되는 암호화 제품군입니다.

tls.minVersion

VersionTLS12 or VersionTLS13

API 서버에서 제공할 최소 TLS 버전을 지정합니다. 기본값은 VersionTLS12 입니다.

debugging.logLevel

일반 , 디버그,추적 또는 TraceAll

로그 상세 정보 표시. 기본값은 Normal 입니다.

dns.baseDomain

유효한 도메인

노드의 기본 도메인입니다. 관리되는 모든 DNS 레코드는 이 기본 도메인의 하위 도메인입니다.

dns.hosts.status

enabled,Disabled

구성되지 않은 경우 기본값을 Disabled 로 설정합니다.

dns.hosts.file

문자열

기본적으로 /etc/hosts 로 설정된 filepath.

etcd.memoryLimitMB

number

기본적으로 etcd 는 시스템의 부하를 처리하는 데 필요한 만큼의 메모리를 사용합니다. 그러나 메모리 제한 시스템에서는 etcd 가 지정된 시간에 사용할 수 있는 메모리 양을 제한하는 것이 바람직하거나 필요할 수 있습니다.

generic.Device.Plugin.devices

groups

플러그인에서 노출할 장치 정의를 나열합니다. 각 장치 항목에는 'name'과 그룹 목록이 포함되어 있습니다.

generic.Device.Plugin.devices.groups

count,paths, 'usbs'

장치 그룹을 나열합니다. 그룹 내의 장치는 공통 이름으로 장치 풀을 구성합니다. 해당 풀에서 장치를 요청하면 다른 정의된 경로에서 장치를 수신할 수 있습니다.

generic.Device.Plugin.devices.groups.count

number

이 장치 그룹을 동시에 마운트할 수 있는 횟수를 지정합니다. 지정되지 않은 경우 Count의 기본값은 1입니다. 높은 수(예: /dev/fuse )에 대해 1000 을 설정하는 것은 고유한 제한이 없기 때문에 가능하지만, 호스트 기능 및 장치의 특성에 따라 성능에 영향을 미칠 수 있습니다.

generic.Device.Plugin.devices.groups.paths

string

호스트 장치 파일 경로를 나열합니다. 경로는 와일드카드 패턴일 수 있습니다. 예를 들어 /dev/ttyUSB 에서는 일치하는 각 장치가 예약 가능한 개수 시간입니다. 이 필드는 USB에 한정되어 있습니다. 동일한 장치 그룹에서 두 매개변수를 모두 정의할 수 없습니다.

generic.Device.Plugin.devices.groups.paths.limit

number

그룹 내의 다른 장치가 더 많은 일치를 생성할 때 이 장치를 동시에 사용할 수 있는 횟수까지 지정합니다. 예를 들어 그룹의 한 경로가 5 장치와 일치하고 다른 경로가 1 장치와 일치하지만 제한이 10이면 그룹은 5 쌍의 장치를 제공합니다. 지정되지 않은 경우 제한의 기본값은 1 입니다.

generic.Device.Plugin.devices.groups.paths.mountPath

string

컨테이너 내에서 호스트 장치를 마운트해야 하는 파일 경로입니다. 지정되지 않은 경우 mountPath의 기본값은 path 입니다.

generic.Device.Plugin.devices.groups.paths.path

string

호스트에 있는 장치의 파일 경로입니다. 예를 들어 /dev/video0,/dev/ttyUSB*.

generic.Device.Plugin.devices.groups.paths.permissions

r, w, m

마운트된 장치에 부여된 파일 시스템 권한입니다. 장치 유형의 마운트에만 적용됩니다. 다음 중 하나 이상일 수 있습니다.

  • R을 사용하면 컨테이너가 지정된 장치에서 읽을 수 있습니다.
  • W를 사용하면 컨테이너가 지정된 장치에 쓸 수 있습니다.
  • m 을 사용하면 컨테이너가 아직 존재하지 않는 장치 파일을 만들 수 있습니다.

지정되지 않은 경우 기본값은 mrw 입니다.

generic.Device.Plugin.devices.groups.paths.readOnly

true, false

경로를 읽기 전용으로 마운트해야 하는지 여부를 지정합니다. 유형 마운트 에만 적용됩니다.

generic.Device.Plugin.devices.groups.paths.type

장치,마운트

이 경로가 나타내는 파일 시스템 노드 유형과 마운트 방법을 설명합니다. 지정되지 않은 경우 default 를 Device.

generic.Device.Plugin.devices.groups.usbs

string

이 장치 그룹이 구성된 USB 사양을 나열합니다. 벤더와 제품 ID는 항상 일치해야 합니다. 제공된 경우 직렬 ID가 일치하거나 ID가 비어 있는 경우 건너뛰어야 합니다. usbs 필드는 경로가 한정되어 있습니다.

generic.Device.Plugin.devices.groups.usbs.product

string

일치시킬 장치의 USB 제품 ID입니다. 예를 들면 0x7523 입니다.

generic.Device.Plugin.devices.groups.usbs.serial

string

일치시킬 장치의 일련 번호입니다. USB 장치는 통과하려면 지정된 모든 속성과 정확히 일치해야 합니다.

generic.Device.Plugin.devices.groups.usbs.vendor

string

일치시킬 장치의 USB 벤더 ID입니다. 예를 들면 0x1a86 입니다.

generic.Device.Plugin.devices.name

string

이 사양에서 설명하는 장치 종류를 나타내는 고유한 문자열입니다. 예를 들어 직렬,비디오 또는 fuse 를 예로 들 수 있습니다. 이 이름은 Pod 리소스 요청에 사용됩니다. 예를 들면 device.microshift.io/serial 입니다.

generic.Device.Plugin.domain

string

노드에 있는 장치를 알리고 있는 도메인 접두사를 지정합니다. 예를 들면 device.microshift.io/serial 입니다. 기본값은 device.microshift.io 입니다.

generic.Device.Plugin.status

enabled,Disabled

기본 GDP 상태를 지정합니다.

ingress.certificateSecret

string

Ingress 컨트롤러에서 제공하는 기본 인증서가 포함된 보안에 대한 참조입니다. 경로가 자체 인증서를 지정하지 않으면 certificateSecret 이 사용됩니다.

보안에는 다음 키와 데이터가 포함되어야 합니다.

  • TLS.crt: 인증서 파일 콘텐츠
  • TLS.key: 키 파일 콘텐츠

이러한 값 중 하나를 설정하지 않으면 와일드카드 인증서가 자동으로 생성되어 사용됩니다. 인증서는 수신 컨트롤러 도메인 및 하위 도메인 필드에 유효하며 인증서에 생성된 CA는 노드의 신뢰 저장소와 자동으로 통합됩니다.

사용 중인 모든 인증서는 MicroShift OAuth 서버에 자동으로 통합됩니다.

ingress.clientTLS

AllowedSubjectPatterns,spec.clientTLS.ClientCA,spec.clientTLS.clientCertificatePolicy

노드 및 서비스에 대한 클라이언트 액세스를 인증합니다. 이러한 설정을 사용할 때 상호 TLS 인증이 활성화됩니다. spec.clientTLS.clientCertificatePolicy 및 spec.clientTLS.ClientCA 의 값을 설정하지 않으면 클라이언트 TLS가 활성화되지 않습니다.

ingress.clientTLS.AllowedSubjectPatterns

PCRE 구문의 목록

요청을 필터링할 유효한 클라이언트 인증서의 고유 이름과 일치하는 정규식 목록을 지정하는 선택적 하위 필드입니다. 이 매개변수를 사용하여 수신 컨트롤러가 고유 이름을 기반으로 인증서를 거부하도록 합니다. PCRE(Perl Compatible Regular Expressions) 구문이 필요합니다. 이 필드를 구성하는 경우 유효한 표현식을 포함해야 합니다. 그렇지 않으면 MicroShift 서비스가 실패합니다. 클라이언트 인증서의 고유 이름과 일치하는 패턴이 하나 이상 있어야 합니다. 그렇지 않으면 Ingress 컨트롤러에서 인증서를 거부하고 연결을 거부합니다.

ingress.clientTLS.ClientCA

string

openshift-ingress 네임스페이스에 구성 맵을 지정하는 필수 하위 필드입니다. 구성 맵에는 CA 인증서 번들이 포함되어야 합니다.

ingress.clientTLS.ClientCertificatePolicy

필수 항목,선택 사항

사용자 정의 인증서와 함께 재암호화 TLS 종료를 사용하여 보안 경로를 생성하는 필수 하위 필드입니다. PEM 인코딩 파일에 인증서/키 쌍이 있고 해당 인증서가 경로 호스트에 유효해야 합니다. 수신 컨트롤러는 클라이언트 인증서만 에지 종료 및 재암호화 TLS 경로를 확인합니다. 일반 텍스트 HTTP 또는 패스스루 TLS 경로에 대한 인증서는 이 설정에서 확인되지 않습니다.

ingress.defaultHTTPVersion

number

수신에 사용할 기본 HTTP 버전을 결정합니다. 기본값은 HTTP/1.1 프로토콜인 1 입니다.

ingress.forwardedHeaderPolicy

추가,교체,IfNone,Never

Ingress 컨트롤러가 Forwarded,X-Forwarded-For,X-Forwarded-Host,X-Forwarded-Port, X-Forwarded-Proto , X-Forwarded-Proto -Version HTTP 헤더를 설정하는 시기와 방법을 지정합니다. 기본값은 Append 입니다.

  • append는 Ingress 컨트롤러에서 기존 헤더를 추가하도록 지정합니다.
  • replace 는 Ingress 컨트롤러에서 헤더를 설정하고 기존 Forwarded 또는 X-Forwarded-* 헤더를 대체하도록 지정합니다.
  • IfNone 은 Ingress 컨트롤러가 아직 설정되지 않은 경우 헤더를 설정하도록 지정합니다.
  • Never 는 Ingress 컨트롤러에서 헤더를 설정하지 않고 기존 헤더를 유지합니다.

ingress.httpCompression

object

HTTP 트래픽 압축 정책을 정의합니다. 기본적으로 HTTP 압축이 없습니다.

ingress.httpCompression.mimeTypes

배열 또는 null

압축할 MIME 유형 목록입니다. 목록이 비어 있으면 Ingress 컨트롤러에서 압축을 적용하지 않습니다. 목록을 정의하려면 메시지 본문에 있는 데이터의 유형 및 하위 유형 및 데이터의 기본 인코딩을 지정하는 RFC 1341에서 Content-Type 정의 형식을 사용합니다. 예를 들어 Content-Type := type \"/\" subtype *[\";\" 매개변수].

  • Content-Type 의 값은 application, audio, image, message, multipart, text, video 또는 custom type 앞에 \"X-\" 및 토큰 뒤에 오는 유형 중 하나일 수 있습니다. 토큰은 다음 방법 중 하나로 정의해야 합니다.
  • 토큰은 하나 이상의 문자의 문자열 이며 tspecials 세트의 공백, 제어 문자 또는 임의의 문자를 포함하지 않습니다.
  • tspecials 세트에는 문자 ()\u003c\u003e@,;:\\\"/[]?.= 가 포함됩니다.
  • Content-Type의 하위 유형도 토큰입니다.
  • 하위 유형 뒤에 있는 선택적 매개변수는 토큰 \"=\"(토큰 / quoted-string) 로 정의됩니다.
  • RFC 822에 정의된 인용 문자열 은 큰따옴표로 묶고 \\, \" 및 CR 을 제외한 공백을 더한 문자를 포함할 수 있습니다. 따옴표로 묶은 문자열 은 단일 ASCII 문자를 포함할 수도 있습니다. \\.",..

모든 MIME 유형이 압축의 이점은 아니지만 HAProxy 는 리소스를 사용하여 압축이 구성되면 파일을 압축합니다. 일반적으로 html,ccs, js 와 같은 텍스트 형식이 압축의 이점을 제공합니다. 이미지, 오디오 및 비디오와 같이 이미 압축되어 있는 파일 유형을 압축하기 위해 CPU 리소스를 소비하는 것은 제한된 이점의 가치가 없을 수 있습니다.

ingress.httpEmptyRequestsPolicy

응답 또는 무시

기본값은 Respond입니다. 요청이 수신되기 전에 연결 시간이 초과되면 HTTP 연결을 처리하는 방법에 대해 설명합니다. 이러한 연결은 일반적으로 로드 밸런서 서비스 또는 사전 연결과 같은 웹 브라우저의 예상 연결 상태 프로브에서 가져옵니다.

  • 필드가 Respond 로 설정된 경우 Ingress 컨트롤러는 "HTTP 400" 또는 "408" 응답을 전송하고 액세스 로깅이 활성화된 경우 연결을 기록하며 적절한 메트릭의 연결을 계산합니다.
  • 필드가 Ignore 로 설정된 경우 Ingress 컨트롤러는 응답을 보내거나 연결을 기록하거나 메트릭을 늘리지 않고 연결을 종료합니다. 이 필드를 Ignore 로 설정하면 문제 또는 침입을 탐지하고 진단할 수 있습니다. 특히 시간 초과 연결이 네트워크 오류 또는 포트 검사로 인해 발생하는 경우입니다. 두 경우 모두 빈 요청을 로깅하는 것은 오류를 진단하고 침입 시도를 감지하는 데 유용할 수 있습니다.

ingress.listenAddress

IP 주소, NIC 이름 또는 여러 개

기본값은 호스트의 전체 네트워크입니다. 구성 가능한 유효한 값은 단일 IP 주소 또는 NIC 이름 또는 여러 IP 주소와 NIC 이름일 수 있는 목록입니다.

ingress.logEmptyRequests

로그 또는 무시

기본값은 Log 입니다. 빈 요청을 수신하는 방법을 기록합니다. 이러한 연결은 일반적으로 로드 밸런서 서비스 상태 또는 사전 연결과 같은 웹 브라우저의 추측 연결 상태 프로브에서 가져옵니다. 일반적인 요청을 로깅하는 것은 바람직하지 않을 수 있지만 요청은 네트워크 오류 또는 포트 검사로 인해 발생할 수 있으며, 이 경우 로깅은 오류를 진단하고 침입 시도를 감지하는 데 유용할 수 있습니다.

ingress.ports.http

80

기본 포트가 표시됩니다. 구성 가능. 유효한 값은 1-65535 범위의 고유한 단일 포트입니다. ports.http 및 ports.https 필드의 값은 같을 수 없습니다.

ingress.ports.https

443

기본 포트가 표시됩니다. 구성 가능. 유효한 값은 1-65535 범위의 고유한 단일 포트입니다. ports.http 및 ports.https 필드의 값은 같을 수 없습니다.

ingress.routeAdmissionPolicy

namespaceOwnership 또는 wildcardPolicy

네임스페이스에서 클레임 허용 또는 거부와 같은 새 경로 클레임을 처리하는 정책을 정의합니다. 기본적으로 경로가 네임스페이스에서 동일한 호스트 이름의 다른 경로를 요청할 수 있습니다.

ingress.routeAdmissionPolicy.namespaceOwnership

Strict 또는 InterNamespaceAllowed

네임스페이스에서 호스트 이름 클레임을 처리하는 방법을 설명합니다. 기본값은 InterNamespaceAllowed 입니다. Strict 을 지정하면 다른 네임스페이스의 경로가 동일한 호스트 이름을 요청하는 것을 방지할 수 있습니다. 사용자 지정 MicroShift config.yaml 파일에서 값이 삭제되면 InterNamespaceAllowed 값이 자동으로 설정됩니다.

  • Strict: 경로가 네임스페이스에서 동일한 호스트 이름을 요청하는 것을 허용하지 않습니다.
  • InterNamespaceAllowed: 경로가 네임스페이스에서 동일한 호스트 이름의 다른 경로를 요청하도록 허용합니다.

ingress.routeAdmissionPolicy.wildcardPolicy

WildcardsAllowed 또는 WildcardsDisallowed

와일드카드 정책이 있는 경로를 Ingress 컨트롤러에서 처리하는 방법을 설명합니다.

  • WildcardsAllowed: 와일드카드 정책이 있는 경로가 Ingress 컨트롤러에 의해 허용됨을 나타냅니다.
  • WildcardsDisallowed: 와일드카드 정책이 None 인 경로만 Ingress 컨트롤러에 의해 허용됨을 나타냅니다. WildcardsAllowed에서 WildcardsDisallowed로 wildcardPolicy를 업데이트하면 와일드카드 정책이 Subdomain인 허용되는 경로의 작동이 중지됩니다. Ingress 컨트롤러에서 이러한 경로를 다시 생성하려면 None 의 와일드카드 정책으로 다시 생성해야 합니다. 기본 설정은 WildcardsDisallowed입니다.

ingress.status

관리 또는 제거

라우터 상태. 기본값은 Managed 입니다.

ingress.tlsSecurityProfile

object

최소 TLS 버전 및 암호화 제품군을 포함하여 수신 컨트롤러 TLS 연결에 대한 설정을 지정합니다. 프로필을 설정하지 않으면 기본값은 apiservers.config.openshift.io/cluster 리소스를 기반으로 합니다.

Ingress 컨트롤러는 기본 TLS 곡선을 알립니다. 노드가 FIPS 모드에서 실행되지 않는 경우 기본 곡선은 X25519MLKEM768,X25519,P-256,P-384, P-521 입니다. 노드가 FIPS 모드에서 실행되는 경우 곡선은 P-256,P-384 및 P-521 입니다. config.yaml 파일에서 TLS 곡선을 구성할 수 없습니다.

ingress.tlsSecurityProfile.type

Old,Intermediate,Modern,Custom

TLS 보안 프로필의 프로필 유형을 지정합니다. 기본값은 Intermediate 입니다.

Old, Intermediate 및 Modern 프로파일 유형을 사용하는 경우 유효한 프로파일 구성은 릴리스마다 변경될 수 있습니다. 예를 들어 릴리스 X.Y.Z 에 배포된 Intermediate 프로파일을 사용하기 위한 사양이 있는 경우 릴리스 X.Y.Z+1 로 업그레이드하면 새 프로필 구성이 Ingress 컨트롤러에 적용되어 롤아웃이 발생할 수 있습니다.

ingress.tlsSecurityProfile.minTLSVersion

number

Ingress 컨트롤러의 TLS 버전을 지정합니다.

최소 TLS 버전은 1.1 이며 최대 TLS 버전은 1.3 입니다.

  • 구성된 보안 프로파일의 암호 및 최소 TLS 버전은 TLSProfile 상태에 반영됩니다.
  • Ingress 컨트롤러는 Old 또는 Custom 프로파일의 TLS 1.0 을 1.1 로 변환합니다.

ingress.tuningOptions

Objects

수신 컨트롤러 Pod의 성능을 조정하는 옵션을 지정합니다.

ingress.tuningOptions.clientFinTimeout

형식 기간이있는 문자열

연결을 닫기 전에 서버/backend에 대한 클라이언트 응답을 기다리는 동안 연결이 열린 상태로 유지되는 시간을 정의합니다. 기본 제한 시간은 1s 이며 1초입니다.

ingress.tuningOptions.clientTimeout

형식 기간이있는 문자열

클라이언트 응답을 기다리는 동안 연결이 열린 상태로 유지되는 시간을 정의합니다. 기본 제한 시간은 30s 이며, 이는 30초입니다.

ingress.tuningOptions.headerBufferBytes

int32; 16384 형식 의 정수 는 HTTP/2가 활성화된 최소 값입니다.

IngressController 연결 세션에 대해 예약해야 하는 메모리 양을 바이트 단위로 설명합니다. 기본값은 바이트 32768 입니다.

  • headerBufferBytes 값이 너무 작으면 IngressController 및 headerBufferBytes 값이 너무 크면 IngressController 가 필요 이상으로 많은 메모리를 사용할 수 있으므로 이 필드를 설정하는 것이 권장되지 않습니다.

ingress.tuningOptions.headerBufferMaxRewriteBytes

정수, 포맷된 int32; 4096 은 최소값입니다.

IngressController 연결 세션에 대해 HTTP 헤더 재작성 및 추가용으로 headerBufferBytes 에서 예약해야 하는 바이트 단위의 메모리 양을 설명합니다. 기본값은 8192 바이트입니다. 들어오는 HTTP 요청은 headerBufferBytes 바이트에서 headerBufferMaxRewriteBytes 바이트를 뺀 값으로 제한됩니다. 즉 headerBufferBytes 값이 headerBufferMaxRewriteBytes 값보다 커야 합니다.

  • headerBufferMaxRewriteBytes 값이 너무 작으면 IngressController 및 headerBufferMaxRewriteBytes 값이 너무 크면 IngressController 가 필요 이상으로 많은 메모리를 사용할 수 있으므로 이 필드를 설정하는 것이 권장되지 않습니다.

ingress.tuningOptions.healthCheckInterval: ""

문자열 with pattern: ^(0|(\\.[0-9])?(ns|us| Cryostats|ms|s|m|h))$

기본 healthCheckInterval 값은 5s 이며 이는 5초입니다. 이 매개변수 값은 라우터의 구성된 백엔드의 두 연속 상태 점검 간에 라우터가 대기하는 시간을 정의합니다. 허용되는 최소 값은 1s 이고 허용되는 최대 값은 2147483647ms 이며, 이는 24.85일입니다.

  • 이 값은 모든 경로에 대해 전역적으로 적용되지만 경로 주석 router.openshift.io/haproxy.health.check.interval 로 덮어쓸 수 있습니다.
  • 10진수의 부호 없는 기간 문자열이 필요하며 각각 300ms,1.5h 또는 2h45m 과 같은 선택적 분수와 단위 접미사가 있습니다. 유효한 시간 단위는 ns,us (또는 Cryostats U+00B5 또는 Cryostats U+03BC), ms,s,m,h 입니다.
  • 이 매개변수 값을 5s 미만으로 설정하면 TCP 상태 점검이 너무 자주 발생하고 SYN 패킷의 유예로 인해 초과 트래픽이 발생할 수 있습니다.
  • 이 매개변수 값을 너무 높게 설정하면 더 이상 사용할 수 없지만 아직 탐지되지 않은 백엔드 서버로 인해 대기 시간이 증가할 수 있습니다.
  • 빈 또는 0 값은 "의견이 없음"을 의미하고 Ingress 컨트롤러는 기본값을 선택합니다. 향후 릴리스에서는 기본값이 변경될 수 있습니다.

ingress.tuningOptions.maxConnections

정수, 유효한 값은 빈,0,-1 및 범위 2000-2000000

기본값은 0.은 HAProxy 프로세스별로 설정할 수 있는 최대 동시 연결 수를 정의합니다. 이 값을 늘리면 각 Ingress 컨트롤러 Pod에서 추가 시스템 리소스 비용으로 더 많은 연결을 처리할 수 있습니다.

  • 이 필드가 비어 있거나 0 인 경우 IngressController 는 기본값 50000 을 사용하지만 향후 릴리스에서는 기본값이 변경될 수 있습니다.
  • 값이 -1 이면 HAProxy 는 실행 중인 컨테이너에서 ulimit 값으로 설정된 사용 가능한 리소스에 따라 동적으로 최대값을 계산합니다. -1 을 선택하면 자동 값이 계산되므로 각 HAProxy 프로세스가 현재 기본값인 50000 과 비교하여 상당한 메모리 사용량이 발생합니다.
  • 현재 운영 체제 제한보다 큰 값을 설정하면 HAProxy 프로세스가 시작되지 않습니다.
  • 다음 메트릭을 사용하여 라우터 컨테이너의 메모리 사용량을 모니터링할 수 있습니다.

    container_memory_working_set_bytes{container=`router`,namespace=`openshift-ingress`}`
  • 다음 메트릭을 사용하여 라우터 컨테이너에서 개별 'HAProxy'processes의 메모리 사용량을 모니터링할 수 있습니다.

    container_memory_working_set_bytes{container=`router`,namespace=`openshift-ingress`}/container_processes{container=`router`,namespace=`openshift-ingress`}

ingress.tuningOptions.serverFinTimeout

형식 기간의 문자열

연결을 닫기 전에 클라이언트에 대한 서버 또는 백엔드 응답을 기다리는 동안 연결이 열린 상태로 유지되는 시간을 정의합니다. 기본 제한 시간은 1s 입니다.

ingress.tuningOptions.serverTimeout

형식 기간의 문자열

서버 또는 백엔드 응답을 기다리는 동안 연결이 열린 상태로 유지되는 시간을 정의합니다. 기본 제한 시간은 30s 입니다.

ingress.tuningOptions.threadCount

int32 형식의 정수; 최소값은 1, 최대값은 64입니다.

HAProxy 프로세스별로 생성된 스레드 수를 정의합니다. 기본값은 4 입니다. 이 필드가 비어 있으면 기본값이 사용됩니다.

  • 이 필드를 설정하는 것은 일반적으로 권장되지 않습니다. 더 많은 스레드를 생성하면 각 Ingress 컨트롤러 Pod가 더 많은 시스템 리소스를 사용할 때 더 많은 연결을 처리할 수 있습니다. HAProxy 스레드 수를 늘리면 Ingress 컨트롤러 Pod에서 부하에서 더 많은 CPU 시간을 사용할 수 있으므로 너무 높은 경우 다른 Pod가 중단될 수 있습니다. 반대로 스레드 수를 줄이면 Ingress 컨트롤러가 제대로 작동하지 않을 수 있습니다.

ingress.tuningOptions.tlsInspectDelay

형식 기간의 문자열

라우터에서 데이터를 보유하여 일치하는 경로를 찾을 수 있는 기간을 정의합니다. 값이 너무 짧으면 라우터가 더 일치하는 인증서를 사용할 수 있는 경우에도 에지 종료 클라이언트의 기본 인증서로 되돌리거나 경로를 재암호화할 수 있습니다.

  • 기본 검사 지연은 5 초이며 대부분의 경우 충분합니다. 대기 시간이 긴 네트워크에 대해 특별히 이 구성의 값을 늘리면 SSL 핸드셰이크를 완료하는 데 지연이 발생할 수 있습니다. 구성된 값은 애플리케이션에 투명해야 합니다.

ingress.tuningOptions.tunnelTimeout

형식 기간의 문자열

터널이 유휴 상태인 동안 websockets를 포함한 터널 연결이 열린 상태로 유지되는 시간을 정의합니다. 기본 제한 시간은 1h 이며, 이는 1시간입니다.

kubelet

MicroShift 짧은 대기 시간 지침을 참조하십시오.

kubelet 노드 에이전트의 passthrough 구성에 대한 매개변수입니다. 대기 시간이 짧은 구성에 사용됩니다. 기본값은 null입니다.

매니페스트

경로 목록

매니페스트를 로드하는 데 사용할 kustomization 파일을 스캔할 파일 시스템의 위치입니다. 해당 경로만 검사하려면 경로 목록으로 설정합니다. 매니페스트 로드를 비활성화하려면 빈 목록으로 설정합니다. 목록의 항목은 여러 하위 디렉터리와 일치하도록 glob 패턴일 수 있습니다. 기본값은 /usr/lib/microshift/manifests,/usr/lib/microshift/manifests.d/, /etc/microshift/manifests, /etc/microshift/manifests.d/ 입니다.

network.clusterNetwork

IP 주소 블록

Pod IP 주소가 할당되는 IP 주소 블록입니다. IPv4는 기본 네트워크입니다. 듀얼 스택 항목이 지원됩니다. MicroShift가 시작된 후 이 필드의 첫 번째 항목은 변경할 수 없습니다. 기본 범위는 10.42.0.0/16 입니다.

network.cniPlugin

문자열

비어 있거나 "ovnk" 로 설정된 경우 Open Virtual Networking - Kubernetes(OVN-K) 네트워크 플러그인을 기본 컨테이너 네트워크 인터페이스(CNI)로 배포합니다. 지원되는 값은 empty, "" 또는 "ovnk" 입니다. "없음" 으로 설정하면 CNI가 제거되고 권장되지 않습니다. OVN-K만 MicroShift에 의해 관리됩니다.

network.multus.status

string

Multus CNI(Container Network Interface)의 배포를 제어합니다. 기본 상태는 Disabled 입니다. 값을 Enabled 로 설정하면 Multus CNI를 삭제할 수 없습니다.

network.serviceNetwork

IP 주소 블록

Kubernetes 서비스의 가상 IP 주소 블록입니다. 서비스를 위한 IP 주소 풀입니다. IPv4는 기본값입니다. 듀얼 스택 항목이 지원됩니다. MicroShift가 시작된 후 이 필드의 첫 번째 항목은 변경할 수 없습니다. 기본 범위는 10.43.0.0/16 입니다.

network.serviceNodePortRange

range

NodePort 유형의 Kubernetes 서비스에 허용되는 포트 범위입니다. 범위를 지정하지 않으면 기본 범위 30000-32767 이 사용됩니다. NodePort 가 지정되지 않은 서비스에는 이 범위에서 자동으로 할당됩니다. 이 매개변수는 MicroShift가 시작된 후 업데이트할 수 있습니다.

node.hostnameOverride

string

노드의 이름입니다. 기본값은 hostname입니다. 비어 있지 않은 경우 이 문자열은 호스트 이름 대신 노드를 식별하는 데 사용됩니다. MicroShift가 시작된 후에는 이 값을 변경할 수 없습니다.

node.nodeIP

IPv4 주소

노드의 IPv4 주소입니다. 기본값은 기본 경로의 IP 주소입니다.

nodeIPv6

IPv6 주소

듀얼 스택 구성을 위한 노드의 IPv6 주소입니다. IPv4 또는 IPv6의 단일 스택으로 구성할 수 없습니다. 기본값은 빈 값 또는 null입니다.

storage.driver

none 또는 lvms

기본값은 비어 있습니다. 빈 값 또는 null 필드는 기본값은 LVMS deployment입니다.

storage.optionalCsiComponents

array

기본값은 null 또는 빈 배열입니다. null 또는 빈 배열의 기본값은 snapshot-controller 입니다. 예상 값은 csi-snapshot-controller 또는 none 입니다. none 값은 다른 모든 값과 함께 사용할 수 없습니다.

telemetry.endpoint

https://infogw.api.openshift.com

Telemetry 데이터가 전송되는 끝점입니다. 보고된 메트릭에는 사용자 또는 개인 데이터가 포함되지 않습니다. 기본값은 https://infogw.api.openshift.com 입니다.

telemetry.status

활성화됨

Telemetry 상태: 활성화 또는 Disabled 일 수 있습니다. 기본값은 Enabled 입니다.

2.1.3. 광고 주소 네트워크 플래그 구성

apiserver.advertiseAddress 플래그는 API 서버를 노드의 멤버로 알릴 IP 주소를 지정합니다. 이 주소는 노드에서 연결할 수 있어야 합니다. 여기에서 사용자 지정 IP 주소를 설정할 수 있지만 호스트 인터페이스에 IP 주소도 추가해야 합니다.

이 매개변수를 사용자 지정하면 MicroShift가 기본 IP 주소를 br-ex 네트워크 인터페이스에 추가하는 것을 선점합니다.

중요

advertiseAddress IP 주소를 사용자 지정하는 경우 호스트 인터페이스에 IP 주소를 추가하여 MicroShift가 시작될 때 노드에서 연결할 수 있는지 확인합니다.

설정되지 않은 경우 서비스 네트워크 후 기본값은 다음 즉시 서브넷으로 설정됩니다. 예를 들어 서비스 네트워크가 10.43.0.0/16 인 경우 advertiseAddress 는 10.44.0.0/32 로 설정됩니다.

2.1.4. NodePort 서비스의 포트 범위 확장

serviceNodePortRange 설정은 NodePort 서비스에 사용 가능한 포트 범위를 확장합니다. 이 옵션은 30000-32767 범위의 특정 표준 포트를 노출해야 하는 경우에 유용합니다.

예를 들어, 클라이언트 장치에서 다른 포트를 사용할 수 없기 때문에 장치가 네트워크에 1883/tcp MQ Telemetry Transport(MQTT) 포트를 노출해야 하는 경우입니다.

중요

NodePort는 시스템 포트와 겹치기 때문에 시스템 또는 MicroShift의 오작동이 발생할 수 있습니다.

NodePort 서비스 범위를 구성할 때 다음을 고려하십시오.

  • 명시적 nodePort 선택 없이 NodePort 서비스를 생성하지 마십시오. 명시적 nodePort 를 지정하지 않으면 kube-apiserver 에 의해 포트를 임의로 할당하며 예측할 수 없습니다.
  • 장치 HostNetwork 에 대해 시스템 서비스 포트, MicroShift 포트 또는 기타 서비스에 대해 NodePort 서비스를 생성하지 마십시오.
  • 표 1은 포트 범위를 확장할 때 사용하지 않도록 포트를 지정합니다.

    표 2.2. 방지하기 위한 포트입니다.
    포트설명

    22/TCP

    SSH 포트

    80/tcp

    OpenShift 라우터 HTTP 끝점

    443/tcp

    OpenShift 라우터 HTTPS 끝점

    1936/tcp

    오늘 노출되지 않은 openshift-router의 지표 서비스

    2379/TCP

    etcd 포트

    2380/tcp

    etcd 포트

    6443

    Kubernetes API

    8445/tcp

    openshift-route-controller-manager

    9537/tcp

    CRI-o 메트릭

    10250/tcp

    kubelet

    10248/tcp

    kubelet healthz 포트

    10259/TCP

    kube 스케줄러

2.1.5. 사용자 정의 호스트 이름 구성

hosts 파일을 사용하여 Pod 워크로드에 대한 사용자 정의 호스트 이름을 확인할 수 있습니다. 이를 통해 애플리케이션은 노드 내 DNS 쿼리에 /etc/hosts 기능을 적용하여 로컬 시스템 또는 외부 서비스와 같은 고정된 호스트 이름을 확인할 수 있습니다. 이 기능은 MicroShift 구성 YAML 파일에 특정 구성을 추가하고 서비스 다시 시작을 완료하여 적용됩니다.

사전 요구 사항

  • OpenShift CLI(oc)를 설치합니다.
  • 노드에 대한 root 액세스 권한이 있어야 합니다.

절차

  1. /etc/microshift/config.yaml 파일에서 MicroShift 설정을 편집합니다.
  2. 파일 끝에 다음 호스트 구성을 추가합니다.

    dns:
     hosts:
       status: <Enabled|Disabled>
       file: <filepath>
  3. 구성 YAML 파일을 저장합니다.
  4. MicroShift 서비스를 다시 시작하여 구성 변경 사항을 활성화합니다.

    $ sudo systemctl restart microshift

    이 초기 다시 시작 후 dns.hosts.status 가 Enabled 로 설정된 경우 MicroShift는 dns.hosts.file 파일에서 업데이트를 자동으로 모니터링합니다. MicroShift 구성 YAML 파일이 다시 변경될 때까지 MicroShift 서비스를 다시 시작할 필요가 없습니다.

    참고

    /etc/hosts 파일을 저장한 후 Pod에서 변경 사항을 활성화하는 데 최대 90초가 걸립니다. 이 기간 동안 Pod에서 호스트 이름을 올바르게 확인하지 못할 수 있습니다.

2.1.6. 사용자 정의 DNS 구성 이해

기본적으로 MicroShift는 노드의 내부 CoreDNS Corefile을 렌더링합니다. MicroShift 구성 파일의 dns.configFile 매개변수를 호스트 파일 시스템에 있는 사용자 지정 Corefile의 절대 경로로 설정하여 기본 제공 구성을 교체할 수 있습니다.

기본 DNS 구성이 고급 네트워킹 요구 사항을 충족하지 않는 경우 사용자 지정 Corefile을 사용합니다. 일반적인 사용 사례에는 split-horizon DNS, 사용자 정의 전달 규칙 및 조건부 영역 위임이 포함됩니다.

주의

사용자 정의 CoreDNS 구성의 정확성을 담당합니다. 잘못된 Corefile은 DNS 확인을 중단하거나 간헐적인 오류가 발생할 수 있습니다. 사용자 지정 Corefile과 관련된 문제에 대한 Red Hat 지원은 상업적으로 합리적인 노력으로 제한됩니다. 사용자 정의 구성 없이 문제를 재현해야 할 수 있습니다.

dns.configFile 을 설정하지 않거나 값을 비워 두면 MicroShift는 기본 제공 Corefile을 사용합니다.

dns.configFile 및 dns.hosts 매개변수는 함께 사용할 수 없습니다. dns.configFile 을 설정하고 dns.hosts.status 도 Enabled 로 설정하면 MicroShift가 시작되지 않습니다.

dns.configFile 을 설정할 때 사용자 지정 Corefile은 다음 제약 조건을 충족해야 합니다. 제약 조건이 실패하면 MicroShift가 시작되지 않습니다.

  • 경로는 절대 경로여야 합니다. 예를 들어 /etc/microshift/dns/Corefile.
  • 파일이 있어야 합니다.
  • 파일은 일반 파일이어야 합니다.
  • 파일을 읽을 수 있어야 합니다.
  • 파일이 비어 있지 않아야 합니다.
  • 파일은 1MiB를 초과해서는 안 됩니다.

2.1.7. 사용자 정의 CoreDNS Corefile을 사용하여 MicroShift 구성

호스트에 사용자 정의 Corefile을 배치하고 dns.configFile 매개변수를 해당 파일을 가리키면 기본 제공 CoreDNS 구성을 교체할 수 있습니다. MicroShift는 파일 내용을 openshift-dns 네임스페이스의 dns-default 구성 맵에 복사합니다.

사전 요구 사항

  • OpenShift CLI(oc)를 설치합니다.
  • 노드에 대한 root 액세스 권한이 있어야 합니다.
  • /etc/microshift/ 디렉터리에 MicroShift config.yaml 파일을 생성하셨습니다.
  • dns.hosts.status 매개변수는 Enabled 로 설정되지 않습니다.

절차

  1. 다음 명령을 실행하여 사용자 지정 Corefile의 디렉터리를 생성합니다.

    $ sudo mkdir -p /etc/microshift/dns
  2. 사용자 지정 Corefile을 생성합니다. 다음 예제를 시작점으로 사용한 다음 환경에 필요한 전달 규칙 또는 영역 스탠자를 추가합니다.

    starter Corefile의 예

    .:5353 {
        bufsize 1232
        errors
        log . {
            class error
        }
        health {
            lameduck 20s
        }
        ready
        kubernetes cluster.local in-addr.arpa ip6.arpa {
            pods insecure
            fallthrough in-addr.arpa ip6.arpa
        }
        prometheus 127.0.0.1:9153
        forward . /etc/resolv.conf {
            policy sequential
        }
        cache 900 {
            denial 9984 30
        }
        reload
    }
    hostname.bind:5353 {
        chaos
    }

    파일을 /etc/microshift/dns/Corefile 로 저장합니다.

    중요

    CoreDNS가 구성 맵 업데이트를 적용하도록 사용자 정의 Corefile에 다시 로드 플러그인을 유지합니다. 잘못된 Corefile은 DNS 확인을 중단하거나 MicroShift가 시작되지 않을 수 있습니다.

  3. 선택 사항: 특정 업스트림 확인자에게 쿼리를 전달하려면 Corefile의 forward 스탠자를 해당 환경의 값으로 교체합니다.

    사용자 정의 전달 스탠자의 예

        forward . 192.0.2.53 {
            policy sequential
        }

  4. /etc/microshift/config.yaml 파일을 편집하고 dns.configFile 매개변수를 사용자 지정 Corefile의 절대 경로로 설정합니다.

    사용자 정의 Corefile 구성의 예

    apiServer:
    # ...
    dns:
      configFile: /etc/microshift/dns/Corefile
    # ...

    다음과 같습니다.

    dns.configFile
    호스트에서 사용자 지정 Corefile의 절대 경로를 지정합니다. 경로가 있어야 하며 읽을 수 있어야 하며 1MiB를 초과하지 않아야 합니다. 이 매개변수는 dns.hosts.status: Enabled 와 함께 사용할 수 없습니다.
    참고

    config.yaml 을 편집하는 대신 /etc/microshift/config.d/ 디렉터리의 구성 스니펫에서 동일한 매개변수를 설정할 수 있습니다.

  5. 구성 파일을 저장합니다.
  6. 다음 명령을 실행하여 MicroShift 서비스를 다시 시작하십시오.

    $ sudo systemctl restart microshift

    이 초기 재시작 후 MicroShift는 사용자 정의 Corefile에서 콘텐츠 변경을 모니터링합니다. 해당 파일에 편집을 적용하려면 MicroShift 서비스를 다시 시작하지 않습니다. 구성 YAML 파일에서 dns.configFile 경로를 변경하면 MicroShift 서비스를 다시 시작합니다.

검증

  1. 다음 명령을 실행하여 dns-default 구성 맵에 사용자 지정 Corefile이 포함되어 있는지 확인합니다.

    $ oc get configmap dns-default -n openshift-dns -o jsonpath='{.data.Corefile}{"\n"}'

    출력은 /etc/microshift/dns/Corefile 의 내용과 일치합니다.

  2. 다음 명령을 실행하여 구성 맵 주석이 사용자 지정 Corefile을 가리키는지 확인합니다.

    $ oc get configmap dns-default -n openshift-dns -o jsonpath='{.metadata.annotations.microshift\.io/dns-config-file}{"\n"}'

    출력 예

    /etc/microshift/dns/Corefile

  3. 다음 명령을 실행하여 DNS pod가 실행 중인지 확인합니다.

    $ oc get pods -n openshift-dns

    출력 예

    NAME                  READY   STATUS    RESTARTS   AGE
    dns-default-xxxxx     2/2     Running   0          1m
    node-resolver-xxxxx   1/1     Running   0          1m

2.1.8. 런타임 시 사용자 정의 Corefile 업데이트

dns.configFile 매개변수를 설정하고 MicroShift를 다시 시작하면 MicroShift는 호스트에서 사용자 지정 Corefile을 감시합니다. 해당 파일에 대한 변경 사항을 저장하면 MicroShift가 openshift-dns 네임스페이스의 dns-default 구성 맵에서 Corefile 키를 업데이트합니다. 이러한 콘텐츠 변경 사항을 적용하기 위해 MicroShift 서비스를 다시 시작하지 않습니다.

CoreDNS는 사용자 정의 Corefile에 다시 로드 플러그인이 포함된 경우에만 업데이트된 구성 맵을 적용합니다. MicroShift 또는 DNS Pod를 다시 시작하지 않고 DNS 변경 사항이 적용되도록 해당 플러그인을 파일에 보관합니다.

파일 감시자는 MicroShift가 시작될 때 설정된 Corefile 경로에만 적용됩니다. 다음과 같은 변경을 수행할 때 MicroShift 서비스를 다시 시작하십시오.

  • config.yaml 파일 또는 구성 스니펫에서 dns.configFile 값을 변경합니다.
  • config.yaml 파일 또는 구성 스니펫에서 dns.configFile 설정을 제거하고 사용자 지정 Corefile을 삭제합니다. 그런 다음 MicroShift를 다시 시작한 후 내장 Corefile을 사용합니다.
  • MicroShift 구성에서 dns.hosts 를 활성화하거나 비활성화합니다. dns.configFile 및 dns.hosts.status: Enabled 설정은 상호 배타적으로 유지됩니다.

dns.configFile 을 제거하지 않고 사용자 지정 Corefile을 삭제해도 기본 제공 구성이 복원되지 않습니다. MicroShift가 실행 중인 동안 파일 감시자는 dns-default 구성 맵의 마지막 내용을 유지합니다. 다음 시작에서 dns.configFile 이 존재하지 않는 파일을 가리키는 경우 MicroShift가 실패합니다. 파일을 삭제하기 전에 dns.configFile 설정을 제거한 다음 MicroShift 서비스를 다시 시작하십시오.

중요

MicroShift 구성 YAML 파일은 서비스가 시작될 때만 읽습니다. 런타임 감시는 config.yaml 또는 구성 스니펫에는 적용되지 않습니다. 이미 구성된 Corefile의 콘텐츠만 재시작하지 않고 동기화됩니다.

Corefile에 대한 잘못된 편집으로 인해 실행 중인 노드에서 DNS 확인이 손상될 수 있습니다. 파일을 변경한 후 dns-default 구성 맵과 DNS Pod를 확인합니다.

Red Hat logoGithubRedditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 소개

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

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

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

Red Hat 문서 정보

Legal Notice

Theme

© 2026 Red Hat
맨 위로 이동