diff --git a/doc/topics/cloud/config.rst b/doc/topics/cloud/config.rst index cdb143eb22..9eec5d367a 100644 --- a/doc/topics/cloud/config.rst +++ b/doc/topics/cloud/config.rst @@ -186,6 +186,27 @@ minion. In your pillar file, you would use something like this: Cloud Configurations ==================== +Scaleway +-------- + +To use Salt Cloud with Scaleway, you need to get an ``access key`` and an ``API token``. ``API tokens`` are unique identifiers associated with your Scaleway account. +To retrieve your ``access key`` and ``API token``, log-in to the Scaleway control panel, open the pull-down menu on your account name and click on "My Credentials" link. + +If you do not have ``API token`` you can create one by clicking the "Create New Token" button on the right corner. + +.. code-block:: yaml + + my-scaleway-config: + access_key: 15cf404d-4560-41b1-9a0c-21c3d5c4ff1f + token: a7347ec8-5de1-4024-a5e3-24b77d1ba91d + provider: scaleway + +.. note:: + + In the cloud profile that uses this provider configuration, the syntax for the + ``provider`` required field would be ``provider: my-scaleway-config``. + + Rackspace --------- diff --git a/doc/topics/cloud/index.rst b/doc/topics/cloud/index.rst index 22234b90da..0d35efc0d1 100644 --- a/doc/topics/cloud/index.rst +++ b/doc/topics/cloud/index.rst @@ -58,6 +58,7 @@ Cloud Provider Specifics Getting Started With Parallels Getting Started With Proxmox Getting Started With Rackspace + Getting Started With Scaleway Getting Started With SoftLayer Getting Started With Vexxhost Getting Started With VMware diff --git a/doc/topics/cloud/scaleway.rst b/doc/topics/cloud/scaleway.rst new file mode 100644 index 0000000000..8318322665 --- /dev/null +++ b/doc/topics/cloud/scaleway.rst @@ -0,0 +1,95 @@ +============================= +Getting Started With Scaleway +============================= + +Scaleway is the first IaaS provider worldwide to offer an ARM based cloud. It’s the ideal platform for horizontal scaling with BareMetal SSD servers. The solution provides on demand resources: it comes with on-demand SSD storage, movable IPs , images, security group and an Object Storage solution. https://scaleway.com + +Configuration +============= +Using Salt for Scaleway, requires an ``access key`` and an ``API token``. ``API tokens`` are unique identifiers associated with your Scaleway account. +To retrieve your ``access key`` and ``API token``, log-in to the Scaleway control panel, open the pull-down menu on your account name and click on "My Credentials" link. + +If you do not have API token you can create one by clicking the "Create New Token" button on the right corner. + +.. code-block:: yaml + + # Note: This example is for /etc/salt/cloud.providers or any file in the + # /etc/salt/cloud.providers.d/ directory. + + my-scaleway-config: + access_key: 15cf404d-4560-41b1-9a0c-21c3d5c4ff1f + token: a7347ec8-5de1-4024-a5e3-24b77d1ba91d + provider: scaleway + +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 + + scalewa-ubuntu: + provider: my-scaleway-config + image: Ubuntu Trusty (14.04 LTS) + + +Images can be obtained using the ``--list-images`` option for the ``salt-cloud`` command: + +.. code-block:: bash + + #salt-cloud --list-images my-scaleway-config + my-scaleway-config: + ---------- + scaleway: + ---------- + 069fd876-eb04-44ab-a9cd-47e2fa3e5309: + ---------- + arch: + arm + creation_date: + 2015-03-12T09:35:45.764477+00:00 + default_bootscript: + {u'kernel': {u'dtb': u'', u'title': u'Pimouss 3.2.34-30-std', u'id': u'cfda4308-cd6f-4e51-9744-905fc0da370f', u'path': u'kernel/pimouss-uImage-3.2.34-30-std'}, u'title': u'3.2.34-std #30 (stable)', u'id': u'c5af0215-2516-4316-befc-5da1cfad609c', u'initrd': {u'path': u'initrd/c1-uInitrd', u'id': u'1be14b1b-e24c-48e5-b0b6-7ba452e42b92', u'title': u'C1 initrd'}, u'bootcmdargs': {u'id': u'd22c4dde-e5a4-47ad-abb9-d23b54d542ff', u'value': u'ip=dhcp boot=local root=/dev/nbd0 USE_XNBD=1 nbd.max_parts=8'}, u'organization': u'11111111-1111-4111-8111-111111111111', u'public': True} + extra_volumes: + [] + id: + 069fd876-eb04-44ab-a9cd-47e2fa3e5309 + modification_date: + 2015-04-24T12:02:16.820256+00:00 + name: + Ubuntu Vivid (15.04) + organization: + a283af0b-d13e-42e1-a43f-855ffbf281ab + public: + True + root_volume: + {u'name': u'distrib-ubuntu-vivid-2015-03-12_10:32-snapshot', u'id': u'a6d02e63-8dee-4bce-b627-b21730f35a05', u'volume_type': u'l_ssd', u'size': 50000000000L} + ... + + +Execute a query and return all information about the nodes running on configured cloud providers using the ``-Q`` option for the ``salt-cloud`` command: + +.. code-block:: bash + + # salt-cloud -F + [INFO ] salt-cloud starting + [INFO ] Starting new HTTPS connection (1): api.scaleway.com + my-scaleway-config: + ---------- + scaleway: + ---------- + salt-manager: + ---------- + creation_date: + 2015-06-03T08:17:38.818068+00:00 + hostname: + salt-manager + ... + +.. note:: + + Additional documentation about Scaleway can be found at ``_. +