Paso 3: Instalar Apigeectl

Estás viendo la versión 1.10 de la documentación de Apigee Hybrid. Para obtener más información, consulta las Versiones compatibles.

Version 1.10 

   Versiones compatibles:

• v1.12 (más reciente)                        
• v1.11                         
• v1.10                                        
• Lista de versiones compatibles

   Versiones no compatibles

• v1.9                                         
• v1.8                                         
• v1.7                                         
• v1.6                                         
• v1.5                                         
• v1.4                                         
• v1.3                                         
• v1.2                                         
• v1.1                                         

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

1. 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/1.10.5/apigeectl_linux_64.tar.gz

2. Crea un directorio en tu sistema a fin de que funcione como el 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 el directorio al directorio base con el comando cd.

5. 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.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 directorio principal de apigeectl. 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 guardar esta ruta del directorio principal con el siguiente comando:

   export APIGEECTL_HOME=$PWD

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

   echo $APIGEECTL_HOME

macOS

1. 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/1.10.5/apigeectl_mac_64.tar.gz

2. Crea un directorio en tu sistema a fin de que funcione como el 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 el directorio al directorio base con el comando cd.

5. 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.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 directorio principal de apigeectl. 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 guardar esta ruta del directorio principal con el siguiente comando:

   export APIGEECTL_HOME=$PWD

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

   echo $APIGEECTL_HOME

Windows

1. 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/1.10.5/apigeectl_windows_64.zip

2. Crea un directorio en tu sistema a fin de que funcione como el directorio base para la instalación de Apigee Hybrid.

3. Extrae el contenido del archivo ZIP descargado en el directorio actual mediante el siguiente comando:

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

4. Cambia el directorio al directorio base con el comando cd.

5. 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.10.5-d591b23_windows_64. Cambia el nombre de ese directorio a apigeectl mediante 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 directorio principal de apigeectl. 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 guardar esta ruta del directorio principal con el siguiente comando:

   set APIGEECTL_HOME=%CD%

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

Nota: A los fines de esta guía de inicio rápido, los pasos de instalación posteriores suponen que creaste la estructura del proyecto como se describe en esta sección. Si sigues esta estructura sugerida, puedes copiar y pegar la mayoría de los comandos de instalación directamente en tu terminal.

Linux

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

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

3. La estructura de directorios actual ahora tiene el siguiente aspecto:

   pwd && ls

   /hybrid-base-directory
     apigeectl
     hybrid-files

4. Usa el comando de cambio de directorio a la carpeta hybrid-files con el siguiente comando:

   cd hybrid-files

5. Crea una variable de entorno para guardar la ruta de acceso al directorio hybrid-files:

   export HYBRID_FILES=$PWD

   echo $HYBRID_FILES

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

   mkdir overrides
   mkdir certs

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

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

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

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

3. La estructura de directorios actual ahora tiene el siguiente aspecto:

   pwd && ls

   /hybrid-base-directory
     apigeectl
     hybrid-files

4. Cambia el directorio a la carpeta hybrid-files con el siguiente comando:

   cd hybrid-files

5. Crea una variable de entorno para guardar la ruta de acceso al directorio hybrid-files:

   export HYBRID_FILES=$PWD

   echo $HYBRID_FILES

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

   mkdir overrides
   mkdir certs

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

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

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

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

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

4. Usa el comando de cambio de directorio a la carpeta hybrid-files.
5. Crea una variable de entorno para guardar la ruta de acceso al directorio hybrid-files:

   set HYBRID_FILES=%CD%

   echo %HYBRID_FILES%

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

   mkdir overrides
   mkdir certs

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

8. 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 (SIGUIENTE) Paso 4: Configura cuentas de servicio 5 6 7 8 9 10 11