Crea un clúster de Autopilot

En esta página, se explica cómo crear un clúster de Google Kubernetes Engine (GKE) en el modo Autopilot. Autopilot es un modo de operación de GKE que te permite enfocarte en tus servicios y aplicaciones, mientras GKE administra tus nodos y la infraestructura. Cuando implementas tus cargas de trabajo, GKE aprovisiona, configura y administra los recursos y el hardware, incluso cuando escalas.

Antes de comenzar

Antes de comenzar, asegúrate de haber realizado las siguientes tareas:

  • Habilita la API de Google Kubernetes Engine.
    • Habilitar la API de Google Kubernetes Engine
  • Si deseas usar Google Cloud CLI para esta tarea, instala y, luego, inicializa gcloud CLI. Si ya instalaste gcloud CLI, ejecuta gcloud components update para obtener la versión más reciente.

Crea un clúster de Autopilot

Puedes crear un clúster de Autopilot mediante Google Cloud CLI, la consola de Google Cloud o Terraform:

gcloud

Ejecuta el comando siguiente:

gcloud container clusters create-auto CLUSTER_NAME \
    --location=LOCATION \
    --project=PROJECT_ID

Reemplaza lo siguiente:

  • CLUSTER_NAME: Es el nombre del clúster nuevo de Autopilot.
  • LOCATION: Es la región. para tu clúster.
  • PROJECT_ID: Es el ID de tu proyecto.

De forma opcional, puedes usar la marca --service-account=SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com para especificar una cuenta de servicio de IAM diferente que los nodos usen en lugar de la cuenta de servicio predeterminada de Compute Engine. Te recomendamos que crees y uses una cuenta de servicio con privilegios mínimos para que tus nodos no tengan más privilegios de los que requieren.

Para obtener una lista de otras opciones que puedes especificar, consulta la documentación de referencia de gcloud container clusters create-auto.

Console

Realiza las siguientes tareas:

  1. Ve a la página de Google Kubernetes Engine en la consola de Google Cloud.

    Ir a Google Kubernetes Engine

  2. Haz clic en Crear.

  3. En la sección Aspectos básicos del clúster, completa lo siguiente:

  4. Ingresa el nombre de tu clúster.

  5. Selecciona una región para tu clúster.

    1. Opcional (disponible con GKE Enterprise): Si deseas registrar tu clúster nuevo en una flota, ve a la sección Registro de flotas y sigue las instrucciones de la consola de Google Cloud para crear y registrar un clúster nuevo a fin de completar el registro del clúster.

  6. En la sección Herramientas de redes, elige una de las siguientes opciones:

    • Para crear un clúster con un extremo de acceso público, elige Clúster público.
    • Si tu organización tiene requisitos de aislamiento de red específicos, elige Clúster privado. Para obtener instrucciones, consulta Crea un clúster privado.

  7. De manera opcional, configura otros parámetros de configuración, como los períodos de mantenimiento y las funciones de seguridad avanzadas.

  8. Haz clic en Crear.

Terraform

Para crear un clúster de Autopilot mediante Terraform, consulta el siguiente ejemplo:

resource "google_container_cluster" "default" {
  name     = "gke-autopilot-basic"
  location = "us-central1"

  enable_autopilot = true

  # Set `deletion_protection` to `true` will ensure that one cannot
  # accidentally delete this instance by use of Terraform.
  deletion_protection = false
}

Si deseas obtener más información sobre el uso de Terraform, consulta Compatibilidad con Terraform para GKE.

Configura la versión y el canal de versiones de un nuevo clúster de Autopilot

De forma predeterminada, GKE inscribe nuevos clústeres de Autopilot en el canal de versiones regular, con la versión de GKE predeterminada en el canal. Puedes cambiar el canal de versiones cuando creas un clúster de Autopilot mediante gcloud CLI, la consola de Google Cloud o Terraform.

También puedes configurar una versión específica de GKE cuando creas un clúster con gcloud CLI. Configurar la versión del clúster solo es útil si tienes un requisito de versión específico. Para establecer la versión del clúster, especifica marca --cluster-version en el comando gcloud container clusters create-auto. La versión que especifiques debe ser una versión de GKE disponible.

