https://github.com/dgl/cloud-regions

Data on cloud regions
https://github.com/dgl/cloud-regions

aws azure cloud gcp geojson geojson-data linode oci vultr

Last synced: 16 days ago
JSON representation

Data on cloud regions

• Host: GitHub
• URL: https://github.com/dgl/cloud-regions
• Owner: dgl
• Created: 2022-04-22T08:22:39.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2022-07-20T06:34:14.000Z (over 2 years ago)
• Last Synced: 2024-10-11T21:18:46.521Z (about 1 month ago)
• Topics: aws, azure, cloud, gcp, geojson, geojson-data, linode, oci, vultr
• Language: HTML
• Homepage: https://cloud-regions.ip.wtf
• Size: 30.3 KB
• Stars: 15
• Watchers: 2
• Forks: 4
• Open Issues: 1
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Cloud provider regions

This is data on cloud provider regions, primarily aiming to give their

approximate location in a provider independent format.

## Providers

* Amazon, Amazon Web Services (AWS)

* Azure, Microsoft Azure

* Google, Google Cloud Platform (GCP)

* Linode

* Oracle

* Vultr

## Adding or updating data

The raw data is in data.csv in each provider's directory. Update that and send

a PR.

Most regions currently refer to a coarse area, such as "London". If you know

which datacentres a region is actually hosted in, we will happily take updates.

However there are cases where the parts (to use neutral terminology) of a

region are far apart, we may editorialise in those cases and pick a single

datacentre in a suitable midpoint. Sometimes the datacenters are actually

outside the declared "region" by the provider, that's fine.

## Adding a provider

Make a data.csv.

- "region" must match the region used in the API for the provider

- "location_name" ideally should match the description the provider uses

- "country_tld" should be the country code, with a bias towards the form used

  in TLDs (hk rather than cn, uk rather than gb)

The rest of the fields should be as: [./get-loc.sh](tools/get-loc.sh) "London,

England" outputs.

Make a "fetch-list" which can fetch a list of the current regions from the

providers API or other provider controlled source (sources without auth such as

IP lists are preferred). This makes it possible to regularly check for new

regions so the data stays fresh.

Explain in the README roughly how you did it, for when it comes time to update.

## Using the data

The raw data is in CSV in each provider's data.csv file.

In [tools/](tools) geojson.go can be used to convert the data into a GeoJSON

FeatureCollection.

```shell

$ go build -o geojson geojson.go

$ ./geojson ../*/data.csv > ../data.json

```

This is visualised at: http://cloud-regions.bodge.cloud

## License

This data uses data from OpenStreetMap, which is:

  © OpenStreetMap contributors, ODbL 1.0. https://osm.org/copyright

As a result this work is licensed under the same licence:

  This data is made available under the Open Database License:

  http://opendatacommons.org/licenses/odbl/1.0/. Any rights in individual

  contents of the database are licensed under the Database Contents License:

  http://opendatacommons.org/licenses/dbcl/1.0/

Non database files are licensed under the MIT license.