Back to Details

application-management

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Managing Applications

应用管理

Use when:
  • Listing applications you have access to
  • Linking or unlinking a local repo to a Cloud application
  • Creating a new Drupal or Next.js project
  • Checking branch/tag deployment status
  • Waiting for an async task to complete
  • Exporting a full site archive
适用场景：
  • 列出您有权访问的应用
  • 将本地仓库与Cloud应用关联或解除关联
  • 创建新的Drupal或Next.js项目
  • 查看分支/标签部署状态
  • 等待异步任务完成
  • 导出完整站点归档文件

List Applications

列出应用

bash
acli api:applications:list
Returns a JSON array of all applications you have access to. Each entry includes 
id
, 
uuid
, 
name
, 
type
, 
status
, and 
organization
.
To display a readable table:
bash
acli api:applications:list | python3 -c "
import json, sys
apps = json.load(sys.stdin)
for a in apps:
    print(f\"{a['id']:<10} {a['name']:<40} {a.get('type',''):<10} {a.get('status',''):<10}\")
"
bash
acli api:applications:list
返回您有权访问的所有应用的JSON数组。每个条目包含
id
、
uuid
、
name
、
type
、
status
和
organization
字段。
如需显示可读性更强的表格：
bash
acli api:applications:list | python3 -c "
import json, sys
apps = json.load(sys.stdin)
for a in apps:
    print(f\"{a['id']:<10} {a['name']:<40} {a.get('type',''):<10} {a.get('status',''):<10}\")
"

Open Application in Browser

在浏览器中打开应用

bash
acli app:open
Aliases: 
acli open
, 
acli o
Opens the selected Cloud application in your default browser.
bash
acli app:open
别名：
acli open
、
acli o
在默认浏览器中打开所选的Cloud应用。

Link and Unlink a Local Repository

关联与解除本地仓库

Associate your local checkout with a Cloud application so commands like 
env:deploy
can detect the app automatically:
bash
cd /path/to/project
acli app:link
To remove the association:
bash
acli app:unlink
将本地代码检出目录与Cloud应用关联，以便
env:deploy
等命令能自动识别应用：
bash
cd /path/to/project
acli app:link
如需解除关联：
bash
acli app:unlink

Tail Application Logs

跟踪应用日志

Stream live logs from a Cloud environment:
bash
acli app:log:tail
Prompts for the application and environment, then tails all available log streams in real time. Useful for monitoring deployments or debugging live issues.
实时流式传输Cloud环境的日志：
bash
acli app:log:tail
提示选择应用和环境，然后实时跟踪所有可用的日志流。适用于监控部署或调试线上问题。

Check Branch and Tag Deployment Status

查看分支与标签部署状态

bash
acli app:vcs:info
Lists all branches and tags in the application's git repository along with which environment (if any) each is currently deployed to.
bash
acli app:vcs:info
列出应用Git仓库中的所有分支和标签，以及每个分支/标签当前部署到的环境（如有）。

Wait for an Async Task

等待异步任务完成

Some Cloud operations (database copies, environment mirrors) return a notification UUID. Wait for them to complete:
bash
acli app:task-wait <notification-uuid>
Useful in CI/CD pipelines to block until a task finishes before proceeding.
部分Cloud操作（如数据库复制、环境镜像）会返回通知UUID。可使用以下命令等待任务完成：
bash
acli app:task-wait <notification-uuid>
在CI/CD流水线中非常实用，可阻塞流程直到任务完成后再继续下一步。

Create a New Local Project

创建新的本地项目

Scaffold a new Drupal or Next.js project from an Acquia-recommended template:
bash
undefined
从Acquia推荐的模板搭建新的Drupal或Next.js项目：
bash
undefined

Interactive — prompts for template and directory

交互式模式 — 提示选择模板和目录

acli app:new:local
acli app:new:local

Non-interactive

非交互式模式

acli app:new:local my-project --template=acquia_drupal_recommended acli app:new:local my-project --template=acquia_drupal_cms

Alias: `acli new`

Available templates:
- `acquia_drupal_recommended` — Standard Acquia Drupal project
- `acquia_drupal_cms` — Acquia Drupal CMS project

---
acli app:new:local my-project --template=acquia_drupal_recommended acli app:new:local my-project --template=acquia_drupal_cms

别名：`acli new`

可用模板：
- `acquia_drupal_recommended` — 标准Acquia Drupal项目
- `acquia_drupal_cms` — Acquia Drupal CMS项目

---

Migrate from Drupal 7

从Drupal 7迁移

Generate a new Drupal 9+ project from an existing Drupal 7 application using Acquia Migrate Accelerate:
bash
acli app:new:from:drupal7
Options: 
--drupal7-directory
, 
--drupal7-uri
, 
--stored-analysis
, 
--recommendations
, 
--directory
Aliases: 
acli ama
, 
acli from:d7
使用Acquia Migrate Accelerate从现有Drupal 7应用生成新的Drupal 9+项目：
bash
acli app:new:from:drupal7
可选参数：
--drupal7-directory
、
--drupal7-uri
、
--stored-analysis
、
--recommendations
、
--directory
别名：
acli ama
、
acli from:d7

Export a Site Archive

导出站点归档文件

Export an application's code, files, and database as a single archive file:
bash
acli archive:export /path/to/destination/
Options:
bash
undefined
将应用的代码、文件和数据库导出为单个归档文件：
bash
acli archive:export /path/to/destination/
可选参数：
bash
undefined

Exclude public files

排除公共文件

acli archive:export /path/to/destination/ --no-files
acli archive:export /path/to/destination/ --no-files

Exclude database

排除数据库

acli archive:export /path/to/destination/ --no-database
acli archive:export /path/to/destination/ --no-database

Use a specific source directory

使用指定的源目录

acli archive:export /path/to/destination/ --dir=/path/to/drupal

---
acli archive:export /path/to/destination/ --dir=/path/to/drupal

---

Best Practices

最佳实践

  1. Link your repo — Run 
    acli app:link
    in every project checkout so app-aware commands work without extra flags.
  2. Check VCS status before deploying — Use 
    acli app:vcs:info
    to confirm the right branch is ready.
  3. Use 
    app:task-wait
    in CI     — Ensures async Cloud operations complete before the next pipeline step runs.
  1. 关联您的仓库 — 在每个项目检出目录中运行
    acli app:link
    ，这样识别应用的命令无需额外参数即可正常工作。
  2. 部署前检查VCS状态 — 使用
    acli app:vcs:info
    确认正确的分支已准备就绪。
  3. 在CI中使用
    app:task-wait
     — 确保异步Cloud操作完成后再执行流水线的下一步。

Related Topics

相关主题

  • Environment Management — List environments, deploy, create CDEs
  • Pull & Push — Sync code, database, and files
  • Remote Access — SSH, Drush, and log tailing
  • SSH Key Management — Secure access setup
  • 环境管理 — 列出环境、部署、创建CDE
  • 拉取与推送 — 同步代码、数据库和文件
  • 远程访问 — SSH、Drush和日志跟踪
  • SSH密钥管理 — 安全访问设置