Paketierung produktspezifischer Standardkonfigurationen

Alle Pakete MÜSSEN über eine globale Standardkonfiguration verfügen. Diese Konfiguration wird immer dann verwendet, wenn keine produktspezifische Standardkonfiguration erforderlich ist, zum Beispiel bei einer Nicht-Produktinstallation oder wenn nur Fedora Cloud eine benutzerdefinierte Konfiguration besitzt und Fedora Workstation installiert wurde.

Jedes Paket, das eine produktspezifische Standardkonfiguration erfordert, MUSS alle alternativen Konfigurationsdateien im selben Paket bereitstellen.

Jedes Paket, das eine für das jeweilige Produkt unterschiedliche Konfiguration erfordert, MUSS vor der Paketierung die Genehmigung der Arbeitsgruppe des jeweiligen Produkts einholen.

Die globale Standardkonfiguration MUSS von dem Paket bereitgestellt werden, das sie benötigt.

Die globale Standardkonfiguration MUSS gemäß dem normalen Namensschema des Pakets benannt werden, wobei der Hauptteil des Namens mit dem Suffix „-default“ versehen wird. Wenn das Paket beispielsweise normalerweise foo.conf verwendet, MUSS die globale Standardkonfiguration foo-default.conf heißen.

Für jedes Produkt, das eine individuelle Standardkonfiguration erfordert, MUSS der Paketierer eine Kopie der Standardkonfigurationsdatei bereitstellen, die entsprechend dem jeweiligen Produkt angepasst ist.

Die produktspezifische Konfigurationsdatei MUSS gemäß dem üblichen Namensschema des Pakets benannt werden. Der Hauptteil des Namens wird mit einem Bindestrich und dem Produktnamen ergänzt. Verwendet das Paket beispielsweise normalerweise foo.conf, muss die Serverversion foo-server.conf heißen.

Wenn die Konfiguration per symbolischem Link direkt im Verzeichnis gespeichert werden soll, muss sich die produktspezifische Konfigurationsdatei in einem geeigneten Bereich der /etc-Verzeichnishierarchie befinden. Die abweichende Konfigurationsdatei muss gemäß den üblichen Paketbaurichtlinien von /etc als %config(noreplace) in %files angegeben werden.

Soll die Konfiguration direkt kopiert werden, muss sich die produktspezifische Konfigurationsdatei in einem geeigneten Bereich der Verzeichnishierarchie /usr/share befinden. Die abweichende Konfigurationsdatei muss als normale Datei im Abschnitt %files angegeben werden.

Es MUSS zuerst prüfen, ob die endgültige Konfigurationsdatei bereits existiert. Falls ja, DARF das Skript KEINE Änderungen vornehmen.

%posttrans
if [ ! -e %{_sysconfdir}/foo/foo.conf ]; then
    ...
fi

Anschließend muss der Wert von VARIANT_ID aus Fedora verwendet werden, um eine der abweichenden Konfigurationsdateien (oder die Standarddatei) an den endgültigen Speicherort der Konfigurationsdatei zu verlinken oder zu kopieren. Dieser Wert wird durch Importieren des Inhalts von /etc/os-release als Shell-Werte ermittelt. Bekannte Werte dieses Feldes sind zum Zeitpunkt der Erstellung dieses Dokuments „atomichost“, „cloud“, „server“ und „workstation“. Weitere Informationen finden Sie in der Handbuchseite zu os-release(5).

. /etc/os-release || :
case "$VARIANT_ID" in
    server)
        ln -sf foo-server.conf %{_sysconfdir}/foo/foo.conf || :
        ;;
    *)
        ln -sf foo-default.conf %{_sysconfdir}/foo/foo.conf || :
        ;;
    esac

Schließlich MUSS der Speicherort der endgültigen Konfigurationsdatei im Abschnitt %files mit %ghost angegeben werden:

%ghost %config(noreplace) %{_sysconfdir}/foo/foo.conf

Zur Nachverfolgung muss das Paket, das die verschiedenen Konfigurationsdateien bereitstellt, auch ein virtuelles Provides: für jede anwendbare Konfigurationsvariante enthalten:

Provides: variant_config(Atomic.host)
Provides: variant_config(Cloud)
Provides: variant_config(Server)
Provides: variant_config(Workstation)