liveBook · Manning

Project

As explained in Kargo in Action

A Project is a Kargo resource that scopes delivery resources to a Kubernetes namespace and its associated access controls.

A Project is Kargo’s organizational unit for a team or service. Creating one provisions a Kubernetes namespace with the same name and configures the RBAC its controllers need. Warehouses, Stages, Freight, and Promotions for that Project live in its namespace. section 3.2.5

Projects form Kargo’s isolation boundary: separate teams can use separate Projects, namespaces, Warehouses, Stages, and RBAC. A minimal Project needs only a name; promotion policies and project-level RBAC are optional. section 3.2.5

Create and verify a Project

Apply the Project manifest, then check that both the Project resource and matching namespace exist. If the namespace is NotFound, check the Kargo controller logs. section 3.5.2

Figure 3.1 Kargo’s core resource model. A Project defines the team-or-service scope (a Kubernetes namespace plus its RBAC). Inside that scope, a Warehouse discovers artifacts and produces Freight. A Stage is a node in the promotion graph; it subscribes to Freight, owns a promotion policy, and owns the Promotion objects that record each advancement event. Every Promotion ties a specific Freight to a specific Stage, recording who advanced it and with what outcome.
Kargo core resource model

Trace how a Project scopes the resources involved in an artifact’s path through discovery and promotion. section 3.2

How Kargo in Action covers it

How deep it goes
Defines namespace and RBAC effects, notes optional governance fields, and demonstrates Project creation and namespace verification.
Examples
Uses a minimal demo Project and separate Projects, namespaces, Warehouses, Stages, and RBAC for multi-team isolation.
What it assumes
Requires a Project before creating other Kargo resources and provisions its namespace and controller RBAC at that starting point.
What you can do after
Operate/configure a Project by applying its manifest, checking the resource and namespace, and inspecting controller logs if provisioning fails.
How it connects
Groups Warehouses, Stages, Freight, and Promotions, and maps directly to a Kubernetes namespace and RBAC.

Related concepts

This explainer was generated by Manning's knowledge graph from the text of Kargo in Action. The section links point to the parts of the book it draws on.