// Module included in the following assemblies:
//
// * architecture/index.adoc

:_mod-docs-content-type: REFERENCE
ifndef::openshift-rosa[]
[id="openshift-architecture-common-terms_{context}"]
= Glossary of common terms for {product-title} architecture
endif::openshift-rosa[]
ifdef::openshift-rosa[]
[id="openshift-architecture-common-terms_{context}"]
= Glossary of common terms for {product-title}
endif::openshift-rosa[]

[role="_abstract"]
Review the architecture terms and concepts to plan and deploy the cluster infrastructure.

access policies::
A set of roles that dictate how users, applications, and entities within a cluster interact with one another. An access policy increases cluster security.

admission plugins::
Admission plugins enforce security policies, resource limitations, or configuration requirements.

authentication::
// The following variations have only minor differences, but are separated for maintainability.
ifndef::openshift-dedicated,openshift-rosa,openshift-rosa-hcp[]
To control access to an {product-title} cluster, a cluster administrator can configure user authentication to ensure only approved users access the cluster. To interact with an {product-title} cluster, you must authenticate with the {product-title} API. You can authenticate by providing an OAuth access token or an X.509 client certificate in your requests to the {product-title} API.
endif::openshift-dedicated,openshift-rosa,openshift-rosa-hcp[]
ifdef::openshift-rosa,openshift-rosa-hcp[]
To control access to a {product-title} cluster, an administrator with the `dedicated-admin` role can configure user authentication to ensure only approved users access the cluster. To interact with a {product-title} cluster, you must authenticate with the {product-title} API. You can authenticate by providing an OAuth access token or an X.509 client certificate in your requests to the {product-title} API.
endif::openshift-rosa,openshift-rosa-hcp[]
ifdef::openshift-dedicated[]
To control access to an {product-title} cluster, an administrator with the `dedicated-admin` role can configure user authentication to ensure only approved users access the cluster. To interact with an {product-title} cluster, you must authenticate with the {product-title} API. You can authenticate by providing an OAuth access token or an X.509 client certificate in your requests to the {product-title} API.
endif::openshift-dedicated[]

bootstrap::
A temporary machine that runs minimal Kubernetes and deploys the {product-title} control plane.

certificate signing requests (CSRs)::
A resource requests a denoted signer to sign a certificate. This request might get approved or denied.

Cluster Version Operator (CVO)::
An Operator that checks with the {product-title} Update Service to see the valid updates and update paths based on current component versions and information in the graph.

compute nodes::
Nodes that are responsible for executing workloads for cluster users. Compute nodes are also known as worker nodes.

configuration drift::
A situation where the configuration on a node does not match what the machine config specifies.

containers::
Lightweight and executable images that consist of software and all of its dependencies. Because containers virtualize the operating system, you can run containers anywhere, such as data centers, public or private clouds, and local hosts.

container orchestration engine::
Software that automates the deployment, management, scaling, and networking of containers.

container workloads::
Applications that are packaged and deployed in containers.

control groups (cgroups)::
Partitions sets of processes into groups to manage and limit the resources processes consume.

control plane::
A container orchestration layer that exposes the API and interfaces to define, deploy, and manage the life cycle of containers. Control planes are also known as control plane machines.

CRI-O::
A Kubernetes native container runtime implementation that integrates with the operating system to deliver an efficient Kubernetes experience.

deployment::
A Kubernetes resource object that maintains the life cycle of an application.

Dockerfile::
A text file that contains the user commands to perform on a terminal to assemble the image.
ifdef::openshift-rosa,openshift-rosa-hcp[]
hosted control planes::
A {product-title} feature that enables hosting a control plane on the {product-title} cluster from its data plane and workers. This model performs the following actions:

* Optimize infrastructure costs required for the control planes.
* Improve the cluster creation time.
* Enable hosting the control plane using the Kubernetes native high level primitives. For example, deployments and stateful sets.
* Allow a strong network segmentation between the control plane and workloads.
endif::openshift-rosa,openshift-rosa-hcp[]
ifndef::openshift-dedicated,openshift-rosa,openshift-rosa-hcp[]
hosted control planes::
A {product-title} feature that enables hosting a control plane on the {product-title} cluster from its data plane and workers. This model performs the following actions:

* Optimize infrastructure costs required for the control planes.
* Improve the cluster creation time.
* Enable hosting the control plane using the Kubernetes native high level primitives. For example, deployments and stateful sets.
* Allow a strong network segmentation between the control plane and workloads.
endif::openshift-dedicated,openshift-rosa,openshift-rosa-hcp[]

hybrid cloud deployments::
Deployments that deliver a consistent platform across bare metal, virtual, private, and public cloud environments. This offers speed, agility, and portability.

Ignition::
A utility that {op-system} uses to manipulate disks during initial configuration. It completes common disk tasks, including partitioning disks, formatting partitions, writing files, and configuring users.

installer-provisioned infrastructure::
The installation program deploys and configures the infrastructure that the cluster runs on.

kubelet::
A primary node agent that runs on each node in the cluster to ensure that containers are running in a pod.

kubernetes manifest::
Specifications of a Kubernetes API object in a JSON or YAML format. A configuration file can include deployments, config maps, secrets, daemon sets.

Machine Config Daemon (MCD)::
A daemon that regularly checks the nodes for configuration drift.

