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.
You can install and run Otoroshi with this little bash snippet
wget -q --show-progress 'https://dl.bintray.com/maif/binaries/otoroshi.jar/1.2.0/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.2.0
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
- About Otoroshi
- Try Otoroshi in 5 minutes
- Video tutorials
- Get Otoroshi
- First run
- Setup Otoroshi
- Using Otoroshi
- Third party Integrations
- Detailed topics
- Embedding Otoroshi
- Admin REST API
- Rust CLI
- Deploy to production
The sources of Otoroshi are available on Github.
Every release, along with the migration instructions, is documented on the Github Releases page.
The work on Otoroshi was funded by MAIF with the help of the community.
Otoroshi is Open Source and available under the Apache 2 License