hetzner-k3s 0.4.3 → 0.4.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c3e7bedd3a695b38522a25598d9d0523bee9e5120aea6e76c462ba91dc8f3f12
-  data.tar.gz: d54f24ebe59f8b0354c74fdacff6f747169b288eddb99f070456f147523a07b4
+  metadata.gz: 153385c9fce84159b90d6b77bed3e3afebd3cb0739fbd6de1e4cc91e5f1e130f
+  data.tar.gz: '08a51842b854c2a438012c6fde115520e32fb782524a3ddd4048a772db8aeaa3'
 SHA512:
-  metadata.gz: 36c460db4001ba080ef27dec517c4c44ce853a75935fee7d0fc5e4a13d689a5e812d762ec842a22503ac07d555a24be545293db9bb838ddcb7d27cd1866d9a1e
-  data.tar.gz: 2e8f67ca3c74292b7ad3c3a2098b1a4c8d096b1cb01677e8cc94ae199ee4b0df25eb869d2400b32451da6475a7518c7265cd1b70ec6bb0090e25b76047a03e4e
+  metadata.gz: 9d6ac1e71d783a6b01d77863e30fae972c0983cda9e85dfcaac5fda8da0ea7a33565404aaa8efdd0594185f31c85ebc91cf92cdfe06fd9b92422aaf8c158feee
+  data.tar.gz: 4f93a9eb6635d2c757dfbc1205023e563bfbb564ca0b0f9b839ea4b722f9fc2d7db7978ce4ab7da70d2ce23fd3559a301342f3b222522ac4df0554a9f66317bd

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    hetzner-k3s (0.4.0)
+    hetzner-k3s (0.4.3)
       bcrypt_pbkdf
       ed25519
       http

data/README.md

