@kingworks/deploy-cli

Zero-configuration CLI tool for deploying web applications to dual-region CDN infrastructure (China and Malaysia).

Features

• Zero configuration - automatically detects project name from git
• Dual-region deployment - deploys to CN and MY regions in parallel
• Secure authentication - Feishu OAuth with automatic token refresh
• Deployment tracking - complete audit trail of all deployments
• Fast uploads - uses STS tokens and parallel uploads

Installation

npm install -g @kingworks/deploy-cli

No additional packages needed. 🎉

Configuration

After installation, you need to configure the CLI:

Quick Setup (Recommended)

# Create global configuration
mkdir -p ~/.deploy-cli
cat > ~/.deploy-cli/.env << EOF
DEPLOY_API_URL=https://your-api-url.com
FEISHU_CLIENT_ID=cli_your_id
EOF

Required Configuration

• DEPLOY_API_URL - Your backend API URL (required)
• FEISHU_CLIENT_ID - Feishu OAuth Client ID (optional, defaults to cli_xxx)

You only need DEPLOY_API_URL. FEISHU_CLIENT_ID is optional.

Usage

First-time setup

# Login with Feishu
deploy login

Deploy to environments

# Deploy to test environment
deploy test

# Deploy to pre-release environment
deploy pre

# Deploy to production environment
deploy prod

Logout

deploy logout

Requirements

• Node.js 18 or higher
• Git repository
• Built application in ./dist/ directory
• Feishu account with deployment permissions

How it works

1. Detects project name from git repository
2. Validates authentication token (auto-refreshes if needed)
3. Requests STS tokens from backend for both CN and MY regions
4. Uploads files to both regions in parallel
5. Reports deployment results to backend
6. Displays CDN URLs for both regions

Environment Variables

• DEPLOY_ENV: Set to local for local development (default: production)

License

MIT

Documentation

Run deploy --help to view the full Chinese command help.