From e9d647a41efbd64545119ceffbc95dfaaa08634a Mon Sep 17 00:00:00 2001 From: Zhiwei Liang Date: Mon, 20 Jul 2026 18:53:20 -0400 Subject: [PATCH] Add Linode Compute and DNS driver documentation and examples Signed-off-by: Zhiwei Liang --- docs/compute/drivers/linode.rst | 34 ++++++++++++++++ docs/dns/drivers/linode.rst | 40 +++++++++++++++++++ .../compute/linode/linode_compute_simple.py | 8 ++++ .../examples/dns/linode/instantiate_driver.py | 5 +++ 4 files changed, 87 insertions(+) create mode 100644 docs/compute/drivers/linode.rst create mode 100644 docs/dns/drivers/linode.rst create mode 100644 docs/examples/compute/linode/linode_compute_simple.py create mode 100644 docs/examples/dns/linode/instantiate_driver.py diff --git a/docs/compute/drivers/linode.rst b/docs/compute/drivers/linode.rst new file mode 100644 index 0000000000..359fa2c6d0 --- /dev/null +++ b/docs/compute/drivers/linode.rst @@ -0,0 +1,34 @@ +Linode Compute Driver Documentation +=================================== + +`Linode`_ is an American cloud hosting provider offering virtual private +servers (Linodes) in data centers around the world. + +.. figure:: /_static/images/provider_logos/linode.png + :align: center + :width: 200 + :target: https://www.linode.com/ + +How to get API Access Token +--------------------------- + +Visit https://cloud.linode.com/profile/tokens and create a Personal Access +Token. The token is used as the ``key`` argument when instantiating the driver. + +Examples +-------- + +1. Create Linode driver - how to create the Linode driver with an access token +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +.. literalinclude:: /examples/compute/linode/linode_compute_simple.py + :language: python + +API Docs +-------- + +.. autoclass:: libcloud.compute.drivers.linode.LinodeNodeDriverV4 + :members: + :inherited-members: + +.. _`Linode`: https://www.linode.com/ diff --git a/docs/dns/drivers/linode.rst b/docs/dns/drivers/linode.rst new file mode 100644 index 0000000000..e91253b16b --- /dev/null +++ b/docs/dns/drivers/linode.rst @@ -0,0 +1,40 @@ +Linode DNS Driver Documentation +=============================== + +`Linode`_ is an American cloud hosting provider that offers managed DNS for +domains through its Domains service. + +.. figure:: /_static/images/provider_logos/linode.png + :align: center + :width: 200 + :target: https://www.linode.com/ + +Driver features +--------------- + +* Manage zones (domains) and records for Linode hosted domains +* Supports the SOA, NS, MX, A, AAAA, CNAME, PTR, TXT, SRV and CAA record types + +How to get API Access Token +--------------------------- + +Visit https://cloud.linode.com/profile/tokens and create a Personal Access +Token. The token is used as the ``key`` argument when instantiating the driver. + +Examples +-------- + +Instantiating the driver +~~~~~~~~~~~~~~~~~~~~~~~~~~ + +.. literalinclude:: /examples/dns/linode/instantiate_driver.py + :language: python + +API Docs +-------- + +.. autoclass:: libcloud.dns.drivers.linode.LinodeDNSDriverV4 + :members: + :inherited-members: + +.. _`Linode`: https://www.linode.com/ diff --git a/docs/examples/compute/linode/linode_compute_simple.py b/docs/examples/compute/linode/linode_compute_simple.py new file mode 100644 index 0000000000..4c98bd3531 --- /dev/null +++ b/docs/examples/compute/linode/linode_compute_simple.py @@ -0,0 +1,8 @@ +from libcloud.compute.types import Provider +from libcloud.compute.providers import get_driver + +cls = get_driver(Provider.LINODE) +driver = cls("your access token") + +nodes = driver.list_nodes() +print(nodes) diff --git a/docs/examples/dns/linode/instantiate_driver.py b/docs/examples/dns/linode/instantiate_driver.py new file mode 100644 index 0000000000..10643b605e --- /dev/null +++ b/docs/examples/dns/linode/instantiate_driver.py @@ -0,0 +1,5 @@ +from libcloud.dns.types import Provider +from libcloud.dns.providers import get_driver + +cls = get_driver(Provider.LINODE) +driver = cls(key="your access token")