yapi/static/doc/devops.html

190 lines
9.7 KiB
HTML
Raw Normal View History

2017-10-10 10:25:50 +08:00
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width,minimum-scale=1.0,maximum-scale=1.0,user-scalable=no" />
<meta name="format-detection" content="telephone=no,email=no" />
<meta http-equiv="X-UA-Compatible" content="ie=edge, chrome=1">
<meta name="description" content="description of your site">
<meta name="author" content="author of the site">
2017-11-03 12:16:20 +08:00
<title>YApi 接口管理平台 内网部署</title>
<link rel="shortcut icon" href="./images/favicon.ico" />
2017-10-10 10:25:50 +08:00
<link rel="stylesheet" href="source/main.css" />
<link rel="stylesheet" href="styles/theme.css" />
</head>
<body>
<div class="ydoc">
<header class="ydoc-header">
<div class="ydoc-header-area">
2017-11-03 13:53:39 +08:00
<a href="./index.html" class="navbar-brand"><img src="./images/logo_header@2x.png" /> &nbsp;YApi</a>
2017-10-10 10:25:50 +08:00
<button class="ydocIcon navbar-toggle">&#xf020;</button>
<nav class="ydoc-nav">
<ul class="navbar-left">
<li class="">
2017-11-03 13:53:39 +08:00
<a href="index.html"></a>
2017-11-02 20:49:10 +08:00
</li>
<li class="">
<a href="usage.html">使用手册</a>
2017-10-10 10:25:50 +08:00
</li>
<li class="active">
<a href="devops.html">内网部署</a>
</li>
2017-10-11 16:09:25 +08:00
<li class="">
2017-11-03 11:16:39 +08:00
<a href="plugin.html">插件 Wiki</a>
2017-10-11 16:09:25 +08:00
</li>
2017-10-20 10:54:08 +08:00
<li class="">
<a href="qa.html">常见问题</a>
</li>
2017-10-10 10:25:50 +08:00
<li class="">
<a href="releases.html">版本记录</a>
</li>
<li class="">
2017-11-03 11:16:39 +08:00
<a href="http://yapi.demo.qunar.com/" target="_blank">demo 站点</a>
2017-10-10 10:25:50 +08:00
</li>
<li class="">
<a href="api.html"></a>
</li>
</ul>
</nav>
</div>
</header>
<!-- <header style="height:20px"></header> -->
<!-- Docs page layout -->
2017-11-03 11:16:39 +08:00
<div class="ydoc-banner-bg">
<div class="ydoc-banner ">
<div class="ydoc-banner-area">
<h1 >内网部署</h1>
<p class="desc ">部署 YApi 平台是非常容易的,即便您不懂 nodejs 或者 mongodb</p>
</div>
</div>
2017-10-10 10:25:50 +08:00
<div class="ydoc-container">
<div class="ydoc-container-content ">
<div class="content-left staticsidenav" role="complementary">
<nav class="docs-sidebar hidden-print hidden-xs hidden-sm">
<ul class="nav docs-sidenav">
<!-- <li > -->
<li >
<a href="#环境要求">环境要求</a>
</li>
<!-- <li > -->
<li >
<a href="#安装">安装</a>
</li>
<!-- <li > -->
<li >
2017-10-13 17:14:47 +08:00
<a href="#升级">升级</a>
2017-10-10 10:25:50 +08:00
</li>
<!-- <li > -->
<li >
2017-11-03 12:16:20 +08:00
<a href="#配置邮箱 (仅支持 SMTP)">配置邮箱 (仅支持 SMTP)</a>
2017-10-10 10:25:50 +08:00
</li>
</ul>
</nav>
</div>
<div class="content-right markdown-body use-sidebar" role="main">
2017-10-11 11:29:02 +08:00
<h1 class="subject" id="内网部署">内网部署 <a class="hashlink" href="#内网部署">#</a></h1><p>使用我们提供的 yapi-cli 工具,部署 YApi 平台是非常容易的。建议部署成 http 站点,因 chrome 浏览器安全限制,部署成 https 会导致 测试功能的文件上传功能异常。</p>
<p>如果您是将服务器代理到 nginx 服务器,请配置 nginx 支持 websocket。</p>
<pre><code>在location /添加
proxy_http_version <span class="token number">1.1</span><span class="token punctuation">;</span>
proxy_set_header Upgrade $http_upgrade<span class="token punctuation">;</span>
proxy_set_header Connection <span class="token string">"upgrade"</span><span class="token punctuation">;</span>
</code></pre><h2 class="subject" id="环境要求">环境要求 <a class="hashlink" href="#环境要求">#</a></h2><ul>
2017-10-10 10:25:50 +08:00
<li>nodejs7.6+)</li><li>mongodb2.6+</li></ul>
2017-10-16 20:33:23 +08:00
<h2 class="subject" id="安装">安装 <a class="hashlink" href="#安装">#</a></h2><p>执行 yapi server 启动可视化部署程序,输入相应的配置和点击开始部署,就能完成整个网站的部署。部署完成之后,可按照提示信息,执行 node/{网站路径/server/app.js} 启动服务器。在浏览器打开指定url, 点击登录输入您刚才设置的管理员邮箱,默认密码(ymfe.org) 登录系统(默认密码可在个人中心修改)。</p>
2017-10-10 10:25:50 +08:00
<pre><code>npm install -g yapi-cli --registry https<span class="token operator">:</span>//registry.npm.taobao.org
2017-10-16 20:33:23 +08:00
yapi server
2017-10-13 17:14:47 +08:00
</code></pre><h2 class="subject" id="升级">升级 <a class="hashlink" href="#升级">#</a></h2><p>升级项目版本是非常容易的,并且不会影响已有的项目数据,只会同步 vendors 目录下的源码文件。</p>
<pre><code>cd <span class="token punctuation">{</span>项目目录<span class="token punctuation">}</span>
2017-10-16 20:33:23 +08:00
yapi ls //查看版本号列表
yapi update //升级到最新版本
yapi update -v v1<span class="token number">.1</span>.<span class="token number">0</span> //升级到指定版本
2017-10-10 10:25:50 +08:00
</code></pre><h2 class="subject" id="配置邮箱__仅支持_SMTP_">配置邮箱 (仅支持 SMTP) <a class="hashlink" href="#配置邮箱__仅支持_SMTP_">#</a></h2><p>打开项目目录 config.json 文件,新增 mail 配置, 替换默认的邮箱配置</p>
<pre><code><span class="token punctuation">{</span>
<span class="token property">"port"</span><span class="token operator">:</span> <span class="token string">"*****"</span><span class="token punctuation">,</span>
<span class="token property">"adminAccount"</span><span class="token operator">:</span> <span class="token string">"********"</span><span class="token punctuation">,</span>
<span class="token property">"db"</span><span class="token operator">:</span> <span class="token punctuation">{</span>...<span class="token punctuation">}</span><span class="token punctuation">,</span>
<span class="token property">"mail"</span><span class="token operator">:</span> <span class="token punctuation">{</span>
<span class="token property">"enable"</span><span class="token operator">:</span> <span class="token boolean">true</span><span class="token punctuation">,</span>
<span class="token property">"host"</span><span class="token operator">:</span> <span class="token string">"smtp.163.com"</span><span class="token punctuation">,</span> //邮箱服务器
<span class="token property">"port"</span><span class="token operator">:</span> <span class="token number">465</span><span class="token punctuation">,</span> //端口
<span class="token property">"from"</span><span class="token operator">:</span> <span class="token string">"***@163.com"</span><span class="token punctuation">,</span> //发送人邮箱
<span class="token property">"auth"</span><span class="token operator">:</span> <span class="token punctuation">{</span>
<span class="token property">"user"</span><span class="token operator">:</span> <span class="token string">"***@163.com"</span><span class="token punctuation">,</span> //邮箱服务器账号
<span class="token property">"pass"</span><span class="token operator">:</span> <span class="token string">"*****"</span> //邮箱服务器密码
<span class="token punctuation">}</span>
<span class="token punctuation">}</span>
<span class="token punctuation">}</span>
</code></pre><p><br><br><br><br><br></p>
</div>
</div>
</div>
2017-11-03 11:16:39 +08:00
</div>
2017-10-10 10:25:50 +08:00
<footer class="footer">
<div class="copyright">
2017-11-03 12:16:20 +08:00
&copy; 2017 <a href="https://github.com/ymfe">YMFE</a> Team. Build by <a href="http://ued.qunar.com/ydoc/">ydoc</a>&nbsp;
2017-10-10 10:25:50 +08:00
</div>
</footer>
</div>
<div class="open-panel"></div>
<div class="mask"></div>
<script src="source/main.js"></script>
<script src="source/app.js"></script>
</body>
</html>