rancher/ui-driver-rackhd

Name: ui-driver-rackhd

Owner: Rancher

Description: Machine driver for RackHD

Created: 2016-04-19 18:41:01.0

Updated: 2017-10-13 06:41:41.0

Pushed: 2016-04-23 08:54:49.0

Homepage: null

Size: 7

Language: JavaScript

GitHub Committers

User	Most Recent Commit	# Commits

Other Committers

User	Email	Most Recent Commit	# Commits

README

ui-driver-rackhd

Rancher UI driver for RackHD docker-machine driver

Setup

• Fork this repository into your own account as ui-driver-DRIVERNAME
• DRIVERNAME should be the name of the driver that you would give to docker-machine create --driver, e.g. “mycompany”, “digitalocean”, “vultr”, etc.
• Update the “name” in package.json to match
• You should also update description, URLs, etc, but these aren't strictly required.
• npm install
• bower install

Development

This package contains a small web-server that will serve up the custom driver UI at https://localhost:3000/component.js. You can run this while developing and point the Rancher settings there.

• npm start
• The driver name can be optionally overridden: npm start -- --name=DRIVERNAME
• The compiled files are viewable at https://localhost:3000.
• Note: The development server does not currently automatically restart when files are changed.

Building

For other users to see your driver, you need to build it and host the output on a server accessible from their browsers.

• npm run build
• Copy the contents of the dist directory onto a webserver.
• If your Rancher is configured to use HA or SSL, the server must also be available via HTTPS.
• If your driver is public, GitHub release binaries are a simple hosting choice.

Using

• Add a Machine Driver in Rancher (Admin tab -> Settings -> Machine Drivers)
• Name: Your DRIVERNAME (see above).
• Download URL: The URL for the driver binary (e.g. https://github.com/mycompany/docker-machine-mycompany/releases/download/v1.0.0/docker-machine-driver-mycompany-v1.0.0-linux-amd64.tar.gz)
• Custom UI URL: The URL you uploaded the dist folder to, e.g. https://github.com/mycompany/ui-driver-mycompany/releases/download/v1.0.0/component.js)
• Wait for the driver to become “Active”
• Go to Infrastructure -> Hosts -> Add Host, your driver and custom UI should show up.