cloudsmith/cloudsmith-cli repository overview

⁠🐳 Cloudsmith CLI (Containerized)

Official Docker image for the Cloudsmith CLI⁠, built for use in CI/CD pipelines and automation environments.

This image includes the latest Cloudsmith CLI as a zipapp and is optimized for minimal size and fast execution.

⁠✅ Key Features

• Lightweight Alpine-based Docker image (~20MB compressed)
• Ships with the versioned zipapp⁠ of the Cloudsmith CLI
• Supports API Key authentication out-of-the-box
• Suitable for CI tools like GitHub Actions, GitLab CI, Bitbucket Pipelines, Jenkins, etc.

⁠🔐 Authentication

⁠1. API Key (Supported)

Pass your API key using the CLOUDSMITH_API_KEY environment variable:

docker run --rm -e CLOUDSMITH_API_KEY=your-key \
  cloudsmith/cloudsmith-cli:latest \
  whoami

⁠2. OIDC (Manual Setup)

OIDC authentication is not built-in as of now, but can be used by:

• Performing a token exchange outside the container, taking reference from here⁠
• Setting the resulting token as CLOUDSMITH_API_KEY

⁠🚀 CI/CD Example (GitHub Actions)

jobs:
  cloudsmith:
    runs-on: ubuntu-latest
    container:
      image: cloudsmith/cloudsmith-cli:1.8.3
    steps:
      - run: cloudsmith whoami
        env:
          CLOUDSMITH_API_KEY: ${{ secrets.CLOUDSMITH_API_KEY }}

⁠🛠️ Image Details

• Base Image: python:3.12-alpine
• CLI Installed: via Zipapp⁠ and placed at /opt/cloudsmith/cloudsmith
• Convenience: cloudsmith is symlinked into $PATH

⁠🔗 Related Links

• 📦 Cloudsmith CLI Docs⁠
• 💻 cloudsmith-io/cloudsmith-cli GitHub⁠
• 🧪 Cloudsmith CLI Zipapp Registry⁠

⁠🧑‍💻 Maintainers

Maintained by the Cloudsmith Customer Engineering team.
Reach out via support.cloudsmith.io⁠ for feedback or questions.