Zurück zum Hub

cargo.ayedo.cloud/ayedo/hcloud/vpc 0.0.12 generic
polycrate block pull cargo.ayedo.cloud/ayedo/hcloud/vpc:0.0.12

hcloud VPC (Virtual Private Cloud)

Dieser Block verwaltet eine VPC (Virtual Private Cloud) innerhalb eines Hetzner Projektes. Es ist möglich, Firewalls, Netzwerke, Loadbalancer, Server und Placement Groups anzulegen und miteinander zu verknüpfen.

Dieser Block verwaltet ein Hetzner Projekt vollständig. Manuelle Änderungen außerhalb dieses Blockes vorzunehmen kann ungewünschte Nebeneffekte haben.

Dieser Block generiert bei Installation ein Inventory auf Basis des Hetzner Cloud Dynamic Inventory für Ansible, welches folgendermaßen von anderen Blöcken referenziert werden kann:

blocks:
  - name: vpc
    from: cargo.ayedo.cloud/ayedo/hcloud/vpc
  - name: second-block
    inventory:
      from: vpc

Nach dem Anlegen der Server schreibt install zusätzlich eine statische inventory.yml in das Workspace-Root. Der Hostname ist {node_defaults.nodename.prefix}-{node.name} (im Workspace der Projektname plus Node-Name). all.vars.primary_ip ist die private IP des ersten Nodes mit Label k8s=controlplane. Gruppen heißen k8s_<wert> und entstehen aus dem Label k8s.

all:
  vars:
    primary_ip: 10.11.3.2
    primary_interface: eth0
  hosts:
    tng-aucoteam-controlplane-1:
      ansible_host: 162.55.177.94
      ansible_user: "sysops"
      ansible_ssh_port: 4422
      ansible_python_interpreter: "/usr/bin/python3"
      ansible_become: "yes"
      internal_ip: 10.11.3.2
      internal_interface: enp7s0
      public_ip: 162.55.177.94
      public_interface: eth0
  children:
    k8s_controlplane:
      hosts:
        tng-aucoteam-controlplane-1:

Schnittstellennamen stehen in config.inventory (public_interface, internal_interface, primary_interface).

Polycrate 0.60 bringt hetzner.hcloud 6.3.0 mit. Die Collection liest nach dem Anlegen einer VM noch server.datacenter.location, das die Hetzner-API nicht mehr liefert. Im Workspace-Root eine Dockerfile.poly anlegen, die hetzner.hcloud >= 7 über die mitgelieferte Collection installiert. polycrate run baut das Image automatisch (--build ist Standard).

Changelog

  • 0.0.14: Actions wieder nur ansible-playbook; hetzner.hcloud >= 7 gehört ins Workspace-Image (Dockerfile.poly)
  • 0.0.13: hetzner.hcloud 7.x wird neben dem Playbook installiert; die mitgelieferte 6.3.0 aus dem Image wird ignoriert
  • 0.0.12: Actions installieren hetzner.hcloud >= 7.0, damit Server ohne Datacenter-Feld angelegt werden können
  • 0.0.11: install schreibt inventory.yml ins Workspace
  • 0.0.10: Fixes
  • Pfad zum SSH Public Key in der Install-Routine korrigiert
  • 0.0.9: Fixes
  • ssh default user von root auf sysops geändert.
  • 0.0.8: Fixes
  • Labels werden jetzt korrekt gemerged
  • 0.0.7: Fixes
  • Die action uninstall löscht keine Server, Loadbalancer oder Netzwerke.
  • 0.0.6: Fixes
  • Die action uninstall löscht keine Server, wenn ein Wert für config.node_defaults.nodename.prefix gesetzt wurde.
  • Wenn ein Loadbalancer nachträglich durch den Block ayedo/k8s/hcloud-ccm angelegt wurde, brach die uninstall action beim entfernen des Netzwerkes ab.
  • Wurde der Wert für ein Netzwerk auf delete_protection: true gesetzt, wurde das Netzwerk bei einem uninstall nicht gelöscht. Die delete_protection für Netzwerke hat ab diesem Fix nur Auswirkung auf die Hetzner Cloud Console und wird vom Skript während der Ausführng der uninstall action ignoriert.
  • Die uninstall action zeigt jetzt nach Durchführung der deinstallation eine Übersicht über noch vorhandenen Netzwerke, Loadbalancer oder Volumes an.
  • 0.0.5: Fixes
  • Installation schlägt fehl, weil für config.node_defaults kein Default gesetzt war
  • 0.0.4: Fixes:
  • Installation schlägt fehl, wenn keine labels gesetzt wurden.
  • config.node_default.labels wurde nicht berücksichtigt.
  • config.node_default.enabled wurde entfernt. Standardmäßig ist der Wert für alle nodes 'true' und kann nur über einzelne nodes config.nodes[].enabled angepasst werden.
  • config.node_defaults.networks wurde nicht berücksichtigt.
  • config.node_defaults.nodename.prefix hinzugefügt.
  • 0.0.3: Vorinstallierte apt und python Pakete reduziert, Docs
  • 0.0.2: Netzwerke sind konfigurierbar
  • 0.0.1: initiale Version

Beispiel

ssh_port: &ssh_port 22022
ssh_user: &ssh_user robot
hcloud_token: &hcloud_token YOUR_TOKEN
blocks:
  - name: vpc
    from: cargo.ayedo.cloud/ayedo/hcloud/vpc
    config:
      token: *hcloud_token
      ssh:
        port: *ssh_port
        user: *ssh_user
      nodes:
        - name: node-1
          enabled: true
          labels:
            - key: group
              value: docker
          networks:
            - default

Actions

install

Installiert die konfigurierten Komponenten in ein Hetzner Cloud Projekt.

polycrate run vpc install