@@ -2,7 +2,7 @@
 
 This is a CLI tool - based on a Ruby gem - to quickly create and manage Kubernetes clusters in [Hetzner Cloud](https://www.hetzner.com/cloud) using the lightweight Kubernetes distribution [k3s](https://k3s.io/) from [Rancher](https://rancher.com/).
 
-Hetzner Cloud is an awesome cloud provider which offers a truly great service with the best performance/cost ratio in the market. I highly recommend them if European locations (Germany and Finland) are OK for your projects (the Nuremberg data center has decent latency for US users as well). With Hetzner's Cloud Controller Manager and CSI driver you can provision load balancers and persistent volumes very easily.
+Hetzner Cloud is an awesome cloud provider which offers a truly great service with the best performance/cost ratio in the market. With Hetzner's Cloud Controller Manager and CSI driver you can provision load balancers and persistent volumes very easily.
 
 k3s is my favorite Kubernetes distribution now because it uses much less memory and CPU, leaving more resources to workloads. It is also super quick to deploy because it's a single binary.
 
@@ -38,7 +38,7 @@ This will install the `hetzner-k3s` executable in your PATH.
 Alternatively, if you don't want to set up a Ruby runtime but have Docker installed, you can use a container. Run the following from inside the directory where you have the config file for the cluster (described in the next section):
 
 ```bash
-docker run --rm -it -v ${PWD}:/cluster -v ${HOME}/.ssh:/tmp/.ssh vitobotta/hetzner-k3s:v0.4.2 create-cluster --config-file /cluster/test.yaml
+docker run --rm -it -v ${PWD}:/cluster -v ${HOME}/.ssh:/tmp/.ssh vitobotta/hetzner-k3s:v0.4.4 create-cluster --config-file /cluster/test.yaml
 ```
 
 Replace `test.yaml` with the name of your config file.
@@ -86,7 +86,8 @@ If you set `masters.instance_count` to 1 then the tool will create a non highly
 
 You can specify any number of worker node pools for example to have mixed nodes with different specs for different workloads.
 
-At the moment Hetzner Cloud has three locations: two in Germany (`nbg1`, Nuremberg and `fsn1`, Falkensteing) and one in Finland (`hel1`, Helsinki).
+At the moment Hetzner Cloud has four locations: two in Germany (`nbg1`, Nuremberg and `fsn1`, Falkensteing), one in Finland (`hel1`, Helsinki) and one in the USA (`ash`, Ashburn, Virginia). Please note that the Ashburn, Virginia location has just
+been announced and it's limited to AMD instances for now.
 
 For the available instance types and their specs, either check from inside a project when adding a server manually or run the following with your Hetzner token:
 
@@ -241,6 +242,10 @@ I recommend that you create a separate Hetzner project for each cluster, because
 
 ## changelog
 
+- 0.4.4
+  - Add support for the new Ashburn, Virginia (USA) location
+  - Automatically use a placement group so that the instances are all created on different physical hosts for high availability
+
 - 0.4.3
   - Fix an issue with SSH key creation
 

data/bin/build.sh

@@ -6,9 +6,9 @@ set -e
 
 IMAGE="vitobotta/hetzner-k3s"
 
-docker build -t ${IMAGE}:v0.4.3 \
+docker build -t ${IMAGE}:v0.4.4 \
   --platform=linux/amd64 \
-  --cache-from ${IMAGE}:v0.4.2 \
+  --cache-from ${IMAGE}:v0.4.3 \
   --build-arg BUILDKIT_INLINE_CACHE=1 .
 
-docker push vitobotta/hetzner-k3s:v0.4.2
+docker push vitobotta/hetzner-k3s:v0.4.4

data/lib/hetzner/infra/network.rb

@@ -5,7 +5,8 @@ module Hetzner
       @cluster_name = cluster_name
     end
 
-    def create
+    def create(location:)
+      @location = location
       puts
 
       if network = find_network
@@ -38,7 +39,7 @@ module Hetzner
 
     private
 
-      attr_reader :hetzner_client, :cluster_name
+      attr_reader :hetzner_client, :cluster_name, :location
 
       def network_config
         {
@@ -47,7 +48,7 @@ module Hetzner
           subnets: [
             {
               ip_range: "10.0.0.0/16",
-              network_zone: "eu-central",
+              network_zone: (location ? "us-east" : "eu-central"),
               type: "cloud"
             }
           ]

data/lib/hetzner/infra/placement_group.rb

@@ -0,0 +1,55 @@
+module Hetzner
+  class PlacementGroup
+    def initialize(hetzner_client:, cluster_name:)
+      @hetzner_client = hetzner_client
+      @cluster_name = cluster_name
+    end
+
+    def create
+      puts
+
+      if (placement_group = find_placement_group)
+        puts "Placement group already exists, skipping."
+        puts
+        return placement_group["id"]
+      end
+
+      puts "Creating placement group..."
+
+      response = hetzner_client.post("/placement_groups", placement_group_config).body
+
+      puts "...placement group created."
+      puts
+
+      JSON.parse(response)["placement_group"]["id"]
+    end
+
+    def delete
+      if (placement_group = find_placement_group)
+        puts "Deleting placement group..."
+        hetzner_client.delete("/placement_groups", placement_group["id"])
+        puts "...placement group deleted."
+      else
+        puts "Placement group no longer exists, skipping."
+      end
+
+      puts
+    end
+
+    private
+
+      attr_reader :hetzner_client, :cluster_name
+
+      def placement_group_config
+        {
+          name: cluster_name,
+          type: "spread"
+        }
+      end
+
+      def find_placement_group
+        hetzner_client.get("/placement_groups")["placement_groups"].detect{ |placement_group| placement_group["name"] == cluster_name }
+      end
+
+  end
+end

data/lib/hetzner/infra/server.rb

@@ -5,7 +5,7 @@ module Hetzner
       @cluster_name = cluster_name
     end
 
-    def create(location:, instance_type:, instance_id:, firewall_id:, network_id:, ssh_key_id:)
+    def create(location:, instance_type:, instance_id:, firewall_id:, network_id:, ssh_key_id:, placement_group_id:)
       puts
 
       server_name = "#{cluster_name}-#{instance_type}-#{instance_id}"
@@ -36,7 +36,8 @@ module Hetzner
         labels: {
           cluster: cluster_name,
           role: (server_name =~ /master/ ? "master" : "worker")
-        }
+        },
+        placement_group: placement_group_id
       }
 
       response = hetzner_client.post("/servers", server_config).body

