Skip to the content
Documentation
Help Start
Reading in:
  • German: 9,090 of 9,090 pages
About the help in other languages
All help pages

Konfiguration unter Versionsverwaltung

Für IT-Teams im öffentlichen Sektor, die jede Änderung an einer Live-Website steuern und nachvollziehen müssen. Wie Sie Code und Einstellungen von Exponential in der Versionsverwaltung halten, die Administration mit…

Download as PDF

Address: https://doc.exponential.earth/exphelp/viewer/help/government/operations/hosting/configuration-under-version-control.md

On this page

This page is a translation. Read the English original

Konfiguration unter Versionsverwaltung

Diese Seite richtet sich an IT-Teams in öffentlichen Stellen, deren Änderungsprozess vorschreibt, dass jede Änderung an einem Produktionssystem auf einen freigegebenen Antrag zurückführbar sein muss. Sie beantwortet, wie Sie Code und Einstellungen einer Exponential-Website in der Versionsverwaltung halten, wie Sie verhindern, dass die Administration an Ihrem Prozess vorbei Einstellungen auf dem Server ändert, und was aus dem Repository herausbleiben muss. Die Funktionsreferenz ist Durch die Bereitstellung verwaltete Konfiguration.

Inhalt

  1. Was in die Versionsverwaltung gehört
  2. Das Problem mit im Browser bearbeiteten Einstellungen
  3. Mit ManagedByDeployment sperren
  4. Geheimnisse
  5. Nachvollziehbarkeit
  6. Checkliste

Was in die Versionsverwaltung gehört

PfadIm RepositoryHinweis
composer.json, composer.lockjavendor/ in denselben Versionen neu aufbauen
Ihre eigenen Erweiterungen und Designsja
settings/siteaccess/jaSiteaccess-Einstellungen
settings/override/ja, ohne Geheimnissesiehe Geheimnisse
Umgebungsvarianten wie site.ini.test.append.phpjaEinstellungen pro Umgebung (Umgebungen für Entwicklung, Test und Produktion)
config.env.phpneinbenennt die Umgebung der Maschine; .gitignore hält sie heraus
var/neinLaufzeitdaten, separat gesichert
vendor/neinvon Composer neu aufgebaut

Wie Code mit Composer und Git auf einen Server gelangt, steht unter Composer und Git auf Servern.

Das Problem mit im Browser bearbeiteten Einstellungen

Ohne Sperre schreiben der INI-Editor, die Editoren für Werkzeugleiste und Menüs und der Template-Editor der Administration Dateien *.ini.append.php und .tpl in das Release-Verzeichnis. Die Versionsverwaltung sieht sie nicht, und die nächste Bereitstellung verwirft sie (Durch die Bereitstellung verwaltete Konfiguration). Für eine öffentliche Stelle ist das zudem ein Prüfungsbefund: eine Änderung an der Produktion, die den Änderungsprozess umgangen hat.

Mit ManagedByDeployment sperren

Ein Schalter pro Siteaccess, standardmäßig ausgeschaltet, seit 6.0.15:

# settings/siteaccess/<admin siteaccess>/site.ini.append.php
[ConfigurationSettings]
ManagedByDeployment=enabled

Ist er eingeschaltet, gilt bei Web-Anfragen:

  • die Ansichten, die Konfiguration schreiben, antworten wie eine deaktivierte Ansicht (standardmäßig mit 404): settings/edit, die Editoren für Werkzeugleiste und Menüs, der Template-Editor, der Einrichtungsassistent, die Aktivierung von Erweiterungen (setup/extensions), die Codegeneratoren sowie Hochladen, Installieren, Deinstallieren, Erstellen und Exportieren von Paketen;
  • Menüs und Links zu diesen Ansichten werden ausgeblendet;
  • eZINI::save() verweigert den Schreibvorgang, was auch schreibende Stellen stoppt, die die Liste nicht kennt.

