1. Version 7.2.0 - 11.05.2021
Highlights
Seit Version 5.0.0 unterliegen Erstellung und Bearbeitung von API-Keys der Bedingung, dass _id
und key
denselben Wert besitzen müssen. Bestehende API-Keys waren von dieser Regel zunächst ausgenommen. Ab dieser Version werden regelwidrige API-Keys automatisch ermittelt und unter neuer _id
gespeichert.
Vor jeder Migration von API-Keys wird ein Backup der apikey-Collection erstellt, wobei der Name der Backup-Collection zur leichteren Identifizierung das aktuelle Datum und die Uhrzeit enthält.
Die Migrationslogik wird in einer zukünftigen Version wieder entfernt werden.
Aktualisierungshinweis
Wenn API-Keys mit widersprüchlichen Berechtigungen gefunden werden, können diese nicht migriert werden. In solch einem Fall wird eine Log-Nachricht mit dem Präfix [ACTION REQUIRED]
geschrieben. Achten Sie bitte auf diese Meldung, um Ihre API-Keys entsprechend manuell zu migrieren.
Neue Features
ID | Beschreibung |
---|---|
CAAS-1630 |
Automatische Migration von API-Keys, die nicht die in Version 5.0.0 eingeführte Bedingung _id == key erfüllen. |
2. Version 7.1.0 - 07.05.2021
Highlights
Der Docker Compose Stack war seit 02/2020 nur noch für Entwicklungszwecke freigegeben. Dieser ist nun mit sofortiger Wirkung abgekündigt und wir empfehlen ab sofort nur noch den Einsatz von Kubernetes als Betriebsplattform.
Bitte beachten Sie, dass keine weiteren Bugfixes oder Funktionen an der Docker Compose Konfiguration implementiert werden und der gesamte Stack Ende 2021 entfernt wird.
Neue Features
ID | Beschreibung |
---|---|
CAAS-1676 |
Abkündigung des Docker Compose Stacks. |
3. Version 7.0.0 - 07.05.2021
Highlights
Das CaaS Admin Interface ist mit sofortiger Wirkung abgekündigt und dessen Deployment im Helm-Chart sowie Docker Compose Stack deaktiviert. Bitte beachten Sie, dass keine weiteren Bugfixes oder Funktionen implementiert werden und das CaaS Admin Interface Ende 2021 entfernt wird.
Aktualisierungshinweis
Das Deployment des CaaS Admin Interface wird im Helm-Chart aufgrund der Deprecation deaktiviert. Wir empfehlen stattdessen die Verwendung eines REST-Clients Ihrer Wahl zur Interaktion mit der REST-Api, insbesondere zur Pflege der API Keys.
Die Deaktivierung des CaaS Admin Interface führt ab jetzt nicht mehr zur automatischen Generierung von Anmeldedaten. Wenn Sie das CaaS Admin Interface bisher auch schon deaktiviert hatten, so müssen Sie daher jetzt im Credentials-Block der custom-values.yaml
die Werte webAdminUser
und webAdminPassword
pflegen. Andernfalls gelten die Vorgabewerte des Charts.
Wenn Sie das CaaS Admin Interface weiterhin verwenden möchten, müssen Sie es in der custom-values.yaml
Ihres Helm-Deployments wieder aktivieren.
Die Deaktivierung des CaaS Admin Interface wird ebenfalls im Docker Compose Stack vollzogen.
Wenn es weiterhin genutzt werden soll, müssen Sie die Kommentare in der docker-compose.yml
entfernen.
Neue Features
ID | Beschreibung |
---|---|
CAAS-1660 |
Abkündigung der CaaS-Admin-Schnittstelle und standardmäßige Deaktivierung des Deployments. |
4. Version 6.3.0 - 06.05.2021
Neue Features
ID | Beschreibung |
---|---|
CAAS-1667 |
Alle Migrationshinweise können zukünftig vollumfänglich den Releasenotes entnommen werden, so dass das separate Dokument "Migration Guide" von nun an nicht mehr weitergeführt wird. |
5. Version 6.2.1 - 03.05.2021
Behobene Fehler
ID | Beschreibung |
---|---|
CAAS-1666 |
Die Erstellung und Bearbeitung von API-Keys in der Admin-Webapp wurde korrigiert. Zusätzlich verwendet das Laden von API-Keys in der Admin-Webapp jetzt pagesize=100, da kein Paging implementiert ist. Beachten Sie, dass das Arbeiten mit mehr als 100 API-Keys in der Admin-Webapp nicht unterstützt wird. Bitte verwenden Sie in solchen Situationen stattdessen einen REST-Client. |
6. Version 6.2.0 - 29.04.2021
Neue Features
ID | Beschreibung |
---|---|
CAAS-1447 |
Die Dokumentationsartefakte der CaaS-Plattform wurden in eine separate Kachel auf der Dokumentations-Landingpage verschoben. |
7. Version 6.1.3 - 23.04.2021
Behobene Fehler
ID | Beschreibung |
---|---|
CAAS-1637 |
Alle expliziten pagesize-Parameter wurden aus den Aufrufen der Admin-Webapp entfernt. |
8. Version 6.1.2 - 22.04.2021
Behobene Fehler
ID | Beschreibung |
---|---|
CAAS-1654 |
Die interne Testausführung in einer dockerisierter CI-Umgebung wurde vereinfacht. |
9. Version 6.1.1 - 19.04.2021
Behobene Fehler
ID | Beschreibung |
---|---|
CAAS-1570 |
Sicherheitslücke bei Nutzung von Sicherheitstokens im Multitenant Betrieb behoben. |
10. Version 6.1.0 - 15.04.2021
Neue Features
ID | Beschreibung |
---|---|
CAAS-1625 |
Die Initialisierung der Datenbank wurde von deren Konfiguration getrennt und in den Rest-API-Container verschoben. |
11. Version 6.0.2 - 14.04.2021
Behobene Fehler
ID | Beschreibung |
---|---|
CAAS-1645 |
Es wurde ein Fehler bei der API Key-Validierung behoben, der PUT Requests für API Keys abgelehnt hat, wenn die ID nicht ausschließlich alphanumerische Zeichen, Bindestrich oder Unterstrich enthielt. |
12. Version 6.0.1 - 12.04.2021
Behobene Fehler
ID | Beschreibung |
---|---|
CAAS-1644 |
Es wurde ein Fehler bei der API-Key Validierung behoben, der zu einer HTTP 500-Antwort statt einer HTTP 400-Antwort führte, wenn der Wert des |
13. Version 6.0.0 - 06.04.2021
Aktualisierungshinweis
Bitte beachten Sie, dass die neuen Standard Werte für default-pagesize
und max-pagesize
verringert wurden. Dies führt dazu, dass Requests mit explizit gesetztem pagesize
Query-Parameter und einem Wert größer 100 mit HTTP 400 Bad Request abgelehnt werden.
Falls Sie explizit Antworten mit mehr als 100 Dokumenten wünschen oder benötigen, können Sie diese Parameter in ihren custom-values.yaml
entsprechend anpassen.
Neue Features
ID | Beschreibung |
---|---|
CAAS-1540 |
Es wurden Konfigurationsmöglichkeiten für die Parameter |
14. Version 5.0.0 - 06.04.2021
Aktualisierungshinweis
Mit dieser Version geht die Plattform restriktiver mit dem Anlegen von API Keys um. Es werden von nun an nur PUT bzw. POST Requests angenommen, die folgende Richtlinien erfüllen:
-
Jeder POST Request muss zusätzlich den Parameter
_id
beinhalten, welcher dem gleichzeitig mitzusendendenkey
Parameter entsprechen muss. -
Jeder PUT Request muss jetzt auf eine ID zeigen, welche gleich dem
key
Parameter sein muss.
Diese Änderung sorgt langfristig dafür, dass das Erstellen von mehreren API Key-Einträgen mit identischem key
Parameter nicht mehr möglich ist. Dadurch stellen wir sicher, dass ein API Key über die Platform eindeutig bleibt.
Bereits existierende API Keys sind von dieser Änderung nicht betroffen, und deren Funktionalität bleibt weiterhin bestehen.
Neue Features
ID | Beschreibung |
---|---|
CAAS-1501 |
Es wurde eine erweiterte Validierung beim Anlegen und Bearbeiten vom API Keys implementiert. |
15. Version 4.0.8 - 06.04.2021
Behobene Fehler
ID | Beschreibung |
---|---|
CAAS-1624 |
Aktualisierung von RESTHeart auf Version 5.3.4 aufgrund der Behebung von Sicherheitsproblemen in RESTHeart. |
16. Version 4.0.5 - 17.03.2021
Behobene Fehler
ID | Beschreibung |
---|---|
CAAS-1609 |
Aktualisierung von RESTHeart auf Version 5.3.3 aufgrund der Behebung von Sicherheitsproblemen in RESTHeart. |
17. Version 4.0.4 - 11.03.2021
Behobene Fehler
ID | Beschreibung |
---|---|
CAAS-1583 |
Es wird nun erzwungen, dass MongoDB beim Start von Rest-API-Instanzen als ReplicaSet läuft. Dies kann vor allem beim ersten Start in Kubernetes nicht der Fall sein, da MongoDB während des Bootstrappings erreichbar ist. Für den Moment werden wir den Start der Rest-API-Instanzen fehlschlagen lassen. Eine nachhaltigere Lösung erfordert einige Änderungen an den MongoDB-Konfigurationen und wird vorerst zurückgestellt. |
18. Version 4.0.3 - 11.03.2021
Behobene Fehler
ID | Beschreibung |
---|---|
CAAS-1596 |
RESTHeart wurde auf Version 5.3.2 aktualisiert, um potenzielle |
19. Version 4.0.2 - 05.03.2021
Behobene Fehler
ID | Beschreibung |
---|---|
CAAS-1468 |
Der Release Prozess wurde an interne Änderungen angepasst. |
20. Version 4.0.1 - 03.03.2021
Behobene Fehler
ID | Beschreibung |
---|---|
CAAS-1468 |
Der Versions-Endpunkt der Rest-API gibt nun wieder die korrekte Release-Version zurück und nicht die Version des Entwicklungsstandes direkt vor dem Release. |
21. Version 4.0.0 - 01.03.2021
Aktualisierungshinweis
Aufgrund des Upgrades auf MongoDB 4.4.4 mussten verschiedene Änderungen an der Docker Compose-Konfiguration vorgenommen werden. Alle Änderungen müssen händisch in vorhandene Konfiguration übertragen werden.
Neue Features
ID | Beschreibung |
---|---|
CAAS-1581 |
MongoDB wurde von 4.4.3 auf 4.4.4 aktualisiert. |
22. Version 3.0.22 - 23.02.2021
Behobene Fehler
ID | Beschreibung |
---|---|
CAAS-1538 |
Kapitel Preview CaaS aus dem Installationskapitel der Dokumentation entfernt. |
23. Version 3.0.21 - 22.02.2021
Neue Features
ID | Beschreibung |
---|---|
CAAS-1534 |
Dokumentation bezüglich Push Benachrichtigungen (Change Streams) hinzugefügt. |
24. Version 3.0.20 - 18.02.2021
Neue Features
ID | Beschreibung |
---|---|
CAAS-1580 |
Aktualisierung der Restheart-Lizenz |
25. Version 3.0.18 - 17.02.2021
Neue Features
ID | Beschreibung |
---|---|
CAAS-1577 |
MongoDB wurde von 4.4 auf 4.4.3 aktualisiert. |
26. Version 3.0.17 - 16.02.2021
Aktualisierungshinweis
Die Werte für die Variable _JAVA_OPTIONS
in docker-compose.yml
wurden korrigiert und müssen manuell in bestehenden Installationen angepasst werden.
Behobene Fehler
ID | Beschreibung |
---|---|
CAAS-1476 |
Um einen stabileren Betrieb zu gewährleisten, wurden die JVM-Flags bzgl. der Heap-Größe im Kubernetes-Stack hinzugefügt und die bestehenden Konfigurationen im Docker-Stack angepasst. |
27. Version 3.0.16 - 16.02.2021
Aktualisierungshinweis
Achtung, mit CAAS-1544 wurde die Docker Compose-Konfiguration verändert. Stellen Sie sicher, dass Sie die Änderungen händisch in Ihre Konfiguration übertragen.
Außerdem basiert der Rest-API-Container nun nicht mehr auf einem Distroless-Basis-Image.
Behobene Fehler
ID | Beschreibung |
---|---|
CAAS-1544 |
Docker Compose-Integration und Tests für Websocket-Unterstützung hinzugefügt. |
28. Version 3.0.14 - 11.02.2021
Neue Features
ID | Beschreibung |
---|---|
CAAS-1564 |
Die kurzlebigen Sicherheitstokens lassen sich nun für beliebige API Keys erzeugen, unabhängig von ihren Berechtigungen. |
29. Version 3.0.11 - 01.02.2021
Behobene Fehler
ID | Beschreibung |
---|---|
CAAS-1500 |
RESTHeart wurde auf Version 5.3.1 aktualisiert. Das Erstellen einer bereits existierenden Datenbank mit abweichender Groß-/Kleinschreibung liefert jetzt einen HTTP 409 Konflikt statt eines internen Serverfehlers zurück. |
30. Version 3.0.9 - 28.01.2021
Neue Features
ID | Beschreibung |
---|---|
CAAS-1532 |
RESTHeart wurde auf Version 5.2.0 aktualisiert |
31. Version 3.0.8 - 21.01.2021
Behobene Fehler
ID | Beschreibung |
---|---|
CAAS-1512 |
Entfernung der WARN-Logausgaben beim Start der Rest-API bzgl. veralteter Konfigurations-Syntax. |
32. Version 3.0.4 - 19.01.2021
Behobene Fehler
ID | Beschreibung |
---|---|
CAAS-1524 |
Entfernung einer irreführenden WARN-Logausgabe aus |
33. Version 3.0.3 - 19.01.2021
Aktualisierungshinweis
Es ist der Wert credentials.caasSecureTokenEncryptionKey
zu den Helm Values hinzugefügt worden. Dieser muss von on-premise Kunden zusammen mit allen anderen Credentials überschrieben werden.
Neue Features
ID | Beschreibung |
---|---|
CAAS-1433 |
Unterstützung für kurzlebige Sicherheitstokens hinzugefügt, welche Authentifizierung per Query Parameter oder Cookie erlauben. |
34. Version 3.0.0 - 11.12.2020
Aktualisierungshinweis
Der Endpunkt PATCH /caas_admin/apikeys/{id}
für die Teilaktualisierung eines API Keys entfällt aufgrund der eingeführten Validierungen. Die vollständige Aktualisierung eines vorhandenen API Keys kann weiterhin über die Endpunkte PUT oder POST durchgeführt werden.
Neue Features
ID | Beschreibung |
---|---|
CAAS-1469 |
Es wurden weitere Validierungen für API Keys implementiert: ab sofort ist es nicht mehr möglich, mehrere API Keys mit demselben |
35. Version 2.17.0 - 10.12.2020
Aktualisierungshinweis
Beim Erstellen und Aktualisieren von API Keys wird jetzt gegen ein JSON-Schema validiert. Bestehende API Keys sind davon nicht betroffen, solange diese nicht geändert werden. Auf das Schema kann unter /caas_admin/_schemas/apikeys
zugegriffen werden.
Der Zugriff auf die interne Datenbank caas_admin
wurde stärker eingeschränkt. Das Lesen aller darin enthaltenen Daten ist natürlich weiterhin erlaubt. Der Schreibzugriff wurde jedoch auf die Verwaltung von API Keys beschränkt. Somit ist das Erstellen, Ändern oder sogar Löschen von Collections oder der gesamten Datenbank selbst nicht mehr möglich. Diese Änderungen verhindern in erster Linie eine nicht funktionierende CaaS-Plattform aufgrund beschädigter Strukturen in der internen Datenbank.
Neue Features
ID | Beschreibung |
---|---|
CAAS-1132 |
Alle neu erstellten oder aktualisierten API Keys werden ab sofort gegen ein JSON-Schema validiert. Darüber hinaus ist der Schreibzugriff auf die interne Datenbank |
36. Version 2.16.1 - 03.11.2020
Behobene Fehler
ID | Beschreibung |
---|---|
CAAS-1457 |
Das CaaS Overview Grafana Dashboard wurde angepasst, so dass die Auswahl des Zeitraums in den angezeigten Restarts berücksichtigt wird. |
37. Version 2.16.0 - 02.11.2020
Aktualisierungshinweis
Sie müssen die CaaS Plattform Version 2.15.0 mit MongoDB in Version 4.4 installiert haben, um ein Upgrade auf CaaS Plattform 2.16 durchführen zu können. Dies ist ein absolut notwendiger Schritt für das MongoDB-Upgrade! Weitere Informationen finden Sie im Migration-Guide.
Neue Features
ID | Beschreibung |
---|---|
CAAS-1342 |
Die MongoDB featureCompatibilityVersion wurde auf 4.4 gesetzt. Wenn Sie den Docker-Stack verwenden, müssen Sie nach dem Upgrade die Anpassungen manuell durchführen. Weitere Informationen finden Sie im Migration-Guide. |
38. Version 2.15.0 - 11.09.2020
Aktualisierungshinweis
Sie müssen mindestens die CaaS Version 2.13.3 installiert haben, um ein Upgrade auf 2.15.x durchführen zu können. Dies ist ein absolut notwendiger Schritt für das MongoDB-Upgrade! Weitere Informationen finden Sie im Migration-Guide.
Neue Features
ID | Beschreibung |
---|---|
CAAS-1341 |
MongoDB wurde von 4.2 auf 4.4 aktualisiert. Der Wert für featureCompatibilityVersion bleibt auf 4.2 und wird mit einer kommenden Version aktualisiert. |
39. Version 2.14.5 - 26.08.2020
Neue Features
ID | Beschreibung |
---|---|
CAAS-1386 |
Die Rest-API weist nun wieder 401 und 403 responses in den Prometheus Metriken aus. |
40. Version 2.14.3 - 20.08.2020
Behobene Fehler
ID | Beschreibung |
---|---|
CAAS-1390 |
Entfernung des Security Proxy aus der "Architektur"-Abbildung der Produktdokumentation |
41. Version 2.14.2 - 17.08.2020
Neue Features
ID | Beschreibung |
---|---|
CAAS-1379 |
Entfernung der Ansi-Farben aus den Logausgaben von RESTheart |
42. Version 2.14.1 - 11.08.2020
Neue Features
ID | Beschreibung |
---|---|
CAAS-1079 |
Ein Grafana-Dashboard für MongoDB wurde hinzugefügt, um eine grundlegende Analyse des Status der MongoDB und möglicher Probleme zu ermöglichen. |
43. Version 2.14.0 - 11.08.2020
Highlights
Es erfolgt eine Aktualisierung auf RESTheart 5.1.4.
Aktualisierungshinweis
Ab dieser Version entfällt der separate "Security Proxy" für Authentifizierung und Autorisierung.
Neue Features
ID | Beschreibung |
---|---|
CAAS-1295 |
RESTHeart wurde auf Version 5.1.4 aktualisiert |
44. Version 2.13.3
Aktualisierungshinweis
Sie müssen die CaaS Plattform Version 2.12.0 mit MongoDB in Version 4.2 installiert haben, um ein Upgrade auf CaaS Plattform 2.13 durchführen zu können. Dies ist ein absolut notwendiger Schritt für das MongoDB-Upgrade! Weitere Informationen finden Sie im Migration-Guide.
Neue Features
ID | Description |
---|---|
CAAS-1101 |
Die MongoDB featureCompatibilityVersion wurde auf 4.2 gesetzt. Wenn Sie den Docker-Stack verwenden, müssen Sie nach dem Upgrade die Anpassungen manuell durchführen. Weitere Informationen finden Sie im Migration-Guide. |
45. Version 2.12.0
Aktualisierungshinweis
Sie müssen mindestens die CaaS Version 2.9.2 installiert haben, um ein Upgrade auf 2.12.x durchführen zu können. Dies ist ein absolut notwendiger Schritt für das MongoDB-Upgrade! Weitere Informationen finden Sie im Migration-Guide.
Neue Features
ID | Description |
---|---|
CAAS-1100 |
MongoDB wurde von 4.0 auf 4.2 aktualisiert. Der Wert für featureCompatibilityVersion bleibt auf 4.0 und wird mit einer kommenden Version aktualisiert. |
46. Version 2.11.41
Behobene Fehler
ID | Description |
---|---|
CAAS-1307 |
RESTHeart wurde auf Version 4.1.17 aktualisiert |
CAAS-1303 |
In den Helm Chart Standardwerten wurde die Einheit des CPU Limit des Containers caas-rest-api-security korrigiert. |
CAAS-1284 |
Grafana Dashboards angepasst, so dass die Auswahl des Zeitraums in den angezeigten Metriken berücksichtigt wird. |
Neue Features
ID | Description |
---|---|
CAAS-1288 |
Ein HTTP-Endpunkt wurde hinzugefügt, um die Version von caas-rest-api unter /_logic/version abzufragen. Dieser Endpunkt ist gesichert und benötigt eine Authentifizierung durch den Admin oder den Metrics-Benutzer. |
47. Version 2.11.34
Highlights
Die Nutzung von Helm 2 wird ab sofort nicht mehr empfohlen. Das Helm-Chart kann bereits jetzt mit Helm 3 installiert werden, ist aber noch mit Helm 2 kompatibel. In einem der kommenden Releases wird das Chart jedoch nur noch Helm 3 unterstützen. Daher raten wir umgehend zur Migration auf Helm 3. Informationen hierzu entnehmen Sie z.B. dem Blog https://helm.sh/blog/migrate-from-helm-v2-to-helm-v3/.
Behobene Fehler
ID | Description |
---|---|
CAAS-1259 |
Entfernung der Keystore- und Truststore-Passwörtern aus caas-docker.env, da die SSL-Unterstützung in Version 2.4.5 weggefallen ist. |
Neue Features
ID | Description |
---|---|
CAAS-1242 |
Helm 3 ist nun Bestandteil unseres Referenz-Systems. Unterstützung von Helm 2 entfällt demnächst. Migration auf Helm 3 wird dringend angeraten. |
48. Version 2.11.28
Behobene Fehler
ID | Description |
---|---|
CAAS-1270 |
Um mit Helm 3 kompatibel zu sein, wurde das Feld "tillerVersion" aus dem Helm-Chart entfernt. Helm 3.x wird noch nicht aktiv unterstützt, dies ist nur als erste Vorbereitung zu sehen. |
49. Version 2.11.23
Behobene Fehler
ID | Description |
---|---|
CAAS-1229 |
Der Resources Block für den caas-rest-api-security Cotainer wurde in den Standardwerten des Helm Charts korrigiert. |
CAAS-1165 |
Datenbank- oder Collection-Namen mit Anführungszeichen, Backslashes oder Zeilenumbrüchen werden nun in den Prometheus-Metriken des REST-Interface korrekt escaped. |
Neue Features
ID | Description |
---|---|
CAAS-1248 |
Die Versionen, die in den Release Notes für die Plattform genannt sind, wurden korrigiert. |
CAAS-1246 |
Um mit Helm 3 kompatibel zu sein, wurde der Wert für apiVersion im Helm-Chart explizit gesetzt. Helm 3.x wird noch nicht aktiv unterstützt, dies ist nur als erste Vorbereitung zu sehen. |
CAAS-1235 |
Das technische Datenblatt wurde aufgetrennt und ist ab sofort jeweils für CaaS-Modul und CaaS-Plattform verfügbar. |
CAAS-1234 |
Die Dokumentation wurde in separate Dokumente für die CaaS-Plattform und das CaaS-Modul aufgetrennt und leicht überarbeitet. Zusätzlich ist eine CaaS Produkt-Dokumentation hinzugekommen, welche als Einstieg dient und auf die separaten Dokumente verweist. |
CAAS-1176 |
Die TraceID Header-Werte werden nun auch im caas-rest-api-security Container geloggt. |
CAAS-1175 |
Die Healthcheck-URL wurde in Version 2.11.5 zu /_logic/healthcheck geändert. Dies wurde jetzt in der Dokumentation und im Migration Guide nachgebessert. |
CAAS-1158 |
RESTheart auf Version 4.1.16 aktualisiert |
50. Version 2.11.5
Highlights
Es erfolgt eine Aktualisierung auf RESTheart 4.1.3 (Platform Edition). Ab dieser Version werden Authentifizierung und Autorisierung durch einen "Security Proxy" durchgeführt.
Aktualisierungshinweis
Bei Entwicklungsinstallationen (docker-compose) ist der Stack neu aufzusetzen, da Änderungen am Datenbank-Setup erforderlich sind.
Das beispielhafte Monitoring Stack Deployment wurde aus dem CaaS Helm Chart entfernt, da es nicht für den produktiven Einsatz vorgesehen war. Bitte installieren Sie Prometheus Operator z. B. mit Hilfe der offiziellen Helm Charts. Dies beinhaltet ein wesentlich umfassenderes Cluster Monitoring. Weitere Informationen finden Sie im Migrationshandbuch und in der Dokumentation.
Die CaaS Grafana-Dashboards wurden so konvertiert, dass sie mehrere Namespaces unterstützen.
Auf die API-Endpunkte der API-Keys kann nur noch mit Basic Auth zugegriffen werden. Selbst authentifizierte API-Keys sind nicht berechtigt, die interne Admin-Datenbank zu lesen oder zu schreiben. Die Admin-Webapp ist hiervon nicht betroffen und funktioniert wie zuvor.
Behobene Fehler
ID | Description |
---|---|
CAAS-1087 |
Requests, die aufgrund von fehlenden oder eingeschränkt verrechteten Credentials abgelehnt wurden, antworten nun korrekt mit 401 / 403 statt immer nur mit 401. |
Neue Features
ID | Description |
---|---|
CAAS-1145 |
Die Nginx-Konfiguration des Preview-CaaS Ingress ist jetzt Teil der Helm Values. |
CAAS-1078 |
RESTheart auf Version 4.1.3 aktualisiert |
CAAS-1009 |
Der Beispiel Monitoring Stack wurde aus den CaaS Helm Charts entfernt und die Grafana Dashboards so erweitert, dass mehrere Namespaces unterstützt werden. |
CAAS-915 |
Der Zugriff auf die "caas_admin"-DB (inkl. aller Collections) wird bei Authentifizierung mittels API-Key unterbunden. |
CAAS-395 |
CaaS-Rest-Api verwendet jetzt sog. Distroless-Container als Basis für die Docker-Images. Dies verringert die Angriffsfläche der Container. |
51. Version 2.10.4
Behobene Fehler
ID | Description |
---|---|
CAAS-1108 |
Die Kubernetes Ingress-Definition für den Preview CaaS hat nun eigene Werte für Annotationen und Cert-Manager/TLS, anstatt die Werte des CaaS Ingress zu verwenden. |
52. Version 2.10.0
Aktualisierungshinweis
Das CaaS-Modul und die CaaS-Platform wurden für die interne Entwicklung voneinander getrennt, jedoch aktuell noch gemeinsam ausgeliefert. Dies hat zur Folge, dass die Versionsnummern innerhalb der Auslieferung nicht mehr gleich sind und sich in Zukunft unabhängig voneinander entwickeln werden.
Behobene Fehler
ID | Description |
---|---|
CAAS-1055 |
Der HTTPS-Port wurde aus der Kubernetes-Service-Definition der Rest-API entfernt, da die SSL-Unterstützung in Version 2.4.5 entfernt wurde. |
Neue Features
ID | Description |
---|---|
CAAS-1083 |
Das CaaS-Modul und die CaaS-Plattform wurden intern getrennt |
53. Hinweis zu den Versionsnummern
Mit dem Release 2.10 wurde intern die Entwicklung des CaaS-Modul und der CaaS-Plattform getrennt. Ab diesem Zeitpunkt entwickeln sich demnach auch die Versionsnummern dieser Komponenten unabhängig voneinander.
Dies hat zur Folge, dass die Release Notes in diesem Dokument oberhalb dieses Hinweis nur noch für die CaaS-Plattform aufgeführt werden. Unterhalb dieses Hinweis werden jedoch aus historischen Gründen noch die bisher kombinierten Release Notes von CaaS-Modul und CaaS-Plattform aufgelistet.
54. Version 2.9.2
Aktualisierungshinweis
Sie müssen die CaaS Version 2.8.6 mit MongoDB in Version 4.0 installiert haben, um ein Upgrade auf CaaS 2.9 durchführen zu können. Dies ist ein absolut notwendiger Schritt für das MongoDB-Upgrade! Weitere Informationen finden Sie im Migration-Guide.
Behobene Fehler
ID | Description |
---|---|
CAAS-1099 |
Fehlende Lese- und Ausführungs-Rechte des MongoDB Bootstrap-Skriptes im Docker Compose Stack wiederhergestellt. |
Neue Features
ID | Description |
---|---|
CAAS-1039 |
Die MongoDB featureCompatibilityVersion wurde auf 4.0 gesetzt. Wenn Sie den Docker-Stack verwenden, müssen Sie nach dem Upgrade die Anpassungen manuell durchführen. Weitere Informationen finden Sie im Migration-Guide. |
55. Version 2.8.6
Highlights
Die Helm-Charts unterstützen die Konfiguration zusätzlicher Ingress-Definitionen, um einen Vorschau- CaaS bereitzustellen, ohne einen zweiten CaaS-Stack zu betreiben. Um zu vermeiden, dass freigegebene und nicht freigegebene Daten vermischt werden, fügen diese Ingress dem Datenbanknamen das Suffix "Preview" hinzu. Nach dem Aktivieren der Preview-Ingress können Sie die Verbindung in der FirstSpirit-Projektkomponente konfigurieren. Weitere Informationen finden Sie in der Dokumentation.
Aktualisierungshinweis
Sie müssen die CaaS Version 2.7.9 installiert haben, um ein Upgrade auf 2.8.x durchführen zu können. Dies ist ein absolut notwendiger Schritt für das MongoDB-Upgrade! Weitere Informationen finden Sie im Migration-Guide.
Behobene Fehler
ID | Description |
---|---|
CAAS-1084 |
Das Grafana-Board pro CaaS-Datenbank zeigt die Antwortzeiten für 4xx/5xx-Responses nun korrekt an. |
CAAS-1082 |
Bei Verwendung einer CaaS-Instanz mit einem HTTP-Kontextpfad muss die Konfiguration des CaaSService im Server-Manager nicht mehr mit einem '/' enden. |
CAAS-1080 |
Erzeugung von Remote-Referenzen im Vorschau-Modus korrigiert. |
CAAS-1076 |
Die Übertragungsdauer in der Übersicht am Ende des CaaS-Auftrags wurde falsch berechnet, wenn Übertragungen wiederholt werden mussten |
CAAS-1054 |
Beim CleanUp wird nun ein 404 als Antwort auf ein Delete-Request akzeptiert. |
CAAS-1012 |
Der Dialog "Verbindung prüfen" zeigt nun den zum Ergebnis passenden Titel an |
Neue Features
ID | Description |
---|---|
CAAS-1031 |
In den Helm Charts können weitere Ingresse aktiviert werden, um eine Preview-CaaS Funktionalität ohne zweiten CaaS-Stack bereitzustellen. |
CAAS-1011 |
MongoDB wurde von 3.6.13 auf 4.0.10 aktualisiert. Der Wert für featureCompatibilityVersion bleibt auf 3.6 und wird mit einer kommenden Version aktualisiert. |
56. Version 2.7.9
Highlights
Die Verbindung zwischen dem FirstSpirit-Modul und der REST-Schnittstelle wurde neu implementiert um robuster und schneller zu sein. Zusätzlich hat sich die Bedeutung der Parallelitätseinstellung in der Servicekonfiguration geändert: Anstatt auf Auftrags- wird die Parallelität nun auf Serverebene konfiguriert und betrifft nur noch Medienverarbeitung.
Aktualisierungshinweis
Sie müssen die CaaS Version 2.6.1 mit MongoDB in Version 3.6 installiert haben, um ein Upgrade auf 2.7.x durchführen zu können. Dies ist ein absolut notwendiger Schritt für das MongoDB-Upgrade! Weitere Informationen finden Sie im Migration-Guide.
Da sich die Bedeutung der Parallelitätskonfiguration in den Serviceeinstellungen geändert hat, sollten Sie Ihre aktuelle Konfiguration überprüfen und gegebenenfalls anpassen. Auftragskonfigurationen die diesen Wert überschrieben haben (mit dem Parameter caasMaxParallelConnections) sind nun wirkungslos. Trotzdessen sie keinen Fehler verursachen, sollten Sie sie entfernen.
Behobene Fehler
ID | Description |
---|---|
CAAS-1052 |
Ein Prometheus Alert wurde hinzugefügt, um mögliche MongoDB Splitbrain Situationen basierend auf den mit CaaS 2.5.7 eingeführten MongoDB-Metriken zu erkennen. |
CAAS-1051 |
Beim Einsatz eines Proxy werden Medien erfolgreich an eine HTTPS REST-Schnittstelle gesendet |
CAAS-1049 |
Seit Release 2.5.7 haben einige Docker-Images im Release-Zip gefehlt, die auf öffentlichen Repositories liegen. Die zum Betrieb benötigten Images sind nun wieder im Release-Zip enthalten. |
CAAS-1048 |
Releases nach Version 2.5.7 enthielten einen Fehler, der Installationen ohne den Monitoring-Stack verhindert haben. Dieses Problem wurde behoben. |
CAAS-997 |
Der Name des Persistent Volume Claim des MongoDB Stateful Sets kann nun in der values.yaml des Helm Charts konfiguriert werden. Beachten Sie, dass der Name des Persistent Volume Claim eines bereits bestehenden Stateful-Sets nicht geändert werden kann! |
CAAS-838 |
CaaS-CleanUp hängt nicht länger eine Generierung hinterher. |
Neue Features
ID | Description |
---|---|
CAAS-1041 |
Dokumentationsabschnitt 'technische Vorraussetzungen' angepasst. |
CAAS-1038 |
Die MongoDB featureCompatibilityVersion wurde auf 3.6 gesetzt. Wenn Sie den Docker-Stack verwenden, müssen Sie nach dem Upgrade die Anpassungen manuell durchführen. Weitere Informationen finden Sie im Migration-Guide. |
CAAS-946 |
Die CaaSConnection-Implementierung wurde ausgetauscht |
CAAS-704 |
Der Ping-Endpunkt (/_logic /metrics /ping) der Rest-API-Instanzen wurde entfernt und die Kubernetes Liveness-Probe auf den Metrics-Endpunkt (/_metrics) umgestellt. |
57. Version 2.6.1
Aktualisierungshinweis
Sie müssen die Version 2.5.7 installiert haben, um ein Upgrade auf 2.6.x durchführen zu können. Dies ist ein absolut notwendiger Schritt für das MongoDB-Upgrade! Weitere Informationen finden Sie im Migration-Guide.
Behobene Fehler
ID | Description |
---|---|
CAAS-1025 |
Die Log-Ausgaben des FirstSpirit-Moduls wurden erweitert. |
Neue Features
ID | Description |
---|---|
CAAS-1040 |
Der Migration Guide ist ab sofort auch auf Englisch verfügbar. |
CAAS-1037 |
RESTheart wurde auf Version 3.10.1 aktualisiert. |
CAAS-891 |
Fehlerbehandlung falls Projektsprache gelöscht wurde. |
CAAS-670 |
MongoDB wurde von 3.4.19 auf 3.6.13 aktualisiert. Der Wert für featureCompatibilityVersion bleibt (im Falle von Upgrades) auf 3.4 und wird mit einer kommenden Version aktualisiert. |
58. Version 2.5.7
Highlights
Wir haben die Normalisierung von Projektnamen (CaaS Datenbanknamen) geändert. Von nun an werden sämtliche Sonderzeichen ausgenommen nicht-führende Unterstriche, sowie Bindestriche in Projektnamen entfernt, sodass resultierende CaaS-Urls keine sonstigen Sonderzeichen mehr enthalten. Die gleichen Regeln gelten nun auch für Collection- und Document-Namen, wobei hier führende Unterstriche erlaubt sind. Für weitere Informationen, schauen Sie bitte in die aktualisierte Dokumentation.
Aktualisierungshinweis
Die Änderung der Normalisierungslogik für alle Teile der CaaS-Urls könnte für Sie unerwünschte Änderungen bedeuten. Bitte lesen Sie sich die Dokumentation zur Änderung aufmerksam durch und kontaktieren Sie uns, wenn Sie Unterstützung bei der Migration benötigen.
Die Kubernetes Liveness Probe für das MongoDB-Statefulset wurde entfernt, um der Datenbank längere Start- und Wiederherstellungszeiten zu ermöglichen. Im Helm Chart können CaaS-spezifische Prometheus Alerts aktiviert werden. Weitere Informationen finden Sie in der Dokumentation.
Wenn die Cleanup-Aktion auch im Fehlerfall ausgeführt wird, wird die Ausführung beim Vorliegen von Übertragungsfehlern unterdrückt. Bei reinen Generierungsfehlern wird die Aktion jedoch trotzdem ausgeführt. Um die Ausführung auch bei Übertragungsfehlern zu erzwingen, setzen Sie caasForceCleanupOnFailedItems auf true.
Behobene Fehler
ID | Description |
---|---|
CAAS-1029 |
Das Executable-Flag für das bootstrap.sh Script der MongoDB im Docker-Compose Stack wurde hinzugefügt. |
CAAS-1017 |
Wiederherstellung der früheren Projektnamennormalisierung |
CAAS-902 |
Die MongoDB Liveness Probe wurde entfernt und durch Prometheus Alerts ersetzt |
CAAS-805 |
Interne Abhängigkeiten der Metadata-Konverter-Klasse reduziert. |
Neue Features
ID | Description |
---|---|
CAAS-901 |
Die MongoDB Helm-Templates wurden aktualisiert und vorbereitend auf kommende Upgrades wurde der featureCompatibilityVersion-Parameter in der Datenbank auf "3.4" gesetzt. Darüber hinaus können nun MongoDB Metriken in den Helm-Values aktiviert werden. |
CAAS-853 |
Das FirstSpirit Metadaten-Template kann nun bei der CaaS-Generierung berücksichtigt werden |
CAAS-790 |
Die Cleanup-Aktion führt bei Übertragungsfehlern keine Löschungen durch |
59. Version 2.4.35
Behobene Fehler
ID | Description |
---|---|
CAAS-1006 |
Alte Klassensignaturen wiederhergestellt |
Neue Features
ID | Description |
---|---|
CAAS-250 |
Die Konfiguration der CaaS Zieldatenbank und Collection im Site Architect ist nicht mehr für alle Benutzer eines Projektes möglich, sondern nur noch für Projekt-Administratoren. |
60. Version 2.4.29
Highlights
Die Eingabekomponenten für URL-Konfigurationen zeigen nun an, wo die einzelnen Teile der resultierenden CaaS-URL herkommen. Beim Speichern einer Konfiguration für ein Element wird nun außerdem nur noch die Eingabe gespeichert, die der Benutzer auch wirklich vorgenommen hat - wird beispielsweise kein Projektname vergeben, so wird nicht der aktuelle Projektname gespeichert, sondern gar keiner. Beim Auflösen der URL wird so automatisch der Projektname aus dem aktuellen FirstSpirit-Projekt verwendet.
Behobene Fehler
ID | Description |
---|---|
CAAS-989 |
Verbesserungen am URL-Handling bei der Generierung |
CAAS-369 |
Die Persistenzschicht für URL-Konfigurationen wurde ausgetauscht. |
Neue Features
ID | Description |
---|---|
CAAS-980 |
Die Admin-Webapp kann im Kubernetes-Stack nun deaktiviert werden, falls sie nicht benötigt wird. |
CAAS-976 |
Minimale Unterstützung für OpenShift vorbereitet |
CAAS-808 |
Die Releasenotes sind ab sofort auch auf Deutsch verfügbar. |
CAAS-426 |
Das Helm Chart unterstützt nun die Konfiguration von Kubernetes-Netzwerkrichtlinien über die Values. Standardmäßig sind alle Richtlinien deaktiviert, können aber mit einer Standard Konfiguration aktiviert und bei Bedarf entsprechend angepasst werden. |
61. Version 2.4.21
Highlights
Betrieb mit Kubernetes ist ab diesem Release nicht mehr im Status "Technical Preview".
Behobene Fehler
ID | Description |
---|---|
CAAS-940 |
Gespeicherte URLs wurden nicht verwendet, wenn die Standard FirstSpirit-Mechanismen für das Mediendeploment verwendet werden sollten, aber Dokumente im CaaS abgelegt werden sollten. |
CAAS-836 |
Gelöst: Datensätze haben in der Preview keine Medien deployed |
Neue Features
ID | Description |
---|---|
CAAS-741 |
RESTheart wurde auf Version 3.9.0 aktualisiert, um Metriken pro Datenbank und Collection zu ermöglichen. Ein neues Grafana-Dashboard zeigt diese Metriken mit Hilfe von Dropdown Filtern an. |
CAAS-578 |
Überarbeitung der CaaS Dokumentation |
62. Version 2.4.16
Aktualisierungshinweis
Mit dieser Änderung können jetzt auch Projektadministratoren, die Einstellugen der CaaS Projektkomponente verändern.
Durch die Nutzung der UrlCreatorAgent API wird nun mindestens die FirstSpirit Version 2019-03 vorausgesetzt.
Behobene Fehler
ID | Description |
---|---|
CAAS-934 |
Aufträge, die den Vorschaustand deployen werden nur dann noch die CaaS Previewl UrlFactory verwenden, wenn die Vorschau in der Projektkomponente komplett konfiguriert wurde. |
CAAS-931 |
Unnötige Requests zum Erstellen der bereits vorhandenen assets.files Collection wurden entfernt. |
CAAS-930 |
Einige fehlgeschlagene HTTP-Verbindungen sind wiederholt worden, obwohl es nicht nötig war (z.B. 403 forbidden). Wiederholungen sind nun auf einige Statuscodes beschränkt. |
CAAS-924 |
Die Berechtigungen im Admin-WebApp-Container wurden korrigiert, um die Verwendung von securityContext.runAsUser zu ermöglichen. |
CAAS-919 |
Anpassung des Preview Service, so dass zum Aktualisieren der Projekt Konfiguration kein Neustart mehr benötigt wird. |
Neue Features
ID | Description |
---|---|
CAAS-888 |
Nutzung der neuen UrlCreatorAgent API |
CAAS-881 |
Das CaaS Modul unterstützt jetzt JDK11 als Laufzeitumgebung für FirstSpirit |
CAAS-878 |
Remote-Medien können in der Preview nun auch aus FirstSpirit gestreamed werden |
63. Version 2.4.5
Aktualisierungshinweis
Bitte beachten Sie, dass diese Aktualisierung eine Aktualisierung der MongoDB enthält. Wie üblich bei Datenbankupdates: Sorgen Sie für ein funktionierendes Backup, bevor Sie dieses Update einspielen.
Die Felder mongo.cpuRequest
und mongo.memoryRequest
, die in Kubernetes helm Chart Konfigurationsdatei values.yaml
definiert werden, wurden entfernt. Stattdessen werden die Limits verwendet, was zur Folge hat dass die Pods der MongoDB in der "guaranteed" QoS-Klasse sind. Falls Sie diese Werte verwendet haben ergeben sich möglicherweise Änderungen bezüglich des Ressourcenverbrauchs der MongoDB.
Bitte bedenken Sie, dass es in CaaS-Aufträgen nicht möglich ist eigene URL-Factory-Konfigurationen zu verwenden. Sollte eine solche Konfiguration vorliegen, wird diese von nun an intern überschrieben und bleibt somit wirkungslos.
Falls Sie die mitgelieferten Zertifikate bisher genutzt haben, müssen Sie diese ab sofort eigenständig einrichten und verwalten. Mehr Informationen dazu finden Sie in der Docker bzw. Kubernetes Dokumentation.
Mit diesem Release wird Kubernetes mindestens in Version 1.9.0 vorausgesetzt
Behobene Fehler
ID | Description |
---|---|
CAAS-914 |
Der Persistent Volume Claim Support für Grafana wurde entfernt, da alle Dashboards und Datenquellen vorprovisioniert sind und Grafana zustandslos sein sollte. |
CAAS-913 |
Benutzer waren in der Lage, nicht unterstützte UrlCreator zur Verwendung für Medien beim CDN-Deployment zu verwenden, das ist nun nicht mehr möglich |
CAAS-903 |
MongoDB ist auf Version 3.4.19 aktualisiert worden |
CAAS-900 |
Datum zum Standard Logpattern der REST-Schnittstelle hinzugefügt. |
CAAS-893 |
Die Formel zur Berechnung der Wired Tiger Cache Größe wurde an die Version aus der offiziellen Dokumentation angepasst. Dies führt dazu, dass MongoDB einen etwas größeren Cache zur Verfügung hat. |
CAAS-847 |
Probleme des internen Queue Handlings der CaaS Generierung behoben. |
CAAS-814 |
Die CompletionStage wird jetzt korrekt beendet. |
Neue Features
ID | Description |
---|---|
CAAS-918 |
Aktualisierung der Screenshots für die GUI der Projektkomponente |
CAAS-912 |
Parameter, die in den CaaS-Aufträgen angegeben werden (z.B. "CaaS Initialize"), beachten nun keine Groß- und Kleinschreibung mehr (z.B. kann man den Parameter "caasUrl" nun auch "caasURL" schreiben, ohne dass Fehler auftreten) |
CAAS-895 |
MongoDB pods sind nun immer in der QoS-Klasse "guaranteed" um sowohl die Performance, als auch die Stabilität zu verbessern. |
CAAS-862 |
Dokumentation um Hinweise zur Skalierung und Fehleranalyse des MongoDB Clusters sowie den Healthcheck der Rest-API erweitert. |
CAAS-819 |
Aufträge mit Generierung des Vorschaustandes können nun FirstSpirit-Vorschau-URLs verwenden. |
CAAS-768 |
Verbesserungen an Vorschau-URLs. |
CAAS-665 |
Mit dieser CaaS-Version entfallen die mitgelieferten selbstsignierten SSL-Zertifikate. |
CAAS-652 |
Livenessprobe der caas-rest-api wurde so verändert, dass ein nicht reagierender Pod vor Beendigung erst einmal für 10 Sekunden aus dem Loadbalancer genommen wird, bevor er neu gestartet wird. So besteht die Chance, dass er sich selbst wieder erholt. |
CAAS-647 |
Das Setzen von path im Ingress der Webapp konfiguriert jetzt dessen Basis-URL. |
CAAS-460 |
Kubernetes API version auf apps/v1 aktualisiert |
64. Version 2.3.1
Aktualisierungshinweis
Wir haben MongoDB von Version 3.4.10 auf 3.4.17 aktualisiert. Wenn Sie mehr Informationen benötigen, konsultieren Sie bitte https://docs.mongodb.com/manual/release-notes/3.4-changelog.
Eine Aktualisierung der Major-Version der MongoDB werden wir in einer der folgenden Veröffentlichungen durchführen.
Behobene Fehler
ID | Description |
---|---|
CAAS-882 |
Button zum Überprüfen der Verbindung zum Preview-CaaS in der Konfiguration der Projektkomponente hinzugefügt |
CAAS-834 |
Bei Eingabe von API-Keys und URLs in der CaaS-Konfiguration werden Leerzeichen am Anfang und Ende nun automatisch entfernt um Fehleingaben zu verhindern |
CAAS-832 |
In der CaaS-Service-Konfiguration ist die Fehlerbehandlung des Verbindungschecks verbessert worden, sodass bessere Fehlermeldungen erzeugt werden falls etwas falsch konfiguriert ist |
CAAS-822 |
Performance-Optimierung der Aktion CaaS DeltaGeneration |
CAAS-654 |
Änderung der Variablennamen in der env.js Konfigurationsdatei. |
Neue Features
ID | Description |
---|---|
CAAS-864 |
Softwareupdate der unterliegenden Docker-Images |
CAAS-856 |
Das Prometheus-Label für Service-Monitor-Definitionen ist jetzt konfigurierbar. |
CAAS-727 |
Support für Horizontal Pod Autoscaler |
65. Version 2.2.5
Behobene Fehler
ID | Description |
---|---|
CAAS-865 |
Invalides JSON hat seit dem letzten Release dazu geführt, dass das entsprechende Element nicht in den CaaS übertragen wurde und keine Fehlermeldungen entstanden sind |
66. Version 2.2.3
Highlights
Das CaaS-Modul kann nun auf isolierungsfähigen FirstSpirit-Servern eingesetzt werden. Außerdem wurde die JSON-Validierung verschärft, sodass Aufträge bei einigen zusätzlichen Fällen von Eingabe invalider Daten Fehler produzieren.
Neue Features
ID | Description |
---|---|
CAAS-705 |
RESTheart auf Version 3.5.0 aktualisiert. |
CAAS-311 |
Das Modul unterstützt nun den Einsatz auf isolierungsfähigen FirstSpirit-Servern. |
67. Hilfe
Der Technical Support der e-Spirit AG bietet qualifizierte technische Unterstützung zu allen Themen, die FirstSpirit™ als Produkt betreffen. Weitere Hilfe zu vielen relevanten Themen erhalten und finden Sie in auch in unserer Community.