mcpField
C
codestudio

codestudio

github.com/acquia云与 DevOps10111 次安装今天更新
代码仓库

关于 codestudio

codestudio 用于在 ACE 订阅中设置 Acquia Code Studio 项目，涵盖项目配置和 PHP 构建版本调整。它专注于设置；触发构建、查看状态和日志需使用 pipelines-cli。

主要功能

  1. 01引导式 Code Studio 项目设置
  2. 02连接 GitLab 项目
  3. 03配置 CI/CD 变量
  4. 04调整 PHP 构建版本
  5. 05迁移流水线配置的指导

适用场景

  1. 01将应用接入 Code Studio
  2. 02更新构建所用的 PHP 版本
  3. 03从 acquia-pipelines.yml 迁移到 .gitlab-ci.yml

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/acquia/acquia-skills --skill codestudio

安装后在 Claude Code 中输入/codestudio确认已加载。

详细介绍

使用 Acquia CLI 的 Code Studio

平台： 此技能仅适用于 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 是 Acquia 基于 GitLab 的 CI/CD 平台。它会为 Cloud Platform 应用程序运行构建流水线、自动化测试和部署。

设置 Code Studio（向导）

该向导会为你的应用程序创建并配置 Code Studio 项目：

acli codestudio:wizard

别名：acli cs:wizard

该向导将：

  1. 与你的 Cloud Platform 应用程序进行身份验证
  2. 连接到你的 GitLab 实例
  3. 创建或配置 Code Studio 项目
  4. 设置 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 历史记录和进程列表中。始终从环境变量或密钥管理器中读取凭据。

选项：

选项说明
--keyCode Studio 使用的 Cloud Platform API 密钥
--secretCode Studio 使用的 Cloud Platform API 密钥
--gitlab-tokenGitLab 个人访问令牌
--gitlab-project-id要配置的 GitLab 项目的整数 ID
--gitlab-host-nameGitLab 主机名（默认为 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

# Step 1: Set up Code Studio project
acli codestudio:wizard

# Step 2: Set PHP version if needed
acli codestudio:php-version 8.2

最佳实践

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

故障排除

“找不到 GitLab 项目”

验证项目 ID，并确认令牌有权访问该项目：

# Re-run wizard interactively to select the right project
acli codestudio:wizard
身份验证错误

确保你的 Cloud API 密钥和密钥有效：

acli auth:login
acli auth:me

相关主题

评论

支持 Markdown