3- Manage vmr environment
A vmr environment consist of a directory and a template file call Vagrantfile.
A vmr object contains information to create and modify an vmr environment. Once the environment created and initialized the vmr object became optional and only the working directory and the Vagrantfile are the managers.
Create a vmr environment
Create a vmr object
vmr_env <- vmrCreate(<boxname>)
vmrCreate() function create a vmr object using several arguments:
* name : the box name (from vmrList())
* provider: the provider name (from vmrList())
* version: (optional by default latest version is use)
* provider.options: specific provider options (vignette n°5)
Load a vmr object
Set the working directory to a vmr environment who was already initialized.
vmr_env <- vmrLoad()
Initialize a vmr environment
Initialize a vmr environment will create a Vagrantfile template into the working directory and download the box associated.
The box download can be long depending of the box size and network bandwide. The box is save in vagrant environment (“~/.vagrant.d/”).
vmr_env # created or loaded object
# force.vagrantfile will override existing Vagrantfile template
vmr_env <- vmrInitEnv(vmr_env, force.vagrantfile=TRUE)
Clean a vmr environment
To remove any file created, boxes downloaded and provider instance run this commands:
vmr_env <- vmrLoad()
# provider cleaning
# box cleaning
vmrLocalBoxRemove(vmr_env$box, provider = vmr_env$provider, version = vmr_env$version)
# remove the working directory
Add options to vmr environment
Several functions need and can modify a vmr object to add options to the environment.
vmrInitEnv() have to be recall at vmr object modification.
It’s possible to upgrade an environment to use the latest box version.
vmr_env <- vmrUpdateEnvVersion(vmr_env)
Manipulate a vmr environment
This functions manage the environment instance.
They have to be call in vmr environment (working directory), with no arguments.
# Get environment status
# Start a provider instance
# Save state and stop provider instance
# Resume a saved provider instance
# Stop a provider instance
# Remove a provider instance
Manage provider instance with snapshot.
# Take a snapshot
# resume a snapshot
# list snapshots