Skip to content

Commit

Permalink
Fix port-forarding instructions; port-forward to istio gateway
Browse files Browse the repository at this point in the history
See kubeflow#1041 and kubeflow/kubeflow#3618

* With 0.6 if no auth is setup and you want to connect via port-forwarding
  then you need to port-forward to the ISTIO gateway; not ambassador

* I suspect the original suggestion in kubeflow#1041 to port-forward to Ambassador
  only worked in the basic auth setting in which case we are still setting
  up Ambassador.

Fix: kubeflow#1041
  • Loading branch information
jlewi committed Aug 13, 2019
1 parent d01f2cb commit a49729f
Show file tree
Hide file tree
Showing 2 changed files with 22 additions and 2 deletions.
22 changes: 21 additions & 1 deletion content/docs/other-guides/accessing-uis.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,14 @@ weight = 1
Kubeflow includes a number of web user interfaces (UIs). This document provides
instructions on how to connect to them.

To access the Kubeflow UI's you need to connect to the
[ISTIO gateway](https://istio.io/docs/concepts/traffic-management/#gateways) that
provides access to the Kubeflow
[service mesh](https://istio.io/docs/concepts/what-is-istio/#what-is-a-service-mesh).

How you access the ISTIO gateway will vary depending on how you've configured it.


## Accessing Kubeflow web UIs

The Kubeflow web UIs include the following:
Expand Down Expand Up @@ -47,6 +55,18 @@ guide to

## Using kubectl and port-forwarding

If you didn't configure Kubeflow to integrate with an identity provider and perform
any authorization checks (for example you aren't using IAP with Google or DEX)
then you can port-forward directly to the ISTIO gateway.

Port-forwarding typically won't work if any of the following are true

* you've configured the ISTIO ingress to only accept
HTTPS traffic on a specific domain or IP address

* you've configured the ISTIO ingress to perform an authorization check (e.g. using IAP or Dex)


You can access Kubeflow via `kubectl` and port-forwarding as follows:

1. Install `kubectl` if you haven't already done so:
Expand All @@ -57,7 +77,7 @@ You can access Kubeflow via `kubectl` and port-forwarding as follows:
installation guide](https://kubernetes.io/docs/tasks/tools/install-kubectl/).

1. Use the following command to set up port forwarding to the
[Ambassador](https://www.getambassador.io/) service that provides the reverse proxy.
[ISTIO gateway](https://istio.io/docs/tasks/traffic-management/ingress/ingress-control/).

{{% code-webui-port-forward %}}

Expand Down
2 changes: 1 addition & 1 deletion layouts/shortcodes/code-webui-port-forward.html
Original file line number Diff line number Diff line change
@@ -1,3 +1,3 @@
<pre><code>export NAMESPACE=istio-system
kubectl port-forward svc/ambassador -n ${NAMESPACE} 8080:80
kubectl port-forward -n istio-system svc/istio-ingressgateway 8080:80
</code></pre>

0 comments on commit a49729f

Please sign in to comment.