Skip to content

Commit 21e2c69

Browse files
rename
1 parent e148296 commit 21e2c69

File tree

5 files changed

+20
-59
lines changed

5 files changed

+20
-59
lines changed

README.md

Lines changed: 14 additions & 53 deletions
Original file line numberDiff line numberDiff line change
@@ -1,26 +1,26 @@
11
<div align="center">
2-
<h1>Treebeard Kubeflow</h1>
3-
<p><b>🪐 scale Jupyter in Kubernetes</b></p>
2+
<h1>Kubeflow Helm</h1>
3+
<p><b>🪐 1-click Kubeflow</b></p>
44

55
<img src="https://raw.githubusercontent.com/treebeardtech/terraform-helm-kubeflow/main/docs/tkf.png" width="400" height="100%">
66

77
<br />
88

9+
<a target="_blank" href="https://artifacthub.io/packages/helm/kubeflow-helm/kubeflow-helm">
10+
<img src="https://img.shields.io/endpoint?url=https://artifacthub.io/badge/repository/kubeflow-helm" />
11+
</a>
912
<a target="_blank" href="https://registry.terraform.io/modules/treebeardtech/kubeflow/helm/latest">
1013
<img src="https://img.shields.io/badge/terraform-module-blue?logo=terraform" />
1114
</a>
1215
<a target="_blank" href="https://discord.gg/QFjCpMjqRY">
1316
<img src="https://img.shields.io/badge/chat-discord-blue?logo=discord&logoColor=white" />
1417
</a>
15-
<a target="_blank" href="https://artifacthub.io/packages/helm/treebeard-kubeflow/treebeard-kubeflow">
16-
<img src="https://img.shields.io/endpoint?url=https://artifacthub.io/badge/repository/treebeard-kubeflow" />
17-
</a>
1818

1919
</div>
2020

2121
## About this project
2222

23-
This project simplifies MLOps in Kubernetes by providing a Terraform module which creates a Kubeflow instance.
23+
This project simplifies MLOps in Kubernetes by providing Kubeflow in Helm and Terraform package formats. This allows scaling Kubeflow usage with the rest of your production systems.
2424

2525
Kubeflow provides a cloud-native AI platform which can be used to deploy applications in
2626
scientific computing, traditional machine learning, and generative AI.
@@ -32,9 +32,15 @@ This module is primarily focussed on the Jupyter notebook environment initially
3232

3333
## Architecture
3434

