This is the simplest way for a developer to get the sample up and running locally.
- Install a Git client to obtain the sample code.
- Install Maven and a Java 8 JDK.
- Install a Docker engine.
- Install minikube.
- Install the Microservice Builder fabric - these are various services that run on top of Kubernetes.
- Enable ingress with the command
minikube addons enable ingress. git clonethe following projects:mvn clean packagein each ../sample.microservicebuilder.* projects except docs.docker build -t [name] .in each ../sample.microservicebuilder.* projects except docs, where [name] is the argument passed toutils.dockerBuild()in theJenkinsfilein that project's root directory.- Deploy each microservice from its root directory with the command
kubectl apply -f manifests. - Use
kubectl get ingto determine the address of theweb-application-ingress. Open this location in a web browser to access the sample.
Once you've made changes to the source code you'll want to rebuild and redeploy the new modules. See this topic for some notes about redeployment. You can also explore adding security to the application with OpenID Connect and JSON Web Tokens (JWT).