Paso 1: crea un clúster de AKS

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

Configura tu shell de la terminal

Asegúrate de tener instaladas la 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 para Azure y kubectl la interfaz de línea de comandos principal a fin de ejecutar comandos en clústeres de Kubernetes.

Crea un grupo de recursos

Crea un grupo de recursos con la consola de Azure o con la CLI de Azure. Por ejemplo: 

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

Crea una red virtual

Crea una red virtual con un rango de CIDR sin conflictos. Por ejemplo:

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

Aquí:

  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 dentro de la red virtual.
  4. subnet-address-range es una lista de bloques de direcciones reservados para esta subred en notación CIDR.

Crea 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: Revisa las especificaciones del disco de AKS y elige un tamaño de volumen de almacenamiento según tus requisitos de costos y de IOPS.

    Pestaña Atributo Valor
    Aspectos básicos Suscripción Nombre de la suscripción
    Grupo de recursos El grupo de recursos que creaste antes
    Región La región que especificaste antes. Por ejemplo: (EE.UU.) Este de EE.UU.
    Nombre del clúster de Kubernetes El nombre del clúster Por ejemplo: my-hybrid-aks-cluster
    Versión de Kubernetes Elige la versión 1.14.x o una posterior
    Prefijo del nombre de DNS El prefijo del nombre de DNS. Por ejemplo: my-hybrid-aks-cluster-dns
    Cantidad de nodos 3
    Tamaño del nodo DS3 Standard
    Escala Nodos virtuales Inhabilitados
    Conjuntos de escalamiento de VM Habilitado
    Authentication Habilita RBAC Sí
    Principal de servicio Predeterminado
    Redes Enrutamiento de aplicaciones HTTP No
    Balanceador de cargas Estándar
    Configuración de red Avanzado
    Red virtual El nombre de la red virtual. Puedes seleccionar la red virtual que creaste antes o crear una nueva haciendo clic en el vínculo Crear nueva. Por ejemplo: my-hybrid-rg-vnet
    Subred del clúster Ejemplo: default (10.240.0.0/16)
    Rango de direcciones del servicio de Kubernetes El rango de direcciones del servicio. Asegúrate de usar un rango de direcciones no competidor. Por ejemplo: 10.0.0.0/16
    Dirección IP del servicio DNS de Kubernetes Por ejemplo: 10.0.0.10
    Dirección del puente de Docker Por ejemplo: 172.17.0.1/16
    Supervisión Habilita la supervisión de contenedores Sí
    Lugar de trabajo de estadísticas de registros Por ejemplo: DefaultWorkspace-66f9d75c-2cd9-47dd-ad0f-c43d888e9cef-EUS
    Etiquetas Ninguna
  4. Haz clic en Revisar y crear.
  5. Cuando finalice la creación del clúster, ve al siguiente paso.

Configura credenciales de clúster

Agrega las credenciales del clúster de Kubernetes para el clúster recién creado con el siguiente comando, si aún no se agregaron. Por ejemplo: 

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

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 actual esté configurado en el clúster que acabas de crear. Por ejemplo:

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

Si el contexto no está configurado a tu clúster como se esperaba, sigue estos pasos para cambiarlo:

  1. Enumera todos los contextos para determinar cuál es el contexto actual. En el siguiente ejemplo, el contexto se configura 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, 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 anterior fueget-contexts, si el nombre del clúster que creaste era my-hybrid-aks-cluster, deberías cambiar al contexto my-hybrid-aks-cluster de la siguiente manera: 
    kubectl config use-context my-hybrid-aks-cluster

    En el que my-hybrid-aks-cluster es el nombre del contexto del clústeral que deseas cambiar.

Resumen

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

1 (SIGUIENTE) Paso 2: Instala apigeectl 3 4