# Freeze (EAS / EDA) from Pipeline

# Vorbereitung

# 01 – Überblick und Voraussetzungen

<p class="callout info">Zielgruppe: Consultants · Stand: 09.11.2026</p>

Du beschreibst ein neues Freeze-Projekt (Archiv-Hosting für Otris EAS/EDA) vollständig in Bitwarden. Die Plattform liest die Angaben automatisch, stellt die benötigte Serverkapazität bereit und richtet das Archiv ein. Als Consultant brauchst du dafür keinen Zugriff auf die technischen Systeme dahinter und startest nichts selbst.

## So läuft die Bereitstellung ab

**Bitwarden → Projektzuweisung → Server-Bereitstellung → Projekt-Bereitstellung → Prüfung in Bitwarden und im EAS Manager**

| Schritt | Was passiert? |
|---|---|
| Bitwarden | Du hinterlegst Projektangaben, Lizenz und Verschlüsselungsschlüssel. |
| Projektzuweisung | Die automatische Verarbeitung liest die Projekte und weist ihnen einen passenden Server zu. Sie gilt gemeinsam für Breeze und Freeze. |
| Server-Bereitstellung | Die benötigten Server werden bereitgestellt oder abgeglichen. |
| Projekt-Bereitstellung | Das EAS-Archiv wird eingerichtet. In der Projekt-Collection entstehen zusätzliche Einträge. |
| Abschluss | Du prüfst die Einträge und die Anmeldung am EAS Manager. |

Das Speichern in Bitwarden startet keinen sofortigen Lauf. Die Änderung wird beim nächsten automatischen Durchlauf berücksichtigt (Zeiten siehe **04 – Automatische Bereitstellung abwarten**). Danach braucht die eigentliche Bereitstellung zusätzliche Zeit.

## Breeze und Freeze zusammen

Ein vollständiger Kundenstack besteht aus Breeze (Otris DOCUMENTS) und Freeze (Otris EAS/EDA als Archiv). Beide Projekte beschreibst du getrennt: je eine eigene Projekt-Collection mit eigener Notiz (`brz_project` bei Breeze, `frz_project` bei Freeze). Die Plattform richtet sie unabhängig voneinander ein, kein Feld verweist auf das jeweils andere Projekt. Du kannst die beiden Projekte also in beliebiger Reihenfolge anlegen. Die Anbindung von DOCUMENTS an das EAS-Archiv richtest du nach der Bereitstellung beider Projekte in DOCUMENTS selbst ein. Details dazu klärst du mit dem Plattformteam.

