Utilizzo di un dominio di prova

Scopri come utilizzare i record DNS con caratteri jolly per configurare un dominio per il tuo cluster. Devi configurare un dominio per consentire ai tuoi servizi di accettare le richieste e consentirti di accedere a scopi di test.

Importante: per la produzione, mappa un dominio personalizzato per abilitare HTTPS e utilizzare i certificati TLS automatici.

Per impostazione predefinita, i cluster Cloud Run for Anthos utilizzano il dominio di base example.com e non consentono le richieste ai tuoi servizi. Ad esempio, l'invio di richieste a http://{service}.{namespace}.example.com non va a buon fine.

Per abilitare i servizi nel tuo cluster ad accettare le richieste, devi configurare il tuo dominio in modo che utilizzi uno dei seguenti sistemi:

• Servizio con caratteri jolly DNS gratuito
• Dominio personalizzato di tua proprietà. Per ulteriori dettagli, consulta Mappatura di domini personalizzati.

I record jolly DNS devono essere utilizzati solo per test a causa di problemi relativi all'affidabilità delle richieste. Scopri di più sui record DNS con caratteri jolly.

Prima di iniziare

Assicurati di aver installato e configurato Google Cloud CLI e kubectl.

Scelta tra un servizio DNS jolly e un dominio personalizzato

Durante lo sviluppo e il test, puoi modificare il dominio predefinito per utilizzare un sito di test DNS con caratteri jolly. Ecco alcuni esempi:

• nip.io
• xip.io
• slip.io

Se hai già un dominio da utilizzare a scopo di test, o se non ti interessa acquistare un dominio per scopi di test, puoi impostare il dominio predefinito in modo che utilizzi il tuo dominio. Un dominio personalizzato offre una maggiore affidabilità per i test.

Acquisizione dell'indirizzo IP esterno

Prima di procedere, devi ottenere l'indirizzo IP esterno del servizio bilanciatore del carico creato per il controller Ingress in entrata.

Nota: quando crei un cluster GKE abilitato per Cloud Run for Anthos, un controller Istio in entrata crea un bilanciatore del carico di rete Google Cloud con un indirizzo IP pubblico.

console

Per recuperare l'indirizzo IP esterno del bilanciatore del carico da Google Cloud Console:

1. Vai alla pagina GKE in Google Cloud Console:
   Vai alla pagina GKE

2. Fai clic su Servizi e entrata.

3. Identifica il servizio che è il controller Istio in entrata del tuo cluster. Il Tipo del servizio sarà Bilanciatore del carico esterno. La tabella seguente mostra il nome del servizio in base alla versione del cluster:

   Versione cluster	ISTIO-GATEWAY
   1.15.3-gke.19 e maggiore 1.14.3-gke.12 e superiore 1.13.10-gke.8 e superiore	istio-ingress
   Tutte le altre versioni	istio-ingressgateway

4. Una volta trovato il controller Ingress in entrata del cluster, copia il relativo endpoint. Questo sarà l'indirizzo IP senza il numero di porta. Ad esempio, potresti vedere 00.000.000.000:11 elencato come endpoint, ma è sufficiente copiare 00.000.000.000.

Riga di comando

Per ottenere l'IP esterno per il gateway in entrata Istio:

kubectl get svc istio-ingress -n gke-system

in cui l'output risultante ha questo aspetto:

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

EXTERNAL-IP per il bilanciatore del carico è l'indirizzo IP che devi utilizzare.

Se utilizzi un servizio con caratteri jolly, ti servirà l'indirizzo IP esterno quando modifichi la configurazione del cluster. Se stai utilizzando il tuo dominio personalizzato, ti servirà l'indirizzo IP esterno per creare o aggiornare un record nel registrar di dominio.

Configurazione del dominio del cluster in corso...

Cloud Run for Anthos utilizza il ConfigMap config-domain per definire il dominio di base per tutti i servizi di cui è stato eseguito il deployment nel cluster. Il comando per modificare questa configurazione varia a seconda che si utilizzi un servizio DNS jolly o un dominio personalizzato di tua proprietà. Puoi ripetere questi passaggi con valori diversi se vuoi aggiornare il dominio del cluster predefinito in futuro.

