Preevy CLI

Preevy is a CLI tool for easily creating preview environments for your Docker Compose apps on your cloud provider - we currently support AWS and Google, with more on the way.
Usage
$ npm install -g preevy
$ preevy COMMAND
running command...
$ preevy (--version)
preevy/0.0.32 linux-x64 node-v18.16.0
$ preevy --help [COMMAND]
USAGE
$ preevy COMMAND
...
Commands
preevy down
Delete preview environments
USAGE
$ preevy down [-D] [-f <value>] [--system-compose-file <value>] [-p <value>] [-d lightsail|gce|azure]
[--lightsail-region us-east-2|us-east-1|us-west-2|ap-south-1|ap-northeast-2|ap-southeast-1|ap-southeast-2|ap-northea
st-1|ca-central-1|eu-central-1|eu-west-1|eu-west-2|eu-west-3|eu-north-1] [--gce-project-id <value>] [--gce-zone
<value>] [--azure-region <value>] [--azure-subscription-id <value>] [--id <value>] [--force] [--wait] [--json]
FLAGS
-d, --driver=<option> Machine driver to use
<options: lightsail|gce|azure>
--force Do not error if the environment is not found
--id=<value> Environment id - affects created URLs. If not specified, will try to detect automatically
--wait Wait for resource deletion to complete. If false (the default), the deletion will be started
but not waited for
GLOBAL FLAGS
-D, --debug Enable debug logging
-f, --file=<value>... [default: ] Compose configuration file
-p, --project=<value> Project name. Defaults to the Compose project name
--json Format output as json.
--system-compose-file=<value>... [default: ] Add extra Compose configuration file without overriding the defaults
AZURE DRIVER FLAGS
--azure-region=<value> Microsoft Azure region in which resources will be provisioned
--azure-subscription-id=<value> Microsoft Azure subscription id
GCE DRIVER FLAGS
--gce-project-id=<value> Google Cloud project ID
--gce-zone=<value> Google Cloud zone in which resources will be provisioned
LIGHTSAIL DRIVER FLAGS
--lightsail-region=<option> AWS region in which resources will be provisioned
<options: us-east-2|us-east-1|us-west-2|ap-south-1|ap-northeast-2|ap-southeast-1|ap-south
east-2|ap-northeast-1|ca-central-1|eu-central-1|eu-west-1|eu-west-2|eu-west-3|eu-north-1>
DESCRIPTION
Delete preview environments
See code: dist/commands/down.ts
preevy help [COMMANDS]
Display help for preevy.
USAGE
$ preevy help [COMMANDS] [-n]
ARGUMENTS
COMMANDS Command to show help for.
FLAGS
-n, --nested-commands Include all nested commands in the output.
DESCRIPTION
Display help for preevy.
See code: @oclif/plugin-help
preevy init [PROFILE-ALIAS]
Initialize or import a new profile
USAGE
$ preevy init [PROFILE-ALIAS] [-D] [-f <value>] [--system-compose-file <value>] [-p <value>] [-f <value>]
ARGUMENTS
PROFILE-ALIAS [default: default] Alias of the profile
FLAGS
-f, --from=<value> Import profile from existing path
GLOBAL FLAGS
-D, --debug Enable debug logging
-f, --file=<value>... [default: ] Compose configuration file
-p, --project=<value> Project name. Defaults to the Compose project name
--system-compose-file=<value>... [default: ] Add extra Compose configuration file without overriding the defaults
DESCRIPTION
Initialize or import a new profile
See code: dist/commands/init.ts
preevy logs [SERVICES]
Show logs for an existing environment
USAGE
$ preevy logs [SERVICES] [-D] [-f <value>] [--system-compose-file <value>] [-p <value>] [-d
lightsail|gce|azure] [--lightsail-region us-east-2|us-east-1|us-west-2|ap-south-1|ap-northeast-2|ap-southeast-1|ap-s
outheast-2|ap-northeast-1|ca-central-1|eu-central-1|eu-west-1|eu-west-2|eu-west-3|eu-north-1] [--gce-project-id
<value>] [--gce-zone <value>] [--azure-region <value>] [--azure-subscription-id <value>] [--id <value>] [--columns
<value> | -x] [--sort <value>] [--filter <value>] [--output csv|json|yaml | | [--csv | --no-truncate]] [--no-header
| ]
ARGUMENTS
SERVICES Service name(s). If not specified, will show all services
FLAGS
-d, --driver=<option> Machine driver to use
<options: lightsail|gce|azure>
-x, --extended show extra columns
--columns=<value> only show provided columns (comma-separated)
--csv output is csv format [alias: --output=csv]
--filter=<value> filter property by partial string matching, ex: name=foo
--id=<value> Environment id - affects created URLs. If not specified, will try to detect automatically
--no-header hide table header from output
--no-truncate do not truncate output to fit screen
--output=<option> output in a more machine friendly format
<options: csv|json|yaml>
--sort=<value> property to sort by (prepend '-' for descending)
GLOBAL FLAGS
-D, --debug Enable debug logging
-f, --file=<value>... [default: ] Compose configuration file
-p, --project=<value> Project name. Defaults to the Compose project name
--system-compose-file=<value>... [default: ] Add extra Compose configuration file without overriding the defaults
AZURE DRIVER FLAGS
--azure-region=<value> Microsoft Azure region in which resources will be provisioned
--azure-subscription-id=<value> Microsoft Azure subscription id
GCE DRIVER FLAGS
--gce-project-id=<value> Google Cloud project ID
--gce-zone=<value> Google Cloud zone in which resources will be provisioned
LIGHTSAIL DRIVER FLAGS
--lightsail-region=<option> AWS region in which resources will be provisioned
<options: us-east-2|us-east-1|us-west-2|ap-south-1|ap-northeast-2|ap-southeast-1|ap-south
east-2|ap-northeast-1|ca-central-1|eu-central-1|eu-west-1|eu-west-2|eu-west-3|eu-north-1>
DESCRIPTION
Show logs for an existing environment
See code: dist/commands/logs.ts
preevy ls
List preview environments
USAGE
$ preevy ls [-D] [-f <value>] [--system-compose-file <value>] [-p <value>] [-d lightsail|gce|azure]
[--lightsail-region us-east-2|us-east-1|us-west-2|ap-south-1|ap-northeast-2|ap-southeast-1|ap-southeast-2|ap-northea
st-1|ca-central-1|eu-central-1|eu-west-1|eu-west-2|eu-west-3|eu-north-1] [--gce-project-id <value>] [--gce-zone
<value>] [--azure-region <value>] [--azure-subscription-id <value>] [--columns <value> | -x] [--sort <value>]
[--filter <value>] [--output csv|json|yaml | | [--csv | --no-truncate]] [--no-header | ] [--json]
FLAGS
-d, --driver=<option> Machine driver to use
<options: lightsail|gce|azure>
-x, --extended show extra columns
--columns=<value> only show provided columns (comma-separated)
--csv output is csv format [alias: --output=csv]
--filter=<value> filter property by partial string matching, ex: name=foo
--no-header hide table header from output
--no-truncate do not truncate output to fit screen
--output=<option> output in a more machine friendly format
<options: csv|json|yaml>
--sort=<value> property to sort by (prepend '-' for descending)
GLOBAL FLAGS
-D, --debug Enable debug logging
-f, --file=<value>... [default: ] Compose configuration file
-p, --project=<value> Project name. Defaults to the Compose project name
--json Format output as json.
--system-compose-file=<value>... [default: ] Add extra Compose configuration file without overriding the defaults
AZURE DRIVER FLAGS
--azure-region=<value> Microsoft Azure region in which resources will be provisioned
--azure-subscription-id=<value> Microsoft Azure subscription id
GCE DRIVER FLAGS
--gce-project-id=<value> Google Cloud project ID
--gce-zone=<value> Google Cloud zone in which resources will be provisioned
LIGHTSAIL DRIVER FLAGS
--lightsail-region=<option> AWS region in which resources will be provisioned
<options: us-east-2|us-east-1|us-west-2|ap-south-1|ap-northeast-2|ap-southeast-1|ap-south
east-2|ap-northeast-1|ca-central-1|eu-central-1|eu-west-1|eu-west-2|eu-west-3|eu-north-1>
DESCRIPTION
List preview environments
See code: dist/commands/ls.ts
preevy profile create NAME URL
Create a new profile
USAGE
$ preevy profile create NAME URL [-D] [-f <value>] [--system-compose-file <value>] [-p <value>] [-d
lightsail|gce|azure] [--lightsail-region us-east-2|us-east-1|us-west-2|ap-south-1|ap-northeast-2|ap-southeast-1|ap-s
outheast-2|ap-northeast-1|ca-central-1|eu-central-1|eu-west-1|eu-west-2|eu-west-3|eu-north-1] [--gce-project-id
<value>] [--gce-zone <value>] [--azure-region <value>] [--azure-subscription-id <value>] [--json]
ARGUMENTS
NAME name of the new profile
URL url of the new profile store
FLAGS
-d, --driver=<option> Machine driver to use
<options: lightsail|gce|azure>
GLOBAL FLAGS
-D, --debug Enable debug logging
-f, --file=<value>... [default: ] Compose configuration file
-p, --project=<value> Project name. Defaults to the Compose project name
--json Format output as json.
--system-compose-file=<value>... [default: ] Add extra Compose configuration file without overriding the defaults
AZURE DRIVER FLAGS
--azure-region=<value> Microsoft Azure region in which resources will be provisioned
--azure-subscription-id=<value> Microsoft Azure subscription id
GCE DRIVER FLAGS
--gce-project-id=<value> Google Cloud project ID
--gce-zone=<value> Google Cloud zone in which resources will be provisioned
LIGHTSAIL DRIVER FLAGS
--lightsail-region=<option> AWS region in which resources will be provisioned
<options: us-east-2|us-east-1|us-west-2|ap-south-1|ap-northeast-2|ap-southeast-1|ap-south
east-2|ap-northeast-1|ca-central-1|eu-central-1|eu-west-1|eu-west-2|eu-west-3|eu-north-1>
DESCRIPTION
Create a new profile
preevy profile current
Display current profile in use
USAGE
$ preevy profile current [-D] [-f <value>] [--system-compose-file <value>] [-p <value>] [--json]
GLOBAL FLAGS
-D, --debug Enable debug logging
-f, --file=<value>... [default: ] Compose configuration file
-p, --project=<value> Project name. Defaults to the Compose project name
--json Format output as json.
--system-compose-file=<value>... [default: ] Add extra Compose configuration file without overriding the defaults
DESCRIPTION
Display current profile in use
preevy profile import LOCATION
Import an existing profile
USAGE
$ preevy profile import LOCATION [-D] [-f <value>] [--system-compose-file <value>] [-p <value>] [--name <value>]
[--json]
ARGUMENTS
LOCATION location of the profile
FLAGS
--name=<value> name of the profile
GLOBAL FLAGS
-D, --debug Enable debug logging
-f, --file=<value>... [default: ] Compose configuration file
-p, --project=<value> Project name. Defaults to the Compose project name
--json Format output as json.
--system-compose-file=<value>... [default: ] Add extra Compose configuration file without overriding the defaults
DESCRIPTION
Import an existing profile
preevy profile ls
Lists profiles
USAGE
$ preevy profile ls [-D] [-f <value>] [--system-compose-file <value>] [-p <value>] [--json]
GLOBAL FLAGS
-D, --debug Enable debug logging
-f, --file=<value>... [default: ] Compose configuration file
-p, --project=<value> Project name. Defaults to the Compose project name
--json Format output as json.
--system-compose-file=<value>... [default: ] Add extra Compose configuration file without overriding the defaults
DESCRIPTION
Lists profiles
preevy profile rm NAME
Remove a profile
USAGE
$ preevy profile rm NAME [-D] [-f <value>] [--system-compose-file <value>] [-p <value>] [--json]
ARGUMENTS
NAME name of the profile to remove
GLOBAL FLAGS
-D, --debug Enable debug logging
-f, --file=<value>... [default: ] Compose configuration file
-p, --project=<value> Project name. Defaults to the Compose project name
--json Format output as json.
--system-compose-file=<value>... [default: ] Add extra Compose configuration file without overriding the defaults
DESCRIPTION
Remove a profile
preevy profile use NAME
Set current profile
USAGE
$ preevy profile use NAME [-D] [-f <value>] [--system-compose-file <value>] [-p <value>] [--json]
ARGUMENTS
NAME name of the profile to use
GLOBAL FLAGS
-D, --debug Enable debug logging
-f, --file=<value>... [default: ] Compose configuration file
-p, --project=<value> Project name. Defaults to the Compose project name
--json Format output as json.
--system-compose-file=<value>... [default: ] Add extra Compose configuration file without overriding the defaults
DESCRIPTION
Set current profile
preevy purge
Remove all cloud provider resources
USAGE
$ preevy purge [-D] [-f <value>] [--system-compose-file <value>] [-p <value>] [-d lightsail|gce|azure]
[--lightsail-region us-east-2|us-east-1|us-west-2|ap-south-1|ap-northeast-2|ap-southeast-1|ap-southeast-2|ap-northea
st-1|ca-central-1|eu-central-1|eu-west-1|eu-west-2|eu-west-3|eu-north-1] [--gce-project-id <value>] [--gce-zone
<value>] [--azure-region <value>] [--azure-subscription-id <value>] [--snapshots] [--machines] [--key-pair] [--all]
[--force] [--wait] [--json]
FLAGS
-d, --driver=<option> Machine driver to use
<options: lightsail|gce|azure>
--all Remove machines, snapshots and key pairs
--force Do not ask for confirmation
--key-pair Remove key pair
--machines Remove machines
--snapshots Remove snapshots
--wait Wait for resource deletion to complete. If false (the default), the deletion will be started
but not waited for
GLOBAL FLAGS
-D, --debug Enable debug logging
-f, --file=<value>... [default: ] Compose configuration file
-p, --project=<value> Project name. Defaults to the Compose project name
--json Format output as json.
--system-compose-file=<value>... [default: ] Add extra Compose configuration file without overriding the defaults
AZURE DRIVER FLAGS
--azure-region=<value> Microsoft Azure region in which resources will be provisioned
--azure-subscription-id=<value> Microsoft Azure subscription id
GCE DRIVER FLAGS
--gce-project-id=<value> Google Cloud project ID
--gce-zone=<value> Google Cloud zone in which resources will be provisioned
LIGHTSAIL DRIVER FLAGS
--lightsail-region=<option> AWS region in which resources will be provisioned
<options: us-east-2|us-east-1|us-west-2|ap-south-1|ap-northeast-2|ap-southeast-1|ap-south
east-2|ap-northeast-1|ca-central-1|eu-central-1|eu-west-1|eu-west-2|eu-west-3|eu-north-1>
DESCRIPTION
Remove all cloud provider resources
See code: dist/commands/purge.ts
preevy up [SERVICE]
Bring up a preview environment
USAGE
$ preevy up [SERVICE] [-D] [-f <value>] [--system-compose-file <value>] [-p <value>] [-d
lightsail|gce|azure] [--lightsail-region us-east-2|us-east-1|us-west-2|ap-south-1|ap-northeast-2|ap-southeast-1|ap-s
outheast-2|ap-northeast-1|ca-central-1|eu-central-1|eu-west-1|eu-west-2|eu-west-3|eu-north-1] [--gce-project-id
<value>] [--gce-zone <value>] [--azure-region <value>] [--azure-subscription-id <value>]
[--lightsail-availability-zone <value>] [--lightsail-bundle-id
nano_2_0|micro_2_0|small_2_0|medium_2_0|large_2_0|xlarge_2_0|2xlarge_2_0] [--gce-machine-type <value>]
[--azure-vm-size <value>] [--azure-resource-group-name <value>] [--id <value>] [-t <value>] [--tls-hostname <value>]
[--insecure-skip-verify] [--columns <value> | -x] [--sort <value>] [--filter <value>] [--output csv|json|yaml | |
[--csv | --no-truncate]] [--no-header | ]
ARGUMENTS
SERVICE Service name(s). If not specified, will deploy all services
FLAGS
-d, --driver=<option> Machine driver to use
<options: lightsail|gce|azure>
-t, --tunnel-url=<value> [default: ssh+tls://livecycle.run] Tunnel url, specify ssh://hostname[:port] or
ssh+tls://hostname[:port]
-x, --extended show extra columns
--columns=<value> only show provided columns (comma-separated)
--csv output is csv format [alias: --output=csv]
--filter=<value> filter property by partial string matching, ex: name=foo
--id=<value> Environment id - affects created URLs. If not specified, will try to detect automatically
--insecure-skip-verify Skip TLS or SSH certificate verification
--no-header hide table header from output
--no-truncate do not truncate output to fit screen
--output=<option> output in a more machine friendly format
<options: csv|json|yaml>
--sort=<value> property to sort by (prepend '-' for descending)
--tls-hostname=<value> Override TLS server name when tunneling via HTTPS
GLOBAL FLAGS
-D, --debug Enable debug logging
-f, --file=<value>... [default: ] Compose configuration file
-p, --project=<value> Project name. Defaults to the Compose project name
--system-compose-file=<value>... [default: ] Add extra Compose configuration file without overriding the defaults
AZURE DRIVER FLAGS
--azure-region=<value> Microsoft Azure region in which resources will be provisioned
--azure-resource-group-name=<value> Microsoft Azure resource group name
--azure-subscription-id=<value> Microsoft Azure subscription id
--azure-vm-size=<value> [default: Standard_B2s] Machine type to be provisioned
GCE DRIVER FLAGS
--gce-machine-type=<value> Machine type to be provisioned
--gce-project-id=<value> Google Cloud project ID
--gce-zone=<value> Google Cloud zone in which resources will be provisioned
LIGHTSAIL DRIVER FLAGS
--lightsail-availability-zone=<value> AWS availability zone to provision resources in region
--lightsail-bundle-id=<option> Lightsail bundle ID (size of instance) to provision. Default: medium_2_0
<options:
nano_2_0|micro_2_0|small_2_0|medium_2_0|large_2_0|xlarge_2_0|2xlarge_2_0>
--lightsail-region=<option> AWS region in which resources will be provisioned
<options: us-east-2|us-east-1|us-west-2|ap-south-1|ap-northeast-2|ap-southeast-
1|ap-southeast-2|ap-northeast-1|ca-central-1|eu-central-1|eu-west-1|eu-west-2|e
u-west-3|eu-north-1>
DESCRIPTION
Bring up a preview environment
See code: dist/commands/up.ts
preevy urls [SERVICE] [PORT]
Show urls for an existing environment
USAGE
$ preevy urls [SERVICE] [PORT] [-D] [-f <value>] [--system-compose-file <value>] [-p <value>] [-d
lightsail|gce|azure] [--lightsail-region us-east-2|us-east-1|us-west-2|ap-south-1|ap-northeast-2|ap-southeast-1|ap-s
outheast-2|ap-northeast-1|ca-central-1|eu-central-1|eu-west-1|eu-west-2|eu-west-3|eu-north-1] [--gce-project-id
<value>] [--gce-zone <value>] [--azure-region <value>] [--azure-subscription-id <value>] [--id <value>] [--columns
<value> | -x] [--sort <value>] [--filter <value>] [--output csv|json|yaml | | [--csv | --no-truncate]] [--no-header
| ] [--json]
ARGUMENTS
SERVICE Service name. If not specified, will show all services
PORT Service port. If not specified, will show all ports for the specified service
FLAGS
-d, --driver=<option> Machine driver to use
<options: lightsail|gce|azure>
-x, --extended show extra columns
--columns=<value> only show provided columns (comma-separated)
--csv output is csv format [alias: --output=csv]
--filter=<value> filter property by partial string matching, ex: name=foo
--id=<value> Environment id - affects created URLs. If not specified, will try to detect automatically
--no-header hide table header from output
--no-truncate do not truncate output to fit screen
--output=<option> output in a more machine friendly format
<options: csv|json|yaml>
--sort=<value> property to sort by (prepend '-' for descending)
GLOBAL FLAGS
-D, --debug Enable debug logging
-f, --file=<value>... [default: ] Compose configuration file
-p, --project=<value> Project name. Defaults to the Compose project name
--json Format output as json.
--system-compose-file=<value>... [default: ] Add extra Compose configuration file without overriding the defaults
AZURE DRIVER FLAGS
--azure-region=<value> Microsoft Azure region in which resources will be provisioned
--azure-subscription-id=<value> Microsoft Azure subscription id
GCE DRIVER FLAGS
--gce-project-id=<value> Google Cloud project ID
--gce-zone=<value> Google Cloud zone in which resources will be provisioned
LIGHTSAIL DRIVER FLAGS
--lightsail-region=<option> AWS region in which resources will be provisioned
<options: us-east-2|us-east-1|us-west-2|ap-south-1|ap-northeast-2|ap-southeast-1|ap-south
east-2|ap-northeast-1|ca-central-1|eu-central-1|eu-west-1|eu-west-2|eu-west-3|eu-north-1>
DESCRIPTION
Show urls for an existing environment
See code: dist/commands/urls.ts
preevy version
Show Preevy version
USAGE
$ preevy version [-D] [-f <value>] [--system-compose-file <value>] [-p <value>] [--json]
GLOBAL FLAGS
-D, --debug Enable debug logging
-f, --file=<value>... [default: ] Compose configuration file
-p, --project=<value> Project name. Defaults to the Compose project name
--json Format output as json.
--system-compose-file=<value>... [default: ] Add extra Compose configuration file without overriding the defaults
DESCRIPTION
Show Preevy version
See code: dist/commands/version.ts