Migrate Command (zeysdk migrate)

The migrate command updates an application to the latest format, converting configuration files and updating the directory structure.

Usage

zeysdk migrate [options]

Options

Option	Description	Default
-v, --verbose	Show detailed output	false
--link	Link application after migration	false

Directory Structure Migration

The command updates the following structure:

/my-app/
├── .zeysdk/              # New SDK directory
│   ├── sync.json
│   └── sync.<instance>.json
├── resources/
├── services/
├── settings/
├── weblets/
└── zeyos.app.json       # Updated manifest

Migration Steps

1. Configuration Files

   • Converts .zeysdk.assets.json to zeyos.app.json
   • Merges .zeysdk.package.json into zeyos.app.json
   • Updates sync file format

2. Directory Structure

   • Creates .zeysdk directory
   • Moves sync files to new location
   • Maintains existing assets

3. Instance Configuration

   • Migrates instance settings
   • Updates sync state tracking
   • Preserves authentication tokens

4. Asset Migration

   • Updates resource definitions
   • Converts service configurations
   • Migrates weblet settings

Validation

Pre-migration Checks

• Verifies application directory
• Validates existing configuration
• Checks file permissions

Post-migration Validation

• Verifies file structure
• Validates configuration format
• Checks instance connectivity

Error Handling

Error	Description	Resolution
Not in app directory	Command run outside app	Navigate to app directory
Invalid old structure	Missing required files	Verify app structure
Permission denied	Cannot modify files	Check file permissions
Migration conflict	Incompatible changes	Resolve conflicts manually

Examples

Basic migration:

zeysdk migrate

Verbose migration with linking:

zeysdk migrate --verbose --link

Migration with specific options:

zeysdk migrate --verbose

Notes

• Always backup your application before migration
• Migration is a one-way process
• Some manual configuration may be required
• Use --verbose for detailed progress information
• Add --link to validate and save instance connection after migration