{"id":27161742,"url":"https://github.com/costela/hetzner-ip-floater","last_synced_at":"2025-04-09T00:57:49.091Z","repository":{"id":66874262,"uuid":"146348370","full_name":"costela/hetzner-ip-floater","owner":"costela","description":"Minimalistic floating IP setter for container clusters running on Hetzner Cloud","archived":false,"fork":false,"pushed_at":"2020-04-20T21:25:20.000Z","size":7,"stargazers_count":7,"open_issues_count":0,"forks_count":4,"subscribers_count":4,"default_branch":"master","last_synced_at":"2024-06-20T03:48:16.609Z","etag":null,"topics":["docker","docker-swarm","floating-ip","hetzner","hetzner-cloud"],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/costela.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-08-27T20:09:36.000Z","updated_at":"2023-02-17T08:17:27.000Z","dependencies_parsed_at":"2023-02-23T18:16:14.109Z","dependency_job_id":null,"html_url":"https://github.com/costela/hetzner-ip-floater","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/costela%2Fhetzner-ip-floater","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/costela%2Fhetzner-ip-floater/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/costela%2Fhetzner-ip-floater/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/costela%2Fhetzner-ip-floater/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/costela","download_url":"https://codeload.github.com/costela/hetzner-ip-floater/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247953108,"owners_count":21023947,"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","docker-swarm","floating-ip","hetzner","hetzner-cloud"],"created_at":"2025-04-09T00:57:48.371Z","updated_at":"2025-04-09T00:57:49.071Z","avatar_url":"https://github.com/costela.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"![Docker Automated build](https://img.shields.io/docker/automated/costela/hetzner-ip-floater.svg)\n![Docker Build Status](https://img.shields.io/docker/build/costela/hetzner-ip-floater.svg)\n![Image Info](https://images.microbadger.com/badges/image/costela/hetzner-ip-floater.svg)\n\n# ⚠ This project is unmaintained, but has a \"spiritual successor\" in [hcloud-ip-floater](/costela/hcloud-ip-floater)\n\n# hetzner-ip-floater\n\nMinimalistic floating IP setter for container clusters (currently tested on docker swarm) running on [Hetzner Cloud](https://www.hetzner.com/cloud).\n\n## Usage\n\nThis project should be used as a container. It will run once and update a given floating IP to point to the node currently running it. This can be used to ensure the floating IP will be reassigned upon node failure, by relying on the underlying cluster to redeploy this service on a healthy node.\n\nThis is an example deployment for `docker stack deploy`:\n```yaml\nservices:\n  app:\n    image: costela/hetzner-ip-floater\n    secrets:\n      - hetzner_api_key_for_floating_ip  # set via `docker secret create`\n    environment:\n      API_KEY_FILE: /run/secrets/hetzner_api_key_for_floating_ip\n      TARGET_HOST: '{{ .Node.Hostname }}'  # uses docker swarm's templating to get node name\n      FLOATING_IP_ID: 12345  # taken from Hetzner cloud console\n    deploy:\n      replicas: 1\n```\n\nThis assumes the node's hostnames are the same as their API names, which is the case unless the hostname has been changed after provisioning.\n\n## Other considerations\n\nThe deployment of `hetzner-ip-floater` should be limited to those nodes where the floating IP is locally configured, otherwise incoming trafic will be dropped.\n\nThe same nodes should also be configured as ingress nodes. When using the [default mesh networking](https://docs.docker.com/engine/swarm/ingress/) on docker swarm, this is already the case for all worker nodes.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcostela%2Fhetzner-ip-floater","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcostela%2Fhetzner-ip-floater","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcostela%2Fhetzner-ip-floater/lists"}