Was offen bleibt: schreibgeschützte Ansichten (settings/view, setup/cache, setup/info, die Logs), Kommandozeilenskripte und die Bereitstellung selbst, einschließlich exp:ini und bin/php/*.php, sowie Schlüsselmaterial, das der Code bei der ersten Verwendung erzeugt (die Audit-Schlüssel, das Geheimnis für die E-Mail-Präferenzen). Die Liste der gesperrten Ansichten steht in der Klasse, nicht in einer INI-Datei, sodass eine Einstellungsdatei sie nicht abschwächen kann. Sie gilt gleichermaßen unter PHP-FPM, Apache, FrankenPHP und Velocity.

Grenzen: Die Installation eines Pakets über die Kommandozeile schreibt weiterhin in die Datenbank, und Dateirechte auf dem Release-Verzeichnis bleiben die stärkere Maßnahme.

Legen Sie die Einstellung selbst in die Versionsverwaltung, niemals in eine Datei, die die Administration schreiben könnte. Änderungen an Einstellungen laufen dann über Ihr Repository, Ihre Prüfung und Ihre Bereitstellung:

./console exp:ini get site.ini/ConfigurationSettings/ManagedByDeployment --allow-root-user

Geheimnisse

Halten Sie Datenbankpasswörter und erzeugte Schlüssel aus dem Repository heraus oder legen Sie sie verschlüsselt darin ab:

GeheimnisWo es liegt
Zugangsdaten der Datenbanksite.ini [DatabaseSettings] in settings/override/
Signatur- und Pseudonymschlüssel des Auditssettings/override/audit.ini.append.php
Geheimnis für die E-Mail-Präferenzensettings/override/mailpreferences.ini.append.php
Zertifikatsschlüssel von Velocityder Konfigurationsbaum von Velocity

Ein verbreitetes Muster ist eine kleine, nicht versionierte Einstellungsdatei pro Umgebung für die Zugangsdaten, die aus Ihrem Speicher für Geheimnisse bereitgestellt wird. Sichern Sie diese Dateien separat (Schlüssel und Geheimnisse in Datensicherungen).

Nachvollziehbarkeit

Mit Code und Einstellungen in der Versionsverwaltung sagt die Historie des Repositorys, was sich wann und in welchem geprüften Commit geändert hat. Exponential steuert seinen Teil bei: Das Prüfprotokoll zeichnet Schreibvorgänge an Einstellungen, das Leeren von Caches, Bereitstellungen und Paketinstallationen im Kanal system auf (Prüfprotokoll). Zusammen erlauben sie Ihnen, die Frage einer Prüferin oder eines Prüfers zu beantworten: „Wer hat diese Einstellung geändert, und war das freigegeben?“ Der Änderungsprozess selbst ist unter Änderungsmanagement und Änderungsbeiräte beschrieben.

Checkliste

  • To do: Code, Erweiterungen, Designs und Einstellungen liegen in der Versionsverwaltung; var/, vendor/ und config.env.php nicht.
  • To do: Geheimnisse bleiben aus dem Repository heraus oder liegen verschlüsselt darin.
  • To do: ManagedByDeployment=enabled in jedem Administrations- und Redaktions-Siteaccess der Produktion.
  • To do: Das Release-Verzeichnis ist für den Benutzer des Webservers nicht beschreibbar, wo nichts hineinschreiben muss.
  • To do: Bereitstellungen laufen aus dem Repository, nicht durch Handbearbeitung auf dem Server.

Verwandte Seiten

Werden Sie Exponential-Partner

Partner teilen ihre Informationen, stellen Mittel bereit, geben Beiträge zurück und entwickeln die Produkte mit uns, und so wächst Exponential. Eine Partner-Website und ein Dashboard sind für Mitte 2027 geplant: Werden Sie noch heute Partner, damit wir schneller wachsen und neue Funktionen früher liefern.

Something wrong on this page? Report an error

Documentation license

This documentation is free documentation, licensed under the GNU Free Documentation License 1.3 or later.

Exponential Copyright © 1998-2026 Exponential Foundation and 7x