Digital.ai Release Integration SDK Workshop

The Integration SDK for Digital.ai Release allows you to run tasks as containers, using any language or third-party library.

In this workshop, you will learn how to

• Build and maintain custom integrations using Python 3
• Set up a development environment for building, testing, installing, and running integration tasks
• Configure a production-style architecture to run the container-based tasks in a Kubernetes cluster

System requirements

You will run this workshop on your own machine. Here's a breakdown of the components that you need to have.

• Operating system: Windows, Linux, macOS. For Macs with the M1/M2 chip, macOS Ventura is required and enable Rosetta in Docker Desktop under 'Feature in development'
• Internal memory: Enough to run Docker comfortably, 8 GB min; 16 GB recommended
• GitHub account
• Docker Desktop, latest version
• Admin privileges on your system. You need to be able to edit the /etc/hosts file
• Python 3.11
• Code editor or IDE like PyCharm or Visual Code

Requirements for part 3: Production Setup with Kubernetes (optional)

Container-based integration plugins are meant to run on a Kubernetes cluster. To have a hands-on experience you will need to install additional components.

⚡️ Note: Some Kubernetes experience is needed to make the best of this exercise. Feel free to skip this part if Kubernetes is all new to you (or be prepared for a steep learning curve)

Refer to Part 3 for a detailed list of requirements regarding the Kubernetes setup.

Help needed?

If you get stuck during the workshop, check the Troubleshooting section for common problems

For further questions or remarks, use our public Slack channel #release-sdk-workshop.

Workshop Contents

Introduction

• PowerPoint presentation

Watch the recording of the Introduction

Part 1 - Getting started

• Lab 0 - Getting Started: Check out and run Release
• Lab 1 - Run Hello World
• Lab 2 - Create a project repository
• Lab 3 - Set up Python and IDE
• Lab 4 - Define a new task and test

Watch the recording of Part 1

Part 2 - Create your own task

• Lab 5 - Create integration to a third party server

Part 3 - Production Setup with Kubernetes

• Lab 6 - Prepare Kubernetes
• Lab 7 - Install Release runner

---

Start