salt/doc/topics/config.rst
Thomas S Hatch 15ce1ee755 Change EC2 to AWS, since in the long run
Salt Cloud will control a lot more than EC2 in the amazon cloud
2012-08-01 21:37:52 -06:00

92 lines
2.3 KiB
ReStructuredText

==================
Core Configuration
==================
A number of core configuration options and some options that are global to
the vm profiles can be set in the cloud config file. By default this file is
located at ``/etc/salt/cloud``.
Minion Configuration
====================
The default minion configuration is set up in this file. This is where the
minions that are created derive their configuration.
.. code-block:: yaml
minion:
master: saltmaster.example.com
This is the location in particular to specify the location of the salt master.
Cloud Configurations
====================
The data specific to interacting with public clouds is set up here.
Rackspace
---------
Rackspace cloud requires two configuration options:
.. code-block:: yaml
RACKSPACE.user: example_user
RACKSPACE.apikey: 123984bjjas87034
Amazon AWS
----------
A number of configuration options are required for Amazon AWS:
.. code-block:: yaml
AWS.id: HJGRYCILJLKJYG
AWSAWS.key: 'kdjgfsgm;woormgl/aserigjksjdhasdfgn'
AWSAWS.keyname: test
AWSAWS.securitygroup: quick-start
AWSAWS.private_key: /root/test.pem
Linode
------
Linode requires a single api key, but the default root password also needs
to be set:
.. code-block:: yaml
LINODE.apikey: asldkgfakl;sdfjsjaslfjaklsdjf;askldjfaaklsjdfhasldsadfghdkf
LINODE.password: F00barbaz
The password needs to be 8 characters and contain lowercase, uppercase and
numbers.
Joyent Cloud
------------
The Joyent cloud requires three configuration paramaters. The user name and
password that are used to log into the Joyent system, and the location of
the private ssh key associated with the Joyent account. The ssh key is needed
to send the provisioning commands up to the freshly created virtual machine,
.. code-block:: yaml
JOYENT.user: fred
JOYENT.password: saltybacon
JOYENT.private_key: /root/joyent.pem
GoGrid
------
To use Salt Cloud with GoGrid log into the GoGrid web interface and
create an api key. Do this by clicking on "My Account" and then going to the
API Keys tab.
The GOGRID.apikey and the GOGRID.sharedsecret configuration paramaters need to
be set in the config file to enable interfacing with GoGrid:
.. code-block:: yaml
GOGRID.apikey: asdff7896asdh789
GOGRID.sharedsecret: saltybacon