From d2cf66aa948b51b1cb806810db845ac0b093985e Mon Sep 17 00:00:00 2001 From: Julian Friedman Date: Fri, 18 Jun 2021 16:37:51 +0100 Subject: [PATCH] Clarify Magic DNS Caveat (#3823) Magic DNS does work locally on minikube, so long as `minikube tunnel` is running. --- docs/admin/install/knative-with-operators.md | 11 ++++++++--- .../install/serving/install-serving-with-yaml.md | 9 ++++++--- 2 files changed, 14 insertions(+), 6 deletions(-) diff --git a/docs/admin/install/knative-with-operators.md b/docs/admin/install/knative-with-operators.md index cdeb2afdc..e7dedd99b 100644 --- a/docs/admin/install/knative-with-operators.md +++ b/docs/admin/install/knative-with-operators.md @@ -328,9 +328,14 @@ kubectl logs -f deploy/knative-operator 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 or hostname, so it will not work with IPv6 clusters or local setups - like Minikube. For these, see "Real DNS" or "Temporary DNS". + !!! info "Caveat" + This will only work if the cluster `LoadBalancer` service exposes an + IPv4 address or hostname, so it will not work with IPv6 clusters or local setups + like Minikube unless [`minikube tunnel`](https://minikube.sigs.k8s.io/docs/commands/tunnel/) + is running. + + For these, see the "Real DNS" or "Temporary DNS" tabs. + === "Real DNS" To configure DNS for Knative, take the External IP diff --git a/docs/admin/install/serving/install-serving-with-yaml.md b/docs/admin/install/serving/install-serving-with-yaml.md index a6d8067c8..e2acf1ee0 100644 --- a/docs/admin/install/serving/install-serving-with-yaml.md +++ b/docs/admin/install/serving/install-serving-with-yaml.md @@ -194,10 +194,13 @@ Follow the procedure for the DNS of your choice: kubectl apply -f {{ artifact(repo="serving",file="serving-default-domain.yaml")}} ``` - !!! info "CAVEAT" - This will only work if the cluster LoadBalancer service exposes an + !!! info "Caveat" + This will only work if the cluster `LoadBalancer` service exposes an IPv4 address or hostname, so it will not work with IPv6 clusters or local setups - like Minikube. For these, see "Real DNS" or "Temporary DNS". + like Minikube unless [`minikube tunnel`](https://minikube.sigs.k8s.io/docs/commands/tunnel/) + is running. + + For these, see the "Real DNS" or "Temporary DNS" tabs. === "Real DNS"