Skip to content

WOGRA-AG/terraform-kustomization-shepard

Repository files navigation

Terraform Kustomization Shepard

The terraform-kustomization-shepard uses Kustomize manifests to install Shepard, an open source software made by the German Aerospace Center, on any Kubernetes cluster.

Important

The module is in an VERY early stage of development. Thus, it is experimental and not for production use.

Getting Started

Nobody wants complicated installations. We neither, so we try to keep things as simple as possible. So how does it work?

Prerequisites

In fact, all it takes is a running Kubernetes cluster and instance of Keycloak to get started.

With k3d you can do it like this, for example

k3d cluster create shepard-cluster

If you don't have a running Keycloak instance and want to deploy one in your cluster, just run

kubectl apply -k manifests/keycloak/base

in this project.

Installation

Create a realm, client and user with credentials in your instance of Keycloak and supplement ./manifests/common/configmap.yaml with your configuration.

In ./examples/kubernetes you find a Terraform script to install Shepard on your configured Kubernetes cluster. And this is how it works:

git clone https://github.com/WOGRA-AG/terraform-kustomization-kubeflow
cd terraform-kustomization-kubeflow/examples/kubernetes
terraform init
terraform apply -auto-approve

Acknowledgment

This module was originally created by the ml research team at WOGRA AG to deploy kubeflow as part of the Os4ML project.

Os4ML is a project of the WOGRA AG research group in cooperation with the German Aerospace Center and is funded by the Ministry of Economic Affairs, Regional Development and Energy as part of the High Tech Agenda of the Free State of Bavaria.