mirror of
https://github.com/xinnan-tech/xiaozhi-esp32-server.git
synced 2026-07-21 10:55:38 +00:00
75 lines
2.2 KiB
Markdown
75 lines
2.2 KiB
Markdown
# 本地编译docker镜像方法
|
||
|
||
现在本项目已经使用`github`的`自动编译docker镜像`功能，如果您拉取的是项目发行的镜像，您没有自己编译镜像的需求，那就忽略本文档。
|
||
|
||
如果您修改了源码，然后想采用`docker`的方式部署运行，可以参照以下步骤操作：
|
||
|
||
## 1、环境准备
|
||
|
||
安装docker：
|
||
```bash
|
||
sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
|
||
```
|
||
|
||
## 2、编译镜像
|
||
|
||
当你修改好代码后，需要编译新的镜像时，需要按照以下步骤操作：
|
||
|
||
准备好你的`你的用户名`和`新的版本号`。
|
||
- 这个`你的用户名`是你在`docker hub`注册的用户名，例如`xiaozhi`。当然，如果你不需要推送到`docker hub`，你可以自由定义。
|
||
- 这个`新的版本号`是你编译的镜像版本，例如`1.2.3`，你可以根据需要自定义或者使用日期格式（例如`20260609`）主要是方便和现在运行的版本号做区分，同时也方便下次回忆你是什么时候构建的，不要和现在你本机运行的版本号相同。
|
||
|
||
进入`xiaozhi-esp32-server`项目根目录，编译 server 和 web 两个镜像：
|
||
|
||
```bash
|
||
cd 项目根目录
|
||
|
||
# 编译server镜像
|
||
docker build -f Dockerfile-server -t 你的用户名/xiaozhi-esp32-server:新的版本号 .
|
||
|
||
# 编译web镜像
|
||
docker build -f Dockerfile-web -t 你的用户名/xiaozhi-esp32-server-web:新的版本号 .
|
||
|
||
```
|
||
|
||
## 3、修改docker-compose配置
|
||
|
||
```bash
|
||
cd main/xiaozhi-server
|
||
```
|
||
|
||
编辑 `docker-compose_all.yml` 文件，将镜像版本替换为你刚才编译的版本：
|
||
|
||
```yaml
|
||
services:
|
||
xiaozhi-esp32-server:
|
||
image: 你的用户名/xiaozhi-esp32-server:新的版本号 # 修改为你的镜像地址
|
||
...
|
||
|
||
xiaozhi-esp32-server-web:
|
||
image: 你的用户名/xiaozhi-esp32-server-web:新的版本号 #修改为你的镜像地址
|
||
...
|
||
```
|
||
|
||
## 4、重启服务
|
||
|
||
```bash
|
||
# 停止旧容器
|
||
docker compose -f docker-compose_all.yml down
|
||
|
||
# 启动新容器
|
||
docker compose -f docker-compose_all.yml up -d
|
||
```
|
||
|
||
## 5、验证
|
||
|
||
查看日志确认服务启动正常：
|
||
|
||
```bash
|
||
# 查看server日志
|
||
docker logs -f -n 50 xiaozhi-esp32-server
|
||
|
||
# 查看web日志
|
||
docker logs -f -n 50 xiaozhi-esp32-server-web
|
||
```
|