I've been using OpenShift for a while now... for many reasons. First of all, I don't want to build my own Docker and Kubernetes environment on Windows, and second of all, because I like the simple installation. After the Christmas holidays, I decided to upgrade my machine to Windows 10. While I like the look and feel, it broke quite a bit of my networking and container installments including the Docker and OpenShift environments. Now that I have everything up and running again, it is time to follow the microserivces path a little more. The first thing is to actually get OpenShift up and running and get a development environment setup in which we can simply push Docker images to it without having to use any of the Source-2-Image or OpenShift build mechanisms.
Installing the All-in-One-VM
Download the all-in-one-vm image and import it into the vagrant box. This image is based off of OpenShift Origin and is a fully functioning OpenShift instance with an integrated Docker registry. The intent of this project is to allow Web developers and other interested parties to run OpenShift V3 on their own computer. Given the way it is configured, the VM will appear to your local machine as if it was running somewhere off the machine (which is exactly what I need to show you in OpenShift while introducing some more feature). If you need a little more assistance follow the method 2 in this earlier blog-post.
I also assume that you have docker-machine running. You can install it via the Docker Toolbox.
First Steps in OpenShift
Fire up the magazine via Vagrant and redirect your browser to https://localhost:8443/. Accept the certificate warning and enter admin/admin as login. You're now browsing through the admin console. Let's create a new project to play around with:
oc login https://localhost:8443 # enter admin/admin as the credentials oc new-project myfear --description="Testing random Docker Images on OpenShift" --display-name="Myfears test project" # Add admin role to user myfear oc policy add-role-to-user myfear admin -n myfear
First thing to do is to actually get a MySQL database up and running. I want to use that in subsequent blog posts and it's a good test to see if everything is working. Get the two JSON files from my Github repository and execute the following commands:
oc create -f mysql-pod.json oc create -f mysql-service.json
Go back to your browser and select the myfear project and see the MySQL service up and running with one pod.
Using the OpenShift Registry
You just witnessed how OpenShift pulled the MySQL image and started a pod with a container on it. Obviously this image came from the built in registry. But, how can one actually upload a Docker image to the internal OpenShift registry? SSH into the Vagrant machine and look around a bit:
vagrant ssh docker ps
You see a lot of running containers and one of them is running the openshift/openshift-registry-proxy. This little gem actually forwards the port 5000 from the internal docker registry to the Vagrant vm. Open Virtualbox and look at the port forwarding rules there. Another rule forwards port 5000 from the guest to the host. This means, the internal OpenShift Docker registry is already exposed by default. But, how do we push something there? The Docker client requires a Docker host to work. The OpenShift Docker Daemon isn't exposed externally and you can't just point your Docker client to it.
This means, you need another Docker host on your machine which is configured to access the OpenShift docker registry as external registry. I'm using docker-machine here, because it is extremely easy to create new Docker hosts with it.
docker-machine create -d virtualbox dev
After a couple of seconds your "dev" vm is created and started. Now, we need to find out what the host system's IP address is from the dev box. SSH into the machine and get the ip of the default gateway:
docker-machine ssh dev $ ip route | grep default > 10.0.0.2
Now we need to stop the machine and add the ip address we found to the insecure registry part of the configuration:
docker-machine stop dev edit ~/.docker/machine/machines/default/config.json # Add the found ip address plus the registry port to the HostOptions => EngineOptions => InsecureRegistry array
Afterward, it should look like this:
"InsecureRegistry": [ "10.0.2.2:5000" ]
Time to restart the dev vm and get the Docker client configured for it:
docker-machine start dev FOR /f "tokens=*" %i IN ('docker-machine env dev --shell cmd') DO %i
That's it for now. One important thing is, that the internal registry is secured and we need to log in to it. Get the login token for the user "myfear" with the following commands:
oc login -u myfear oc whoami -t
This will return something cryptic like: dV2Dep7vP8pJTxNGk5oNJuqXdPbdznHrxy5_7MZ4KFY. Now, login to the registry:
docker login -u myfear -p dV2Dep7vP8pJTxNGk5oNJuqXdPbdznHrxy5_7MZ4KFY -e email@example.com 10.0.2.2:5000
Make sure to use the correct username and token. You get a success message with and your login credentials are being saved in the central config.json.
Build and Push the Custom Image
Time to finally build the custom image and push it. I am using Roland's Docker Maven plugin again.
If you want to learn more about it, there is an older blog-post about it. Also, find the code in this Github repository. Compare the pom.xml and make sure to update the docker.host and docker.registry properties:
And, update the <authConfig> section with the correct credentials. Build the image with:
mvn clean install docker:build docker:push
If you ran into an issue with the Maven plugin not being able to build the image, you may need to pull the jboss/base-jdk:8 image manually first:
docker pull jboss/base-jdk:8
Let's check if the image is successfully uploaded by using the console and navigating to the overview => image streams page.
And in fact, the image is listed. Now, we need to start a container with it and expose the service to the world:
oc new-app swarm-sample-discovery:latest --name=swarm oc expose service swarm --hostname=swarm-sample-discovery.local
Please make sure to add the hostname mapping to your hosts or DNS configuration (to 127.0.0.1). As you can see, I am no longer using the Docker image tag but the image stream name. OpenShift converted this internally.
Time to access the example via the browser http://swarm-sample-discovery.local:1080/rs/customer.
If you're wondering about the port, go back to the Virtualbox configuration and check the NAT section. The all on one vm actually assumes that you have something running on port 80 already and maps the vm ports to the 1080 host port.
The application does very little for now, but I will use this in subsequent blog posts to dig a little into service discovery options.
The console overview shows the two services with one pod each.
That's it for today. Thanks again to Roland for his help with this. Let me know if you run into issues and if you want to know something else about OpenShift and custom images.