1
0
mirror of https://github.com/openshift/openshift-docs.git synced 2026-02-05 12:46:18 +01:00
Files
openshift-docs/modules/microshift-manifests-overview.adoc
2025-10-07 17:43:41 +00:00

56 lines
2.6 KiB
Plaintext

// Module included in the following assemblies:
//
// * microshift//running_applications/microshift-applications.adoc
:_mod-docs-content-type: CONCEPT
[id="microshift-manifests-overview_{context}"]
= How Kustomize works with manifests to deploy applications
The `kustomize` configuration management tool is integrated with {microshift-short}. You can use Kustomize and the {oc-first} together to apply customizations to your application manifests and deploy those applications to a {microshift-short} node.
* A `kustomization.yaml` file is a specification of resources plus customizations.
* Kustomize uses a `kustomization.yaml` file to load a resource, such as an application, then applies any changes you want to that application manifest and produces a copy of the manifest with the changes overlaid.
* Using a manifest copy with an overlay keeps the original configuration file for your application intact, while enabling you to deploy iterations and customizations of your applications efficiently.
* You can then deploy the application in your {microshift-short} node with an `oc` command.
[NOTE]
====
At each system start, {microshift-short} deletes the manifests found in the `delete` subdirectories and then applies the manifest files found in the manifest directories to the node.
====
[id="how-microshift-uses-manifests"]
== How {microshift-short} uses manifests
At every start, {microshift-short} searches the following manifest directories for Kustomize manifest files:
* `/etc/microshift/manifests`
* `/etc/microshift/manifests.d/++*++`
* `/usr/lib/microshift/`
* `/usr/lib/microshift/manifests.d/++*++`
{microshift-short} automatically runs the equivalent of the `kubectl apply -k` command to apply the manifests to the node if any of the following file types exists in the searched directories:
* `kustomization.yaml`
* `kustomization.yml`
* `Kustomization`
This automatic loading from multiple directories means you can manage {microshift-short} workloads with the flexibility of having different workloads run independently of each other.
.{microshift-short} manifest directories
[cols="2",options="header"]
|===
|Location
|Intent
|`/etc/microshift/manifests`
|Read-write location for configuration management systems or development.
|`/etc/microshift/manifests.d/*`
|Read-write location for configuration management systems or development.
|`/usr/lib/microshift/manifests`
|Read-only location for embedding configuration manifests on OSTree-based systems.
|`/usr/lib/microshift/manifestsd./*`
|Read-only location for embedding configuration manifests on OSTree-based systems.
|===