Red Hat Summit Red Hat SummitSupportoConsoleSviluppatoriInizia una provaContatti

Questo contenuto non è disponibile nella lingua selezionata.

Chapter 3. Using configuration snippets

To configure one or two settings in Red Hat build of MicroShift, use the /etc/microshift/config.d/ configuration directory to drop in configuration snippet YAML files. Restart MicroShift for new or changed snippets to apply.

3.1. How configuration snippets work
Copia collegamento

Configuration snippets in Red Hat build of MicroShift are YAML files in /etc/microshift/config.d/ that merge with the existing configuration at runtime. You can use them to change one or two settings without editing the main config file.

You must restart MicroShift for new configurations to apply.

To return to previous values, you can delete a configuration snippet and restart MicroShift.

At runtime, the YAML files inside /etc/microshift/config.d are merged into the existing MicroShift configuration, whether that configuration is a result of default values or a user-created config.yaml file. You do not need to create a config.yaml file to use a configuration snippet.

Files in the snippet directory are sorted in lexicographical order and run sequentially. You can use numerical prefixes for snippets so that each is read in the order you want. The last-read file takes precedence when there is more than one YAML for the same parameter.

Important

Configuration snippets take precedence over both default values and a customized config.yaml configuration file.

3.2. Examples of configuration snippet lists or arrays
Copia collegamento

Lists and arrays in Red Hat build of MicroShift configuration snippets are overwritten, not merged.

For example, you can replace a SAN or list of SANs by creating an additional snippet for the same field that is read after the first:

MicroShift configuration directory contents
/etc/microshift/config.yaml.default or /etc/microshift/config.yaml
Example MicroShift configuration snippet directory contents
/etc/microshift/config.d/10-san.yaml and /etc/microshift/config.d/20-san.yaml

Example 10-san.yaml snippet

apiServer:
  subjectAltNames:
    - host1
    - host2
Copy to Clipboard Toggle word wrap

Example 20-san.yaml snippet

apiServer:
  subjectAltNames:
    - hostZ
Copy to Clipboard Toggle word wrap

Example configuration result

apiServer:
  subjectAltNames:
    - hostZ
Copy to Clipboard Toggle word wrap

If you want to add a value to an existing list, you can add it to an existing snippet. For example, to add hostZ to an existing list of SANs, edit the snippet you have instead of creating a new one:

Example 10-san.yaml snippet

apiServer:
  subjectAltNames:
    - host1
    - host2
    - hostZ
Copy to Clipboard Toggle word wrap

Example configuration result

apiServer:
  subjectAltNames:
    - host1
    - host2
    - hostZ
Copy to Clipboard Toggle word wrap

3.3. Example configuration snippets that are objects
Copia collegamento

Object fields in Red Hat build of MicroShift are merged together when you use a configuration snippet.

Example 10-advertiseAddress.yaml snippet

apiServer:
  advertiseAddress: "microshift-example"
Copy to Clipboard Toggle word wrap

Example 20-audit-log.yaml snippet

apiServer:
  auditLog:
    maxFileAge: 12
Copy to Clipboard Toggle word wrap

Example configuration result

apiServer:
  advertiseAddress: "microshift-example"
  auditLog:
    maxFileAge: 12
Copy to Clipboard Toggle word wrap

3.4. Examples of mixed configuration snippets
Copia collegamento

When you use mixed configuration snippets in Red Hat build of MicroShift, object fields merge and the last-read snippet replaces list values. File order controls which list entries apply.

In the following example, the values of both advertiseAddress and auditLog.maxFileAge fields merge into the configuration, but only the c.com and d.com subjectAltNames values are retained. This happens because the numbering in the filename indicates that the c.com and d.com values are higher priority.

Example 10-advertiseAddress.yaml snippet

apiServer:
  advertiseAddress: "microshift-example"
Copy to Clipboard Toggle word wrap

Example 20-audit-log.yaml snippet

apiServer:
  auditLog:
    maxFileAge: 12
Copy to Clipboard Toggle word wrap

Example 30-SAN.yaml snippet

apiServer:
  subjectAltNames:
    - a.com
    - b.com
Copy to Clipboard Toggle word wrap

Example 40-SAN.yaml snippet

apiServer:
  subjectAltNames:
    - c.com
    - d.com
Copy to Clipboard Toggle word wrap

Example configuration result

apiServer:
  advertiseAddress: "microshift-example"
  auditLog:
    maxFileAge: 12
  subjectAltNames:
    - c.com
    - d.com
Copy to Clipboard Toggle word wrap

Red Hat logoGithubredditYoutubeTwitter

Formazione

Prova, acquista e vendi

Community

Informazioni sulla documentazione di Red Hat

Aiutiamo gli utenti Red Hat a innovarsi e raggiungere i propri obiettivi con i nostri prodotti e servizi grazie a contenuti di cui possono fidarsi. Esplora i nostri ultimi aggiornamenti.

Rendiamo l’open source più inclusivo

Red Hat si impegna a sostituire il linguaggio problematico nel codice, nella documentazione e nelle proprietà web. Per maggiori dettagli, visita il Blog di Red Hat.

Informazioni su Red Hat

Forniamo soluzioni consolidate che rendono più semplice per le aziende lavorare su piattaforme e ambienti diversi, dal datacenter centrale all'edge della rete.

Theme

© 2026 Red HatTorna in cima