agentleFS
acquiaacquia/acquia-skills-private/skills/acli/pull-push/SKILL.md

pull-push

Skill1 starsChanged 7 months agoMITView on GitHub

Use when syncing code, database, or files between local and Acquia Cloud environments, or pulling a Cloud database/files locally.

1 other project uses a version of this, 1 of them edited.

Adopted by

Most recently taken up by

The file

We split this skill into the rules it gives an agent

3 rules. About 0 are common, 2 are distinctive, and 1 is very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈2

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 1

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    If you skipped scripts during a pull, run them separately:

    line 95
  2. Distinctive:

    Verify your SSH key is set up and your account has write access to the environment:

    line 216
  3. Very specific:

    Check that composer install and any build steps complete without errors before pushing:

    line 225

≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Pull & Push with Acquia CLI

Use when:

  • Syncing your local environment with a Cloud Platform environment
  • Pulling code, database, or files from Cloud to local
  • Pushing code, database, files, or build artifacts to Cloud

Pull: Copy from Cloud to Local

Pull everything (code + database + files)

acli pull:all

Aliases: acli refresh, acli pull

Prompts you to select an environment, then copies code, database, and files to your local environment.

Options:

acli pull:all \
  --dir=/path/to/project \
  --no-code \        # skip code
  --no-databases \   # skip database
  --no-files \       # skip files
  --no-scripts       # skip post-pull scripts

Pull code only

acli pull:code

Pulls the latest code from the selected Cloud environment into your local directory.

acli pull:code --dir=/path/to/project

Pull database only

acli pull:database

Alias: acli pull:db

Imports a database backup from a Cloud environment into your local database.

Options:

acli pull:database \
  --on-demand \      # force a fresh on-demand backup (not cached)
  --no-import \      # download the backup file but don't import it
  --multiple-dbs     # download multiple databases (multisite)

Pull files only

acli pull:files

Copies Drupal public files (sites/default/files) from the Cloud environment to your local.


Run post-pull scripts manually

If you skipped scripts during a pull, run them separately:

acli pull:run-scripts
acli pull:run-scripts --dir=/path/to/project

Push: Copy from Local to Cloud

Push database

acli push:database

Alias: acli push:db

Uploads your local database to a Cloud Platform environment. Requires both a local and remote database to be configured.


Push files

acli push:files

Copies your local Drupal public files to the selected Cloud environment.


Push code (IDE only)

acli push:code

Push code from your Cloud IDE to a Cloud Platform environment. This command is only available inside a Cloud IDE or Lando environment.


Build and push a code artifact

Build your project and push the compiled artifact to a Cloud environment or custom git remote:

acli push:artifact

Common options:

# Push to a specific branch on Cloud
acli push:artifact --destination-git-branch=deploy/main

# Push to a specific tag
acli push:artifact --destination-git-tag=release-1.2.3

# Push to an external git URL (e.g. GitHub)
acli push:artifact --destination-git-urls=git@github.com:myorg/myrepo.git

# Dry run — build but don't push
acli push:artifact --no-push

# Build in a specific directory
acli push:artifact --dir=/path/to/project

# Skip sanitization step
acli push:artifact --no-sanitize

Typical Workflows

Refresh local dev environment

acli pull:all

Pull only the database (fastest for testing)

acli pull:database --on-demand

Deploy a build artifact to Cloud

acli push:artifact --destination-git-branch=tags/deploy-branch

Sync files to production (use with care)

acli push:files

Best Practices

  1. Always pull before you push — Avoid overwriting recent Cloud changes.
  2. Use --on-demand for fresh data — The default pull uses a cached backup; --on-demand forces a new one.
  3. Test artifact builds with --no-push — Verify the artifact is correct before pushing.
  4. Use --no-scripts in CI — Post-pull scripts are designed for local dev, not CI pipelines.
  5. Backup before pushing a database — A push:database overwrites the remote database.

Troubleshooting

"Local database not found"

pull:all and pull:database require a running local database. Make sure your local Drupal stack (Lando, DDEV, etc.) is running.

"Access denied" on push

Verify your SSH key is set up and your account has write access to the environment:

acli ssh-key:list
acli auth:me

Artifact push fails

Check that composer install and any build steps complete without errors before pushing:

acli push:artifact --no-push  # dry run to inspect

Related Topics

  • Application Management — Find environment IDs
  • SSH Key Management — Authentication
  • Remote Access — SSH and Drush on Cloud environments

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.