Paso 4: Instalar Apigeectl

En este paso, se explica cómo descargar y, luego, instalar apigeectl, configurar los directorios de instalación y crear las cuentas de servicio de GCP y las credenciales de TLS que se requieren para que funcione Apigee Hybrid.

Descargar e instalar `apigeectl`

apigeectl es una interfaz de línea de comandos (CLI) para instalar y administrar Apigee Hybrid en un clúster de Kubernetes.

En los siguientes pasos, se describe cómo obtener apigeectl:

Almacena el número de la versión más reciente en una variable con el siguiente comando:
```
export VERSION=$(curl -s \
    https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/current-version.txt?ignoreCache=1)
```
Nota: Algunas shells de la terminal de MacOS pueden mostrar un error a partir de este comando. Si ves un error, intenta ejecutarlo sin ?ignoreCache=1, de la siguiente manera:
```
export VERSION=$(curl -s \
    https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/current-version.txt)
```
Verifica que la variable se haya propagado con un número de versión mediante el siguiente comando. Si quieres usar una versión diferente, puedes guardarla en una variable de entorno.
```
echo $VERSION
```
```
  1.4.0
```

Descarga el paquete de lanzamientos para tu sistema operativo con el siguiente comando:

Mac (64 bits)

curl -LO \
    https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/$VERSION/apigeectl_mac_64.tar.gz

Linux de 64 bits

curl -LO \
    https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/$VERSION/apigeectl_linux_64.tar.gz

Mac de 32 bits:

curl -LO \
    https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/$VERSION/apigeectl_mac_32.tar.gz

Linux de 32 bits

curl -LO \
    https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/$VERSION/apigeectl_linux_32.tar.gz

Crea un directorio en tu sistema a fin de que funcione como el 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 el directorio al directorio base con el comando cd.
De forma predeterminada, el contenido del archivo tar se expande a un directorio con la versión y la plataforma en su nombre. Por ejemplo: ./apigeectl_1.4.0-d591b23_linux_64. Cambia el nombre de ese directorio a apigeectl con el siguiente comando:
```
mv apigeectl_1.4.0-d591b23_linux_64 apigeectl
```
Cambia al directorio con el siguiente comando:
```
cd ./apigeectl
```
Este directorio es el directorio principal de apigeectl. Es donde se encuentra el comando ejecutable apigeectl.
Crea una variable de entorno para guardar esta ruta del directorio principal con el siguiente comando:
```
export APIGEECTL_HOME=$PWD
```
Verifica que la variable contenga la ruta correcta con el siguiente comando:
```
echo $APIGEECTL_HOME
```

Configura la estructura del directorio del proyecto.

Recomendamos la siguiente estructura de directorios. Separa el software de actualización de Apigee Hybrid de los archivos de configuración que debes crear. Mediante el uso de la variable $APIGEECTL_HOME y los vínculos simbólicos que crearás, puedes cambiar con facilidad a una nueva versión de software si lo deseas. Consulta también Actualiza Apigee Hybrid.

Asegúrate de estar en el directorio base (el directorio en el que se encuentra el directorio apigeectl) mediante el uso del siguiente comando:
```
cd $APIGEECTL_HOME/..
```
Crea una carpeta nueva llamada hybrid-files con el siguiente comando. Puedes asignar el nombre que desees al directorio, pero en los documentos, el nombre hybrid-files se usará de forma coherente. Más adelante, almacenarás archivos de configuración, claves de cuenta de servicio y certificados TLS en esta carpeta. Esta carpeta te permite mantener tus archivos de configuración separados de la instalación de software apigeectl.
```
mkdir hybrid-files
```
La estructura de directorios actual ahora tiene el siguiente aspecto:
```
pwd && ls
/hybrid-base-directory
  apigeectl
  hybrid-files
```
Cambia el directorio a la carpeta hybrid-files con el siguiente comando:
```
cd hybrid-files
```
Dentro del directorio hybrid-files, crea los siguientes tres subdirectorios para organizar los archivos que crearás más adelante:
```
mkdir overrides
mkdir service-accounts
mkdir certs
```
En el directorio hybrid-files, crea los siguientes vínculos simbólicos a $APIGEECTL_HOME. Estos vínculos te permiten ejecutar el comando apigeectl desde el directorio hybrid-files como se muestra en el siguiente ejemplo:
Nota: Si no es la primera vez que usas este proceso, es posible que los siguientes vínculos simbólicos ya existan. Usa el siguiente comando para verificar si los vínculos ya existen. Si los directorios existen, omite este paso.
```
ls -l | grep ^l
```
```
ln -s $APIGEECTL_HOME/tools tools
ln -s $APIGEECTL_HOME/config config
ln -s $APIGEECTL_HOME/templates templates
ln -s $APIGEECTL_HOME/plugins plugins
```
Para verificar que los symlinks se hayan creado correctamente, ejecuta este comando y asegúrate de que las rutas de los vínculos apunten a las ubicaciones correctas:
```
ls -l | grep ^l
```

Ahora tienes una base en la que puedes configurar, implementar y administrar Apigee Hybrid en tu clúster de Kubernetes. A continuación, crearás las credenciales y las cuentas de servicio de Google Cloud necesarias para configurar los componentes de entorno de ejecución híbrido.

Próximo paso

1 2 3 4 (SIGUIENTE) Paso 5: Configura cuentas de servicio 6 7