Skip to content

Add migration guide for posit-dev image changes#867

Merged
bschwedler merged 4 commits into
update-default-imagesfrom
docs-posit-dev-migration
May 14, 2026
Merged

Add migration guide for posit-dev image changes#867
bschwedler merged 4 commits into
update-default-imagesfrom
docs-posit-dev-migration

Conversation

@bschwedler
Copy link
Copy Markdown
Contributor

Summary

  • Cross-product Quarto guide covering the 0.20.0 breaking image changes
  • Covers repository renames, tag format reversal, tagPrefix removal, private registry/GHCR alternatives
  • Connect-specific: init container migration, removed customRuntimeYaml, interpreter path changes
  • Workbench-specific: session image tag restructuring (rVersion/pythonVersion/os), component init containers
  • Before/after values snippets and helm diff upgrade verification steps
  • Added to _quarto.yml sidebar as a top-level entry

@bschwedler bschwedler requested review from a team as code owners May 12, 2026 15:36
@bschwedler bschwedler requested a review from ianpittwood May 12, 2026 15:48
@bschwedler bschwedler force-pushed the docs-posit-dev-migration branch 20 times, most recently from 61d0500 to 090d5a1 Compare May 12, 2026 17:00
@bschwedler bschwedler requested a review from jforest May 12, 2026 18:04
Cross-product guide covering the 0.20.0 breaking changes:
repository renames, tag format reversal, tagPrefix removal,
Connect-specific runtime changes, and Workbench session
image tag restructuring. Includes before/after values
snippets and verification steps.
@bschwedler bschwedler force-pushed the docs-posit-dev-migration branch from 090d5a1 to 7d6adb8 Compare May 12, 2026 19:36
Comment thread docs/migrating-to-posit-images.qmd Outdated
Comment thread docs/migrating-to-posit-images.qmd
Comment thread docs/migrating-to-posit-images.qmd Outdated
Comment thread docs/migrating-to-posit-images.qmd Outdated
Comment thread docs/migrating-to-posit-images.qmd Outdated
Comment thread docs/migrating-to-posit-images.qmd Outdated
Comment thread docs/migrating-to-posit-images.qmd Outdated

If you mirror images to a private registry, update the repository path. Make sure your mirror tags follow the new `{appVersion}-{os}` format, or pin `image.tag` to an exact value.

## Connect
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 a ### Connect Content image section be included to mirror what Workbench has? This would be a good opportunity to reiterate an example of the new executionEnvironments value array.

Comment thread docs/migrating-to-posit-images.qmd Outdated
Comment thread docs/migrating-to-posit-images.qmd Outdated
Comment thread docs/migrating-to-posit-images.qmd Outdated
- Capitalize "Posit" in title
- Add Docker Hub rate limit note with GHCR alternative
- Replace em dashes with colons in value lists
- Use complete sentences before colons per style guide
- Long-form product names in headings
- Rename Session image heading to Workbench Session image
- Add Connect Content images section with base/pro examples
- Expand GHCR on first use, link Docker Hub and GHCR orgs
- Add per-product Removed values sections
- Add warning callout for Python path change
- Fix tag format descriptions to use {tagPrefix}{appVersion}
- Expand verification list by product with all image types
@bschwedler bschwedler force-pushed the docs-posit-dev-migration branch from 8c84d94 to bab2e88 Compare May 14, 2026 11:08
@bschwedler bschwedler merged commit 6f36dbb into update-default-images May 14, 2026
8 checks passed
@bschwedler bschwedler deleted the docs-posit-dev-migration branch May 14, 2026 11:16
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.

2 participants