Erste Schritte
Diese Seite führt Sie von einer frischen Installation bis zu Ihrem ersten erfolgreichen Task. Jeder Schritt verweist auf die Seite mit den Details.
Von null zum ersten Task
- Installieren Sie Semaphore mit der Methode Ihrer Wahl: Installation.
- Melden Sie sich an mit dem Admin-Benutzer, den Sie bei der Einrichtung erstellt haben, oder über die
SEMAPHORE_ADMIN_*-Variablen in Docker. - Erstellen Sie ein Projekt. Ein Projekt isoliert Teams, Infrastrukturen oder Anwendungen voneinander: Projekte.
- Verbinden Sie, was Ihre Automatisierung benötigt:
- Quellcode mit Playbooks, Modulen oder Skripten: Repositories.
- SSH-Schlüssel, Token und Passwörter: Schlüsselspeicher.
- Zielhosts und Verbindungseinstellungen: Inventory.
- Wiederverwendbare Variablen: Variablengruppen.
- Erstellen Sie ein Task-Template und führen Sie es aus. Wählen Sie die Anleitung für Ihr Werkzeug: Ansible, Terraform/OpenTofu, Shell, PowerShell oder Python. Führen Sie es anschließend aus und beobachten Sie es: Tasks.
- Automatisieren und in den Betrieb überführen:
- Nach Zeitplan ausführen: Zeitpläne.
- Steuern, wer was tun darf: Teams und benutzerdefinierte Rollen.
- Über Ergebnisse benachrichtigt werden: Benachrichtigungen.
Grundbegriffe
Diese Begriffe tauchen überall in der Benutzeroberfläche auf.
| Begriff | Bedeutung |
|---|---|
| Projekt | Die wichtigste Trenneinheit. Jedes Projekt hat seine eigenen Repositories, Schlüssel, Inventories, Templates und sein eigenes Team. Projekte |
| Repository | Ein Git-Repository oder lokaler Pfad, in dem Playbooks, Module oder Skripte liegen. Repositories |
| Inventory | Hosts, Gruppen und Verbindungseinstellungen für Ansible-artige Ausführungen. Inventory |
| Variablengruppe | Wiederverwendbare Variablen und Umgebungskonfiguration, auch Environment genannt. Variablengruppen |
| Schlüsselspeicher | Verschlüsselte Anmeldedaten wie SSH-Schlüssel, Token und Passwörter. Schlüsselspeicher |
| Task-Template | Die Definition einer Ausführung: App, Repository, Inventory, Variablen und Optionen. Task-Templates |
| Task | Eine einzelne Ausführung eines Templates mit Log und Status. Tasks |
| Workflow | Ein Graph aus Templates mit Verzweigungen, Freigaben und Verzögerungen. Pro-Funktion. Workflows |
| Runner | Wo Tasks ausgeführt werden: der Server selbst oder ein entfernter Runner. Runner |
Nächste Schritte
- Betreiben Sie Semaphore hinter TLS mit einem Reverse-Proxy.
- Verbinden Sie Ihren Identitätsanbieter: LDAP oder OpenID Connect.
- Steuern Sie Semaphore aus CI oder Skripten über die API und die CLI.