# Salt Cloud 0.6.0 Release Notes

The new Salt project, Salt Cloud, is introduced with version 0.6.0. Salt Cloud has been developed to ease the automation and integration of Salt with public cloud providers by allowing cloud vms to be cleanly defined, created, and automatically hooked back into a Salt Master.

While Salt Cloud is primarily made to build cloud vms to tie into a Salt Mater, it has been created in a generic way, so that it can be used to provision and hook systems of any type via the familiar Salt modules system.

This release supports three public cloud providers (all via libcloud), Amazon EC2, Rackspace Cloud and Linode.

## Documentation

The documentation for Salt Cloud can be found on Read the Docs: https://salt-cloud.readthedocs.io

## Download

Salt Cloud can be downloaded and install via pypi or github:

https://pypi.python.org/packages/source/s/salt-cloud/salt-cloud-0.6.0.tar.gz

https://cloud.github.com/downloads/saltstack/salt-cloud/salt-cloud-0.6.0.tar.gz

Packages are not yet available, Salt Cloud requires three dependencies, the salt libs, libcloud, and paramiko.

## Extensible With Cloud Modules

The Salt loader system has been employed to make adding support for additional public cloud systems just as modular and simple as adding support for new package managers in Salt.

Adding support for a new cloud provider is extremely simple, just add a cloud module and everything cleanly links together.

## Define VM Profiles

The way a vms is created is done via profiles. Profiles are used to define what properties a vm will have, the cloud provider, the size and the image.

    centos_rackspace:
      provider: rackspace
      image: CentOS 6.2
      size: 1024 server
      os: RHEL6
      minion:
        grains:
            role: webserver
        master: salt.example.com

This profile will be used to create vms on Rackspace cloud with the CentOS 6.2 image and the Rackspace 1024 vm size. Particulars of the minion config can also be specified.

Individual vms can be created from profiles:

    # salt-cloud -p centos_rackspace web1

This command creates a vms with the name web1 on the Rackspace cloud and connects the new vm to a Salt Master located at salt.example.com. The new VM has the Salt id of web1.

## Define Maps of Profiles

When it is desired to have a predefined mapping of many, or a specific group of vms then a cloud map can be defined:

    centos_rackspace:
      web1
      web2
      web3
      web4
    centos_linode:
      redis1
      riak1
      riak2
      riak3
    ubuntu_ec2:
      dev1
      dev2
      cassandra1
      cassandra2
      cassandra3

This map file will create vms named web 1-4 using the centos_rackspace profile on rackspace, the redis and riak vms on linode and the dev and Cassandra vms on ec2. It can be run with salt-cloud:

    # salt-cloud -m mapfile

When creating more than one vm the -P option can be passed, to make the vms provision in parallel, greatly speeding up large scale expansions of vms.