The Ansible Linode Collection contains various plugins for managing Linode services.
This collection has been tested against following Ansible versions: >=2.9.10.
Plugins and modules within a collection may be tested with only specific Ansible versions. A collection may contain metadata that identifies these versions. PEP440 is the schema used to describe the versions of Ansible.
Modules for managing Linode infrastructure.
| Name | Description |
|---|---|
| linode.cloud.domain | Manage Linode Domains. |
| linode.cloud.domain_record | Manage Linode Domain Records. |
| linode.cloud.firewall | Manage Linode Firewalls. |
| linode.cloud.firewall_device | Manage Linode Firewall Devices. |
| linode.cloud.image | Manage a Linode Image. |
| linode.cloud.instance | Manage Linode Instances, Configs, and Disks. |
| linode.cloud.lke_cluster | Manage Linode LKE clusters. |
| linode.cloud.lke_node_pool | Manage Linode LKE cluster node pools. |
| linode.cloud.nodebalancer | Manage a Linode NodeBalancer. |
| linode.cloud.nodebalancer_node | Manage Linode NodeBalancer Nodes. |
| linode.cloud.object_keys | Manage Linode Object Storage Keys. |
| linode.cloud.stackscript | Manage a Linode StackScript. |
| linode.cloud.token | Manage a Linode Token. |
| linode.cloud.user | Manage a Linode User. |
| linode.cloud.volume | Manage a Linode Volume. |
Modules for retrieving information about existing Linode infrastructure.
| Name | Description |
|---|---|
| linode.cloud.account_info | Get info about a Linode Account. |
| linode.cloud.domain_info | Get info about a Linode Domain. |
| linode.cloud.domain_record_info | Get info about a Linode Domain Record. |
| linode.cloud.firewall_info | Get info about a Linode Firewall. |
| linode.cloud.image_info | Get info about a Linode Image. |
| linode.cloud.instance_info | Get info about a Linode Instance. |
| linode.cloud.lke_cluster_info | Get info about a Linode LKE cluster. |
| linode.cloud.nodebalancer_info | Get info about a Linode NodeBalancer. |
| linode.cloud.object_cluster_info | Get info about a Linode Object Storage Cluster. |
| linode.cloud.profile_info | Get info about a Linode Profile. |
| linode.cloud.user_info | Get info about a Linode User. |
| linode.cloud.vlan_info | Get info about a Linode VLAN. |
| linode.cloud.volume_info | Get info about a Linode Volume. |
Modules for retrieving and filtering on multiple Linode resources.
| Name | Description |
|---|---|
| linode.cloud.event_list | List and filter on Linode events. |
Dynamically add Linode infrastructure to an Ansible inventory.
| Name |
|---|
| linode.cloud.instance |
You can install the Linode collection with the Ansible Galaxy CLI:
ansible-galaxy collection install linode.cloudThe python module dependencies are not installed by ansible-galaxy. They can
be manually installed using pip:
pip install -r requirements.txtOnce the Linode Ansible collection is installed, it can be referenced by its Fully Qualified Collection Namespace (FQCN): linode.cloud.module_name.
In order to use this collection, the LINODE_API_TOKEN environment variable must be set to a valid Linode API v4 token.
Alternatively, you can pass your Linode API v4 token into the api_token option for each Linode module you reference.
---
- name: create linode instance
hosts: localhost
tasks:
- name: Create a Linode instance
linode.cloud.instance:
label: my-linode
type: g6-nanode-1
region: us-east
image: linode/ubuntu20.04
root_pass: verysecurepassword!!!
state: presentFor more information on Ansible collection usage, see Ansible's official usage guide.
Use-case examples for this collection can be found here.
GNU General Public License v3.0.
See COPYING to see the full text.