standby
v0.1.2
Published
Displays a simple standby page on the specified port, refreshing until your real site comes back. Great for deployments and data migrations that shouldn't be run while your site is up.
Downloads
4
Maintainers
Readme
standby
Standby is an incredibly simple server that just delivers a page saying your site will be back shortly. That's all!
Use it in your deployment scripts to put up a placeholder page on the port number of your node app while you are migrating data or performing other tasks that can't be done while the site is up.
The standby page will automatically refresh until your site comes back.
The URL in the browser does not change, so the user typically gets the page they wanted once the site is back up.
How to Install
npm install -g standby
How to Use
To display a standby page on port 3000:
standby start 3000
To stop displaying a standby page on port 3000:
standby stop 3000
To substitute your own static content in place of our standby page:
standby start 3000 --content=/path/to/my/assets/folder
The page displayed to the user will be index.html
in the content folder.
Note that you need to stop standby
before launching your app again.
Standby uses files in /tmp/standby
to keep track of what's already running. We use /tmp
rather than /var/run
because we hardly ever launch node apps as root.
Requirements
You need node and npm, of course. That's about it.
Standby and Stagecoach
Althogh you can use standby
without it, we had stagecoach in mind when we wrote it. stagecoach
makes it easy to deploy one or more node apps to an Ubuntu server without a lot of fuss. standby
is a good companion piece for use during temporary downtime such as during data migration.
About P'unk Avenue and Apostrophe
standby
was created at P'unk Avenue for use with sites built on Apostrophe, an open-source content management system built on node.js. If you like standby
you should definitely check out apostrophenow.org. Also be sure to visit us on github.
Support
Feel free to open issues on github.