Create a project

This guide shows you how to create a project using the evroc CLI.

Prerequisites

Before creating a project, you need:

  • The evroc CLI installed and configured. See Install the evroc CLI
  • Admin permissions in your organization

Create a project

Create a project with a unique identifier and optional display name:

evroc iam project create my-project --name "My Project"

CLI parameters

  • <project_id> - (Required) Unique identifier for the project. Must be lowercase alphanumeric with hyphens, starting and ending with an alphanumeric character. Maximum 63 characters.
  • --name - (Optional) Human-readable display name. Defaults to the project ID if not specified.

Examples

Create a project for development:

evroc iam project create dev --name "Development"

Create a project for a specific team:

evroc iam project create data-platform --name "Data Platform Team"

Verify the project

List your projects to confirm the new project was created:

evroc iam project list
# dev
# data-platform

Get details for a specific project:

evroc iam project get my-project

Set as current project

Set the new project as your current working project for CLI operations:

evroc config set-project my-project

All subsequent CLI commands operate on this project until you switch to another.

Update a project

Update the project's display name:

evroc iam project update my-project --name "New Project Name"

Delete a project

Delete a project when it's no longer needed:

evroc iam project delete my-project

Warning: Deleting a project removes all resources within it. This action can't be undone.

Use the --force flag to skip the confirmation prompt:

evroc iam project delete my-project --force

Next steps