Paso 1: Crea un clúster

En este paso se explica cómo configurar el entorno de shell y crear un clúster de Microsoft® Azure Kubernetes Service (AKS) adecuado para probar Apigee hybrid.

.

Configurar la shell de la terminal

Asegúrate de tener instaladas las herramientas CLI de Azure (az) y kubectl en tu shell local. La herramienta de la CLI de Azure proporciona la interfaz de línea de comandos principal de Azure, y kubectl proporciona la interfaz de línea de comandos principal para ejecutar comandos en clústeres de Kubernetes.

Crear un grupo de recursos

Crea un grupo de recursos con la consola de Azure o con la CLI de Azure mediante el siguiente comando: 

az group create --name my-hybrid-rg --location eastus

Crear una red virtual

Crea una red virtual con un intervalo CIDR que no entre en conflicto.

Por ejemplo:

Sintaxis

az network vnet create \
 --name vnet-name \
 --resource-group my-hybrid-rg \
 --address-prefixes vnet-address-range \
 --subnet-name vnet-subnet-name \
 --subnet-prefix subnet-address-range

Ejemplo

az network vnet create \
 --name my-hybrid-rg-vnet \
 --resource-group my-hybrid-rg \
 --address-prefixes 120.38.1.0/14 \
 --subnet-name my-hybrid-rg-vnet-subnet \
 --subnet-prefix 120.38.1.0/16

Donde:

  1. my-hybrid-rg es el nombre de la red virtual.
  2. vnet-address-range es una lista de bloques de direcciones reservados para esta red virtual en notación CIDR.
  3. vnet-subnet-name es el nombre de la subred de la red virtual.
  4. subnet-address-range es una lista de bloques de direcciones reservados para esta subred en notación CIDR.

Crear un clúster de AKS

En este paso, crearás un clúster de AKS.

  1. Abre el portal de Microsoft® Azure.
  2. Haz clic en Servicios de Kubernetes.
  3. Crea un clúster con los siguientes ajustes de configuración mínimos.

    Almacenamiento mínimo recomendado: consulta las especificaciones de los discos de AKS y elige un tamaño de volumen de almacenamiento en función de tus requisitos de IOPs y costes.

    Puedes consultar las directrices de configuración de clústeres para Apigee hybrid en los artículos Configurar Cassandra para el entorno de producción y Configuración de StorageClass.

    Tabulador Atributo Valor
    Aspectos básicos Suscripción Nombre de la suscripción
    Grupo de recursos El grupo de recursos que has creado anteriormente
    Región La región que especificaste anteriormente. Por ejemplo: (US) East US
    Nombre del clúster de Kubernetes Nombre del clúster. Por ejemplo: my-hybrid-aks-cluster
    Versión de Kubernetes Elige la versión 1.16.x o una posterior
    Prefijo del nombre de DNS El prefijo del nombre de DNS. Por ejemplo: my-hybrid-aks-cluster-dns
    Recuento de nodos 3
    Tamaño de los nodos DS3 Standard .
    Escala Nodos virtuales Inhabilitado
    Conjuntos de escalado de máquinas virtuales Habilitado
    Autenticación Habilitar el control de acceso basado en roles Sí
    Entidad de servicio Predeterminado
    Redes Enrutamiento de aplicaciones HTTP No
    Balanceador de carga Estándar
    Configuración de red CNI de Azure
    Red virtual El nombre de la red virtual. Puedes seleccionar la red virtual que hayas creado anteriormente o crear una haciendo clic en el enlace Crear nueva. Por ejemplo: my-hybrid-rg-vnet
    Subred de clúster Ejemplo: default (10.240.0.0/16)
    Intervalo de direcciones de servicio de Kubernetes El intervalo de direcciones de servicio. Asegúrate de usar un intervalo de direcciones que no compita con el tuyo. Por ejemplo: 10.0.0.0/16
    Dirección IP del servicio DNS de Kubernetes Por ejemplo: 10.0.0.10
    Dirección de puente de Docker Por ejemplo: 172.17.0.1/16
    Monitorización Habilitar la monitorización de contenedores Sí
    Espacio de trabajo de Log Analytics Por ejemplo: DefaultWorkspace-66f9d75c-2cd9-47dd-ad0f-c43d888e9cef-EUS
    Etiquetas Ninguno
  4. Haz clic en Revisar y crear.
  5. Cuando se haya completado la creación del clúster, ve al siguiente paso.

Definir las credenciales del clúster

Añade las credenciales del clúster de Kubernetes del clúster recién creado con el siguiente comando, si aún no lo has hecho: 

az aks get-credentials --resource-group my-hybrid-rg --name my-hybrid-aks-cluster

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 actual esté definido en el clúster que acabas de crear con el siguiente comando:

kubectl config current-context
 my-hybrid-aks-cluster-context

Si el contexto no se ha definido en tu clúster como esperabas, sigue estos pasos para cambiarlo:

  1. Lista todos los contextos para determinar cuál es el contexto actual. En el siguiente ejemplo, el contexto se define como my-hybrid-aks-ext01: 
    kubectl config get-contexts
CURRENT   NAME                            CLUSTER                                 AUTHINFO
          my-hybrid-aks-cluster    my-hybrid-aks-cluster          clusterUser_my-hybrid-rg2_myhybrid-aks-cluster
*         my-hybrid-aks-ext01      my-hybrid-aks-ext01            clusterUser_my-hybrid-rg_my-hybrid-aks-ext01
  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 el resultado de get-contexts es el anterior y el nombre del clúster que has creado es my-hybrid-aks-cluster, cambiarías al contexto my-hybrid-aks-cluster de la siguiente manera: 
    kubectl config use-context my-hybrid-aks-cluster

    Donde my-hybrid-aks-cluster es el nombre del contexto del clúster al que quieres cambiar.

Resumen

Ahora tienes un clúster de Kubernetes que se ejecuta en AKS. Tu entorno de shell está configurado y puedes instalar el software de tiempo de ejecución de Apigee hybrid en tu máquina local.

1 Paso 2(NEXT): Instala cert-manager y ASM 3 4 5