Machine Config Operator (MCO)::
An Operator that applies the new configuration to your cluster machines.

machine config pools (MCP)::
A group of machines, such as control plane components or user workloads, that are based on the resources that they handle.

metadata::
Additional information about cluster deployment artifacts.

microservices::
An approach to writing software. Applications can be separated into the smallest components, independent from each other by using microservices.

mirror registry::
A registry that holds the mirror of {product-title} images.

monolithic applications::
Applications that are self-contained, built, and packaged as a single piece.

namespaces::
A namespace isolates specific system resources that are visible to all processes. Inside a namespace, only processes that are members of that namespace can see those resources.

networking::
Network information of {product-title} cluster.

node::
A worker machine in the {product-title} cluster. A node is either a virtual machine (VM) or a physical machine.

OpenShift CLI (`oc`)::
A command-line tool to run {product-title} commands on the terminal.

ifndef::openshift-dedicated,openshift-rosa,openshift-rosa-hcp[]
OpenShift Dedicated::
A managed {op-system-base} {product-title} offering on Amazon Web Services (AWS) and {gcp-first}. OpenShift Dedicated focuses on building and scaling applications.
endif::openshift-dedicated,openshift-rosa,openshift-rosa-hcp[]

OpenShift Update Service (OSUS)::
For clusters with internet access, {op-system-base-full} provides over-the-air updates by using an OpenShift update service as a hosted service located behind public APIs.

{product-registry}::
A registry provided by {product-title} to manage images.

Operator::
The preferred method of packaging, deploying, and managing a Kubernetes application in
ifdef::openshift-rosa,openshift-rosa-hcp[]
a
endif::openshift-rosa,openshift-rosa-hcp[]
ifndef::openshift-rosa,openshift-rosa-hcp[]
an
endif::openshift-rosa,openshift-rosa-hcp[]
{product-title} cluster. An Operator takes human operational knowledge and encodes it into software that is packaged and shared with customers.

OperatorHub::
A platform that contains various {product-title} Operators to install.

Operator Lifecycle Manager (OLM)::
OLM helps you to install, update, and manage the lifecycle of Kubernetes native applications. OLM is an open source toolkit designed to manage Operators in an effective, automated, and scalable way.

OSTree::
An upgrade system for Linux-based operating systems that performs atomic upgrades of complete file system trees. OSTree tracks meaningful changes to the file system tree using an addressable object store, and is designed to complement existing package management systems.

over-the-air (OTA) updates::
The {product-title} Update Service (OSUS) provides over-the-air updates to {product-title}, including {op-system-first}.

pod::
One or more containers with shared resources, such as volume and IP addresses, running in your {product-title} cluster. A pod is the smallest compute unit defined, deployed, and managed.

private registry::
{product-title} can use any server implementing the container image registry API as a source of the image which allows the developers to push and pull their private container images.

public registry::
{product-title} can use any server implementing the container image registry API as a source of the image which allows the developers to push and pull their public container images.

{op-system-base} {product-title} Cluster Manager::
A managed service where you can install, modify, operate, and upgrade your {product-title} clusters.

{op-system-base} Quay Container Registry::
A Quay.io container registry that serves most of the container images and Operators to {product-title} clusters.

replication controllers::
An asset that indicates how many pod replicas are required to run at a time.

role-based access control (RBAC)::
A key security control to ensure that cluster users and workloads have only access to resources required to execute their roles.

route::
Routes expose a service to allow for network access to pods from users and applications outside the {product-title} instance.

scaling::
The increasing or decreasing of resource capacity.

service::
A service exposes a running application on a set of pods.

Source-to-Image (S2I) image::
An image created based on the programming language of the application source code in {product-title} to deploy applications.

storage::
// OSD and ROSA definitions are separated here due to different indefinite
// articles.
ifndef::openshift-dedicated,openshift-rosa,openshift-rosa-hcp[]
{product-title} supports many types of storage, both for on-premise and cloud providers. You can manage container storage for persistent and non-persistent data in an {product-title} cluster.
endif::openshift-dedicated,openshift-rosa,openshift-rosa-hcp[]
ifdef::openshift-rosa,openshift-rosa-hcp[]
{product-title} supports many types of storage for cloud providers. You can manage container storage for persistent and non-persistent data in a {product-title} cluster.
endif::openshift-rosa,openshift-rosa-hcp[]
ifdef::openshift-dedicated[]
{product-title} supports many types of storage for cloud providers. You can manage container storage for persistent and non-persistent data in an {product-title} cluster.
endif::openshift-dedicated[]

Telemetry::
A component to collect information such as size, health, and status of {product-title}.

template::
A template describes a set of objects that can be parameterized and processed to produce a list of objects for creation by {product-title}.

ifndef::openshift-dedicated,openshift-rosa,openshift-rosa-hcp[]
user-provisioned infrastructure::
You can install {product-title} on the infrastructure that you provide. You can use the installation program to generate the assets required to provision the cluster infrastructure, create the cluster infrastructure, and then deploy the cluster to the infrastructure that you provided.
endif::openshift-dedicated,openshift-rosa,openshift-rosa-hcp[]

web console::
A user interface (UI) to manage {product-title}.

worker node::
Nodes that are responsible for executing workloads for cluster users. Worker nodes are also known as compute nodes.
