Pulsar Route Maps
This project is in active development and is currently available as early access.
Utilities for working with Pulsar Route Maps.
Route maps are a way to express routing policy based on the network locations of
real users. Locations are specified as IPv4 and/or IPv6 CIDR blocks (as
opposed to Geo/ASN groups) for ultimate precision. Route maps scale to millions
of network addresses so you can create groupings on a granular level
for very precise and accurate control over routing.
What can I do with this utility?
This utility streamlines CRUD operations (Create/Read/Update/Delete) for
route maps. It also does validation and linting of maps before they are
uploaded.
See our documentation for more information.
Who is using Route Maps?
Many of our customers! Dropbox wrote a blog post
about their experience using route maps to implement a global load balancing
policy.
Installation
We provide binary releases for most platforms so installation is easy. Just:
- Download the latest release here: https://github.com/ns1/pulsar-routemap/releases/latest
(older releases are available here).
- Expand the release archive which includes the
routemap(.exe)
executable.
- Run the
routemap(.exe)
command from here or copy to some location on your
Path.
Verify your new install:
$ ./routemap --version
routemap version x.y.z from <timestamp> (Git commit)
Quick start
You'll need an NS1 API key to get started. You can get or create one via NS1's
portal here: https://my.nsone.net/#/account/settings
Use your API key as an argument to all commands. For example,
$ routemap --api-key xxxxxxxxxxxxxxxxx list
You can also add your API key as an environment variable to save providing it
on the command line:
$ export NS1_APIKEY=xxxxxxxxxxxxxxxxx
# No longer need to add --api-key param
$ routemap list
For information on available commands and options try:
$ routemap help
More detail can be found in our documentation.
Contributing
Pull Requests and issues are welcome. See the NS1 Contribution Guidelines
for more information.
License
Copyright (C) 2020, NSONE, Inc.
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.