Acquia CLI 入门指南
本指南涵盖安装、认证以及首批命令的使用。
适用场景：
首次安装 acli
使用 Acquia Cloud 进行认证
学习首批 acli 命令
工具概览
Acquia Cloud 操作存在两个独立的 CLI：
工具 | 用途
acli | 通用 Cloud 管理：应用、环境、IDE、SSH 密钥、代码/数据库同步
pipelines-cli | CI/CD 流水线操作：触发构建、检查任务状态、流式日志
任何与流水线任务相关的内容使用 pipelines-cli。其他所有内容使用 acli。
ACE 与 MEO
acli 服务于两个不同的托管产品，命令前缀各自独立：
产品 | 命令前缀 | API
ACE（Acquia Cloud Enterprise）——经典单站点托管 | acli api:* | V2
MEO（Multi-site Enterprise Operations）——多站点托管 | acli api:v3:* | V3
如果你正在使用 MEO 订阅，请参阅 MEO Overview 获取完整命令集。
安装
macOS 与 Linux
选项 1：原生二进制（推荐）
原生二进制无需安装 PHP，适用于任何现代 macOS 或 Linux 系统。
下载最新版本
curl -fsSL https://github.com/acquia/cli/releases/latest/download/acli
-o /usr/local/bin/acli
使其可执行
chmod +x /usr/local/bin/acli
验证是否可用
acli --version
选项 2：PHP 归档（PHAR）
如果你偏好或已安装 PHP 8.2：
curl -fsSL https://github.com/acquia/cli/releases/latest/download/acli.phar
-o /usr/local/bin/acli.phar
chmod +x /usr/local/bin/acli.phar
使用方式：
acli.phar --version
或创建别名
alias acli='acli.phar'
使用 Homebrew（macOS）
brew tap acquia/cli brew install acli acli --version
你的第一条命令：认证
Acquia CLI 使用 OAuth 与你的 Acquia 账户进行认证。只需执行一次。
acli auth:login
该命令将：
打开浏览器
提示你授权 Acquia CLI
生成访问令牌
将其本地存储在 ~/.acquia/cloud_api/credentials.json（加密）
令牌有效期为 30 天。如果令牌过期，请再次运行 acli auth:login。
验证认证
acli auth:me
显示你的姓名、邮箱和账户信息。
你的第一条命令：列出应用
查看你有权访问的应用：
acli api:applications:list
输出：
Select a Cloud Platform application: [0] My First App (prod, staging, dev) [1] Client Project (prod, staging) [2] Development App (dev)
Shell 补全
启用 Tab 补全以加快命令输入。
Bash
eval "$(acli shell:complete bash)"
添加到 ~/.bashrc 以永久生效：
echo 'eval "$(acli shell:complete bash)"' >> ~/.bashrc source ~/.bashrc
Zsh
eval "$(acli shell:complete zsh)"
添加到 ~/.zshrc 以永久生效：
echo 'eval "$(acli shell:complete zsh)"' >> ~/.zshrc source ~/.zshrc
Fish
acli shell:complete fish | source
添加到 ~/.config/fish/config.fish：
acli shell:complete fish | source
获取帮助
命令帮助
每个命令都有内置帮助页面：
通用帮助
acli --help acli -h
特定命令的帮助
acli ide:create --help acli ide:create -h
按类别列出所有可用命令
acli list
详细输出
用于调试，显示详细输出：
-v（普通）、-vv（详细）、-vvv（非常详细）
acli ide:list -vvv acli ide:create -v
调试模式
以调试模式运行任何命令以查看幕后细节：
acli ide:create --debug
配置
配置文件位置
配置存储在：~/.acquia/
~/.acquia/ ├── cloud_api/ │ └── credentials.json # 你的 API 令牌（加密） ├── config.yaml # 设置 └── cache/ # 缓存数据
关联本地项目
在项目目录中运行 acli app:link 将其与 Cloud 应用关联。详见 Application Management。
常见首次操作步骤
步骤 1：认证
acli auth:login acli auth:me
步骤 2：设置项目
cd /path/to/project acli app:link
步骤 3：创建 IDE（或连接现有 IDE）
acli ide:create # 创建新 IDE
或
acli ide:list # 连接现有 IDE
步骤 4：设置 SSH
acli ssh-key:list # 查看你的 SSH 密钥
如果没有密钥，创建一个
acli ssh-key:create
步骤 5：尝试 Drush 命令
acli remote:drush status acli remote:drush cr # 清除缓存
故障排查
“Command not found: acli”
确保二进制文件在 PATH 中。尝试：
which acli
如果没有输出，添加到 PATH
export PATH="/usr/local/bin:$PATH" acli --version
“Error: Failed to authenticate”
你的令牌已过期或无效。尝试：
acli auth:login
“Error: Access denied”
你没有访问该应用或资源的权限。检查：
你是否使用正确的 Acquia 账户登录？
你在 Acquia Cloud UI 中是否有权限？
运行 acli auth:me 验证你使用的是正确的账户。
需要更多帮助？
更多问题请参阅 Troubleshooting Guide。
Acquia Site Factory（ACSF）认证
如果你的组织使用 Acquia Site Factory，请注册单独的凭据：
acli auth:acsf-login
选项：
acli auth:acsf-login
--username=myuser
--key=MY_API_KEY
--factory-url=https://www.myfactory.com
登出：
acli auth:acsf-logout
缓存管理
清除本地 acli 缓存（当命令行为异常时有用）：
acli self:clear-caches
别名：acli cc、acli cr
遥测
acli 默认收集匿名使用数据以帮助改进工具。如需退出：
acli self:telemetry:disable
重新启用：
acli self:telemetry:enable
交互式切换：
acli self:telemetry:toggle
别名：acli telemetry
打开产品文档
在浏览器中打开 Acquia 产品文档：
acli docs
针对特定产品：
acli docs acli acli docs cloud-ide
最佳实践
先认证——在做任何事之前运行 acli auth:login；大多数命令都需要它。
发现命令——使用 acli list 查看按主题分组的所有可用命令。
启用 Shell 补全——运行一次 acli shell:complete 即可获得命令和标志的 Tab 补全。
验证设置——运行 acli self:info 确认已认证身份和 acli 版本。
保持更新——定期运行 acli self:update 获取错误修复和新功能。
异常行为时清除缓存——如果命令返回意外结果，运行 acli self:clear-caches。
后续步骤
现在你已完成设置，可以尝试：
创建你的第一个 IDE——设置开发环境
探索应用——了解你的应用
设置 SSH 密钥——安全认证