Semaphore-Konfiguration als Code verwalten

Der Provider verwaltet unterstützte Semaphore-Ressourcen über die Semaphore API, etwa Projekte, Repositories, Vorlagen und weitere dokumentierte Ressourcenfamilien. Er konfiguriert die Plattform selbst. Das unterscheidet sich vom Einsatz von Semaphore zur Ausführung von Terraform-Code, der Ihre Cloud-Infrastruktur verwaltet. Prüfen Sie die Ressourcen- und Argumentdokumentation der festgelegten Provider-Version. Eine Einstellung in der Weboberfläche ist nicht automatisch ein Beleg für ihre Unterstützung im Provider.

Nein. Der Provider kann überall laufen, wo Sie Terraform ausführen, sofern diese Umgebung die Semaphore API erreicht und sich mit den erforderlichen Rechten authentifizieren kann. Sie können einen Arbeitsplatzrechner oder Ihre vorhandene Konfigurationspipeline verwenden. Legen Sie Ausführungsumgebung, API-Zugangsdaten und Zustandsbackend des Providers ausdrücklich fest. Falls Sie ihn später über Semaphore selbst ausführen, bewerten Sie diese Abhängigkeit sorgfältig, damit Plattformkonfiguration und ihre Ausführbarkeit wiederherstellbar bleiben.

Der Provider verwendet das Terraform-Provider-Protokoll. Ein lokaler Test setzte semaphoreui/semaphore 0.3.9 in OpenTofu gegen eine isolierte Semaphore-2.19.12-Instanz ein. Der Test las ein vorhandenes Projekt, erstellte ein temporäres Projekt und fand bei einem folgenden Plan keine Abweichungen. Er prüfte weder die Terraform CLI noch jede Provider-Ressource. Legen Sie eigene Versionen fest und prüfen Sie die von Ihrem Team benötigten Ressourcen und Lebenszyklusoperationen vor der Einführung.

Prüfen Sie für jede Ressource in der Dokumentation Ihrer festgelegten Provider-Version, ob ein Import unterstützt wird und welche Kennung nötig ist. Gehen Sie nicht von einem einheitlichen Importverhalten aller Ressourcen aus. Legen Sie vor dem Anwenden eines Plans fest, wie die vorhandene Konfiguration abgebildet wird und welches System spätere Änderungen verantwortet. Beginnen Sie mit einer nicht produktiven Ressource, prüfen Sie den entstandenen State und die vorgeschlagenen Änderungen und vermeiden Sie, eine funktionierende gemeinsame Konfiguration versehentlich zu ersetzen.

Ja. Speichern Sie die Terraform-Konfiguration für unterstützte Semaphore-Ressourcen in einem versionierten Repository und prüfen Sie Änderungen über Ihren normalen Pull-Request-Prozess. Der Provider übernimmt diese Konfiguration über die Semaphore API. Speichern Sie API-Zugangsdaten getrennt vom Code und verwenden Sie ein zur verwalteten Konfiguration passendes Zustandsbackend.

Task Templates gehören zu den dokumentierten Ressourcenfamilien des Providers. Nutzen Sie die Registry-Referenz für die genauen Argumente Ihrer festgelegten Provider-Version. Eine Vorlagenänderung kann nachfolgende Automatisierungsausführungen beeinflussen. Prüfen Sie daher den Plan und bestätigen Sie die resultierende Konfiguration in Semaphore, bevor das Team den aktualisierten Job verwendet.

Sie dienen unterschiedlichen Zwecken. Der Provider verwaltet Semaphore-Konfiguration über dessen API. Ein Terraform Task Template führt Ihre Infrastrukturkonfiguration aus Semaphore aus. Sie können beide unabhängig einsetzen: Konfigurieren Sie die Automatisierungsplattform aus Ihrer vorhandenen Terraform-Umgebung und nutzen Sie anschließend ihre Vorlagen für die vom Team bereits gepflegten Infrastrukturjobs.

Übergeben Sie das API-Token über die unterstützte Provider-Konfiguration, ohne es in Git zu speichern. Wählen Sie ein Terraform-Zustandsbackend mit für Ihr Team geeigneter Zugriffssteuerung und Sicherung. Die Provider-Ausführungsumgebung benötigt Netzwerkzugriff auf Semaphore und eine Identität, die die in der Konfiguration deklarierten Ressourcen verwalten darf.