Ansible hinzugefügt
This commit is contained in:
Florian Hensel
@@ -454,7 +454,6 @@ Für fortgeschrittene Anwendungsfälle können Spezialrechte gesetzt werden:
|
||||
**Samba-spezifische Nutzung:**
|
||||
* **SGID** ist nützlich, um sicherzustellen, dass neue Dateien/Ordner in einer Freigabe automatisch der richtigen Gruppe gehören:
|
||||
````bash
|
||||
|
||||
sudo chmod 2770 /srv/samba/dokumente # SGID + Besitzer/Gruppe: rwx
|
||||
````
|
||||
|
||||
|
||||
Binary file not shown.
|
Before Width: | Height: | Size: 9.4 KiB |
346
mkdocs/docs/bonus/automatisierung-mit-ansible.md
Normal file
346
mkdocs/docs/bonus/automatisierung-mit-ansible.md
Normal file
@@ -0,0 +1,346 @@
|
||||
# Ansible-Basics-Handbuch
|
||||
|
||||
## 1. Einführung in Ansible
|
||||
|
||||
### Was ist Ansible?
|
||||
Ansible ist ein **Open-Source-Tool zur Automatisierung von IT-Infrastrukturen**. Es ermöglicht die **zentrale Verwaltung, Konfiguration und Bereitstellung** von Servern, Netzwerkgeräten und Anwendungen. Ansible ist besonders nützlich, weil es:
|
||||
|
||||
- **Zeit spart**: Automatisiert Routineaufgaben wie Software-Installationen, Updates oder Benutzerverwaltung.
|
||||
- **Fehler reduziert**: Durch die Verwendung von **Playbooks** (Skripte in YAML) werden Konfigurationen **wiederholbar und konsistent** umgesetzt.
|
||||
- **Einfach zu erlernen**: Nutzt **YAML**, eine leicht lesbare Sprache, und erfordert keine Programmierkenntnisse.
|
||||
- **Agentenlos arbeitet**: Benötigt auf den verwalteten Systemen **keine zusätzliche Software** – nur **SSH** ist erforderlich.
|
||||
- **Flexibel einsetzbar**: Unterstützt eine Vielzahl von Systemen, darunter **Ubuntu-Server, Docker-Container und Netzwerkgeräte**.
|
||||
|
||||
### Typische Anwendungsfälle
|
||||
- **Server-Setup**: Automatisierte Installation und Konfiguration von Servern (z. B. für Webserver oder Datenbanken).
|
||||
- **Benutzerverwaltung**: Erstellen und Verwalten von Benutzern und Gruppen.
|
||||
- **Sicherheitsupdates**: Regelmäßige, automatische Updates für alle Systeme.
|
||||
- **Software-Bereitstellung**: Installation und Konfiguration von Programmen wie **Nginx, Samba oder Docker**.
|
||||
- **Backup-Strategien**: Automatisierte Sicherung von Daten.
|
||||
|
||||
|
||||
### Wie funktioniert Ansible?
|
||||
Ansible arbeitet nach dem **Push-Prinzip**:
|
||||
|
||||
1. **Control Node**: Der Rechner, von dem aus Ansible gesteuert wird. (Im Kurs das Linux Mint)
|
||||
2. **Managed Nodes**: Die Systeme, die von Ansible verwaltet werden. (Im Kurs der Ubuntu-Server)
|
||||
3. **Inventar**: Eine Liste der verwalteten Systeme (IP-Adressen oder Hostnamen).
|
||||
4. **Playbooks**: Skripte, die definieren, welche Aufgaben auf den verwalteten Systemen ausgeführt werden sollen.
|
||||
|
||||
**Beispiel:**
|
||||
Sie möchten auf mehreren Servern **Nginx installieren** und eine **Standard-Webseite** bereitstellen. Statt auf jedem Server manuell Befehle auszuführen, schreiben Sie ein **Ansible-Playbook**, das diese Aufgabe **automatisiert und zentral** erledigt.
|
||||
|
||||
---
|
||||
|
||||
### Voraussetzungen
|
||||
- **Ubuntu Server** (als Managed Node).
|
||||
- **SSH-Zugriff** auf die Server (mit Schlüsselpaar).
|
||||
- **Ansible** auf dem Control Node (Linux Mint) installiert.
|
||||
|
||||
---
|
||||
|
||||
## 2. Vorbereitung: SSH-Key-Paar für Ansible erstellen
|
||||
|
||||
### Schritt 1: Schlüsselpaar auf dem Ansible-Control-Node erstellen
|
||||
````bash
|
||||
ssh-keygen -t ed25519 -C "ansible@control-node"
|
||||
````
|
||||
* Speicherort: /home/benutzer/.ssh/id_ed25519 (Standard)
|
||||
* Passphrase: Optional, aber für zusätzliche Sicherheit empfohlen.
|
||||
|
||||
### Schritt 2: Öffentlichen Schlüssel auf die Managed Nodes übertragen
|
||||
Kopieren Sie den öffentlichen Schlüssel mit folgendem Befehl auf Ihre Server:
|
||||
````bash
|
||||
ssh-copy-id -i ~/.ssh/id_ed25519.pub benutzer@server-ip
|
||||
````
|
||||
Beispiel:
|
||||
````bash
|
||||
ssh-copy-id -i ~/.ssh/id_ed25519.pub meisterkurs@192.168.100.250
|
||||
````
|
||||
Test der Verbindung:
|
||||
````bash
|
||||
ssh Meisterkurs@192.168.100.250
|
||||
````
|
||||
Die Anmeldung sollte jetzt **ohne Passwortabfrage** möglich sein.
|
||||
|
||||
## 3. Ansible installieren und konfigurieren
|
||||
|
||||
### Ansible auf dem Control Node installieren
|
||||
Installieren Sie Ansible mit den folgenden Befehlen:
|
||||
````bash
|
||||
sudo apt update
|
||||
sudo apt install ansible -y
|
||||
````
|
||||
### Inventar-Datei erstellen
|
||||
Legen Sie eine Inventar-Datei an, z. B. ````/etc/ansible/hosts````, und tragen Sie Ihre Server ein:
|
||||
````yaml
|
||||
ubuntu_servers:
|
||||
hosts:
|
||||
sv1:
|
||||
ansible_host: 192.168.100.250
|
||||
ansible_user: meisterkurs
|
||||
ansible_become: true
|
||||
ansible_become_method: sudo
|
||||
ansible_become_password: passw0rd#
|
||||
````
|
||||
### Verbindung testen
|
||||
|
||||
````bash
|
||||
ansible -m ping all
|
||||
````
|
||||
|
||||
> Erwartete Ausgabe:
|
||||
````json
|
||||
"sv1": {
|
||||
"ping": "pong"
|
||||
}
|
||||
````
|
||||
|
||||
## 4. System-Updates mit Ansible durchführen
|
||||
### Playbook: 01-playbook-update_system.yml
|
||||
Erstellen Sie eine Datei namens 01-playbook-update_system.yml mit folgendem Inhalt:
|
||||
````yaml
|
||||
---
|
||||
- name
|
||||
hosts: ubuntu_servers # Zielgruppe: Alle Ubuntu-Server im Inventar
|
||||
become: yes # Root-Rechte für Paketverwaltung
|
||||
tasks:
|
||||
- name: System-Paketlisten aktualisieren
|
||||
apt:
|
||||
update_cache: yes
|
||||
# Aktualisiert die Paketlisten, um die neuesten Versionen zu erhalten
|
||||
|
||||
- name: Alle Pakete auf den neuesten Stand bringen
|
||||
apt:
|
||||
upgrade: dist # Führt ein Distribution-Upgrade durch
|
||||
autoremove: yes # Entfernt nicht mehr benötigte Pakete
|
||||
# Installiert alle verfügbaren Updates und bereinigt das System
|
||||
|
||||
- name: Überprüfen, ob ein Neustart erforderlich ist
|
||||
stat:
|
||||
path: /var/run/reboot-required
|
||||
register: reboot_required
|
||||
# Prüft, ob ein Neustart nach den Updates erforderlich ist
|
||||
|
||||
- name: Hinweis auf Neustart ausgeben (falls erforderlich)
|
||||
debug:
|
||||
msg: "Ein Neustart des Servers {{ inventory_hostname }} ist erforderlich!"
|
||||
when: reboot_required.stat.exists
|
||||
# Zeigt eine Warnung an, wenn ein Neustart erforderlich ist
|
||||
|
||||
````
|
||||
|
||||
Führen Sie das Playbook aus:
|
||||
````bash
|
||||
ansible-playbook 01-playbook-update_system.yml
|
||||
````
|
||||
|
||||
## 5. Programm installieren und konfigurieren (Beispiel: Nginx)
|
||||
|
||||
### Playbook: 02-playbook-install-nginx.yaml
|
||||
|
||||
Erstellen Sie Datei 01-playbook-install.nginx.yaml
|
||||
|
||||
````yaml
|
||||
---
|
||||
- name: Installiere nginx auf einstellbarem Port
|
||||
hosts: ubuntu_servers
|
||||
become: yes
|
||||
vars:
|
||||
nginx_port: 5000 # Port, auf dem Nginx laufen soll
|
||||
example_page_content: |
|
||||
<!DOCTYPE html>
|
||||
<html>
|
||||
<head>
|
||||
<title>Nginx auf Port 5000</title>
|
||||
<style>
|
||||
body { font-family: Arial, sans-serif; text-align: center; margin-top: 50px; }
|
||||
h1 { color: #0078d7; }
|
||||
</style>
|
||||
</head>
|
||||
<body>
|
||||
<h1>Willkommen auf der Nginx-Beispielseite!</h1>
|
||||
<p>Diese Seite wird auf <strong>Port {{ nginx_port }}</strong> bereitgestellt.</p>
|
||||
<p>Ansible-Playbook erfolgreich ausgeführt!</p>
|
||||
</body>
|
||||
</html>
|
||||
|
||||
tasks:
|
||||
- name: Nginx installieren
|
||||
apt:
|
||||
name: nginx
|
||||
state: present
|
||||
# Installiert Nginx, falls nicht bereits vorhanden
|
||||
|
||||
- name: Nginx-Konfiguration für Port 5000 anpassen
|
||||
template:
|
||||
src: nginx.conf.j2 # Template-Datei für die Nginx-Konfiguration
|
||||
dest: /etc/nginx/sites-available/default
|
||||
notify: Nginx neu starten
|
||||
# Ersetzt die Standardkonfiguration von Nginx durch unsere angepasste Version
|
||||
|
||||
- name: Beispiel-HTML-Seite bereitstellen
|
||||
copy:
|
||||
dest: /var/www/nginx/index.html
|
||||
content: "{{ example_page_content }}"
|
||||
notify: Nginx neu starten
|
||||
# Kopiert die Beispiel-HTML-Seite in das Webverzeichnis von Nginx
|
||||
|
||||
- name: Nginx-Dienst starten und aktivieren
|
||||
service:
|
||||
name: nginx
|
||||
state: started
|
||||
enabled: yes
|
||||
# Startet Nginx und aktiviert den Autostart beim Systemstart
|
||||
|
||||
- name: Firewall für Port 5000 öffnen (falls UFW aktiv)
|
||||
ufw:
|
||||
rule: allow
|
||||
port: "{{ nginx_port }}"
|
||||
proto: tcp
|
||||
when: "'ufw' in ansible_facts.packages"
|
||||
# Öffnet den Port 5000 in der Firewall, falls UFW installiert ist
|
||||
|
||||
- name: Überprüfen, ob Nginx auf Port 5000 erreichbar ist
|
||||
uri:
|
||||
url: "http://localhost:{{ nginx_port }}"
|
||||
return_content: yes
|
||||
register: nginx_status
|
||||
until: nginx_status.status == 200
|
||||
retries: 5
|
||||
delay: 10
|
||||
# Prüft, ob Nginx auf dem konfigurierten Port erreichbar ist
|
||||
# - retries: 5: Wiederholt die Prüfung 5 Mal, falls der Port noch nicht erreichbar ist
|
||||
# - delay: 10: Wartezeit von 10 Sekunden zwischen den Versuchen
|
||||
|
||||
- name: Statusmeldung ausgeben
|
||||
debug:
|
||||
msg: "Nginx ist erfolgreich auf Port {{ nginx_port }} gestartet und erreichbar unter http://{{ ansible_host }}:{{ nginx_port }}"
|
||||
# Zeigt eine Erfolgsmeldung mit der URL zur Beispielseite an
|
||||
|
||||
|
||||
handlers:
|
||||
- name: Nginx neu starten
|
||||
service:
|
||||
name: nginx
|
||||
state: restarted
|
||||
# Startet Nginx neu, um Änderungen an der Konfiguration zu übernehmen
|
||||
````
|
||||
#### Was sind Handler?
|
||||
> Handler in Ansible sind spezielle Aufgaben, die nur dann ausgeführt werden, wenn sie von einer anderen Aufgabe explizit benachrichtigt (notify) werden. Sie werden typischerweise für Dienst-Neustarts oder Konfigurationsänderungen verwendet, die nur dann notwendig sind, wenn sich etwas geändert hat.
|
||||
|
||||
|
||||
### Nginx-Konfigurationsdatei (nginx.conf.j2)
|
||||
|
||||
Im Script wird eine Kopierquelle für die konfiguration des Servers angegeben. Diese darf direkt daneben angelegt werden: ````nginx.conf.j2````
|
||||
|
||||
````nginx
|
||||
server {
|
||||
listen {{ nginx_port }} default_server;
|
||||
listen [::]:{{ nginx_port }} default_server;
|
||||
|
||||
root /var/www/nginx;
|
||||
index index.html;
|
||||
|
||||
server_name _;
|
||||
|
||||
location / {
|
||||
try_files $uri $uri/ =404;
|
||||
}
|
||||
}
|
||||
````
|
||||
|
||||
|
||||
Ausführung des Playbooks:
|
||||
````bash
|
||||
ansible-playbook 01-playbook-install.nginx.yaml
|
||||
````
|
||||
|
||||
### Nach der Installation:
|
||||
Öffnen Sie einen Browser und verbinden Sie sich mit port 5000
|
||||
> Sie sollten die Beispielseite sehen.
|
||||
Port-Überprüfung:
|
||||
Das Playbook prüft automatisch, ob Nginx auf Port 5000 erreichbar ist, und gibt eine Erfolgsmeldung aus.
|
||||
|
||||
## 6. Playbook: Benutzer und Gruppen verwalten
|
||||
````03-playbook-manage-users.yml````
|
||||
````yaml
|
||||
---
|
||||
- name: Benutzer und Gruppen auf den Managed Nodes verwalten
|
||||
hosts: sv1
|
||||
become: yes
|
||||
|
||||
vars:
|
||||
users:
|
||||
- name: dbecker
|
||||
groups: ["Geschäftsleitung"]
|
||||
- name: spoller
|
||||
groups: ["Projektleitung"]
|
||||
groups:
|
||||
- Geschäftsleitung
|
||||
- Projektleitung
|
||||
|
||||
tasks:
|
||||
- name: Gruppen erstellen
|
||||
group:
|
||||
name: "{{ item }}"
|
||||
state: present
|
||||
loop: "{{ groups }}"
|
||||
# Erstellt die in der Variable "groups" definierten Gruppen
|
||||
|
||||
- name: Benutzer erstellen
|
||||
user:
|
||||
name: "{{ item.name }}"
|
||||
groups: "{{ item.groups | join(',') }}"
|
||||
shell: /bin/bash
|
||||
loop: "{{ users }}"
|
||||
# Erstellt die in der Variable "users" definierten Benutzer
|
||||
# - groups: Fügt die Benutzer den angegebenen Gruppen hinzu
|
||||
# - shell: Setzt die Standard-Shell auf Bash
|
||||
````
|
||||
|
||||
## 7. Playbook: Automatische Updates einrichten
|
||||
````04-playbook-auto-update.yml````
|
||||
|
||||
````yaml
|
||||
---
|
||||
- name: Automatische Updates auf den Managed Nodes einrichten
|
||||
hosts: ubuntu_servers
|
||||
become: yes
|
||||
|
||||
tasks:
|
||||
- name: unattended-upgrades installieren
|
||||
apt:
|
||||
name: unattended-upgrades
|
||||
state: present
|
||||
# Installiert das Paket für automatische Updates
|
||||
|
||||
- name: Automatische Updates aktivieren
|
||||
copy:
|
||||
dest: /etc/apt/apt.conf.d/20auto-upgrades
|
||||
content: |
|
||||
APT::Periodic::Update-Package-Lists "1";
|
||||
APT::Periodic::Unattended-Upgrade "1";
|
||||
# Konfiguriert die automatische Aktualisierung der Paketlisten und Installation von Updates
|
||||
````
|
||||
## 8. Zusammenfassung
|
||||
Was wurde erreicht?
|
||||
|
||||
* SSH-Key-Authentifizierung für sichere Ansible-Kommunikation.
|
||||
* Automatisierte System-Updates und Programm-Installation.
|
||||
* Benutzer- und Gruppenverwaltung.
|
||||
* Automatische Sicherheitsupdates.
|
||||
|
||||
---
|
||||
|
||||
## Inhaltsverzeichnis
|
||||
|
||||
[TOC]
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
@@ -17,7 +17,7 @@ nav:
|
||||
- Bonuskapitel:
|
||||
- Linux als Active Directory Server: bonus/linux-als-ad-server.md
|
||||
- Linux als Client in Active Directory: bonus/linux-als-ad-client.md
|
||||
|
||||
- Automatisierung mit Ansible: bonus/automatisierung-mit-ansible.md
|
||||
# Theme
|
||||
theme:
|
||||
logo: assets/Logo.png
|
||||
|
||||
Reference in New Issue
Block a user