Skip to content

Document GHCR package visibility and how to make public #140

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
blooop merged 7 commits into from
Feb 10, 2026
Merged

Document GHCR package visibility and how to make public #140

Show file tree
Hide file tree
Changes from 1 commit
Commits
Show all changes
7 commits
Select commit Hold shift + click to select a range
867454b
Document GHCR package visibility and how to make it public
blooop Feb 10, 2026
799c95b
Default to local builds for template portability
blooop Feb 10, 2026
f44873a
Add pixi task to migrate devcontainer to prebuilt GHCR image
blooop Feb 10, 2026
37cc4f3
Address Sourcery review: clarify org vs user package paths
blooop Feb 10, 2026
dab0704
Fix portability and add gh CLI check in migration script
blooop Feb 10, 2026
330f1d0
Address subagent review feedback
blooop Feb 10, 2026
37688f0
Fix syntax error in gh api error handling
blooop Feb 10, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions .devcontainer/devcontainer.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -12,8 +12,8 @@
// "context": ".."
// },
// "features": {
// "./claude-code": {}
// "ghcr.io/devcontainers/features/docker-in-docker:2": {}
// "./claude-code": {},
// "ghcr.io/devcontainers/features/docker-in-docker:2": {},
// "ghcr.io/devcontainers/features/common-utils:2": {},
// "ghcr.io/anthropics/devcontainer-features/claude-code:1.0": {},
// "ghcr.io/jsburckhardt/devcontainer-features/codex:latest": {}
Expand Down
37 changes: 37 additions & 0 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -57,6 +57,43 @@ source .claude/activate.sh

See [.claude/README.md](.claude/README.md) for detailed information about the Claude Code configuration.

# Devcontainer Prebuilt Image

This template includes a CI workflow (`.github/workflows/devcontainer.yml`) that automatically builds and pushes a devcontainer image to GitHub Container Registry (GHCR) whenever `.devcontainer/` files change on `main`.

The main `.devcontainer/devcontainer.json` references this prebuilt image to avoid slow local builds:

```json
"image": "ghcr.io/blooop/python_template/devcontainer:latest"
```

## GHCR Package Visibility

**GHCR packages are private by default.** After the first CI push, you must manually make the package public or users (and tools like DevPod) will get a `MANIFEST_UNKNOWN` error when trying to pull the image.

### Making the package public

**Option 1: GitHub Web UI**

1. Go to your repository's package settings:
`https://github.com/users/<username>/packages/container/<repo>%2Fdevcontainer/settings`
2. Under "Danger Zone", click **Change visibility**
3. Select **Public** and confirm

**Option 2: GitHub CLI**

```bash
# Ensure your token has the write:packages scope
gh auth refresh -s write:packages

# Set the package to public
gh api --method PATCH /user/packages/container/<repo>%2Fdevcontainer -f visibility=public
```

## Falling back to local builds

If the prebuilt image is unavailable, you can switch to local builds by editing `.devcontainer/devcontainer.json`: comment out the `"image"` line and uncomment the `"build"` and `"features"` blocks.

# Github setup

There are github workflows for CI, codecov and automated pypi publishing in `ci.yml` and `publish.yml`.
Expand Down