Skip to content

Latest commit

 

History

History
77 lines (50 loc) · 2.36 KB

File metadata and controls

77 lines (50 loc) · 2.36 KB

Aspire CLI (aspire-cli)

Installs the Aspire CLI.

Example Usage

"features": {
    "ghcr.io/sliekens/devcontainer-features/aspire-cli:1": {
        "quality": "release"
    }
}

Options

Option Type Default Description
quality string release Quality to download. Allowed: release, staging, dev.

Persistent State

Host path Container path Purpose
~/.aspire /var/lib/aspire-cli CLI state and configuration

This directory is bind-mounted from the host so that CLI state is preserved across container rebuilds.

Because Docker cannot bind-mount a directory that does not yet exist, consuming devcontainer.json files should add an initializeCommand to pre-create this directory on the host before the container starts:

{
    "image": "mcr.microsoft.com/devcontainers/base:ubuntu",
    "features": {
        "ghcr.io/sliekens/devcontainer-features/aspire-cli:1": {}
    },
    "initializeCommand": "mkdir -p \"$HOME/.aspire\""
}

License

This feature is released under the MIT License.

The installed tool is subject to its own license: Aspire license.

Links

Release Notes

1.3.3 - 2026-05-16

  • It's just Aspire now

1.3.2 - 2026-05-14

  • Install aspire binary to /opt/aspire/bin and expose it via a wrapper script so aspire bundle operations work as a nonroot user.
  • Hand ownership of /opt/aspire to the container user at container start so bundle locking and extraction work without elevated privileges.

1.3.1 - 2026-05-14

  • Add trailing slash to bind mount source path to mark it explicitly as a directory.

1.3.0 - 2026-03-28

  • Use bind mount from host ~/.aspire instead of a Docker volume for persistent state.

1.2.0 - 2026-03-28

  • Enabled container tunnel support by default for improved CLI experience in devcontainers (ASPIRE_ENABLE_CONTAINER_TUNNEL set to true).

1.1.0 - 2026-03-27

  • Added recommended VS Code extension microsoft-aspire.aspire-vscode.

1.0.0 - 2026-03-26

  • Initial release.