https://github.com/libdns/linode
Linode provider implementation for libdns
https://github.com/libdns/linode
Last synced: 4 months ago
JSON representation
Linode provider implementation for libdns
- Host: GitHub
- URL: https://github.com/libdns/linode
- Owner: libdns
- License: mit
- Created: 2023-01-30T16:34:01.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2024-03-12T08:48:47.000Z (about 2 years ago)
- Last Synced: 2024-04-16T00:13:11.281Z (about 2 years ago)
- Language: Go
- Homepage:
- Size: 27.3 KB
- Stars: 3
- Watchers: 3
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
Linode for [`libdns`](https://github.com/libdns/libdns)
=======================
[](https://pkg.go.dev/github.com/libdns/linode)
This package implements the [libdns interfaces](https://github.com/libdns/libdns) for Linode, allowing you to manage DNS records.
Requires a Linode API token.
This package was created for use in [HugoKlepsch/caddy-dns_linode](https://github.com/HugoKlepsch/caddy-dns_linode)
or [caddy-dns/linode](https://github.com/caddy-dns/linode).
Both are Caddy plugins for managing DNS records on Linode.
Caddy uses this package to complete DNS-01 challenges when using Linode.
It may have behaviour tailored to that use case.
# Getting a token
* Go to https://cloud.linode.com/profile/tokens (API Tokens tab)
* Click "Create a Personal Access Token"
* This library requires Read/Write in the "Domains" scope
* Copy the token. It should be kept private.
* Load it into the `APIToken` member when creating a new `linode.Provider`
# Running Integration Tests
* Requires a Linode API token
* Should be able to run without owning a domain. The test suite tries to operate
on unused domains. It follow the pattern of `libdns-test--.example`.
* Set the `LINODE_DNS_PAT` environment variable to your Personal Access Token.
* Run with this command:
```bash
go test -v -tags=integration
````