# 版本迁移指导

Botfront 还没有达到 1.x 版本的稳定程度,在这阶段我们主要把关注点集中在 0.y.z 的 y 版本更新上,版本之间可能会有较大的改动。

# 小版本更新

比如说 0.18.1 升级到 0.18.3

Botfront 会自动完成大部分的小版本更新处理,但有些可能需要手动接入的内容,我们会以 ONE thing 的方式给出:

  • .botfront/botfront.yaml 文件中, rasa-for-botfront 的版本改成 v1.3.9-bf.4
  • .botfront/botfront.yaml 文件中,rasa-sdk 的版本改成 1.3.2

像这样:




 
 


images:
  default:
    ...
    rasa: botfront/rasa-for-botfront:v1.3.9-bf.4
    actions: rasa/rasa-sdk:1.3.2
    ...

除此之外还需要手动更新一下文件中的对应版本字符串...

  • rasa/Dockerfile
  • actions/Dockerfile
  • actions/Dockerfile.production

# 大版本更新

# 比如从 0.18.x 更新到 0.19.x

大版本更新可能会遇到项目结构的改动,这时你需要手动创建一个新的项目,并把对应的文件拷贝到新项目下:

  1. 创建一个新项目 botfront init.
  2. botfront-db 目录拷贝到新项目的指定目录下,在此过程中,请确保 是拷贝,而不是移动,整个目录到新项目中,保留原有的项目做个备份。
  3. 如果你创建了自定义动作,那么把 actions 目录拷贝到新项目中去。
  4. 运行 botfront up,确保新项目正常工作。