garrettmills/k8s-hpc-demo
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity
20 Commits 1 Branch 0 Tags 57 KiB
Shell 95.4%
Dockerfile 4.6%
6a2cc5f8ff
Go to file
glmdev 6a2cc5f8ff remove snow
2019-05-02 11:45:49 -05:00
container add snow container stuff 2019-05-02 11:29:08 -05:00
definitions big bang 2019-04-30 13:21:03 -05:00
demos remove snow 2019-05-02 11:45:49 -05:00
cluster_exec.sh add README and rename files 2019-04-30 13:42:41 -05:00
README.md add README and rename files 2019-04-30 13:42:41 -05:00
setup.sh big bang 2019-04-30 13:21:03 -05:00
start_cluster.sh big bang 2019-04-30 13:21:03 -05:00
stop_cluster.sh big bang 2019-04-30 13:21:03 -05:00

README.md

Computing in the Kubernetes Framework

This repository contains some resources for getting started with OpenMPI and high-performance computing on Kubernetes. This accompanies a presentation given by Garrett Mills at the KU CRMDA on Docker, Kubernetes, and high-performance computing.

Get up and running.

If you want to follow along or try OpenMPI on Kubernetes out for yourself, you can get started by creating a virtual cluster on your machine with Minikube. Here's how to get set up:

  1. Install VirtualBox. Our test Kubernetes cluster will run on a collection of VMs, so we'll install VirtualBox to make that possible. Here's the download.
  2. Install kubectl. This is the Kubernetes CLI tool. It's how you interface with Kubernetes. Grab it here.
  3. Install Minikube. Minikube is a software tool that creates a Kubernetes cluster with VMs on your local machine. This is an excellent tool for testing deployments. Get it here.
  4. Install Helm. Helm is a Kubernetes package manager used by the cluster framework. Here's the link.
  5. Clone this repository to your computer using Git: git clone https://git.glmdev.tech/glmdev/k8s-hpc-demo

That's it! You're ready to start using the Kubernetes cluster on your computer.

Basic use.

From within the cloned repository's folder, run the ./setup.sh command. This will clone the kube-openmpi repository and generate the SSH key used by OpenMPI.

Now, we can start the cluster by running the ./start_cluster.sh script. This will create the Kubernetes resources and start the cluster. If you have the watch command line tool installed, it will open up the cluster status page so you can see when it's done initializing.

At this point, we have a fully-functional OpenMPI cluster. By default, the definitions provided in this repo will create 5 worker nodes. You can run commands on the cluster using the ./cluster_exec.sh script. For example:

$ ./cluster_exec.sh mpiexec --allow-run-as-root --hostfile /kube-openmpi/generated/hostfile -n 5 echo "Hello, world!"
Hello, world!
Hello, world!
Hello, world!
Hello, world!
Hello, world!

When you're finished with the cluster, stop it using the ./stop_cluster.sh command.