You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
106 lines
3.7 KiB
106 lines
3.7 KiB
|
|
# Qdrant 배포
|
|
|
|
## 1. 배포 방법
|
|
- 명령어
|
|
``` sh
|
|
$ helm upgrade qdrant ../qdrant --install \
|
|
--namespace qdrant \
|
|
-f ./custom-values.yaml
|
|
```
|
|
|
|
|
|
|
|
## 2.custom-values.yaml 설명
|
|
|
|
- custom-values.yaml에 정의된 값에 대한 설명이다.
|
|
|
|
### 1) 이미지 설정
|
|
- private 환경 배포시 사용한다.
|
|
|
|
| Name | 설명 | 기본값 |
|
|
| ---------------------- | ------------------------------------------------------------ | ------ |
|
|
| `image.repository` | 오프라인 설치 시에 설정 변경 필요. <br />paasup 설치시에는 "paasup.io/qdrant/qdrant"로 설정 | `"docker.io/qdrant/qdrant"` |
|
|
| `image.tag` | 이미지의 태그 설정 | `"v1.12.4"` |
|
|
|
|
|
|
|
|
### 2) pod 설정
|
|
- pod의 수, tolerations, nodeSelector 리소스 등을 설정한다.
|
|
|
|
| Name | 설명 | 기본값 |
|
|
| ------------------------ | ---------------------------------- | --------- |
|
|
| `replicaCount` | qdrant pod의 replicas 설정. | "1" |
|
|
| `tolerations` | qdrant pod의 toleration 설정. | `[]` |
|
|
| `nodeSelector` | qdrant pod의 nodeSelector 설정. | `{}` |
|
|
| `resources.request.cpu` | qdrant pod의 cpu requst 설정. | `` |
|
|
| `resources.request.memory` | qdrant pod의 memory requst 설정. | `` |
|
|
| `resources.limits.cpu` | qdrant pod의 cpu limits 설정. | `` |
|
|
| `resources.limits.memory` | qdrant pod의 memory limits 설정. | `` |
|
|
| `persistence.accessModes` | 생성할 Persistent Volume의 accessModes. | `["ReadWriteOnce"]` |
|
|
| `persistence.size` | 생성할 Persistent Volume 사이즈. | `10Gi` |
|
|
| `persistence.storageClass` | Storage Class 설정. | `""` |
|
|
|
|
|
|
|
|
### 3) Qdrant 설정
|
|
|
|
- qdrant에 적용되는 configuration을 작성한다.
|
|
|
|
| Name | 설명 | 기본값 |
|
|
| --------------------------- | ------------------------------------------------------------ | ----------------------- |
|
|
| `config` | qdrant에 적용되는 기본 configuration을 덮어씌운다. | `custom-values.yaml 참조` |
|
|
| apiKey | api key 생성 여부. | `false` |
|
|
| readOnlyApiKey | read-only api key 생성 여부. | `false` |
|
|
|
|
|
|
|
|
### 4) Ingress 설정
|
|
|
|
#### 4.1) tls 시크릿 직접 생성
|
|
|
|
|
|
- Rancher에서 ingress 사용을 위해서는 다음과 같이 설정할 수 있다.
|
|
``` yaml
|
|
ingress:
|
|
enabled: true
|
|
hosts:
|
|
- host: qdrant.example.org
|
|
paths:
|
|
- path: /
|
|
pathType: Prefix
|
|
servicePort: 6333
|
|
tls:
|
|
- hosts:
|
|
- qdrant.example.org
|
|
secretName: qdrant-tls-secret
|
|
```
|
|
|
|
- ingress 사용을 위해서는 인증서를 secret으로 제공해야한다. 로컬 파일을 이용해 secret을 생성하는 방법은 다음과 같다.
|
|
``` sh
|
|
kubectl create secret tls qdrant-tls-secret --cert=<path-to-cert-file> --key=<path-to-key-file> -n <namespace>
|
|
```
|
|
|
|
|
|
#### 4.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: "selfsigned-issuer"
|
|
cert-manager.io/duration: 8760h
|
|
cert-manager.io/renew-before: 720h
|
|
hosts:
|
|
- host: qdrant.example.org
|
|
paths:
|
|
- path: /
|
|
pathType: Prefix
|
|
servicePort: 6333
|
|
tls:
|
|
- hosts:
|
|
- qdrant.example.org
|
|
secretName: qdrant-tls-secret
|
|
``` |