This step explains how to download and install apigeectl, set up the installation directories, and create Google Cloud service accounts, and TLS credentials that are required for Apigee hybrid to operate.
Download and install
apigeectl is the command-line interface
(CLI) for installing and managing Apigee hybrid in a Kubernetes cluster.
The following steps describe how to get
Store the latest version number in a variable using the following command:
export VERSION=$(curl -s \ https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/current-version.txt?ignoreCache=1)
Check that the variable was populated with a version number using the following command. If
you want to use a different version, you can save that in an environment variable instead.
Download the release package for your operating system using the following command:
Mac 64 bit:
curl -LO \ https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/$VERSION/apigeectl_mac_64.tar.gz
Linux 64 bit:
curl -LO \ https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/$VERSION/apigeectl_linux_64.tar.gz
Mac 32 bit:
curl -LO \ https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/$VERSION/apigeectl_mac_32.tar.gz
Linux 32 bit:
curl -LO \ https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/$VERSION/apigeectl_linux_32.tar.gz
- Create a directory on your system to serve as the base directory for the Apigee hybrid installation.
Extract the downloaded gzip file contents into the base directory you just created using the following command:
tar xvzf filename.tar.gz -C path-to-base-directory
Change directory to the base directory using the
The tar contents are, by default, expanded into a directory with the version and platform in its name. For example:
./apigeectl_1.5.0-d591b23_linux_64. Rename that directory to
apigeectlusing the following command:
mv apigeectl_1.5.0-d591b23_linux_64 apigeectl
Change to the directory using the following command:
This directory is the
apigeectlhome directory. It is where the
apigeectlexecutable command is located.
Create an environment variable to hold this home directory path using the following command:
Verify that the variable holds the correct path using the following command:
Set up the project directory structure
The following directory structure is a suggested approach. It separates Apigee hybrid
release software from configuration files that you must create. Through the use of the
$APIGEECTL_HOME variable and symbolic links that you create, you can easily
switch to a new software version if you choose to. See also Upgrading Apigee hybrid.
Be sure you are in the base directory (the directory where the
apigeectldirectory is located) by using the following command:
Create a new folder called
hybrid-filesusing the following command. You can give the directory any name you wish, but in the docs, the name
hybrid-filesis used consistently. Later, you will store configuration files, service account keys, and TLS certificates in this folder. This folder lets you keep your config files separate from the
The current directory structure now looks like the following:
pwd && ls/hybrid-base-directory apigeectl hybrid-files
Change directory into the
hybrid-filesfolder using the following command:
hybrid-filesdirectory, create the following subdirectories to organize files that you will create later:
hybrid-filesdirectory, create the following symbolic links to
$APIGEECTL_HOME. These links allow you to run the
apigeectlcommand from inside the
hybrid-filesdirectory as the following example shows:
To check that the symlinks were created correctly, execute the following command and make
sure the link paths point to the correct locations:
ls -l | grep ^l
You now have a home base from which you can configure, deploy, and manage Apigee hybrid in your Kubernetes cluster. Next, you will create the Google Cloud service accounts and credentials required to configure hybrid runtime components.