README.md

Workshop for installing Digital.ai Release and Digital.ai Deploy on a Kubernetes cluster using the xl kube command line interface.

Prerequisites

• kubectl
• xl-cli 24.1.0 - Installation instructions
• yq 4.18.1 or higher. Ubuntu comes with a broken version of yq installed. Download the latest version of yq from GitHub directly.

Mandatory for Azure

• Azure Cli - az - if you are working with Azure during workshop

Mandatory for Minikube

• minikube - if you plan to use Minikube during workshop (use the latest version)

Mandatory for Docker Desktop

• docker - if you plan to use Docker during workshop (use the latest version)

Optional

• Java 17 - keytool (only if you plan to use the generation of the keystore inside the xl-cli kube)
• helm - if you would like to get additional info
• k9s - Kubernetes CLI To Manage Your Clusters In Style

if you have any questions or troubles, contact your Digital.ai representative

Workshop Content

General remarks

• xl <command> --help is your friend! For example: xl kube install --help

Part 0

0. Setup kubectl context

Part 1

1. Install Digital.ai Release 23.3.2
   • Wait for resources with xl kube check
   • Discover how to open the page and login
2. Upgrade Release 24.1.0
3. OIDC setup (use Identity service)
4. Clean Release from cluster

Part 2

5. Install Deploy with –files 24.1.0
   • Use private image registry for all images
   • Discover how to open the page and login
6. Clean Deploy from cluster

Part 3

7. Fix errors - Troubleshoot
   • Use wrong tag
   • Use for postgres wrong storageclass
8. How to change configuration file

Workshop Agenda

1. Introduction - PowerPoint
2. Work on Labs
   • Part 0
   • Part 1
   • Part 2
   • Part 3

---

Start