Exoscale#

This datasource supports reading from the metadata server used on the Exoscale platform. Use of the Exoscale datasource is recommended to benefit from new features of the Exoscale platform.

The datasource relies on the availability of a compatible metadata server (http://169.254.169.254 is used by default) and its companion password server, reachable at the same address (by default on port 8080).

Crawling of metadata#

The metadata service and password server are crawled slightly differently:

  • The “metadata service” is crawled every boot.

  • The password server is also crawled every boot (the Exoscale datasource forces the password module to run with “frequency always”).

In the password server case, the following rules apply in order to enable the “restore instance password” functionality:

  • If a password is returned by the password server, it is then marked “saved” by the cloud-init datasource. Subsequent boots will skip setting the password (the password server will return saved_password).

  • When the instance password is reset (via the Exoscale UI), the password server will return the non-empty password at next boot, therefore causing cloud-init to reset the instance’s password.

Configuration#

Users of this datasource are discouraged from changing the default settings unless instructed to by Exoscale support.

The following settings are available and can be set for the datasource base configuration (in /etc/cloud/cloud.cfg.d/).

The settings available are:

  • metadata_url: The URL for the metadata service.

    Defaults to http://169.254.169.254.

  • api_version: The API version path on which to query the instance metadata.

    Defaults to 1.0.

  • password_server_port: The port (on the metadata server) on which the password server listens.

    Defaults to 8080.

  • timeout: The timeout value provided to urlopen for each individual http request.

    Defaults to 10.

  • retries: The number of retries that should be done for a http request.

    Defaults to 6.

Example#

An example configuration with the default values is provided below:

datasource:
  Exoscale:
    metadata_url: "http://169.254.169.254"
    api_version: "1.0"
    password_server_port: 8080
    timeout: 10
    retries: 6