@@ -51,20 +51,23 @@ details on how to do that.
51
51
52
52
## New Ingest Command
53
53
54
- The _ telepresence ingest _ can be thought of as a _ telepresence intercept _ light . It's an intercept, but without the
55
- traffic.
54
+ The new ingest command can be thought of as a light version of intercept . It's in many respects the same thing, but
55
+ without the traffic.
56
56
57
57
Sometimes, intercepting network traffic to a container isn't the most efficient solution. For example, if you're working
58
58
with a Kafka service that only interacts with a message broker, or if you're planning to send data to your local
59
59
application through other means, just accessing the container's environment and volume mounts might be more practical.
60
- The new ` telepresence ingest <workload> [--container <container name>] ` command was designed for exactly this purpose.
60
+ The new ` telepresence ingest <workload> [--container <container name>] ` command was designed for this purpose.
61
61
62
- The ingest and intercept commands are very similar, but while the intercept will target a port to intercept (and
63
- implicitly a container), the ingest command will target a container directly.
62
+ First, ` telepresence connect ` establishes network access to the cluster. Then, ` telepresence ingest ` makes the
63
+ container's environment and volume mounts available locally, allowing local processes to run, but without receiving
64
+ intercepted traffic.
64
65
65
- An ingest is also less intrusive. Since volumes are always mounted read-only, and everything happens on the client side,
66
- there's no conflict when several ingests of the same container, possibly on different workstations, happen
67
- simultaneously.
66
+ The syntax for the ingest and intercept commands are very similar, but while the intercept will target a port to
67
+ intercept (and implicitly a container), the ingest command will target a container directly.
68
+
69
+ There's no conflict when several ingests of the same container, possibly on different workstations, happen
70
+ simultaneously, because volumes are always mounted read-only, and everything happens on the client side.
68
71
69
72
### Why the term "ingest"?
70
73
I initially considered adding a ` --no-traffic ` option to the ` intercept ` command. This would allow users to invoke the
@@ -114,9 +117,10 @@ The `telpresence intercept/ingest --docker-run` now also leverages this techniqu
114
117
115
118
This release contains several performance improvements. Most notably perhaps the rewrite of the ` telepresence list `
116
119
command, so that it now retrieves its data from the traffic-manager instead of doing a large number of API calls to
117
- the Kubernetes API.
120
+ the Kubernetes API. This makes a huge difference when the namespace contains a large number of workloads.
118
121
119
122
## And there's more
120
123
121
124
The release contains several other improvements such as Windows arm64 support, and the ability to exclude certain
122
- workload types to offload the traffic-manager. For a full list, please review the [ release notes] ( ../docs/release-notes ) .
125
+ workload types to offload the traffic-manager. And, of course, a number of bugfixes. For a full list, please review the
126
+ [ release notes] ( ../docs/release-notes ) .
0 commit comments