Como alterar o domínio padrão do GKE para usá-lo em testes

Por padrão, o Cloud Run para Anthos no Google Cloud usa example.com como o domínio base, em que o nome de domínio totalmente qualificado de um serviço é formatado como http://{service}.{namespace}.example.com. Esse URL não aceita solicitações.

Nesta página, mostramos como alterar o domínio padrão do cluster do Cloud Run para Anthos no Google Cloud para um domínio utilizável para fins de teste. As instruções mostram o uso de sites de DNS curinga gratuitos para que você não precise adquirir um domínio personalizado para teste. No entanto, também é possível usar curingas com um domínio personalizado de sua propriedade, se preferir. Nesta página, mostramos os dois métodos.

Antes de começar

Certifique-se de ter instalado e configurado o SDK do Cloud e o kubectl.

Escolha uma alternativa para DNS curinga

Quando você está desenvolvendo e testando, o domínio padrão é alterado para o uso de um dos sites de teste de DNS curinga. Por exemplo:

Em vez de usar um desses sites gratuitos, você tem a opção de alterar o domínio padrão para um domínio personalizado de sua propriedade. Isso envolve a compra de um domínio e a configuração de registros no registro de domínios para dar compatibilidade a curingas de DNS.

Como conseguir o endereço IP externo

Se você usa um dos sites de DNS curinga gratuitos ou um domínio personalizado de sua propriedade, é necessário conseguir o endereço IP externo do serviço do balanceador de carga criado para o controlador de ingresso do Istio.

Para receber o IP externo do gateway de entrada do Istio:

kubectl get svc ISTIO-GATEWAY -n NAMESPACE 
Substitua ISTIO-GATEWAY e NAMESPACE da seguinte maneira:
Versão do cluster ISTIO-GATEWAY NAMESPACE
1.15.3-gke.19 e mais recente
1.14.3-gke.12 e mais recente
1.13.10-gke.8 e mais recente
istio-ingress gke-system
Todas as outras versões istio-ingressgateway istio-system

A saída resultante é algo semelhante a:

NAME            TYPE           CLUSTER-IP     EXTERNAL-IP  PORT(S)
ISTIO-GATEWAY    LoadBalancer   XX.XX.XXX.XX   pending     80:32380/TCP,443:32390/TCP,32400:32400/TCP

O EXTERNAL-IP do balanceador de carga é o endereço IP que você precisa usar.

  • Para os sites curinga gratuitos, você usará o endereço IP externo ao editar a configuração do cluster, que é descrita a seguir.
  • Para um domínio personalizado de sua propriedade, não use o endereço IP externo na configuração do cluster, mas sim em um registro novo ou atualizado no registro de domínios.

Como editar a configuração do domínio de cluster

O Cloud Run para Anthos no Google Cloud usa o ConfigMap config-domain para definir o domínio base para todos os serviços implantados no cluster. O comando para editar essa configuração varia dependendo se você usa um site de DNS curinga gratuito ou um domínio personalizado que você tenha.

Como usar sites de DNS curinga gratuitos

Para alterar o domínio base padrão de example.com para um dos sites curinga DNS gratuitos, por exemplo, xip.io, use o comando:

kubectl patch configmap config-domain --namespace knative-serving --patch \
  '{"data": {"example.com": null, "[EXTERNAL-IP].xip.io": ""}}'

Substitua:

  • [EXTERNAL-IP] pelo endereço IP externo do balanceador de carga;
  • xip.io pelo site DNS de caractere curinga gratuito que você está usando.

Repita este comando com valores diferentes se quiser alterar isso novamente.

Seus serviços estarão disponíveis em {service-name}.{namespace}.{[EXTERNAL-IP].xip.io}.

Como testar com um domínio personalizado

Se você quiser usar um domínio personalizado seu para testar usando esse domínio, em vez de usar um dos sites DNS com caracteres curinga gratuitos:

  1. Especifique seu domínio personalizado usando o comando:

    kubectl patch configmap config-domain --namespace knative-serving --patch \
    '{"data": {"example.com": null, "[DOMAIN]": ""}}'

    Substitua [DOMAIN] pelo seu próprio domínio, por exemplo, mydomain.com O comando acima remove o example.com do ConfigMap e adiciona mydomain.com como o domínio base padrão. Repita este comando se quiser alterar isso novamente para algum outro domínio.

  2. Faça login na conta do registro de domínios e abra a página de configuração de DNS.

  3. Localize a seção de registros do host da página de configuração do seu domínio e adicione os registros de recursos necessários.

    1. Para adicionar um registro DNS à conta no provedor de DNS:

      • selecione o tipo de registro A;
      • forneça o curinga **, conforme mostrado no exemplo a seguir:

        Curinga do DNS

    2. Salve as alterações na página de configuração do DNS da conta do domínio. Geralmente, leva apenas alguns minutos para que essas alterações entrem em vigor, mas em alguns casos pode levar várias horas, dependendo do registro e do time to live (TTL) de qualquer registro DNS anterior para seu domínio.

Depois de atualizar seus registros DNS e apontá-los para o cluster, seus serviços estarão disponíveis em {service-name}.{namespace}.{your-domain}.