codestudio について
codestudioは、ACEサブスクリプション向けにAcquia Code Studioプロジェクトを設定するスキルです。プロジェクト設定やPHPビルドバージョンの変更を扱い、ビルド実行やログ操作にはpipelines-cliを案内します。
主な機能
- 01Code Studioプロジェクトの設定ガイド
- 02GitLabプロジェクトへの接続
- 03CI/CD変数の設定
- 04PHPビルドバージョンの変更
- 05パイプライン設定の移行ガイド
活用シーン
- 01アプリケーションをCode Studioに登録
- 02ビルドで使うPHPバージョンの更新
- 03acquia-pipelines.ymlから.gitlab-ci.ymlへの移行
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、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
ウィザードでは、次の処理が行われます：
- 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
セキュリティ： 認証情報の値をコマンドラインに直接渡さないでください。シェルの履歴やプロセス一覧に表示されます。必ず環境変数またはシークレットマネージャーから読み込んでください。
オプション：
| オプション | 説明 |
|---|---|
--key | Code Studio が使用する Cloud Platform API キー |
--secret | Code Studio が使用する Cloud Platform API シークレット |
--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 へのオンボーディング
# Step 1: Set up Code Studio project
acli codestudio:wizard
# Step 2: Set PHP version if needed
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 プロジェクトが見つかりません」
プロジェクト ID と、トークンにアクセス権があることを確認してください。
# Re-run wizard interactively to select the right project
acli codestudio:wizard
認証エラー
Cloud API キー／シークレットが有効であることを確認してください。
acli auth:login
acli auth:me