Folders for grouping projects in GCP - Commands & Configuration

Introduction

When you have many projects in Google Cloud, it can get messy to manage them all. Folders help you group projects together so you can organize and control them easily.

When you want to organize projects by department like sales, marketing, or engineering.

When you need to apply the same access rules to multiple projects at once.

When you want to see billing or usage grouped by teams or business units.

When you want to separate projects for different environments like development, testing, and production.

When you want to keep related projects together for easier management and reporting.

Commands

This command creates a folder named Engineering under your organization with ID 123456789012. Folders help group projects.

Terminal

gcloud resource-manager folders create --display-name="Engineering" --organization=123456789012

Expected Output

createTime: '2024-06-01T12:00:00.000Z'

displayName: Engineering

name: folders/987654321

parent: organizations/123456789012

state: ACTIVE

→

--display-name - Sets the name of the folder you want to create.

→

--organization - Specifies the organization under which the folder is created.

This command moves the project named my-project into the folder with ID 987654321 to group it under Engineering.

Terminal

gcloud projects move my-project --folder=987654321

Expected Output

Move request issued for project [my-project].

→

--folder - Specifies the folder ID where the project will be moved.

This command lists all folders under your organization so you can see your folder structure.

Terminal

gcloud resource-manager folders list --organization=123456789012

Expected Output

NAME              DISPLAY_NAME

folders/987654321 Engineering

→

--organization - Shows folders only under the specified organization.

This command lists all projects inside the Engineering folder to verify your grouping.

Terminal

gcloud projects list --filter="parent.id=987654321" --format="table(projectId, name)"

Expected Output

PROJECT_ID  NAME

my-project  My Project

→

--filter - Filters projects by their parent folder ID.

→

--format - Formats the output as a table for easy reading.

Key Concept

If you remember nothing else from this pattern, remember: folders let you organize and control multiple projects together under your Google Cloud organization.

Common Mistakes

Trying to create a folder without specifying the organization ID.

Folders must belong to an organization, so the command fails without it.

Always include the --organization flag with your organization's numeric ID when creating folders.

Moving a project to a folder using the folder name instead of the folder ID.

The move command requires the folder's numeric ID, not its display name.

Use the folder ID (like 987654321) with the --folder flag when moving projects.

Not verifying the folder or project move by listing folders or projects afterward.

You might think the operation succeeded but it could have failed silently or with a warning.

Always run list commands to confirm your folders and projects are organized as expected.

Summary

Create folders under your organization to group related projects.

Move projects into folders using their folder IDs to organize them.

List folders and projects to verify your cloud resource structure.