Test con un servizio di caratteri jolly DNS

xip.io viene utilizzato per dimostrare come configurare il tuo dominio per utilizzare un servizio DNS jolly, ma puoi sostituirlo con qualsiasi servizio tu scelga.

console

Per cambiare il dominio di base predefinito da example.com a uno dei servizi DNS jolly (ad esempio xip.io) in Google Cloud Console:

1. Vai alla pagina Mapping di domini di Cloud Run for Anthos in Google Cloud Console:

   Vai a Mappature di domini

2. Seleziona Aggiungi mappatura > Aggiungi dominio predefinito del cluster

3. Seleziona la casella di controllo accanto a "Applica questa mappatura di dominio a tutti i servizi Cloud Run for Anthos di cui è stato eseguito il deployment in questo cluster".

4. Seleziona il cluster dal menu a discesa.

5. Nel campo Dominio, inserisci [EXTERNAL-IP].xip.io. Sostituisci:

   • [EXTERNAL-IP] con l'indirizzo IP esterno del bilanciatore del carico.

   • xip.io con il sito DNS jolly che utilizzi.

Riga di comando

Per cambiare il dominio di base predefinito da example.com a uno dei siti con caratteri jolly DNS (ad esempio xip.io), utilizza il comando:

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

Sostituisci

• [EXTERNAL-IP] con l'indirizzo IP esterno del bilanciatore del carico.
• xip.io con il sito DNS jolly che utilizzi.

Il tuo servizio è ora disponibile all'indirizzo {service-name}.{namespace}.{[EXTERNAL-IP].xip.io}.

Eseguire i test con un dominio personalizzato

Se vuoi utilizzare un tuo dominio personalizzato per i test, i passaggi seguenti ti aiuteranno a eseguire la configurazione.

Per prima cosa, aggiorna il ConfigMap del cluster in modo che punti al tuo dominio:

console

1. Vai alla pagina Mapping di domini di Cloud Run for Anthos in Google Cloud Console:

   Vai a Mappature di domini

2. Seleziona Aggiungi mappatura > Aggiungi dominio predefinito del cluster

3. Seleziona la casella di controllo accanto a "Applica questa mappatura di dominio a tutti i servizi Cloud Run for Anthos di cui è stato eseguito il deployment in questo cluster".

4. Seleziona il cluster dal menu a discesa.

5. Nel campo Dominio, inserisci il tuo nome di dominio. Ad esempio, example.com.

Riga di comando

Specifica il dominio personalizzato utilizzando il comando:

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

Sostituisci [DOMAIN] con il tuo dominio, ad esempio mydomain.com Il comando riportato sopra rimuove example.com da ConfigMap e aggiunge mydomain.com come dominio di base predefinito. Puoi ripetere questo comando per cambiare di nuovo questo dominio.

I passaggi rimanenti devono essere eseguiti sul sito web del registrar del tuo dominio:

1. Accedi al tuo account presso il registrar di domini, quindi apri la pagina di configurazione DNS.

2. Individua la sezione dei record host della pagina di configurazione del dominio e aggiungi i record di risorse necessari.

   1. Per aggiungere un record DNS all'account del provider DNS:

      • Seleziona il tipo di record A.

      • Fornisci il carattere jolly *, come mostrato nell'esempio seguente:

        

   2. Salva le modifiche nella pagina di configurazione DNS dell'account del tuo dominio. Nella maggior parte dei casi, l'applicazione di queste modifiche richiede solo pochi minuti, ma in alcuni casi possono essere necessarie diverse ore, a seconda del registrar e della durata (TTL) di tutti i record DNS precedenti per il tuo dominio.

Dopo aver aggiornato i record DNS e averli indirizzati al tuo cluster, il servizio è disponibile all'indirizzo {service-name}.{namespace}.{your-domain}.