Skip to content

Reference

This page documents exact behavior. Open the reference overview

profile

Reference

profile manages explicit local value namespaces. Use it when one machine needs more than one local context for the same shared contract.

envctl profile list
envctl profile create NAME
envctl profile copy SRC DST
envctl profile remove NAME
envctl profile path [NAME]

Purpose

Profiles are local namespaces of values.

They let you switch context without duplicating fragile files or muddying the shared contract.

What these commands do

These commands manage explicit local profiles.

Available subcommands

  • envctl profile list
  • envctl profile create NAME
  • envctl profile copy SRC DST
  • envctl profile remove NAME
  • envctl profile path [NAME]

When to use it

Use profile commands when one machine needs more than one local value set for the same contract.

When not to use it

Do not use profiles as alternate contracts. Profiles change local values, not project requirements.

Notes

Named profiles must be created explicitly before use.

  • see set, fill, and check for the commands that operate on the active profile

Profiles concept

Go back to what profiles mean in the model.

Read about profiles

Profiles guide

See the practical workflow for create, copy, fill, and remove.

Open profiles guide

Profiles reference

See the exact selection and storage rules.

Open profiles reference