35-
This module is built on top of the official [Kubeflow Manifests repo](https://github.com/kubeflow/manifests) which contains _Kustomizations_ for the various components of Kubeflow.
35+
This system is built on top of the official [Kubeflow Manifests repo](https://github.com/kubeflow/manifests) which contains _Kustomizations_ for the various components of Kubeflow.
36+
37+
We provide a terraform and helm-based interface for managing Kubeflow via GitOps. Because Kubeflow is a collection of modular components, this project relies on ArgoCD for combining them.
3638

37-
We provide a terraform and helm-based interface for managing Kubeflow via GitOps
39+
### Design Tenets
40+
41+
1. Integrate with production systems that already use Terraform and Helm
42+
2. Embrace GitOps for Kubernetes resources on the popular ArgoCD project
43+
3. Enable adoption of cloud-native/AI tools beyond the scope of Kubeflow (e.g. Ray, MLFlow)
3844

3945
<img src="https://raw.githubusercontent.com/treebeardtech/terraform-helm-kubeflow/main/docs/arch.png" width="650" height="100%">
4046

@@ -131,48 +137,3 @@ Moving the deployment between different states of configuration can be challengi
131137
due to the dependencies between components in the cluster.
132138

133139
If you have made a change to a dependency such as istio, or an auth component such as dex, it can be a good idea to re-create pods such that they re-initialise. This can be done by scaling to 0 then back up again, or simply deleting a pod managed by a deployment.
134-
135-
## Requirements
136-
137-
| Name | Version |
138-
|------|---------|
139-
| <a name="requirement_terraform"></a> [terraform](#requirement\_terraform) | >= 1.3 |
140-
| <a name="requirement_helm"></a> [helm](#requirement\_helm) | >= 2.12 |
141-
| <a name="requirement_null"></a> [null](#requirement\_null) | >= 3.0 |
142-
| <a name="requirement_time"></a> [time](#requirement\_time) | >= 0.9 |
143-
144-
## Providers
145-
146-
| Name | Version |
147-
|------|---------|
148-
| <a name="provider_helm"></a> [helm](#provider\_helm) | >= 2.12 |
149-
| <a name="provider_null"></a> [null](#provider\_null) | >= 3.0 |
150-
151-
## Modules
152-
153-
No modules.
154-
155-
## Resources
156-
157-
| Name | Type |
158-
|------|------|
159-
| [helm_release.argo_bootstrap](https://registry.terraform.io/providers/hashicorp/helm/latest/docs/resources/release) | resource |
160-
| [helm_release.argo_cd](https://registry.terraform.io/providers/hashicorp/helm/latest/docs/resources/release) | resource |
161-
| [null_resource.start](https://registry.terraform.io/providers/hashicorp/null/latest/docs/resources/resource) | resource |
162-
163-
## Inputs
164-
165-
| Name | Description | Type | Default | Required |
166-
|------|-------------|------|---------|:--------:|
167-
| <a name="input_bootstrap_set"></a> [bootstrap\_set](#input\_bootstrap\_set) | Value block with custom STRING values to be merged with the values yaml. | <pre>list(object({<br> name = string<br> value = string<br> }))</pre> | `null` | no |
168-
| <a name="input_bootstrap_set_sensitive"></a> [bootstrap\_set\_sensitive](#input\_bootstrap\_set\_sensitive) | Value block with custom sensitive values to be merged with the values yaml that won't be exposed in the plan's diff. | <pre>list(object({<br> path = string<br> value = string<br> }))</pre> | `null` | no |
169-
| <a name="input_bootstrap_values"></a> [bootstrap\_values](#input\_bootstrap\_values) | Extra values | `list(string)` | `[]` | no |
170-
| <a name="input_enable_argocd"></a> [enable\_argocd](#input\_enable\_argocd) | n/a | `bool` | `true` | no |
171-
172-
## Outputs
173-
174-
No outputs.
175-
176-
## Not sure where to start?
177-
178-
Open an issue or message us directly in [Discord](https://discord.gg/QFjCpMjqRY).

examples/k3s/README.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Run on K3d
22

3-
This example will help you try Treebeard Kubeflow in your development environment.
3+
This example will help you try Kubeflow Helm in your development environment.
44

55
## Pre-reqs:
66

@@ -58,7 +58,7 @@ Once complete, verify the API server has started:
5858
kubectl get nodes
5959
```
6060

61-
### 2. Install Treebeard Kubeflow
61+
### 2. Install Kubeflow Helm
6262

6363
Initialise the terraform environment
6464

@@ -97,7 +97,7 @@ Try creating a Jupyter Notebook server with 0.1 CPU via the web UI.
9797

9898
## Next steps?
9999

100-
This shows you how you can start developing Treebeard Kubeflow into your infrastructure.
100+
This shows you how you can start developing Kubeflow Helm into your infrastructure.
101101

102102
Customisation and deployment for your team is another matter and will be discussed in subsequent tutorials.
103103

helm/bootstrap/README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@
1414
| name | string | `"000-bootstrap"` | |
1515
| namespace | string | `"argocd"` | |
1616
| project | string | `"default"` | |
17-
| sources[0].chart | string | `"treebeard-kubeflow"` | |
17+
| sources[0].chart | string | `"kubeflow-helm"` | |
1818
| sources[0].repoURL | string | `"ghcr.io/treebeardtech"` | |
1919
| sources[0].targetRevision | string | `"0.1-2024-03-08-T12-25-15"` | |
2020
| syncPolicy.automated.prune | bool | `false` | |

helm/treebeard-kubeflow/README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# treebeard-kubeflow
1+
# kubeflow-helm
22

33
![Version: 0.1.0](https://img.shields.io/badge/Version-0.1.0-informational?style=flat-square)
44

helm/treebeard-kubeflow/templates/000-debug-secret.yaml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
apiVersion: v1
33
kind: Secret
44
metadata:
5-
name: treebeard-kubeflow-debug
5+
name: kubeflow-helm-debug
66
type: Opaque
77
stringData:
88
helm-values: |

0 commit comments

Comments
 (0)