push:artifact

Build and push a code artifact to a Cloud Platform environment

This command builds a sanitized deploy artifact by running 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. npm install), add a post-install-cmd script to your 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.

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