Deploy YAML Configs with Reis (Flag Mode)

Create and manage YAML configs directly from the command line using Reis flag-mode commands.

Create a YAML config

reis yaml_config:create \
  --name "App Config" \
  --handle app-config \
  --content_file ./configs/app.yaml

The content file must contain valid YAML. The handle must be DNS-1123 compliant (lowercase alphanumeric and hyphens, max 63 characters).

List YAML configs

reis yaml_config:list

Shows a table with handle, name, and creation date for each config.

Show details

reis yaml_config:show <config-id>

Displays metadata and the full YAML content.

Rotate content

reis yaml_config:rotate <config-id> \
  --content_file ./configs/app-v2.yaml

Creates a new version and marks it current. The previous version is retained for rollback.

List versions

reis yaml_config:versions <config-id>

Activate a previous version (rollback)

reis yaml_config:activate_version <config-id> <version-number>

Delete a YAML config

reis yaml_config:delete <config-id>

Add --force to skip the confirmation prompt. Deleting removes all versions, project attachments, and container wiring.

Attach to a project

reis project:attach <project-id> yaml_configs app-config

Singular alias yaml_config is also accepted. The project-id is the UUID Reis returns from project:list or project:show.

Detach from a project

reis project:detach <project-id> yaml_configs app-config

If a running container still mounts the config, detach is rejected with a 409 naming the blocking container — tear it down (or remove its yaml_configs block) and retry.

See also

• YAML Configs with Terraform
• YAML Configs with Reis (YAML Mode)