Utilizzo dei domini di test

Scopri come accedere ai servizi Knative serving nel tuo cluster a scopo di test prima di scegliere di mappare un dominio personalizzato.

Per impostazione predefinita, i servizi di cui esegui il deployment nei cluster Knative serving sono impostati sul dominio di base nip.io. Pertanto, se utilizzi il nome consigliato per il gateway in entrata, puoi testare immediatamente i tuoi servizi e inviare richieste senza ulteriori configurazioni. Ad esempio: http://{SERVICE_NAME}.{NAMESPACE}.kuberun.{EXTERNAL_IP}.nip.io.

Tieni presente che possono verificarsi problemi di affidabilità delle richieste quando utilizzi i caratteri jolly DNS, incluso il dominio nip.io, che è un servizio di caratteri jolly DNS gratuito. Al contrario, la configurazione e l'utilizzo di un dominio personalizzato per i test può offrire maggiore affidabilità.

Facoltativamente, puoi anche accedere ai tuoi servizi tramite l'indirizzo IP esterno.

Utilizzo del dominio di prova nip.io

Per accedere a un servizio utilizzando il dominio di base nip.io predefinito, puoi individuare l'URL dalla console Google Cloud oppure puoi crearlo manualmente.

Console

  1. Nella console Google Cloud, vai alla pagina Knative serving.

    Vai a Knative serving

  2. Nell'elenco, fai clic sul servizio per cui vuoi ottenere l'URL.

  3. Nella parte superiore della pagina viene visualizzato l'URL.

    Ad esempio: http://my-service.default.kuberun.11.111.11.111.nip.io

    Dove my-service è il nome del servizio Knative serving, default è lo spazio dei nomi e 11.111.11.111 è l'indirizzo IP del tuo bilanciatore del carico esterno.

Manualmente

Per creare manualmente l'URL del servizio, utilizza il nome del servizio, lo spazio dei nomi in cui è in esecuzione il servizio e l'indirizzo IP del bilanciatore del carico:

http://SERVICE.NAMESPACE.kuberun.EXTERNAL_IP.nip.io

Sostituisci:

  • SERVICE_NAME con il nome del tuo servizio.
  • NAMESPACE con lo spazio dei nomi in cui hai eseguito il deployment del servizio. Per impostazione predefinita, il deployment dei servizi viene eseguito nello spazio dei nomi default.
  • EXTERNAL_IP con l'indirizzo IP esterno del bilanciatore del carico.

Ad esempio, se hai un servizio denominato hello nello spazio dei nomi default e il tuo indirizzo IP esterno è 12.345.67.890, l'URL potrebbe essere simile a questo:

http://hello.default.kuberun.12.345.67.890.nip.io

Utilizzare l'indirizzo IP esterno

Facoltativamente, puoi utilizzare l'indirizzo IP esterno del bilanciatore del carico per accedere ai servizi tramite i comandi cURL o configurando manualmente un servizio di caratteri jolly DNS alternativo.

Prima di iniziare

Recuperare l'indirizzo IP esterno

Quando viene creato un cluster GKE Enterprise, il controller Istio in entrata crea un bilanciatore del carico di rete Google Cloud con un indirizzo IP disponibile pubblicamente.

Per configurare l'accesso al servizio con cURL o un servizio DNS, devi prima ottenere l'indirizzo IP esterno del servizio bilanciatore del carico:

Console

Per recuperare l'indirizzo IP esterno del bilanciatore del carico dalla console Google Cloud:
  1. Vai alla pagina GKE nella console Google Cloud:
    Vai a GKE
  2. Fai clic su Servizi e in entrata.
  3. Identifica il servizio che è il traffico Istio in entrata del tuo cluster. Il Tipo del servizio sarà Bilanciatore del carico esterno, mentre il Nome sarà istio-ingressgateway.
  4. Una volta trovato il servizio in entrata Istio del cluster, copia il relativo endpoint. Sarà l'indirizzo IP senza il numero di porta. Ad esempio, potresti vedere 00.000.000.000:11 elencato come endpoint, ma devi solo copiare 00.000.000.000.

