https://github.com/sapcc/andromeda
Platform agnostic GSLB frontend with OpenStack-like API
https://github.com/sapcc/andromeda
golang gslb loadbalancer openstack
Last synced: 2 months ago
JSON representation
Platform agnostic GSLB frontend with OpenStack-like API
- Host: GitHub
- URL: https://github.com/sapcc/andromeda
- Owner: sapcc
- License: apache-2.0
- Created: 2020-11-20T12:56:08.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2025-04-29T18:38:10.000Z (3 months ago)
- Last Synced: 2025-04-29T19:44:10.470Z (3 months ago)
- Topics: golang, gslb, loadbalancer, openstack
- Language: Go
- Homepage: https://sapcc.github.io/andromeda/
- Size: 2.88 MB
- Stars: 6
- Watchers: 44
- Forks: 3
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
# andromeda
Platform agnostic GSLB frontend with OpenStack-like API
Andromeda is a OpenStack like REST API Fronted for Global Loadbalancing as a Service (GLbaaS). It can support multiple backends, called provider.
Features:
* Multi-tenant capable
* keystone authentication
* OpenStack policy files
* Prometheus metrics
* Rate limiting
* OpenStack like Quota API
* Multiple Database backends supported
* PostgreSQL
* MariaDB (Warning, MySQL/Percona is **not** supported)
* CockroachDB
Currently it supports following provider:
* F5 BigIP DNS
* Akamai
API Documentation: https://sapcc.github.io/andromeda/
## CLI Client
Andromeda provides a reference CLI client called `m31ctl` that uses the REST API of Andromeda.
## Running Requirements
* go 1.19
* NATS
* SQL Database (PostgreSQL/MariaDB/CockroachDB)
### Optional development requirements (needed to re-create meta sources)
* swagger https://github.com/go-swagger/go-swagger/blob/master/docs/install.md
* protoc https://grpc.io/docs/protoc-installation/
* protoc-gen-go https://github.com/golang/protobuf
* protoc-gen-micro v3 https://github.com/asim/go-micro/tree/v3/cmd/protoc-gen-micro
## Build
* Build `andromeda` and `m31ctl`: `$ make`
* Rebuild swagger metafiles: `$ make swagger`
## Example Architecture
```mermaid
flowchart TB
A[User region A] -->|Rest API| C(andromeda-api)
B[User region B] -->|Rest API| D(andromeda-api)
M[User region C] -->|Rest API| O(andromeda-api)
C & D & O <--> NATS
C ---> db1[(Database)]
D ----> db2[(Database)]
O ---> db3[(Database)]
subgraph Distributed Database
db1 ---|sync| db2
db2 ---|sync| db3
end
subgraph NATS
N[NATS message bus]
end
NATS --> andromeda-worker-1
NATS --> andromeda-worker-2
NATS --> andromeda-worker-3
```
## License
* APACHE LICENSE, VERSION 2.0
* Text version: https://www.apache.org/licenses/LICENSE-2.0.txt
* SPDX short identifier: Apache-2.0
* OSI Approved License: https://opensource.org/licenses/Apache-2.0