Skip to main content

Route53 domain updates for humans.

Project description

Route53 domain updates for humans.

Installation

With pip:

$ pip install roadtrip

With setuptools:

$ easy_install roadtrip

Requirements

Roadtrip requires Python 2.7 and leans heavily on the shoulders of Boto 2.25.0+.

Using

You can use roadtrip to update a round-robin A record, adding a new value if it doesn’t already exist:

$ roadtrip --type A --zone example.com --name mycluster.example.com --value 1.2.3.4 --add

There is also a compact syntax for each option:

$ roadtrip -t A -z example.com -n mycluster.example.com -v 1.2.3.4 -a

You can also remove a value from a list:

$ roadtrip --type A --zone example.com --name mycluster.example.com --value 1.2.3.4 --delete

You can also specify multiple values to be added, removed, or overwritten (which will discard all previous values):

$ roadtrip --type A --zone example.com --name mycluster.example.com --value 1.2.3.4 --value 1.2.3.5 --overwrite

You can also get help:

usage: roadtrip [-h] --type {A,AAAA,CNAME,MX,NS,PTR,SOA,SPF,SRV,TXT} --zone
                ZONE --name NAME --value VALUE [--ttl TTL]
                (--add | --delete | --overwrite) [--access-key ACCESS_KEY]
                [--secret-key SECRET_KEY] [--verbose]

Update a Route53 record, adding or removing values.

optional arguments:
  -h, --help            show this help message and exit
  --type {A,AAAA,CNAME,MX,NS,PTR,SOA,SPF,SRV,TXT}, -t {A,AAAA,CNAME,MX,NS,PTR,SOA,SPF,SRV,TXT}
                        The type of record to update.
  --zone ZONE, -z ZONE  The domain name or zone ID.
  --name NAME, -n NAME  The name to update.
  --value VALUE, -v VALUE
                        The data to add or remove. This argument can be used
                        multiple times to add or remove multiple values.
  --ttl TTL, -l TTL     Non-default TTL value.
  --add, -a             Add the value.
  --delete, -d          Remove the value.
  --overwrite, -o       Overwrite all existing values with those provided.
  --access-key ACCESS_KEY, -k ACCESS_KEY
                        Your AWS access key. Will override the
                        AWS_ACCESS_KEY_ID environment variable.
  --secret-key SECRET_KEY, -s SECRET_KEY
                        Your AWS secret key. Will override the
                        AWS_SECRET_ACCESS_KEY envionrment variable.
  --verbose, -vv        Verbose output.

You can set a non-default TTL value with --ttl and enable verbose output with --verbose.

Roadtrip will use the AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY environment variables if they are set. You can provide these values yourself or override the environment variables by providing --access-key and --secret-key.

Under the hood

Roadtrip will do its best not to add an entry that already exists or delete an entry that doesn’t. It uses UPSERT to update the values based on the values that exist when you call it.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

roadtrip-0.2.4.tar.gz (4.7 kB view details)

Uploaded Source

Built Distribution

roadtrip-0.2.4-cp27-none-macosx_10_9_x86_64.whl (6.3 kB view details)

Uploaded CPython 2.7 macOS 10.9+ x86-64

File details

Details for the file roadtrip-0.2.4.tar.gz.

File metadata

  • Download URL: roadtrip-0.2.4.tar.gz
  • Upload date:
  • Size: 4.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for roadtrip-0.2.4.tar.gz
Algorithm Hash digest
SHA256 1153f265d0f05bfad4f618e71acdcdd2a7e026b05ad913c8b65aa6a3d2cd6cff
MD5 655cc13702c08f65d43d841b19e19970
BLAKE2b-256 987d0ae95045dc54cccbbd9d66629ef95997a72534754f6c5ffd5e9b35a084be

See more details on using hashes here.

File details

Details for the file roadtrip-0.2.4-cp27-none-macosx_10_9_x86_64.whl.

File metadata

File hashes

Hashes for roadtrip-0.2.4-cp27-none-macosx_10_9_x86_64.whl
Algorithm Hash digest
SHA256 f970e250c8a8508a6af98058ee4edbe8fcccf1aaf68c7aec3357af579da6868d
MD5 8dc54949f3f7eb4ec1995a840941ea27
BLAKE2b-256 a507d099c05e833d1bbbf7d057c328f86cda247a06bd2cd4fb5c88d9783e144d

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page