Skip to content

Commit

Permalink
Adding docs for intercept w/ no process fix
Browse files Browse the repository at this point in the history
Signed-off-by: Donny Yung <[email protected]>
  • Loading branch information
Donny Yung committed Jul 22, 2021
1 parent fe530d6 commit 66aa590
Show file tree
Hide file tree
Showing 2 changed files with 21 additions and 1 deletion.
11 changes: 11 additions & 0 deletions reference/intercepts.md
Original file line number Diff line number Diff line change
Expand Up @@ -40,6 +40,17 @@ This will intercept a workload named `hello` and name the intercept `myhello`.

Telepresence can import the environment variables from the pod that is being intercepted, see [this doc](../environment/) for more details.

## Creating an intercept without a local process running

If you are *are* logged into Ambassador Cloud, when you create an intercept the Traffic
Agent does a GET request to your service and the process running on your local machine
at the port specified in your intercept to determine if they support HTTP/2. This is
required for the selective intercepts to behave correctly.

If you do not have a service running locally, the Traffic Agent will use the result
it gets from the HTTP check against your app in the cluster to configure requests
from the local process once it has started.

## Creating an intercept Without a preview URL

If you *are not* logged into Ambassador Cloud, the following command will intercept all traffic bound to the service and proxy it to your laptop. This includes traffic coming through your ingress controller, so use this option carefully as to not disrupt production environments.
Expand Down
11 changes: 10 additions & 1 deletion releaseNotes.yml
Original file line number Diff line number Diff line change
Expand Up @@ -30,11 +30,20 @@ docDescription: >-
changelog: https://github.com/telepresenceio/telepresence/blob/$branch$/CHANGELOG.md

items:

- version: 2.3.7
date: '2021-07-23'
notes:

- type: bugfix
title: Better UX around intercepts with no local process running
body: >-
When initiating an intercept before you have a local process running,
it would result in requests hanging indefinitely. This has been fixed
and will result in an <code>Empty reply from server</code> until you
start a local process.
docs: reference/intercepts

- version: 2.3.6
date: '2021-07-20'
notes:
Expand Down

0 comments on commit 66aa590

Please sign in to comment.