//Cloudogu EcoSystem Docs

Migration von Cesapp-Versionen

Migrieren von 3.x.x zu 4.x.x

Bei der Migration von der Version 3 zu der Version 4 sind einige Dinge zu beachten:

Configuration.json

Für den Fall, dass vor dem Upgrade manuelle Änderungen an der Datei /etc/cesapp/configuration.json vorgenommen wurden, wird ein Dateikonflikt auftreten. Daher sollte vor dem Update der Cesapp-Version eine Kopie dieser Datei erstellt werden, um Datenverlust zu verhindern.

Erfolgt das Upgrade über apt install cesapp, kann selbst entschieden werden, ob bei dem Konflikt einfach die neue /etc/cesapp/configuration.json übernommen werden soll oder die alte beibehalten werden soll. Es wird empfohlen, die alte Datei beizubehalten und die folgende Änderung händisch nachzutragen:

Vor dem Upgrade:

  "remote": {
    "endpoint": "https://dogu.cloudogu.com/api/v1/",
    [......]
  },

Nach dem Upgrade

  "remote": {
    "endpoint": "https://dogu.cloudogu.com/api/v2/",
    [......]
  },

Erfolgt die Änderung über das Blueprint-Upgrade, wird die /etc/cesapp/configuration.json automatisch überschrieben. Das Blueprint-Upgrade bricht dann mit einem Fehler ab. Der Befehl kann anschließend erneut gestartet werden und sollte dann ohne Fehler funktionieren. Vorher gemachte manuelle Änderungen an der Datei müssen nun gegebenenfalls erneut eingetragen werden.

Registry

Mit der Version wurde das Format der dogu.jsons angepasst. Da es aber noch einige wichtige Abhängigkeiten gibt, die eine lokale Dogu-Registry in dem alten Format benötigen, um korrekt zu funktionieren, wurde im etcd ein zweiter Pfad angelegt. Die alte Dogu-Registry im v1-Format ist weiterhin unter /dogu zu finden. Zusätzlich dazu wurde der Pfad /dogu_v2 für das v2-Format im etcd angelegt.

Wird ein neues Dogu installiert, so wird es sowohl in der v1-Registry (im v1-Format) als auch in der v2-Registry (im v2-Format) registriert. Die lesenden Zugriffe der Cesapp greifen als erstes auf die v2-Registry zu. Wird dort kein Dogu gefunden, wird in der v1-Registry gesucht. Erst wenn dort das Dogu nicht zu finden ist, wird ein Fehler geworfen.