Skip to content

internal: Add comments about env files#3957

Merged
DrJosh9000 merged 1 commit into
mainfrom
comments-on-env-files
May 27, 2026
Merged

internal: Add comments about env files#3957
DrJosh9000 merged 1 commit into
mainfrom
comments-on-env-files

Conversation

@DrJosh9000
Copy link
Copy Markdown
Contributor

Description

Make it easier to understand what BUILDKITE_ENV_FILE is for.

Context

https://linear.app/buildkite/issue/A-1236

Changes

Add some comments.

Testing

  • Tests have run locally (with go test ./...). Buildkite employees may check this if the pipeline has run automatically.
  • Code is formatted (with go tool gofumpt -extra -w .)

Disclosures / Credits

These are just some words I wrote

@DrJosh9000 DrJosh9000 requested review from a team as code owners May 26, 2026 06:44
@DrJosh9000 DrJosh9000 added the internal Non-user facing, internal change. label May 26, 2026
Copy link
Copy Markdown
Contributor

@zhming0 zhming0 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good with a suggestion 👍🏿

Comment thread agent/job_runner.go Outdated
// to the pre-bootstrap hook.
// - Env files are designed to be validated by the pre-bootstrap hook
// - Env files are designed to be validated by the pre-bootstrap hook.
// Because the job env may contain untrusted or even dangerous env vars,
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should we give an example here?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I've added some more words in parentheses that explain how such an env var might be added, and how it could be dangerous, but I would rather not be overly specific.

@DrJosh9000 DrJosh9000 force-pushed the comments-on-env-files branch from 8d9cc97 to 214bb7b Compare May 26, 2026 07:12
@DrJosh9000 DrJosh9000 merged commit a440d99 into main May 27, 2026
4 checks passed
@DrJosh9000 DrJosh9000 deleted the comments-on-env-files branch May 27, 2026 01:42
@quinn-diesel quinn-diesel mentioned this pull request Jun 5, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

internal Non-user facing, internal change.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants