蓝鲸是一个开放式的运维管理平台，拥有丰富APP的同时，平台将持续提炼一些常用的功能
和脚本让用户快速上手，最大程度的降低运维门槛、提升运维效率；
截至目前，腾讯所有的端游、页游、手游都在使用蓝鲸系统做运维管理，效率提升近百倍；

蓝鲸平台地址：http://o.qcloud.com/ 
开发者中心地址：http://o.qcloud.com/developer-center

说明:目前只针对腾讯云注册用户开放
腾讯云用户注册地址：http://manage.qcloud.com/developerCenter/registUser.php

蓝鲸QQ群号码：204042538
加群链接：http://jq.qq.com/?_wv=1027&k=QTs6eb
 

目录 1 蓝鲸平台介绍 1.1 桌面 1.2 应用市场 2 开发者中心介绍 2.1 功能介绍 2.1.1 创建应用 2.1.2 应用部署 2.2 应用服务 2.2.1 日志分析 2.2.2 数据分析 2.2.3 权限管理 2.2.4 任务管理 2.2.5 告警监控配置 2.2.6 用户反馈 2.2.7 推广 2.3 APP开发 2.3.1 本地开发准备 2.2.2 开发注意事项 2.2.3 常见问题

 

1 蓝鲸平台介绍

1.1 桌面

桌面是蓝鲸的控制台，蓝鲸相关的操作都是在桌面中进行的。
（1）桌面切换：点击桌面顶部的1、2、3、4、5等字样可以在不同的桌面间切换。
（2）添加：点击桌面上的添加图标，可以“添加应用”跳转到应用市场中添加APP，可以可“新建文件夹”在桌
面上创建文件夹。
 
（3）文件夹：右键可以对文件夹进行打开、重命名等操作。文件夹打开后，可以直接将APP拖入、拖出文件夹中。
 
（4）设置：在桌面空白处右键，包含设置桌面的主题和壁纸等功能，点击注销将退出登录。

1.2 应用市场

应用系统中包含蓝鲸系统中的所有APP，用户可以根据APP名称、开发者等信息搜索到相关的APP。（访问地址：http://o.qcloud.com/console/?app=market） 
应用市场的左侧为APP的分类，点击相应的分类可以直接查看该分类的所有APP。
 
单击APP的名称或者图标可以进入到APP的详情页面，其中： 
（1）复制宣传链接：将APP的访问链接复制到剪切板 
（2）添加应用：将APP添加到桌面 

2 开发者中心介绍

2.1 功能介绍

开发者中心包括创建应用、开发部署、应用管理等一系列APP部署和管理的相关操作。
开发者中心访问地址：http://o.qcloud.com/developer-center 

2.1.1 创建应用

用户可以通过以下几个步骤来创建自己的应用：
1）用户可以点击“创建应用”来创建自己的APP
2）用户填写完APP ID和APP名称等信息后就可以，系统会自动给这个APP创建数据库并初始化SVN仓库代码。
 
3）点击“签出代码”就可以获取APP的SVN地址，将APP的目录checkout到本地后就可以开始你的APP开发了。

2.1.2 应用部署

APP开发完成后并将代码提交到SVN后，就可以通过“应用部署”将APP部署到测试\正式环境中。
 
操作入口：应用列表-》点击对应应用的部署链接，即可进入应用部署页面。 
 
（1）测试部署：该操作将APP代码在测试环境上进行部署，部署成功后就可以在测试环境中使用您的APP。如果后续对代码进行了修改，点击【重新测试部署】就可以了。
如果代码中使用了celery来执行后台任务可以勾选上“是否使用celery”。
 
（2）上线部署：该操作将APP代码在正式环境上进行部署，部署成功后就可以在正式环境中使用您的APP。
已上线的APP需要进行【重新测试部署】并在测试环境测试成功后， 才能再次上线。
（3）下架：系统将APP代码从您选择的环境上撤销部署，届时用户将无法访问该APP，但是该APP的数据库依然保
留。您可以进行“测试部署”操作，重新部署APP。

2.2 应用服务

开发者中心为用户提供调试、管理、监控等功能。操作入口：应用列表-》点击对应的应用，即可进入应用管理
页面，页面左侧有功能导航栏，包括日志分析、数据分析、权限管理、任务管理、告警监控配置、用户反馈。

2.2.1 日志分析

提供django日志和uwsgi日志，用户可以通过日志进行分析，锁定应对哪里进行调优。

2.2.2 数据分析

提供APP的访问的统计信息（如PV、UIP）。

2.2.3 权限管理

通过开启白名单限制用户访问，只有在白名单中的用户才能访问APP。

2.2.4 任务管理

管理APP的后台任务，也可以查看celery的状态，并手动停止或启动Celery。

 

2.2.5 告警监控配置

监控APP的运行状况，并配置告警。

2.2.6 用户反馈

收集用户对APP的反馈信息，APP开发者可以第一时间看到用户对APP的反馈。

2.2.7 推广

