pluralsight/service-container

The service container is a lightweight framework that provides the ability to build micro-services

Download

Step 1. Add the JitPack repository to your build file

Add it in your root settings.gradle at the end of repositories:

	dependencyResolutionManagement {
		repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
		repositories {
			mavenCentral()
			maven { url 'https://jitpack.io' }
		}
	}

Add it in your settings.gradle.kts at the end of repositories:

	dependencyResolutionManagement {
		repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
		repositories {
			mavenCentral()
			maven { url = uri("https://jitpack.io") }
		}
	}

Add to pom.xml

	<repositories>
		<repository>
		    <id>jitpack.io</id>
		    <url>https://jitpack.io</url>
		</repository>
	</repositories>

Add it in your build.sbt at the end of resolvers:

 
    resolvers += "jitpack" at "https://jitpack.io"

Add it in your project.clj at the end of repositories:

 
    :repositories [["jitpack" "https://jitpack.io"]]

Step 2. Add the dependency

	dependencies {
		implementation 'com.github.pluralsight:service-container:v2.0.1'
	}

	dependencies {
		implementation("com.github.pluralsight:service-container:v2.0.1")
	}

	<dependency>
	    <groupId>com.github.pluralsight</groupId>
	    <artifactId>service-container</artifactId>
	    <version>v2.0.1</version>
	</dependency>


                            
    libraryDependencies += "com.github.pluralsight" % "service-container" % "v2.0.1"


                            
    :dependencies [[com.github.pluralsight/service-container "v2.0.1"]]

Readme

Service Container

The service container is a lightweight framework that provides the ability to build microservices. It contains a built-in Http server and utilizes both Akka and Spray at it's core. The service container is fully SaaS ready as it provides functionality for recording metrics and for tracking the health of your service.

There are a few sub-projects in this repository and here is a list of those currently available.

service-container : The core framework
service-container-metrics-reporting : Support for external reporting of gathered metrics
service-container-examples : A few examples that can be used for reference as well as run for testing

How To

There are several aspects to utilizing the functionality contained within the Service Container and it's supporting libraries. This section outlines the available functionality and how to best utilize the framework.

Configuration

As with any framework, it is important to allow custom configuration. The Service Container supports enhanced configuration and follow the standard Typesafe Config rollup patterns.

Instructions

Builtin Service Container endpoints

In order to allow our internal users and systems to self-discover the health of services, the Service Container will expose canned endpoints. These endpoints can be used for such things as checking health, monitoring, and other various purposes.

Instructions

Metrics

The Service Container implements logic to track metrics within the system. It automatically tracks JVM and other internal metrics. The framework also provides the ability to track any number of custom metrics. Once metrics are gathered, the can be accessed by the /metrics endpoint and written out using any number of metrics reporters.

Instructions

License

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.