Paso 2: Instala y configura para GKE

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:

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

Linux de 64 bits

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

Mac de 32 bits:

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

Linux de 32 bits

curl -LO \
    https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/1.2.0/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 que descargaste en el directorio base que acabas de crear. Por ejemplo:
```
tar xvzf filename.tar.gz -C path-to-base-directory
```
Cambia el directorio al directorio base.
De forma predeterminada, los contenidos del archivo tar se expanden a un directorio con la versión y la plataforma en su nombre. Por ejemplo: ./apigeectl_1.0.0-f7b96a8_linux_64. Cambia el nombre de ese directorio a apigeectl con el siguiente comando:
```
mv apigeectl_1.0.0-f7b96a8_linux_64 apigeectl
```
Cámbialo al directorio. Por ejemplo:
```
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.

La estructura del directorio que se describe a continuación es un enfoque sugerido. 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).
Crea una carpeta nueva llamada hybrid-files. 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 subdirectorios para organizar los archivos que crearás más adelante con los siguientes comandos:
```
mkdir overrides
mkdir service-accounts
mkdir certs
```
Dentro del 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:
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
```

Crea cuentas de servicio

Apigee Hybrid usa cuentas de servicio de Google Cloud para permitir que los componentes híbridos se comuniquen mediante llamadas a la API autorizadas. En este paso, usarás una herramienta de línea de comandos de Apigee Hybrid para crear un conjunto de cuentas de servicio. La herramienta también descarga las claves privadas de las cuentas de servicio por ti. Luego, debes agregar estas claves a tu archivo de configuración de clúster de Apigee Hybrid.

Haz clic para obtener más información.

En la siguiente tabla, se describen las cuentas de servicio que requieren los componentes híbridos para realizar la comunicación autorizada. Consulta también Acerca de las cuentas de servicio.

Componente^*	Función	Descripción
`apigee-cassandra`	Administrador de objetos de almacenamiento	Permite las copias de seguridad de Cassandra a Google Cloud Storage, como se describe en Copia de seguridad y recuperación.
`apigee-logger`	Escritor de registros	Permite la recopilación de datos de registro, como se describe en Logging. Solo se necesita para las instalaciones de clústeres que no sean de GKE.
`apigee-mart`	Sin función	Permite la autenticación del servicio de MART. Esta cuenta de servicio no debe tener una función asociada, como resultado, cuando creas esta cuenta de servicio, no le asignas una función.
`apigee-metrics`	Escritor de métricas de Monitoring	Permite la recopilación de datos de métricas, como se describe en Recopilación de métricas.
`apigee-org-admin`	Administrador de la organización de Apigee	Te permite llamar a la API de getSyncAuthorization y a la API de setSyncAuthorization. No puedes crear esta cuenta de servicio con la herramienta `create-service-account`.
`apigee-synchronizer`	Apigee Synchronizer Manager	Permite que el sincronizador descargue paquetes de proxy y datos de configuración del entorno. También permite el funcionamiento de la función de seguimiento.
`apigee-udca`	Agente de Apigee Analytics	Permite la transferencia de datos de estado de implementación, estadísticas y seguimiento al plano de administración.
^* Este nombre se usa en el nombre de archivo de la clave de la cuenta de servicio que se descargó.

Crea las claves:

Asegúrate de estar en el directorio base_directory/hybrid-files.
Ejecuta el siguiente comando desde el directorio hybrid-files: Con este comando, se crea una cuenta de servicio para el componente apigee-metrics y se coloca la clave que descargaste en el directorio ./service-accounts:
```
./tools/create-service-account apigee-metrics ./service-accounts
```
Cuando veas el siguiente mensaje, ingresa y:
```
[INFO]: gcloud configured project ID is project_id.
 Press: y to proceed with creating service account in project: project_id
 Press: n to abort.
```
Si es la primera vez que se crea una cuenta de servicio con el nombre exacto asignado por la herramienta, la herramienta solo la crea, y no tienes que realizar ninguna otra acción.

Sin embargo, si ves el siguiente mensaje e instrucción, ingresa y para generar claves nuevas:
```
[INFO]: Service account apigee-metrics@project_id.iam.gserviceaccount.com already exists.
...
 [INFO]: The service account might have keys associated with it. It is recommended to use existing keys.
 Press: y to generate new keys.(this does not de-activate existing keys)
 Press: n to skip generating new keys.
 
```

