Paso 4: Instalar Apigeectl

En este paso, se explica cómo descargar y, luego, instalar apigeectl.

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 descargar e instalar apigeectl:

Linux

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)

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.7.6
```

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

curl -LO \
    https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/$VERSION/apigeectl_linux_64.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.7.6-d591b23_linux_64. Cambia el nombre de ese directorio a apigeectl con el siguiente comando:
```
mv apigeectl_1.7.6-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.
Verifica la versión de apigeectl con el comando version:
```
./apigeectl version
```
```
Version: 1.7.6
```
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
```

macOS

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)

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.7.6
```

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

curl -LO \
    https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/$VERSION/apigeectl_mac_64.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.7.6-d591b23_mac_64. Cambia el nombre de ese directorio a apigeectl con el siguiente comando:
```
mv apigeectl_1.7.6-d591b23_mac_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.
Verifica la versión de apigeectl con el comando version:
```
./apigeectl version
```
```
Version: 1.7.6
```
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
```

Windows

Almacena el número de la versión más reciente en una variable con el siguiente comando:

for /f "tokens=*" %a in ('curl -s ^
  https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/current-version.txt') ^
do set VERSION=%a

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.7.6
```

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

curl -LO ^
  https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/%VERSION%/apigeectl_windows_64.zip

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 ZIP descargado en el directorio actual mediante el siguiente comando:
```
tar xvzf filename.zip -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.7.6-d591b23_windows_64. Cambia el nombre de ese directorio a apigeectl mediante el siguiente comando:
```
rename apigeectl_1.7.6-d591b23_windows_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.
Verifica la versión de apigeectl con el comando version:
```
./apigeectl version
```
```
Version: 1.7.6
```
Crea una variable de entorno para guardar esta ruta del directorio principal con el siguiente comando:
```
set APIGEECTL_HOME=%CD%
```
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.

Linux

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
```
Usa el comando de cambio de 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 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
```

macOS

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 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
```

Windows

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:

dir

 Directory of C:\Users\example\hybrid

08/05/2021  01:38 PM    <DIR>          .
08/05/2021  01:38 PM    <DIR>          ..
08/02/2021  01:11 PM    <DIR>          apigeectl
08/02/2021  11:13 AM         5,803,963 apigeectl_1.7.6rc1-437dccc_windows_64.zip
08/05/2021  01:38 PM    <DIR>          hybrid-files

Usa el comando de cambio de directorio a la carpeta 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 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: Necesitarás un privilegio de administrador en la computadora Windows para ejecutar el comando mklink. Para lograrlo, ejecuta la terminal de comando como administrador o usa el comando runas. Por ejemplo:
```
runas /noprofile /user:mymachine\administrator "mklink /d config %APIGEECTL_HOME%\config"
```
```
mklink /d config %APIGEECTL_HOME%\config\
mklink /d plugins %APIGEECTL_HOME%\plugins\
mklink /d templates %APIGEECTL_HOME%\templates\
mklink /d tools %APIGEECTL_HOME%\tools\
```

Para verificar que los symlinks se hayan creado correctamente, usa dir:

dir

 Directory of C:\Users\example\hybrid\hybrid-files

08/05/2021  01:56 PM    <DIR>          .
08/05/2021  01:56 PM    <DIR>          ..
08/05/2021  01:46 PM    <DIR>          certs
08/05/2021  01:55 PM    <SYMLINKD>     config [C:\Users\example\hybrid\apigeectl\config\]
08/05/2021  01:46 PM    <DIR>          overrides
08/05/2021  01:56 PM    <SYMLINKD>     plugins [C:\Users\example\hybrid\apigeectl\plugins\]
08/05/2021  01:56 PM    <SYMLINKD>     templates [C:\Users\example\hybrid\apigeectl\templates\]
08/05/2021  01:56 PM    <SYMLINKD>     tools [C:\Users\example\hybrid\apigeectl\tools\]

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.

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

Paso 4: Instalar Apigeectl

Descargar e instalar apigeectl

Linux

macOS

Windows

Configura la estructura del directorio del proyecto.

Linux

macOS

Windows

Descargar e instalar `apigeectl`