codestudio

概述

Code Studio 是 Acquia 提供的基于 GitLab 的 CI/CD 平台，用于为 Cloud Platform 应用运行构建流水线、自动化测试和部署。本技能适用于 ACE（Acquia Cloud Enterprise）订阅。

适用场景

为 Cloud 应用设置新的 Code Studio 项目
更改 Code Studio 构建中使用的 PHP 版本
将现有的 acquia-pipelines.yml 迁移为 .gitlab-ci.yml 文件

注意：本技能仅覆盖 Code Studio 的设置。如需触发构建、检查任务状态或查看日志，请使用 pipelines-cli（pipelines-cli-pipeline-operations）。

设置 Code Studio（向导）

向导会为你的应用创建并配置一个 Code Studio 项目：

acli codestudio:wizard

别名：acli cs:wizard

向导会：

与你的 Cloud Platform 应用进行认证
连接你的 GitLab 实例
创建或配置 Code Studio 项目
设置 CI/CD 变量

非交互方式（预先提供全部凭据）：

acli codestudio:wizard \
  --key="$ACQUIA_KEY" \
  --secret="$ACQUIA_SECRET" \
  --gitlab-token="$GITLAB_TOKEN" \
  --gitlab-project-id=12345 \
  --gitlab-host-name=code.acquia.com

安全提示：切勿在命令行中直接传入凭据值——它们会出现在 shell 历史记录和进程列表中。务必从环境变量或密钥管理器获取。

选项：

--key：Code Studio 使用的 Cloud Platform API 密钥
--secret：Code Studio 使用的 Cloud Platform API 密钥 secret
--gitlab-token：GitLab 个人访问令牌
--gitlab-project-id：要配置的 GitLab 项目的整数项目 ID
--gitlab-host-name：GitLab 主机名（默认为 Acquia 的实例）

更改 Code Studio 中的 PHP 版本

更新 Code Studio 构建容器使用的 PHP 版本：

acli codestudio:php-version <version>

示例：

acli codestudio:php-version 8.2
acli codestudio:php-version 8.3

典型工作流：接入 Code Studio

# 步骤 1：设置 Code Studio 项目
acli codestudio:wizard

# 步骤 2：根据需要设置 PHP 版本
acli codestudio:php-version 8.2

最佳实践

先运行向导——它会自动设置所有必需的 CI/CD 变量。
在 CI 中使用环境变量传递凭据——通过环境变量传入 --key、--secret 和 --gitlab-token（例如 --key="$ACQUIA_KEY"），切勿使用字面值。将密钥存储在 CI/CD 平台的密钥存储中。
匹配 PHP 版本——确保 codestudio:php-version 与 composer.json 平台要求中的版本一致。

故障排查

"GitLab project not found"：验证项目 ID，并确认你的令牌有权访问：

# 以交互方式重新运行向导以选择正确的项目
acli codestudio:wizard

认证错误：确保 Cloud API key/secret 有效：

acli auth:login
acli auth:me

技能介绍

概述