Chains
Chains CLI reference
Details on Chains CLI
Chains is part of the Truss CLI.
push
Deploys a chain remotely.
SOURCE
: Path to a python file that contains the entrypoint chainlet.ENTRYPOINT
: Class name of the entrypoint chainlet in source file. May be omitted if a chainlet definition inSOURCE
is tagged with@chains.mark_entrypoint
.
Options:
--name
(TEXT): Name of the chain to be deployed, if not given, the entrypoint name is used.--publish / --no-publish
: Create chainlets as a published deployment.--promote / --no-promote
: Promote newly deployed chainlets into production.--environment
(TEXT): Deploy chainlets into a particular environment.--wait / --no-wait
: Wait until all chainlets are ready (or deployment failed).--watch / --no-watch
: Watches the chains source code and applies live patches. Using this option will wait for the chain to be deployed (i.e.--wait
flag is applied), before starting to watch for changes. This option requires the deployment to be a development deployment.--experimental-chainlet-names
: (TEXT): Runswatch
, but only applies patches to specified chainlets. The option is a comma-separated list of chainlet (display) names. This option can give faster dev loops, but also lead to inconsistent deployments. Use with caution and refer to docs.--dryrun
: Produces only generated files, but doesnβt deploy anything.--remote
(TEXT): Name of the remote in .trussrc to push to.--log
[humanfriendly|I|INFO|D|DEBUG]
: Customizes logging.--help
: Show this message and exit.
watch
Watches the chains source code and applies live patches to a development deployment.
The development deployment must have been deployed before running this command.
SOURCE
: Path to a python file that contains the entrypoint chainlet.
ENTRYPOINT
: Class name of the entrypoint chainlet in source file. May be
omitted if a chainlet definition in SOURCE is tagged with
@chains.mark_entrypoint
.
Options:
--name
(TEXT): Name of the chain to be deployed, if not given, the entrypoint name is used.--remote
: (TEXT): Name of the remote in .trussrc to push to.--experimental-chainlet-names
: (TEXT): Runswatch
, but only applies patches to specified chainlets. The option is a comma-separated list of chainlet (display) names. This option can give faster dev loops, but also lead to inconsistent deployments. Use with caution and refer to docs.--log [humanfriendly|W|WARNING|I|INFO|D|DEBUG]
: Customizes logging.--help
: Show this message and exit.
init
Initializes a chains project directory.
DIRECTORY
: A name of new or existing directory to create the chain in, it must be empty. If not specified, the current directory is used.
Options:
--log
[humanfriendly|I|INFO|D|DEBUG]
: Customizes logging.--help
: Show this message and exit.