2 min • read

Intercept a service

You can quickly intercept traffic destined to a workload in your cluster so that it is sent to your workstation instead.

Install Telepresence and log in

Follow these instructions to install the latest version of Telepresence and make sure to login by running the following command:

Terminal
$ telepresence login

Intercept from the Connected view

  1. Start your local instance of the service

  2. Once you have logged in, you should see an indicator in the top bar telling you that your computer is connected. Click on "Connected (x/x)", hover your computer name and click the "Intercept" button.

    Connected computer view's Intercept button

  3. In the slideout that opens, you'll see the list of services available to intercept based on the selected Namespace filter. Intercept Slideout

  4. Click on the service you want to intercept

  5. Fill out the form to complete the intercept.

Intercept from the main Service Catalog view

  1. Start your local instance of the service
  2. Click on the service you want to intercept to go into the Service Details view
  3. Choose a cell and click the intercept button
  4. Fill out the form to complete the intercept.

Intercept this service

Intercept from the Service Details view

  1. Start your local instance of the service
  2. Go to the Intercept tab
  3. Click the New Intercept button
  4. Fill out the form to complete the intercept.

Fill out the form to complete the intercept

  1. Select the port from your service that you want to intercept

  2. Select which port on your computer where requests should be sent to

  3. Optionally, update the advanced settings that define how requests from generated preview url should be sent to you cluster:

    1. In the "INGRESS IP ADDRESS/DNS NAME + PORT NUMBER" field, enter the address and port of a LoadBalancer service in your cluster
    2. Select whether the LoadBalancer service port uses TLS
    3. Specify the Host header that should be passed along with the request. If you have a Mapping that routes requests to your services based a specific hostname, this is the value you should specify here
  4. Click Intercept

    Intercept settings form