assembler deploy plan cli command

docs-builder assembler deploy plan \
  --environment <string> \
  --s3-bucket-name <string> \
  [options]
		

Creates an incremental synchronization plan by comparing the remote --s3-bucket-name with the local output of the build.

Remote files that are no longer in the build output are planned for deletion, with one exception: content-hashed frontend assets under _static/ (chunk-*-[hash].js, chunk-*-[hash].css, asset-*-[hash].*, and the entry bundle once it is hashed) keep their 10 newest stale versions per asset. An asset changes at most once per build, so this keeps the assets of the last 10 builds reachable for pages that are still open in a browser or served from a cache. The kept keys are listed under retain in the plan.

--environment string required

Named deployment target.

--s3-bucket-name string required

S3 bucket to deploy to.

--out string

Path to write the plan file. Defaults to stdout.

Constraints: symbolic links not allowed

--delete-threshold number

Abort if the plan would delete more than this percentage of objects (0–100).

-l --log-level enum

Minimum log level.

Values: trace, debug, information, warning, error, critical, none

Default: information

-c --config-source enum

Override the configuration source: local, remote

Values: local, remote, embedded

--skip-private-repositories

Skip cloning private repositories

-l --log-level enum

Minimum log level.

Values: trace, debug, information, warning, error, critical, none

Default: information

-c --config-source enum

Override the configuration source: local, remote

Values: local, remote, embedded

--skip-private-repositories

Skip cloning private repositories