# microsphere-netflix

**Repository Path**: microsphere-projects/microsphere-netflix

## Basic Information

- **Project Name**: microsphere-netflix
- **Description**: The microsphere projects for Netflix OSS
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-03
- **Last Updated**: 2026-09-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Microsphere Netflix

> Microsphere Projects for Netflix

[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/microsphere-projects/microsphere-netflix)
[![Maven Build](https://github.com/microsphere-projects/microsphere-netflix/actions/workflows/maven-build.yml/badge.svg)](https://github.com/microsphere-projects/microsphere-netflix/actions/workflows/maven-build.yml)
[![Codecov](https://codecov.io/gh/microsphere-projects/microsphere-netflix/branch/main/graph/badge.svg)](https://app.codecov.io/gh/microsphere-projects/microsphere-netflix)
![Maven](https://img.shields.io/maven-central/v/io.github.microsphere-projects/microsphere-netflix.svg)
![License](https://img.shields.io/github/license/microsphere-projects/microsphere-netflix.svg)

The microsphere-netflix project is a Java-based integration framework that provides enhanced functionality for Netflix
OSS components, specifically focusing on Eureka service discovery with clustering capabilities and advanced client
features. The project extends the standard Netflix Eureka implementation with production-ready enhancements including
high availability server clustering via Apache Tomcat, enhanced client metadata synchronization, and multiple client
management capabilities.

## Modules

| **Module**       | **Artifact ID**                                    | **Purpose**                                                                 |
|------------------|----------------------------------------------------|-----------------------------------------------------------------------------|
| Parent POM       | **microsphere-netflix-parent**                     | Provides common configuration and dependency management for all modules     |
| Dependencies BOM | **microsphere-netflix-dependencies**               | Centralized dependency version management using BOM pattern                 |
| Core Client      | **microsphere-netflix-eureka-client-core**         | Foundation Eureka client functionality independent of Spring Cloud          |
| Enhanced Client  | **microsphere-netflix-eureka-client-spring-cloud** | Spring Cloud integration with enhanced features and multiple client support |
| Clustered Server | **microsphere-netflix-eureka-server-spring-cloud** | High availability Eureka server with Tomcat clustering capabilities         |

## Getting Started

The easiest way to get started is by adding the Microsphere Netflix BOM (Bill of Materials) to your project's pom.xml:

```xml

<dependencyManagement>
    <dependencies>
        ...
        <!-- Microsphere Netflix Dependencies -->
        <dependency>
            <groupId>io.github.microsphere-projects</groupId>
            <artifactId>microsphere-netflix-dependencies</artifactId>
            <version>${microsphere-netflix.version}</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
        ...
    </dependencies>
</dependencyManagement>
```

`${microsphere-netflix.version}` has two branches:

| **Branches** | **Purpose**                                      | **Latest Version** |
|--------------|--------------------------------------------------|--------------------|
| **main**     | Compatible with Spring Cloud 2022.0.x - 2025.0.x | `0.2.0`            |
| **1.x**      | Compatible with Spring Cloud Hoxton - 2021.0.x   | `0.1.0`            |

## Building from Source

You don't need to build from source unless you want to try out the latest code or contribute to the project.

To build the project, follow these steps:

1. Clone the repository:

```bash
git clone https://github.com/microsphere-projects/microsphere-netflix.git
```

2. Build the source:

- Linux/MacOS:

```bash
./mvnw package
```

- Windows:

```powershell
mvnw.cmd package
```

## Contributing

We welcome your contributions! Please read [Code of Conduct](./CODE_OF_CONDUCT.md) before submitting a pull request.

## Reporting Issues

* Before you log a bug, please search the [issues](https://github.com/microsphere-projects/microsphere-netflix/issues)
  to see if someone has already reported the problem.
* If the issue doesn't already
  exist, [create a new issue](https://github.com/microsphere-projects/microsphere-netflix/issues/new).
* Please provide as much information as possible with the issue report.

## Documentation

### User Guide

[DeepWiki Host](https://deepwiki.com/microsphere-projects/microsphere-netflix)

### Wiki

[Github Host](https://github.com/microsphere-projects/microsphere-netflix/wiki)

### JavaDoc

TODO

## License

The Microsphere Spring is released under the [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0).