skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
acquia/acquia-skills125 installs

codestudio

Use when setting up a new Code Studio (GitLab CI/CD) project, changing PHP version in Code Studio builds. NOT for checking pipeline job status — use pipelines-cli-pipeline-operations for that.

How do I install this agent skill?

npx skills add https://github.com/acquia/acquia-skills --skill codestudio
view source ↗

Is this agent skill safe to install?

  • Gen Agent Trust Hubpass

    The skill provides instructions for using the Acquia CLI (acli) to set up and configure Code Studio (GitLab CI/CD) projects. It includes security best practices for handling API credentials using environment variables.

  • Socketpass

    No alerts

  • Snykpass

    Risk: LOW · No issues

What does this agent skill do?

Code Studio with Acquia CLI

Platform: This skill applies to ACE (Acquia Cloud Enterprise) subscriptions only.

Use when:

  • Setting up a new Code Studio project for a Cloud application
  • Changing the PHP version used in Code Studio builds
  • Migrating an existing acquia-pipelines.yml to a .gitlab-ci.yml file

Note: This skill covers Code Studio setup only. To trigger builds, check job status, or stream logs, use pipelines-cli (pipelines-cli-pipeline-operations).

Code Studio is Acquia's GitLab-based CI/CD platform. It runs build pipelines, automated tests, and deployments for your Cloud Platform applications.


Set Up Code Studio (Wizard)

The wizard creates and configures a Code Studio project for your application:

acli codestudio:wizard

Alias: acli cs:wizard

The wizard will:

  1. Authenticate with your Cloud Platform application
  2. Connect to your GitLab instance
  3. Create or configure a Code Studio project
  4. Set up CI/CD variables

Non-interactive (provide all credentials upfront):

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

Security: Never pass credential values directly in the command line — they appear in shell history and process listings. Always source them from environment variables or a secrets manager. If your Cloud Platform key is stored as ACQUIA_KEY/ACQUIA_SECRET, export it as ACLI_KEY/ACLI_SECRET first (export ACLI_KEY="$ACQUIA_KEY") — that's the name ACLI itself reads.

Options:

OptionDescription
--keyCloud Platform API key for Code Studio to use
--secretCloud Platform API secret for Code Studio to use
--gitlab-tokenGitLab personal access token
--gitlab-project-idInteger project ID of the GitLab project to configure
--gitlab-host-nameGitLab hostname (defaults to Acquia's instance)

Change PHP Version in Code Studio

Update the PHP version used in Code Studio build containers:

acli codestudio:php-version <version>

Example:

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

Typical Workflow: Onboard to 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

Best Practices

  1. Run the wizard first — It sets up all required CI/CD variables automatically.
  2. Use environment variables for credentials in CI — Pass --key, --secret, and --gitlab-token via environment variables (e.g., --key="$ACLI_KEY"), never as literal values. Store secrets in your CI/CD platform's secret store.
  3. Match PHP versions — Ensure codestudio:php-version matches the version in your composer.json platform requirements.

Troubleshooting

"GitLab project not found"

Verify the project ID and that your token has access:

# Re-run wizard interactively to select the right project
acli codestudio:wizard

Authentication errors

Ensure your Cloud API key/secret are valid:

acli auth:login
acli api:accounts:find

Related Topics

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/acquia/acquia-skills/codestudio">View codestudio on skillZs</a>