A continuación, crea el resto de las cuentas de servicio con los siguientes comandos:

./tools/create-service-account apigee-synchronizer ./service-accounts
./tools/create-service-account apigee-udca ./service-accounts
./tools/create-service-account apigee-mart ./service-accounts
./tools/create-service-account apigee-cassandra ./service-accounts
./tools/create-service-account apigee-logger ./service-accounts

Verifica que se crearon las claves de la cuenta de servicio. Eres responsable de almacenar estas claves privadas de forma segura. Los nombres de los archivos de la clave tienen el prefijo del nombre de tu proyecto de Google Cloud. Por ejemplo:
```
ls ./service-accounts
gcp-project-id-apigee-cassandra.json
gcp-project-id-apigee-logger.json
gcp-project-id-apigee-mart.json
gcp-project-id-apigee-metrics.json
gcp-project-id-apigee-synchronizer.json
gcp-project-id-apigee-udca.json
```

Crea certificados TLS

Debes proporcionar certificados TLS para las puertas de enlace de entrada de MART y del entorno de ejecución en la configuración Apigee Hybrid. Las credenciales que se usan para la puerta de enlace de MART deben estar autorizadas por una autoridad certificada (CA). A los fines de esta guía de inicio rápido (una instalación de prueba que no es de producción), la puerta de enlace del entorno de ejecución puede aceptar credenciales autofirmadas.

En este paso, crearás los archivos de credenciales TLS y los agregarás al directorio base_directory/hybrid-files/certs. En el Paso 3: Configura el clúster, agregarás las rutas de acceso al archivo al archivo de configuración del clúster.

Crea credenciales TLS para la puerta de enlace del entorno de ejecución

La puerta de enlace de entrada del entorno de ejecución (la puerta de enlace que controla el tráfico del proxy de API) requiere un par de claves o un certificado TLS autorizado. Para esta instalación de la guía de inicio rápido, puedes usar credenciales autofirmadas. En los siguientes pasos, openssl se usa para generar las credenciales.

Asegúrate de estar en el directorio base_directory/hybrid-files.
Ejecuta el siguiente comando desde el directorio hybrid-files con el siguiente comando:
```
openssl req  -nodes -new -x509 -keyout ./certs/keystore.key -out \
    ./certs/keystore.pem -subj '/CN=mydomain.net' -days 3650
```
Este comando crea un par autofirmado de certificado y clave que puedes usar para la guía de inicio rápido. El CN mydomain.net puede ser cualquier valor que desees para las credenciales autofirmadas.
Usa el siguiente comando para asegurarte de que los archivos estén en el directorio ./certs.
```
ls ./certs
  keystore.pem
  keystore.key
```
En el ejemplo anterior, keystore.pem es el archivo de certificado TLS autofirmado, y keystore.key es el archivo de claves.

Crea credenciales TLS para la puerta de enlace MART

Como se indica en Antes de comenzar, debes usar un par de claves o un certificado TLS autorizado para la configuración de la puerta de enlace de MART. Si aún no lo hiciste, obtén o crea estas credenciales ahora.

Obtén o crea un par de claves o un certificado TLS autorizado por una autoridad certificada. Se proporciona un ejemplo que muestra cómo obtener estas credenciales mediante la CA Let's Encrypt. Tenga en cuenta que el nombre común del certificado (CN) debe ser un nombre de DNS válido. Para conocer los pasos de ejemplo, consulta Obtén credenciales TLS: un ejemplo.
Copia las credenciales en el directorio base_directory/hybrid-files/certs.
Cuando termines, deberías tener dos pares de archivos de credenciales en el directorio ./certs. Por ejemplo:
```
ls ./certs
  fullchain.pem
  privkey.key
  keystore.pem
  keystore.key
```
En el ejemplo anterior, fullchain.pem es el archivo de certificado TLS autorizado, y privkey.key es el archivo de claves autorizado.

Resumen

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 un archivo que Kubernetes usará para implementar los componentes del entorno de ejecución híbrido en el clúster.

Próximo paso

1 2 (SIGUIENTE) Paso 3: Configura el clúster 4