Git Product home page Git Product logo

vertx-config's Introduction

Externalized Configuration - Eclipse Vert.x Booster

Important
While you can run and interact with this booster on our local host, you cannot take advantage of using ConfigMap with this booster without using OpenShift. For more details on using this booster with a single-node OpenShift cluster, CI/CD deployments, as well as the rest of the runtime, see the Eclipse Vert.x Runtime Guide.
Important
As part of the process of creating this booster, launch.openshift.io set up a project with a CI/CD deployment of this booster. You can see the status of this deployment in your Single-node OpenShift Cluster or OpenShift Online Web Console.

Run this Booster Locally

To run this booster on your local host:

$ git clone [email protected]:lholmquist/vertx-config

$ cd vertx-config

$ mvn compile vertx:run

Interact with this Booster Locally

To interact with your booster while its running, use the form at http://localhost:8080 or the curl command:

$ curl http://localhost:8080/api/greeting
{"content":"Hello, World!"}

$ curl http://localhost:8080/api/greeting?name=Sarah
{"content":"Hello, Sarah!"}

Run this Booster on a Single-node OpenShift Cluster

If you have a single-node OpenShift cluster, such as Minishift or the Red Hat Container Development Kit, installed and running, you can also deploy your booster there. A single-node OpenShift cluster provides you with access to a cloud environment that is similar to a production environment.

To deploy your booster to a running single-node OpenShift cluster:

  1. Log in and create your project.

    $ oc login -u developer -p developer
    
    $ oc new-project MY_PROJECT_NAME
  2. Be sure that view access rights for the service account are added before deploying your booster.

    $ oc policy add-role-to-user view -n $(oc project -q) -z default
  3. Navigate to the root directory of your booster.

  4. Deploy your ConfigMap configuration using app-config.yml.

    $ oc create configmap app-config --from-file=app-config.yml
  5. Deploy your booster.

    $ mvn clean fabric8:deploy -Popenshift

Interact with this Booster on a Single-node OpenShift Cluster

To interact with your booster while it’s running on a Single-node OpenShift Cluster, you first need to obtain it’s URL:

$ oc get route booster-configmap-vertx -o jsonpath={$.spec.host}

booster-configmap-vertx-MY_PROJECT_NAME.LOCAL_OPENSHIFT_HOSTNAME

You can use the form at your application’s url or you can use the curl command:

$ curl http://booster-configmap-vertx-MY_PROJECT_NAME.LOCAL_OPENSHIFT_HOSTNAME/api/greeting
{"content":"Hello World from a ConfigMap!"}

$ curl http://booster-configmap-vertx-MY_PROJECT_NAME.LOCAL_OPENSHIFT_HOSTNAME/api/greeting?name=Sarah
{"content":"Hello Sarah from a ConfigMap!"}

More Information

You can learn more about this booster and rest of the Eclipse Vert.x runtime in the Eclipse Vert.x Runtime Guide.

vertx-config's People

Contributors

openshiftio-launchpad avatar

Watchers

James Cloos avatar Lucas Holmquist avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.