Paso 1: crea un clúster de GKE

En este paso, se explica cómo configurar tu entorno de shell y crear un clúster de GKE en tu proyecto de Google Cloud Platform (GCP).

Configura tu shell de la terminal

La herramienta gcloud proporciona la interfaz de línea de comandos principal para GCP y kubectl proporciona la interfaz de línea de comandos principal a fin de ejecutar comandos en clústeres de Kubernetes.

Asegúrate de tener gcloud y kubectl instalados en tu shell local. La herramienta gcloud proporciona la interfaz de línea de comandos principal para GCP y kubectl proporciona la interfaz de línea de comandos principal a fin de ejecutar comandos en clústeres de Kubernetes.
```
gcloud -h
kubectl -h
```
Si no tienes instaladas estas utilidades, instálalas ahora:
1. Instala el SDK de Cloud, que incluye la herramienta de línea de comandos de gcloud.
2. Luego de instalar el SDK de Cloud, instala la herramienta de línea de comandos de kubectl mediante la ejecución del comando siguiente:
Usa la herramienta de gcloud para establecer dos opciones de configuración predeterminadas: el proyecto predeterminado y la región de procesamiento. Establecer esta configuración facilita la ejecución de los comandos de gcloud, ya que gcloud requiere que especifiques el proyecto y la zona de procesamiento en la que deseas trabajar.
Para mostrar una lista de la configuración actual, haz lo siguiente:
```
gcloud config list
```
Si un proyecto o una zona de procesamiento no aparece en la lista, debes agregarlos con los comandos que se muestran a continuación. Si, en el resultado de la lista, determinas que necesitas cambiar la configuración actual para reflejar tu proyecto y región de procesamiento (o zona), también puedes usar estos comandos:
```
gcloud config set project project-id
gcloud config set compute/region compute-region
gcloud config set compute/zone compute-zone
```
En el que project-id es el nombre de tu proyecto de GCP, compute-region es el nombre de una región de procesamiento de GCP y compute-zone es el nombre de una zona de procesamiento de GCP. Por ejemplo: compute/region us-central1. Para obtener una lista de regiones y zonas de procesamiento, consulta Regiones y zonas disponibles.

Crea un clúster de GKE

En este paso, crearás un clúster de Kubernetes en tu proyecto de GCP (el proyecto que configuraste con el comando gcloud config).

NOTA: En el siguiente comando, suponemos que estableces la configuración de gcloud para la región o zona de procesamiento, como se explica en los pasos anteriores. Si no configuraste la configuración, deberás agregar el parámetro --region "compute-region" o --zone "compute-zone" al comando.

Ejecuta el siguiente comando para crear el clúster. El tipo de máquina, la cantidad de nodos y otras opciones de configuración especificadas en el comando crean un clúster de configuración mínima adecuado para una instalación de Apigee Hybrid.

gcloud container clusters create cluster-name \
--machine-type "n1-standard-4" --num-nodes "3" --enable-autoscaling --min-nodes "3" --max-nodes "6"

donde cluster-name es el nombre que eliges para el clúster.

La creación del clúster puede tardar unos minutos. Si se ejecuta de forma correcta, verás un resultado similar al siguiente con el estado RUNNING:

NAME           LOCATION       MASTER_VERSION  MASTER_IP     MACHINE_TYPE   NODE_VERSION   NUM_NODES  STATUS
apigee-hybrid  us-central1-a  1.14.10-gke.27   35.222.54.89  n1-standard-4  1.14.10-gke.27          RUNNING

Establece el contexto actual

Un contexto es un grupo de parámetros de acceso. Cada contexto contiene un clúster de Kubernetes, un usuario y un espacio de nombres. El contexto actual es el clúster que predeterminado para kubectl: todos los comandos kubectl se ejecutan en ese clúster.

Asegúrate de que el contexto de gcloud actual esté configurado en el clúster que acabas de crear.

Primero, enumera los contextos para determinar cuál es el contexto actual. En el siguiente ejemplo, el contexto actual es gke_hybrid-project_us-central1-a_apigee-hybrid. El nombre incluye el nombre de un proyecto de GCP (hybrid-project), una región o zona (us-central1-a) y un nombre de clúster (apigee-hybrid):

kubectl config get-contexts
CURRENT   NAME                                             CLUSTER                                          AUTHINFO                                           NAMESPACE
*         gke_hybrid-project_us-central1-a_apigee-hybrid   gke_hybrid-project_us-central1-a_apigee-hybrid   gke_hybrid-project_us-central1-a_apigee-hybrid
          gke_apigee-project_us-west1-a_apigee-cluster     gke_apigee-project_us-west1-a_apigee-cluster     gke_apigee-project_us-west1-a_apigee-cluster

Si es necesario, configura el contexto actual en el clúster que acabas de crear (el clúster en el que quieres instalar Apigee Hybris). Suponiendo que el resultado get-contexts fue como el anterior, si el nombre del clúster que creaste era apigee-cluster en la región us-west1, deberás cambiar al contexto gke_apigee-project_us-west1-a_apigee-cluster, de la siguiente manera:
```
kubectl config use-context gke_apigee-project_us-west1-a_apigee-cluster
```
En el que gke_apigee-project_us-west1-a_apigee-cluster es el nombre del contexto al que deseas cambiar.
Verifica el contexto actual para asegurarte de que esté configurado en el clúster deseado. Por ejemplo:
```
kubectl config current-context
 gke_apigee-project_us-west1-a_apigee-cluster
```

Otorga credenciales de clúster

Las credenciales del clúster te brindan acceso a los contenedores que se ejecutan en el clúster. Recupera tus credenciales y otórgale la función cluster-admin:

Recupera las credenciales:
```
gcloud container clusters get-credentials cluster-name
```
En el ejemplo anterior, cluster-name es el nombre del clúster que creaste (el clúster en el que quieres instalar Apigee Hybrid).

Establece la vinculación de función del clúster. Ejecuta este comando exactamente como se muestra:

kubectl create clusterrolebinding cluster-admin-binding \
--clusterrole cluster-admin --user $(gcloud config get-value account)

Resumen

Ahora tienes un clúster de Kubernetes en ejecución en su proyecto de GCP. Tu entorno de shell está configurado y estás listo para instalar el software de entorno de ejecución híbrido de Apigee en tu máquina local.

1 (SIGUIENTE) Paso 2: Instala apigeectl 3 4