Orlo

Orlo is an API for tracking deployments, written with Python, Flask and SqlAlchemy.

It originated as part of a siteops hackathon, and is currently in development by staff at eBay Classifieds Group.

Contents

• Installation
  • From pip
  • From source
  • Developing in Vagrant
  • Building the debian package
  • Initial Configuration
  • Database setup
  • Running under Gunicorn
  • Nginx Setup
• Configuration
  • [main]
  • [security]
  • [db]
  • [flask]
  • [gunicorn]
  • [logging]
• REST API
• Security Notes
  • Overview
  • Keep instances on private networks
  • Keep instances isolated
  • Cross-site scripting
  • Third-party libraries

About Orlo

Orlo aims to cover the needs of all eCG platforms with respect to gathering information about deployments, while being simple to integrate with existing deployment software and scripts. This currently includes:

• Person who performed the release
• Dev team responsible
• Platforms deployed to
• Start time, finish time, and duration by package
• Versions of packages released
• External references such as issue tracking tickets
• Output such as logs

With this information, it will be possible to build dashboards and more intelligent release tooling.

The API should also be agnostic to release process, server container or packaging format - all platforms do things differently. It should be forgiving and “do the right thing” in the case of missing data, as not all platforms will use every field.

Why “orlo”?

Originally this project was called “Sponge”, because sponges are absorbent. But it turns out that name was already in use on readthedocs.org, so it was renamed. In English, orlo means “a plinth supporting the base of a column”.

Clients

At present we only have a Python client, see [orlo-client](https://github.com/eBayClassifiedsGroup/orloclient).