Zum Hauptinhalt gehen
 

Wie können wir helfen?

Suche

[en] Update Your Standard Stack Installation

  • Aktualisiert

Anmerkung

[en] Before you start, make sure that you've:

[en] If you want to update your Standard Stack installation, you'll first need to identify which platform version you want to use. Here’s a list of available Acrolinx Helm charts.

[en] The platform chart names follow the pattern acrolinx-platform-<operator version>+<platform version>.tgz. For example:

acrolinx-platform-1.0.5+2021.05.tgz
acrolinx-platform-1.1.3+2021.07.tgz 
acrolinx-platform-1.1.4+2021.07.tgz

Warnung

[en] Before you can update your Standard Stack installation to 2022.06, you'll need to upgrade to K3s version v1.22.8+k3s1. Learn how to do this under Upgrade Basics in the K3s docs.

[en] You'll also need to delete the Traefik v1 configuration before you upgrade.

[en] To delete your Traefik v1 configuration, run the following commands:

kubectl -n kube-system delete helmchart traefik traefik-crd
kubectl -n kube-system delete helmchartconfig traefik

[en] To update to a new platform version, do the following:

  1. [en] Choose your preferred platform version. If you see multiple operator versions, pick the one with the higher version number. For example, if you want to install platform version 2021.07, and you see both 1.1.3+2021.07 and 1.1.4+2021.07 listed, choose 1.1.4+2021.07.

  2. [en] Open your acrolinx.yaml file and update the configuration:

    1. [en] Update the version field with the operator and platform version that you chose in step 1. This might look like the following:

      spec:
  # ...
  version: x.x.x+xxxx.xx

    2. [en] Replace the old guidance package name and version with the version and name of the guidance package that you'd like to use instead. Learn more about where to find your available guidance package versions.

      Anmerkung

      [en] Your container image for your guidance package starts with the prefix acrolinx/guidance. The name appears after acrolinx/guidance/. For example, targets-starter-en-stasta in acrolinx/guidance/targets-starter-en-stasta.

      [en] Be sure to use a colon to separate the name and build number. For example:

      spec:
  set:
    ### [...]
    platform.spec.guidance: "targets-starter-en-stasta:xxxx.xx-xxxxx"

  3. [en] After you update the configuration in your acrolinx.yaml file, you can upgrade the Acrolinx version in your Kubernetes cluster. To apply the upgrade, use the following:

    kubectl apply -f acrolinx.yaml

    1. [en] Wait for the installation to complete.

      [en] Optional: You can use the following to wait for the Ready status.

      kubectl wait -n acrolinx coreplatform acrolinx --for condition=Ready --timeout=15m

      [en] When the status is Ready, you'll see the message "condition met". If you don't see the status Ready after 15 minutes, the command will time out.

    2. [en] Check your installation.

      kubectl describe coreplatform acrolinx -n acrolinx

      [en] When your installation is ready, you’ll see the following in the output and the Acrolinx Platform will become available on port 80 of the target machine.

      Status:
  # [...]
  Summary:
    Version: xxxx.xx
    Platform Status:  Ready