Part 1: Google Cloud services and hybrid UI configuration

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

Before you begin

The steps described in this hybrid install process are performed with one or more of the following:

  • Google Cloud console
  • Apigee hybrid UI
  • gcloud command line

Environment variables

The steps performed using the command line make use of user-created environment variables. If your terminal window is disconnected, the environment variables are not saved.

Tip: Create a shell script to quickly set the environment variables.

The environment variables used in these procedures are as follows:

Linux / MacOS

export PROJECT_ID="your_project_id"export ORG_NAME=$PROJECT_IDexport ORG_DISPLAY_NAME="org_friendly_name"export ORGANIZATION_DESCRIPTION="org_description_text"export ANALYTICS_REGION="analytics_region"export RUNTIMETYPE=HYBRIDexport ENV_NAME="environment_name"export ENV_DISPLAY_NAME="env_friendly_name"export ENV_DESCRIPTION="env_description_text"export DOMAIN="example.com"export ENV_GROUP="environment-group-name"export CLUSTER_NAME="cluster_name"export CLUSTER_LOCATION="cluster_region"

Variable name contents that contain spaces must be enclosed in double quotes. For example:

export ORGANIZATION_DESCRIPTION="My example organization number 1"
Tip: Use theecho $variable-name command to verify that the environment variables are properly set.

Windows

set PROJECT_ID="your_project_id"set ORG_NAME=$PROJECT_IDset ORG_DISPLAY_NAME="org_friendly_name"set ORGANIZATION_DESCRIPTION="org_description_text"set ANALYTICS_REGION="analytics_region"set RUNTIMETYPE=HYBRIDset ENV_NAME="environment_name"set ENV_DISPLAY_NAME="env_friendly_name"set ENV_DESCRIPTION="env_description_text"set DOMAIN="example.com"set ENV_GROUP="environment-group-name"set CLUSTER_NAME="cluster_name"set CLUSTER_LOCATION="cluster_region"

Variable name contents that contain spaces must be enclosed in double quotes. For example:

set ORGANIZATION_DESCRIPTION="My example organization number 1"
Tip: Use theecho %variable-name% command to verify that the environment variables are properly set.

Authorization credentials token

Thegcloud authorization credentials token expires after 20 minutes. If you don't complete all of the steps within that time, you must get the authorization credentials again. For example:

On the command line, get yourgcloud authentication credentials using the following command:

Linux / MacOS

TOKEN=$(gcloud auth print-access-token)

Windows

for /f "tokens=*" %a in ('gcloud auth print-access-token') do set TOKEN=%a

Other environment variables

You will be asked to add more environment variables in the process of this guide, and you may want to add them to the script. For example:

  • LONG_RUNNING_OPERATION_ID: The UUID of the asynchronous, long-running operation that is part of the org creation process.
  • APIGEECTL_HOME: The path to the directory where you install theapigeectl utility.

Process overview

This section provides an overview of the tasks you must accomplish to set up the hybrid UI and Google Cloud services.

The general process for setting up the Apigee hybrid UI and Google Cloud services is as follows:

ActionUsingDescription
Step 1: Create a Google Cloud account Google Cloud console You need a Google Cloud account to use these procedures. This account will be bound to a new hybrid organization.
Step 2: Create a Google Cloud project Google Cloud console Google Cloud projects form the basis for creating, enabling, and using Google Cloud services. A project organizes all your Google Cloud resources.
Step 3: Enable APIs Google Cloud console or Command line Without these, hybrid services wouldn't be able to talk to one another or other services.
Step 4: Create an organization Command line Projects belong to organizations. Once you have an organization, you're almost ready to make API calls and create API proxies.
Step 5: Add an environment Apigee hybrid UI or Command line An environment provides an isolated context orsandbox for running API proxies. In a single organization, you can create multiple environments. If you don't do this, you won't be able to complete the hybrid runtime installation, nor will you have anywhere to deploy your API proxies to.
Note: 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.

Next step

Each of these steps is described in the sections that follow.

Let's Go!

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-18 UTC.