Skip to main content
This is a preview/beta feature. Further changes are expected.
Environments and Logical Environments are the building blocks for Artifact Deployment Tracking in Chainloop. Together, they describe where your artifacts run (the infrastructure target) and at what stage of the lifecycle they are (development, staging, production, etc.).

Environments

An Environment represents a concrete infrastructure target where your software runs. This could be a Kubernetes cluster, an AWS ECS service, a bare-metal server, a serverless function, or any other deployment destination.

Managing Environments

Environments are managed via the chainloop environment command group. For example:
chainloop environment create --name my-k8s-cluster --description "Production Kubernetes cluster in us-east-1"
See the CLI Reference for all available commands (create, list, describe, update, delete).

Logical Environments

A Logical Environment represents a lifecycle stage in your delivery pipeline. While Environments define the physical or virtual infrastructure, Logical Environments define the purpose or phase of a deployment, such as development, staging, or production. When you create an organization, Chainloop automatically provides three default logical environments:
Logical EnvironmentDescription
developmentFor development and testing
stagingPre-production validation
productionLive production workloads
You can also create custom logical environments to match your organization’s delivery process (e.g., qa, performance-testing, canary).
In an upcoming release, Logical Environments will also enable running Policies scoped to specific lifecycle stages — for example, enforcing stricter compliance checks for artifacts deployed to production than to development.

Managing Logical Environments

Logical environments are managed via the chainloop logical-environment command group. For example:
chainloop logical-environment create --name canary --description "Canary release stage"
See the CLI Reference for all available commands.

Next Steps