Zum Hauptinhalt springen
Version: Weekly Build

CI-Profile

Was ist ein CI-Profil?​

Ein CI-Profil ist eine eigenständige Version der ci.yml-Konfiguration. Wenn ein neues Profil erstellt wird, generiert Codesphere eine entsprechende Konfigurationsdatei im Projektstammverzeichnis (z. B. ci.dev.yml, ci.prod.yml).

Dadurch lassen sich bestimmte Verhaltensweisen für unterschiedliche Umgebungen anpassen:

  • Build-Schritte: Führe unterschiedliche Tests oder Build-Skripte für verschiedene Stufen aus.
  • Run-Befehle: Starte die App mit unterschiedlichen Flags (z. B. --debug vs. --prod).
  • Services: Starte unterschiedliche Services & Runtimes (z. B. ein dediziertes Redis für Prod vs. ein gemeinsam genutztes für Dev).

Profile verwalten​

Profile lassen sich vollständig über den Landscape Config Editor verwalten.

Ein neues Profil erstellen​

CI-Profilmenü

  1. Navigiere zum Tab Landscape Config Editor.
  2. Klicke auf das Dropdown-Menü CI Profile.
  3. Wähle + Add New CI Profile.
  4. Gib einen Namen für das Profil ein (z. B. prod) und bestätige.

Es wird eine neue, leere Konfiguration erstellt. Die Build- und Run-Schritte können nun speziell für dieses Profil konfiguriert werden.

Ein Profil duplizieren​

tipp

Häufig ähnelt die production-Konfiguration stark der staging-Konfiguration, mit nur geringen Unterschieden. Anstatt von Grund auf neu zu beginnen, kann ein bestehendes Profil duplziert werden.

  1. Wähle im Dropdown das Profil aus, das kopiert werden soll (z. B. default).
  2. Öffne das Dropdown erneut und wähle Duplicate Current CI Profile.
  3. Gib dem neuen Profil einen Namen (z. B. production).

Dadurch wird eine exakte Kopie der Konfiguration erstellt, die anschließend nach Bedarf angepasst werden kann.

Profile wechseln​

So wird das aktuell aktive Profil für eine Landscape geändert:

CI-Profilmenü

  1. Öffne den Execution Manager.
  2. Klicke auf das Dropdown CI Profile.
  3. Wähle das gewünschte Profil aus (z. B. Wechsel von dev zu prod).

info

Der Wechsel des Profils erfordert ein erneutes Deployment, damit die neuen Build-Schritte und Run-Befehle angewendet werden.

Dateistruktur​

Wenn Profile über die Benutzeroberfläche erstellt werden, verwaltet Codesphere die zugrunde liegenden YAML-Dateien im Stammverzeichnis des Projekts automatisch:

  • ci.yml: Das Standardprofil.
  • ci.<PROFILE>.yml: Die Konfiguration für ein bestimmtes Profil (z. B. ci.dev.yml, ci.prod.yml). Diese Dateien sollten in Git versioniert werden. Sobald die Bearbeitung und das Testen abgeschlossen sind, sollten sie im Projekt-Repository committet werden.

hinweis

Da die Profile „nur eine Datei in Git" sind, können sie bei Bedarf auch manuell in der Cloud IDE oder auf beliebige andere Weise bearbeitet werden. Die Änderungen werden sofort in der Benutzeroberfläche übernommen.

Weitere Informationen zum Konfigurieren der CI-Pipeline.