Create a project to group your resources together within an organization, providing a lifecycle and policy boundary for your resources.
Before you begin
To get the permissions needed to create a project, ask your Organization
IAM Admin to grant you the Project Creator role (project-creator
).
The following are used to identify your project:
Project name: A human-readable name for your project.
The project name isn't used by any GDC APIs. You can edit the project name at any time during or after project creation. Project names don't need to be unique.
Projects have the following name requirements:
- 4 to 30 characters in length.
- Contains lowercase letters, numbers, periods, or hyphens.
Project ID: A globally unique identifier for your project.
A project ID is a unique string used to differentiate your project from all others in GDC. You can only modify the project ID when you're creating the project.
Project IDs have the following requirements:
- 6 to 30 characters in length.
- Contains lowercase letters, numbers, and hyphens.
- Starts with a letter.
- Must not start with the prefix
g-
, such asg-project
. - Must not end with a hyphen.
- Must not end with the string
-cluster
or-system
. The-system
suffix is reserved for projects created by GDC. - Must not be in use or previously used; this includes deleted projects.
Project number: An automatically generated unique identifier for your project.
Don't include sensitive information in your project name, project ID, or other resource names. The project ID is used in the name of many other GDC resources, and any reference to the project or related resources exposes the project ID and resource name.
Create a new project
You can create a project to provide logical grouping of service resources. For example, you can create separate projects to hold resources for development, test, and production environments.
To get the permissions that you need to create a project, ask your Organization IAM Admin to grant you the Project Creator role. For more information on granting permissions, see Grant and revoke access.
Console
To create a new project using the GDC console, complete the following steps:
- In the navigation menu, click Projects.
- Click Add project.
- In the Project name field, enter a project name.
- Click Next.
Select the existing clusters to attach to the project. Click Next.
Optional: Configure your project's networking capabilities. Clear the Enable data exfiltration protection checkbox to disable all egress traffic to other projects inside your organization.
Click Next.
In the Review section, review the summary and click Create.
To verify the new project is available, a message is displayed in the console:
Project PROJECT_NAME successfully created
.
gdcloud
To create a new project using the gdcloud CLI, complete the following steps:
Ensure you have the gdcloud CLI installed. For more information, see the gdcloud CLI Overview page.
To create a project, run:
gdcloud projects create --name PROJECT_ID
Replace
PROJECT_ID
with the unique identifier for your new project.To verify the new project is available, run:
gdcloud projects list
API
To create a new project using the API directly, apply a custom resource to your GDC instance:
To create a new project using the kubectl
CLI, complete the following
steps:
Create and apply the
Project
custom resource:kubectl apply -f - <<EOF apiVersion: resourcemanager.gdc.goog/v1 kind: Project metadata: namespace: platform name: PROJECT_NAME EOF
Replace
PROJECT_NAME
with the name of your project.Verify the new project is available:
kubectl get namespaces