Paso 1: Crea un clúster

Antes de comenzar:

Para estos pasos, se supone que creaste variables de entorno en los pasos anteriores. Consúltalos con los siguientes comandos:

echo $PROJECT_ID
echo $ANALYTICS_REGION
echo $ORG_NAME
echo $ENV_NAME

Haz clic para obtener descripciones y comandos que te permitan definir las variables.

En estos pasos, se usan las siguientes variables de entorno:

PROJECT_ID: El ID del proyecto de Google Cloud. Consulta Guía de inicio rápido de Hybrid: Paso 2: Crea un proyecto de Google Cloud
```
export PROJECT_ID=your_project_ID
```
ANALYTICS_REGION: Es la región en la que se ejecuta tu proyecto de GKE. Es la región de estadísticas de tu organización. Consulta la Guía de inicio rápido de Hybrid: Paso 4: Crea una organización
```
export ANALYTICS_REGION=your_analytics region
```
ORG_NAME: Es el nombre de tu organización. Debe coincidir con el ID de tu proyecto de Google Cloud. Consulta la Guía de inicio rápido de Hybrid: Paso 4: Crea una organización
```
export ORG_NAME=your_organization_name
```
ENV_NAME: Es el nombre de tu entorno híbrido. Consulta Guía de inicio rápido de nube híbrida - Paso 6: Crea un grupo de entornos
```
export ENV_NAME=your_environment_name
```

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.

Configura tu shell de la terminal

La herramienta de gcloud proporciona la interfaz de línea de comandos principal para Google Cloud, 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 de gcloud proporciona la interfaz de línea de comandos principal para Google Cloud, 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 de la siguiente manera:
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 región de procesamiento en la que deseas trabajar.
Para mostrar las opciones de configuración actuales, ejecuta el siguiente comando:
```
gcloud config list
```
Si un proyecto o una región 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, decides que necesitas cambiar la configuración actual para que refleje tu proyecto y región de procesamiento, también puedes usar estos comandos:
```
gcloud config set project $PROJECT_ID
gcloud config set compute/region $ANALYTICS_REGION
```
Aquí:
- PROJECT_ID es el nombre del proyecto de Google Cloud.
- ANALYTICS_REGION es el nombre de una región de procesamiento de Google Cloud.

Cree un clúster de GKE

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

Nota:El siguiente comando supone que estableces la configuración gcloud para la región de procesamiento, como se explica en los pasos anteriores. Si no estableciste la configuración, deberás agregar el parámetro --region "compute-region" o

al comando.

Nota : Recomendamos que verifiques la versión predeterminada de Kubernetes y te asegures de que cumpla con los requisitos de versión que se indican en Plataformas admitidas. Para determinar cuál es la versión de Kubernetes predeterminada, usa el siguiente comando:

gcloud container get-server-config

Si no deseas usar el valor predeterminado, puedes agregar la marca --cluster-version al comando de creación del clúster. Si quieres obtener más información, consulta gcloud container clusters create.

Crea el clúster

Crea la variable de entorno CLUSTER_NAME con el siguiente comando (opcional):
```
export CLUSTER_NAME=cluster-name
```
donde cluster-name es el nombre que eliges para el clúster.
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 prueba de Apigee Hybrid.
Nota: El tamaño del clúster que crearás en este paso tiene una cantidad mínima de recursos adecuados solo para pruebas. A fin de obtener información más detallada sobre los requisitos de recursos del clúster para entornos de producción y de no producción, consulta:
- Requisitos de los clústeres de producción de GKE
- Requisitos del clúster de GKE que no es de producción
```
gcloud container clusters create $CLUSTER_NAME \
--machine-type "e2-standard-4" --num-nodes "4" --enable-autoscaling --min-nodes "3" --max-nodes "6"
```
La creación del clúster puede tardar unos minutos. Si se ejecuta de forma correcta, se muestra 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    1.15.12-gke.2   35.222.54.89  e2-standard-4  1.15.12-gke.2             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 kubectlcomandos 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_apigee-hybrid. El nombre incluye el nombre de un proyecto de Google Cloud (hybrid-project), una región (us-central1) y un nombre de clúster (apigee-hybrid).

kubectl config get-contexts

El resultado debería ser similar al siguiente ejemplo:

CURRENT   NAME                                             CLUSTER                                          AUTHINFO                                           NAMESPACE
*         gke_hybrid-project_us-central1_apigee-hybrid     gke_hybrid-project_us-central1_apigee-hybrid     gke_hybrid-project_us-central1_apigee-hybrid
          gke_apigee-project_us-west1_apigee-cluster       gke_apigee-project_us-west1_apigee-cluster       gke_apigee-project_us-west1_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 Hybrid). Si usas el resultado get-contexts anterior, puedes cambiar al contexto correcto de la siguiente manera:
```
kubectl config use-context context
```
En el ejemplo anterior, context es el nombre del contexto completo para tu clúster como resultado del comando get-contexts anterior. Por ejemplo: gke_apigee-project_us-west1_apigee-cluster.
Verifique el contexto actual para asegurarse de que esté configurado en el clúster deseado con el siguiente comando:
```
kubectl config current-context
```
Por ejemplo:
```
gke_apigee-project_us-west1_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:

Ingresa el siguiente comando para recuperar 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).

Deberías ver un mensaje similar al siguiente:
```
Fetching cluster endpoint and auth data.
kubeconfig entry generated for example-cluster.
```

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

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

Deberías ver un mensaje similar al siguiente:

clusterrolebinding.rbac.authorization.k8s.io/cluster-admin-binding created

Resumen

Ahora tienes un clúster de Kubernetes en ejecución en tu proyecto de Google Cloud. Tu entorno de shell está configurado y estás listo para instalar los servicios de Istio y cert-manager que requiere Apigee Hybrid en tu máquina local.

Próximo paso

1 (SIGUIENTE) Paso 2: Instala Istio y cert-manager 3 4 5