saltstack/salt
1
0
Fork 0
mirror of https://github.com/saltstack/salt.git synced 2025-04-10 14:51:40 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 2
salt/doc/topics/cloud/index.rst
natalieswork bd10d94449 removing references to Azure from existing files
2023-05-22 16:07:26 -04:00

5.6 KiB
Raw Blame History

Salt Cloud

Configuration

Salt Cloud provides a powerful interface to interact with cloud hosts. This interface is tightly integrated with Salt, and new virtual machines are automatically connected to your Salt master after creation.

Since Salt Cloud is designed to be an automated system, most configuration is done using the following YAML configuration files:

  • /etc/salt/cloud: The main configuration file, contains global settings that apply to all cloud hosts. See Salt Cloud Configuration <salt-cloud-config>.
  • /etc/salt/cloud.providers.d/*.conf: Contains settings that configure a specific cloud host, such as credentials, region settings, and so on. Since configuration varies significantly between each cloud host, a separate file should be created for each cloud host. In Salt Cloud, a provider is synonymous with a cloud host (Amazon EC2, Google Compute Engine, Rackspace, and so on). See Provider Specifics <cloud-provider-specifics>.
  • /etc/salt/cloud.profiles.d/*.conf: Contains settings that define a specific VM type. A profile defines the systems specs and image, and any other settings that are specific to this VM type. Each specific VM type is called a profile, and multiple profiles can be defined in a profile file. Each profile references a parent provider that defines the cloud host in which the VM is created (the provider settings are in the provider configuration explained above). Based on your needs, you might define different profiles for web servers, database servers, and so on. See VM Profiles <salt-cloud-profiles>.

Configuration Inheritance

Configuration settings are inherited in order from the cloud config => providers => profile.

image

For example, if you wanted to use the same image for all virtual machines for a specific provider, the image name could be placed in the provider file. This value is inherited by all profiles that use that provider, but is overridden if a image name is defined in the profile.

Most configuration settings can be defined in any file, the main difference being how that setting is inherited.

QuickStart

The Salt Cloud Quickstart <salt-cloud-qs> walks you through defining a provider, a VM profile, and shows you how to create virtual machines using Salt Cloud.

Note that if you installed Salt via Salt Bootstrap, it may not have automatically installed salt-cloud for you. Use your distribution's package manager to install the salt-cloud package from the same repo that you used to install Salt. These repos will automatically be setup by Salt Bootstrap.

Alternatively, the -L option can be passed to the Salt Bootstrap script when installing Salt. The -L option will install salt-cloud and the required libcloud package.

Using Salt Cloud

Command Line Reference <../../ref/cli/salt-cloud> Basic <basic> Profiles <profiles> Maps <map> Actions <action> Functions <function>

Core Configuration

Installing salt cloud <install/index> Core Configuration <config>

Windows Configuration

Windows Configuration <windows>

Cloud Provider Specifics

Getting Started With Aliyun <aliyun> Getting Started With CloudStack <cloudstack> Getting Started With DigitalOcean <digitalocean> Getting Started With Dimension Data <dimensiondata> Getting Started With EC2 <aws> Getting Started With GoGrid <gogrid> Getting Started With Google Compute Engine <gce> Getting Started With HP Cloud <hpcloud> Getting Started With Joyent <joyent> Getting Started With Libvirt <libvirt> Getting Started With Linode <linode> Getting Started With LXC <lxc> Getting Started With OneAndOne <oneandone> Getting Started With OpenNebula <opennebula> Getting Started With OpenStack <openstack> Getting Started With Parallels <parallels> Getting Started With ProfitBricks <profitbricks> Getting Started With Proxmox <proxmox> Getting Started With Scaleway <scaleway> Getting Started With Saltify <saltify> Getting Started With SoftLayer <softlayer> Getting Started With Tencent Cloud <tencentcloud> Getting Started With Vagrant <vagrant> Getting Started With Vexxhost <vexxhost> Getting Started With Virtualbox <virtualbox> Getting Started With VMware <vmware> Getting Started With Xen <xen>

Miscellaneous Options

Miscellaneous <misc>

Troubleshooting Steps

Troubleshooting <troubleshooting>

Extending Salt Cloud

Adding Cloud Providers <cloud> Adding OS Support <deploy>

Using Salt Cloud from Salt

Using Salt Cloud from Salt <salt>

Feature Comparison

Features <features>

Tutorials

QuickStart <qs> Using Salt Cloud with the Event Reactor <reactor>