Crea un directorio en tu sistema que sirva como directorio base para la instalación de Apigee hybrid.
Extrae el contenido del archivo gzip descargado en el directorio base que acabas de crear con el siguiente comando:
tar xvzf filename.tar.gz -C path-to-base-directory
Cambia al directorio base con el comando cd.
De forma predeterminada, el contenido del archivo tar se descomprime en un directorio cuyo nombre incluye la versión y la plataforma. Por ejemplo: ./apigeectl_1.5.0-d591b23_linux_64. Cambia el nombre de ese directorio
a apigeectl con el siguiente comando:
mv apigeectl_1.5.0-d591b23_linux_64 apigeectl
Cambia al directorio con el siguiente comando:
cd ./apigeectl
Este directorio es el apigeectldirectorio principal. Es donde se encuentra el comando ejecutable apigeectl.
Crea una variable de entorno para almacenar esta ruta de directorio principal con el siguiente comando:
export APIGEECTL_HOME=$PWD
Verifica que la variable contiene la ruta correcta con el siguiente comando:
echo $APIGEECTL_HOME
Configurar la estructura del directorio del proyecto
La siguiente estructura de directorios es una sugerencia. Separa el software de lanzamiento de Apigee hybrid de los archivos de configuración que debes crear. Si utilizas la variable $APIGEECTL_HOME y los enlaces simbólicos que crees, puedes cambiar fácilmente a una nueva versión del software si quieres. Consulta también Actualizar la versión de Apigee Hybrid.
Asegúrate de que estás en el directorio base (el directorio en el que se encuentra el directorio apigeectl) con el siguiente comando:
cd $APIGEECTL_HOME/..
Crea una carpeta llamada hybrid-files con el siguiente comando. Puedes asignar el nombre que quieras al directorio, pero en la documentación se usa el nombre hybrid-files de forma sistemática. Más adelante, almacenarás archivos de configuración, claves de cuentas de servicio y certificados TLS en esta carpeta. Esta carpeta te permite mantener tus archivos de configuración separados de la
instalación del software apigeectl.
mkdir hybrid-files
La estructura de directorios actual es la siguiente:
Cambia al directorio hybrid-files con el siguiente comando:
cd hybrid-files
En el directorio hybrid-files, crea los siguientes subdirectorios para organizar los archivos que crearás más adelante:
mkdir overrides
mkdir certs
En el directorio hybrid-files, crea los siguientes enlaces simbólicos a
$APIGEECTL_HOME. Estos enlaces le permiten ejecutar el comando apigeectl desde el directorio hybrid-files, como se muestra en el siguiente ejemplo:
Para comprobar que los enlaces simbólicos se han creado correctamente, ejecuta el siguiente comando y asegúrate de que las rutas de los enlaces apuntan a las ubicaciones correctas:
ls -l | grep ^l
Ahora tienes una base desde la que puedes configurar, desplegar y gestionar Apigee Hybrid en tu clúster de Kubernetes. A continuación, creará las cuentas de servicio y las credenciales de Google Cloud necesarias para configurar los componentes del tiempo de ejecución híbrido.
[[["Es fácil de entender","easyToUnderstand","thumb-up"],["Me ofreció una solución al problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Es difícil de entender","hardToUnderstand","thumb-down"],["La información o el código de muestra no son correctos","incorrectInformationOrSampleCode","thumb-down"],["Me faltan las muestras o la información que necesito","missingTheInformationSamplesINeed","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-09-09 (UTC)."],[[["\u003cp\u003eThis documentation covers version 1.5 of Apigee hybrid, which is now end-of-life, and users should upgrade to a newer version for continued support.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eapigeectl\u003c/code\u003e is the command-line interface (CLI) used for installing and managing Apigee hybrid in a Kubernetes cluster, and instructions for downloading it for various operating systems are detailed.\u003c/p\u003e\n"],["\u003cp\u003eA base directory and a \u003ccode\u003ehybrid-files\u003c/code\u003e folder with subdirectories are to be created to manage the Apigee hybrid installation, separating configuration files from the \u003ccode\u003eapigeectl\u003c/code\u003e release software.\u003c/p\u003e\n"],["\u003cp\u003eSymbolic links are created within the \u003ccode\u003ehybrid-files\u003c/code\u003e directory, pointing to specific directories in the \u003ccode\u003e$APIGEECTL_HOME\u003c/code\u003e, to enable running \u003ccode\u003eapigeectl\u003c/code\u003e commands and other related actions from the \u003ccode\u003ehybrid-files\u003c/code\u003e directory.\u003c/p\u003e\n"],["\u003cp\u003eThe setup process in this document will be used as a reference point for subsequent steps when installing the rest of the Apigee Hybrid product, and assumes this process has been completed.\u003c/p\u003e\n"]]],[],null,["# Step 4: Install apigeectl\n\n| You are currently viewing version 1.5 of the Apigee hybrid documentation. **This version is end of life.** You should upgrade to a newer version. For more information, see [Supported versions](/apigee/docs/hybrid/supported-platforms#supported-versions).\n\nThis step explains how to download and install [apigeectl](/apigee/docs/hybrid/v1.5/cli-reference).\n\nDownload and install `apigeectl`\n--------------------------------\n\n`apigeectl` is the command-line interface\n(CLI) for installing and managing Apigee hybrid in a Kubernetes cluster.\n\nThe following steps describe how to get `apigeectl`:\n\n1. Download the release package for your operating system using the following command:\n\n **Mac 64 bit:** \n\n ```\n curl -LO \\\n https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/1.5.10/apigeectl_mac_64.tar.gz\n ```\n\n **Linux 64 bit:** \n\n ```\n curl -LO \\\n https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/1.5.10/apigeectl_linux_64.tar.gz\n ```\n\n **Mac 32 bit:** \n\n ```\n curl -LO \\\n https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/1.5.10/apigeectl_mac_32.tar.gz\n ```\n\n **Linux 32 bit:** \n\n ```\n curl -LO \\\n https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/1.5.10/apigeectl_linux_32.tar.gz\n ```\n2. Create a directory on your system to serve as the **base directory** for the Apigee hybrid installation.\n3. Extract the downloaded gzip file contents into the base directory you just created using the\n following command:\n\n ```\n tar xvzf filename.tar.gz -C path-to-base-directory\n ```\n4. Change directory to the base directory using the `cd` command.\n5. The tar contents are, by default, expanded into a directory with the version and platform in\n its name. For example: `./apigeectl_1.5.0-d591b23_linux_64`. Rename that directory\n to `apigeectl` using the following command:\n\n ```\n mv apigeectl_1.5.0-d591b23_linux_64 apigeectl\n ```\n6. Change to the directory using the following command: \n\n ```\n cd ./apigeectl\n ```\n\n\n This directory is the `apigeectl` home directory. It is where the `apigeectl`\n executable command is located.\n7. Create an environment variable to hold this home directory path using the following command: \n\n ```\n export APIGEECTL_HOME=$PWD\n ```\n8. Verify that the variable holds the correct path using the following command: \n\n ```\n echo $APIGEECTL_HOME\n ```\n\nSet up the project directory structure\n--------------------------------------\n\n\nThe following directory structure is a suggested approach. It separates Apigee hybrid\nrelease software from configuration files that you must create. Through the use of the\n`$APIGEECTL_HOME` variable and symbolic links that you create, you can easily\nswitch to a new software version if you choose to. See also [Upgrading Apigee hybrid](/apigee/docs/hybrid/v1.5/upgrade).\n| **Note:** For the purpose of this quickstart, subsequent installation steps assume that you created the project structure as described in this section. If you follow this suggested structure, you can copy and paste most installation commands directly into your terminal.\n\n1. Be sure you are in the base directory (the directory where the `apigeectl` directory is located) by using the following command: \n\n ```\n cd $APIGEECTL_HOME/..\n ```\n2. Create a new folder called `hybrid-files` using the following command. You can give the directory any name you wish, but in the docs, the name `hybrid-files` is 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 `apigeectl` software installation. \n\n ```\n mkdir hybrid-files\n ```\n3. The current directory structure now looks like the following: \n\n pwd && ls\n /hybrid-base-directory\n apigeectl\n hybrid-files\n\n4. Change directory into the `hybrid-files`folder using the following command: \n\n ```\n cd hybrid-files\n ```\n5. Inside the `hybrid-files` directory, create the following subdirectories to organize files that you will create later: \n\n mkdir overrides\n mkdir certs\n\n6. Inside the `hybrid-files` directory, create the following symbolic links to `$APIGEECTL_HOME`. These links allow you to run the `apigeectl` command from inside the `hybrid-files` directory as the following example shows:\n | **Note:** If this is not the first time you have used this process, the following symbolic links\n | may already exist. Check to see if the links already exist using the\n | following command. If the directories exist, skip this step. \n |\n | ```\n | ls -l | grep ^l\n ``` \n\n ln -s $APIGEECTL_HOME/tools tools\n ln -s `$APIGEECTL_HOME`/config config\n ln -s `$APIGEECTL_HOME`/templates templates\n ln -s `$APIGEECTL_HOME`/plugins plugins\n\n7. To check that the symlinks were created correctly, execute the following command and make sure the link paths point to the correct locations: \n\n ```\n ls -l | grep ^l\n ```\n\n\nYou now have a home base from which you can configure, deploy, and manage Apigee hybrid\nin your Kubernetes cluster. Next, you will create the Google Cloud service accounts and credentials\nrequired to configure hybrid runtime components.\n[1](/apigee/docs/hybrid/v1.5/install-create-cluster) [2](/apigee/docs/hybrid/v1.5/install-cert-manager) [3](/apigee/docs/hybrid/v1.5/install-asm) [4](/apigee/docs/hybrid/v1.5/install-apigeectl) [(NEXT) Step 5: Set up service accounts](/apigee/docs/hybrid/v1.5/install-service-accounts) [6](/apigee/docs/hybrid/v1.5/install-create-tls-certificates) [7](/apigee/docs/hybrid/v1.5/install-configure-cluster) [8](/apigee/docs/hybrid/v1.5/install-enable-synchronizer-access) [9](/apigee/docs/hybrid/v1.5/install-hybrid-runtime)\n\n\u003cbr /\u003e"]]
