push:artifact
Build and push a code artifact to a Cloud Platform environment
This command builds a sanitized deploy artifact by running <options=bold>composer install, removing sensitive files, and committing vendor directories.
Vendor directories and scaffold files are committed to the build artifact even if they are ignored in the source repository.
To run additional build or sanitization steps (e.g. <options=bold>npm install), add a <options=bold>post-install-cmd script to your <options=bold>composer.json file: https://getcomposer.org/doc/articles/scripts.md#command-events
This command is designed for a specific scenario in which there are two branches or repositories involved: a source branch without vendor files committed, and an artifact branch with them. If both your source and destination branches are the same, you should simply use git push instead.
Usage
acli push:artifact [--dir DIR] [--no-sanitize] [--dry-run] [--no-push] [--no-commit] [--no-clone] [-u|--destination-git-urls DESTINATION-GIT-URLS] [-b|--destination-git-branch DESTINATION-GIT-BRANCH] [-t|--destination-git-tag DESTINATION-GIT-TAG] [-s|--source-git-tag SOURCE-GIT-TAG] [--] [<environmentId>]
acli push:artifact [<environmentAlias>]
acli push:artifact myapp.dev
acli push:artifact prod:myapp.dev
acli push:artifact 12345-abcd1234-1111-2222-3333-0e02b2c3d470
acli push:artifact --destination-git-branch=main-build
acli push:artifact --source-git-tag=foo-build --destination-git-tag=1.0.0
acli push:artifact [email protected]:example.git [email protected]:example.git --destination-git-branch=main-build
Arguments
environmentId
Optional
The Cloud Platform environment ID or alias (i.e. an application and environment name optionally prefixed with the realm)
Options
--dir
Required
The directory containing the Drupal project to be pushed
--no-sanitize
Optional
Do not sanitize the build artifact
Defaults to
false--dry-run
Optional
Deprecated: Use no-push instead
Defaults to
false--no-push
Optional
Do not push changes to Acquia Cloud
Defaults to
false--no-commit
Optional
Do not commit changes. Implies no-push
Defaults to
false--no-clone
Optional
Do not clone repository. Implies no-commit and no-push
Defaults to
false--destination-git-urls | -u
Required
The URL of your git repository to which the artifact branch will be pushed. Use multiple times for multiple URLs.
Defaults to
[]--destination-git-branch | -b
Required
The destination branch to push the artifact to
--destination-git-tag | -t
Required
The destination tag to push the artifact to. Using this option requires also using the --destination-git-branch option
--source-git-tag | -s
Required
Deprecated: Use destination-git-branch instead
--help | -h
Optional
Display help for the given command. When no command is given display help for the `list` command
Defaults to
false--quiet | -q
Optional
Do not output any message
Defaults to
false--verbose | -v|-vv|-vvv
Optional
Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug
Defaults to
false--version | -V
Optional
Display this application version
Defaults to
false--ansi
Optional
Force (or disable --no-ansi) ANSI output
--no-ansi
Optional
Negate the "--ansi" option
Defaults to
false--no-interaction | -n
Optional
Do not ask any interactive question
Defaults to
false