Ansible Provider für Terraform - administrator-tutorials

Die Kombination von Terraform und Ansible ermöglicht eine leistungsstarke und umfassende Automatisierung deiner Infrastruktur. Terraform ist hervorragend geeignet, um Cloud-Ressourcen zu erstellen und zu verwalten, während Ansible ideal für die Konfiguration und das Konfigurationsmanagement dieser Ressourcen ist. Um die beiden Tools nahtlos zu integrieren, kann der Ansible Provider für Terraform genutzt werden.

In diesem Blog-Tutorial zeige ich dir, wie du Terraform verwenden kannst, um Infrastruktur bereitzustellen, und wie du anschließend Ansible für die Konfiguration der bereitgestellten Ressourcen verwendest – alles gesteuert über Terraform.

Warum Terraform und Ansible kombinieren?

Terraform: Terraform ist ein Infrastructure-as-Code (IaC)-Tool, das Cloud-Ressourcen wie Server, Netzwerke und Datenbanken erstellt und verwaltet. Es ist besonders gut für das Management von Cloud-Providern wie AWS, Azure und Google Cloud geeignet.
Ansible: Ansible ist ein Konfigurationsmanagement-Tool, das Infrastrukturressourcen konfiguriert und verwaltet, z. B. das Installieren von Software, das Anwenden von Sicherheitseinstellungen und das Konfigurieren von Diensten.

Mit dem Ansible Provider für Terraform kannst du Terraform verwenden, um Ansible-Playbooks direkt nach der Bereitstellung deiner Cloud-Ressourcen auszuführen. Dadurch kannst du die Provisionierung und Konfiguration in einem einzigen Workflow integrieren.

Voraussetzungen

Bevor du beginnst, stelle sicher, dass du die folgenden Voraussetzungen erfüllst:

Terraform ist auf deinem System installiert. Du kannst es von der offiziellen Website herunterladen.
Ansible ist ebenfalls installiert. Installiere es mit dem Befehl:

sudo apt install ansible  # Für Debian/Ubuntu-basierte Systeme

Du benötigst einen Cloud-Anbieter wie AWS oder Azure, um Ressourcen zu provisionieren, sowie die entsprechenden Zugangsdaten für Terraform.

1. Terraform und Ansible einrichten

Bevor wir uns den Ansible Provider anschauen, richten wir ein einfaches Terraform-Projekt ein, um eine EC2-Instanz auf AWS zu erstellen.

Verzeichnisstruktur erstellen

Zuerst richten wir unser Arbeitsverzeichnis für Terraform und Ansible ein:

mkdir terraform-ansible
cd terraform-ansible

Terraform-Konfiguration für AWS EC2

Erstelle eine Datei namens main.tf für Terraform:

provider "aws" {
  region = "us-east-1"
}

resource "aws_instance" "web" {
  ami           = "ami-12345678"  # Ersetze dies durch eine gültige AMI-ID
  instance_type = "t2.micro"
  key_name      = "mein-key"  # SSH-Schlüssel, der für den Zugriff auf die Instanz verwendet wird

  tags = {
    Name = "AnsibleTestInstance"
  }
}

Diese Konfiguration erstellt eine einfache EC2-Instanz auf AWS.

Terraform initialisieren

Initialisiere Terraform, um die benötigten Provider herunterzuladen und das Projekt vorzubereiten:

terraform init

2. Ansible-Playbook erstellen

Jetzt erstellen wir ein einfaches Ansible-Playbook, das nach der Bereitstellung der EC2-Instanz ausgeführt wird. Das Playbook wird Apache auf der Instanz installieren.

Erstelle ein Ansible-Playbook namens apache.yml:

---
- name: Installiere Apache Webserver
  hosts: all
  become: true
  tasks:
    - name: Aktualisiere apt Paketliste
      apt:
        update_cache: yes

    - name: Installiere Apache
      apt:
        name: apache2
        state: present

    - name: Starte und aktiviere Apache
      systemd:
        name: apache2
        enabled: yes
        state: started

