mirror of
https://github.com/openimsdk/open-im-server.git
synced 2025-10-26 13:12:12 +08:00
docs: update deploy docs.
This commit is contained in:
parent
9768656943
commit
8213948d89
@ -6,6 +6,15 @@
|
|||||||
- Memory: 4 GiB
|
- Memory: 4 GiB
|
||||||
- Disk usage: 20 GiB (on Node)
|
- Disk usage: 20 GiB (on Node)
|
||||||
|
|
||||||
|
## Preconditions
|
||||||
|
|
||||||
|
ensure that you have already deployed the following components:
|
||||||
|
|
||||||
|
- Redis
|
||||||
|
- MongoDB
|
||||||
|
- Kafka
|
||||||
|
- MinIO
|
||||||
|
|
||||||
## Origin Deploy
|
## Origin Deploy
|
||||||
|
|
||||||
### Enter the target dir
|
### Enter the target dir
|
||||||
@ -14,29 +23,19 @@
|
|||||||
|
|
||||||
### Deploy configs and dependencies
|
### Deploy configs and dependencies
|
||||||
|
|
||||||
Upate your `openim-config.yml`. **You can check the official docs for more details.**
|
Upate your configMap `openim-config.yml`. **You can check the official docs for more details.**
|
||||||
|
|
||||||
In `openim-config.yml`, you need modify the following configurations:
|
In `openim-config.yml`, you need modify the following configurations:
|
||||||
|
|
||||||
**discovery.yml**
|
**discovery.yml**
|
||||||
|
|
||||||
- `kubernetes.namespace`: default is `default`, you can change it to your namespace.
|
- `kubernetes.namespace`: default is `default`, you can change it to your namespace.
|
||||||
- `enable`: set to `kubernetes`
|
|
||||||
- `rpcService`: Every field value need to same to the corresponding service name. Such as `user` value in same to `openim-rpc-user-service.yml` service name.
|
|
||||||
|
|
||||||
**log.yml**
|
|
||||||
|
|
||||||
- `storageLocation`: log save path in container.
|
|
||||||
- `isStdout`: output in kubectl log.
|
|
||||||
- `isJson`: log format to JSON.
|
|
||||||
|
|
||||||
**mongodb.yml**
|
**mongodb.yml**
|
||||||
|
|
||||||
- `address`: set to your already mongodb address or mongo Service name and port in your deployed.
|
- `address`: set to your already mongodb address or mongo Service name and port in your deployed.
|
||||||
- `username`: set to your mongodb username.
|
|
||||||
- `database`: set to your mongodb database name.
|
- `database`: set to your mongodb database name.
|
||||||
- `password`: **need to set to secret use base64 encode.**
|
- `authSource`: set to your mongodb authSource. (authSource is specify the database name associated with the user's credentials, user need create in this database.)
|
||||||
- `authSource`: set to your mongodb authSource, default is `openim_v3`.
|
|
||||||
|
|
||||||
**share.yml**
|
**share.yml**
|
||||||
|
|
||||||
@ -50,15 +49,11 @@ In `openim-config.yml`, you need modify the following configurations:
|
|||||||
**redis.yml**
|
**redis.yml**
|
||||||
|
|
||||||
- `address`: set to your already redis address or redis Service name and port in your deployed.
|
- `address`: set to your already redis address or redis Service name and port in your deployed.
|
||||||
- `password`: **need to set to secret use base64 encode.**
|
|
||||||
|
|
||||||
**minio.yml**
|
**minio.yml**
|
||||||
|
|
||||||
- `bucket`: set to your minio bucket name or use default value `openim`.
|
|
||||||
- `accessKeyID`: set to your minio accessKey ID or use `root`.
|
|
||||||
- `secretAccessKey`: need to set to secret use base64 encode.
|
|
||||||
- `internalAddress`: set to your already minio internal address or minio Service name and port in your deployed.
|
- `internalAddress`: set to your already minio internal address or minio Service name and port in your deployed.
|
||||||
- `externalAddress`: set to your already expose minio external address or minio Service name and port in your deployed.
|
- `externalAddress`: set to your already expose minio external address.
|
||||||
|
|
||||||
### Set the secret
|
### Set the secret
|
||||||
|
|
||||||
@ -66,16 +61,18 @@ A Secret is an object that contains a small amount of sensitive data. Such as pa
|
|||||||
|
|
||||||
#### Example:
|
#### Example:
|
||||||
|
|
||||||
create a secret for redis password. You can create new file is `redis-secret.yml` or append contents to `openim-config.yml` use `---` split it.
|
create a secret for redis password. You can update `redis-secret.yml`.
|
||||||
|
|
||||||
|
you need update `redis-password` value to your redis password in base64.
|
||||||
|
|
||||||
```yaml
|
```yaml
|
||||||
apiVersion: v1
|
apiVersion: v1
|
||||||
kind: Secret
|
kind: Secret
|
||||||
metadata:
|
metadata:
|
||||||
name: redis-secret
|
name: openim-redis-secret
|
||||||
type: Opaque
|
type: Opaque
|
||||||
data:
|
data:
|
||||||
redis-password: b3BlbklNMTIz # "openIM123" in base64
|
redis-password: b3BlbklNMTIz # you need update to your redis password in base64
|
||||||
```
|
```
|
||||||
|
|
||||||
#### Usage:
|
#### Usage:
|
||||||
@ -95,11 +92,11 @@ spec:
|
|||||||
containers:
|
containers:
|
||||||
- name: rpc-user-server
|
- name: rpc-user-server
|
||||||
env:
|
env:
|
||||||
- name: IMENV_REDIS_PASSWORD # adapt to redis.yml password field
|
- name: IMENV_REDIS_PASSWORD # adapt to redis.yml password field in OpenIM Server config, Don't modify it.
|
||||||
valueFrom:
|
valueFrom:
|
||||||
secretKeyRef:
|
secretKeyRef:
|
||||||
name: redis-secret
|
name: openim-redis-secret # You deployed secret name
|
||||||
key: redis-password
|
key: redis-password # You deployed secret key name
|
||||||
```
|
```
|
||||||
|
|
||||||
So, you need following configurations to set secret:
|
So, you need following configurations to set secret:
|
||||||
@ -110,6 +107,12 @@ So, you need following configurations to set secret:
|
|||||||
- `MINIO_ACCESSKEYID`
|
- `MINIO_ACCESSKEYID`
|
||||||
- `MINIO_SECRETACCESSKEY`
|
- `MINIO_SECRETACCESSKEY`
|
||||||
|
|
||||||
|
Apply the secret.
|
||||||
|
|
||||||
|
```shell
|
||||||
|
kubectl apply -f redis-secret.yml -f minio-secret.yml -f mongo-secret.yml
|
||||||
|
```
|
||||||
|
|
||||||
### Apply all config and dependencies
|
### Apply all config and dependencies
|
||||||
|
|
||||||
`kubectl apply -f ./openim-config.yml`
|
`kubectl apply -f ./openim-config.yml`
|
||||||
@ -124,10 +127,6 @@ So, you need following configurations to set secret:
|
|||||||
|
|
||||||
**If you have already deployed the storage component, you need to update corresponding config and secret. And pass corresponding deployments and services build.**
|
**If you have already deployed the storage component, you need to update corresponding config and secret. And pass corresponding deployments and services build.**
|
||||||
|
|
||||||
Run infrasturcture components.
|
|
||||||
|
|
||||||
`kubectl apply -f minio-service.yml -f minio-statefulset.yml -f mongo-service.yml -f mongo-statefulset.yml -f redis-service.yml -f redis-statefulset.yml -f kafka-service.yml -f kafka-statefulset.yml`
|
|
||||||
|
|
||||||
> Note: Ensure that infrastructure services like MinIO, Redis, and Kafka are running before deploying the main applications.
|
> Note: Ensure that infrastructure services like MinIO, Redis, and Kafka are running before deploying the main applications.
|
||||||
|
|
||||||
### run all deployments and services
|
### run all deployments and services
|
||||||
|
|||||||
Loading…
x
Reference in New Issue
Block a user