application-design-center-design-deploy

Designs, validates, and deploys GCP infrastructure using Terraform and Application Design Center.

19.1k|1.5k|Updated Mar 31, 2026
One-click install
npx skills add https://github.com/google/skills --skill application-design-center-design-deploy
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: application-design-center-design-deploy
Source: https://github.com/google/skills/tree/main/skills/cloud/application-design-center-design-deploy
Command: npx skills add https://github.com/google/skills --skill application-design-center-design-deploy

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires absl-py, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Manually designing, validating, and deploying Google Cloud infrastructure is error-prone and slow, with security and best-practice issues often discovered only after deployment. This Skill provides a prescriptive end-to-end workflow that designs modular Terraform locally, scans plans against best practices before import, and manages deployment through Application Design Center (ADC).

Core Features & Use Cases

  • Local Terraform Design & Validation: Generates modular HCL from ADC catalog components and validates it with terraform init, validate, and plan in an isolated scratch directory.
  • Shifted-Left Plan Assessment: Runs ADC best-practice assessments on the exported tfplan.json and iteratively remediates security, cost, and reliability findings before import.
  • ADC Import, Deployment & Troubleshooting: Imports validated HCL as application templates, deploys them with LRO monitoring, and diagnoses failures using structured troubleshooting guides for both ADC and raw Terraform errors.
  • Use Case: Ask the agent to deploy a three-tier web application on GCP; it designs the Terraform, scans the plan for violations, imports the template into ADC, deploys it, and verifies the public endpoints.

Quick Start

Design and deploy a Cloud Run web application with a Cloud SQL database to my GCP project using Application Design Center.

Frequently Asked Questions about application-design-center-design-deploy

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I deploy GCP infrastructure with Application Design Center?

Design modular Terraform locally, validate it with terraform init, validate, and plan, then run an ADC plan assessment on the exported tfplan.json. Import the clean HCL as an application template and deploy it via the ADC manage_application tool with LRO monitoring.

How do I troubleshoot ADC application deployment failures?

Fetch the application details with gcloud design-center spaces applications describe, then retrieve the Cloud Build logs for the failed build ID. Classify the error as configuration, resource conflict, IAM, or API-disabled, and apply the matching remediation from the troubleshooting guides.

What Terraform constraints does Application Design Center enforce on import?

The ADC parser prohibits resource blocks, allowing only module, variable, output, and provider blocks. It also rejects terraform version constraint blocks and requires strict string typing, such as subnet_private_access = "true" instead of a boolean.

Can I use private catalog modules instead of public Google templates?

Yes, the workflow queries both your private ADC catalog and the public Google catalog, and private templates always take priority. Module sources must use pinned GitHub URLs with the exact refTag from the catalog revision metadata.

Why does my ADC deployment fail with a 409 already exists error?

A 409 error means a resource with the same name already exists in the target project, such as a service account created by a previous deployment. Remediate by disabling resource creation in the HCL and referencing the existing resource, or by using unique parameterized names.