Follow these instructions to keep your box up-to-date.
Virtual Machine Update
A Virtual Machine Update is used for running various system maintenance tasks inside your box and updating your Cakebox Commands and Dashboard to the most current version.
Run the following command inside your box to apply the update:
cakebox update self
Local Machine Update
A Local Machine Update is used for adding new Vagrant related functionality
by updating the
cakebox repository on your local machine.
Run the following commands on your local machine to apply the update:
cd cakebox git pull vagrant reload --provision
Box Image Update
Unfortunately, Vagrant does not provide a way to update the box-image of an existing Virtual Machine which means that (optionally) upgrading to a new cakebox-image will always:
- require you to create a new/fresh cakebox Virtual Machine
- lead to losing all data and configuration inside your existing cakebox Virtual Machine
Note: updates to the cakebox box-image will be kept to an absolute minimum.
The good news is that your box was designed with this limitation in mind so you will be able to re-create an exact copy of your existing Virtual Machine with all your applications, websites, databases and software as long as you:
- have used the Cakebox.yaml file to configure your box
- manually export the MySQL databases in your existing box (will be implemented as a command)
To create a new Virtual Virtual Machine using the new box-image simply:
- git clone a fresh copy of the cakebox project
- replace the default Cakebox.yaml with your existing (rich filled) Cakebox.yaml
- make sure your local SSH agent is forwarding your Github key if you have private Git repositories in your yaml
- watch your box install and configure all the applications, databases, and websites that existed on your old box
- manually place the MySQL databases you have exported from your old box
That's all there's to it. You should now have a new box using the same SSH keys as before with all websites and databases up-and-running, exactly as they did on your old Virtual Machine.
Note: please remember that only Cakebox.yaml provisioned entities will be re-created. You will obviously still lose logfiles, temporary files and anything you've changed manually.