@@ -6,29 +6,28 @@ This document tracks custom modifications in the hext-dev/envbuilder fork.
66
77| Branch | Purpose | Image Tag |
88| --------| ---------| -----------|
9- | ` main ` | Stable, synced with upstream | ` ghcr.io/hext-dev/envbuilder:latest ` |
10- | ` hext/gcp-lifecycle-reporting ` | GCP instance identity auth + lifecycle reporting | ` ghcr.io/hext-dev/envbuilder:hext-dev-* ` |
9+ | ` main ` | All hext-dev features (GCP auth, lifecycle reporting, container persistence) | ` ghcr.io/hext-dev/envbuilder:hext-dev-* ` |
10+
11+ The ` main ` branch contains all custom hext-dev features. We no longer track upstream on main - sync manually when needed.
1112
1213## Tag Namespace
1314
1415- ** Upstream tags:** ` v1.x.x ` (from coder/envbuilder)
1516- ** Hext dev tags:** ` hext-dev-v0.x.x ` (our custom features)
1617
17- ** Current dev version:** ` hext-dev-v0.1.3 ` (GCP instance identity auth + lifecycle reporting + container persistence)
18+ ** Current dev version:** ` hext-dev-v0.1.4 ` (GCP instance identity auth + lifecycle reporting + container persistence + unexpanded ARG handling )
1819
1920This separation allows easy rollback:
2021``` terraform
2122# Use stable version
2223devcontainer_builder_image = "ghcr.io/hext-dev/envbuilder:latest"
2324
2425# Use dev version with all hext-dev features
25- devcontainer_builder_image = "ghcr.io/hext-dev/envbuilder:hext-dev-v0.1.3 "
26+ devcontainer_builder_image = "ghcr.io/hext-dev/envbuilder:hext-dev-v0.1.4 "
2627```
2728
2829## Feature: GCP Instance Identity Auth + Lifecycle Reporting
2930
30- ** Branch:** ` hext/gcp-lifecycle-reporting `
31-
3231** Problem:** When envbuilder fails to build a devcontainer, the Coder workspace hangs forever because:
33321 . The Coder agent runs inside the container (never starts if build fails)
34332 . We can't use ` CODER_AGENT_TOKEN ` due to caching/agent association issues
@@ -57,7 +56,7 @@ devcontainer_builder_image = "ghcr.io/hext-dev/envbuilder:hext-dev-v0.1.3"
5756
5857``` bash
5958# Template uses new image
60- devcontainer_builder_image = " ghcr.io/hext-dev/envbuilder:hext-dev-v0.1.3 "
59+ devcontainer_builder_image = " ghcr.io/hext-dev/envbuilder:hext-dev-v0.1.4 "
6160
6261# Pass new env vars
6362" ENVBUILDER_CODER_AUTH_METHOD" : " gcp-instance-identity" ,
@@ -67,8 +66,7 @@ devcontainer_builder_image = "ghcr.io/hext-dev/envbuilder:hext-dev-v0.1.3"
6766
6867## Feature: Container Persistence (ENVBUILDER_ENV_FILE)
6968
70- ** Branch:** ` hext/gcp-lifecycle-reporting `
71- ** Version:** ` hext-dev-v0.1.3 `
69+ ** Version:** ` hext-dev-v0.1.3+ `
7270
7371** Problem:** By default, Coder workspaces use ` docker run --rm ` , destroying the container on stop. This loses:
7472- Installed packages (` apt install ` , ` pip install ` )
@@ -120,16 +118,12 @@ See [container-persistence.md](container-persistence.md) for full design details
120118
121119``` bash
122120git fetch upstream
123- git checkout main
124- git merge upstream/main
121+ git merge upstream/main # Merge upstream changes into main
125122git push origin main
126-
127- # Rebase feature branch
128- git checkout hext/gcp-lifecycle-reporting
129- git rebase main
130- git push --force-with-lease origin hext/gcp-lifecycle-reporting
131123```
132124
125+ Note: We no longer maintain a separate feature branch. All development happens on ` main ` .
126+
133127## Critical Gotchas
134128
135129### Use Annotated Tags for Releases
0 commit comments