The Google Distributed Cloud (GDC) air-gapped solutions guides bridge the gap between
out-of-the-box product capabilities and production-ready enterprise
architectures. These guides equip platform administrators and application
operators with conceptual frameworks, reference architectures, and practical
implementation steps to run critical workloads in GDC
air-gapped environments.

The solutions guides adhere to strict requirements for performance, security,
and data sovereignty.

## Document types

Solutions are documented across three complementary document types:

- **Reference architectures**: Architectural blueprints that outline design principles, system topology, component interactions, and security controls for deploying a solution.
- **Reference implementations**: Step-by-step guides for installing, configuring, and verifying the infrastructure, dependencies, and software deployment on GDC clusters.
- **User guides**: Day-2 operational guides covering practical administration, service configuration, monitoring, scaling, and ongoing maintenance.

## Available solutions

The following sections list the available solution guides for
GDC air-gapped, organized by technical domain matching
the Google Cloud Architecture Center.

### AI and machine learning

- **AI Gateway**
  - [Reference architecture](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/solutions/ai-gateway/reference-architecture.md.txt): Centralized routing, protocol mediation, and traffic management for large language models (LLMs).
  - **Envoy**
    - [Reference implementation](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/solutions/ai-gateway/envoy/reference-implementation.md.txt): Deploy Envoy Gateway and Envoy Agent Router on a standard cluster.
    - [Body-based routing](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/solutions/ai-gateway/envoy/body-based-routing.md.txt): Configure request payload inspection and content-based model routing.
- **Elastic Stack**
  - [Reference architecture](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/solutions/elasticstackgdcagarchitecture.md.txt): Architecture for deploying the Elastic Stack and integrating it with an LLM service to enable Elastic's generative AI features.
  - [Reference implementation](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/solutions/elasticstackgdcagimpl.md.txt): Deploy the Elastic Stack and integrate it with an LLM service to evaluate Elastic's generative AI features.
- **Open weight models**
  - [Reference architecture](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/solutions/open-weight-models/reference-architecture.md.txt): Architecture for deploying and serving open weight large language models.
  - **Ollama**
    - [Reference implementation](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/solutions/open-weight-models/ollama/reference-implementation.md.txt): Deploy Ollama to serve open weight models on standard clusters.
    - [Gemma models](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/solutions/open-weight-models/ollama/gemma.md.txt): Serve Gemma 4 models using Ollama; select the model and the GPU option in one guide.
  - **vLLM**
    - [Reference implementation](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/solutions/open-weight-models/vllm/reference-implementation.md.txt): Deploy vLLM to serve high-throughput model inference on standard clusters with GPUs.
    - [Gemma models](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/solutions/open-weight-models/vllm/gemma.md.txt): Serve Gemma 4 models using vLLM; select the model and the GPU option in one guide.
    - [Mistral models](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/solutions/open-weight-models/vllm/mistral.md.txt): Serve Mistral 7B, Mistral NeMo 12B, Mistral Small 3.2 24B, Ministral 8B, Mixtral 8x7B, or Magistral Small 1.2 using vLLM; select the model and the GPU option in one guide.
  - [Open WebUI](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/solutions/open-weight-models/open-webui.md.txt): Deploy and configure Open WebUI to interact with models served by Ollama and vLLM.

### Databases

> [!IMPORTANT]
> **Important:** Database workloads on GDC air-gapped are scoped as bounded supporting services for AI and Kubernetes-native applications. Production database deployments must run on GDC-managed primary storage using Google-prescribed hardware and predefined storage profiles (such as GDC Database Service with AlloyDB Omni), and must pass pre-flight validation through the Rack Configurator and Hardware Validation Suite. Unconstrained standalone relational database migrations and Bring-Your-Own (BYO) primary storage aren't supported.

- **Self-managed MySQL databases**
  - [Reference architecture](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/solutions/SelfManagedMySQLArchitecture.md.txt): Design patterns for enterprise MySQL database topologies.
  - [Reference implementation](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/solutions/SelfManagedMySQLImplementation.md.txt): Deploy MySQL with replication and persistent volume management.
- **Self-managed Oracle databases**
  - [Reference architecture](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/solutions/db-self-managed-oracle-ref-arc.md.txt): Architectural blueprints for migrating Oracle databases to virtual machines.
  - [Deploy self-managed Oracle databases](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/solutions/db-deploy-self-managed-oracle.md.txt): Deploy single-instance Oracle databases on compute virtual machines.
  - [Deploy highly-available self-managed Oracle databases](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/solutions/db-deploy-ha-self-managed-oracle.md.txt): Configure Oracle Data Guard for disaster recovery and high availability.
- **Self-managed PostgreSQL databases**
  - [Reference architecture](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/solutions/postgres-db-architecture.md.txt): Architecture for scalable PostgreSQL database clusters.
  - [Reference implementation](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/solutions/postgres-db-implementation.md.txt): Deploy and configure PostgreSQL with automated backups and replication.

### Networking

- **Self-managed Layer 7 load balancing**
  - [Reference architecture](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/solutions/l7-lb-architecture.md.txt): Architecture for application ingress routing and TLS termination.
  - [HAProxy reference implementation](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/solutions/l7-lb-haproxy-impl.md.txt): Deploy and tune HAProxy for high-throughput Layer 7 traffic routing.
  - [NGINX reference implementation](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/solutions/l7-lb-nginx-impl.md.txt): Deploy and configure NGINX reverse proxy services.

### Security and IAM

- **Keyfactor EJBCA**
  - [Reference architecture](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/solutions/keyfactor-ejbca-architecture.md.txt): Public key infrastructure (PKI) and certificate authority architecture.
  - [Reference implementation](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/solutions/keyfactor-ejbca-implementation.md.txt): Deploy Keyfactor EJBCA for enterprise certificate lifecycle management.