Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/goldmansachs/obevo

Obevo is a database deployment tool that handles enterprise scale schemas and complexity
https://github.com/goldmansachs/obevo

database database-deployment database-management database-migrations database-schema db-deployment db-migrate db-migration db2 deployment in-memory-database java maintenance mongodb mongodb-deployment oracle postgresql sql-server stored-procedures sybase

Last synced: about 4 hours ago
JSON representation

Obevo is a database deployment tool that handles enterprise scale schemas and complexity

Awesome Lists containing this project

README 

        
# Obevo



[![Documentation abc](https://img.shields.io/badge/Documentation-online-brightgreen.svg)](https://goldmansachs.github.io/obevo/) [![Build Status abc](https://travis-ci.org/goldmansachs/obevo.svg?branch=master)](https://travis-ci.org/goldmansachs/obevo) [![Maven Central](https://maven-badges.herokuapp.com/maven-central/com.goldmansachs.obevo/obevo-parent/badge.svg)](https://maven-badges.herokuapp.com/maven-central/com.goldmansachs.obevo/obevo-parent) [![Releases](https://img.shields.io/github/release/goldmansachs/obevo.svg)](https://github.com/goldmansachs/obevo/releases) [![Apache License](https://img.shields.io/badge/License-Apache%202-blue.svg)](LICENSE.txt)



## Database Deployment Tool for Enterprise Scale and Complexity



Deploying tables for a new application?



Or looking to improve the DB Deployment of a years-old system with hundreds (or thousands) of tables, views, stored procedures, and other objects?



Obevo has your use case covered.



Supported platforms: DB2, H2, HSQLDB, Microsoft SQL Server, MongoDB, Oracle, PostgreSQL, Redshift (from Amazon), Sybase ASE, Sybase IQ



## NoSQL (MongoDB) platforms also supported!



Obevo can be used for more than just relational databases.



MongoDB support is now available and supported for MongoDB versions 4.1.x and greater (i.e. not using the deprecated "eval" API).



This is the first non-RDBMS platform supported, which shows that the object-based management pattern described

[here](https://www.infoq.com/articles/Obevo-Introduction) can be applicable elsewhere.



Feel free to reach out to us if you'd like to apply our core algorithm onto a new use case.



## Quick Links



|Getting Started|

|:---|

|[Documentation](https://goldmansachs.github.io/obevo/)|

|[Quickstart Examples](https://github.com/goldmansachs/obevo-kata) (Setup a new database or Onboard an existing database)|

|[NY JavaSIG Presentation - Slides with animations (preferred)](https://docs.google.com/presentation/d/1oe_jjS7VwziLMjX9feCquGAx1FFRIiLek8hpccoll48)|

|[NY JavaSIG Presentation - PDF](Obevo_Javasig.pdf)|

|[InfoQ Publication - Introducing Obevo: Get Your Database SDLC under Control](https://www.infoq.com/articles/Obevo-Introduction)|



|APIs|Build Integration|

|:---|:---|

|[Java API](https://goldmansachs.github.io/obevo/java-api.html)|[Maven](https://goldmansachs.github.io/obevo/maven-api.html)|

|[Command Line API](https://goldmansachs.github.io/obevo/command-line-api.html)|[Gradle](https://goldmansachs.github.io/obevo/gradle-api.html)|



Docker image is available at Docker Hub: [shantstepanian/obevo](https://hub.docker.com/r/shantstepanian/obevo/tags/)



## How to Contribute?



Please see the [Contribution Guide](CONTRIBUTING.md).



## Why Use Obevo?



### Organized maintenance of all your DB object files to handle all use cases



By allowing your DB files to be maintained per DB object (as you would with classes in application code), db file maintenance

becomes much easier compared to DB Deployment tools that require a new file or change definition per migration:



* Changes for a particular table can be reviewed in one place

* Stateless objects like stored procedures and views can be edited in place without specifying any new incremental change files

* All of this is possible without having to define the complete order of your file deployments; Obevo figures it out for you (a la a Java compiler compiling classes)



[Click here](https://goldmansachs.github.io/obevo/design-walkthrough.html) for more information on how Obevo works and how its algorithm compares to what most other DB Deployment tools do



![1 file per object structure](obevo-site/src/site/resources/images/db-kata-file-setup.jpg)



### In-memory and integration testing



How do you test your DDLs before deploying to production?



Obevo provides utilities and build plugins to clean and rebuild your databases so that you can integrate that step into

your integration testing lifecycle.



Obevo can take that a step further by converting your DB table and view code into an [in-memory database compatible format](https://goldmansachs.github.io/obevo/in-memory-db-testing.html)

that you can use in your tests. The conversion is done at runtime, so you do not have to maintain separate DDLs

just for in-memory testing



### Easy onboarding of existing systems



Hesitant about getting your existing database schema under SDLC control due to how objects your application has built up

over the years? Obevo has been vetted against many such cases from applications in large enterprises.



### Versatile to run



Obevo can be invoked via:

* [Java API](https://goldmansachs.github.io/obevo/java-api.html)

* [Command Line API](https://goldmansachs.github.io/obevo/command-line-api.html)

* [Maven](https://goldmansachs.github.io/obevo/maven-api.html)

* [Gradle](https://goldmansachs.github.io/obevo/gradle-api.html)



Obevo is designed to allow your DB code to be packaged and deployed alongside your application binaries.



Treat your DB code like you would treat your application code!



## Acquiring Obevo



* [Versions](https://github.com/goldmansachs/obevo/releases)

* [Maven Central](http://search.maven.org/#search%7Cga%7C1%7Cg%3A%22com.goldmansachs.obevo%22)