
# flowise 배포 

## 1. 배포 방법

### 1) 배포시 주의 사항

- 사용할 모델에 따라서 적절한 자원(CPU, Memory, GPU)를 설정한 후 배포 해야한다.

### 2) 배포 방법 

``` sh
git clone https://github.com/paasup/dip-catalog.git
cd charts/flowise
helm upgrade flowise ./ -f custom-values.yaml  --install -n flowise --create-namespace
```



## 2.custom-values.yaml 설명

- custom-values.yaml에 정의된 값에 대한 설명이다.

### 1) Global 설정

| Name                   | 설명                                                         | 기본값 |
| ---------------------- | ------------------------------------------------------------ | ------ |
| `global.storageClass` | 전역 Storage Class 설정. <br />모든 PV에서 사용할 기본 Storage Class | `"longhorn"`   |

### 2) Pod 설정

| Name                   | 설명                                                         | 기본값 |
| ---------------------- | ------------------------------------------------------------ | ------ |
| `image.registry` | 오프라인 설치 시에 설정. <br />오프라인 설치시에는 "paasup.io"로 설정 | `"docker.io"`   |
| `image.tag` | 이미지 태그 설정 | '0.5.4' |
| `persistence.enabled` | PV의 사용 여부 | 'true' |
| `persistence.size` | PV 용량 | "1Gi" |
| `persistence.storageClass` | PV 생성 시 사용할 Storage Class | "longhorn" |
| `resources` | Flowise 서버의 시스템 자원 설정.<br />적절한 CPU, Memory 설정이 필요하다. | `custom-values.yaml` 참고 |



### 3) Worker 설정

- flowise worker를 사용하여 백그라운드 작업을 처리할 수 있다.

| Name                  | 설명                      | 기본값      |
| --------------------- | ------------------------ | --------- |
| `worker.enabled`      | Worker 사용 여부          | `true`    |
| `worker.replicaCount` | Worker 복제본 수          | `1`       |
| `worker.resources`    | Worker의 시스템 자원 설정   | `{}`      |

### 4) flowise 사용자 설정

- flowise에서 사용할 사용자 이름/패스워드를 설정한다.

| Name                  | 설명                      | 기본값      |
| --------------------- | ------------------------ | --------- |
| `config.username`     | flowise에서 사용할 사용자 이름 | "flowise" |
| `config.password`     | flowise에서 사용할 패스워드   | "flowise" |



### 5) Ingress 설정

#### 5.1) tls 시크릿 직접 생성

- flowise에서 ingress 사용을 위해서는 다음과 같이 설정할 수 있다.
  
  ``` yaml
  ingress:
    enabled: true
      hosts:
      - host: flowise.example.org
        paths:
        - path: /
      tls: 
      -  hosts:
        - flowise.example.org
        secretName: flowise-tls-secret
  ```
  
- ingress 사용을 위해서는 인증서를 secret으로 제공해야한다. 로컬 파일을 이용해 secret을 생성하는 방법은 다음과 같다.
  
  ``` sh
  kubectl create secret tls flowise-tls-secret --cert=<path-to-cert-file> --key=<path-to-key-file> -n <namespace>
  ```

#### 5.2) cert-manager를 이용한 자동 생성

- cert manager를 통해 인증서 자동 생성 시 `custom-values.yaml` 수정한다.
- `ingress.annotations.cert-manager.io/cluster-issuer`에 미리 배포된 Cluster Issuer의 이름으로 변경한다.
  
  ``` yaml
  ingress:
    enabled: true
    annotations: 
      cert-manager.io/cluster-issuer: "root-ca-issuer"
      cert-manager.io/duration: 8760h  
      cert-manager.io/renew-before: 720h
    hosts:
    - host: flowise.example.org
      paths:
        - /
    tls: 
    -  hosts:
      - flowise.example.org
      secretName: flowise-tls-secret
  ```

### 6) Redis 설정

- Redis를 사용하여 캐싱 및 세션 관리를 할 수 있다.

| Name                  | 설명                      | 기본값      |
| --------------------- | ------------------------ | --------- |
| `redis.enabled`       | Redis 사용 여부           | `true`    |

### 7) Postgresql 설정

- 내장 postgresql을 사용하여 배포할 수 있다.
- custom-values.yaml
  ``` yaml
  postgresql:
  enabled: true
  primary:
    persistence:
      enabled: true
      size: 8Gi
      storageClass: ""
  ```