蓝鲸智云应用(APP)开发指南

导出PDF

蓝鲸智云应用基于蓝鲸智云应用开发框架做二次开发,蓝鲸智云应用开发框架是基于 Django 框架构建的,其中涉及到 Python , Django , Mako, Html, Javascript,CSS 等技术。

本白皮书重点介绍使用蓝鲸智云开发者中心,进行蓝鲸智云应用开发的主要步骤,及注意事项。

开发环境搭建

  • 1.蓝鲸智云统一开发环境下载

  • 2.蓝鲸智云统一开发环境搭建指南

创建应用

基本信息注册

蓝鲸智云开发者中心中创建应用,填写应用基本信息(包括应用 ID、应用名称、代码仓库等信息)。

图1

注意:代码仓库请务必选择跟仓库地址保持一致。若选择了“Git”,“仓库地址”填写SVN地址,将导致应用部署失败。

创建应用

点击“创建应用”,系统会将基本信息注册到蓝鲸智云开发者中心。

获取代码,修改配置

获取蓝鲸开发框架

用户可以在蓝鲸智云开发者中心项目源码的 framework 目录中获取应用开发框架代码,并按以下提示修改配置。

配置修改

(1)通用配置

  • 1.conf/default.py 文件:APP_ID 和 APP_TOKEN (蓝鲸智云开发者中心 > 点击应用ID > 基本信息中可以查看到这个两个值的信息)

  • 2.conf/default.py 文件:BK_PAAS_HOST(用户搭建的蓝鲸智云开发者中心的域名,请参考开发者中心 > 新手指南 >配置修改中的值)

  • 3.conf/settings_development.py 文件:DATABASES(请创建本地开发数据库,并修改配置信息)

  • 4.conf/settings_testing.py 文件:DATABASES(请创建测试环境数据库,并修改配置信息)

  • 5.conf/settings_production.py 文件:DATABASES(请创建正式环境数据库,并修改配置信息)

说明:测试环境和正式环境都需要开发者登录到配置的服务器上创建应用的数据库,并对AppServer授权。创建DB,请注意DB编码!
create database if not exists 'db_name' default character set utf8 collate utf8_general_ci;

(2)Celery

若需要使用 Celery,请修改以下配置:( Celery 开发指引 参考开发者中心 > 新手指南 > 配置修改)

  • 1.conf/default.py 文件:IS_USE_CELERY 的值设置为: True

  • 2.conf/default.py 文件:BROKER_URL_DEV(请创建本地开发的 Celery 消息队列,并修改配置信息,推荐使用 RabbitMQ)

  • 3.conf/default.py 文件:CELERY_IMPORTS(添加 celery 任务模块)

开发应用

Django1.8数据库操作

  • 1.执行python manage.py migrate

  • 2.执行python manage.py startapp yourappname

  • 3.添加 yourappname 到 config/default.py 文件 “INSTALLED_APPS” 中

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

  • 5.执行python manage.py migrate yourappname

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

启动应用

  • 1.本地配置host:127.0.0.1 dev.xxx.xxx(注意:必须与PaaS平台主站在同一个一级域名)

  • 2.进入工程目录

  • 3.执行python manage.py runserver,使用 http://dev.xxx.xxx:8000 访问

部署应用

操作入口:蓝鲸智云开发者中心 > 应用列表 > 点击应用名称 > 应用部署。

图2

用户开发完应用后可进行测试、正式部署操作。

图3

说明:蓝鲸智云本次提供了内置应用(开发者中心 > 内置应用,只有管理员才有权限看到这个入口),里面有五个应用,请点击“部署”,等待部署成功后,即可在“工作台”看到这五个应用。

最终效果

图4

图5

本文档是否对您有帮助?