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 매개변수 및 각각에 유효한 값을 설명합니다.
| 필드 | 유형 | 설명 |
|---|---|---|
|
|
| API 서버가 노드 구성원에게 알리는 IP 주소를 지정하는 문자열입니다. 기본값은 서비스 네트워크의 주소를 기반으로 계산됩니다. |
|
|
|
자동 삭제 전에 로그 파일이 저장되는 시간입니다. |
|
|
|
기본적으로 |
|
|
| 보관 중인 총 로그 파일 수입니다. 기본적으로 MicroShift는 10개의 로그 파일을 유지합니다. 가장 오래된 파일은 초과 파일이 생성될 때 삭제됩니다. 이 값을 구성할 수 있습니다. |
|
|
|
읽기 및 쓰기 요청에 대한 메타데이터만 기록합니다. OAuth 액세스 토큰 요청을 제외하고 요청 본문을 기록하지 않습니다. 이 필드를 지정하지 않으면 |
|
|
| 사용자 정의 인증 기관을 사용하여 외부에서 생성된 인증서 및 도메인 이름을 정의합니다. |
|
|
| 인증서의 전체 경로입니다. |
|
|
| 인증서 키의 전체 경로입니다. |
|
|
| 선택 사항: 명시적 DNS 이름 목록을 추가합니다. 선행 와일드카드가 허용됩니다. 이름을 나열하지 않으면 암시적 이름이 인증서에서 추출됩니다. |
|
|
FQDN(정규화된 도메인 이름), | API 서버 인증서의 제목 대체 이름입니다. Sans는 인증서로 보안되는 모든 도메인 이름 및 IP 주소를 나타냅니다. |
|
|
| 사용되는 TLS(전송 이후 프로토콜)와 허용되는 암호화 제품군을 정의합니다. 노출된 MicroShift API 서버 및 내부 컨트롤 플레인 엔드 포인트에 대한 보안을 제공합니다. |
|
|
|
API 서버가 수락하고 제공하는 허용된 암호화 제품군을 나열합니다. 기본값은 |
|
|
|
API 서버에서 제공할 최소 TLS 버전을 지정합니다. 기본값은 |
|
|
|
로그 상세 정보 표시. 기본값은 |
|
|
| 노드의 기본 도메인입니다. 관리되는 모든 DNS 레코드는 이 기본 도메인의 하위 도메인입니다. |
|
|
|
구성되지 않은 경우 기본값을 |
|
|
|
기본적으로 |
|
|
|
기본적으로 |
|
|
| 플러그인에서 노출할 장치 정의를 나열합니다. 각 장치 항목에는 'name'과 그룹 목록이 포함되어 있습니다. |
|
|
| 장치 그룹을 나열합니다. 그룹 내의 장치는 공통 이름으로 장치 풀을 구성합니다. 해당 풀에서 장치를 요청하면 다른 정의된 경로에서 장치를 수신할 수 있습니다. |
|
|
|
이 장치 그룹을 동시에 마운트할 수 있는 횟수를 지정합니다. 지정되지 않은 경우 Count의 기본값은 1입니다. 높은 수(예: |
|
|
|
호스트 장치 파일 경로를 나열합니다. 경로는 와일드카드 패턴일 수 있습니다. 예를 들어 |
|
|
|
그룹 내의 다른 장치가 더 많은 일치를 생성할 때 이 장치를 동시에 사용할 수 있는 횟수까지 지정합니다. 예를 들어 그룹의 한 경로가 5 장치와 일치하고 다른 경로가 1 장치와 일치하지만 제한이 10이면 그룹은 5 쌍의 장치를 제공합니다. 지정되지 않은 경우 제한의 기본값은 |
|
|
|
컨테이너 내에서 호스트 장치를 마운트해야 하는 파일 경로입니다. 지정되지 않은 경우 mountPath의 기본값은 |
|
|
|
호스트에 있는 장치의 파일 경로입니다. 예를 들어 |
|
|
|
마운트된 장치에 부여된 파일 시스템 권한입니다.
지정되지 않은 경우 기본값은 |
|
|
|
경로를 읽기 전용으로 마운트해야 하는지 여부를 지정합니다. 유형 |
|
|
|
이 |
|
|
|
이 장치 그룹이 구성된 USB 사양을 나열합니다. 벤더와 제품 ID는 항상 일치해야 합니다. 제공된 경우 직렬 ID가 일치하거나 ID가 비어 있는 경우 건너뛰어야 합니다. |
|
|
|
일치시킬 장치의 USB 제품 ID입니다. 예를 들면 |
|
|
| 일치시킬 장치의 일련 번호입니다. USB 장치는 통과하려면 지정된 모든 속성과 정확히 일치해야 합니다. |
|
|
|
일치시킬 장치의 USB 벤더 ID입니다. 예를 들면 |
|
|
|
이 사양에서 설명하는 장치 종류를 나타내는 고유한 문자열입니다. 예를 들어 |
|
|
|
노드에 있는 장치를 알리고 있는 도메인 접두사를 지정합니다. 예를 들면 |
|
|
| 기본 GDP 상태를 지정합니다. |
|
|
|
Ingress 컨트롤러에서 제공하는 기본 인증서가 포함된 보안에 대한 참조입니다. 경로가 자체 인증서를 지정하지 않으면 보안에는 다음 키와 데이터가 포함되어야 합니다.
이러한 값 중 하나를 설정하지 않으면 와일드카드 인증서가 자동으로 생성되어 사용됩니다. 인증서는 수신 컨트롤러 사용 중인 모든 인증서는 MicroShift OAuth 서버에 자동으로 통합됩니다. |
|
|
|
노드 및 서비스에 대한 클라이언트 액세스를 인증합니다. 이러한 설정을 사용할 때 상호 TLS 인증이 활성화됩니다. |
|
|
| 요청을 필터링할 유효한 클라이언트 인증서의 고유 이름과 일치하는 정규식 목록을 지정하는 선택적 하위 필드입니다. 이 매개변수를 사용하여 수신 컨트롤러가 고유 이름을 기반으로 인증서를 거부하도록 합니다. PCRE(Perl Compatible Regular Expressions) 구문이 필요합니다. 이 필드를 구성하는 경우 유효한 표현식을 포함해야 합니다. 그렇지 않으면 MicroShift 서비스가 실패합니다. 클라이언트 인증서의 고유 이름과 일치하는 패턴이 하나 이상 있어야 합니다. 그렇지 않으면 Ingress 컨트롤러에서 인증서를 거부하고 연결을 거부합니다. |
|
|
|
|
|
|
| 사용자 정의 인증서와 함께 재암호화 TLS 종료를 사용하여 보안 경로를 생성하는 필수 하위 필드입니다. PEM 인코딩 파일에 인증서/키 쌍이 있고 해당 인증서가 경로 호스트에 유효해야 합니다. 수신 컨트롤러는 클라이언트 인증서만 에지 종료 및 재암호화 TLS 경로를 확인합니다. 일반 텍스트 HTTP 또는 패스스루 TLS 경로에 대한 인증서는 이 설정에서 확인되지 않습니다. |
|
|
|
수신에 사용할 기본 HTTP 버전을 결정합니다. 기본값은 HTTP/1.1 프로토콜인 |
|
|
|
Ingress 컨트롤러가
|
|
|
| HTTP 트래픽 압축 정책을 정의합니다. 기본적으로 HTTP 압축이 없습니다. |
|
|
|
압축할 MIME 유형 목록입니다. 목록이 비어 있으면 Ingress 컨트롤러에서 압축을 적용하지 않습니다. 목록을 정의하려면 메시지 본문에 있는 데이터의 유형 및 하위 유형 및 데이터의 기본 인코딩을 지정하는 RFC 1341에서 Content-Type 정의 형식을 사용합니다. 예를 들어
모든 MIME 유형이 압축의 이점은 아니지만 |
|
|
|
기본값은
|
|
| IP 주소, NIC 이름 또는 여러 개 | 기본값은 호스트의 전체 네트워크입니다. 구성 가능한 유효한 값은 단일 IP 주소 또는 NIC 이름 또는 여러 IP 주소와 NIC 이름일 수 있는 목록입니다. |
|
|
|
기본값은 |
|
|
|
기본 포트가 표시됩니다. 구성 가능. 유효한 값은 |
|
|
|
기본 포트가 표시됩니다. 구성 가능. 유효한 값은 |
|
|
| 네임스페이스에서 클레임 허용 또는 거부와 같은 새 경로 클레임을 처리하는 정책을 정의합니다. 기본적으로 경로가 네임스페이스에서 동일한 호스트 이름의 다른 경로를 요청할 수 있습니다. |
|
|
|
네임스페이스에서 호스트 이름 클레임을 처리하는 방법을 설명합니다. 기본값은
|
|
|
| 와일드카드 정책이 있는 경로를 Ingress 컨트롤러에서 처리하는 방법을 설명합니다.
|
|
|
|
라우터 상태. 기본값은 |
|
|
|
최소 TLS 버전 및 암호화 제품군을 포함하여 수신 컨트롤러 TLS 연결에 대한 설정을 지정합니다. 프로필을 설정하지 않으면 기본값은
Ingress 컨트롤러는 기본 TLS 곡선을 알립니다. 노드가 FIPS 모드에서 실행되지 않는 경우 기본 곡선은 |
|
|
|
TLS 보안 프로필의 프로필 유형을 지정합니다. 기본값은
|
|
|
| Ingress 컨트롤러의 TLS 버전을 지정합니다.
최소 TLS 버전은
|
|
| Objects | 수신 컨트롤러 Pod의 성능을 조정하는 옵션을 지정합니다. |
|
|
형식 |
연결을 닫기 전에 서버/backend에 대한 클라이언트 응답을 기다리는 동안 연결이 열린 상태로 유지되는 시간을 정의합니다. 기본 제한 시간은 |
|
|
형식 |
클라이언트 응답을 기다리는 동안 연결이 열린 상태로 유지되는 시간을 정의합니다. 기본 제한 시간은 |
|
|
|
|
|
|
|
|
|
|
|
기본
|
|
|
|
기본값은
|
|
|
형식 |
연결을 닫기 전에 클라이언트에 대한 서버 또는 백엔드 응답을 기다리는 동안 연결이 열린 상태로 유지되는 시간을 정의합니다. 기본 제한 시간은 |
|
|
형식 |
서버 또는 백엔드 응답을 기다리는 동안 연결이 열린 상태로 유지되는 시간을 정의합니다. 기본 제한 시간은 |
|
|
|
|
|
|
형식 | 라우터에서 데이터를 보유하여 일치하는 경로를 찾을 수 있는 기간을 정의합니다. 값이 너무 짧으면 라우터가 더 일치하는 인증서를 사용할 수 있는 경우에도 에지 종료 클라이언트의 기본 인증서로 되돌리거나 경로를 재암호화할 수 있습니다.
|
|
|
형식 |
터널이 유휴 상태인 동안 websockets를 포함한 터널 연결이 열린 상태로 유지되는 시간을 정의합니다. 기본 제한 시간은 |
|
| MicroShift 짧은 대기 시간 지침을 참조하십시오. | kubelet 노드 에이전트의 passthrough 구성에 대한 매개변수입니다. 대기 시간이 짧은 구성에 사용됩니다. 기본값은 null입니다. |
|
|
|
매니페스트를 로드하는 데 사용할 |
|
| IP 주소 블록 |
Pod IP 주소가 할당되는 IP 주소 블록입니다. IPv4는 기본 네트워크입니다. 듀얼 스택 항목이 지원됩니다. MicroShift가 시작된 후 이 필드의 첫 번째 항목은 변경할 수 없습니다. 기본 범위는 |
|
| 문자열 |
비어 있거나 |
|
|
|
Multus CNI(Container Network Interface)의 배포를 제어합니다. 기본 상태는 |
|
| IP 주소 블록 |
Kubernetes 서비스의 가상 IP 주소 블록입니다. 서비스를 위한 IP 주소 풀입니다. IPv4는 기본값입니다. 듀얼 스택 항목이 지원됩니다. MicroShift가 시작된 후 이 필드의 첫 번째 항목은 변경할 수 없습니다. 기본 범위는 |
|
|
|
|
|
|
| 노드의 이름입니다. 기본값은 hostname입니다. 비어 있지 않은 경우 이 문자열은 호스트 이름 대신 노드를 식별하는 데 사용됩니다. MicroShift가 시작된 후에는 이 값을 변경할 수 없습니다. |
|
| IPv4 주소 | 노드의 IPv4 주소입니다. 기본값은 기본 경로의 IP 주소입니다. |
|
| IPv6 주소 | 듀얼 스택 구성을 위한 노드의 IPv6 주소입니다. IPv4 또는 IPv6의 단일 스택으로 구성할 수 없습니다. 기본값은 빈 값 또는 null입니다. |
|
|
| 기본값은 비어 있습니다. 빈 값 또는 null 필드는 기본값은 LVMS deployment입니다. |
|
|
|
기본값은 null 또는 빈 배열입니다. null 또는 빈 배열의 기본값은 |
|
|
Telemetry 데이터가 전송되는 끝점입니다. 보고된 메트릭에는 사용자 또는 개인 데이터가 포함되지 않습니다. 기본값은 | |
|
|
|
Telemetry 상태: |
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 액세스 권한이 있어야 합니다.
절차
-
/etc/microshift/config.yaml파일에서 MicroShift 설정을 편집합니다. 파일 끝에 다음
호스트구성을 추가합니다.dns: hosts: status: <Enabled|Disabled> file: <filepath>- 구성 YAML 파일을 저장합니다.
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/디렉터리에 MicroShiftconfig.yaml파일을 생성하셨습니다. -
dns.hosts.status매개변수는Enabled로 설정되지 않습니다.
절차
다음 명령을 실행하여 사용자 지정 Corefile의 디렉터리를 생성합니다.
$ sudo mkdir -p /etc/microshift/dns사용자 지정 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가 시작되지 않을 수 있습니다.선택 사항: 특정 업스트림 확인자에게 쿼리를 전달하려면 Corefile의
forward스탠자를 해당 환경의 값으로 교체합니다.사용자 정의 전달 스탠자의 예
forward . 192.0.2.53 { policy sequential }/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/디렉터리의 구성 스니펫에서 동일한 매개변수를 설정할 수 있습니다.- 구성 파일을 저장합니다.
다음 명령을 실행하여 MicroShift 서비스를 다시 시작하십시오.
$ sudo systemctl restart microshift이 초기 재시작 후 MicroShift는 사용자 정의 Corefile에서 콘텐츠 변경을 모니터링합니다. 해당 파일에 편집을 적용하려면 MicroShift 서비스를 다시 시작하지 않습니다. 구성 YAML 파일에서
dns.configFile경로를 변경하면 MicroShift 서비스를 다시 시작합니다.
검증
다음 명령을 실행하여
dns-default구성 맵에 사용자 지정 Corefile이 포함되어 있는지 확인합니다.$ oc get configmap dns-default -n openshift-dns -o jsonpath='{.data.Corefile}{"\n"}'출력은
/etc/microshift/dns/Corefile의 내용과 일치합니다.다음 명령을 실행하여 구성 맵 주석이 사용자 지정 Corefile을 가리키는지 확인합니다.
$ oc get configmap dns-default -n openshift-dns -o jsonpath='{.metadata.annotations.microshift\.io/dns-config-file}{"\n"}'출력 예
/etc/microshift/dns/Corefile다음 명령을 실행하여 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를 확인합니다.