formae apply

Apply a forma to create or update infrastructure. apply reads a forma file, sends it to the agent, and reconciles or patches your resources depending on the apply mode.

formae apply --mode <reconcile|patch> [flags] <forma file>

The --mode flag is required, and a forma file argument is required.

Examples

formae apply --mode reconcile forma.pkl
formae apply --mode patch forma.pkl
formae apply --mode reconcile --simulate forma.pkl

For human output, apply always simulates first and shows the planned changes before asking you to confirm. Use --yes to skip the confirmation, or --simulate to stop after the dry run.

Flags

Flag	Default	Description
`--mode <reconcile\|patch>`		Apply mode. This flag is required. See apply modes.
`--simulate`	`false`	Simulate the command rather than make actual changes.
`--force`	`false`	Overwrite any changes since the last reconcile without prompting. Applies in reconcile mode.
`--status-output-layout <summary\|detailed>`	`summary`	What to print as status output.
`--yes`	`false`	Run without any confirmations.
`--output-consumer <human\|machine>`	`human`	Consumer of the command result.
`--output-schema <json\|yaml>`	`json`	The schema to use for the result output.
`--config <path>`		Path to a config file.
`--profile <name>`		Named profile to use.

Property flags

Properties declared in your forma become flags on apply, so you can set them per run without editing the file. apply, destroy, and eval all support the properties declared by the forma they target. Run formae apply --help against a specific forma to see the property flags it exposes.

Get started

Guides

Concepts

Reference

Examples

Flags

Property flags

​Examples

​Flags

​Property flags

Examples

Flags

Property flags