data/lib/hetzner/k3s/cli.rb

@@ -193,7 +193,7 @@ module Hetzner
 
         def validate_location
           return if locations.empty? && !valid_token?
-          errors << "Invalid location - available locations: nbg1 (Nuremberg, Germany), fsn1 (Falkenstein, Germany), hel1 (Helsinki, Finland)" unless locations.include? configuration.dig("location")
+          errors << "Invalid location - available locations: nbg1 (Nuremberg, Germany), fsn1 (Falkenstein, Germany), hel1 (Helsinki, Finland) or ash (Ashburn, Virginia, USA)" unless locations.include? configuration.dig("location")
         end
 
         def find_available_releases

data/lib/hetzner/k3s/cluster.rb

@@ -11,6 +11,7 @@ require_relative "../infra/network"
 require_relative "../infra/ssh_key"
 require_relative "../infra/server"
 require_relative "../infra/load_balancer"
+require_relative "../infra/placement_group"
 
 require_relative "../k3s/client_patch"
 
@@ -89,6 +90,11 @@ class Cluster
       master_instance_type = masters_config["instance_type"]
       masters_count = masters_config["instance_count"]
 
+      placement_group_id = Hetzner::PlacementGroup.new(
+        hetzner_client: hetzner_client,
+        cluster_name: cluster_name
+      ).create
+
       firewall_id = Hetzner::Firewall.new(
         hetzner_client: hetzner_client,
         cluster_name: cluster_name
@@ -97,7 +103,7 @@ class Cluster
       network_id = Hetzner::Network.new(
         hetzner_client: hetzner_client,
         cluster_name: cluster_name
-      ).create
+      ).create(location: location)
 
       ssh_key_id = Hetzner::SSHKey.new(
         hetzner_client: hetzner_client,
@@ -113,7 +119,8 @@ class Cluster
           instance_id: "master#{i+1}",
           firewall_id: firewall_id,
           network_id: network_id,
-          ssh_key_id: ssh_key_id
+          ssh_key_id: ssh_key_id,
+          placement_group_id: placement_group_id
         }
       end
 
@@ -136,7 +143,8 @@ class Cluster
             instance_id: "pool-#{worker_node_pool_name}-worker#{i+1}",
             firewall_id: firewall_id,
             network_id: network_id,
-            ssh_key_id: ssh_key_id
+            ssh_key_id: ssh_key_id,
+            placement_group_id: placement_group_id
           }
         end
       end
@@ -158,6 +166,11 @@ class Cluster
     end
 
     def delete_resources
+      Hetzner::PlacementGroup.new(
+        hetzner_client: hetzner_client,
+        cluster_name: cluster_name
+      ).delete
+
       Hetzner::LoadBalancer.new(
         hetzner_client: hetzner_client,
         cluster_name: cluster_name

data/lib/hetzner/k3s/version.rb

@@ -1,5 +1,5 @@
 module Hetzner
   module K3s
-    VERSION = "0.4.3"
+    VERSION = "0.4.4"
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: hetzner-k3s
 version: !ruby/object:Gem::Version
-  version: 0.4.3
+  version: 0.4.4
 platform: ruby
 authors:
 - Vito Botta
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2021-10-17 00:00:00.000000000 Z
+date: 2021-11-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: thor
@@ -140,6 +140,7 @@ files:
 - lib/hetzner/infra/firewall.rb
 - lib/hetzner/infra/load_balancer.rb
 - lib/hetzner/infra/network.rb
+- lib/hetzner/infra/placement_group.rb
 - lib/hetzner/infra/server.rb
 - lib/hetzner/infra/ssh_key.rb
 - lib/hetzner/k3s/cli.rb