Skip to content

refactor(cli)!: remove community image resolution - #3503

Draft
elezar wants to merge 5 commits into
codex/alpine-defaultfrom
codex/community-image-shortcodes
Draft

elezar wants to merge 5 commits into
codex/alpine-defaultfrom
codex/community-image-shortcodes

Conversation

@elezar

@elezar elezar commented Sep 21, 2026

Copy link
Copy Markdown
Member

Summary

Remove the generic Community image-name resolver after the Alpine-default parent PR lands. Bare image names will no longer be expanded through the Community registry; callers must supply explicit OCI image references.

Related Issue

Part of #3116. Stacked on #3386.

Changes

  • Remove the shared Community image registry resolver and OPENSHELL_COMMUNITY_REGISTRY override.
  • Pass explicit image references from the CLI and TUI to the gateway unchanged.
  • Remove the obsolete CLI shorthand example.

Remaining work

  • Replace or retire all documented Community shortcodes and fully qualified Community image references.
  • Decide and document the supported explicit replacements for Community-specific workloads such as ollama, pi, and python.
  • Remove or rename remaining Community-specific configuration compatibility variables.

Testing

  • mise run pre-commit passes
  • Existing resolver tests updated with the implementation
  • Documentation and example migration complete

Checklist

  • Follows Conventional Commits
  • Commits are signed off (DCO)

akram and others added 5 commits September 21, 2026 12:04
With the default sandbox image now Alpine, images that declare no OCI USER
must start instead of being rejected. When the image declares no USER and
the policy requests none, the Podman and Docker drivers now supply a numeric
non-root identity (DEFAULT_SANDBOX_UID/GID = 1000) instead of rejecting,
matching the numeric-identity behavior of the Kubernetes and VM drivers. The
supervisor's resolved-identity path runs the sandbox as a synthesized
non-root account without the account existing in the image. Images that
declare a USER keep the OCI resolution path unchanged.

Part of #3116.

Signed-off-by: Akram <akram.benaissi@gmail.com>
Signed-off-by: Evan Lezar <elezar@nvidia.com>
The restrictive default policy granted read-only access to /app, a directory
that only existed in the community base image. A generic Alpine default has no
/app, so remove it. Landlock best-effort already ignores absent paths; this
just stops advertising a community-specific layout in the default.

Part of #3116.

Signed-off-by: Akram
Signed-off-by: Akram <akram.benaissi@gmail.com>
Signed-off-by: Evan Lezar <elezar@nvidia.com>
Remove DEFAULT_COMMUNITY_REGISTRY, resolve_community_image, and the
OPENSHELL_COMMUNITY_REGISTRY override. Bare --from values are no longer
expanded into the OpenShell Community registry; the CLI and TUI now pass
explicit OCI image references through to the gateway unchanged. The
openshell-core image module is reduced to default_sandbox_image().

BREAKING CHANGE: community sandbox shorthand names and OPENSHELL_COMMUNITY_REGISTRY
are no longer supported; pass a full OCI image reference to --from.

Part of #3116.

Signed-off-by: Akram <akram.benaissi@gmail.com>
@copy-pr-bot

copy-pr-bot Bot commented Sep 21, 2026

Copy link
Copy Markdown

Auto-sync is disabled for draft pull requests in this repository. Workflows must be run manually.

Contributors can view more details about this message here.

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