Gemeinsam sind beiden Büchern Tresor, Partner, Standort, Zeitplan der automatischen Durchläufe und die persönlichen Zugänge. Wie du das Breeze-Projekt anlegst, steht im Buch [Breeze from Pipeline](https://docs.squeeze.one/books/breeze-from-pipeline). Gemeinsame Abläufe sind hier kurz beschrieben und verweisen dorthin. Alles, was nur für Freeze gilt, steht vollständig in diesem Buch.

## Das brauchst du vorher

- Zugriff auf die vorgesehene Bitwarden-Organisation und die Projekt-Collection. Zum Anlegen einer Collection gegebenenfalls Unterstützung durch die Bitwarden-Verwaltung.
- Die EAS-Lizenz des Kunden.
- Einen Verschlüsselungsschlüssel für das Projekt (siehe **02 – Projekt in Bitwarden anlegen**). Ohne ihn wird das Projekt nicht eingerichtet.
- Die vereinbarten Projektangaben: Partner, Standort, Größe, technischer Kurzname und Store-Namen (siehe **03 – Projektfelder ausfüllen**).
- Optional: einen persönlichen SSH-Zugang für Server-Zugriffe.

### Persönlichen SSH-Zugang vorbereiten (optional)

Freeze nutzt dieselben persönlichen Logins wie Breeze. Sie liegen in Bitwarden unter **Kundensysteme → Breeze User**. Hast du dort bereits einen Login, verwende ihn weiter. Andernfalls legst du ihn wie im Breeze-Buch auf der Seite **01 – Überblick und Voraussetzungen** beschrieben an. Trage anschließend den eindeutigen Namen des Login-Eintrags in das Feld `freeze_custom_admins` der Notiz `frz_project` ein, bei mehreren Personen durch Kommas getrennt.

<p class="callout warning">Der Wert in <code>freeze_custom_admins</code> bezeichnet den Namen des Bitwarden-Login-Eintrags. Der Login-Eintrag muss eindeutig auffindbar sein. Das Feld legt keine EAS-Benutzer an.</p>

## Drei Namen, die du auseinanderhalten solltest

| Name | Beispiel | Bedeutung |
|---|---|---|
| Projekt-Collection | `Musterfirma Archiv` | Ihr vollständiger Name wird zum Projektnamen. Er steht später als Präfix in den erzeugten Einträgen. |
| Bitwarden-Eintrag | `frz_project` | Fester Name, an dem die Plattform die Projektbeschreibung erkennt. Daneben braucht jedes Projekt das Login `frz_encryption`. |
| Technischer Kurzname | `musterfirma-archiv` | Wert von `freeze_unique_name`. Wird unter anderem für die interne Adresse des EAS Managers und die Namen der Speicherbereiche verwendet. |

## Der Tresor bestimmt die Zielumgebung

Wie bei Breeze ergibt sich die Zielumgebung aus dem Bitwarden-Tresor, in dem du die Projekt-Collection anlegst. Du wählst nichts weiter aus:

- **Kundensysteme:** Systeme realer Kunden, einschließlich Kunden-Testsystemen, sowie Demo-Systeme.
- **Interne Systeme:** interne Entwicklungs- und Vorabsysteme des Plattformteams.

Innerhalb von **Kundensysteme** entscheidet der Partner, ob es ein Produktivsystem oder ein Demo-System ist (siehe **03 – Projektfelder ausfüllen**).

Weiter: **02 – Projekt in Bitwarden anlegen**

# 02 – Projekt in Bitwarden anlegen

<p class="callout info">Zielgruppe: Consultants · Stand: 09.11.2026</p>

Für jedes neue Freeze-Projekt brauchst du eine eigene Collection mit genau einer sicheren Notiz namens `frz_project` und genau einem Login namens `frz_encryption`. Diese Seite zeigt, wie du Collection, Notiz, Lizenz und Schlüssel anlegst.

## 1. Die Projekt-Collection vorbereiten

1. Öffne den für die Zielumgebung vorgesehenen Tresor in Bitwarden (siehe **01 – Überblick und Voraussetzungen**).
2. Lege eine neue Collection an oder verwende die dafür bereitgestellte, noch nicht belegte Projekt-Collection.
3. Verwende einen eindeutigen Projektnamen, beispielsweise `Musterfirma Archiv`. Wähle einen einfachen Namen aus Buchstaben ohne Umlaute, Zahlen, Leerzeichen, Bindestrich und Unterstrich. Beginne mit einem Buchstaben oder einer Zahl und vermeide Leerzeichen am Anfang oder Ende. Verwende keine Schrägstriche, Punkte oder `&`.
4. Stelle sicher, dass sowohl die zuständigen Personen als auch der Automatisierungszugang Zugriff haben. Lass fehlende Berechtigungen durch die Verwaltung ergänzen.

Der vollständige Collection-Name wird als Projektname übernommen. Die Screenshots zur Collection-Anlage findest du im Breeze-Buch auf der Seite **02 – Projekt in Bitwarden anlegen**. Der Ablauf ist bei Freeze identisch.

## 2. Die sichere Notiz anlegen

1. Erstelle in der Collection einen Eintrag vom Typ **Sichere Notiz**.
2. Vergib exakt den Namen `frz_project`.
3. Lege in dieser Collection genau eine Notiz mit diesem Namen an.
4. Trage die Projektfelder als benutzerdefinierte Textfelder ein. Die Feldnamen und Werte stehen auf **03 – Projektfelder ausfüllen**.

## 3. Die EAS-Lizenz einfügen

Kopiere die vollständige, mehrzeilige EAS-Lizenz (`.pem`-Inhalt) in den großen Notiztext der Notiz `frz_project`. Die Zeilenumbrüche müssen erhalten bleiben. Schreibe keine Erläuterungen dazu und verwende weder ein einzeiliges Feld noch einen Anhang. Ohne Zeilenumbrüche im Notiztext wird das Projekt nicht eingerichtet. Der Lizenzinhalt gehört nicht in Chats, Tickets oder E-Mails.

## 4. Das Login `frz_encryption` anlegen

Jedes Freeze-Projekt braucht einen Verschlüsselungsschlüssel. Er verschlüsselt alle Stores des Projekts. Die Plattform erzeugt ihn nie selbst. Du erzeugst ihn mit dem Passwortgenerator von Bitwarden und hinterlegst ihn vor der Bereitstellung in der Projekt-Collection.

1. Erstelle in **derselben** Collection einen Eintrag vom Typ **Login**.
2. Vergib exakt den Namen `frz_encryption`.
3. Erzeuge im Feld **Passwort** mit dem Passwortgenerator einen Schlüssel: Typ **Passwort**, Länge **64**, Groß- und Kleinbuchstaben und Zahlen an, **Sonderzeichen aus**. So enthält der Schlüssel keine verbotenen Zeichen.
4. Lege genau ein Login mit diesem Namen in der Collection an.

| Regel | Wert |
|---|---|
| Länge | 32 bis 128 Zeichen |
| Verbotene Zeichen | Leerraum jeder Art sowie `$`, `;` und `#` |
| Anzahl | genau ein Login `frz_encryption` je Projekt-Collection |
| Änderung | nie ändern, überschreiben oder löschen |

<p class="callout danger">Der Schlüssel darf nach der ersten Verwendung nie geändert oder gelöscht werden. Ein anderer Schlüssel macht alle bereits verschlüsselten Archive des Projekts unlesbar. Der Schlüssel liegt ausschließlich in Bitwarden. Das gilt auch nach einer Kündigung des Projekts.</p>

## 5. Speichern und gegenprüfen

Speichere erst, wenn Projektfelder, Lizenz und Schlüssel vollständig sind. Öffne beide Einträge danach erneut und prüfe Collection-Zuordnung, Feldwerte, Zeilenumbrüche der Lizenz und die Schlüsselregeln. Der nächste automatische Durchlauf berücksichtigt die gespeicherten Einträge (Zeiten siehe **04 – Automatische Bereitstellung abwarten**).

## Die Statusnotiz `frz_project_status`

Neben `frz_project` legt die Plattform in der Projekt-Collection selbst eine zweite Notiz an: `frz_project_status`. Sie ist nur zum Lesen gedacht und deine Änderungen daran werden überschrieben. Sie nennt in Klartext:

- ob das Projekt in Ordnung ist (`Projekt: ok`) oder was an der Projektbeschreibung fehlerhaft ist, zum Beispiel ein fehlendes Pflichtfeld oder ein fehlendes Schlüssel-Login,
- welcher Server zugeteilt wurde, oder dass noch keiner zugeteilt ist,
- einen Hinweis, wenn eine Kündigung vorgemerkt ist, und
- einen Hinweis, wenn eine gelöschte Notiz wiederhergestellt wurde.

<p class="callout success">Die Statusnotiz ist deine erste Anlaufstelle, wenn etwas nicht wie erwartet läuft. Sie prüft allerdings nicht alles: Kurzname, Store-Liste und Lizenz fallen erst bei der Einrichtung auf (siehe <strong>06 – Probleme und spätere Änderungen</strong>).</p>

Weiter: **03 – Projektfelder ausfüllen**

# 03 – Projektfelder ausfüllen

<p class="callout info">Zielgruppe: Consultants · Stand: 09.11.2026</p>

Lege die folgenden Angaben als **benutzerdefinierte Textfelder** in `frz_project` an. Kopiere die Feldnamen exakt und lege jeden Namen nur einmal an. Die Beispielwerte sind fiktiv und müssen zu deinem Auftrag passen.

## Angaben für ein neues Projekt

| Feldname | Was trägst du ein? | Beispiel |
|---|---|---|
| `freeze_partner` | Den für diesen Tresor eingerichteten Partnerwert, siehe Tabelle unten. Kleinschreibung. | `dexpro` |
| `freeze_ressource_sizing` | Die vereinbarte Größe: `small`, `medium` oder `large`. | `small` |
| `freeze_deployment_site` | Das vereinbarte Standortkürzel. Derzeit gibt es nur `bre1`. | `bre1` |
| `freeze_unique_name` | Einen abgestimmten, eindeutigen technischen Kurznamen. Verwende kleine Buchstaben, Zahlen und bei Bedarf Bindestriche, und halte ihn kurz (siehe unten). | `musterfirma-archiv` |
| `freeze_eas_stores` | Die Namen der Stores, durch Kommas getrennt (siehe unten). Mindestens ein Store. | `archiv,rechnungen` |

**Achte auf die Schreibweise `freeze_ressource_sizing`:** Sie ist mit doppeltem „s“ geschrieben und muss genau so angelegt werden.

Die EAS-Lizenz gehört nicht in ein Feld, sondern in den Notiztext (siehe **02 – Projekt in Bitwarden anlegen**).

### Welche Partner gibt es?

Je nach Tresor sind nur bestimmte Partner freigeschaltet:

| Tresor und Umgebung | Partner |
|---|---|
| Kundensysteme, Produktivsysteme | `dexpro`, `mdt`, `easycompetence` |
| Kundensysteme, Demo-Systeme | `demo` |
| Interne Systeme des Plattformteams | `dev`, `pre-dev` |

Eine nicht freigeschaltete Kombination aus Partner und Standort wird nicht eingerichtet.

<p class="callout warning">Ein Wechsel von <code>freeze_partner</code> oder <code>freeze_deployment_site</code> bei einem bestehenden Projekt ist gesperrt und blockiert die automatische Verarbeitung der gesamten Umgebung, bis die Änderung zurückgenommen ist, nicht nur dieses Projekts. Beides erfordert einen Auftrag an das Plattformteam.</p>

### Was sind Stores?

Ein Store ist ein eigener Archivbereich innerhalb des EAS-Projekts. Das Archiv selbst liegt nicht auf dem Server, sondern je Store in einem eigenen Speicherbereich (Bucket). Für jeden Store legt die Plattform einen Speicherzugang an und hinterlegt ihn als Eintrag in der Projekt-Collection (siehe **05 – Ergebnis prüfen und übergeben**). Du trägst keine Speicherzugangsdaten ein.

Für `freeze_eas_stores` gilt:

- Namen durch Kommas trennen, zum Beispiel `archiv,rechnungen`.
- Erlaubt sind Kleinbuchstaben, Ziffern und Bindestrich. Ein Name beginnt mit einem Buchstaben oder einer Ziffer.
- Kein Name darf der Anfang eines anderen Namens sein. `store1` und `store10` zusammen sind also nicht erlaubt.
- Der Name des Speicherbereichs setzt sich aus Umgebung, Partner, Kurzname und Store-Name zusammen und darf höchstens 63 Zeichen lang sein. Halte Kurzname und Store-Namen deshalb kurz.

Stimme nachträgliche Änderungen an der Store-Liste immer vorher mit dem Plattformteam ab.

## Optionale Angaben

| Feldname | Wann verwenden? | Eingabe |
|---|---|---|
| `freeze_disk_gb` | Wenn das Projekt mehr lokalen Platz als die Standardvorgabe braucht. Das Feld betrifft nur Index, Registry, Audit und Schlüssel auf dem Server, nicht das Archiv. | Ganze Zahl in GB. Ohne Wert rechnet die Plattform mit 10 GB. Ein nicht numerischer Wert macht die Projektbeschreibung fehlerhaft. |
| `freeze_custom_admins` | Wenn vorhandene Consultant-/Administrator-Zugänge eingerichtet werden sollen. | Abgestimmte Namen von Login-Einträgen, durch Kommas getrennt, zum Beispiel `nachname-a,nachname-b`. |
| `freeze_version` | Wenn für das Projekt eine bestimmte freigegebene EAS-Version vorgegeben wurde. | Exakt die freigegebene Versionskennung. Ohne Wert gelten die Plattformvorgaben. |
| `freeze_eas_s3_provider` | Nur nach Absprache, um den Speicheranbieter festzulegen. | `gridscale` oder `wasabi`. Ohne Wert gilt `gridscale`. In Kundensystemen und Demo-Systemen ist nur `gridscale` zulässig. |
| `freeze_decommission` | Nur zum Stilllegen eines Projekts. | Datum `YYYY-MM-DD`. Lies zuerst **07 – Projekt kündigen**. |

Die Benutzer für `freeze_custom_admins` müssen als eindeutig auffindbare Login-Einträge in der Organisation **Kundensysteme**, Collection **Breeze User**, vorhanden sein. Die Plattform übernimmt daraus Benutzername und Zugang für administrative Server-Zugänge. Das Feld legt keine EAS-Benutzer an.

<p class="callout warning">Ein Größenwechsel (<code>freeze_ressource_sizing</code>) bestehender Projekte sowie eine Änderung von <code>freeze_disk_gb</code> sind Änderungen an der Serverzuweisung. Stimme sie vorher mit dem Plattformteam ab. Die Größe <code>enterprise</code> gibt es bei Freeze nicht; sie macht die Projektbeschreibung fehlerhaft.</p>

## Welche Projektgröße?

| Größe | Einordnung für die Planung |
|---|---|
| `small` | Kleinste Stufe. |
| `medium` | Mittlere Stufe. |
| `large` | Größte Stufe. |

Übernimm die im Auftrag vereinbarte Größe. Die Plattform entscheidet über die konkrete Serverzuweisung; du musst keinen Servernamen eintragen.

## Kurz-Checkliste vor dem Speichern

- ☐ Alle fünf Projektangaben ausgefüllt, Partner und Standort passen zum Tresor.
- ☐ Kurzname eindeutig und kurz, Store-Namen gültig und ohne Präfix-Überschneidung.
- ☐ Vollständige, mehrzeilige Lizenz im Notiztext.
- ☐ Genau ein Login `frz_encryption` mit gültigem Schlüssel in derselben Collection.
- ☐ Optionale Admin-Einträge vorhanden und eindeutig auffindbar.
- ☐ Eintrag gespeichert; keine Beispielwerte versehentlich übernommen.

Weiter: **04 – Automatische Bereitstellung abwarten**

# Bereitstellung

# 04 – Automatische Bereitstellung abwarten

<p class="callout info">Zielgruppe: Consultants · Stand: 09.11.2026</p>

Nach dem Speichern in Bitwarden ist deine Eingabe abgeschlossen. Die technische Bereitstellung läuft automatisch im Hintergrund. Als Consultant musst du nichts starten oder freigeben. Diese Seite sagt, wann die Plattform deine Eingabe aufgreift und wie lange du mit Wartezeit rechnen solltest. Der Zeitplan ist derselbe wie bei Breeze.

## Was automatisch passiert

1. Der nächste planmäßige Durchlauf liest die Projekt-Collections aus Bitwarden.
2. Das neue Projekt wird anhand von Partner, Standort und Größe einem geeigneten Server zugewiesen.
3. Falls zusätzliche Serverkapazität benötigt wird, wird sie automatisch bereitgestellt.
4. Der EAS-Container mit den Stores, die Speicherzugänge, die EAS-Konten und die zugehörigen Bitwarden-Einträge werden eingerichtet.

## Wann läuft die Verarbeitung?

Die Verarbeitung startet automatisch zu festen Uhrzeiten (Zeitzone Berlin):

| Tresor und Partner | Durchläufe pro Tag |
|---|---|
| Kundensysteme, Produktivsysteme (`dexpro`, `mdt`, `easycompetence`) | 01, 08, 13 und 18 Uhr |
| Kundensysteme, Demo-Systeme (`demo`) | 01 und 18 Uhr |

Eine Neuanlage wird bei jedem dieser Durchläufe verarbeitet. Die längste Wartezeit bis zum Beginn des nächsten Durchlaufs beträgt damit 7 Stunden bei Produktivsystemen und 17 Stunden bei Demo-Systemen (nach dem Lauf um 01 Uhr bis zum Lauf um 18 Uhr). Die anschließende Server- und Projektbereitstellung braucht zusätzliche Zeit. Änderungen an bestehenden Projekten werden in der Regel erst im nächtlichen Vollabgleich um 01 Uhr berücksichtigt.

## Während der Wartezeit

- Lege keine zweite Projekt-Collection und keine zweite Notiz namens `frz_project` an.
- Lege kein zweites Login `frz_encryption` an und ändere den Schlüssel nicht.
- Verschiebe oder lösche die Projekt-Collection nicht.
- Ändere keine Werte auf Verdacht, solange kein eindeutiger Fehler bekannt ist.
- Ein manueller Start oder eine Freigabe durch den Consultant ist nicht erforderlich.

## Woran erkennst du die Fertigstellung?

Aktualisiere nach dem Durchlauf deine Bitwarden-Ansicht. Die Bereitstellung hat stattgefunden, wenn in der Projekt-Collection neben `frz_project` und `frz_encryption` die erwarteten, von der Automatisierung erzeugten Einträge erscheinen und die Notiz `frz_project_status` `Projekt: ok` und einen zugeteilten Server nennt. Prüfe danach die Anmeldung am EAS Manager wie auf Seite 05 beschrieben.

Fehlen die Einträge auch nach dem nächsten Durchlauf und zusätzlicher Bereitstellungszeit, lies zuerst die Notiz `frz_project_status` und prüfe danach deine Bitwarden-Eingaben anhand von Seite 06.

Weiter: **05 – Ergebnis prüfen und übergeben**

# 05 – Ergebnis prüfen und übergeben

<p class="callout info">Zielgruppe: Consultants · Stand: 09.11.2026</p>

Das Projekt ist bereit zur Übergabe, wenn die automatisch erzeugten Bitwarden-Einträge vorhanden sind und du die Anmeldung am EAS Manager und die Stores geprüft hast. Diese Seite führt dich durch die Prüfung.

## 1. Ergebnis in Bitwarden prüfen

Aktualisiere die Projekt-Collection nach dem automatischen Durchlauf (Zeiten siehe **04 – Automatische Bereitstellung abwarten**). Öffne zuerst die Notiz `frz_project_status`: Sie soll `Projekt: ok` und einen zugeteilten Server nennen. Neben `frz_project` und `frz_encryption` legt die Automatisierung folgende Einträge mit dem Projektnamen als Präfix an:

| Eintrag | Wofür ist er gedacht? |
|---|---|
| `<Projektname> Freeze EAS Administrator` | Anmeldung am EAS Manager mit der Rolle Administrator. Der Eintrag enthält die Adresse des EAS Managers. |
| `<Projektname> Freeze EAS Keeper` | Anmeldung am EAS Manager mit der Rolle Keeper. |
| `<Projektname> Freeze EAS Guest` | Anmeldung am EAS Manager mit der Rolle Guest. |
| `<Projektname> Freeze EAS User` | Anmeldung am EAS Manager mit der Rolle User. |
| `<Projektname> Freeze Portainer` | Technische Container-Verwaltung auf dem zugewiesenen Server. |
| `<Projektname> Freeze Traefik Dashboard` | Technische Routing-Übersicht auf dem zugewiesenen Server. |
| `<Kurzname> <Partner> S3 <Store>` (je Store ein Eintrag) | Zugang zum Speicherbereich des Stores. Das Feld `bucket` nennt den Namen des Speicherbereichs. |

Die Passwörter der EAS-Konten erzeugt die Plattform. Du musst sie nicht selbst vergeben.

<p class="callout warning">Behandle die Speicherzugänge der Stores und die EAS-Zugänge vertraulich. Gib sie nur nach Absprache mit der Projektbetreuung weiter.</p>

## 2. Anmeldung am EAS Manager prüfen

1. Öffne die Adresse aus dem Eintrag `<Projektname> Freeze EAS Administrator`.
2. Prüfe, ob die Seite ohne Zertifikatswarnung oder Serverfehler erreichbar ist.
3. Melde dich mit dem Konto aus dem Eintrag an.
4. Prüfe, ob alle Stores aus `freeze_eas_stores` angezeigt werden.
5. Führe einen für das Projekt vereinbarten kurzen Funktionstest aus, sofern ein Test vorgesehen ist.

<p class="callout warning">Die Adresse des EAS Managers ist eine interne Adresse. Gib sie nicht als Kundenadresse weiter.</p>

Welche Zugänge der Kunde erhält und wie sie übergeben werden, klärst du mit der zuständigen Projektbetreuung.

## 3. SSH-Zugang prüfen

Wenn für deinen Auftrag ein SSH-Zugang vorgesehen ist (Feld `freeze_custom_admins`), verbinde dich mit dem bereitgestellten Server und den für dich hinterlegten Zugangsdaten, am besten mit VS Code. Prüfe, ob die Anmeldung gelingt.

Weiter: **06 – Probleme und spätere Änderungen**

# 06 – Probleme und spätere Änderungen

<p class="callout info">Zielgruppe: Consultants · Stand: 09.11.2026</p>

Als Consultant prüfst du die Bitwarden-Eingaben und das von außen sichtbare Ergebnis. Wenn sich ein Problem nicht in Bitwarden beheben lässt, gibst du die beobachtbaren Angaben an das Plattformteam weiter. Diese Seite hilft bei Fehlersuche und bei späteren Änderungen an bestehenden Projekten.

## Häufige Situationen

| Beobachtung | Was du prüfen oder veranlassen solltest |
|---|---|
| Nach dem nächsten Durchlauf fehlen die erzeugten Bitwarden-Einträge | Berücksichtige zusätzliche Bereitstellungszeit (Zeiten siehe **04 – Automatische Bereitstellung abwarten**). Lies dann die Notiz `frz_project_status`: Sie nennt, ob die Projektbeschreibung fehlerhaft ist und warum, zum Beispiel `fehlerhaft: freeze_partner fehlt (nicht angelegt)`. Prüfe danach den richtigen Tresor, die Collection-Zuordnung, genau eine sichere Notiz namens `frz_project`, die Pflichtfelder und das Login `frz_encryption`. |
| Die Statusnotiz nennt `kein Login frz_encryption`, `Logins frz_encryption` (mehrere) oder `frz_encryption-Schlüssel ungültig` | Das Projekt wird nicht eingerichtet. Lege genau ein Login `frz_encryption` mit gültigem Schlüssel in derselben Collection an (siehe **02 – Projekt in Bitwarden anlegen**). Ändere niemals den Schlüssel eines bereits genutzten Projekts. |
| Die Statusnotiz nennt `freeze_ressource_sizing fehlt oder ungültig` | Prüfe die Schreibweise des Feldnamens und den Wert. Erlaubt sind `small`, `medium` und `large`. `enterprise` gibt es bei Freeze nicht. |
| Die Statusnotiz nennt `freeze_disk_gb ungültig` | Trage eine ganze Zahl ein oder entferne das Feld. |
| Die Statusnotiz zeigt `Projekt: ok` und einen Server, aber die erzeugten Einträge fehlen auch nach zusätzlicher Bereitstellungszeit | Die Statusnotiz prüft Kurzname, Store-Liste und Lizenz nicht. Prüfe `freeze_unique_name`, `freeze_eas_stores` (Schreibweise, kein Name als Anfang eines anderen, Gesamtlänge) und die Lizenz im Notiztext (vollständig, mehrzeilig). Sind alle Angaben korrekt, informiere das Plattformteam. |
| Das Projekt erscheint in der falschen Umgebung | Prüfe, ob die Collection im richtigen Tresor liegt und der Partner dazu passt. Kundensysteme und Demo-Systeme gehören in **Kundensysteme** (Demo mit Partner `demo`), interne Entwicklungssysteme des Plattformteams in **Interne Systeme**. |
| Der EAS Manager ist nicht erreichbar oder die Anmeldung scheitert | Vergleiche die Adresse mit dem Eintrag `<Projektname> Freeze EAS Administrator` und verwende das Konto aus dem Eintrag. Ist der Server noch nicht zugeteilt oder fehlt der Eintrag, warte den nächsten Durchlauf ab. Besteht das Problem weiter, informiere das Plattformteam. |
| Ein Store erscheint nicht im EAS Manager | Prüfe die Schreibweise in `freeze_eas_stores` (Kleinbuchstaben, Ziffern, Bindestrich, kein Name als Anfang eines anderen). Ändere die Liste nicht auf Verdacht, sondern stimme dich mit dem Plattformteam ab. |

## Nach einer Korrektur

Korrigiere den bestehenden Eintrag in Bitwarden und speichere ihn. Lege keine zweite Collection, keine zweite Notiz und kein zweites Login `frz_encryption` an. Die Änderung wird beim nächsten automatischen Durchlauf berücksichtigt. Korrekturen an bestehenden Projekten wirken in der Regel erst im nächsten nächtlichen Vollabgleich um 01 Uhr. Warte danach erneut die zusätzliche Bereitstellungszeit ab.

Wenn bereits Teile des Projekts angelegt wurden oder die Ursache unklar ist, stimme die Änderung vorab mit dem Plattformteam ab.

## Bestehende Projekte ändern

Änderungen an Tresor, Collection-Name, Kurzname, Partner, Standort, Größe oder Store-Liste sind keine harmlose Korrektur der Anzeige. Sie können Projektidentität, Adresse, Archivbereiche oder Serverzuweisung betreffen. Stimme sie vor dem Speichern mit dem Plattformteam ab. Das gilt auch für Versionswechsel und für `freeze_disk_gb`.

<p class="callout danger">Partner- und Standortwechsel sind gesperrt und blockieren die automatische Verarbeitung der gesamten Umgebung, bis sie zurückgenommen sind. Größenwechsel bestehender Projekte stimmst du immer mit dem Plattformteam ab. Beides erfordert einen Auftrag an das Plattformteam.</p>

<p class="callout danger">Ändere oder lösche niemals das Login <code>frz_encryption</code> eines Projekts, das schon Archivdaten enthält. Die Archive sind danach nicht mehr lesbar.</p>

Das Löschen oder Verschieben der Notiz `frz_project` oder der Collection pausiert oder entfernt kein Projekt. Fehlt nur die Notiz, versucht die Plattform sie wiederherzustellen. Gelingt das nicht, bleibt das Projekt unverändert stehen und die Statusnotiz nennt den Grund. Willst du ein Projekt stilllegen, lies **07 – Projekt kündigen**.

## Was du dem Plattformteam mitgibst

Nenne Projektname, Tresor, Partner, Standort, den Zeitpunkt der letzten Änderung und die genaue sichtbare Fehlermeldung. Ergänze kurz, welche Angaben zuletzt geändert wurden, und nenne den Inhalt der Notiz `frz_project_status`. Verweise auf die Bitwarden-Collection; kopiere keine Passwörter, Schlüssel, Speicherzugangsdaten oder Lizenzinhalte in die Anfrage.

# 07 – Projekt kündigen

<p class="callout info">Zielgruppe: Consultants · Stand: 09.11.2026</p>

Ein Freeze-Projekt wird ausschließlich über die Kündigung abgebaut: Du trägst in `frz_project` ein Abbaudatum ein. Löschen oder Verschieben von Notiz oder Collection baut nie ein Projekt ab. Diese Seite zeigt, wie die Kündigung funktioniert und was beim Abbau passiert.

<p class="callout danger">Beim Abbau werden der EAS-Container, seine Volumes und das gesamte Projektverzeichnis auf dem Server unwiderruflich gelöscht. Dazu gehören Index, Registry, Audit, Richtlinien, Signaturschlüssel und Lizenz. Die Archivdaten liegen im Speicherbereich je Store und bleiben dort bestehen, sind aber ohne das Login <code>frz_encryption</code> nicht lesbar. Setze das Datum nur nach ausdrücklicher Freigabe durch die Projektbetreuung und erst, wenn die Datenübergabe geklärt ist.</p>

## Voraussetzungen

- Eine ausdrückliche Freigabe der Projektbetreuung für den Abriss.
- Geklärte Datenübergabe. Verlasse dich nicht darauf, dass die Plattform vor dem Abbau etwas für dich bereitstellt.
- Zugriff auf die Notiz `frz_project` des Projekts.

## Vorgehen

1. Öffne die sichere Notiz `frz_project` des Projekts.
2. Lege ein zusätzliches benutzerdefiniertes Textfeld `freeze_decommission` an.
3. Trage das Abbaudatum im Format `YYYY-MM-DD` ein, zum Beispiel `2026-12-31`. Das Datum muss ein echtes Kalenderdatum sein.
4. Speichere die Notiz.

<p class="callout warning">Ein Datum von heute oder aus der Vergangenheit löst den Abbau schon beim nächsten Durchlauf aus. Prüfe das Datum vor dem Speichern doppelt.</p>

## Prüfen/Ergebnis

Das Datum bestimmt, wann der Abbau passiert (Zeitzone Berlin):

| Zeitpunkt | Was passiert? |
|---|---|
| Vor dem Datum | Das Projekt läuft normal weiter. Die Notiz `frz_project_status` zeigt `Hinweis: Kündigung zum <Datum>`. |
| Ab dem Datum (der Tag selbst zählt mit) | Beim nächsten automatischen Durchlauf wird das Projekt abgebaut (Zeiten siehe **04 – Automatische Bereitstellung abwarten**). Die Notiz `frz_project` bleibt bestehen, die Statusnotiz zeigt `gekündigt, Abbau ab <Datum>`. |
| Ungültiges Datum | Das Projekt wird nicht abgebaut, sondern eingefroren. Die Statusnotiz nennt den Fehler. |

<p class="callout success">Du erkennst eine gültige Kündigung am Hinweis <code>Kündigung zum &lt;Datum&gt;</code> in der Notiz <code>frz_project_status</code>.</p>

## Was beim Abbau passiert

1. **Sicherung:** In Kundensystemen und Demo-Systemen sichert die Plattform vor dem Abbau jeden Store verschlüsselt in dessen eigenen Speicherbereich. Gelingt die Sicherung nicht oder lässt sie sich nicht verifizieren, wird das Projekt nicht abgebaut. In internen Systemen des Plattformteams gibt es diese Sicherung nicht.
2. **Abbau auf dem Server:** Der EAS-Container, seine Volumes und das Projektverzeichnis werden gelöscht.
3. **Was bleibt:** Der Speicherbereich je Store mit Archivdaten und Sicherung, der zugehörige Speicherzugang samt Bitwarden-Eintrag `<Kurzname> <Partner> S3 <Store>` (in Kundensystemen und Demo-Systemen) und das Login `frz_encryption`.

## Stolperfallen

- Ohne das Feld `freeze_decommission` baut die Plattform nie ein Projekt ab. Fehlt die Notiz oder ist sie ungültig, wird das Projekt eingefroren und nicht abgebaut (siehe **06 – Probleme und spätere Änderungen**).
- Willst du die Kündigung zurücknehmen, entferne das Feld, solange der Abbau noch nicht gelaufen ist. Nach dem Abbau lässt sich das Projekt nicht aus Bitwarden wiederherstellen.
- Lösche das Login `frz_encryption` auch nach der Kündigung nie. Ohne den Schlüssel sind die Archive im Speicherbereich nicht mehr lesbar.
- Die übrigen zum Projekt erzeugten Zugangseinträge (EAS-Konten, Portainer, Traefik Dashboard) gehören zum Projekt und verschwinden voraussichtlich mit ihm. Kläre die Übergabe benötigter Zugänge vorher mit der Projektbetreuung.
- Brauchst du nach dem Abbau Daten aus der Sicherung, sprich vorher mit dem Plattformteam.

Weiter: zurück zu **06 – Probleme und spätere Änderungen**