console 部署文档

在 LAIN 的机制下对 console 进行编译部署

Precondition

准备 lain.yaml

• 默认使用的 lain.yaml 中包含 console UI Archon，如果不想使用 UI 可以使用 lain-without-ui.yaml 替换 lain.yaml 文件
• 如果 console 使用了 archon 并且想要打开 auth，需要在 lain.yaml 中为所有的 proc 配置 secret_files 为 config 文件，并使用 lvault 添加相应配置文件

Usage

1. local dev/test env @ lain-box

Target : 基于 LAIN 的机制提供一个方便的可重建的 docker 化的本地开发和测试环境 REF : 建议阅读 Docker Docs Docker —— 从入门到实践 LAIN White Paper lain-box 是基于 vagrant / virtualbox 的 一个虚拟机开发环境，其启动的虚拟机是一个集成了 docker 和 laincli 等工具的 centos7.2 ，作为 docker daemon 的宿主系统

1.1. LAIN 环境预备

• 宿主机（咱们一般都是 mac book 对吧）上代码目录（假设在 /code/） cd /code/ && git clone https://github.com/laincloud/lain-box.git
• 宿主机 cd /code/lain-box
• 宿主机 vim config.yaml按照其中的说明修改想要在宿主机和虚拟机之间映射的目录，建议将宿主机的 console 目录（假设在 /code/console）映射到虚拟机里的 /apps/console，即写成 console: /code/console
• 宿主机 vagrant up 启动虚拟机（第一次启动会下载一个几百M的系统模板，需要在办公网）
• 宿主机 vagrant ssh 登录虚拟机（默认用户 vagrant ，使用 vagrant ssh 时免密码，sudo 时也基本免密码，需要密码的时候 root/vagrant 用户的密码都是 vagrant ）
• 虚拟机 cd /apps/console
• 虚拟机 lain prepare 将远程 docker image 拉到本地并做指定的准备工作，看网络情况可能会花一些时间

1.2. local test

• 虚拟机/宿主机 do some coding && commit
• 虚拟机 lain test 在容器内执行本地测试，可以在 lain.yaml 中增加想要执行测试的指令

1.3. local build 和 开发过程

• 虚拟机 lain update
• 虚拟机 lain config save local domain lain.local
• 虚拟机/宿主机 do some coding && commit
• 虚拟机 lain test 构建镜像，并进行测试
• git push 代码提交推送
• gitlab mergerequest 代码审核
• merge to master 合入
• 虚拟机 lain tag local && lain deploy local 作为 LAIN 的开发者可以部署到本地的 LAIN 集群进行测试

1.4. local debug server

前提是先提供本地测试数据库并修改配置使应用连接本地数据库

• 虚拟机 lain build 用测试配置构建应用
• 虚拟机 lain run web 会按照 lain.yaml 中 web proc 描述 serve 在指定端口，即可通过 http://192.168.10.24:8000 访问本地测试服务
  • console 本地运行需要仔细阅读 commons/settings.py 里面对于各环境变量的获取及其默认值，运行时应注入这些环境变量
• 虚拟机 mkvirtualenv console ; pip install -r pip-req.txt ; python manage.py runserver 0.0.0.0:18000，即可通过 http://192.168.10.24:18000 访问本地测试服务
  • console 本地运行需要仔细阅读 commons/settings.py 里面对于各环境变量的获取及其默认值，运行时应预置这些环境变量