NexGate

• NexGate is NexCloud's API Gateway made of NexEureka and NexZUUL using Spring Cloud for DC/OS. Just install NexEureka and NexZUUL and access microservices through service name without Eureka client.

• Architecture
  

• Environments

  • Over JAVA 8
  • Over Spring 4
  • Over Spring boot 1.5.9
  • Over Maven 3.5.2

• Installation

  • The first option is that fork this repository, modify application.properties, build Docker images and deploy the application on DC/OS.

    • NexEureka's application.properties
      : In application.properties, you just modify two env variables - eureka.endpoint and marathon.tasks.endpoint
      : marathon.tasks.endpoint is your Marathon's URL to call service list via Marathon REST API.
      : eureka.endpoint is Mesos DNS for eureka to register service list via Eureka REST API.

      marathon.tasks.endpoint=${MARATHON_TASKS_ENDPOINT:http://leader.mesos:8080/v2/tasks}
      eureka.endpoint=${EUREKA_ENDPOINT:http://nexrouter.marathon.mesos:8770/eureka/apps}

    • NexZuul need not modify properties. So, you just build Docker images and deploy the application on DC/OS

  • The second option is to deploy JSON configuration we suggested. JSON configuration is like samples below.

    • NexEureka

      {
          "id": "/nexgate/nexeureka",
          "backoffFactor": 1.15,
          "backoffSeconds": 1,
          "container": {
              "portMappings": [
              {
                  "containerPort": 8770,
                  "hostPort": 8770,
                  "labels": {
                  "VIP_0": "/nexeureka:8770"
                  },
                  "protocol": "tcp",
                  "servicePort": 10020
              }
              ],
              "type": "DOCKER",
              "volumes": [],
              "docker": {
              "image": "nexclipper/nexeureka",
              "forcePullImage": true,
              "privileged": false,
              "parameters": []
              }
          },
          "cpus": 0.5,
          "disk": 0,
          "env": {
              "MARATHON_TASKS_ENDPOINT": "http://leader.mesos:8080/v2/tasks",
              "EUREKA_ENDPOINT": "http://nexrouter.marathon.mesos:8770/eureka/apps/"
          },
          "healthChecks": [
              {
              "gracePeriodSeconds": 300,
              "intervalSeconds": 60,
              "maxConsecutiveFailures": 3,
              "portIndex": 0,
              "timeoutSeconds": 20,
              "delaySeconds": 15,
              "protocol": "MESOS_HTTP",
              "path": "/check"
              }
          ],
          "instances": 1,
          "maxLaunchDelaySeconds": 3600,
          "mem": 1536,
          "gpus": 0,
          "networks": [
              {
              "mode": "container/bridge"
              }
          ],
          "requirePorts": false,
          "upgradeStrategy": {
              "maximumOverCapacity": 1,
              "minimumHealthCapacity": 1
          },
          "killSelection": "YOUNGEST_FIRST",
          "unreachableStrategy": {
              "inactiveAfterSeconds": 0,
              "expungeAfterSeconds": 0
          },
          "fetch": [],
          "constraints": []
      }

    • NexZUUL

      {
          "id": "nexgate/nexzuul",
          "backoffFactor": 1.15,
          "backoffSeconds": 1,
          "container": {
          "portMappings": [
              {
              "containerPort": 9999,
              "hostPort": 0,
              "protocol": "tcp",
              "servicePort": 10100
              }
          ],
          "type": "DOCKER",
          "volumes": [],
          "docker": {
              "image": "nexclipper/nexzuul",
              "forcePullImage": true,
              "privileged": false,
              "parameters": []
          }
          },
          "cpus": 1,
          "disk": 0,
          "healthChecks": [
          {
              "gracePeriodSeconds": 300,
              "intervalSeconds": 60,
              "maxConsecutiveFailures": 3,
              "portIndex": 0,
              "timeoutSeconds": 20,
              "delaySeconds": 15,
              "protocol": "MESOS_HTTP",
              "path": "/check"
          }
          ],
          "instances": 1,
          "maxLaunchDelaySeconds": 3600,
          "mem": 1024,
          "gpus": 0,
          "networks": [
          {
              "mode": "container/bridge"
          }
          ],
          "requirePorts": false,
          "upgradeStrategy": {
          "maximumOverCapacity": 1,
          "minimumHealthCapacity": 1
          },
          "killSelection": "YOUNGEST_FIRST",
          "unreachableStrategy": {
          "inactiveAfterSeconds": 0,
          "expungeAfterSeconds": 0
          },
          "fetch": [],
          "constraints": []
      }

• Demos

  • Now, you are able to access services via NexGate. Here is samples that you can simply use NexGate.

    1. When you access NexEureka endpoint, then you can see the following screen. This screen shows service list deployed by marathon and Mesos DNS that we registered.

    2. The following image is an API service that we access endpoint directly. It can be an application you developed.
       The URL in this image is a direct access point for sample API service.

    3. You can see service list registered to NexEureka through NEXZUUL_ENDPOINT/routes.
       Our sample API service ID is tracing-sample_nexservice.

    4. You can access this service via NexZuul. This indicates that you can access any service through NexZuul/service_id.
       

What is NexEureka?

• NexEureka is the NexCloud's customed Eureka which can register service without Eureka client. In standard Eureka, you must inject dependency to registered service. But, in NexEureka, you need just NexEureka service on your server. We made functions that crawl services deployed by Marathon and register them to Eureka Server. It renews service list by 30 secs, so it is safe when an error occurred from one of services instances.

• Waht is Eureka?

  • Eureka is Spring Cloud project for service discovery in Micro Service Architecture. If you want to use service discover by Eureka, you have to initialize Eureka Server by putting @EnableEurekaServer annotation in the main class of Eureka Server Project. Then put @EnableEurekaClient annotation in the main class of service that you want to use.

  • Eureka has server - client Architecture for service registry. So you must have client source to register to Eureka server.
    

  • If Eureka client is registered to Eureka server, client replicates services registered to the server. If the service is not edge service, it is inefficient that eureka dependency is injected to project.

  • By defaults, Spring Cloud supports only JAVA application, so if you want to register NON-JAVA application, you need to adopt side-car.

• Advantages of NexEureka

  • Supports service discovery by itself.
  • Supports polyglot without side-car.
  • Supports high availability.

What is NexZUUL?

• NexZUUL is the NexCloud's customed ZUUL. As we explained, A service initialized as a Eureka client cached service list from Eureka server. So NexZUUL is the only Eureka client on Micro Service Architecture.

• What is ZUUL?

  • ZUUL is a simple gateway service or edge service. So its main goal is routing, monitoring, error management and security. Many API gateway products offer limited functions, but ZUUL is free to customize its functions for developers.

  • API gateway using Eureka and ZUUL
    You must inject Eureka client dependency to you micro service

• With NexEureka, just deploy microservices with no additional dependencies and access service through service name.