Part 2: Hybrid runtime setup

You are currently viewing version 1.4 of the Apigee hybrid documentation.This version is end of life. You should upgrade to a newer version. For more information, seeSupported versions.

Supported platforms

SeeApigee hybrid: supported platforms.

Minimum cluster configurations

Your cluster must meet minimum configuration requirements. For details, seeMinimum cluster configurations.

Cluster permissions

Each supported platform has its own permission requirements for creating a cluster. After the cluster is created. As cluster owner, you can proceed to install the Apigee-specific components (including Apigee, ASM, and cert-manager) into the cluster. However, if you want to delegate to another user the installation of the runtime components into the cluster, you can manage the necessary permissions through Kubernetesauthn-authz.

To install the hybrid runtime components into the cluster, a non-cluster-owner user should have CRUD permission on these resources:

  • ClusterRole
  • Webhooks (ValidatingWebhookConfiguration and MutatingWebhookConfiguration)
  • PriorityClass
  • ClusterIssuer
  • CustomerResourceDefinitions
  • StorageClass (optional, if the default StorageClass is not used)

Prerequisites

This section describes tasks you must accomplish before you begin the runtime plane quickstartinstall.

Complete the following tasks to ensure that you can successfully begin the runtime installation (as described in this section):
Note about clusters: You can create a new separate cluster for Apigee hybrid or you can install it in a cluster that is running other workloads.
  • Shared cluster: If you install Apigee hybrid in a cluster running other workloads, you need to upgrade and maintain your GKE/AKS cluster at the versions and features required in common for Apigee hybrid and for your other workloads. You may want to develop a plan to migrate one or more workloads in case conflicts arise between supported versions and requirements.
  • Separate cluster: Creating a dedicated cluster for Apigee hybrid adds isolation. It also adds the operational effort of maintaining the new cluster.
Both options are valid.Note about VPC Service Controls: If you plan to enable Google Cloud Virtual Private Cloud (VPC) Service Controls with your Apigee hybrid installation, seeUsing VPC Service Controls with Apigee and Apigee hybrid for instructions before you proceed.

After you have satisfied the above prerequisites, go to the quickstart for your platform:

Let's get started and create a cluster

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2026-02-19 UTC.