Infrastruktur-Repository einrichten

Zweck: Zugriff auf die Infrastruktur erlangen

Zielgruppe: Administrator mit Gitlab-Zugriff

Schritt 1: Repository klonen

Ziel: Zugriff auf Ansible-Playbooks und DNS-Konfiguration.

  1. SSH-Schlüssel zum Agent hinzufügen:

    ssh-add
    
  2. Repository klonen:

    git clone git@gitlab.com:ferrosoft/infrastructure.git
    cd infrastructure
    

Schlägt der Klon fehl, vergewissern Sie sich, dass Ihr SSH-Schlüssel in Gitlab hinterlegt ist und Sie Zugriff auf die Ferrosoft-Gruppe haben.

Schritt 2: DNSControl einrichten

Ziel: DNS-Zonen über dnsconfig.json verwalten.

  1. Tool über die mitgelieferte Makefile installieren. Schlägt dies fehl, installieren Sie zunächst Go.

    make install
    
  2. creds.json mit den richtigen Zugangsdaten anlegen. Ein fertiges Snippet liegt in der Schlüsseldatenbank unter dem Eintrag dnscontrol creds.json.

    {
      "cloudns": {
        "TYPE": "CLOUDNS",
        "auth-id": "XXX",
        "auth-password": "XXX"
      },
      "hetzner_v2": {
        "TYPE": "HETZNER_V2",
        "api_token": "XXX"
      }
    }
    
  3. Einsatzbereitschaft prüfen:

    bin/dnscontrol preview
    

Schritt 3: Ansible Vault einrichten

Ziel: Ansible kann bei der Ausführung von ansible-playbook verschlüsselte Werte entschlüsseln.

  1. Passwort Ansible Vault aus der Schlüsseldatenbank kopieren.

  2. Passwort in der Shell einlesen:

    read -s pw
    
  3. Passwort in die vorgesehene Datei schreiben:

    echo "$pw" > ansible/vaultpass
    

Schritt 4: Ansible installieren

Ziel: Ansible ist einsatzbereit.

  1. uv installieren.

  2. Ins Ansible-Verzeichnis wechseln: cd ansible.

  3. Abhängigkeiten installieren:

    uv sync