Servidores de API globais e zonais

O Google Distributed Cloud (GDC) com isolamento físico opera como um universo multizonal. Isso significa que há recursos zonais e globais implantados em diferentes servidores de API, que são gerenciados de forma independente pelo sistema. Um servidor de API fornece um único endpoint para criar, gerenciar e excluir recursos de API com um back-end de armazenamento fortemente consistente.

Servidores da API Management

Há dois tipos de servidores de API de gerenciamento:

  • Servidor de API global
  • Servidores de API zonais

Há sempre apenas um servidor de API global para seu universo. Da mesma forma, há um servidor de API zonal para cada zona em que você opera. Mesmo que você opere em um ambiente de zona única, há um servidor de API global e um servidor de API zonal para a única zona.

Os recursos zonais são implantados em um servidor de API zonal e operam em uma única zona de forma independente. Uma interrupção zonal pode afetar alguns ou todos os recursos da zona. Os recursos globais são implantados no servidor de API global e operam com redundância em várias zonas para tolerância a falhas.

Um universo gerencia um servidor de API global que abrange todas as zonas e servidores de API zonais dedicados a cada zona.

É preciso entender essa arquitetura para implantar adequadamente seus recursos de alta disponibilidade. Alguns recursos podem ser implantados globalmente ou operar em uma única zona de forma independente, mas outros são apenas globais ou zonais. Consulte a documentação adequada de um tipo de recurso para mais informações.

Cada plataforma, seja o console do GDC, a CLI gdcloud, as APIs ou o Terraform, oferece mecanismos para implantar adequadamente seu recurso em um servidor de API de gerenciamento designado.

Console do GDC

O console do GDC oferece um seletor de escopo de zona em várias páginas.

Selecione uma zona para mostrar os recursos presentes nela.

Com o seletor de escopo de zona, é possível segmentar zonas específicas para tarefas de gerenciamento de recursos.

Se um recurso puder abranger uma ou várias zonas, você terá a opção de criar e gerenciar esse recurso de acordo com sua escolha de implantação zonal ou global.

Com o console do GDC, é possível escolher a zona de forma dinâmica e ter uma visão abrangente de todos os recursos e serviços do GDC disponíveis para esse local.

A zona ou o contexto global selecionado é renderizado navegando até o URL global ou zonal. Os URLs correspondem aos servidores de API hospedados para o contexto zonal ou global específico. Por exemplo, selecionar o contexto global leva você ao URL global:

https://console.ORG_NAME.SUFFIX

Da mesma forma, selecionar uma zona específica no console navega até o URL zonal:

https://console.ORG_NAME.ZONE.SUFFIX

CLI gdcloud

A CLI gdcloud oferece maneiras de interagir com a API zonal ou global para gerenciar seus recursos e a implantação deles, incluindo:

  • Faça login no URL do console zonal ou global usando a CLI
  • Usar uma flag da CLI zonal para ações específicas da zona

O URL global é o que é configurado por padrão ao inicializar a CLI gdcloud. Você pode atualizar sua configuração do gdcloud para definir URLs zonais e fazer login neles para concluir tarefas específicas da zona.

Da mesma forma, a CLI gdcloud oferece uma flag --zone que pode ser definida para muitas tarefas de gerenciamento de recursos em grupos de comandos. Quando você faz login na configuração global de URL, suas ações da CLI em recursos globais são aplicadas a todas as zonas em que estão no escopo.

Para mais informações sobre como usar a CLI gdcloud para serviços zonais e globais, consulte Gerenciar recursos em várias zonas.

API e Terraform

É possível usar as APIs KRM e, por extensão, o Terraform, para segmentar o servidor de API zonal ou global e interagir com os recursos hospedados nele. O GDC oferece uma maneira de definir o contexto do servidor de API usando kubectl, permitindo configurar o arquivo kubeconfig para o servidor de API adequado. Com o contexto definido, é possível aplicar e manipular seus recursos personalizados hospedados na zona ou, se implantados globalmente, em várias zonas.

Para mais informações sobre como alternar o contexto do servidor da API usando kubectl, consulte Fazer login.

A seguir