Ein Muster, das wir bei Nine h\u00e4ufig beobachten, ist, dass viele unserer Kund*innen Webanwendungen betreiben \u2013 etwa Content-Management-Systeme, Webshops, Dashboards oder eigene APIs. Solche Anwendungen setzen typischerweise auf eine bew\u00e4hrte Kombination aus Infrastrukturdiensten: eine Datenbank zur Datenspeicherung, eine Cache-Schicht f\u00fcr schnelle Performance und einen Server, auf dem die Anwendungslogik l\u00e4uft.<\/p>\n\n\n\n
Unser Szenario spiegelt genau diesen Praxisfall wider. Wir zeigen hier nicht einfach nur das Aufsetzen einer VM oder stellen eine API zur Schau (na gut, vielleicht ein bisschen \ud83d\ude09), sondern stellen typische Komponenten bereit, die in echten Produktionsumgebungen vorkommen:<\/p>\n\n\n\n
Ziel ist es, zu zeigen, wie Sie diese Dienste einfach und praxisnah mit unserer API und unseren Tools bereitstellen und verwalten k\u00f6nnen \u2013 und zwar so, dass das Ganze Ihre Arbeitslast und Herausforderungen widerspiegelt.<\/p>\n\n\n\n
Als Head of Engineering bei Nine<\/a> durfte ich miterleben, wie unsere Plattform kontinuierlich weiterentwickelt wurde, um Entwickler*innen leistungsstarke Werkzeuge zur Infrastrukturautomatisierung zu bieten. Eines der wichtigsten Tools dabei ist unsere \u00f6ffentliche API<\/strong>, mit der Sie Ihre Infrastruktur programmatisch bereitstellen und steuern k\u00f6nnen.<\/p>\n\n\n\n Dieser Blogpost dient nicht als reines Tutorial: Er erz\u00e4hlt die Geschichte, wie aus einem leeren Blatt eine funktionsf\u00e4hige, produktions\u00e4hnliche Umgebung entsteht. Wir erstellen und validieren dabei folgende Infrastrukturkomponenten:<\/p>\n\n\n\n Jeder Schritt wird nicht nur erkl\u00e4rt, sondern auch hinsichtlich der Entscheidungen und Befehle kontextuell eingeordnet. Zielgruppe sind Entwickler*innen oder DevOps-Engineers, die noch nicht mit unserer API, Ansible oder unserem CLI-Tool `nctl` vertraut sind.<\/p>\n\n\n\n Bevor wir ins Technische eintauchen, kurz zu unserem zentralen Werkzeug, das alles zusammenh\u00e4lt: Ansible<\/strong>.<\/p>\n\n\n\n Ansible ist ein beliebtes Automatisierungstool f\u00fcr Konfigurationsmanagement, Applikations-Deployment und allgemeine Infrastruktur-Orchestrierung. Wieso ist es so beliebt?<\/p>\n\n\n\n Ansible passt hervorragend zu Szenarien wie dem unseren, in dem nicht nur Infrastruktur erstellt, sondern auch anschliessend konfiguriert und validiert werden soll.<\/p>\n\n\n\n Vielleicht kennen Sie bereits OpenTofu oder Terraform \u2013 diese Tools \u00fcberzeugen bei der deklarativen Verwaltung von Infrastrukturzust\u00e4nden. Da wir eine \u00f6ffentlich zug\u00e4ngliche API anbieten, ist sie vollst\u00e4ndig kompatibel mit Terraform, Beispielkonfigurationen dazu finden Sie hier<\/a>. Ansible hingegen ist prozedural und ereignisgetrieben, ideal f\u00fcr unseren Schritt-f\u00fcr-Schritt-Ansatz und konditionale Logik.<\/p>\n\n\n\n Unser Abenteuer beginnt auf einem MacBook. Wir installieren die notwendigen Tools mit Homebrew<\/a>, dem de facto Standard-Paketmanager f\u00fcr macOS.<\/p>\n\n\n\n Linux-Nutzer k\u00f6nnen der Ansible-Installationsanleitung<\/a> folgen und `nctl` manuell \u00fcber unsere GitHub-Releases<\/a> installieren.<\/p>\n\n\n\n F\u00fcr Windows empfehlen wir die Verwendung von WSL2<\/a> und dann das Befolgen der Linux-Anweisungen von oben. So k\u00f6nnen Sie dieselben Unix-\u00e4hnlichen Tools und Befehle auf Windows nutzen.<\/p>\n\n\n\n Falls Sie Homebrew noch nicht nutzen, installieren Sie es wie folgt:<\/p>\n\n\n Mit Homebrew k\u00f6nnen Sie dann auch diverse andere Tools einfach installieren.<\/p>\n\n\n\n Ansible ist unser Hauptwerkzeug, um die Bereitstellung, Konfiguration und Validierung der Infrastrukturressourcen zu automatisieren.<\/p>\n\n\n\n `nctl` ist unser Befehlszeilen-Client und vereinfacht das Handling unserer API erheblich, wie beispielsweise das Erstellen einer VM oder Datenbank, das Abrufen von Secrets oder die Zugriffskontrollenverwaltung. Es wird immer wieder zum Einsatz kommen.<\/p>\n\n\n\n Um mit unserer API zu interagieren, ben\u00f6tigen Sie einen Inhaber-Token. Dieser Token gew\u00e4hrt Ihnen autorisierten Zugriff und ist sowohl f\u00fcr Ansible als auch f\u00fcr \u2018nctl\u2019 notwendig.<\/p>\n\n\n\n Sie k\u00f6nnen entweder im Cockpit einen Service-Account erstellen und dort den Token einsehen:<\/p>\n\n\n\n \ud83d\udc49 https:\/\/cockpit.nine.ch\/de\/customer\/api\\_service\\_accounts\/<\/a><\/p>\n\n\n\n Oder Sie erstellen den Token via CLI.<\/p>\n\n\n\n Loggen Sie sich dazu mit Ihrem Account ein:<\/p>\n\n\n Dann erstellen wir einen apiserviceaccount mit dem Namen `cicd`:<\/p>\n\n\n Schliesslich rufen wir den Token f\u00fcr den apiserviceaccount mit dem Namen `cicd` ab:<\/p>\n\n\n Sobald Sie Ihren Token haben, exportieren Sie ihn als Umgebungsvariable:<\/p>\n\n\n Vergessen Sie nicht, Ihren \u00f6ffentlichen SSH-Key ebenfalls zu exportieren. Den brauchen wir, um sp\u00e4ter auf die VM zuzugreifen:<\/p>\n\n\n > \ud83d\udee1\ufe0f Behandeln Sie Ihren API-Token wie ein Passwort \u2013 nie direkt in Dateien speichern.<\/p>\n\n\n\n Um den \u00dcberblick zu behalten, legen wir ein Projektverzeichnis an und definieren unsere wiederverwendbare Konfiguration.<\/p>\n\n\n Ansible erm\u00f6glicht es uns, mittels group vars Variablen an einem Ort zu gruppieren. Erstellen Sie einen Ordner mit:<\/p>\n\n\n So k\u00f6nnte `group_vars\/all.yml` aussehen:<\/p>\n\n\n Das macht unsere Playbooks besser lesbar und erleichtert das Wiederverwenden oder Updaten von Einstellungen. Je nach Bedarf k\u00f6nnen Sie die Werte hier anpassen \u2013 wie zum Beispiel die Betriebssystemversion, den Maschinentyp oder die Serviceversionen. Um herauszufinden, welche Werte unterst\u00fctzt werden, k\u00f6nnen Sie die Dokumentation verwenden, die wir f\u00fcr unsere API bieten:<\/p>\n\n\n\n Um eine verwaltete PostgreSQL-Instanz bereitzustellen, verwenden wir `nctl` mit einem Ansible-Playbook. So wird sichergestellt, dass die Datenbank mit unserer gew\u00fcnschten Konfiguration konsistent erstellt wird.<\/p>\n\n\n\n Erstellen Sie das folgende File und speichern Sie es als `provision_postgres.yml`:<\/p>\n\n\n F\u00fchren Sie das Ganze mithilfe von folgendem Befehl aus:<\/p>\n\n\n Achtung: Dieser Schritt kann einige Zeit in Anspruch nehmen.<\/p>\n\n\n\n Zuerst kommt unsere Datenbank: Eine PostgreSQL-Instanz bietet uns einen dauerhaften, zuverl\u00e4ssigen Datenspeicher. Es ist eine \u00fcbliche Backend-Wahl f\u00fcr moderne Apps.<\/p>\n\n\n\n Wir verwenden `nctl`, um die Instanz zu erstellen und rufen dann gleich den Verbindungs-String ab, damit wir ihn sp\u00e4ter verwenden k\u00f6nnen.<\/p>\n\n\n\n Nutzen Sie den Verbindungs-String, um zu best\u00e4tigen, dass die Instanz erreichbar ist:<\/p>\n\n\n Wenn die Verbindung gelingt, k\u00f6nnen Sie zum n\u00e4chsten Schritt \u00fcbergehen. Denken Sie daran, dass die Erstellung einer DB einige Zeit dauern kann, da wir stets eine dedizierte Datenbank bereitstellen. Bald werden wir auch Shared DBs anbieten, die diesen Schritt beschleunigen werden. Bitte beachten Sie auch, dass wir \u2013 der Einfachheit halber und f\u00fcr diesen Blogbeitrag \u2013 f\u00fcr die IP 0.0.0.0\/0 den Zugriff auf alle unsere Dienste erlauben. Ich empfehle Ihnen aber dringend, Ihre Infrastruktur nicht auf diese Weise aufzusetzen. <\/p>\n\n\n\n Redis verk\u00f6rpert unseren KeyValue Store. Genau wie PostgreSQL, nutzen wir ein Ansible-Playbook, um die Bereitstellung zu automatisieren.<\/p>\n\n\n\n Erstellen Sie das folgende File als `provision_redis.yml`:<\/p>\n\n\n F\u00fchren Sie das Ganze mit folgendem Befehl aus:<\/p>\n\n\n Achtung: Dieser Schritt kann einige Zeit dauern.<\/p>\n\n\n\n Als N\u00e4chstes richten wir einen Redis KeyValue Store ein. Redis wird h\u00e4ufig f\u00fcr Caching, Sitzungsspeicher, Ratenbegrenzung oder Pub\/Sub verwendet \u2013 es ist schnell und speicherbasiert.<\/p>\n\n\n\n Wir verwenden abermals `nctl`, um den Store zu erstellen, und extrahieren dann die Adresse und das Passwort aus dem YAML-Output.<\/p>\n\n\n\n Versuchen Sie, sich mittels CLI mit Redis zu verbinden:<\/p>\n\n\n Sollte die Antwort \u2018PONG\u2019 sein, geht\u2019s mit dem n\u00e4chsten Abschnitt weiter.<\/p>\n\n\n\n Da nun die Datenbankdienste eingerichtet sind, k\u00f6nnen wir eine virtuelle Maschine einrichten, die als Rechen-Node fungiert. Diese VM kann sp\u00e4ter als Host f\u00fcr Applikationen oder Skripte konfiguriert werden.<\/p>\n\n\n\n Speichern Sie das folgende Playbook als `provision_vm.yml`:<\/p>\n\n\n Dann f\u00fchren Sie es wie folgt aus:<\/p>\n\n\n Achtung: Dieser Schritt kann einige Zeit in Anspruch nehmen.<\/p>\n\n\n\n Nun richten wir die virtuelle Maschine ein. Dies wird unsere Rechen-Layer sein, auf der Ihre Anwendung \u2013 oder etwas anderes \u2013 l\u00e4uft.<\/p>\n\n\n\n Wir verwenden erneut `nctl`: dieses Mal, um eine VM mit dem von Ihnen gew\u00fcnschten Betriebssystem-Image und SSH-Schl\u00fcssel einzurichten.<\/p>\n\n\n\n Via SSH einloggen:<\/p>\n\n\n Dieser Befehl best\u00e4tigt, dass der Server online, erreichbar und bereit f\u00fcr die Konfiguration ist.<\/p>\n\n\n\n Wir haben nun die Basis f\u00fcr ein vollst\u00e4ndig cloud-natives Deployment geschaffen:<\/p>\n\n\n\n All das automatisiert \u00fcber Ansible und unsere API \u2013 ohne manuelles Rumgeklicke und Ratespiele.<\/p>\n\n\n\n Jetzt kannst du deine Anwendung konfigurieren, Code deployen und deine Architektur skalieren \u2013 alles sauber im Code dokumentiert und einfach reproduzierbar.<\/p>\n","protected":false},"excerpt":{"rendered":" Ein Muster, das wir bei Nine h\u00e4ufig beobachten, ist, dass viele unserer Kund*innen Webanwendungen betreiben \u2013 etwa Content-Management-Systeme, Webshops, Dashboards oder eigene APIs. Solche Anwendungen setzen typischerweise auf eine bew\u00e4hrte Kombination aus Infrastrukturdiensten: eine Datenbank zur Datenspeicherung, eine Cache-Schicht f\u00fcr schnelle Performance und einen Server, auf dem die Anwendungslogik l\u00e4uft.<\/p>\n","protected":false},"author":22,"featured_media":4142,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[399],"tags":[402,420],"class_list":["post-4146","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-know-how-de","tag-databases-de","tag-root-dedicated-server-cloudvm-de"],"acf":[],"yoast_head":"\n\n
\ud83e\udd16 Warum Ansible?<\/h2>\n\n\n\n
\n
\ud83d\udee0\ufe0f Das Toolkit einrichten (macOS)<\/h2>\n\n\n\n
Homebrew installieren<\/h3>\n\n\n\n
\n\/bin\/bash -c "$(curl -fsSL https:\/\/raw.githubusercontent.com\/Homebrew\/install\/HEAD\/install.sh)"\n<\/pre><\/div>\n\n\n
Ansible installieren<\/h3>\n\n\n
\nbrew install ansible\n<\/pre><\/div>\n\n\n
Unser CLI-Tool `nctl` installieren<\/h3>\n\n\n
\nbrew tap ninech\/nine\nbrew install nctl\n<\/pre><\/div>\n\n\n
Authentifizierung mit unserer API<\/h3>\n\n\n\n
\nnctl auth login\n<\/pre><\/div>\n\n\n
\nnctl create apiserviceaccount cicd\n<\/pre><\/div>\n\n\n
\nnctl get apiserviceaccounts cicd --print-token\n<\/pre><\/div>\n\n\n
\nexport NINE_API_TOKEN="<your-token>"\n<\/pre><\/div>\n\n\n
\nexport SSH_PUBLIC_KEY="$(cat ~\/.ssh\/id_ed25519.pub)"\n<\/pre><\/div>\n\n\n
\ud83d\udcca Projektstruktur<\/h2>\n\n\n\n
\nmkdir nine-infra && cd nine-infra\n<\/pre><\/div>\n\n\n
Gruppenvariablen<\/h3>\n\n\n\n
\nmkdir group_vars\n<\/pre><\/div>\n\n\n
\n# group_vars\/all.yml\npostgres_name: example-postgres\npostgres_version: 15\nredis_name: example-redis\nvm_name: example-vm\nlocation: nine-cz41\nmachine_type: nine-small-1\nos: ubuntu24.04\n<\/pre><\/div>\n\n\n
\n
\ud83d\udd3a Schritt 1: PostgreSQL bereitstellen<\/h2>\n\n\n\n
\n# provision_postgres.yml\n- name: Provision PostgreSQL\n hosts: localhost\n gather_facts: false\n\n vars_files:\n - group_vars\/all.yml\n\n tasks:\n - name: Check if PostgreSQL already exists\n ansible.builtin.shell: "nctl get postgres {{ postgres_name }}"\n changed_when: false\n failed_when: false\n register: pg_exists\n\n - name: Create PostgreSQL\n ansible.builtin.command: >\n nctl create postgres {{ postgres_name }}\n --postgres-version {{ postgres_version }}\n --machine-type nine-db-xs\n --location {{ location }}\n --allowed-cidrs 0.0.0.0\/0\n --wait\n changed_when: "pg_result.rc == 0"\n ignore_errors: true\n when: "pg_exists.rc != 0"\n register: pg_result\n\n - name: Get PostgreSQL connection string\n ansible.builtin.command: "nctl get postgres {{ postgres_name }} --print-connection-string"\n register: pg_conn_str\n changed_when: "pg_conn_str.rc != 0"\n\n - name: Set Postgres connection string fact\n ansible.builtin.set_fact:\n postgres_conn_string: "{{ pg_conn_str.stdout }}\/postgres"\n\n - name: Debug Postgres connection string\n ansible.builtin.debug:\n var: postgres_conn_string\n<\/pre><\/div>\n\n\n\nansible-playbook provision_postgres.yml\n<\/pre><\/div>\n\n\n
\u2705 Validierung:<\/h3>\n\n\n\n
\npsql <postgres_connection_string>\n<\/pre><\/div>\n\n\n
\ud83d\udd3a Schritt 2: Redis bereitstellen<\/h2>\n\n\n\n
\n# provision_redis.yml\n- name: Provision Redis\n hosts: localhost\n gather_facts: false\n\n vars_files:\n - group_vars\/all.yml\n\n tasks:\n - name: Check if Redis already exists\n ansible.builtin.shell: "nctl get keyvaluestore {{ redis_name }}"\n changed_when: false\n failed_when: false\n register: redis_exists\n\n - name: Create Redis\n ansible.builtin.command: >\n nctl create keyvaluestore {{ redis_name }}\n --memory-size 1Gi\n --location {{ location }}\n --allowed-cidrs 0.0.0.0\/0\n --wait\n changed_when: "redis_result.rc == 0"\n ignore_errors: true\n when: "redis_exists.rc != 0"\n register: redis_result\n\n - name: Get Redis connection info\n ansible.builtin.command: nctl get keyvaluestore {{ redis_name }} -o yaml\n register: redis_info\n changed_when: "redis_info.rc != 0"\n\n - name: Parse Redis connection info\n ansible.builtin.set_fact:\n redis_host: "{{ redis_info.stdout | from_yaml | json_query('status.atProvider.connection.address') }}"\n redis_password: "{{ redis_info.stdout | from_yaml | json_query('status.atProvider.connection.password') }}"\n\n - name: Debug Redis details\n ansible.builtin.debug:\n msg: "Redis host: {{ redis_host }}, password: {{ redis_password }}"\n<\/pre><\/div>\n\n\n\nansible-playbook provision_redis.yml\n<\/pre><\/div>\n\n\n
\u2705 Validierung:<\/h3>\n\n\n\n
\nredis-cli -h <redis_host> -a <redis_password>\n<\/pre><\/div>\n\n\n
\ud83d\udd3a Schritt 3: CloudVM provisionieren<\/h2>\n\n\n\n
\n# provision_vm.yml\n- name: Provision Cloud VM\n hosts: localhost\n gather_facts: false\n\n vars_files:\n - group_vars\/all.yml\n\n tasks:\n - name: Check if VM already exists\n ansible.builtin.shell: "nctl get cloudvirtualmachine {{ vm_name }}"\n changed_when: false\n failed_when: false\n register: vm_exists\n\n - name: Create VM using nctl (wait until ready)\n ansible.builtin.command: >\n nctl create cloudvirtualmachine {{ vm_name }}\n --hostname {{ vm_name }}\n --location {{ location }}\n --machine-type {{ machine_type }}\n --os {{ os }}\n --public-keys "{{ lookup('env', 'SSH_PUBLIC_KEY') }}"\n --wait\n changed_when: "vm_create_output.rc == 0"\n ignore_errors: true\n when: "vm_exists.rc != 0"\n register: vm_create_output\n\n - name: Show VM creation output\n ansible.builtin.debug:\n var: vm_create_output.stdout_lines\n when: "vm_exists.rc != 0 and vm_create_output.rc == 0"\n<\/pre><\/div>\n\n\n\nansible-playbook provision_vm.yml\n<\/pre><\/div>\n\n\n
\u2705 Validierung:<\/h3>\n\n\n\n
\nssh root@<vm_ip>\n<\/pre><\/div>\n\n\n
\ud83e\udde9 Das Puzzle zusammenf\u00fcgen<\/h2>\n\n\n\n
\ud83d\udd1a Fazit<\/h3>\n\n\n\n
\n