이 콘텐츠는 선택한 언어로 제공되지 않습니다.

Chapter 1. How configuration tools work


A YAML file customizes Red Hat build of MicroShift instances with your preferences, settings, and parameters.

1.1. Using a YAML configuration file

Red Hat build of MicroShift searches for a configuration file in the user-specific directory, ~/.microshift/config.yaml, then the system-wide /etc/microshift/config.yaml directory. You must create the configuration file and specify any settings that should override the defaults before starting Red Hat build of MicroShift.

1.1.1. Default settings

If you do not create a config.yaml file, the default values are used. The following example configuration contains the default settings. You must change any settings that should override the defaults before starting Red Hat build of MicroShift.

Default YAML file example

dns:
  baseDomain: microshift.example.com 
1

network:
  clusterNetwork:
    - cidr: 10.42.0.0/16 
2

  serviceNetwork:
    - 10.43.0.0/16 
3

  serviceNodePortRange: 30000-32767 
4

node:
  hostnameOverride: "" 
5

  nodeIP: "" 
6

apiServer:
  subjectAltNames: [] 
7

debugging:
  logLevel: "Normal" 
8
Copy to Clipboard Toggle word wrap

1
Base domain of the cluster. All managed DNS records will be subdomains of this base.
2
A block of IP addresses from which Pod IP addresses are allocated.
3
A block of virtual IP addresses for Kubernetes services.
4
The port range allowed for Kubernetes services of type NodePort.
5
The name of the node. The default value is the hostname.
6
The IP address of the node. The default value is the IP address of the default route.
7
Subject Alternative Names for API server certificates.
8
Log verbosity. Valid values for this field are Normal, Debug, Trace, or TraceAll.
Note

Red Hat build of MicroShift only reads the configuration file on startup. Restart Red Hat build of MicroShift after changing any configuration settings to have them take effect.

1.2. Extending the port range for NodePort services

The serviceNodePortRange setting allows the extension of the port range available to NodePort services. This option is useful when specific standard ports under the 30000-32767 need to be exposed. For example, your device needs to expose the 1883/tcp MQ Telemetry Transport (MQTT) port on the network because some client devices cannot use a different port.

Important

NodePorts can overlap with system ports, causing a malfunction of the system or Red Hat build of MicroShift.

Considerations when configuring the NodePort service ranges:

  • Do not create any NodePort service without an explicit nodePort selection. In this case, the port is assigned randomly by the kube-apiserver.
  • Do not create any NodePort service for any system service port, Red Hat build of MicroShift port, or other services you expose on your device HostNetwork.
  • Table one specifies ports to avoid when extending the port range:
Expand
Table 1.1. Ports to avoid.
PortDescription

22/tcp

SSH port

80/tcp

OpenShift Router HTTP endpoint

443/tcp

OpenShift Router HTTPS endpoint

1936/tcp

Metrics service for the openshift-router, not exposed today

2379/tcp

etcd port

2380/tcp

etcd port

6443

kubernetes API

8445/tcp

openshift-route-controller-manager

9537/tcp

cri-o metrics

10250/tcp

kubelet

10248/tcp

kubelet healthz port

10259/tcp

kube scheduler

맨 위로 이동
Red Hat logoGithubredditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

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

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

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

Red Hat 소개

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

Theme

© 2025 Red Hat