Las siguientes instrucciones para configurar el canal de versiones y la versión son opcionales. A menos que necesites una versión específica de GKE, te recomendamos que mantengas la configuración del canal de versiones predeterminado.

gcloud

Ejecuta el siguiente comando:

gcloud container clusters create-auto CLUSTER_NAME \
    --location=LOCATION \
    --release-channel=RELEASE_CHANNEL \

Reemplaza RELEASE_CHANNEL por el nombre del canal de versiones del clúster. El valor predeterminado es Regular.

De manera opcional, especifica --cluster-version=CLUSTER_VERSION y reemplaza CLUSTER_VERSION por la versión de GKE para el clúster, como 1.29.4-gke.1043002. La versión que especifiques se aplica hasta que una versión más reciente se convierta en la predeterminada en tu canal de versiones. Luego, GKE actualiza de forma automática tu clúster a la versión predeterminada nueva. Si omites esta marca, GKE configura la versión en la versión predeterminada del canal de versiones.

Para verificar las versiones disponibles, consulta ¿Qué versiones están disponibles en un canal? Puedes ejecutar cualquier versión secundaria en tu canal seleccionado o elegir un subconjunto de versiones de parche de otros canales.

Console

Para configurar el canal de versiones cuando creas un clúster de Autopilot, haz lo siguiente:

  1. Ve a la página de Google Kubernetes Engine en la consola de Google Cloud.

    Ir a Google Kubernetes Engine

  2. Haz clic en Crear.

  3. En Autopilot, haz clic en Configurar.

  4. En la sección Aspectos básicos del clúster, completa lo siguiente:

    1. Especifica un nombre.
    2. Selecciona una Región.

  5. En la sección Configuración avanzada, elige un canal de versiones.

  6. Haz clic en Crear.

Terraform

Para configurar el canal de versiones y la versión del clúster cuando creas un clúster de Autopilot mediante Terraform, consulta el siguiente ejemplo:

resource "google_container_cluster" "default" {
  name     = "gke-autopilot-release-channel"
  location = "us-central1"

  enable_autopilot = true

  release_channel {
    channel = "REGULAR"
  }

  # Set `deletion_protection` to `true` will ensure that one cannot
  # accidentally delete this instance by use of Terraform.
  deletion_protection = false
}

Si deseas obtener más información sobre el uso de Terraform, consulta Compatibilidad con Terraform para GKE.

También puedes cambiar el canal de versiones y la versión de GKE para los clústeres existentes. Si deseas obtener instrucciones, consulta Actualiza un plano de control de forma manual y Selecciona un canal de versiones nuevo.

Conéctate al clúster

gcloud

gcloud container clusters get-credentials CLUSTER_NAME \
    --location=LOCATION \
    --project=PROJECT_ID

Este comando configura kubectl para usar el clúster que creaste.

Console

  1. En la lista de clústeres, junto al clúster al que deseas conectarte, haz clic en Acciones y, luego, en Conectar.

  2. Haz clic en Ejecutar en Cloud Shell cuando se te solicite. El comando generado se copia en Cloud Shell, por ejemplo:

    gcloud container clusters get-credentials autopilot-cluster --location=us-central1 --project=autopilot-test

  3. Presiona Intro para ejecutar el comando.

Verifica el modo del clúster

Puedes verificar que tu clúster sea de Autopilot mediante la CLI de gcloud o la consola de Google Cloud.

gcloud

Para verificar que tu clúster se haya creado en el modo Autopilot, ejecuta el siguiente comando:

gcloud container clusters describe CLUSTER_NAME \
    --location=LOCATION

El resultado contiene lo siguiente:

autopilot:
  enabled: true

Console

Para verificar que tu clúster se haya creado en el modo Autopilot, haz lo siguiente:

  1. En la lista de clústeres, haz clic en el nombre del clúster.
  2. En la sección Automatización, verifica si el campo Aprovisionamiento automático de nodos (modo Autopilot) está configurado como Habilitado.

¿Qué sigue?