Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Feature: Add support for Kubernetes deployment through Kustomize #187

Merged
merged 10 commits into from
Jun 27, 2022
1 change: 1 addition & 0 deletions .env
Original file line number Diff line number Diff line change
Expand Up @@ -42,6 +42,7 @@ HASURA_VERSION=v2.1.1

############################## Metabase #######################################
METABASE_IMAGE="metabase/metabase"
METABASE_VERSION=v0.41.6
METABASE_DB_NAME=metabase
METABASE_PORT=3000
METABASE_USER=admin@admin.com
Expand Down
47 changes: 47 additions & 0 deletions kube/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,47 @@
## Deploying FarosCE on Kubernetes

We provide all required Kubernetes manifests for a full stack deployment in this repository under `kube/base`. These manifests can be used raw but are also exposed using [Kustomize](https://kustomize.io/) for a more flexible and scalable deployment model.

> Local Kubernetes clusters can be setup in a few different ways. Here's a list of the few most common tools for local K8s deployment: [kind](https://kind.sigs.k8s.io/), [k3d](https://k3d.io/v5.4.3/) or [minikube](https://minikube.sigs.k8s.io/docs/start/).

Provided you have have access to a Kubernetes cluster and have configured access to it via `kubectl`, FarosCE can be deployed with the following command:

```base
kustomize build --load-restrictor LoadRestrictionsNone https://github.com/faros-ai/faros-community-edition/kube/base | kubectl apply -f -
```

Kustomize will load the deployment definition in this repository over Github, build the manifests and pipe them over to `kubectl` for deployment in the configured cluster.

To access the deployed applications you can port forward onto the relevant services, for example:

```yaml
# Expose Airbyte to localhost
kubectl port-forward svc/airbyte-webapp-svc 8000:80
# Expose Metabase to localhost
kubectl port-forward svc/metabase 3000:80
# Expose Hasura to localhost
kubectl port-forward svc/hasura 8080:80
# Expose N8N to localhost
kubectl port-forward svc/n8n 5678:80
```

> Kubernetes services can also be exposed using NodePort, Ingress, or External LoadBalancers. This will vary depending on your Kubernetes cluster.

### Using kustomization.yaml file

For a more declarative and GitOps friendly deployment approach you can create your own local `kustomization.yaml` file, put it under a source control system and reference the same path in the resources attribute.

```yaml
apiVersion: kustomize.config.k8s.io/v1beta1
kind: Kustomization
resources:
- https://github.com/faros-ai/faros-community-edition/kube/base
```

> This allow you to customize the Kubernetes resources objects in any way you want to meet whatever desired cluster requirements you might have
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

allow => allows


With this file available you can run the following command from the same path to build and apply the manifests:

```yaml
kustomize build --load-restrictor LoadRestrictionsNone . | kubectl apply -f -
```
7 changes: 7 additions & 0 deletions kube/base/airbyte/bootloader.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
apiVersion: v1
kind: Pod
metadata:
name: airbyte-bootloader
labels:
app.kubernetes.io/name: airbyte-bootloader
app.kubernetes.io/component: bootloader
68 changes: 68 additions & 0 deletions kube/base/airbyte/db.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,68 @@
apiVersion: apps/v1
kind: Deployment
metadata:
name: airbyte-db
labels:
app.kubernetes.io/name: airbyte-db
app.kubernetes.io/component: database
spec:
selector:
matchLabels:
app.kubernetes.io/name: airbyte-db
app.kubernetes.io/component: database
template:
metadata:
labels:
app.kubernetes.io/name: airbyte-db
app.kubernetes.io/component: database
spec:
containers:
- name: airbyte-db-container
env:
- name: CONFIG_DATABASE_PASSWORD
valueFrom:
configMapKeyRef:
name: faros-config
key: CONFIG_DATABASE_PASSWORD
optional: true
- name: CONFIG_DATABASE_URL
valueFrom:
configMapKeyRef:
name: faros-config
key: CONFIG_DATABASE_URL
optional: true
- name: CONFIG_DATABASE_USER
valueFrom:
configMapKeyRef:
name: faros-config
key: CONFIG_DATABASE_USER
optional: true
- name: DATABASE_PASSWORD
valueFrom:
configMapKeyRef:
name: faros-config
key: DATABASE_PASSWORD
- name: DATABASE_URL
valueFrom:
configMapKeyRef:
name: faros-config
key: DATABASE_URL
- name: DATABASE_USER
valueFrom:
configMapKeyRef:
name: faros-config
key: DATABASE_USER
- name: POSTGRES_PASSWORD
value: ""
valueFrom:
configMapKeyRef:
name: faros-config
key: DATABASE_PASSWORD
- name: POSTGRES_USER
value: ""
valueFrom:
configMapKeyRef:
name: faros-config
key: DATABASE_USER
- name: POSTGRES_DB
$patch: delete
17 changes: 17 additions & 0 deletions kube/base/airbyte/scheduler.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,17 @@
apiVersion: apps/v1
kind: Deployment
metadata:
name: airbyte-scheduler
labels:
app.kubernetes.io/name: airbyte-scheduler
app.kubernetes.io/component: scheduler
spec:
selector:
matchLabels:
app.kubernetes.io/name: airbyte-scheduler
app.kubernetes.io/component: scheduler
template:
metadata:
labels:
app.kubernetes.io/name: airbyte-scheduler
app.kubernetes.io/component: scheduler
29 changes: 29 additions & 0 deletions kube/base/airbyte/server.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,29 @@
apiVersion: v1
kind: Service
metadata:
name: airbyte-server-svc
labels:
app.kubernetes.io/name: airbyte-server
app.kubernetes.io/component: server
spec:
selector:
app.kubernetes.io/name: airbyte-server
app.kubernetes.io/component: server
---
apiVersion: apps/v1
kind: Deployment
metadata:
name: airbyte-server
labels:
app.kubernetes.io/name: airbyte-server
app.kubernetes.io/component: server
spec:
selector:
matchLabels:
app.kubernetes.io/name: airbyte-server
app.kubernetes.io/component: server
template:
metadata:
labels:
app.kubernetes.io/name: airbyte-server
app.kubernetes.io/component: server
26 changes: 26 additions & 0 deletions kube/base/airbyte/temporal.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,26 @@
apiVersion: v1
kind: Service
metadata:
name: airbyte-temporal-svc
spec:
selector:
app.kubernetes.io/name: airbyte-temporal
app.kubernetes.io/component: temporal
---
apiVersion: apps/v1
kind: Deployment
metadata:
name: airbyte-temporal
labels:
app.kubernetes.io/name: airbyte-temporal
app.kubernetes.io/component: temporal
spec:
selector:
matchLabels:
app.kubernetes.io/name: airbyte-temporal
app.kubernetes.io/component: temporal
template:
metadata:
labels:
app.kubernetes.io/name: airbyte-temporal
app.kubernetes.io/component: temporal
29 changes: 29 additions & 0 deletions kube/base/airbyte/webapp.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,29 @@
apiVersion: v1
kind: Service
metadata:
name: airbyte-webapp-svc
labels:
app.kubernetes.io/name: airbyte-webapp-svc
app.kubernetes.io/component: webapp
spec:
selector:
app.kubernetes.io/name: airbyte-webapp
app.kubernetes.io/component: webapp
---
apiVersion: apps/v1
kind: Deployment
metadata:
name: airbyte-webapp
labels:
app.kubernetes.io/name: airbyte-webapp
app.kubernetes.io/component: webapp
spec:
selector:
matchLabels:
app.kubernetes.io/name: airbyte-webapp
app.kubernetes.io/component: webapp
template:
metadata:
labels:
app.kubernetes.io/name: airbyte-webapp
app.kubernetes.io/component: webapp
17 changes: 17 additions & 0 deletions kube/base/airbyte/worker.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,17 @@
apiVersion: apps/v1
kind: Deployment
metadata:
name: airbyte-worker
labels:
app.kubernetes.io/name: airbyte-worker
app.kubernetes.io/component: worker
spec:
selector:
matchLabels:
app.kubernetes.io/name: airbyte-worker
app.kubernetes.io/component: worker
template:
metadata:
labels:
app.kubernetes.io/name: airbyte-worker
app.kubernetes.io/component: worker
1 change: 1 addition & 0 deletions kube/base/faros/config/.env
13 changes: 13 additions & 0 deletions kube/base/faros/config/.k8s.env
Original file line number Diff line number Diff line change
@@ -0,0 +1,13 @@
############################## Faros ##########################################
FAROS_DB_HOST=airbyte-db-svc
FAROS_CONFIG_DB_HOST=airbyte-db-svc

############################## Airbyte ########################################
AIRBYTE_URL=http://airbyte-webapp-svc

############################## Hasura ########################################
HASURA_URL=http://hasura

############################## Metabase ########################################
METABASE_URL=http://metabase
METABASE_FAROS_DB_HOST=airbyte-db-svc
126 changes: 126 additions & 0 deletions kube/base/faros/init.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,126 @@
apiVersion: batch/v1
kind: Job
metadata:
name: faros-init
spec:
ttlSecondsAfterFinished: 300
template:
spec:
restartPolicy: OnFailure
containers:
- name: faros-init
image: farosai.docker.scarf.sh/farosai/faros-ce-init:latest
env:
- name: AIRBYTE_URL
valueFrom:
configMapKeyRef:
name: faros-config
key: AIRBYTE_URL
- name: AIRBYTE_FORCE_SETUP
value: "false"
- name: AIRBYTE_DESTINATION_HASURA_URL
valueFrom:
configMapKeyRef:
name: faros-config
key: HASURA_URL
- name: FAROS_DB_HOST
valueFrom:
configMapKeyRef:
name: faros-config
key: FAROS_DB_HOST
- name: FAROS_DB_PORT
valueFrom:
configMapKeyRef:
name: faros-config
key: FAROS_DB_PORT
- name: FAROS_DB_PASSWORD
valueFrom:
configMapKeyRef:
name: faros-config
key: FAROS_DB_PASSWORD
- name: FAROS_DB_NAME
valueFrom:
configMapKeyRef:
name: faros-config
key: FAROS_DB_NAME
- name: FAROS_DB_USER
valueFrom:
configMapKeyRef:
name: faros-config
key: FAROS_DB_USER
- name: FAROS_CONFIG_DB_HOST
valueFrom:
configMapKeyRef:
name: faros-config
key: FAROS_CONFIG_DB_HOST
- name: FAROS_CONFIG_DB_PORT
valueFrom:
configMapKeyRef:
name: faros-config
key: FAROS_CONFIG_DB_PORT
- name: FAROS_CONFIG_DB_USER
valueFrom:
configMapKeyRef:
name: faros-config
key: FAROS_CONFIG_DB_USER
- name: FAROS_CONFIG_DB_PASSWORD
valueFrom:
configMapKeyRef:
name: faros-config
key: FAROS_CONFIG_DB_PASSWORD
- name: HASURA_DB_NAME
valueFrom:
configMapKeyRef:
name: faros-config
key: HASURA_DB_NAME
- name: HASURA_URL
valueFrom:
configMapKeyRef:
name: faros-config
key: HASURA_URL
- name: HASURA_GRAPHQL_ADMIN_SECRET
valueFrom:
configMapKeyRef:
name: faros-config
key: HASURA_GRAPHQL_ADMIN_SECRET
- name: HASURA_GRAPHQL_DATABASE_URL
valueFrom:
configMapKeyRef:
name: faros-config
key: HASURA_GRAPHQL_DATABASE_URL
optional: true
- name: METABASE_DB_NAME
valueFrom:
configMapKeyRef:
name: faros-config
key: METABASE_DB_NAME
- name: METABASE_FAROS_DB_HOST
valueFrom:
configMapKeyRef:
name: faros-config
key: METABASE_FAROS_DB_HOST
- name: METABASE_USE_SSL
valueFrom:
configMapKeyRef:
name: faros-config
key: METABASE_USE_SSL
- name: METABASE_PASSWORD
valueFrom:
configMapKeyRef:
name: faros-config
key: METABASE_PASSWORD
- name: METABASE_URL
valueFrom:
configMapKeyRef:
name: faros-config
key: METABASE_URL
- name: METABASE_USER
valueFrom:
configMapKeyRef:
name: faros-config
key: METABASE_USER
- name: N8N_DB_NAME
valueFrom:
configMapKeyRef:
name: faros-config
key: N8N_DB_NAME