Projects

Projects are the home for a project or application team of your organization. A project is a collection of one or more environments.

A project is mainly a container that holds a set of environments, and a prerequisite for any environment to be created. You decide how to allocate projects based on what makes the most sense for your organization. They may be application centric, infrastructure centric, or a combination of both, depending on what you wish to manage via the Orchestrator.

Basic example

resource.tf (view on GitHub ) :

resource "platform-orchestrator_project" "example-project" {
  id           = "backend"
  display_name = "Backend Project"
}



hctl create project my-project [email protected]

where project-config.yaml:

display_name: Backend Project

Note: the project id is part of the CLI command, e.g. humctl create my-project, and therefore not shown as part of the configuration.

Configuration

A project configuration consists of these elements:

Refer to the resource schema in the Terraform  or OpenTofu  provider documentation.

# Optional human friendly display name for the project
display_name: Backend Project

Projects and environments

A project is a container for zero or more environments, each of which is of one specific environment type.

Projects & Environments

Lifecycle

A project cannot be deleted while it still contains any environments.

Organizations

Environments