Gérer la configuration Semaphore en code

Le fournisseur gère les ressources Semaphore prises en charge via l’API Semaphore : projets, dépôts, modèles et autres familles documentées. Il configure la plateforme elle-même. Cela diffère de l’utilisation de Semaphore pour exécuter du code Terraform gérant votre infrastructure cloud. Vérifiez la documentation des ressources et arguments de la version fixée : une option présente dans l’interface web ne prouve pas sa prise en charge par le fournisseur.

Non. Le fournisseur peut s’exécuter partout où vous exécutez Terraform, si cet environnement peut joindre l’API Semaphore et s’authentifier avec les droits requis. Utilisez un poste de travail ou votre pipeline de configuration existante. Définissez explicitement l’environnement d’exécution, les identifiants API et le backend d’état du fournisseur. Si vous l’exécutez ensuite via Semaphore lui-même, évaluez soigneusement cette dépendance pour que la configuration de la plateforme et sa capacité d’exécution restent récupérables.

Le fournisseur utilise le protocole des fournisseurs Terraform. Un test local a fixé semaphoreui/semaphore 0.3.9 dans OpenTofu contre une instance Semaphore 2.19.12 isolée. Il a lu un projet existant, créé un projet temporaire et trouvé aucune dérive au plan suivant. Il n’a testé ni la CLI Terraform ni toutes les ressources du fournisseur. Fixez vos versions et vérifiez les ressources et opérations du cycle de vie nécessaires avant adoption.

Vérifiez la prise en charge de l’import et l’identifiant requis pour chaque ressource dans la documentation de votre version de fournisseur fixée. Ne supposez pas que toutes les ressources ont le même comportement d’import. Déterminez comment représenter la configuration existante et quel système sera responsable des modifications suivantes avant d’appliquer un plan. Commencez par une ressource hors production, examinez l’état obtenu et les modifications proposées, et évitez de remplacer accidentellement une configuration partagée fonctionnelle.

Oui. Gardez la configuration Terraform des ressources Semaphore prises en charge dans un dépôt versionné et examinez les changements par votre processus normal de pull request. Le fournisseur applique cette configuration via l’API Semaphore. Stockez les identifiants API séparément et utilisez un backend d’état adapté à la configuration gérée.

Les Task Templates font partie des familles de ressources documentées du fournisseur. Consultez la référence du registre pour les arguments exacts de votre version fixée. Modifier un modèle peut affecter les exécutions suivantes : examinez le plan et confirmez la configuration obtenue dans Semaphore avant que l’équipe utilise le travail modifié.

Ils ont des fonctions différentes. Le fournisseur gère la configuration Semaphore via son API. Un Task Template Terraform exécute votre configuration d’infrastructure depuis Semaphore. Utilisez-les indépendamment : configurez la plateforme depuis votre environnement Terraform existant, puis utilisez ses modèles pour les travaux d’infrastructure déjà entretenus par l’équipe.

Fournissez le jeton API par la configuration du fournisseur prise en charge, sans l’enregistrer dans Git. Choisissez un backend d’état Terraform avec accès et sauvegardes adaptés à votre équipe. L’environnement du fournisseur doit joindre Semaphore et utiliser une identité autorisée à gérer les ressources déclarées.