The Ansible Linode Collection contains various plugins for managing Linode services.
Ansible version compatibilityThis 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.account_settings Returns information related to your Account settings. linode.cloud.api_request Make an arbitrary Linode API request. linode.cloud.database_mysql Manage a Linode MySQL database. linode.cloud.database_mysql_v2 Create, read, and update a Linode MySQL database. linode.cloud.database_postgresql Manage a Linode PostgreSQL database. linode.cloud.database_postgresql_v2 Create, read, and update a Linode PostgreSQL database. 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.ip Allocates a new IPv4 Address on your Account. The Linode must be configured to support additional addresses - please Open a support ticket requesting additional addresses before attempting allocation. linode.cloud.ip_assign Assign IPs to Linodes in a given Region. linode.cloud.ip_rdns Manage a Linode IP address's rDNS. linode.cloud.ip_share Manage the Linode shared IPs. 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.nodebalancer_stats Get info about a Linode Node Balancer Stats. linode.cloud.object_keys Manage Linode Object Storage Keys. linode.cloud.placement_group Manage a Linode Placement Group. linode.cloud.placement_group_assign Manages a single assignment between a Linode and a Placement Group. linode.cloud.ssh_key Manage a Linode SSH key. 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. linode.cloud.vpc Create, read, and update a Linode VPC. linode.cloud.vpc_subnet Create, read, and update a Linode VPC Subnet.Modules for retrieving information about existing Linode infrastructure.
Modules for retrieving and filtering on multiple Linode resources.
Dynamically add Linode infrastructure to an Ansible inventory.
You can install the Linode collection with the Ansible Galaxy CLI:
ansible-galaxy collection install linode.cloud
The Python module dependencies are not installed by ansible-galaxy
. They can be manually installed using pip:
pip install --upgrade -r https://raw.githubusercontent.com/linode/ansible_linode/main/requirements.txt
⚠️ NOTE: Python dependencies should always be reinstalled when upgrading collection versions
Once 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.
The LINODE_UA_PREFIX
environment variable or the ua_prefix
module option can be used to specify a custom User-Agent prefix.
The LINODE_API_URL
environment variable pr the api_url
module option can be used to specify a custom API base url.
--- - 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/ubuntu22.04 root_pass: verysecurepassword!!! state: present
For more information on Ansible collection usage, see Ansible's official usage guide.
Use-case examples for this collection can be found here.
The following section outlines various information relating to the development of this collection.
To quickly and easily attach a debugger to a running module in this collection, you can use the madbg package:
madbg
in your local Python environment:madbg.set_trace(...)
at the location you would like to create a breakpoint at:import madbg; madbg.set_trace()
madbg connect
.GNU General Public License v3.0.
See COPYING to see the full text.
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4