Deploy Application (zeysdk rollout)

Deploy changes to one or more instances simultaneously.

zeysdk rollout

Options

Option	Description	Default
-v, --verbose	Show detailed progress output	false
-f, --force	Continue rollout even if errors occur	false
-a, --all	Rollout to all linked instances	false

Interactive Features

1. Instance Selection

   • If no instances specified, shows interactive checkbox list
   • Currently active instance pre-selected
   • Must select at least one instance

2. Backup Prompt

   • Option to create server state backup before rollout
   • Creates timestamped ZIP archive in backups directory
   • Includes state from all target instances

Rollout Process

1. Validation

   • Verifies .zeysdk directory exists
   • Validates instance tokens
   • Checks app identifier in zeyos.app.json

2. Execution Order

   • Active instance processed first (if included)
   • Remaining instances processed sequentially
   • Automatically switches between instances
   • Returns to original instance when complete

3. Error Handling

   • Stops on first error unless --force used
   • Creates backups before changes (optional)
   • Restores original instance state if error occurs
   • Continues with valid instances if token validation fails with --force

Error Scenarios

Error	Description	Resolution
No instances	No valid target instances found	Specify instances or use --all
Token invalid	Instance authentication failed	Check instance credentials
Backup failed	Unable to create backup	Verify write permissions
Rollout failed	Error during deployment	Check error message or use --force
Switch failed	Unable to change instance	Manually switch using use command