Getting Started With Linode¶

Configuration Options¶

apikey¶

(Required) The key to use to authenticate with the Linode API.

password¶

(Required) The default password to set on new VMs. Must be 8 characters with at least one lowercase, uppercase, and numeric.

poll_interval¶

The rate of time in milliseconds to poll the Linode API for changes. Defaults to 500.

ratelimit_sleep¶

The time in seconds to wait before retrying after a ratelimit has been enforced. Defaults to 0.

Example Configuration¶

Set up the provider cloud configuration file at /etc/salt/cloud.providers or /etc/salt/cloud.providers.d/*.conf.

my-linode-provider:
    driver: linode
    apikey: f4ZsmwtB1c7f85Jdu43RgXVDFlNjuJaeIYV8QMftTqKScEB2vSosFSr...
    password: F00barbazverylongp@ssword

Configuration Options¶

image¶

(Required) The image to deploy the boot disk from. This should be an image ID (e.g. linode/ubuntu22.04); official images start with linode/.

location¶

(Required) The location of the VM. This should be a Linode region (e.g. us-east). See the list of locations and the guide to choose a location for more options.

size¶

(Required) The size of the VM. This should be a Linode instance type ID (e.g. g6-standard-2). See the list of sizes and the guide to choose a size for more options.

password (overrides provider)¶

(*Required) The default password for the VM. Must be provided at the profile or provider level.

assign_private_ip¶

New in version 2016.3.0.

(optional) Whether or not to assign a private IP to the VM. Defaults to False.

backups_enabled¶

(optional) Whether or not to enable the backup for this VM. Backup can be configured in your Linode account Defaults to False.

cloneform¶

(optional) The name of the Linode to clone from.

ssh_interface¶

New in version 2016.3.0.

(optional) The interface with which to connect over SSH. Valid options are private_ips or public_ips. Defaults to public_ips.

If specifying private_ips, the Linodes must be hosted within the same data center and have the Network Helper enabled on your entire account. The instance that is running the Salt-Cloud provisioning command must also have a private IP assigned to it.

Newer accounts created on Linode have the Network Helper setting enabled by default, account-wide. Legacy accounts do not have this setting enabled by default. To enable the Network Helper on your Linode account, please see Linode's Network Helper documentation.

ssh_pubkey¶

(optional) The public key to authorize for SSH with the VM.

swap¶

(optional) The amount of disk space to allocate for the swap partition. Defaults to 256.

Example Configuration¶

Set up a profile configuration at /etc/salt/cloud.profiles or /etc/salt/cloud.profiles.d/*.conf:

my-linode-profile:
    provider: my-linode-provider
    size: g6-standard-1
    image: linode/ubuntu22.04
    location: us-east

The my-linode-profile can be realized now with a salt command:

salt-cloud -p my-linode-profile my-linode-instance

This will create a salt minion instance named my-linode-instance in Linode. If the command was executed on the salt-master, its Salt key will automatically be signed on the master.

Once the instance has been created with a salt-minion installed, connectivity to it can be verified with Salt:

salt my-linode-instance test.version

A more advanced configuration utlizing all of the configuration options might look like:

my-linode-profile-advanced:
    provider: my-linode-provider
    size: g6-standard-1
    image: linode/ubuntu22.04
    location: us-central
    password: iamaverylongp@ssword
    assign_private_ip: true
    ssh_interface: private_ips
    ssh_pubkey: ssh-rsa AAAAB3NzaC1yc2EAAAADAQAB...
    swap_size: 512

Notable Changes¶

Move from label references to ID references. The profile configuration parameters location, size, and image have moved from accepting label based references to IDs. See the profile configuration section for more details.

The ``disk_size`` profile configuration parameter has been removed. The parameter will not be taken into account when creating new VMs while targeting APIv4. See the disk_size description under the profile configuration section for more details.

The ``boot`` function no longer requires a ``config_id``. A config can be inferred by the API instead when booting.

The ``clone`` function has renamed parameters to match convention. The old version of these parameters are no longer supported. * datacenter_id has been removed and replaced by location. * plan_id has been removed and replaced by size.

The ``get_plan_id`` function has been removed and is not supported by APIv4. IDs are now the only way of referring to a "plan" (or type/size).

Listing Sizes¶

Available sizes can be obtained by running one of:

salt-cloud --list-sizes my-linode-provider

salt-cloud -f avail_sizes my-linode-provider

This will list all Linode sizes/types which can be referenced in VM profiles.

my-linode-config:
    g6-standard-1:
        ----------
        class:
            standard
        disk:
            51200
        gpus:
            0
        id:
            g6-standard-1
        label:
            Linode 2GB
        memory:
            2048
        network_out:
            2000
        price:
            ----------
            hourly:
                0.015
            monthly:
                10.0
        successor:
            None
        transfer:
            2000
        vcpus:
            1
        addons:
            ----------
            backups:
                ----------
                price:
                    ----------
                    hourly:
                        0.004
                    monthly:
                        2.5
...SNIP...

Listing Images¶

Available images can be obtained by running one of:

salt-cloud --list-images my-linode-provider

salt-cloud -f avail_images my-linode-provider

This will list all Linode images which can be referenced in VM profiles. Official images are available under the linode namespace.

my-linode-config:
    ----------
    linode:
        ----------
        linode/ubuntu22.04:
            ----------
            created:
                2019-06-20T17:17:11
            created_by:
                linode
            deprecated:
                False
            description:
                None
            eol:
                2021-05-01T04:00:00
            expiry:
                None
            id:
                linode/ubuntu22.04
            is_public:
                True
            label:
                Alpine 3.10
            size:
                300
            type:
                manual
            vendor:
                Alpine
...SNIP...

Listing Locations¶

Available locations can be obtained by running one of:

salt-cloud --list-locations my-linode-provider

salt-cloud -f avail_locations my-linode-provider

This will list all Linode regions which can be referenced in VM profiles.

my-linode-config:
    ----------
    linode:
        ----------
        us-east:
            ----------
            capabilities:
                - Linodes
                - NodeBalancers
                - Block Storage
                - Object Storage
                - GPU Linodes
                - Kubernetes
            country:
                us
            id:
                us-east
            status:
                ok
...SNIP...