andromeda GSLBaaS

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
• OpenStack keystone authentication
• OpenStack policy support
• 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 GSLB 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.24
• NATS
• SQL Database (PostgreSQL/MariaDB/CockroachDB)

Build requirements

• GNU Make

Not required, will be installed by Makefile:

• migrate
• swagger
• protoc
• protoc-gen-go
• protoc-gen-stormrpc

Build target

• Build: $ make
• Rebuild swagger metafiles: $ make swagger
• Cleanup: $ clean

Example Architecture

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

Loading

Support, Feedback, Contributing

This project is open to feature requests/suggestions, bug reports etc. via GitHub issues. Contribution and feedback are encouraged and always welcome. For more information about how to contribute, the project structure, as well as additional contribution information, see our Contribution Guidelines.

Security / Disclosure

If you find any bug that may be a security problem, please follow our instructions in our security policy on how to report it. Please do not create GitHub issues for security-related doubts or problems.

Code of Conduct

We as members, contributors, and leaders pledge to make participation in our community a harassment-free experience for everyone. By participating in this project, you agree to abide by its Code of Conduct at all times.

Licensing

Copyright 2022-2025 SAP SE or an SAP affiliate company and andromeda contributors. Please see our LICENSE for copyright and license information. Detailed information including third-party components and their licensing/copyright information is available via the REUSE tool.