Skip to content

Latest commit

 

History

History
163 lines (110 loc) · 5.09 KB

README.md

File metadata and controls

163 lines (110 loc) · 5.09 KB
Raw

pingcloud-cli

pingcloud-cli gcp

Pingcloud-cli is CLI application to check latency and http trace from AWS, GCP and Azure regions.

This is a personal toy project.

Inspired by GCPing, httpstat-1 and AzureSpeed.

Capabilities

  1. Send HTTP(S) request to regions of AWS, GCP and Azure. Calculate and report response time.
  2. Print httpstat of region(s).
  3. List region code and region name of AWS, GCP and Azure.
Thank you for using pingcloud-cli.
pingcloud-cli is command line tools to check latency and http trace from AWS, GCP and Azure regions.
You can download codes from https://github.com/reoim/pingcloud-cli
Any feedback is welcome. (And stars..)

Usage:
  pingcloud-cli [command]

Available Commands:
  aws         Check latencies of AWS regions.
  azure       Check latencies of Azure regions.
  gcp         Check latencies of GCP regions.
  help        Help about any command
  version     Print version of pingcloud-cli

Flags:
  -h, --help   help for pingcloud-cli

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

Prerequisite

  1. GO installed.
  2. $GOPATH and $GOBIN are properly set.

Installation

  1. Run git clone https://github.com/reoim/pingcloud-cli.git
  2. Run GO111MODULE=on go mod vendor
  3. Run go build -v
  4. Run go install
  5. Set Environment variable PINGCLOUD_DIR as your pingcloud-cli directory(absolute path).

    • Linux & Mac

      Add following code to your .profile or .bash_profile.

      Make sure change [YOUR pingcloud-cli DIR] to absolute path of the git cloned directory.

      # pingcloud-cli settings
export PINGCLOUD_DIR="[YOUR pingcloud-cli DIR]"

      Restart terminal and check if PINGCLOUD_DIR is set properly.

      echo $PINGCLOUD_DIR

      Output should be like this (example)

      /Users/reolee/Downloads/pingcloud-cli

    • Windows

      • Open System in Control panel

      • In the System window, click the Advanced system settings

      • In the System Properties window, click on the Advanced tab, then click the Environment Variables button near the bottom of the tab

        windows env setting

      • In the Environment Variables window, click the New button of the User variables section

      • Set Variable name as PINGCLOUD_DIR

      • Set Variable value as absolute path of pingcloud-cli directory like as shown below.

        C:\Users\reolee\Downloads\pingcloud-cli

      • Click OK button

      • Open new cmd and run echo %PINGCLOUD_DIR%

      • Output should be like this (example)

        C:\Users\reolee\Downloads\pingcloud-cli

Usage

GCP (Google Cloud Platform)

  1. pingcloud-cli gcp

    Ping all GCP regions

    pingcloud-cli gcp

  2. pingcloud-cli gcp [region code]

    Print httpstat of specific regions. You can append multiple region codes to the end of command. (Seperate each region with space)

    pingcloud-cli gcp region

AWS

  1. pingcloud-cli aws

    Ping all AWS regions

    pingcloud-cli aws

  2. pingcloud-cli aws [region code]

    Print httpstat of specific regions. You can append multiple region codes to the end of command. (Seperate each region with space)

    pingcloud-cli aws region

Azure

  1. pingcloud-cli azure

    Ping all Azure regions

    pingcloud-cli azure

  2. pingcloud-cli azure [region code]

    Print httpstat of specific regions. You can append multiple region codes to the end of command. (Seperate each region with space)

    pingcloud-cli azure region

Flags

  • -l or --list List all region codes and region names of the cloud provider. Add -l or --list flag after command.

pingcloud-cli gcp -l

Add/Edit/Delete regions

You can add/edit/delete regions by manifulating endpoints CSV files.

The CSV files of cloud platforms are located in pingcloud-cli/endpoints folder.

Make sure you follw the original csv format of the files.

Notes

Instances for latency test are not maintained by me.

Endpoints for AWS are from EC2 Reachability Test.

For GCP, GCP ping

And for Azure, AzureSpeed.

Endpoints from Azure have domain name and uses https but AWS, GCP endpoints are static and use http.

So latencies from Azure are relatively high compare to AWS and GCP because it needs domain loockup and tls handshaking.

2019-09-08

Changed Azure test endpoints https -> http.

No more TLS handshaking time.

2019-09-16

Removed endpoint information from code.

pingcloud-cli will read the endpoint information from external csv files which can be edited anytime by user.