Preview changes with --diff¶

Preview every change before you apply it, so a restart, a removal or a deleted volume never comes as a surprise. --diff builds the same plan an apply would carry out, and changes nothing on the host.

Run the plan¶

1

cue cmd plan

1

cat hosts/web01/*.json | ssh web01 sudo syslet --diff --stdin

If the output starts with Validation errors:, the plan is refused as a whole; see Troubleshoot a failed apply.

Check downtime¶

Read the CHANGES column of the summary:

• restarted or stopped: the container goes down. If that's not what you meant, see Manage containers.
• reloaded: the container reloads its config in place, without downtime.

Services to stop: lists every unit that stops, including containers restarted because a volume, network, build or secret they use changes.

Check removals¶

• Every removed unit goes away, and under reclaimPolicy: "Delete" its podman resource with it.
• Podman volumes to delete: lists volumes whose data is lost. Stop if a volume there should keep its data, and lock it.
• skipped means a stale unit is protected and stays. If you meant to remove it, unlock it first (see Lock resources).

A plan with unexpected removed lines usually means the input is incomplete, such as a missing file or a disabled entry. Fix the input instead of applying.

Keep secrets out of logs¶

Secret changes: hides values as (secret), so the plan is safe for shared logs such as CI. To check a value locally, set SYSLET_SHOW_SECRETS=1.

For every section and status, see Plan output.