Administra recursos en varias zonas

En este documento, se describen las formas en que puedes administrar recursos en varias zonas de un universo aislado de Google Distributed Cloud (GDC). Cada plataforma, ya sea la consola de GDC, la CLI de gdcloud, las APIs o Terraform, proporciona mecanismos para administrar correctamente tus recursos en una zona designada para los recursos zonales o de forma global para los recursos compatibles con el aprovisionamiento global. En un universo multizonal, debes administrar tus recursos zonales y globales para lograr una alta disponibilidad.

Este documento está dirigido a los siguientes grupos de público:

  • Administradores de la plataforma, como los administradores de TI, que son responsables de desarrollar flujos de trabajo de recuperación ante desastres
  • Operadores de aplicaciones, como desarrolladores de aplicaciones, que son responsables de desarrollar y mantener aplicaciones en un universo de GDC

Para obtener más información, consulta Públicos de la documentación de Google Distributed Cloud aislado.

Antes de comenzar

Antes de administrar recursos en diferentes zonas, debes completar los siguientes requisitos previos según la plataforma que prefieras:

Cambia al contexto global

Para administrar recursos que abarcan todas las zonas o que se admiten para el aprovisionamiento global, cambia al contexto global.

Consola de GDC

El contexto global se establece cuando se navega a la URL global, que sigue esta sintaxis:

  https://console.ORG_NAME.SUFFIX

Navega a la URL global para tener una vista global de tus recursos en todas las zonas.

gdcloud

La URL global se establece con el parámetro organization_console_url cuando se inicializa la configuración predeterminada de la CLI de gcloud. Se supone el contexto global, a menos que hayas establecido un contexto zonal de forma explícita.

Para volver a la URL global, completa los siguientes pasos:

  1. Establece la URL predeterminada de la consola de la organización en la URL global:

    gdcloud config set core/organization_console_url GLOBAL_URL

  2. Accede al contexto global:

    gdcloud auth login --login-config-cert=CA_CERT

    Reemplaza CA_CERT por el certificado de la autoridad certificadora (AC) instalado en el almacén de certificados de confianza del sistema. Para obtener más información, consulta Configuración de certificados TLS web.

API

Debes definir de forma explícita el archivo kubeconfig para el servidor de la API de administración global en tus comandos de kubectl cuando administres o aprovisiones recursos personalizados de la API de KRM global. Por ejemplo:

  kubectl apply -f resource.yaml --kubeconfig GLOBAL_API_SERVER

Puedes establecer el contexto global para tus llamadas a la API automáticamente configurando tu contexto de kubectl en el servidor de la API global. Para obtener más información, consulta Recursos del servidor de la API global.

Terraform

Debes definir de forma explícita el servidor de la API de administración global en tu módulo de Terraform y, luego, inicializarlo:

  1. Define el archivo kubeconfig para el servidor de la API de administración global en un archivo de Terraform dentro de tu módulo, como el archivo main.tf:

    provider "kubernetes" {
  config_path = "GLOBAL_API_SERVER"
}

    Para obtener más información sobre cómo obtener el archivo kubeconfig del servidor de la API global, consulta Recursos del servidor de la API global.

  2. Aplica el nuevo contexto global para tu módulo de Terraform:

    terraform apply

Todas las acciones posteriores de Terraform se llaman en el contexto global.

Cómo cambiar a un contexto zonal

Para administrar los recursos alojados en una zona en particular, cambia a un contexto zonal.

Consola de GDC

El contexto zonal se establece navegando a la URL zonal, que sigue esta sintaxis:

  https://console.ORG_NAME.ZONE.SUFFIX

Navega a la URL zonal para ver los recursos alojados en la zona única.

Muchas páginas de recursos también ofrecen selectores de alcance de zona, que te permiten cambiar entre contextos zonales desde la página de la consola de GDC.

Selecciona una zona para mostrar los recursos presentes en esa zona específica.

Selecciona tu contexto zonal en los mecanismos proporcionados para ver y administrar tus recursos zonales.

gdcloud

Dado que el contexto global se configura de forma predeterminada cuando se usa la CLI de gcloud, debes establecer de forma explícita tu contexto zonal para manipular los recursos zonales. Puedes realizar esta acción de una de las siguientes tres maneras, según tu flujo de trabajo preferido:

Para aplicar uno de estos enfoques, completa los siguientes pasos:

Cómo establecer la configuración de zona predeterminada

  • Establece la configuración de zona para tu instancia de la CLI de gcloud:

    gdcloud config set core/zone ZONE_NAME

    Reemplaza ZONE_NAME por el nombre de la zona que deseas establecer para tu contexto. Para obtener más información, consulta Cómo enumerar las zonas de un universo.

Cómo establecer la configuración de URL zonales

  1. Establece la URL predeterminada de la consola de la organización en la URL zonal:

      gdcloud config set core/organization_console_url ZONAL_URL

  2. Accede a la zona:

      gdcloud auth login --login-config-cert=CA_CERT

    Reemplaza CA_CERT por el certificado de la autoridad certificadora (AC) instalado en el almacén de certificados de confianza del sistema. Para obtener más información, consulta Configuración de certificados TLS web.

Aplica la marca --zone

  • Ejecuta el comando de la CLI de gdcloud con la marca --zone incluida. Por ejemplo:

    gdcloud auth print-identity-token --zone=ZONE_NAME

    Puedes establecer la marca --zone para cualquier comando que la admita. Consulta la documentación de referencia de la CLI de gcloud para tu comando específico y confirma que la marca --zone esté disponible.

    Puedes usar la marca --zone desde cualquier contexto global o zonal.

API

Debes definir de forma explícita el archivo kubeconfig para el servidor de la API de administración zonal en tus comandos de kubectl cuando administres o aprovisiones recursos personalizados de la API de KRM zonal. Por ejemplo:

  kubectl apply -f resource.yaml --kubeconfig ZONAL_API_SERVER

Puedes establecer el contexto zonal para tus llamadas a la API automáticamente configurando tu contexto de kubectl en el servidor de la API de administración de la zona. Para obtener más información, consulta Recursos del servidor de la API de administración zonal.

Terraform

Debes definir de forma explícita el servidor de la API de administración zonal en tu módulo de Terraform y, luego, inicializarlo:

  1. Define el archivo kubeconfig para el servidor de la API de administración zonal en un archivo de Terraform dentro de tu módulo, como el archivo main.tf:

    provider "kubernetes" {
  config_path = "ZONAL_API_SERVER"
}

    Para obtener más información sobre cómo obtener el archivo kubeconfig del servidor de la API de administración zonal, consulta Recursos del servidor de la API de administración zonal.

  2. Aplica el nuevo contexto global para tu módulo de Terraform:

    terraform apply

Todas las acciones posteriores de Terraform se llaman en el contexto de la zona que configuraste.

Enumera las zonas de un universo

Para enumerar todas las zonas de tu universo, ejecuta el siguiente comando:

  gdcloud zones list

El resultado es similar al siguiente:

  METADATA.NAME
  us-east1-a
  us-east1-b
  us-east1-c

¿Qué sigue?