Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ExpediaGroup/stream-registry
Stream Discovery and Stream Orchestration
https://github.com/ExpediaGroup/stream-registry
metadata-management oss-portal-featured stream-processing streams
Last synced: 3 months ago
JSON representation
Stream Discovery and Stream Orchestration
- Host: GitHub
- URL: https://github.com/ExpediaGroup/stream-registry
- Owner: ExpediaGroup
- License: apache-2.0
- Created: 2018-11-28T17:12:11.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2024-03-13T17:42:48.000Z (4 months ago)
- Last Synced: 2024-03-13T18:52:05.059Z (4 months ago)
- Topics: metadata-management, oss-portal-featured, stream-processing, streams
- Language: Java
- Homepage: https://expediagroup.github.io/stream-registry/
- Size: 5.46 MB
- Stars: 115
- Watchers: 14
- Forks: 54
- Open Issues: 48
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Lists
- awesome-kafka - Expedia Stream Registry
README
# stream-registry [![Build Status][build-icon]][build-link]
[build-icon]: https://travis-ci.org/ExpediaGroup/stream-registry.svg?branch=master
[build-link]: https://travis-ci.org/ExpediaGroup/stream-registry
# Announcement: 12th April 2019
We wanted to let you know that there are going to be some exciting developments with the Stream Registry project in the very near future. Stream Registry is being adopted by many brands at Expedia Group as a critical component of its digital nervous system for key streams across Expedia Group. Therefore, Vrbo stream registry is finding a new home.
## What is changing
* We will be investing in the project by expanding the existing team with full-time resources in several locations across Expedia Group. Expect greatly increased project activity: contributors, commits, issues, features, releases
* The repository will relocate to the [ExpediaGroup open source GitHub org](https://github.com/ExpediaGroup) in its entirety, preserving the history and community
## What isn't changing
* The original vision of Stream Registry as a Stream Discovery and Stream Orchestration platform
* The project will remain open source, and will be joined shortly by other supporting Expedia Group stream platform components
* Licenses, conduct and contribution guidelines will remain unchanged
* The value of your contributions - please keep them coming!
We expect the start of this journey to be a little bumpy, but please bear with us as we work towards the first release of the **Expedia Group** Stream Registry!
# About
A Stream Registry is what its name implies: it is a registry of streams. As enterprises increasingly scale in size,
the need to organize and develop around streams of data becomes paramount. Synchronous calls are attracted to the edge,
and a variety of synchronous and asynchronous calls permeate the enterprise. The need for a declarative, central
authority for discovery and orchestration of stream management emerges. This is what a stream registry provides.
In much the same way that DNS provides a name translation service for an ip address, by way of analogy, a
Stream Registry provides a “metadata service” for streams. By centralizing stream metadata, a stream translation service
for producer and/or consumer stream coördinates becomes possible. This centralized, yet democratized, stream metadata
function thus streamlines operational complexity via stream lifecycle management, stream discovery,
stream availability and resiliency.
## Why Stream Registry?
We believe that as the change to business requirements accelerate, time to market pressures increase,
competitive measures grow, migrations to cloud and different platforms are required, and so on, systems will
increasingly need to become more reactive and dynamic in nature.
The issue of state arises.
We see many systems adopting _event-driven-architectures_ to facilitate the changing business needs in these high stakes
environments. We hypothesize there is an emerging need for a centralized "stream metadata" service in the
industry to help streamline the complexities and operations of deploying stream platforms that serve as a
distributed federated nervous system in the enterprise.
## What is Stream Registry?
Put simply, Stream Registry is a centralized service for stream metadata.
The stream registry can answer the following question:
1. Who owns the stream?
2. Who are the producers and consumers of the stream?
3. Management of stream replication across clusters and regions
4. Management of stream storage for permanent access
5. Management of stream triggers for legacy stream sources
## Architecture
See the [architecture/northstar documentation](https://expediagroup.github.io/stream-registry/) for more details.
## Building locally
Stream Registry is built using [OpenJDK 11](https://openjdk.java.net/install/) and Maven.
Stream Registry is currently packaged as a shaded JAR file.
We leave specific deployment considerations up to each team since this varies from enterprise to enterprise.
To build Stream Registry as a JAR file, please run
```console
./mvnw clean package
```
## Start Stream Registry
> **Required Local Environment**
> The local 'dev' version of Stream Registry requires a locally running version of Apache Kafka
> and Confluent's Schema Registry on ports 9092 and 8081, respectively.
To quickly get a local dev environment set up, we recommend to use Docker Compose.
Alternatively, one can start Confluent Platform locally after downloading the [Confluent CLI][confluent-cli-doc] and running the following command.
**Note**: The `confluent` command is currently only available for macOS and Linux. If using Windows, you'll need to use Docker, or run ZooKeeper, Kafka, and the Schema Registry all individually.
[confluent-cli-doc]: https://docs.confluent.io/current/cli/index.html
```console
confluent start zookeeper
confluent start kafka
confluent start schema-registry
```
Stream Registry can then be started.
Once Stream Registry has started, check that the application's GraphiQL server is running at http://localhost:8080/graphiql
## Kafka Version Compatibility
Stream Registry development and initial deployment started with Kafka 0.11.0 / Confluent Platform 3.3.0, and has also been deployed against Kafka 1.1.1 / Confluent Platform 4.1.2.
As per the [Kafka Compatibility Matrix][kafka-compatibility-doc], we expect Stream Registry to be compatbile with Kafka 0.10.0 and newer, and the internal Java Kafka clients used by Stream Registry can be found in the [`pom.xml`](pom.xml).
[kafka-compatibility-doc]: https://cwiki.apache.org/confluence/display/KAFKA/Compatibility+Matrix
## Run Unit Tests
```console
./mvnw clean test
```
## Contributors
Special thanks to the following for making stream-registry possible at Vrbo and beyond!
| [
Adam Westerman](https://www.linkedin.com/in/adam-westerman/)
[💻]([email protected]:expediagroup/stream-registry/commits?author=westeras) | [
Arun Vasudevan](https://www.linkedin.com/in/arun-vasudevan-55117368/)
[💻]([email protected]:expediagroup/stream-registry/commits?author=arunvasudevan) 🎨 | [
Nathan Walther](https://www.linkedin.com/in/nwalther/)
[💻]([email protected]:expediagroup/stream-registry/commits?author=nathanwalther) 👀 | [
Jordan Moore](https://www.linkedin.com/in/jordanmoorerhit/)
[💻]([email protected]:expediagroup/stream-registry/commits?author=cricket007) 💁 | [
Carlos Cordero](https://www.linkedin.com/in/carlos-d%C3%A1vila-cordero-71128a11b/)
[💻]([email protected]:expediagroup/stream-registry/commits?author=dccarlos) | [
Ishan Dikshit](https://www.linkedin.com/in/ishan-dikshit-4a1753ba/)
[💻]([email protected]:expediagroup/stream-registry/commits?author=ishandikshit) [📖]([email protected]:expediagroup/stream-registry/commits?author=ishandikshit) | [
Vinayak Ponangi](https://www.linkedin.com/in/preethi-vinayak-ponangi-90ba3824/)
[💻]([email protected]:expediagroup/stream-registry/commits?author=vinayakponangi) 📢 🎨 👀 |
| :---: | :---: | :---: | :---: | :---: | :---: | :---: |
| [
Prabhakaran Thatchinamoorthy](https://www.linkedin.com/in/prabhakaranthatchinamoorthy/)
[💻]([email protected]:expediagroup/stream-registry/commits?author=prabhakar1983) 🎨 | [
Rui Zhang](https://www.linkedin.com/in/rui-zhang-54667a82/)
[💻]([email protected]:expediagroup/stream-registry/commits?author=ruizhang0519) | [
Miguel Lucero](https://www.linkedin.com/in/miguellucero/)
[💻]([email protected]:expediagroup/stream-registry/commits?author=mlucero10) 💁 | [
René X Parra](https://www.linkedin.com/in/reneparra/)
[💻]([email protected]:expediagroup/stream-registry/commits?author=neoword) [📖]([email protected]:expediagroup/stream-registry/commits?author=neoword) 📝 📢 🎨 👀 |
| :---: | :---: | :---: | :---: |
This project follows the [all-contributors](https://github.com/kentcdodds/all-contributors) specification.
## Legal
This project is available under the [Apache 2.0 License](http://www.apache.org/licenses/LICENSE-2.0.html).
Copyright 2018-2019 Expedia, Inc.