RancherOS Notes

RancherOS notes

Create a RancherOS machine

Locally:

• Install Docker, boot2docker and Docker Machine

Make sure you have a recent version of VirtualBox installed, then:

brew update && brew install docker boot2docker docker-machine
boot2docker init

• Create a docker-ready virtual machine using the docker-machine's virtualbox driver and the RancherOS iso:

docker-machine create -d virtualbox --virtualbox-boot2docker-url \
  https://github.com/rancher/os/releases/download/v0.4.0/rancheros.iso \
  RancherOSMachine

On a remote server:

• Install Docker and Docker Machine:

brew update && brew install docker docker-machine

• Create a docker-ready server using the generic driver and a set of docker containers:

docker-machine create -d generic --generic-ip-address=<ip_address> \
  --generic-ssh-user <username> --generic-ssh-key <path_to_ssh_private_key> \
  <name>

In this case make sure your user has passwordless sudo configured.

• Once docker machine has been created, follow Rancher's official documentation to install & configure a Rancher platform

Setup environment variables

Point the docker client on your host to the docker daemon running in a particular machine:

eval $(docker-machine env <name>)

Keycloak notes

Pull and run Keycloak

To run the Keycloak container service and have it log to stdout, do the following:

docker run -p 8080:8080 jboss/keycloak

Note that Keycloak takes a little while to "warm up". Make sure that it's running before moving on.

Connect to Keycloak

In a new terminal window, use the following command to determine the IP address of the Docker machine:

docker-machine ip RancherOSMachine

Open this IP address on port 8080 in your browser. You should see the standard Keycloak welcome page.