Paso 3: Instala apigeectl

Actualmente, está consultando la versión 1.10 de la documentación de Apigee Hybrid. This version is end of life. You should upgrade to a newer version. Para obtener más información, consulte las versiones admitidas.

Version 1.10 

   Versiones compatibles:

• v1.15 (última)                        
• v1.14                        
• v1.13                         
• Lista de versiones admitidas

   Versiones no compatibles:

• v1.12                         
• v1.11                         
• v1.10                                      
• v1.9                                         
• v1.8                                         
• v1.7                                         
• Versión 1.6                                         
• v1.5                                         
• Versión 1.4                                         
• Versión 1.3                                         
• v1.2                                         
• v1.1                                         

En este paso se explica cómo descargar e instalar apigeectl.

Descarga e instala apigeectl

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

Sigue estos pasos para descargar e instalar apigeectl:

Linux

1. Descarga el paquete de lanzamiento de tu sistema operativo con el siguiente comando:

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

2. Crea un directorio en tu sistema que sirva como directorio base para la instalación de Apigee hybrid.

3. 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

4. Cambia al directorio base con el comando cd.

5. De forma predeterminada, el contenido de tar se expande en un directorio con la versión y la plataforma en su nombre. Por ejemplo: ./apigeectl_1.10.5-d591b23_linux_64. Cambia el nombre de ese directorio a apigeectl con el siguiente comando:

   mv apigeectl_1.10.5-d591b23_linux_64/ apigeectl

6. Cambia al directorio con el siguiente comando:

   cd ./apigeectl

   Este directorio es el apigeectldirectorio principal. Es donde se encuentra el comando ejecutable apigeectl.

7. Verifica la versión de apigeectl con el comando version:

   ./apigeectl version

   Version: 1.10.5

8. Crea una variable de entorno para almacenar esta ruta de directorio principal con el siguiente comando:

   export APIGEECTL_HOME=$PWD

9. Verifica que la variable contiene la ruta correcta con el siguiente comando:

   echo $APIGEECTL_HOME

macOS

1. Descarga el paquete de lanzamiento de tu sistema operativo con el siguiente comando:

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

2. Crea un directorio en tu sistema que sirva como directorio base para la instalación de Apigee hybrid.

3. 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

4. Cambia al directorio base con el comando cd.

5. De forma predeterminada, el contenido de tar se expande en un directorio con la versión y la plataforma en su nombre. Por ejemplo: ./apigeectl_1.10.5-d591b23_mac_64. Cambia el nombre de ese directorio a apigeectl con el siguiente comando:

   mv apigeectl_1.10.5-d591b23_mac_64 apigeectl

6. Cambia al directorio con el siguiente comando:

   cd ./apigeectl

   Este directorio es el apigeectldirectorio principal. Es donde se encuentra el comando ejecutable apigeectl.

7. Verifica la versión de apigeectl con el comando version:

   ./apigeectl version

   Version: 1.10.5

8. Crea una variable de entorno para almacenar esta ruta de directorio principal con el siguiente comando:

   export APIGEECTL_HOME=$PWD

9. Verifica que la variable contiene la ruta correcta con el siguiente comando:

   echo $APIGEECTL_HOME

Windows

1. Descarga el paquete de lanzamiento de tu sistema operativo con el siguiente comando:

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

2. Crea un directorio en tu sistema que sirva como directorio base para la instalación de Apigee hybrid.

3. Extrae el contenido del archivo .zip descargado en el directorio actual con el siguiente comando:

   tar xvzf filename.zip -C path-to-base-directory

4. Cambia al directorio base con el comando cd.

5. El contenido del archivo tar se descomprime de forma predeterminada en un directorio cuyo nombre incluye la versión y la plataforma. Por ejemplo: .\apigeectl_1.10.5-d591b23_windows_64. Cambia el nombre de ese directorio a apigeectl con el siguiente comando:

   rename apigeectl_1.10.5-d591b23_windows_64 apigeectl

6. Cambia al directorio con el siguiente comando:

   cd .\apigeectl

   Este directorio es el apigeectldirectorio principal. Es donde se encuentra el comando ejecutable apigeectl.

7. Verifica la versión de apigeectl con el comando version:

   ./apigeectl version

   Version: 1.10.5

8. Crea una variable de entorno para almacenar esta ruta de directorio principal con el siguiente comando:

   set APIGEECTL_HOME=%CD%

9. 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.

Nota: En esta guía de inicio rápido, se da por hecho que has creado la estructura del proyecto tal como se describe en esta sección. Si sigues esta estructura sugerida, podrás copiar y pegar la mayoría de los comandos de instalación directamente en tu terminal.

Linux

1. 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/..

2. 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

3. La estructura de directorios actual es la siguiente:

   pwd && ls

   /hybrid-base-directory
     apigeectl
     hybrid-files

4. Cambia al directorio hybrid-files con el siguiente comando:

   cd hybrid-files

5. Crea una variable de entorno que contenga la ruta al directorio hybrid-files:

   export HYBRID_FILES=$PWD

   echo $HYBRID_FILES

6. En el directorio hybrid-files, crea los siguientes subdirectorios para organizar los archivos que crearás más adelante:

   mkdir overrides
   mkdir certs

7. 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:

   Nota: Si no es la primera vez que usas este proceso, es posible que los siguientes enlaces simbólicos ya existan. Comprueba si los enlaces ya existen con el siguiente comando. Si los directorios ya existen, sáltate 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

8. 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

macOS

1. 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/..

2. 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

3. La estructura de directorios actual es la siguiente:

   pwd && ls

   /hybrid-base-directory
     apigeectl
     hybrid-files

4. Cambia al directorio hybrid-files con el siguiente comando:

   cd hybrid-files

5. Crea una variable de entorno que contenga la ruta al directorio hybrid-files:

   export HYBRID_FILES=$PWD

   echo $HYBRID_FILES

6. En el directorio hybrid-files, crea los siguientes subdirectorios para organizar los archivos que crearás más adelante:

   mkdir overrides
   mkdir certs

7. 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:

   Nota: Si no es la primera vez que usas este proceso, es posible que los siguientes enlaces simbólicos ya existan. Comprueba si los enlaces ya existen con el siguiente comando. Si los directorios ya existen, sáltate 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

8. 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

Windows

1. 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%\..

2. 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

3. La estructura de directorios actual es la siguiente:

   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.10.5rc1-437dccc_windows_64.zip
   08/05/2021  01:38 PM    <DIR>          hybrid-files

4. Cambia al directorio hybrid-files con el siguiente comando:

   cd hybrid-files

5. Crea una variable de entorno que contenga la ruta al directorio hybrid-files:

   set HYBRID_FILES=%CD%

   echo %HYBRID_FILES%

6. En el directorio hybrid-files, crea los siguientes subdirectorios para organizar los archivos que crearás más adelante:

   mkdir overrides
   mkdir certs

7. En el directorio hybrid-files, crea los siguientes enlaces simbólicos a $APIGEECTL_HOME. Estos enlaces te permiten ejecutar el comando apigeectl desde el directorio hybrid-files, como se muestra en el siguiente ejemplo:
   Nota: Necesitarás privilegios de administrador en tu ordenador Windows para ejecutar el comando mklink. Para ello, ejecuta el terminal de comandos 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\

8. Para comprobar que los enlaces simbólicos se han 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 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.

1 2 3 Paso 4: Configura las cuentas de servicio 5 6 7 8 9 10 11