jumpserver/docs/upgrade.rst

更新升级
-------------

1. 升级 Jumpserver

::

    $ git pull && pip install -r requirements/requirements.txt && cd utils && sh make_migrations.sh

2. 升级 Coco

::

    $ git pull && cd requirements && pip install -r requirements.txt   # 不要指定 -i参数

3. 升级 Luna

重新下载 release 包（https://github.com/jumpserver/luna/releases）

4. 升级 guacamole

:: 

    $ docker pull registry.jumpserver.org/public/guacamole:latest
    $ docker stop jms_guacamole  # 或者写guacamole的容器ID
    $ docker run --name jms_guacamole -d \
      -p 8081:8080 -v /opt/guacamole/key:/config/guacamole/key \
      -e JUMPSERVER_KEY_DIR=/config/guacamole/key \
      -e JUMPSERVER_SERVER=http://<填写本机的IP地址>:8080 \
      registry.jumpserver.org/public/guacamole:latest


切换分支或离线升级
-------------------------------


**Jumpserver**

说明: 以下操作，都在jumpserver所在目录运行

1. 备份配置文件

::

    $ jumpserver_backup=/tmp/jumpserver_backup
    $ mkdir -p $jumpserver_backup
    $ cp config.py $jumpserver_backup

2. 备份migrations migrations中存的是数据库表结构的变更，切换分支会丢失

::

   $ for app in common users assets ops perms terminal;do
      mkdir -p $jumpserver_backup/${app}_migrations
      cp apps/${app}/migrations/*.py $jumpserver_backup/${app}_migrations
   done


3. 备份数据库，已被不时之需

::

  $ mysqldump -u你的数据库账号 -h数据库地址 -p 数据库名称 > $jumpserver_backup/db_backup.sql

4. 备份录像文件

::

   $ cp -r data/media $jumpserver_backup/

5. 切换分支或下载离线包, 更新代码

::

   $ git checkout master  # or other branch


6. 还原配置文件

::

   $ cp $jumpserver_backup/config.py .

7. 还原数据库表结构记录

::

   $ for app in common users assets ops perms terminal;do
      cp $jumpserver_backup/${app}_migrations/*.py ${app}/migrations/
   done

8. 还原录像文件

::

   $ cp -r $jumpserver_backup/media/* data/media/

9. 更新依赖或表结构

::
   $ pip install -r requirements/requirements.txt && cd utils && sh make_migrations.sh


**Coco**

说明: 以下操作都在 coco 项目所在目录

coco是无状态的，备份 keys 目录即可

1. 备份keys

::

   $ cp -r keys $jumpserver_backup/


2. 离线更新升级coco

3. 还原 keys目录

::

   $ mv keys keys_backup
   $ cp -r  $jumpserver_backup/keys .

4. 升级依赖

::

   $ git pull && cd requirements && pip install -r requirements.txt


**Luna**

直接下载最新Release包替换即可


**Guacamole**

直接参考上面的升级即可, 需要注意的是如果更换机器，请备份