ansible / ansible.builtin / v2.4.2.0-1 / module / linode create / delete / stop / restart an instance in Linode Public Cloud | "added in version" 1.3 of ansible.builtin" Authors: Vincent Viallet (@zbal) preview | supported by communityansible.builtin.linode (v2.4.2.0-1) — module
pip
Install with pip install ansible==2.4.2.0.post1
creates / deletes a Linode Public Cloud instance and optionally waits for it to be 'running'.
# Create a server with a private IP Address - local_action: module: linode api_key: 'longStringFromLinodeApi' name: linode-test1 plan: 1 datacenter: 2 distribution: 99 password: 'superSecureRootPassword' private_ip: yes ssh_pub_key: 'ssh-rsa qwerty' swap: 768 wait: yes wait_timeout: 600 state: present
# Fully configure new server - local_action: module: linode api_key: 'longStringFromLinodeApi' name: linode-test1 plan: 4 datacenter: 2 distribution: 99 kernel_id: 138 password: 'superSecureRootPassword' private_ip: yes ssh_pub_key: 'ssh-rsa qwerty' swap: 768 wait: yes wait_timeout: 600 state: present alert_bwquota_enabled: True alert_bwquota_threshold: 80 alert_bwin_enabled: True alert_bwin_threshold: 10 alert_cpu_enabled: True alert_cpu_threshold: 210 alert_diskio_enabled: True alert_bwout_enabled: True alert_bwout_threshold: 10 alert_diskio_enabled: True alert_diskio_threshold: 10000 backupweeklyday: 1 backupwindow: 2 displaygroup: 'test' additional_disks: - {Label: 'disk1', Size: 2500, Type: 'raw'} - {Label: 'newdisk', Size: 2000} watchdog: True
# Ensure a running server (create if missing) - local_action: module: linode api_key: 'longStringFromLinodeApi' name: linode-test1 linode_id: 12345678 plan: 1 datacenter: 2 distribution: 99 password: 'superSecureRootPassword' ssh_pub_key: 'ssh-rsa qwerty' swap: 768 wait: yes wait_timeout: 600 state: present
# Delete a server - local_action: module: linode api_key: 'longStringFromLinodeApi' name: linode-test1 linode_id: 12345678 state: absent
# Stop a server - local_action: module: linode api_key: 'longStringFromLinodeApi' name: linode-test1 linode_id: 12345678 state: stopped
# Reboot a server - local_action: module: linode api_key: 'longStringFromLinodeApi' name: linode-test1 linode_id: 12345678 state: restarted
name: default: null description: - Name to give the instance (alphanumeric, dashes, underscore) - To keep sanity on the Linode Web Console, name is prepended with LinodeID_ plan: default: null description: - plan to use for the instance (Linode plan) swap: default: 512 description: - swap size in MB wait: choices: - 'yes' - 'no' default: 'no' description: - wait for the instance to be in state 'running' before returning state: choices: - present - active - started - absent - deleted - stopped - restarted default: present description: - Indicate desired state of the resource api_key: default: null description: - Linode API key password: default: null description: - root password to apply to a new server (auto generated if missing) watchdog: choices: - 'True' - 'False' default: 'True' description: - Set status of Lassie watchdog. version_added: '2.2' version_added_collection: ansible.builtin kernel_id: default: null description: - kernel to use for the instance (Linode Kernel) version_added: '2.4' version_added_collection: ansible.builtin linode_id: aliases: - lid default: null description: - Unique ID of a linode server datacenter: default: null description: - datacenter to create an instance in (Linode Datacenter) private_ip: choices: - 'yes' - 'no' default: 'no' description: - Add private IPv4 address when Linode is created. version_added: '2.3' version_added_collection: ansible.builtin ssh_pub_key: default: null description: - SSH public key applied to root user displaygroup: default: null description: - Add the instance to a Display Group in Linode Manager version_added: '2.3' version_added_collection: ansible.builtin distribution: default: null description: - distribution to use for the instance (Linode Distribution) payment_term: choices: - 1 - 12 - 24 default: 1 description: - payment term to use for the instance (payment term in months) wait_timeout: default: 300 description: - how long before wait gives up, in seconds backupweeklyday: default: null description: - Integer value for what day of the week to store weekly backups. version_added: '2.3' version_added_collection: ansible.builtin additional_disks: default: null description: 'List of dictionaries for creating additional disks that are added to the Linode configuration settings. Dictionary takes Size, Label, Type. Size is in MB. ' version_added: '2.3' version_added_collection: ansible.builtin alert_cpu_enabled: choices: - 'True' - 'False' default: null description: - Set status of receiving CPU usage alerts. version_added: '2.3' version_added_collection: ansible.builtin alert_bwin_enabled: choices: - 'True' - 'False' default: null description: - Set status of bandwidth in alerts. version_added: '2.3' version_added_collection: ansible.builtin alert_bwout_enabled: choices: - 'True' - 'False' default: null description: - Set status of bandwidth out alerts. version_added: '2.3' version_added_collection: ansible.builtin alert_cpu_threshold: default: null description: - Set percentage threshold for receiving CPU usage alerts. Each CPU core adds 100% to total. version_added: '2.3' version_added_collection: ansible.builtin alert_bwin_threshold: default: null description: - Set threshold in MB of bandwidth in alerts. version_added: '2.3' version_added_collection: ansible.builtin alert_diskio_enabled: choices: - 'True' - 'False' default: null description: - Set status of receiving disk IO alerts. version_added: '2.3' version_added_collection: ansible.builtin alert_bwout_threshold: default: null description: - Set threshold in MB of bandwidth out alerts. version_added: '2.3' version_added_collection: ansible.builtin alert_bwquota_enabled: choices: - 'True' - 'False' default: null description: - Set status of bandwidth quota alerts as percentage of network transfer quota. version_added: '2.3' version_added_collection: ansible.builtin alert_diskio_threshold: default: null description: - Set threshold for average IO ops/sec over 2 hour period. version_added: '2.3' version_added_collection: ansible.builtin alert_bwquota_threshold: default: null description: - Set threshold in MB of bandwidth quota alerts. version_added: '2.3' version_added_collection: ansible.builtin