Otoroshi

Otoroshi is a layer of lightweight api management on top of a modern http reverse proxy written in Scala and developped by the MAIF OSS team that can handle all the calls to and between your microservices without service locator and let you change configuration dynamicaly at runtime.

The Otoroshi is a large hairy monster that tends to lurk on the top of the torii gate in front of Shinto shrines. It’s a hostile creature, but also said to be the guardian of the shrine and is said to leap down from the top of the gate to devour those who approach the shrine for only self-serving purposes.

Installation

You can download the latest build of Otoroshi as a fat jar, as a zip package or as a docker image.

You can install and run Otoroshi with this little bash snippet

wget -q --show-progress 'https://dl.bintray.com/maif/binaries/otoroshi.jar/1.1.2/otoroshi.jar'
# run the following line if you want to use the admin UI in your browser
sudo echo "127.0.0.1    otoroshi-api.foo.bar otoroshi.foo.bar otoroshi-admin-internal-api.foo.bar" >> /etc/hosts
# Java 8
java -jar otoroshi.jar
# Java 9 and 10
java --add-modules java.xml.bind -jar otoroshi.jar

or using docker

docker run -p "8080:8080" maif/otoroshi:1.1.2

now open your browser to http://otoroshi.foo.bar:8080/, log in with the credential generated in the logs and explore by yourself, if you want better instructions, just go to the Quick Start or directly to the installation instructions

You can also try Otoroshi online with Google Cloud Shell if you’re a user of the Google Cloud Platform

Open in Cloud Shell

Documentation

Discussion

Join the Otoroshi channel on the MAIF Gitter

Sources

The sources of Otoroshi are available on Github.

Logo

You can find the official Otoroshi logo on GitHub. The Otoroshi logo has been created by François Galioto (@fgalioto)

Changelog

Every release, along with the migration instructions, is documented on the Github Releases page.

Patrons

The work on Otoroshi was funded by MAIF with the help of the community.

Licence

Otoroshi is Open Source and available under the Apache 2 License