{"id":13450145,"url":"https://mxschmitt.github.io/ui-driver-hetzner/","last_synced_at":"2025-03-23T16:31:01.147Z","repository":{"id":46007769,"uuid":"119262747","full_name":"mxschmitt/ui-driver-hetzner","owner":"mxschmitt","description":"Rancher UI driver for the Hetzner Cloud docker driver.","archived":false,"fork":true,"pushed_at":"2024-04-07T06:09:18.000Z","size":1304,"stargazers_count":258,"open_issues_count":22,"forks_count":50,"subscribers_count":15,"default_branch":"master","last_synced_at":"2024-11-13T10:37:48.343Z","etag":null,"topics":["docker","hcloud","hetzner","hetzner-cloud","rancher"],"latest_commit_sha":null,"homepage":"https://mxschmitt.github.io/ui-driver-hetzner","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"rancher/ui-driver-skel","license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mxschmitt.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null},"funding":{"github":["mxschmitt"]}},"created_at":"2018-01-28T13:53:57.000Z","updated_at":"2024-11-07T13:47:52.000Z","dependencies_parsed_at":"2023-01-18T10:04:55.673Z","dependency_job_id":null,"html_url":"https://github.com/mxschmitt/ui-driver-hetzner","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mxschmitt%2Fui-driver-hetzner","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mxschmitt%2Fui-driver-hetzner/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mxschmitt%2Fui-driver-hetzner/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mxschmitt%2Fui-driver-hetzner/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mxschmitt","download_url":"https://codeload.github.com/mxschmitt/ui-driver-hetzner/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245130715,"owners_count":20565698,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["docker","hcloud","hetzner","hetzner-cloud","rancher"],"created_at":"2024-07-31T07:00:31.492Z","updated_at":"2025-03-23T16:31:00.771Z","avatar_url":"https://github.com/mxschmitt.png","language":"JavaScript","funding_links":["https://github.com/sponsors/mxschmitt"],"categories":["Rancher 2.0"],"sub_categories":["Cloud Drivers"],"readme":"# Rancher 2 Hetzner Cloud UI Driver\n\n[![Build Status](https://travis-ci.org/mxschmitt/ui-driver-hetzner.svg?branch=master)](https://travis-ci.org/mxschmitt/ui-driver-hetzner)\n\nRancher 2.X UI driver for the [Hetzner Cloud](https://www.hetzner.de/cloud). For the Rancher 1 version check out the readme from the `v1.6` branch which you can find [here](https://github.com/mxschmitt/ui-driver-hetzner/blob/v1.6/README.md).\n\n## Usage\n\n* Add a Machine Driver in Rancher 2 (`Cluster Management` -\u003e `Drivers` -\u003e `Node Drivers`)\n\n| Key | Value |\n| --- | ----- |\n| Download URL | `https://github.com/JonasProgrammer/docker-machine-driver-hetzner/releases/download/3.3.0/docker-machine-driver-hetzner_3.3.0_linux_amd64.tar.gz` |\n| Custom UI URL | `https://storage.googleapis.com/hcloud-rancher-v2-ui-driver/component.js` |\n| Whitelist Domains |  `storage.googleapis.com` |\n\n* Wait for the driver to become \"Active\"\n* Go to Clusters -\u003e Add Cluster, your driver and custom UI should show up.\n\n![Authentication screen](docs/authentication-screen.png)\n![Configuration screen](docs/configuration-screen.png)\n\n## Compatibility\n\nThe following `component.js` is always compatible with the latest Rancher 2.X version:\n\n`https://storage.googleapis.com/hcloud-rancher-v2-ui-driver/component.js`\n\n### Rancher 2.0\n\nUse this `component.js` to support Rancher 2.0 version:\n\n`https://storage.googleapis.com/hcloud-rancher-v2-ui-driver/component-v20.js`\n\n## Tested linux distributions\n\nTo use `Debian` e.g. with a non default Storage Driver, you have to set it manually in the Engine Options of the Node Template in Rancher.\n\n### Recommend\n\n| Image        | Docker Version                     | Docker Storage Driver  |\n|--------------|------------------------------------|------------------------|\n| Ubuntu 18.04 | 18.06                              | overlay2 (default)     |\n| Ubuntu 16.04 | 18.06                              | aufs (default)         |\n| Debian 9     | 18.06                              | overlay2, overlay      |\n| CentOS 7     | 18.06                              | devicemapper (default) |\n| Fedora 27    | not supported (due docker-install) |                        |\n| Fedora 28    | not supported (due docker-install) |                        |\n\n## Development\n\nThis package contains a small web-server that will serve up the custom driver UI at `http://localhost:3000/component.js`. You can run this while developing and point the Rancher settings there.\n* `npm start`\n* The driver name can be optionally overridden: `npm start -- --name=DRIVERNAME`\n* The compiled files are viewable at http://localhost:3000.\n* **Note:** The development server does not currently automatically restart when files are changed.\n\n## Building\n\nFor other users to see your driver, you need to build it and host the output on a server accessible from their browsers.\n\n* `npm run build`\n* Copy the contents of the `dist` directory onto a webserver.\n  * If your Rancher is configured to use HA or SSL, the server must also be available via HTTPS.\n\n## Useful resources\n\n### `Error creating machine: Error running provisioning: ssh command error:`\n\nTry to use `overlay2` and if it does not work `overlay` as `Storage Driver` in the `Engine Options` in the bottom.\n\n### How secure is the `Private Network` feature?\n\n\u003e Traffic between Cloud Servers inside a Network is private and isolated, but not automatically encrypted. We recommend you use TLS or similar protocols to encrypt sensitive traffic.\n\nReference: [Hetzner Cloud documentation](https://wiki.hetzner.de/index.php/CloudServer/en#Is_traffic_inside_Hetzner_Cloud_Networks_encrypted.3F)\n\nThe Rancher traffic between the agents and the Rancher related traffic to the nodes is fully encrypted over HTTPS/TLS.\n\nThe custom application specific traffic is *not* encrypted. You can use e.g. the Weave CNI-Provider for that: https://rancher.com/docs/rancher/v2.x/en/faq/networking/cni-providers/#weave\n\n### Requirements for Private Networks\n\n- Rancher host needs to be in the *same Private Network* as the selected one in the Node template\n- Under the global settings of Rancher the `server-url` needs to be the internal IP of the Private Network (you can find it in the Hetzner Cloud Console). Otherwise the traffic won't go through the Internal network.\n\n### How to close the open ports on the public interface?\n\nYou could use it e.g. in combination with that tool: https://github.com/vitobotta/hetzner-cloud-init\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/mxschmitt.github.io%2Fui-driver-hetzner%2F","html_url":"https://awesome.ecosyste.ms/projects/mxschmitt.github.io%2Fui-driver-hetzner%2F","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/mxschmitt.github.io%2Fui-driver-hetzner%2F/lists"}