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 的 一个虚拟机开发环境,其启动的虚拟机是一个集成了 dockerlaincli 等工具的 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.yamlweb 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 里面对于各环境变量的获取及其默认值,运行时应预置这些环境变量

results matching ""

    No results matching ""