Skip to content

sbollers/deploy-react-kubernetes

 
 

Repository files navigation

Build Status

Deploy a React application on Kubernetes

In this Code Pattern, we will deploy a React application using Kubernetes.

There are many choices when looking for the right solution to manage and deploy our applications. It can often be overwhelming when we're trying to pick the right solution. One of our many choices is Kubernetes. This pattern will take you through how to get a front end application deployed on Kubernetes. After implementing the code, you will have the knowledge to deploy your own applications on Kubernetes.

This repository uses the React JavaScript library to build out the front end of the application. Redux is a predictable state container used hand in hand with React. It handles all of the state management within the application. The OMDb API is called to get movie information based on user input. Docker is an open source tool that is used to package the application into a container. IBM Cloud provides one to use with Kubernetes deployments called IBM Cloud Container Service. Kubernetes handles the management and deployment of the containerized application.

When the reader has completed this Code Pattern, they will understand how to:

  • Containerize a React application using Docker
  • Deploy and manage an application using Kubernetes

Flow

Flow

  1. The user accesses the application through the web interface. The user enters a movie title into the input.
  2. The React application is rendered to the user on access.
  3. The application calls the OMDb API and receives a JSON object of the response to show the user.

Included components

  • IBM Cloud Container Service: IBM Bluemix Container Service manages highly available apps inside Docker containers and Kubernetes clusters on the IBM Cloud.
  • Kubernetes Cluster: Create and manage your own cloud infrastructure and use Kubernetes as your container orchestration engine.

Featured technologies

  • Node.js: An open-source JavaScript run-time environment for executing server-side JavaScript code.
  • Cloud: Accessing computer and information technology resources through the Internet.
  • Container Orchestration: Automating the deployment, scaling and management of containerized applications.

Watch the video

Steps

Prerequisites

  1. You must get an API key from OMDb API in order to get a response from the API. You will insert your API key in /src/actions/index.js on line 42 OMDb API by Brian Fitz is licensed under CC BY-NC 4.0

  2. Create an environment variable for your docker username

$ export docker_username="YOUR_DOCKER_USERNAME"

Run locally

  1. Clone the repo
  2. Run the application

1. Clone the repo

Clone the repo locally. In a terminal, run:

$ git clone https://github.com/IBM/deploy-react-kubernetes

2. Run the application

  1. Install Node.js
  2. Run the following commands in a terminal:
$ npm install

$ npm run build-css

$ npm run start

Run the application using Docker

  1. Build the image
  2. Run the image

1. Build the image

In a terminal, run:

$ docker build -t $docker_username/deploy-react-kubernetes .

Your image should be listed by running:

$ docker images

1. Run the image

In a terminal, run:

$ docker run -p 3000:3000 -d $docker_username/deploy-react-kubernetes

You can now access the application at http://localhost:3000

2. Run the application on Kubernetes

  1. Build Docker image.
  2. Deploy the application

Prerequisites

  • Create a namespace
$ bx cr namespace-add <your_namespace>

1. Build Docker image

In a terminal, run:

$ bx cr build -t registry.<ibm_cloud_region>.bluemix.net/<your_namespace>/deploy-react-kubernetes .

2. Deploy the application

$ kubectl run deploy-react-kubernetes-deployment —-image= registry.<ibm_cloud_region>.bluemix.net/<your_namespace>/deploy-react-kubernetes

$ kubectl expose deployment/deploy-react-kubernetes-deployment 
—-type=NodePort —-name=deploy-react-kubernetes-service —-port=3000
  • To access your application. You would need the public IP address of your cluster and NodePort of the service.
# For clusters provisioned with IBM Cloud
$ bx cs workers YOUR_CLUSTER_NAME
# For details on a specific Kubernetes service
$ kubectl describe service deploy-react-kubernetes-service

You can now access the application at http://IP_ADDRESS:NODE_PORT

Sample output

screen shot 2017-03-13 at 6 14 10 pm

Links

Learn more

License

Apache 2.0

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • JavaScript 78.0%
  • CSS 18.8%
  • HTML 3.2%