Rancher UI for Docker

Installation

To install this component, you will need a working instance of the Rancher Management Server. Instructions to set this up can be found in the Rancher documentation.

For a quick set up, you can run the Rancher Management Server inside a docker container with the following command:

docker run -d --restart=always -p 8080:8080 rancher/server

It is always useful to rename a running Docker container.

docker rename <container-id> rancher

To see the output logs for the running Rancher Management Server container:

docker logs -f rancher

Requirements

  • Your IONOS username and password. Note: This is the same username and password you use to sign in to the DCD (Data Center Designer) environment.
  • A link to the latest release of the docker-machine driver for your platform. These can be found at Github and are available for Mac OS X, Linux, and Windows (all 64-bit). All you need to do is copy the link location, which should look something like https://github.com/profitbricks/docker-machine-driver-profitbricks/releases/download/v1.2.1/docker-machine-driver-profitbricks-v1.2.1-linux-amd64.tar.gz.
  • The built component files for this module hosted on a web server accessible by your browser.

Building and Hosting

To build the component files, clone the ProfitBricks Rancher UI repository on GitHub and run the following commands:

$ npm install
$ bower install
$ npm run build

You will then need to copy the contents of the dist/ directory to your webserver. There should be three files in total as follows:

  • component.css
  • component.js
  • logo.png

Note: If your Rancher is configured to use HA or SSL, the server must also be available via HTTPS.

Installing via the Rancher Management Server UI

  • Go to Machine Drivers (Admin -> Machine Drivers)
  • Click on the Add Machine Driver button and a modal drop down will appear.
  • Enter the URL for the docker-machine driver in the Download URL field.
  • Enter the URL for the UI component driver JS in the Custom UI URL field. This should look something like http://example.com/dist/component.js.
  • Wait for the machine driver to become active.

Note: When creating a host, ensure that the version of Docker being installed is the latest version. To do this, you will need to expand the Advanced Options tab at the bottom of the page and select Latest for the Docker install URL. The URL pointing to the https://releases.rancher.com/install-docker/1.10.sh script, which is specified by default, will not work with the image used to provision the host.

Using

  • Navigate to the Hosts section (Infrastructure -> Hosts)
  • Click on the Add Host button and a new screen will appear that shows a list of hosting providers along the top.
  • Choose ProfitBricks and a new form will appear underneath the selection.
  • You will now be able to customise and create your server that can be managed through the Rancher Management Server.

Support

If you need any help please visit IONOS DevOps Central.

Please submit any bugs, issues, or feature requests to profitbricks/ui-driver-profitbricks.