Kubernetes用のHetzner vSwitchesのためのAnsibleロール

このAnsibleロールは、Kubernetesクラスタ用のHetzner vSwitchesとサーバーを設定することを可能にします。追加のvSwitchベースのサブネットをサポートしています。

このプロジェクトや著者は、Hetznerとは提携していません。これは、Hetznerのお客様による個人プロジェクトです。

プロジェクトの目標 / 機能

このAnsibleロールを使用すると、Hetznerのベアメタルサーバー上でvSwitchesを簡単に設定できます。さらに、vSwitchベースのサブネットを持っている場合、このロールはvSwitchネットワーク内でサブネットを使用するために必要なすべてのルートとIPルールを設定します。設定は、MetalLBに対応しており、MetalLBベースのHA Kubernetesロードバランサーを使用することができます。

このロールは、公式のHetznerチュートリアルに従って、サーバー上でvSwitchの設定を行います。このロールは、vSwitchを作成したり、HetznerロボットにIPを登録したりすることはありません。

設定

設定するすべてのvSwitchは、vswitchキーの下に定義する必要があります。以下の例は、VLAN ID 4000のvSwitchを設定するための構成の見本です：

vswitches:
  - name: public        # vSwitchの名前、ルーティングテーブルの名前に使用。
    routing_table: 1    # ルーティングテーブルのID。
    vlan: 4000          # vSwitchのVLAN ID。4000-4091がHetznerでサポートされています。
    gateway: 327.0.0.1  # vSwitchにサブネットがある場合、この変数はサブネットのゲートウェイIPアドレスを含む必要があります。
    addresses:          # vSwitchネットワークインターフェースのIPアドレス（ホストごと）
      - "{{ hostvars[inventory_hostname]['ip'] }}/24"
    subnets:            # vSwitch上で使用可能なサブネット（非プライベートネットワークの場合、Hetznerロボットに登録する必要があります）
    - subnet: 327.0.0.0/24

このロールは、この情報を使用してnetplan構成ファイルを書き込みます。