2022-04-16 21:04:35 +03:00
|
|
|
# piglet
|
|
|
|
|
|
|
|
|
|
piglet is a [Porkbun DNS API](https://porkbun.com/api/json/v3/documentation) CLI client.
|
|
|
|
|
|
|
|
|
|
Currently piglet can:
|
|
|
|
|
|
|
|
|
|
- Create a DNS record
|
|
|
|
|
- Edit record
|
|
|
|
|
- Delete DNS record
|
|
|
|
|
- Retrieve DNS records
|
|
|
|
|
|
|
|
|
|
# Installation
|
|
|
|
|
|
|
|
|
|
Just copy `piglet` to your PATH. For example:
|
|
|
|
|
|
|
|
|
|
```sh
|
2022-12-13 01:48:38 +03:00
|
|
|
install -Dm755 piglet /usr/local/bin/piglet
|
2022-04-16 21:04:35 +03:00
|
|
|
```
|
|
|
|
|
|
|
|
|
|
Install [jq](https://stedolan.github.io/jq/) to enable pretty output.
|
|
|
|
|
|
|
|
|
|
# Getting started
|
|
|
|
|
|
|
|
|
|
For first step setup the configuration file:
|
|
|
|
|
|
|
|
|
|
```sh
|
|
|
|
|
piglet config
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
piglet creates `~/.config/piglet.conf` file with API credentials.
|
|
|
|
|
|
|
|
|
|
Retrieve DNS records:
|
|
|
|
|
|
|
|
|
|
```sh
|
|
|
|
|
piglet -d example.org retrieve
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
Create A-record on subdomain `mail`:
|
|
|
|
|
|
|
|
|
|
```sh
|
|
|
|
|
piglet -d example.org create name=mail type=a content=127.0.0.1 ttl=3600
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
Edit A-record for `example.org` (change to 127.0.0.1):
|
|
|
|
|
|
|
|
|
|
```sh
|
|
|
|
|
piglet -d example.org edit id=220755500 type=a content=127.0.0.1
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
Delete DNS record by id:
|
|
|
|
|
|
|
|
|
|
```sh
|
|
|
|
|
piglet -d example.org delete id=220755592
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
See `piglet --help` for more info.
|
