Skip to content

Upgrading v0.2 to v0.3

When upgrading from v0.2 to v0.3, the installation script simply needs to be run again. However, due to breaking changes, some manual adjustments are required for existing configurations and workloads.

Configurations

CompleteState

  • currentState has been renamed to desiredState

State

  • New mandatory field apiVersion was added to avoid incompatibility issues.
  • The boolean field restart has been supplemented with a restartPolicy enum.
  • configs and cronjobs have been removed for now as they are not implemented yet.

Workload

  • accessRights and updateStrategy have been removed for now as they are not implemented yet.

API

Application using the control interface or communicating directly with the Ankaios server (custom CLIs) need to be adapted.

The two main messages have been renamed:

  • StateChangeRequest -> ToServer
  • ExecutionRequest -> FromServer

A new type of ToServer message, Request, has been introduced. Every Request to the server requires a requestId which is used by the server for the response message. Request IDs allow sending multiple parallel requests to the server. The two messages UpdateStateRequest and CompleteStateRequest have been moved to the new Request message.

A new type of FromServer message, Response, has been introduced. A Response message is always an answer from the Server to a Request message. The Response message contains the same requestId as the answered Request message. This allows to identify the correct Response. The CompleteState message has been moved to the new Response message. Additionally, the Ankaios server now responds to an UpdateStateRequest with an UpdateStateSuccess or Error message, which are both of type Response.