ATC

[planned feature]

Air Traffic Controller

Cluster router and provisioning service.

• service on private network to assign UUID to cluster
• public router endpoint that looks up UUID and forwards request to appropriate cluster
• store UUID -> cluster mapping in persistent layer and load data into memory on startup
• support ability to manually change UUID -> cluster mapping

INTERNAL API

Internal API for assigning UUID to an Airship cluster. The internal API would typically be used by an user registration app to notify ATC of a new UUID.

PUT

/provision/[UUID]

Assigns UUID to an available cluster. Effectively just adds mapping of UUID -> cluster to ATC routing table.

EXTERNAL API

Simple request forwarding.

Accept any request that comes in on public interface, parse out UUID, look it up in mapping table, forward request to internal cluster.

Incoming requests will have UUID as the first part of the URL

/[UUID]/the/rest/of/the/path

The request should be passed to the cluster without any modification.