A command line interface for SPAship!
Last updated a month ago by kunyan .
MIT · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install @spaship/cli 
SYNC missed versions from official npm registry.


A command line interface for SPAship.

oclif Version Downloads/week License


$ npm install -g @spaship/cli
$ spaship COMMAND
running command...
$ spaship (-v|--version|version)
@spaship/cli/0.10.0 darwin-x64 node-v13.7.0
$ spaship --help [COMMAND]
  $ spaship COMMAND


spaship deploy ARCHIVE

deploy to a SPAship host

  $ spaship deploy ARCHIVE

  ARCHIVE  SPA archive file

  -e, --env=env    [default: default] either the name of a SPAship environment as defined in your .spashiprc.yml file,
                   or a URL to a SPAship environment

  -r, --ref=ref    [default: undefined] a version tag, commit hash, or branch to identify this release

  --apikey=apikey  a SPAship API key

  Send an archive containing a SPA to a SPAship host for deployment.  Supports .tar.gz/.tgz, .zip, and .tar.bz2.

  $ npm pack
  $ spaship deploy your-app-1.0.0.tgz

See code: src/commands/deploy.js

spaship help [COMMAND]

display help for spaship

  $ spaship help [COMMAND]

  COMMAND  command to show help for

  --all  see all commands in CLI

See code: @oclif/plugin-help

spaship init

Initialize a SPAship config file for your app.

  $ spaship init

  -n, --name=name    (required) a human-friendly title for your app
  -p, --path=path    (required) the URL path for your app under the SPAship domain. ex: /my/app
  -s, --[no-]single  route all non-asset requests to index.html
  --overwrite        overwrite existing spaship.yaml

  Without arguments, init will ask you a few questions and generate a spaship.yaml config file.  The answers can also be 
  passed in as CLI options.

See code: src/commands/init.js

spashiprc & SPAship environments

(As a rule of thumb, spaship.yaml files are consumed by the SPAship API, whereas spashiprc files are consumed by the CLI)

spashiprc files provide an alternative to typing out --apikey KEY and --env URL every time you run spaship commands. You can use a spashiprc file to define an environment name (like qa) along with its URL and API key, after which you can run spaship deploy --env qa. The URL and API key will be read from your spashiprc file.

Do not commit API keys to your project's version control. If you do, I'll know. See spashiprc layering for how to avoid committing API keys.

spashiprc files are optional, but very convenient if you plan to do deployments from your dev environment. If your deployments are done by a CI/CD server, you probably don't need a spashiprc file and will be better off using --env URL and --apikey KEY.

spashiprc layering

To separate environment URLs from API keys, you can "layer" two spashiprc files together. After the spaship command finds a spashiprc file, it continues searching parent directories for other spashiprc files. If any secondary spashiprc files are found, their values are merged together. If there are conflicting values, the values from the child directory (nearer to your project) will win.

This allows you to put a spashiprc file containing your SPAship URLs in your project's source control, and a secondary spashiprc file containing API keys in a parent directory, not in your project's source control.

For an example, see spashiprc-layering-example.

spashiprc examples

spashiprc with default environment

This spashiprc file defines a default environment which will be used whenever --env is not provided.


    url: https://localhost:8008
    apikey: 57d5c061-9a02-40fc-a3e4-1eb3c9ae6a12

Now when you run spaship commands, the --env flag is optional. When it's omitted, the default environment will be used.

spaship deploy MyProject-1.0.0.tgz

spashiprc layering example


    apikey: 57d5c061-9a02-40fc-a3e4-1eb3c9ae6a12
    apikey: 70f19422-bf53-44b1-b664-f9b4636bea61


    url: https://qa.spaship.io
    url: https://spaship.io

When you run spaship commands from within $HOME/projects/MyProject, both of the above spashiprc files will be loaded and merged together, forming a complete definition of URL+API key for each environment.

Such as:

cd $HOME/projects/MyProject
spaship deploy --env prod MyProject-1.0.0.tgz

Writing tests

Tests are written using oclif's testing tools. See oclif's testing documentation for more.

Current Tags

  • 0.10.0                                ...           latest (a month ago)

19 Versions

  • 0.10.0                                ...           a month ago
  • 0.9.2                                ...           2 months ago
  • 0.9.1                                ...           2 months ago
  • 0.8.0                                ...           2 months ago
  • 0.7.0                                ...           2 months ago
  • 0.6.0                                ...           2 months ago
  • 0.5.0                                ...           3 months ago
  • 0.4.0                                ...           3 months ago
  • 0.3.5                                ...           5 months ago
  • 0.3.4                                ...           7 months ago
  • 0.0.12                                ...           8 months ago
  • 0.0.11                                ...           8 months ago
  • 0.0.10                                ...           8 months ago
  • 0.0.9                                ...           8 months ago
  • 0.0.6                                ...           8 months ago
  • 0.0.5                                ...           8 months ago
  • 0.0.4                                ...           8 months ago
  • 0.0.3                                ...           8 months ago
  • 0.0.2                                ...           8 months ago
Today 0
This Week 0
This Month 0
Last Day 0
Last Week 0
Last Month 0
Dependencies (9)
Dev Dependencies (10)
Dependents (0)

Copyright 2014 - 2016 © taobao.org |