Skip to content

Document deployment lessons from isoform fix rollout#152

Merged
kltm merged 1 commit intomainfrom
docs/deployment-lessons-135
Apr 3, 2026
Merged

Document deployment lessons from isoform fix rollout#152
kltm merged 1 commit intomainfrom
docs/deployment-lessons-135

Conversation

@kltm
Copy link
Copy Markdown
Member

@kltm kltm commented Apr 3, 2026

Summary

  • Document --target flag for gh release create with backport example
  • Add version tag constraints: semver required, 4-component tags fail silently
  • Add branch-aware provisioning guidance (templates/vars differ between branches)

Refs #135

Context

These are lessons learned from deploying the isoform fix (#135) as a backport release. Three separate issues were encountered:

  1. --target main tagged the wrong commit for a release branch backport
  2. A 4-component tag (v0.3.9.1) silently failed the Docker build
  3. The provision/ directory on main was missing sparql_url needed by the v0.3.9 config template

Companion PR for devops-documentation: geneontology/devops-documentation#9

Test plan

  • Verify CLAUDE.md/AGENTS.md renders correctly on GitHub

🤖 Generated with Claude Code

…isioning

Lessons learned from deploying the isoform fix (#135):
- gh release create --target must point to the correct branch for backports
- 4-component version tags silently fail the Docker build (not valid semver)
- Provisioning templates differ between branches; must checkout the correct one

Refs #135

Co-Authored-By: Claude Opus 4.6 (1M context) <[email protected]>
@kltm
Copy link
Copy Markdown
Member Author

kltm commented Apr 3, 2026

Bot doc fixes; the non-passing tests are due to data release. A PR for that is here: #153

@kltm kltm merged commit 8aefd48 into main Apr 3, 2026
1 check failed
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.

1 participant