https://github.com/jmnarloch/zuul-route-cassandra-spring-cloud-starter

Spring Cloud Zuul route Cassandra store
https://github.com/jmnarloch/zuul-route-cassandra-spring-cloud-starter

Last synced: 4 days ago
JSON representation

Spring Cloud Zuul route Cassandra store

• Host: GitHub
• URL: https://github.com/jmnarloch/zuul-route-cassandra-spring-cloud-starter
• Owner: jmnarloch
• License: apache-2.0
• Created: 2015-11-22T19:37:26.000Z (almost 9 years ago)
• Default Branch: master
• Last Pushed: 2017-01-23T19:52:11.000Z (almost 8 years ago)
• Last Synced: 2023-07-04T14:06:58.795Z (over 1 year ago)
• Language: Java
• Size: 77.1 KB
• Stars: 32
• Watchers: 8
• Forks: 21
• Open Issues: 4
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Spring Cloud Zuul Route Cassandra Store

> A Spring Cloud Cassandra store for Zuul routes.

[![Build Status](https://travis-ci.org/jmnarloch/zuul-route-cassandra-spring-cloud-starter.svg?branch=master)](https://travis-ci.org/jmnarloch/zuul-route-cassandra-spring-cloud-starter)

[![Coverage Status](https://coveralls.io/repos/jmnarloch/zuul-route-cassandra-spring-cloud-starter/badge.svg?branch=master&service=github)](https://coveralls.io/github/jmnarloch/zuul-route-cassandra-spring-cloud-starter?branch=master)

## Features

Extends the Spring Cloud's `ProxyRouteLocator` with capabilities of loading routes out of the configured Cassandra database.

Instead of configuring your routes through `zuul.routes` like fallows:

```

zuul:

  ignoredServices: '*'

  routes:

    resource:

      path: /api/**

      serviceId: rest-service

    oauth2:

      path: /uaa/**

      serviceId: oauth2-service

      stripPrefix: false

```

You can store the routes in Cassandra.

Keep in mind that the other properties except for routes are still relevant.

```

zuul:

  ignoredServices: '*'

  store:

    cassandra:

      enabled: true

```

## Setup

Add the Spring Cloud starter to your project:

```xml

  io.jmnarloch

  zuul-route-cassandra-spring-cloud-starter

  1.0.0

```

Connect to Cassandra and create a keyspace:

```cql

CREATE KEYSPACE IF NOT EXISTS zuul WITH REPLICATION = { 'class' : 'SimpleStrategy', 'replication_factor' : 3 };

USE zuul;

CREATE TABLE zuul_routes (

    id text,

    path text,

    service_id text,

    url text,

    strip_prefix boolean,

    retryable boolean,

    PRIMARY KEY(id)

);

```

Register `CassandraOperations` bean within your application:

```java

@SpringBootApplication

public static class Application {

    @Bean

    public Cluster cluster() {

        return Cluster.builder()

                .addContactPoints(InetAddress.getLoopbackAddress())

                .withPort(9142)

                .build();

    }

    @Bean

    public CassandraOperations cassandraTemplate(Cluster cluster) {

        return new CassandraTemplate(cluster.connect("zuul"));

    }

}

```

Configure the Cassandra to be used for loading the Zuul routes:

```yaml

zuul:

  store:

    cassandra:

      enabled: true

```

Finally enable the Zuul proxy with `@EnableZuulProxyStore` - use this annotation as a replacement for standard `@EnableZuulProxy`:

```java

@EnableZuulProxyStore

@SpringBootApplication

public static class Application {

    ...

}

```

## Properties

```yaml

zuul.store.cassandra.enabled=true# false by default

```

## License

Apache 2.0