cloudping

README

cloudping

cloudping identifies the cloud provider regions geographically closest and returns them in order of lowest to highest latency.

Inspired by CloudPing.info.

Table of Contents

• Usage
• Installation
  • Binaries
  • Via Go
  • Homebrew on macOS
• Why?
• Similar projects
• Contributing

Usage

$ cloudping -h
cloudping identifies the cloud provider regions geographically closest
and returns them in order of lowest to highest latency.

Usage:
  cloudping [flags]
  cloudping [command]

Available Commands:
  help        Help about any command
  version     Print the version number of cloudping

Flags:
  -h, --help              help for cloudping
      --limit int         Limits the number of regions returned
      --output string     Output format. One of: txt, json, yaml (default "txt")
      --provider string   Cloud provider (default "aws")
      --regions strings   Limits checks to specific regions
      --timeout int       Timeout for each region in milliseconds (default 500)

Use "cloudping [command] --help" for more information about a command.

The following example checks and returns only 2 regions:

$ cloudping --provider=aws --regions=ap-southeast-2,us-east-1
ap-southeast-2
us-east-1

Installation

Here are a few methods to install cloudping.

Binaries

$ curl -sSL https://raw.githubusercontent.com/estahn/cloudping/master/godownloader.sh | sh

Via Go

$ go get github.com/estahn/cloudping

Homebrew on macOS

If you are on macOS and using Homebrew package manager, you can install cloudping with Homebrew.

1. Run the installation command:

   $ brew install estahn/tap/cloudping
   

2. Test to ensure the version you installed is sufficiently up-to-date:

   $ cloudping version
   

Why?

The idea came from the need to download images from the geographically closest docker registry. We operate our Kubernetes cluster in Sydney/Australia but use CircleCI operating in the US. Because AWS ECR doesn't provide a common endpoint with geographically distributed backend we push our images to both locations. Within our Makefile we can use cloudping to identify if images should be pulled from the US or Sydney.

Similar projects

• CloudPing.info
• AWS Inter-Region Latency Monitoring
• GCP ping

Contributing

Contributions are greatly appreciated. The maintainers actively manage the issues list, and try to highlight issues suitable for newcomers. The project follows the typical GitHub pull request model. See " How to Contribute to Open Source " for more details. Before starting any work, please either comment on an existing issue, or file a new one.