APP上线后，可以申请推广，审核通过后，APP将出现在应用市场(http://o.qcloud.com/console/?app=market）
的广告位上。

 

2.3 APP开发

在开发者中心（http://o.qcloud.com/developer-center）创建应用后，从SVN中checkout代码到本地就可以开
始本地开发；本地调试成功后就可以将应用部署到蓝鲸平台中。
蓝鲸平台提供了一套基于Django框架的APP开发样例，样例中提供了QQ统一登录、腾讯云API接口、 任务调度等
功能，用户在APP开发样例上进行二次开发，可以大幅度提高开发效率。创建应用时自动将最新版的开发样例代
码初始化到APP的SVN中。
APP开发样例 访问地址：http://o.qcloud.com/console?app=app_template

2.3.1 本地开发准备

开发前准备包括：安装python、Mysql等开发环境的配置； APP开发样例下载；配置host。
1.开发环境配置
（1）安装python
（2）安装Mysql
（3）安装 setuptools-0.6c11.win32-py2.7.exe和MySQL-python-1.2.3.win32-py2.7.exe
（4）安装python库，包括django1.3、south、httplib2等
（5）安装本地开发工具，windows环境下推荐使用Eclipse进行代码开发、使用TortoiseSVN管理SVN

2．从svn中检出（checkout）代码
（1）将APP从SVN仓库中检出到本地目录中
（2）将APP样例的代码拷贝到到APP本地目录中
APP开发样例代码下载地址：
（3）配置修改：
1）config/settings_develop.py 文件中DATABASES 项中：填写本地数据库的相关信息
2）本地使用Eclipse开发时，工程的启动端口默认为8000，如使用其他端口在config/settings_develop.py 文
件中S_URL 项中：修改工程的启动端口
 

3.host配置
在hosts中配置：127.0.0.1 app.o.qcloud.com
1）windows下host配置
C:\Windows\System32\drivers\etc\hosts文件 中 添加：
127.0.0.1 app.o.qcloud.com
2）linux下host配置
/etc/hosts 文件中添加：127.0.0.1 app.o.qcloud.com

2.2.2 开发注意事项

1.开发建议
(1）url的末尾一定要加上“/”， 如：“/app_code/path/current_url/”不要写成“/app_code/path/
current_url”

2.数据库操作
蓝鲸中APP使用south来管理数据库。south针对django自带的syncdb同步models和数据库的缺陷开发的数据迁
移工具，South能够检测对models的更改并同步到数据库。
South的使用方法如下:
（1）执行命令 manage.py syncdb, 这一步的作用是在数据库中创建south_migrationhistory的表，用来存放数
据库的变更历史。 
（3）执行manage.py startapp yourappname 创建你的应用，并把你的应用添加到config/settings_custom.py
文件"INSTALLED_APPS_CUSTOM"中。 
（4）在django的models.py中建立数据库模型后，执行 schemamigration yourappname --init，这一步执行完
成后可以在你的app下看到一个migrations的文件夹，里面有__init__.py和0001_initial.py两个文件 
（5）执行成功后再执行migrate yourappname ，这时候数据库中已经建立了你定义的表，并可以看到south_migrationhistory表中增加了一条记录。
（6）在工程中新增app，只需再次执行3—5的步骤即可。 
（7）更改models.py的内容，只需执行schemamigration yourappname --auto 和migrate yourappname即可。 
注意： 必须按上面的步骤顺序执行，manage.py syncdb这个命令只在第2步使用一次。
请注意在第一次syncdb时不要加入自己的app，先syncdb初始化south的数据，然后再加入自己的app进行south
操作!

2.2.3 常见问题

1.编码错误
错误描述：'utf8' codec can't decode byte 0xb6 in position 6: invalid start byte 
错误原因：
（1）本地开发，将app工程目录放在包含中文名称的目录下。
解决方案：确保APP的路径不包含中文名称
（2）本地开发没有设置编码。
解决方案：
在python的安装路径中下的/Lib/site-packages下面创建文件sitecustomize.py，内容如下：

如果没有加入该文件，则在有编码问题的.py代码中，加入以下代码：

2.工程文件目录冲突
错误描述：工程运行启动时，提示No module named settings 错误
错误原因： 工程名和内建app名重复，如下图所示

解决方案：修改工程名或内建app名称

3.提测、上线时fixture数据冲突
错误描述：用户提测、上线时报错，错误原因提示：syncdb_and_migrate Problem installing fixture
错误原因：初始化数据冲突
解决方案：
（1）请检查fixtures 文件内pk和username值是否和数据库中auth_user表里对应的用户名、id一致，请查询
并修改。
（2）config/settings_custom.py 文件中的IS_FIXTURES 设置为False，关闭初始化数据开关。

4.提测、上线时数据库错误
错误描述：类似 _mysql_exceptions.OperationalError: (1045, "Access denied for user @ (using
password: NO)") 错误
解决方案：请检查App的数据库配置（库名、用户名、密码）是否正确，如果使用非蓝鲸提供的DB，请给蓝鲸
机器IP进行授权。

5. SVN 相关问题
遇到奇怪的SVN错误，可以：
（1）重新在本地新建目录，检出干净的svn
（2）或者先保存代码，然后删除该版本，重新导入