Dieses Playbook installiert Apache und stellt sicher, dass der Webserver läuft und beim Start aktiviert wird.

3. Ansible Provider in Terraform konfigurieren

Jetzt kommen wir zum Herzstück – der Konfiguration des Ansible Providers in Terraform, um unser Playbook auszuführen, nachdem die Instanz erstellt wurde.

Installiere den Ansible Provider über den Terraform-Provider-Registries-Link:

provider "ansible" {}

resource "ansible_host" "webserver" {
  inventory_hostname = aws_instance.web.public_ip  # Dynamische IP von der EC2-Instanz
  ansible_user       = "ubuntu"  # Benutzername für die SSH-Verbindung, z. B. für eine Ubuntu-Instanz
  ansible_ssh_private_key_file = "~/.ssh/mein-key.pem"
}

resource "ansible_playbook" "configure_apache" {
  hosts = [ansible_host.webserver.inventory_hostname]
  playbook_file = "apache.yml"
}

Erklärung:

ansible_host: Dies ist die Definition eines Ansible-Hosts, das auf der dynamisch von Terraform bereitgestellten EC2-Instanz basiert. Die öffentliche IP-Adresse wird hier genutzt, um auf die EC2-Instanz zuzugreifen.
ansible_playbook: Hier definieren wir das Ansible-Playbook, das nach der Erstellung der EC2-Instanz ausgeführt wird. Die hosts-Variable nimmt die IP-Adresse der EC2-Instanz aus der Terraform-Ressource ansible_host.

4. Terraform ausführen

Um nun Terraform auszuführen und das Playbook bereitzustellen, führe folgende Schritte aus:

Terraform Apply: Erstelle die EC2-Instanz und führe das Ansible-Playbook aus:

terraform apply

Terraform wird zunächst die EC2-Instanz erstellen und danach das Ansible-Playbook ausführen, um Apache auf der Instanz zu installieren und zu konfigurieren.
Verifiziere den Erfolg: Nach erfolgreicher Ausführung kannst du prüfen, ob Apache korrekt installiert wurde, indem du die öffentliche IP der EC2-Instanz in deinem Browser aufrufst (http://your-ec2-public-ip).

5. Erweiterungen und Fehlerbehebung

Weitere Ressourcen hinzufügen

Du kannst den Ansible Provider erweitern, um weitere Ressourcen und Konfigurationen hinzuzufügen. Zum Beispiel könntest du mehrere EC2-Instanzen oder verschiedene Cloud-Dienste provisionieren und Ansible für deren Konfiguration nutzen.

Fehlerbehebung

Wenn während der Ausführung von Terraform oder Ansible Probleme auftreten, überprüfe:

SSH-Verbindung: Stelle sicher, dass die SSH-Schlüssel korrekt eingerichtet sind und die EC2-Sicherheitsgruppen den SSH-Zugriff erlauben.
Ansible-Playbooks: Überprüfe die Syntax der Playbooks, da YAML sensibel gegenüber Einrückungen ist.

6. Fazit

Die Integration von Terraform und Ansible mit dem Ansible Provider ist eine großartige Möglichkeit, sowohl die Bereitstellung als auch die Konfiguration deiner Infrastruktur zu automatisieren. Während Terraform die Infrastruktur-Ressourcen wie EC2-Instanzen, Netzwerke und Speicher bereitstellt, übernimmt Ansible die Aufgabe, diese Ressourcen zu konfigurieren und zu verwalten.

Die Kombination der beiden Tools in einem einzigen Workflow ermöglicht es dir, effizient und konsistent Cloud-Infrastrukturen bereitzustellen und zu verwalten – von der Erstellung der Ressourcen bis hin zur Konfiguration von Diensten.

Mit dem Ansible Provider für Terraform kannst du das Beste aus beiden Welten nutzen und eine vollständige End-to-End-Automatisierung deiner Infrastruktur aufbauen.

Viel Erfolg bei der Automatisierung deiner Infrastruktur!