FazBrowse GitHub Viewer | Trending |
URL:
| Home
Tools: [Download Repo ZIP]   [Original HTTPS Page]

docs: interactive walks for helper prepare and GOPROXY by EmmS21 · Pull Request #13932 · dagger/dagger · GitHub

/ dagger Public

docs: interactive walks for helper prepare and GOPROXY - #13932

Open
EmmS21 wants to merge 1 commit into
dagger:mainfrom
EmmS21:docs/helper-prepare-visuals
Open

docs: interactive walks for helper prepare and GOPROXY#13932
EmmS21 wants to merge 1 commit into
dagger:mainfrom
EmmS21:docs/helper-prepare-visuals

Conversation

EmmS21 commented Aug 19, 2026

Copy link
Copy Markdown
Contributor

Fixes #13931

Summary

Two interactive walks. No extra pages. Copy stays short. The pictures do the work text keeps failing at: people treat the laptop as Dagger during helper prepare.

Where each visual sits

Helper prepare walk: Execution, after The Path, on steps 3 and 4

Those two lines are:

  1. The engine loads the requested module.
  2. The SDK exposes the module API.

Then the page already says the caller invokes a function. The visual sits in the gap between 4 and 5. That gap is prepare. The function list does not exist yet. The caller cannot invoke anything.

This is the "what happens under the hood" page. Load then expose the API is helper prepare, named as two steps. The picture is those steps drawn: engine already on, a short-lived helper, named settings (not the laptop), downloads, then the function list. Your function stays empty until that list exists.

Not Calling Functions. That page is the command after the list exists. Not Service Proxies for this walk. That page is one env var. Git has no home there.

Lazy Work, Traces, and Cloud stay as they are. The visual does not belong under them.

Call stages: Service Proxies, next to GOPROXY

That page already says set _DAGGER_ENGINE_SYSTEMENV_GOPROXY on the engine container, and that Dagger passes it into Go module downloads including SDK codegen. The four-stage walk is that sentence drawn: connect does not use GOPROXY, load is your files, prepare is the Go helper and the default proxy, your function is last and does not run if prepare cannot finish.

Custom Runner is how you start the box. Point at it. Do not put the four stages there.

Test plan

  • Open /extending/how-dagger-works/execution (Next). Click each prepare step. Helper appears inside the engine. Function stays empty until the list exists.
  • Open /reference/configuration/proxy. Click the four stages. Prepare is the Go download. Connect and the function are not.
  • Confirm laptop, engine, and helper copy names where settings sit, without issue numbers.

Made with Cursor

Show where host, engine, and helper sit before a function exists, and that Go module downloads happen in prepare rather than at connect or in the function.

Fixes dagger#13931

Signed-off-by: EmmS21 <emmanuelsibanda21@gmail.com>
Co-authored-by: Cursor <cursoragent@cursor.com>
EmmS21 requested a review from a team as a code owner August 19, 2026 20:27
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters. Learn more about bidirectional Unicode characters
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Docs never make the helper-prepare mental model explicit, so proxy and git issues keep recurring

1 participant


Back | FazBrowse Home | New Git URL