diff --git a/docs/install/any-kubernetes-cluster.md b/docs/install/any-kubernetes-cluster.md index bfbd4ba37..84077c059 100644 --- a/docs/install/any-kubernetes-cluster.md +++ b/docs/install/any-kubernetes-cluster.md @@ -262,7 +262,7 @@ We ship a simple Kubernetes Job called "default domain" that will (see caveats) kubectl apply --filename {{< artifact repo="serving" file="serving-default-domain.yaml" >}} ``` -**Caveat**: This will only work if the cluster LoadBalancer service exposes an IPv4 address, so it will not work with IPv6 clusters, AWS, or local setups like Minikube. For these, see "Real DNS". +**Caveat**: This will only work if the cluster LoadBalancer service exposes an IPv4 address, so it will not work with IPv6 clusters, AWS, or local setups like Minikube. For these, see "Real DNS" or "Temporary DNS". {{< /tab >}} @@ -294,6 +294,41 @@ kubectl patch configmap/config-domain \ ``` {{< /tab >}} + +{{% tab name="Temporary DNS" %}} +If you are using `curl` to access the sample applications, or your own Knative app, and are unable to use the "Magic DNS (xip.io)" or "Real DNS" methods, there is a temporary approach. This is useful for those who wish to evaluate Knative without altering their DNS configuration, as per the "Real DNS" method, or cannot use the "Magic DNS" method due to using, for example, minikube locally or IPv6 clusters. + +To access your application using `curl` using this method: + +1. After starting your application, get the URL of your application: + + ```bash + kubectl get ksvc + ``` + + The output should be similar to: + + ```bash + NAME URL LATESTCREATED LATESTREADY READY REASON + helloworld-go http://helloworld-go.default.example.com helloworld-go-vqjlf helloworld-go-vqjlf True + ``` + +1. Instruct `curl` to connect to the External IP or CNAME defined by the networking layer in section 3 above, and use the `-H "Host:"` command-line option to specify the Knative application's host name. For example, if the networking layer defines your External IP and port to be `http://192.168.39.228:32198` and you wish to access the above `helloworld-go` application, use: + + ```bash + curl -H "Host: helloworld-go.default.example.com" http://192.168.39.228:32198 + ``` + + In the case of the provided `helloworld-go` sample application, the output should, using the default configuration, be: + + ``` + Hello Go Sample v1! + ``` + +Refer to the "Real DNS" method for a permanent solution. + +{{< /tab >}} + {{< /tabs >}} 1. Monitor the Knative components until all of the components show a `STATUS` of `Running` or `Completed`: