diff --git "a/1_\344\274\201\344\270\232\347\272\247PaaS\350\247\243\345\206\263\346\226\271\346\241\210/media/1.png" "b/1_\344\274\201\344\270\232\347\272\247PaaS\350\247\243\345\206\263\346\226\271\346\241\210/media/1.png" new file mode 100644 index 0000000000000000000000000000000000000000..64cdd7a7098955e885e94065dbf33cb23b6aa219 Binary files /dev/null and "b/1_\344\274\201\344\270\232\347\272\247PaaS\350\247\243\345\206\263\346\226\271\346\241\210/media/1.png" differ diff --git "a/1_\344\274\201\344\270\232\347\272\247PaaS\350\247\243\345\206\263\346\226\271\346\241\210/media/2.png" "b/1_\344\274\201\344\270\232\347\272\247PaaS\350\247\243\345\206\263\346\226\271\346\241\210/media/2.png" new file mode 100644 index 0000000000000000000000000000000000000000..9ad7347fa9619a24df08529371ece641a6c235e2 Binary files /dev/null and "b/1_\344\274\201\344\270\232\347\272\247PaaS\350\247\243\345\206\263\346\226\271\346\241\210/media/2.png" differ diff --git "a/1_\344\274\201\344\270\232\347\272\247PaaS\350\247\243\345\206\263\346\226\271\346\241\210/media/3.png" "b/1_\344\274\201\344\270\232\347\272\247PaaS\350\247\243\345\206\263\346\226\271\346\241\210/media/3.png" new file mode 100644 index 0000000000000000000000000000000000000000..b36f0f3ed8cc226dd689c24deda5e71e872ff4ad Binary files /dev/null and "b/1_\344\274\201\344\270\232\347\272\247PaaS\350\247\243\345\206\263\346\226\271\346\241\210/media/3.png" differ diff --git "a/1_\344\274\201\344\270\232\347\272\247PaaS\350\247\243\345\206\263\346\226\271\346\241\210/media/4.png" "b/1_\344\274\201\344\270\232\347\272\247PaaS\350\247\243\345\206\263\346\226\271\346\241\210/media/4.png" new file mode 100644 index 0000000000000000000000000000000000000000..0318b694ce1cb33b23537b78109d37d430edc92b Binary files /dev/null and "b/1_\344\274\201\344\270\232\347\272\247PaaS\350\247\243\345\206\263\346\226\271\346\241\210/media/4.png" differ diff --git "a/1_\344\274\201\344\270\232\347\272\247PaaS\350\247\243\345\206\263\346\226\271\346\241\210/media/5.png" "b/1_\344\274\201\344\270\232\347\272\247PaaS\350\247\243\345\206\263\346\226\271\346\241\210/media/5.png" new file mode 100644 index 0000000000000000000000000000000000000000..98fd0469d38e8b9b31df7b5a5e4e83aef2473860 Binary files /dev/null and "b/1_\344\274\201\344\270\232\347\272\247PaaS\350\247\243\345\206\263\346\226\271\346\241\210/media/5.png" differ diff --git "a/1_\344\274\201\344\270\232\347\272\247PaaS\350\247\243\345\206\263\346\226\271\346\241\210/media/6.png" "b/1_\344\274\201\344\270\232\347\272\247PaaS\350\247\243\345\206\263\346\226\271\346\241\210/media/6.png" new file mode 100644 index 0000000000000000000000000000000000000000..22a4486612944e6eee472a629bc8a7dc7cc42764 Binary files /dev/null and "b/1_\344\274\201\344\270\232\347\272\247PaaS\350\247\243\345\206\263\346\226\271\346\241\210/media/6.png" differ diff --git "a/1_\344\274\201\344\270\232\347\272\247PaaS\350\247\243\345\206\263\346\226\271\346\241\210/media/7.png" "b/1_\344\274\201\344\270\232\347\272\247PaaS\350\247\243\345\206\263\346\226\271\346\241\210/media/7.png" new file mode 100644 index 0000000000000000000000000000000000000000..6aea0c66b7105b735a422cc516fd8a900e29cf3d Binary files /dev/null and "b/1_\344\274\201\344\270\232\347\272\247PaaS\350\247\243\345\206\263\346\226\271\346\241\210/media/7.png" differ diff --git "a/1_\344\274\201\344\270\232\347\272\247PaaS\350\247\243\345\206\263\346\226\271\346\241\210/media/8.png" "b/1_\344\274\201\344\270\232\347\272\247PaaS\350\247\243\345\206\263\346\226\271\346\241\210/media/8.png" new file mode 100644 index 0000000000000000000000000000000000000000..c0579878785a4d5a21a139d5c0a78e92e733f332 Binary files /dev/null and "b/1_\344\274\201\344\270\232\347\272\247PaaS\350\247\243\345\206\263\346\226\271\346\241\210/media/8.png" differ diff --git "a/1_\344\274\201\344\270\232\347\272\247PaaS\350\247\243\345\206\263\346\226\271\346\241\210/\343\200\212\350\205\276\350\256\257\350\223\235\351\262\270\344\274\201\344\270\232\347\272\247PaaS\350\247\243\345\206\263\346\226\271\346\241\210\343\200\213\345\256\236\346\210\230\346\211\213\345\206\214.md" "b/1_\344\274\201\344\270\232\347\272\247PaaS\350\247\243\345\206\263\346\226\271\346\241\210/\343\200\212\350\205\276\350\256\257\350\223\235\351\262\270\344\274\201\344\270\232\347\272\247PaaS\350\247\243\345\206\263\346\226\271\346\241\210\343\200\213\345\256\236\346\210\230\346\211\213\345\206\214.md" index a19cb90aad760f3a8285c7c626fceb05cde6d7da..4404acf3f2513d763c65f6241b0f87f46e5c91a4 100644 --- "a/1_\344\274\201\344\270\232\347\272\247PaaS\350\247\243\345\206\263\346\226\271\346\241\210/\343\200\212\350\205\276\350\256\257\350\223\235\351\262\270\344\274\201\344\270\232\347\272\247PaaS\350\247\243\345\206\263\346\226\271\346\241\210\343\200\213\345\256\236\346\210\230\346\211\213\345\206\214.md" +++ "b/1_\344\274\201\344\270\232\347\272\247PaaS\350\247\243\345\206\263\346\226\271\346\241\210/\343\200\212\350\205\276\350\256\257\350\223\235\351\262\270\344\274\201\344\270\232\347\272\247PaaS\350\247\243\345\206\263\346\226\271\346\241\210\343\200\213\345\256\236\346\210\230\346\211\213\345\206\214.md" @@ -127,11 +127,9 @@ git push -u origin master ### 2.3 在开发者中心创建应用 -访问蓝鲸平台：https://paas-edu.bktencent.com/。进入 `开发者中心` - `应用创建` ，填写上一步获取的 `git` 仓库地址和账号 - -![image-20210925174303404](media/image-20210925174303404.png) - +访问蓝鲸平台：`https://paas-edu.bktencent.com/` ，进入 `开发者中心` - `应用创建` ，填写上一步获取的 `git` 仓库地址和账号 +![1](media/1.png) ### 2.4 下载初始化框架 @@ -139,7 +137,7 @@ git push -u origin master 代码包压缩格式为 `tar.gz`，请自行安装解压工具进行解压 -![image-20210925174429441](media/image-20210925174429441.png) +![1](media/4.png) @@ -172,9 +170,20 @@ git push ### 3.1 修改配置 -修改 `config/__init__.py` 中的 `APP_CODE` (应用ID) 和 `SECRET_KEY` (应用TOKEN) ，应用ID和token都可以可以在开发者中心查询到 +在开发者中心查询到 `APP_CODE` (应用ID) 和 `SECRET_KEY` (应用TOKEN) ，然后使用shell相关的命令进行关于以下环境变量的配置。 + +```shell +export BKPAAS_ID=APP_CODE +export BKPAAS_APP_SECRET=SECRET_KEY +export BKPAAS_MAJOR_VERSION=3 +export BK_PAAS2_URL=蓝鲸桌面的地址，用于拼接登录链接，注意不要带 console 路径，形如: http://paas.example.com +export BK_COMPONENT_API_URL=蓝鲸 ESB API 地址，形如: http://bkapi.example.com +export BKPAAS_LOGIN_URL=蓝鲸登录链接，形如: http://paas.example.com/login +``` +或者可以在Pycharm中进行相应的配置如图下所示： +![1](media/3.png) ### 3.2 安装开发框架依赖包 @@ -182,8 +191,6 @@ git push pip3 install -r requirements.txt ``` - - ### 3.3 创建和初始化数据库 在CMD上执行以下命令，进入 MySQL 控制台。用户名和密码在安装 MySQL 时已确定 @@ -204,6 +211,8 @@ CREATE DATABASE `{APP_CODE}` default charset utf8 COLLATE utf8_general_ci; 并修改 `config/dev.py` 中 `DATABASES` 配置项 +![1](media/8.png) + - 初始化本地数据库(在工程根目录下) ```bash @@ -225,7 +234,7 @@ python manage.py runserver appdev.paas-edu.bktencent.com:8000 ``` - 本地访问 -用浏览器访问 `http://appdev.paas-edu.bktencent.com:8000` , 就可以看到开发框架的实例页面 +用浏览器访问 `http://appdev.paas-edu.bktencent.com:8000` ，就可以看到开发框架的实例页面 ![image-20201012200207700](media/image-20201012200207700.png) @@ -259,55 +268,9 @@ helloworld - 重新执行 `python manage.py runserver appdev.paas-edu.bktencent.com:8000` ，让新代码生效。若之前的 server 进程已经在执行 ，可在命令行 `Ctrl` + `C` 直接终止 - 在浏览器访问 `http://appdev.paas-edu.bktencent.com:8000/helloworld/` ,将显示 `helloworld` 文本 - - - - ## 5. 部署到线上环境 -### 5.1 自助创建线上环境DB - -访问 `https://paas-edu.bktencent.com/` 将“自助创建数据库”这个 App 添加到桌面 - - - -![image-20210925175928740](media/image-20210925175928740.png) - - - -任务参数配置，其中测试环境数据库名建议格式： `{app_id}stag`，我们先创建**测试环境**的数据库，例如应用ID为: `bk-demo`，那么此处填写的数据库名应为 `bkdemostag`。用户名和密码可自行设置。 - -![image-20210925180917579](media/image-20210925180917579.png) - - - -点击下一步，并执行 - -![image-20210925180212362](media/image-20210925180212362.png) - - - -执行成功之后，即可看到创建的DB信息，我们需要记住它。 - -![image-20210925180519509](media/image-20210925180519509.png) - - - -这样就把测试环境的DB创建好了，接下来可以重复上述步骤，把**正式环境**的DB也创建好。正式环境数据库名建议格式： `{app_id}prod`。与上述步骤的区别是，需要将参数填写中的数据库名改为`bkdemoprod`。执行成功后，记下DB信息 - - - -### 5.2 修改 config DB 配置 - -- 修改文件 `config/stag.py` ，将上一步创建的**测试环境**DB信息填写到对应字段中。其中 `HOST` 取值 `"10.0.2.4"` - -![image-20201012194430725](media/image-20201012194430725.png) - -- 类似的，修改文件 `config/prod.py` ，将上一步创建的**正式环境**DB信息填写到对应字段中 - - - -### 5.3 推送本地代码到线上仓库 +### 5.1 推送本地代码到线上仓库 在cmd中进入到代码仓库根目录，执行以下命令 @@ -322,28 +285,20 @@ git commit -m "feature: add helloworld" git push ``` +### 5.2 线上部署 +1.访问开发者中心`https://bkpaas.paas-edu.bktencent.com/developer-center`，找到需要部署的SaaS，点击“部署” -### 5.4 线上部署 - -1. 访问开发者中心 https://paas-edu.bktencent.com/app/list/，找到需要部署的SaaS，点击“部署” - -![image-20201012195243446](media/image-20201012195243446.png) - - - -2. 进入到部署页面之后，点击“一键部署”，应用将立即开始部署到测试环境。稍等片刻后，点击上方“马上访问”即可访问测试环境页面。 - - - -![image-20201012195157039](media/image-20201012195157039.png) +![1](media/2.png) +2.进入到预发布环境部署页面之后，点击“部署”，应用将立即开始部署到预发布环境。稍等片刻后，点击上方“马上访问”即可访问测试环境页面。 +![1](media/5.png) -3. 尝试访问：`https://paas-edu.bktencent.com/t/{app_id}/` 和 `https://paas-edu.bktencent.com/t/{app_id}/helloworld/` 观察是否符合预期 +3.尝试部署到生产环境当中 -4. 当测试环境部署成功后，即可部署正式环境。稍等片刻后，点击上方“马上访问”即可访问测试环境页面。 +![1](media/6.png) -![image-20201012195828641](media/image-20201012195828641.png) +4.点击尝试访问，观察是否符合预期 -5. 尝试访问：`https://paas-edu.bktencent.com/o/{app_id}/` 和 `https://paas-edu.bktencent.com/o/{app_id}/helloworld/` 观察是否符合预期 \ No newline at end of file +![1](media/7.png) \ No newline at end of file