Howto:Install and Upgrade the App Platform using Helm
Purpose
This article describes how to prepare a Helm repository and install or update the innovaphone App Platform using Helm.
Features
- Add and manage the innovaphone Helm repository
- Install a specific App Platform version
- Install the latest available App Platform version
- Upgrade an existing App Platform installation
Limitations
- Helm must be installed and configured on the target system.
- Access to the innovaphone Helm repository is required.
- A Kubernetes cluster must already be available.
Requirements
- Kubernetes cluster
- Helm installed
- Network access to the innovaphone Helm repository
- Appropriate permissions to create namespaces and install applications
Things to know before you begin
- The URL of the innovaphone Helm repository:
https://helm.innovaphone.com/repository/helm
- The repository name can be chosen freely and will be required in later Helm commands.
- In the examples below, the repository name innovaphone is used.
Configuration
Prepare the Helm Repository
First, check whether the required Helm repository already exists.
helm repo list
If the repository with the URL https://helm.innovaphone.com/repository/helm is already present, update all repositories to load the latest available versions.
helm repo update
Make sure to remember the repository name because it will be used in subsequent Helm commands. In the following examples, the repository name innovaphone is used.
If the repository is not present, add it using the following command:
helm repo add innovaphone https://helm.innovaphone.com/repository/helm
The name innovaphone is only an example and can be replaced with any desired repository name.
Display Available Versions
To display all available App Platform versions, use the following command:
helm search repo innovaphone -l
Replace innovaphone with the repository name you configured previously.
Install the App Platform
Install a Specific Version
If a specific App Platform version should be installed, use the following syntax:
helm install --namespace test --version 0.0.1013 ap innovaphone/app-platform
Parameter description:
- test – freely selectable namespace
- 0.0.1013 – example version number
- ap – freely selectable App Platform release name
- innovaphone – Helm repository name
Install the Latest Version
To always install the latest available version, omit the version parameter:
helm install --namespace test ap innovaphone/app-platform
Parameter description:
- test – freely selectable namespace
- ap – freely selectable App Platform release name
- innovaphone – Helm repository name
Upgrade an Existing App Platform Installation
If the App Platform is already installed and should be upgraded, use the following command:
helm upgrade --install -n test ap innovaphone/app-platform
Parameter description:
- test – namespace where the App Platform is installed
- ap – existing App Platform release name
- innovaphone – Helm repository name
The parameter --install ensures that the App Platform is automatically installed if no existing installation is found.
Verification
- Verify that the Helm repository is listed:
helm repo list
- Verify that the App Platform release is installed:
helm list -n test
- Verify that the deployed Kubernetes resources are running:
kubectl get pods -n test
Known issues
- Installation may fail if the Helm repository is unreachable.
- Insufficient Kubernetes permissions may prevent namespace creation or deployment.
- The specified App Platform version must exist in the configured repository.