2 min • read

Telepresence basic commands

Once you've installed Telepresence, take a moment to familiarize yourself with these basic Telepresence commands.

Connect to Telepresence

To connect to your cluster, enter telepresence connect in your terminal. Then connect to the Kubernetes API server:

Terminal
$ curl -ik https://kubernetes.default
HTTP/1.1 401 Unauthorized
Cache-Control: no-cache, private
Content-Type: application/json
...

View your services in Ambassador Cloud

After you connect to your cluster, enter telepresence login to launch Ambassador Cloud in your browser.

View existing service

Enter telepresence list and Telepresence populates a list of the services available to intercept:

Terminal
$ telepresence list
...
example-service: ready to intercept (traffic-agent not yet installed)
...

Get the name of the port you want to intercept on your service

Enter kubectl get service <service name> --output yaml to retrieve the port of your desired service.

Terminal
$ kubectl get service example-service --output yaml
...
ports:
- name: http
port: 80
protocol: TCP
targetPort: http
...