GCP Project Migration

Migrate GCP resources between projects with a migration script.

218|33|Updated Jan 7, 2026
One-click install
npx skills add https://github.com/first-fluke/fullstack-starter --skill gcp-project-migration
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: GCP Project Migration
Source: https://github.com/first-fluke/fullstack-starter/tree/main/.agents/skills/gcp-migration
Command: npx skills add https://github.com/first-fluke/fullstack-starter --skill gcp-project-migration

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires gcloud, psql, docker, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill provides a structured, repeatable process to migrate all critical resources from one GCP project to another, including databases, storage, container images, and Terraform state, reducing the risk of drift and downtime.

Core Features & Use Cases

  • Comprehensive Migration: DB (Cloud SQL) export/import, GCS bucket data migration, Cloud Run/container image relocation, and Terraform backend/state updates.
  • Environment Reproducibility: Preserves infrastructure configuration across projects to enable staging, testing, and production parity.
  • Automation Ready: Scripted steps and a reusable script to perform the migration with minimal manual intervention, suitable for CI/CD pipelines.

Quick Start

Run the migration script to move from OLD_PROJECT to NEW_PROJECT and update region specs: ./-.agent/skills/gcp-migration/scripts/migrate-gcp-project.sh --old-project OLD_PROJECT --new-project NEW_PROJECT --old-region OLD_REGION --new-region NEW_REGION

Frequently Asked Questions about GCP Project Migration

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

FAQPage Schema
How do I migrate GCP resources between projects?

To migrate GCP resources between projects, you run a shell script that automates the export, transfer, and import of Cloud SQL databases, GCS buckets, container images, and Terraform state to a new project.

What is the best way to move Cloud SQL and GCS buckets to a new GCP project?

The best way to move Cloud SQL and GCS buckets is using an automated migration script that handles database export/import and storage data relocation, minimizing manual intervention and configuration drift.

How does Terraform state migration work when changing GCP projects?

Terraform state migration works by updating the backend configuration to point to the new project, ensuring your infrastructure configuration remains synchronized and reproducible across the old and new environments.

Do I need specific permissions to automate GCP project migration?

Yes, you need proper GCP permissions and API enablement on both the old and new projects to execute the migration script, alongside local dependencies like gcloud, psql, and docker.

Can I use this migration script to relocate Cloud Run container images?

Yes, the migration script supports Cloud Run container image relocation, moving your container artifacts alongside databases and storage buckets to maintain environment parity in the new project.

Why should I use a script for GCP project migration instead of manual transfer?

Using a script for GCP project migration provides a structured, repeatable process that reduces the risk of drift and downtime, making it suitable for CI/CD pipelines and staging environment replication.