mirror of
https://github.com/valitydev/salt.git
synced 2024-11-07 08:58:59 +00:00
498a612078
Conflicts: doc/topics/cloud/linode.rst doc/topics/cloud/misc.rst doc/topics/cloud/parallels.rst doc/topics/cloud/proxmox.rst Conflicts: doc/topics/development/architecture.rst doc/topics/development/translating.rst
119 lines
3.5 KiB
ReStructuredText
119 lines
3.5 KiB
ReStructuredText
==================================
|
|
Getting Started With DigitalOcean
|
|
==================================
|
|
|
|
DigitalOcean is a public cloud provider that specializes in Linux instances.
|
|
|
|
|
|
Configuration
|
|
=============
|
|
Using Salt for DigitalOcean requires a personal_access_token, an ssh_key_file,
|
|
and at least one SSH key name in ssh_key_names, more can be added by comma-separating them.
|
|
The personal_access_token can be found in the Digital Ocean web interface,
|
|
in the "Apps & API" section. The SSH key name can be found under the "SSH Keys" section.
|
|
|
|
.. code-block:: yaml
|
|
|
|
# Note: This example is for /etc/salt/cloud.providers or any file in the
|
|
# /etc/salt/cloud.providers.d/ directory.
|
|
|
|
my-digitalocean-config:
|
|
provider: digital_ocean
|
|
personal_access_token: xxx
|
|
ssh_key_file: /path/to/ssh/key/file
|
|
ssh_key_names: my-key-name,my-key-name-2
|
|
location: New York 1
|
|
|
|
|
|
Profiles
|
|
========
|
|
|
|
Cloud Profiles
|
|
~~~~~~~~~~~~~~
|
|
Set up an initial profile at ``/etc/salt/cloud.profiles`` or in the
|
|
``/etc/salt/cloud.profiles.d/`` directory:
|
|
|
|
.. code-block:: yaml
|
|
|
|
digitalocean-ubuntu:
|
|
provider: my-digitalocean-config
|
|
image: Ubuntu 14.04 x32
|
|
size: 512MB
|
|
location: New York 1
|
|
private_networking: True
|
|
backups_enabled: True
|
|
ipv6: True
|
|
|
|
Sizes can be obtained using the ``--list-sizes`` option for the ``salt-cloud``
|
|
command:
|
|
|
|
.. code-block:: bash
|
|
|
|
# salt-cloud --list-sizes my-digitalocean-config
|
|
my-digitalocean-config:
|
|
----------
|
|
digital_ocean:
|
|
----------
|
|
512MB:
|
|
----------
|
|
cost_per_hour:
|
|
0.00744
|
|
cost_per_month:
|
|
5.0
|
|
cpu:
|
|
1
|
|
disk:
|
|
20
|
|
id:
|
|
66
|
|
memory:
|
|
512
|
|
name:
|
|
512MB
|
|
slug:
|
|
None
|
|
...SNIP...
|
|
|
|
Images can be obtained using the ``--list-images`` option for the ``salt-cloud``
|
|
command:
|
|
|
|
.. code-block:: bash
|
|
|
|
# salt-cloud --list-images my-digitalocean-config
|
|
my-digitalocean-config:
|
|
----------
|
|
digital_ocean:
|
|
----------
|
|
Arch Linux 2013.05 x64:
|
|
----------
|
|
distribution:
|
|
Arch Linux
|
|
id:
|
|
350424
|
|
name:
|
|
Arch Linux 2013.05 x64
|
|
public:
|
|
True
|
|
slug:
|
|
None
|
|
...SNIP...
|
|
|
|
.. note::
|
|
|
|
DigitalOcean's concept of ``Applications`` is nothing more than a
|
|
pre-configured instance (same as a normal Droplet). You will find examples
|
|
such ``Docker 0.7 Ubuntu 13.04 x64`` and ``Wordpress on Ubuntu 12.10``
|
|
when using the ``--list-images`` option. These names can be used just like
|
|
the rest of the standard instances when specifying an image in the cloud
|
|
profile configuration.
|
|
|
|
.. note::
|
|
|
|
If your domain's DNS is managed with DigitalOcean, you can automatically
|
|
create A-records for newly created droplets. Use ``create_dns_record: True``
|
|
in your config to enable this. Add ``delete_dns_record: True`` to also
|
|
delete records when a droplet is destroyed.
|
|
|
|
.. note::
|
|
|
|
Additional documentation is available from `DigitalOcean <https://www.digitalocean.com/community/articles/automated-provisioning-of-digitalocean-cloud-servers-with-salt-cloud-on-ubuntu-12-04>`_. |