This overview page explains the operating model for container workloads in a
Google Distributed Cloud (GDC) air-gapped Kubernetes cluster. GDC
provides a managed Kubernetes service that supports Kubernetes-native container
applications that are widely consumed and supported on
Google Kubernetes Engine (GKE).

This page is for developers within the application operator group, who are
responsible for managing application workloads for their organization. For more
information, see
[Audiences for GDC air-gapped documentation](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/resources/audiences.md.txt).

> [!IMPORTANT]
> **Important:** To access the URLs listed on this page, you must connect to the internet. The URLs are provided to access outside of your air-gapped environment.

## Kubernetes applications for a disconnected environment

*GKE on GDC* is a managed Kubernetes service that incorporates many
GKE features into your GDC universe by
default. This service eliminates the need to install, upgrade, integrate, and
run open source Kubernetes by yourself. You can operate and maintain the provided
Kubernetes distribution with a standard KRM API like any other Kubernetes
offering that is declarative and idempotent. Likewise, GKE on GDC is
offered from the GDC console, gdcloud CLI, and Terraform.
For more information on GDC Kubernetes clusters, see the
[Kubernetes cluster overview](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/platform/pa-user/clusters.md.txt). For more
information on key Kubernetes concepts, see GKE documentation for
[Start learning about Kubernetes](https://docs.cloud.google.com/kubernetes-engine/docs/learn/get-started-with-kubernetes.md.txt).

## Container workload state

Containers in GDC are deployed to Kubernetes clusters as
the following:

- [Stateless workloads](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/application/ao-user/containers/containers-intro.md.txt#stateless-workloads)
- [Stateful workloads](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/application/ao-user/containers/containers-intro.md.txt#stateful-workloads)

You can scale out your GDC Kubernetes cluster nodes
based on the requirements of your container workloads, even after cluster
provisioning, as your compute requirements evolve.

Kubernetes provides several built-in workload resources to accomplish your
preferred container application state. For more information, see Kubernetes
[workloads](https://kubernetes.io/docs/concepts/workloads/) documentation.

### Stateless workloads

*Stateless workloads* are applications that do not store data or application
state to the Kubernetes cluster or to persistent storage. Instead, data and
application state stay with the client, which makes stateless applications more
scalable. For example, a frontend application can be stateless: you deploy multiple
replicas to increase its availability and scale down when demand is low, and the
replicas have no need for unique identities.

Kubernetes uses the
[`Deployment`](https://kubernetes.io/docs/concepts/workloads/controllers/deployment/)
resource to deploy stateless applications as
uniform, non-unique [Pods](https://kubernetes.io/docs/concepts/workloads/pods/).
Deployments manage the *desired state* of your application, such as the
following:

- The amount of Pods to run your application.
- The version of the container image to run.
- The labels of the Pods.

You can change the desired state dynamically through updates to the `Deployment`
resource's `Pod` specification.

Stateless applications are in contrast to
[stateful workloads](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/application/ao-user/containers/containers-intro.md.txt#stateful-workloads), which use persistent storage to save
data and application state.

### Stateful workloads

*Stateful workloads* are applications that save data to persistent disk storage
for use by the server, by clients, and by other applications. An example of a
stateful application is a database or key-value store to which data is saved and
retrieved by other applications. You must provision persistent storage for your
stateful application to use.

Kubernetes uses the
[`StatefulSet`](https://kubernetes.io/docs/concepts/workloads/controllers/statefulset/)
resource to deploy stateful applications. Pods in `StatefulSet` resources are
not interchangeable: each Pod has a unique identifier that is maintained no
matter where it is scheduled.

Stateful applications are different from
[stateless workloads](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/application/ao-user/containers/containers-intro.md.txt#stateless-workloads),
in which client data is not saved to the server between sessions.

#### Persistent storage for containers

GDC provides persistent block storage through
[`PersistentVolumeClaim`](https://kubernetes.io/docs/concepts/storage/persistent-volumes/)
(PVC) objects. A PVC is a request for storage which is referenced by a `Pod`
object. A Pod is a group of one or more containers, with shared storage and
network resources. A PVC has an independent lifecycle from the Pod, which lets
it persist beyond a single Pod.

You can dynamically provision persistent storage for your stateful workloads so
that the underlying volumes are created on demand. In
GDC, you configure dynamic provisioning by creating the
pre-installed `StorageClass` object `standard-rwo`. The `standard-rwo` object is
a `ReadWriteOnce` (RWO) block storage class that allows a volume to only access
one node at a time.

You can also create a
[`VolumeSnapshot`](https://kubernetes.io/docs/concepts/storage/volume-snapshots/)
object to copy your container application's storage volume at a specific point
in time without creating an entirely new volume. For example, a database
administrator could create a volume snapshot to back up databases before
performing edit or delete modifications.

## What's next

- [Create stateless workloads](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/application/ao-user/containers/create-stateless-workloads.md.txt)
- [Create stateful workloads](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/application/ao-user/containers/create-stateful-workloads.md.txt)
- [Access persistent storage](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/application/ao-user/containers/access-persistent-storage.md.txt)
- [Deploy a containerized web server app](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/platform-application/deploy-container-workloads.md.txt)