{"id":10358,"date":"2024-12-01T12:00:00","date_gmt":"2024-12-01T10:00:00","guid":{"rendered":"https:\/\/u-labs.de\/portal\/?p=10358"},"modified":"2024-12-24T19:06:13","modified_gmt":"2024-12-24T17:06:13","slug":"terraform-vserver-hetzner-cloud-automatisiert","status":"publish","type":"post","link":"https:\/\/u-labs.de\/portal\/terraform-vserver-hetzner-cloud-automatisiert\/","title":{"rendered":"Mit Terraform automatisch virtuelle Server in der Hetzner Cloud anlegen"},"content":{"rendered":"

Hetzner bietet mit seiner Cloud<\/em> virtuelle Server als lokale, sicherere Alternative gegen\u00fcber den einschl\u00e4gigen Anbietern aus den USA. Wie bei jedem Hoster kann man sich eine VM in der Web-Oberfl\u00e4che erstellen. Doch wer sich mit Automatisierung und damit z.B. Infrastruktur als Code (IaC) besch\u00e4ftigt, m\u00f6chte das gar nicht – sondern stattdessen die Ausstattung sowie Konfiguration in einer Datei festlegen, womit sich ein fertiges System per Knopfdruck einrichten l\u00e4sst. Das erm\u00f6glicht Terraform und bietet einige Vorteile: Ein identisches Testsystem beispielsweise l\u00e4sst sich mit wenig Aufwand erzeugen. Wie man Terraform zusammen mit der Hetzner Cloud verwendet, zeigt dieser Artikel.<\/p>\n

Zugriffsschl\u00fcssel f\u00fcr Terraform in der Hetzner Cloud Konsole anlegen<\/h2>\n

In der Hetzner Cloud-Konsole<\/a> \u00f6ffnet ihr das gew\u00fcnschte Projekt, f\u00fcr erste Tests gen\u00fcgt auch das standardm\u00e4\u00dfig vorhandene. Links in der Navigation auf den Schl\u00fcssel, der zum Bereich Sicherheit<\/strong> f\u00fchrt. Der Reiter API-Tokens<\/strong> erm\u00f6glicht es, einen Authentifizierungsschl\u00fcssel pro externer Anwendung zu erstellen. Dar\u00fcber kann diese auf alle Ressourcen in dem Projekt zugreifen, ihr solltet diesen also wie ein Passwort behandeln. Standardm\u00e4\u00dfig sind keine vorhanden, ihr m\u00fcsst also zun\u00e4chst einen \u00fcber den roten Knopf rechts oben erstellen. Ein Token pro Anwendung ist zu empfehlen. <\/p>\n

\n
\"\"<\/a><\/figure>\n<\/div>\n

Da Terraform ja Ressourcen wie z.B. Server anlegen soll, werden Schreibrechte ben\u00f6tigt. Der Lesende Zugriff macht an dieser Stelle wenig Sinn und ist f\u00fcr andere Anwendungszwecke vorgesehen. Das Beschreibungsfeld ist frei w\u00e4hlbar und dient zur Zuordnung.<\/p>\n

\n
\"\"<\/a><\/figure>\n<\/div>\n

Das generierte Token ben\u00f6tigen wir im n\u00e4chsten Schritt f\u00fcr Terraform.<\/p>\n

Anlegen eines Servers mit SSH-Schl\u00fcssel per Terraform<\/h2>\n

Als einfaches Beispiel f\u00fcr den Einstieg soll ein kleiner virtueller Server erstellt werden. Um bequem und sicher darauf zugreifen zu k\u00f6nnen, hinterlegen wir per Terraform unseren \u00f6ffentlichen SSH-Schl\u00fcssel. Da die IP-Adresse von Hetzner zugeteilt wird, soll uns die Software zudem nach der Erstellung dessen IPv4-Adresse ausgeben. Die verf\u00fcgbaren Server kann man \u00fcber die Web-Oberfl\u00e4che einsehen, nachdem man in einem Projekt oben auf den roten Server hinzuf\u00fcgen<\/strong> Knopf gedr\u00fcckt hat. Obwohl wir den Server ja eben nicht per Hand zusammen klicken m\u00f6chten, hilft dies f\u00fcr eine \u00dcbersicht der Server. In diesem Beispiel entscheide ich mich f\u00fcr CPX11<\/strong>, der 0,007 \u20ac pro Stunde bzw. 4,58 \u20ac im gesamten Monat kostet.<\/p>\n

\n
\"\"<\/a><\/figure>\n<\/div>\n

Das Kommandozeilenwerkzeug hcloud<\/strong> empfehle ich daf\u00fcr nicht. Es zeigt zwar die Ausstattung der vServer an, jedoch nicht den Preis – diesen erf\u00e4hrt man nur \u00fcber die Web-Oberfl\u00e4che.<\/p>\n

$ .\/hcloud server-type list\nID   NAME    CORES   CPU TYPE    ARCHITECTURE   MEMORY     DISK     STORAGE TYPE\n1    cx11    1       shared      x86            2.0 GB     20 GB    local\n3    cx21    2       shared      x86            4.0 GB     40 GB    local\n5    cx31    2       shared      x86            8.0 GB     80 GB    local<\/code><\/pre>\n
Um mit Terraform zu beginnen, legt ihr zun\u00e4chst einen Ordner als Arbeitsverzeichnis an. Der Code befindet sich in .tf<\/strong> Dateien mit frei w\u00e4hlbarem Name. Meist gibt es Konventionen und in gr\u00f6\u00dferen Projekten macht es auch durchaus Sinn, die Inhalte auf mehrere Dateien aufzuteilen. F\u00fcr den ersten Einstieg kann darauf verzichtet werden und man arbeitet in einer einzigen Datei, die ich main.tf<\/strong> genannt habe. <\/p>\n
Zuerst wird der Provider geladen. Er ist die Schnittstelle zwischen Terraform und Hetzner. Es gibt auch lokale Provider, die etwa KVM oder andere Virtualisierungsl\u00f6sungen nutzen. Da es sich bei Hetzner um einen Cloudanbieter handelt, wird das zuvor erstellte API-Token ben\u00f6tigt, um Zugriff auf unsere dortigen Projekte zu gew\u00e4hren:<\/p>\n
terraform {\n  required_providers {\n    hcloud = {\n      source = "hetznercloud\/hcloud"\n    }\n  }\n  required_version = ">= 0.38.2"\n}\n\nprovider "hcloud" {\n  token = "xxx"\n}<\/code><\/pre>\n
Spannender ist der Hauptteil, in dem wir zuerst eine Ressource f\u00fcr den SSH-Schl\u00fcssel anlegen. Dieser muss auf eurem lokalen System existieren. Ich habe f\u00fcr die Demo-Server einen eigenen Schl\u00fcssel erstellt. Der test01<\/strong> genannte hcloud_server<\/strong> bildet unsere VM ab. Sie bekommt einen Name, \u00fcber den wir ihn verwalten k\u00f6nnen und auch \u00fcbers Web wieder finden. server_type<\/strong> ist das zuvor per Web-Konsole ermittelte Paket, anhand dessen sowohl die gebotene Leistung, als auch der zu zahlende Preis bestimmt werden. Mit datacenter<\/strong> geben wir den Standort an, image<\/strong> definiert, welches Betriebssystemabbild der Server installiert bekommt. Wie ihr diese ermittelt und \u00e4ndert, zeigt der folgende Abschnitt noch ausf\u00fchrlicher. <\/p>\n
Die zwei unteren output<\/strong> sind f\u00fcr die Funktion unwichtig. Sie sorgen nur daf\u00fcr, dass uns Terraform nach der Erstellung den Status sowie die \u00f6ffentliche IP-Adresse des Servers ausgibt.<\/p>\n
resource "hcloud_ssh_key" "key" {\n  name = "dani-pc_ansible-nopw"\n  public_key = file("~\/.ssh\/id_rsa_ansible_nopassword.pub")\n}\nresource "hcloud_server" "test01" {\n  name = "terraform-testserver01"\n  server_type = "cpx11"\n  datacenter = "fsn1-dc14"\n\n  image = "ubuntu-22.04"\n  ssh_keys = [hcloud_ssh_key.key.id]\n}\n\noutput "ip" {\n    value = hcloud_server.test01.ipv4_address\n}\noutput "status" {\n    value = hcloud_server.test01.status\n}<\/code><\/pre>\n
$ terraform init\n\nInitializing the backend...\n\nInitializing provider plugins...\n- Reusing previous version of hetznercloud\/hcloud from the dependency lock file\n- Using previously-installed hetznercloud\/hcloud v1.38.2\n\nTerraform has been successfully initialized!<\/code><\/pre>\n
Als n\u00e4chstes k\u00f6nnen wir die \u00c4nderungen mit terraform apply<\/strong> anwenden. Der Befehl zeigt euch zun\u00e4chst eine \u00dcbersicht, welche Ressourcen (Objekte) angelegt werden, damit man dies \u00fcberpr\u00fcfen kann. Vor allem bei produktiven Systemen ist dies wichtig, um ungewollte \u00c4nderungen zu verhindern. <\/p>\n
\n
\"\"<\/a><\/figure>\n<\/div>\n
Anschlie\u00dfend durch Eingabe von yes<\/strong> best\u00e4tigen und Terraform beginnt mit der Erstellung. Die Erstellung einer VM ohne weitere Konfiguration ben\u00f6tigt in meinen Tests rund 14 Sekunden. Abschlie\u00dfend informiert das Werkzeug, dass es zwei Objekte (den virtuellen Server sowie SSH-Schl\u00fcssel) angelegt hat:<\/p>\n
\n
\"\"<\/a><\/figure>\n<\/div>\n
Au\u00dferdem gibt das Programm unsere vorher definierten Ausgaben an. Sie zeigen uns neben der vom Hoster zugewiesenen IP-Adresse den Status der VM. Da sie l\u00e4uft und bereit ist, l\u00e4sst sich nun eine SSH-Verbindung mit dem zuvor angelegten Schl\u00fcssel erzeugen. Die frisch erstellte Maschine erscheint in der Hetzner-Konsole, wie jeder andere gemietete Server auch, den man beispielsweise von Hand \u00fcber die Web-Oberfl\u00e4che zusammen klickt:<\/p>\n
\n
\"\"<\/a><\/figure>\n<\/div>\n
Der Status wird in terraform.tfstate<\/strong> gespeichert. F\u00fchrt man den Befehl ein zweites Mal aus, wird Terraform No changes<\/em> anzeigen und daher nicht zur Best\u00e4tigung auffordern. Gibt es Ver\u00e4nderungen an den .tf Dateien, werden nur Abweichungen zur letzten Konfiguration (z.B. ein hinzugef\u00fcgter SSH-Sch\u00fcssel) erstellt bzw. angepasst.<\/p>\n
Image und Datacenter ermitteln\/\u00e4ndern<\/h2>\n
Kommandozeilenwerkzeug hcloud einrichten<\/h3>\n
Die verf\u00fcgbaren Lokationen sowie Betriebssystemabbilder lassen sich nicht \u00fcber die Web-Oberfl\u00e4che einsehen – zumindest nicht in der Form, wie wir es f\u00fcr Terraform ben\u00f6tigen. Hier hilft das hcloud Kommandozeilenwerkzeug<\/a>. Es ist daf\u00fcr gedacht, s\u00e4mtliche Ressourcen in der Hetzner-Cloud \u00fcber die Kommandozeile zu verwalten. Die verwendeten Bezeichnungen sind identisch zu Terraform, da deren Provider schlussendlich die gleiche Schnittstelle aufruft. \u00dcber die oben verlinkten Releases sucht ihr zur Installation nach dem aktuellsten Paket f\u00fcr Linux 386, ladet es herunter und entpackt das Archiv.<\/p>\n
$ wget https:\/\/github.com\/hetznercloud\/cli\/releases\/download\/v1.33.1\/hcloud-linux-386.tar.gz\n$ tar -xf hcloud-linux-386.tar.gz hcloud\n$ .\/hcloud version\nhcloud 1.33.1<\/code><\/pre>\n
Damit wird die Bin\u00e4rdatei im aktuellen Arbeitsverzeichnis entpackt und kann mit .\/hcloud<\/strong> aufgerufen werden. F\u00fcr das erste Testprojekt ist das v\u00f6llig ausreichend, wer \u00f6fter damit arbeitet, verschiebt sie stattdessen lieber in \/usr\/local\/bin<\/strong>. So ist sie global auf dem gesamten System verf\u00fcgbar und man hat das Werkzeug nicht in den Terraform Quellcode-Dateien. Einmalig muss es in jedem Fall mit dem gew\u00fcnschten Projekt verkn\u00fcpft werden:<\/p>\n
.\/hcloud context create ul-demo<\/code><\/pre>\n
Hier ist ul-demo<\/strong> der selbst gew\u00e4hlte Name des Projektes. Um Zugriff zu erhalten, muss hier nochmals das am Anfang angelegte API-Token angegeben werden.<\/p>\n
Verf\u00fcgbare Rechenzentren und Abbilder mit hcloud ermitteln<\/h3>\n
Ein datacenter<\/strong> ist ein konkretes Rechenzentrum. Es ist wiederum einer Lokation zugeordnet. In welchem Land sich diese befindet, geht meist aus der Beschreibung hervor. Alternativ kann man sich die Lokationen auch auflisten, dort werden Stadt und Land noch einmal detailliert aufgelistet. Das im Beispiel verwendete fsn1-dc14<\/strong> befindet sich also in Falkenstein (Deutschland).<\/p>\n
$ .\/hcloud datacenter list\nID   NAME        DESCRIPTION                   LOCATION\n2    nbg1-dc3    Nuremberg 1 virtual DC 3      nbg1\n3    hel1-dc2    Helsinki 1 virtual DC 2       hel1\n4    fsn1-dc14   Falkenstein 1 virtual DC 14   fsn1\n5    ash-dc1     Ashburn virtual DC 1          ash\n6    hil-dc1     Hillsboro virtual DC 1        hil\n\n.\/hcloud location list\nID   NAME   DESCRIPTION             NETWORK ZONE   COUNTRY   CITY\n1    fsn1   Falkenstein DC Park 1   eu-central     DE        Falkenstein\n2    nbg1   Nuremberg DC Park 1     eu-central     DE        Nuremberg\n3    hel1   Helsinki DC Park 1      eu-central     FI        Helsinki\n4    ash    Ashburn, VA             us-east        US        Ashburn, VA\n5    hil    Hillsboro, OR           us-west        US        Hillsboro, OR<\/code><\/pre>\n
Die verf\u00fcgbaren Abbilder lassen sich per image list<\/strong> ausgeben. Derzeit sind 56 verf\u00fcgbar, aufgrund der L\u00e4nge habe ich die Liste gek\u00fcrzt. M\u00f6glicherweise von euch angelegte Snapshots erscheinen darin \u00fcbrigens ebenfalls.<\/p>\n
$ .\/hcloud image list\nID          TYPE       NAME                 DESCRIPTION                                         ARCHITECTURE   IMAGE SIZE   DISK SIZE   CREATED                         DEPRECATED\n3           system     centos-7             CentOS 7                                            x86            -            5 GB        Mon Jan 15 12:34:45 CET 2018    -\n168855      system     ubuntu-18.04         Ubuntu 18.04                                        x86            -            5 GB        Wed May  2 13:02:30 CEST 2018   -\n5924233     system     debian-10            Debian 10                                           x86            -            5 GB        Mon Jul  8 08:35:48 CEST 2019   -\n...<\/code><\/pre>\n
Fazit<\/h3>\n
Hetzner bietet als deutscher Anbieter ein hinsichtlich Datenschutz und Sicherheit attraktiveres Angebot gegen\u00fcber den gro\u00dfen ausl\u00e4ndischen Cloudanbietern, die \u00fcberwiegend aus den USA stammen. Wie \u00fcblich zahlt man die Flexibilit\u00e4t von Servern in der Cloud mit einem entsprechenden Aufpreis. Wer den bereit ist zu zahlen, kann in Kombination mit Terraform sehr einfach und schnell vollautomatisiert seine Infrastruktur anlegen – oder eben mit dem entsprechenden Provider lokal nutzen. Denn Terraform selbst ist vielf\u00e4ltig, neben verschiedenen Cloudanbietern werden auch zahlreiche On-Prem Plattformen wie VMWare, Proxmox, KVM und weitere unterst\u00fctzt.<\/p>\n","protected":false},"excerpt":{"rendered":"
Hetzner bietet mit seiner Cloud virtuelle Server als lokale, sicherere Alternative gegen\u00fcber den einschl\u00e4gigen Anbietern aus den USA. Wie bei jedem Hoster kann man sich eine VM in der Web-Oberfl\u00e4che erstellen. Doch wer sich mit Automatisierung und damit z.B. Infrastruktur als Code (IaC) besch\u00e4ftigt, m\u00f6chte das gar nicht – sondern stattdessen die Ausstattung sowie Konfiguration …<\/p>\n","protected":false},"author":5,"featured_media":14268,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[391],"tags":[1109],"class_list":["post-10358","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-linux-server","tag-terraform"],"_links":{"self":[{"href":"https:\/\/u-labs.de\/portal\/wp-json\/wp\/v2\/posts\/10358","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/u-labs.de\/portal\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/u-labs.de\/portal\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/u-labs.de\/portal\/wp-json\/wp\/v2\/users\/5"}],"replies":[{"embeddable":true,"href":"https:\/\/u-labs.de\/portal\/wp-json\/wp\/v2\/comments?post=10358"}],"version-history":[{"count":8,"href":"https:\/\/u-labs.de\/portal\/wp-json\/wp\/v2\/posts\/10358\/revisions"}],"predecessor-version":[{"id":14269,"href":"https:\/\/u-labs.de\/portal\/wp-json\/wp\/v2\/posts\/10358\/revisions\/14269"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/u-labs.de\/portal\/wp-json\/wp\/v2\/media\/14268"}],"wp:attachment":[{"href":"https:\/\/u-labs.de\/portal\/wp-json\/wp\/v2\/media?parent=10358"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/u-labs.de\/portal\/wp-json\/wp\/v2\/categories?post=10358"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/u-labs.de\/portal\/wp-json\/wp\/v2\/tags?post=10358"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}