0.10.0

What's new?

Environments and namespaces are here! These allow users to deploy and work with multiple WordPress applications, sharing the same environment. Please refer to our namespaces and environments guide for usage information.

We've also overhauled a lot of the existing routines in Sail CLI, making them fully client-side, so you no longer have to rely on (or share secrets with) our API service. The only remaining thing powered by the API service is the DNS management for the internal .justsailed.io subdomains.

Note: This release contains breaking changes. If you have existing Sail projects, please refer to the upgrade notes at the end of the announcement.

Changelog

• Added: Namespaces and environments to run multiple applications in the same environment. Use --namespace and --environment with init.
• Added: New pre-deploy hooks in .sail, these will run every time deploy is invoked
• Added: New sail diff command, shortcut for sail deploy --dry-run and sail download --dry-run
• Added: A new install.sh script to install and update Sail CLI
• Changed: New --skip-hooks or --no-verify options to sail deploy to skip running hooks
• Changed: Blueprints now fully client-side
• Changed: Provision and destroy are mostly client-side (API calls only to control justsailed.io DNS)
• Changed: Sizes and regions now client-side
• Changed: Domains, primary and HTTPS fully client-side, domains settings in .sail/config.json
• Changed: Provision now uses cloud-config instead of a Docker image, removed --host option from ssh commands

Migrating 0.9.x projects to 0.10.0

If you have an existing 0.9.x project, don't rush to upgrade your Sail CLI yet. If you did, don't worry, you can install any version you like using our new installer.

• Go to your existing 0.9.x project, and run sail backup to perform a full site backup
• Run sail domain list and note down the list of all domains associated with your project
• Backup any custom configs/hacks/etc. you might have made on the 0.9.x server
• Upgrade Sail CLI to 0.10.x using any of the install methods
• Create a new directory for your project and run sail init
• Copy the new wp-config.php to a safe place, this will contain new database credentials
• Restore the backup from step 1: sail restore /path/to/old/project/.backups/backup-filename.tar.gz
• After the restore is successful, run sail download to make sure your local copy in fresh
• Update wp-config.php with the database credentials you stored in a safe place
• Deploy the new wp-config.php and verify that it's working: sail wp option get home
• Add your domains to the new project sail domain add
• Set the primary domain with sail domain make-primary example.org --no-replace
• After the DNS changes have propagated, you can request new SSL certificates for the domains with sail domain make-https example.org www.example.org

After your site has been successfully migrated and is live, you can shutdown the old 0.9.x project with sail destroy.

If you need any assistance with migrating existing projects to this new release, please join the #help channel on our Slack community and we'll be happy to help you out!