Uh oh!
There was an error while loading. Please reload this page.
Add acli setup: one command from nothing to a local dev environment - #2033
Open
lauriii wants to merge 11 commits into
Open
Add acli setup: one command from nothing to a local dev environment#2033lauriii wants to merge 11 commits into
lauriii wants to merge 11 commits into
Conversation
- New top-level setup command that authenticates, picks an application and environment, ensures an SSH key (files or agent), clones code, provisions ddev, imports database and files, and opens the site. Every step no-ops when already done, so re-running resumes after a failure. - Host prerequisites are only git, Docker, and ddev, with one copy-pasteable remedy per missing tool; PHP/Composer/Drush/MySQL all run inside ddev. - install.sh bootstrap installs the native acli release build (no PHP required on macOS arm64/Linux x86_64) with sha256 verification, then runs acli setup. CI now publishes .sha256 files with release assets. - PullCommandBase::pullDatabase() now returns downloaded dump paths so callers can import them through ddev. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Live end-to-end testing caught two bugs: - cloneFromCloud() ran the branch checkout before checking whether git clone succeeded, turning a failed clone into an unhelpful 'cwd does not exist' process error instead of the intended message. - ddev import-db --file stages the dump through the .ddev bind mount, which fails on some Docker providers (e.g. colima); stream the dump through stdin instead. Also recognize SSH keys that exist only in an SSH agent (e.g. the 1Password agent) when checking Cloud Platform key registration. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
A stack can come up with the site still broken (e.g. Docker providers that fail to share the project path produce a fallback nginx config that 404s everything). Warn with next steps instead of claiming success. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
The push credential for this fork lacks the workflow scope. The two-line checksum change is carried in the PR description for someone with workflow permissions to apply; install.sh already handles releases without checksums gracefully. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Colons are invalid in NTFS filenames, so the fixture broke the Windows CI job. The file is unnecessary: Filesystem::remove() is a no-op for missing paths. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Instead of silently deriving the target directory, setup now asks where to clone, prefilled with ./<sitegroup> so Enter accepts the default. --dir and non-interactive runs skip the prompt as before. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Codecov Report❌ Patch coverage is Additional details and impacted files@@ Coverage Diff @@## main #2033 +/- ##
============================================
- Coverage 92.49% 92.42% -0.07% - Complexity 1995 2083 +88
============================================
Files 123 127 +4 Lines 7238 7516 +278 ============================================
+ Hits 6695 6947 +252 - Misses 543 569 +26 ☔ View full report in Codecov by Harness. 🚀 New features to boost your workflow:
|
Contributor
Try the dev build for this PR: https://acquia-cli.s3.amazonaws.com/build/pr/2033/acli.phar |
Contributor
There was a problem hiding this comment.
Pull request overview
Adds a new top-level acli setup command that bootstraps a local Acquia application checkout into a working ddev-based dev environment, plus a small installer script and supporting plumbing so setup can clone and import reliably.
Changes:
- Introduces
setupcommand that authenticates, ensures an SSH key, clones code, configures/starts ddev, imports DB/files, and validates site responsiveness. - Adds an
install.shbootstrap flow and README “Quick start” snippet to install the latest release asset and launchacli setup. - Updates pull/clone internals to (a) return downloaded DB dump paths and (b) fail fast on clone errors before attempting checkout; adds contextual help messaging and tests.
Reviewed changes
Copilot reviewed 7 out of 7 changed files in this pull request and generated 2 comments.
Show a summary per file
| File | Description |
|---|---|
| tests/phpunit/src/Commands/App/SetupCommandTest.php | Adds PHPUnit coverage for setup flows (prereqs/auth/ssh key/clone/ddev/import/resume). |
| tests/phpunit/src/Application/KernelTest.php | Registers the new setup command in the CLI command list assertion. |
| src/EventListener/ExceptionListener.php | Adds a targeted help hint for clone failures likely caused by SSH key propagation/registration. |
| src/Command/Pull/PullCommandBase.php | Returns DB dump paths from pullDatabase() and improves clone error handling; makes clone method reusable by subclasses. |
| src/Command/App/SetupCommand.php | Implements the new end-to-end local environment bootstrap command. |
| README.md | Documents a one-command quick start via install.sh and acli setup. |
| install.sh | Adds a portable installer that downloads release assets, verifies sha256 when available, installs acli, and runs acli setup. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
Comment on lines
+89
to
+90
| say "Note: $INSTALL_DIR is not in your PATH. Add it with:" | ||
| say " echo 'export PATH=\"$INSTALL_DIR:\$PATH\"' >> ~/.$(basename "${SHELL:-bash}")rc" |
Comment on lines
+367
to
+375
| try { | ||
| $status = $this->httpClient->request('GET', $url, [ | ||
| 'http_errors' => false, | ||
| 'timeout' => 30, | ||
| 'verify' => false, | ||
| ])->getStatusCode(); | ||
| } catch (Exception) { | ||
| $status = 0; | ||
| } |
The next steps now explain that committing and pushing deploys, since the cloned branch is what the chosen environment runs. Omitted for tag-tracking environments, where a push does not deploy. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
…v:stop setup becomes dev:init, and the daily start/stop loop gets thin acli wrappers so newcomers stay in one vocabulary for the lifecycle moments. dev:start re-prints the site URL and health-checks it; dev:stop shuts the stack down. Everything else (drush, logs, ssh) intentionally stays with ddev directly. The namespace is platform-neutral so future platforms become a routing decision inside dev:init rather than a new prefix. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Instead of handing off to ssh-key:create-upload (three prompts and a required passphrase), dev:init now asks one question, generates an RSA-4096 key without a passphrase (the Cloud Platform API rejects ed25519), uploads it, and polls git access until the key is active. Users who want a passphrase-protected key are pointed at ssh-key:create-upload, which still works as before. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
The advisory published 2026-08-05 fails composer audit --locked in CI for every branch. Lockfile-only dev-dependency bump within the 3.x pin. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Copilot review: - Use a template with mktemp for BSD/POSIX portability in install.sh. - Do not report the SSH key as active when the propagation wait times out: LoopHelper invokes its done callback on watchdog timeout, so track success explicitly and fail with a resumable message instead. - Fix stale 'setup' wording in docblocks and help text. Mutation testing (--min-covered-msi=100 on changed lines): - Read the docroot from ddev's config.yaml instead of guessing docroot/ vs web/ — more correct for any custom docroot. - Exempt console output and checklist calls in infection.json5, same rationale as the existing logger exemption; annotate declarative configure() methods and untestable spots with documented reasons. - New tests: reusing a previously generated key, non-matching agent keys in non-interactive mode, per-OS prerequisite remedies, the web/ docroot file sync path, URL fallback when ddev describe emits no usable JSON, unreachable-site warning, and drush-warning absence. - Make dev:* trait helpers private. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This issue has been automatically marked as stale because it has not had recent activity. It will be closed if no further activity occurs. Please remove the |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for freeto join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
environment, ensures an SSH key (files or agent), clones code, provisions
ddev, imports database and files, and opens the site. Every step no-ops
when already done, so re-running resumes after a failure.
remedy per missing tool; PHP/Composer/Drush/MySQL all run inside ddev.
required on macOS arm64/Linux x86_64) with sha256 verification, then runs
acli setup. CI now publishes .sha256 files with release assets.
callers can import them through ddev.
Co-Authored-By: Claude Fable 5 noreply@anthropic.comMotivation
Fixes #NNN
Proposed changes
Alternatives considered
Testing steps
./bin/acli ckc