Repository for dip
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.
 
 
 
 
 
 

101 lines
3.5 KiB

# ollama 배포
## 1. 배포 방법
### 1) 배포시 주의 사항
- 사용할 모델에 따라서 적절한 자원(CPU, Memory, GPU)를 설정한 후 배포 해야한다.
### 2) 배포 방법
``` sh
git clone https://github.com/paasup/dip-catalog.git
cd charts/ollama
helm upgrade ollama ./ -f custom-values.yaml --install -n ollama --create-namespace
```
## 2.custom-values.yaml 설명
- custom-values.yaml에 정의된 값에 대한 설명이다.
### 1) Pod 설정
| Name | 설명 | 기본값 |
| ---------------------- | ------------------------------------------------------------ | ------ |
| `image.repositrory` | 오프라인 설치 시에 설정. <br />paasup 설치시에는 "paasup.io/ollama/ollama"로 설정 | `"ollama/ollama"` |
| `image.tag` | 이미지 태그 설정 | '0.5.4' |
| `runtimeClassName` | pod 실행 시 사용할 runtime을 설정<br />gpu-operator가 설치되어 있는 환경 에서 사용가능하다. | "nvidia" |
| `persistentVolume.enabled` | PV의 사용 여부 | 'true' |
| `persistentVolume.size` | PV 용량 | "30Gi" |
| `persistentVolume.storageClass` | PV 생성 시 사용할 Storage Class | "" |
| resources | Ollama 서버의 시스템 자원 설정.<br />LLM 모델에 따른 적절한 CPU, Memory 설정이 필요하다. | `custom-values.yaml` 참고 |
### 2) Ollama 설정
- ollama 실행 시에 필요한 설정을 작성한다. ex) GPU 설정, LLM 모델 설정
| Name | 설명 | 기본값 |
| ------------------------ | ------------------------------------------------------ | ------------------------- |
| `ollama.gpu.enabled` | Ollama에서 GPU를 사용할지 여부 | "true" |
| `ollama.gpu.type` | GPU의 종류. <br />'nvidia' 또는 'amd'만 사용 가능하다. | 'nvidia' |
| `ollama.gpu.number` | 사용할 GPU의 수 | '1' |
| `ollama.gpu.models.pull` | Ollama 실행 전에 미리 Pulling할 모델 목록 설정 | `custom-values.yaml` 참고 |
### 3) Ingress 설정
#### 3.1) tls 시크릿 직접 생성
- Rancher에서 ingress 사용을 위해서는 다음과 같이 설정할 수 있다.
``` yaml
ingress:
enabled: true
hosts:
- host: ollama.example.org
paths:
- path: /
pathType: Prefix
servicePort: 6333
tls:
- hosts:
- ollama.example.org
secretName: ollama-tls-secret
```
- ingress 사용을 위해서는 인증서를 secret으로 제공해야한다. 로컬 파일을 이용해 secret을 생성하는 방법은 다음과 같다.
``` sh
kubectl create secret tls ollama-tls-secret --cert=<path-to-cert-file> --key=<path-to-key-file> -n <namespace>
```
#### 3.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: ollama.example.org
paths:
- path: /
pathType: Prefix
servicePort: 6333
tls:
- hosts:
- ollama.example.org
secretName: ollama-tls-secret
```