Skip to main content

Bundle Registry

CloudShip Platform hosts a bundle registry for sharing agent configurations across your organization.

Uploading Bundles

Via CLI

# Upload from environment
stn bundle share production

# Upload existing bundle file
stn bundle share ./my-bundle.tar.gz

Via Dashboard

  1. Go to Bundles in CloudShip dashboard
  2. Click Upload Bundle
  3. Drag and drop your .tar.gz file
  4. Add metadata (name, description, tags)
  5. Click Publish

Installing from CloudShip

# Install by UUID
stn bundle install e26b414a-f076-4135-927f-810bc1dc892a my-environment

# Install with stn up
stn up --bundle e26b414a-f076-4135-927f-810bc1dc892a

Bundle Visibility

VisibilityAccess
PrivateOnly your organization
OrganizationAll org members
PublicAnyone (with link)

Cherry-Pick Manifests

Select specific agents from multiple bundles:
{
  "sources": [
    {
      "bundle_id": "e26b414a-f076-4135-927f-810bc1dc892a",
      "agents": ["security-scanner", "code-reviewer"]
    },
    {
      "bundle_id": "f37c525b-g187-5246-a38g-921cd2ed933b",
      "agents": ["devops-helper"]
    }
  ]
}
Create custom bundle from manifest:
curl -X POST https://app.cloudshipai.com/api/registry/custom-bundle/ \
  -H "Authorization: Bearer $CLOUDSHIP_TOKEN" \
  -d @manifest.json \
  --output custom-bundle.tar.gz

Version Management

Semantic Versioning

Bundles support semantic versioning:
{
  "name": "security-bundle",
  "version": "1.2.3"
}

Installing Specific Versions

stn bundle install security-bundle@1.2.3 my-env

Latest vs Pinned

  • Latest: Always get newest version
  • Pinned: Lock to specific version for reproducibility

Organization Bundles

Sharing Within Org

When you upload a bundle, choose organization visibility:
stn bundle share ./bundle.tar.gz --visibility organization

Team Permissions

RoleCan UploadCan InstallCan Delete
Admin
MemberOwn only
Viewer

Bundle Analytics

CloudShip tracks:
  • Download counts
  • Active installations
  • Error rates
  • Popular agents
View analytics in dashboard under Bundles → Analytics.