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

Configurar la shell de la terminal

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

1. Asegúrate de que tienes gcloud y kubectl instalados en tu shell local. La herramienta gcloud proporciona la interfaz de línea de comandos principal de GCP, y kubectl proporciona la interfaz de línea de comandos principal para ejecutar comandos en clústeres de Kubernetes.

   gcloud -h
   kubectl -h

2. Si no tienes instaladas estas utilidades, instálalas ahora:
   1. Instala el SDK de Google Cloud, que incluye la herramienta de línea de comandos gcloud.
   2. Después de instalar el SDK de Google Cloud, instala la herramienta de línea de comandos kubectl ejecutando el siguiente comando:

   gcloud components install kubectl

3. Usa la herramienta gcloud para configurar dos ajustes predeterminados: tu proyecto y tu región de Compute Engine predeterminados. Al configurar estos ajustes, te resultará más fácil ejecutar comandos de gcloud, ya que gcloud requiere que especifiques el proyecto y la zona de cálculo en los que quieres trabajar.

   Para ver la lista de ajustes actuales, sigue estos pasos:

   gcloud config list

   Si no aparece un proyecto o una zona de cálculo, debes añadirlos con los comandos que se muestran a continuación. Si, a partir de la salida de la lista, determina que debe cambiar la configuración actual para que refleje su proyecto y su región (o zona) de computación, también puede usar estos comandos:

   gcloud config set project project-id
   gcloud config set compute/region compute-region
   gcloud config set compute/zone compute-zone
   

   Donde project-id es el nombre de tu proyecto de GCP, compute-region es el nombre de una región de computación de GCP y compute-zone es el nombre de una zona de computación de GCP. Por ejemplo: compute/region us-central1. Para ver una lista de las regiones y zonas de proceso, consulta Regiones y zonas disponibles.

Crear un clúster de GKE

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

Ejecuta el siguiente comando para crear el clúster. El tipo de máquina, el número de nodos y otros ajustes especificados en el comando crean un clúster con una configuración mínima adecuada para una instalación de prueba 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"

En este comando, cluster-name es el nombre que elijas para el clúster.

La creación del clúster puede tardar unos minutos. Si la operación se realiza correctamente, verá 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

Definir 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 está configurado como predeterminado para kubectl: todos los comandos kubectl se ejecutan en ese clúster.

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

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

2. Si es necesario, define el contexto actual en el clúster que acabas de crear (el clúster en el que quieres instalar Apigee hybrid). Si se parte de la salida get-contexts anterior, si el nombre del clúster que has creado es apigee-cluster en la región us-west1, cambiarías 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

   Donde gke_apigee-project_us-west1-a_apigee-cluster es el nombre del contexto al que quieres cambiar.

3. Comprueba el contexto actual para asegurarte de que está configurado en el clúster previsto. Por ejemplo:

   kubectl config current-context
    gke_apigee-project_us-west1-a_apigee-cluster

Otorgar credenciales de clúster

Las credenciales del clúster te dan acceso a los contenedores que se ejecutan en el clúster. Obtén tus credenciales y adquiere el rol cluster-admin:

1. Obtén las credenciales:

   gcloud container clusters get-credentials cluster-name

   Donde cluster-name es el nombre del clúster que has creado (el clúster en el que quieres instalar Apigee hybrid).

2. Define la vinculación de rol de 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 tu proyecto de GCP. Tu entorno de shell está configurado y puedes instalar el software del plano de tiempo de ejecución de Apigee Hybrid en tu máquina local.