我的第一个蓝鲸APP

导出PDF

创建应用

通过以下几个步骤来创建应用

  • 1.点击左侧导航中的“应用创建”

  • 2.填写应用基本注册信息(应用 ID、应用名称、应用分类等)

  • 3.点击“创建应用”,系统会自动为您的应用创建数据库、初始化 SVN 仓库代码并创建应用

图1

签出代码

从 SVN 中签出(checkout)代码

  • 1.应用创建完成后,点击页面上的“签出代码”,将应用的目录(开发框架已经初始化到您的代码仓库)checkout 到本地来以便您开发应用

  • 2.您也可以通过入口:“应用列表“>点击“应用名称”>”代码管理”签出代码

  • 3.您的应用代码目录分为 trunk、tags、branches 三个子目录,建议你在 trunk 目录下进行开发

注:本地开发路径中请不要包含中文

图2
图3

安装环境

开发环境安装(本节只给出过程,详细请参考蓝鲸智云统一开发环境搭建指南

方式一

  • 1.本地环境搭建镜像

  • 2.根据本地环境搭建文档搭建

  • 3.安装组件 SDK

方式二

  • 1.安装 python

  • 2.安装 Mysql

  • 3.安装 setuptools-0.6c11.win32-py2.7.exe和MySQL-python-1.2.3.win32-py2.7.exe

  • 4.安装 python 库,包括 django1.8、mako、suds、httplib2 等

  • 5.安装本地开发工具,Windows 环境下推荐使用 Eclipse 进行代码开发、使用 TortoiseSVN 管理 SVN

  • 6.如开发项目需要用到后台任务时,需要下载 celery 相关开发指引和下载包

  • 7.安装组件 SDK

开发项目

以下修改请在您的应用 trunk 目录下的代码中操作(应用目录结构的和相关说明请参考工程目录下的 README 文件)

配置修改

请在 config/settings_develop.py 文件中 DATABASES 项中填写本地数据库的相关信息

图4

注:本地开发应用时,还需要进行以下配置

本地使用 Eclipse 开发时,工程的启动端口默认为8000,如使用其他端口在’config/settings_develop.py‘文件中 S_URL 项中:修改工程的启动端口

hosts配置:127.0.0.1 appdev.o.qcloud.com

1.windows 下 host 配置

C:\Windows\System32\drivers\etc\hosts 文件中添加:127.0.0.1 appdev.o.qcloud.com

2.linux 下 host 配置

/etc/hosts 文件中添加:127.0.0.1 appdev.o.qcloud.com

注:本地开发时请用 appdev.o.qcloud.com 域名访问(本地开发也通过 QQ登录,所以必须用域名访问)

Django数据库操作

蓝鲸应用使用 Django1.8 自带的 migration 来管理数据库。migration 是 django 自带的同步 models 和数据库的数据迁移工具,migration 能够检测对 models 的更改并同步到数据库。

migration 的使用方法如下:

1.执行 manage.py migrate(作用是在数据库中创建 Django 自带的表,包括 django_migrations 的表,用来存放数据库的变更历史)

2.执行 manage.py startapp yourappname、添加 yourappname 到 config/settings_custom.py文件 “INSTALLED_APPS_CUSTOM” 中

3.在 Django 的 models.py 中建立数据库模型后,执行 manage.py makemigrations yourappname

4.步骤(3)执行成功后再执行 manage.py migrate yourappname ,这时候数据库中已经建立了您定义的表

5.在工程中新增 app,只需再次执行2—4的步骤即可

6.更改 models.py 的内容,只需执行 manage.py makemigrations yourappnamemanage.py migrate yourappname 即可

注意: 必须按上面的步骤顺序执行,在执行第(1)步时最好不要加入自己的 app,除非您保证自己的 app 已经有 migration 的 initial 文件

部署项目

1.操作入口

应用列表 > 点击应用名称 > 应用部署

图5

2.测试部署

将应用代码在测试环境上进行部署,部署成功后您就可以在测试环境上访问您的应用。

如果有功能更新,请提交代码至 svn,并重新【测试部署】即可。

如果代码中使用了 celery 来执行后台任务,测试部署时请勾选“启用celery”。

3.正式部署

将应用代码在正式环境上进行部署,部署成功后就可以在蓝鲸桌面(正式环境)使用您的应用。

已正式部署的应用需要进行【测试部署】并在测试完成后, 才能再次进行正式部署。

4.下架

系统将应用代码从您选择的环境上撤销部署,届时用户将无法访问该应用,但是该应用的数据库依然保留。您可以进行【测试部署】操作,重新部署应用。

本文档是否对您有帮助?