kubectl

Per ottenere l'IP esterno per il bilanciatore del carico, esegui questo comando:

kubectl get svc istio-ingressgateway -n ASM-INGRESS-NAMESPACE

Sostituisci ASM-INGRESS-NAMESPACE con lo spazio dei nomi in cui si trova il traffico in entrata di Cloud Service Mesh. Specifica istio-system se hai installato Cloud Service Mesh utilizzando la configurazione predefinita.

L'output risultante è simile al seguente:

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

dove il valore EXTERNAL-IP è il tuo indirizzo IP esterno del Load Balancer.

Dopo aver ottenuto l'indirizzo IP esterno del bilanciatore del carico, puoi utilizzarlo nei comandi cURL o con un servizio di caratteri jolly DNS per accedere ai servizi Knative serving.

Uso: cURL

Puoi utilizzare i comandi cURL con il dominio di base predefinito nip.io per inviare richieste al tuo servizio.

Puoi specificare l'indirizzo IP esterno del bilanciatore del carico insieme ai nomi del servizio e dello spazio dei nomi nel comando cURL:

curl --header 'Host: SERVICE_NAME.NAMESPACE.kuberun.EXTERNAL_IP.nip.io' EXTERNAL_IP

Sostituisci:

  • SERVICE_NAME con il nome del tuo servizio Knative serving.
  • NAMESPACE con lo spazio dei nomi in cui è in esecuzione il servizio.
  • EXTERNAL_IP con l'indirizzo IP esterno del bilanciatore del carico.

Esempio:

curl --header 'Host: my-service.default.kuberun.12.345.67.890.nip.io' http://12.345.67.890

Utilizzo di altri servizi con caratteri jolly DNS

Per impostazione predefinita, i servizi Knative serving utilizzano il servizio di caratteri jolly DNS nip.io. Tuttavia, puoi scegliere di utilizzare altri servizi come sslip.io. Per configurare altri servizi di carattere jolly DNS, devi prima ottenere l'indirizzo IP esterno del bilanciatore del carico, quindi utilizzarlo per configurare il servizio di caratteri jolly DNS.

Configurazione del dominio del cluster

Knative serving utilizza gli oggetti ConfigMap config-domain per definire il dominio base utilizzato da tutti i servizi Knative serving di cui hai eseguito il deployment. Puoi aggiornare il ConfigMap tramite la console Google Cloud o con i comandi kubectl.

Console

Per modificare il dominio di base predefinito da nip.io a uno dei servizi con caratteri jolly DNS nella console Google Cloud:

  1. Vai alla pagina Mappature di domini di Knative serving nella console Google Cloud:

    Vai a Mappature di domini

  2. Seleziona Aggiungi mappatura > Aggiungi dominio predefinito del cluster

  3. Seleziona la casella di controllo accanto ad "Applica questa mappatura di dominio a tutti i servizi Knative serving di cui è stato eseguito il deployment in questo cluster".

  4. Seleziona il cluster dal menu a discesa.

  5. Nel campo Domain (Dominio), inserisci il sito DNS con caratteri jolly che vuoi utilizzare. Ad esempio: sslip.io

kubectl

Per modificare il dominio di base predefinito da nip.io a uno dei siti con caratteri jolly DNS, utilizza il comando:

kubectl patch configmap config-domain --namespace knative-serving --patch \
  '{"data": {"kuberun.EXTERNAL_IP.nip.io": null, "DNS_SERVICE": ""}}'

Sostituisci

  • EXTERNAL_IP con l'indirizzo IP esterno del bilanciatore del carico.
  • DNS_SERVICE con il sito DNS con caratteri jolly che stai utilizzando. Ad esempio: sslip.io

Il tuo servizio è ora disponibile all'indirizzo http://{SERVICE_NAME}.{NAMESPACE}.kuberun.{EXTERNAL_IP}.{DNS_SERVICE}.