doc: add pm2 faq #370

shaoshuai0102 · 2017-02-13T11:09:33Z

Checklist

npm test passes
tests and/or benchmarks are included
documentation is changed or added
commit message follows commit guidelines

Affected core subsystem(s)

Description of change

mention-bot · 2017-02-13T11:09:33Z

@shaoshuai0102, thanks for your PR! By analyzing the history of the files in this pull request, we identified @gxcsoccer, @popomore and @atian25 to be potential reviewers.

fengmk2 · 2017-02-13T11:12:25Z

docs/source/zh-cn/advanced/cluster.md

@@ -715,3 +715,5 @@ exports.apiClient = {
 - APIClient - 内部调用 ClusterClient 做数据同步，无需关心多进程模型，用户最终使用的模块。API 都通过此处暴露，支持同步和异步。

 有兴趣的同学可以看一下 [增强多进程研发模式](https://github.com/eggjs/egg/issues/322) 讨论过程。
+
+[为什么我们没有选择 PM2?](http://localhost:4000/zh-cn/faq.html#进程管理为什么没有选型-pm2)


url 改一下

codecov · 2017-02-13T11:15:38Z

Codecov Report

Merging #370 into master will not change coverage.
The diff coverage is n/a.

@@          Coverage Diff          @@
##           master   #370   +/-   ##
=====================================
  Coverage     100%   100%           
=====================================
  Files          28     28           
  Lines         637    637           
=====================================
  Hits          637    637

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 1d93002...cbaa597. Read the comment docs.

fengmk2 · 2017-02-13T11:17:59Z

docs/source/zh-cn/faq.md

+
+1. PM2 模块本身复杂度很高，出了问题很难排查。我们认为框架使用的工具复杂度不应该过高，而 PM2 自身的复杂度超越了大部分应用本身。
+2. 没法做非常深的优化。
+3. 切实的需求问题，一个进程里跑 leader，其他进程代理到 leader 这种模式，在企业级开发中对于减少远端连接，降低数据通信压力等都是切实的需求。特别当应用规模大到一定程度，这就会是刚需。egg 本身起源于蚂蚁金服和阿里，我们对标的起点就是大规模企业应用的构建，所以不能做 toy，要非常全面。通过 PM2 无法做到。


写得好像 pm2 是玩具那样。。。好像不是这种感觉，不应该让 pm2 的使用者感觉我们在攻击他们。。

我去掉关键词 -_-! 不是本意哈哈

atian25 · 2017-02-13T11:31:55Z

docs/source/zh-cn/faq.md

+
+1. PM2 模块本身复杂度很高，出了问题很难排查。我们认为框架使用的工具复杂度不应该过高，而 PM2 自身的复杂度超越了大部分应用本身。
+2. 没法做非常深的优化。
+3. 切实的需求问题，一个进程里跑 leader，其他进程代理到 leader 这种模式，在企业级开发中对于减少远端连接，降低数据通信压力等都是切实的需求。特别当应用规模大到一定程度，这就会是刚需。egg 本身起源于蚂蚁金服和阿里，我们对标的起点就是大规模企业应用的构建，所以要非常全面。这些特性通过 PM2 很难做到。


这个地方是指 cluster-client？ link 过去？

dead-horse · 2017-02-13T11:34:02Z

增加一个如果想用 pm2 启动如何实现？这个应该也是很多人的选择。

shaoshuai0102 · 2017-02-13T11:47:12Z

加好了 @dead-horse

atian25 · 2017-02-13T11:47:21Z

嗯，有没有必要用 pm2 启动 egg，如果想，该如何配置。

atian25 · 2017-02-13T11:49:12Z

docs/source/faq.md

+// server.js
+const egg = require('egg');
+
+const workers = Number(process.argv[2] || require('os').cpus().length);


worker 没必要传吧

atian25 · 2017-02-13T11:50:19Z

docs/source/zh-cn/advanced/cluster.md

@@ -715,3 +715,5 @@ exports.apiClient = {
 - APIClient - 内部调用 ClusterClient 做数据同步，无需关心多进程模型，用户最终使用的模块。API 都通过此处暴露，支持同步和异步。

 有兴趣的同学可以看一下 [增强多进程研发模式](https://github.com/eggjs/egg/issues/322) 讨论过程。
+
+[为什么我们没有选择 PM2?](/zh-cn/faq.html#进程管理为什么没有选型-pm2)


链接还是有问题吧，直接链接到 md？

popomore · 2017-02-13T12:03:38Z

docs/source/_data/guide_toc.yml

@@ -38,4 +38,4 @@ Community:
  Contributing: /contributing.html
  Resource: /resource.html
  # Member Guide: /member_guide.html
-  # FAQ: /faq.html
+  FAQ: /faq.html


看看这个中文有翻译吗？

啥意思

btw 说好的说英语呢

See the yml config about language, we should translate it in Chinese

already existed

popomore · 2017-02-13T12:04:05Z

docs/source/faq.md

 If you have questions that is not contained below, please check [egg issues](https://github.com/eggjs/egg/issues).
+
+## Why not choose PM2 as process management tool?


放到 en 下

popomore · 2017-02-13T12:06:50Z

docs/source/zh-cn/faq.md

+
+1. PM2 模块本身复杂度很高，出了问题很难排查。我们认为框架使用的工具复杂度不应该过高，而 PM2 自身的复杂度超越了大部分应用本身。
+2. 没法做非常深的优化。
+3. 切实的需求问题，一个进程里跑 leader，其他进程代理到 leader 这种模式（[多进程模型](/zh-cn/advanced/cluster.html)），在企业级开发中对于减少远端连接，降低数据通信压力等都是切实的需求。特别当应用规模大到一定程度，这就会是刚需。egg 本身起源于蚂蚁金服和阿里，我们对标的起点就是大规模企业应用的构建，所以要非常全面。这些特性通过 PM2 很难做到。


一个进程里跑 leader，其他进程代理到 leader 这种模式

就说 egg 自带多进程模型，不用说的这么具体吧

链接也改下

这里连接有什么问题

Use .md extension

popomore · 2017-02-13T12:07:34Z

docs/source/zh-cn/faq.md

+
+进程模型非常重要，会影响到开发模式，运行期间的深度优化等，我们认为可能由框架来控制比较合适。
+
+## 如何使用 PM2 启动应用？


这个还是接着上面的问题吧

atian25 · 2017-02-13T12:15:58Z

用 md 的链接，不要用发布后的发自我的 iPhone

…

在 2017年2月13日，20:14，Shawn ***@***.***> 写道： @shaoshuai0102 commented on this pull request. In docs/source/zh-cn/faq.md: > @@ -0,0 +1,35 @@ +title: 常见问题 +--- + +如果下面的内容无法解决你的问题，请查看 [egg issues](https://github.com/eggjs/egg/issues)。 + +## 进程管理为什么没有选型 PM2 ？ + +1. PM2 模块本身复杂度很高，出了问题很难排查。我们认为框架使用的工具复杂度不应该过高，而 PM2 自身的复杂度超越了大部分应用本身。 +2. 没法做非常深的优化。 +3. 切实的需求问题，一个进程里跑 leader，其他进程代理到 leader 这种模式（[多进程模型](/zh-cn/advanced/cluster.html)），在企业级开发中对于减少远端连接，降低数据通信压力等都是切实的需求。特别当应用规模大到一定程度，这就会是刚需。egg 本身起源于蚂蚁金服和阿里，我们对标的起点就是大规模企业应用的构建，所以要非常全面。这些特性通过 PM2 很难做到。这里连接有什么问题 — You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub, or mute the thread.

shaoshuai0102 · 2017-02-13T12:23:54Z

go on reviewing @popmore

popomore · 2017-02-13T12:27:28Z

docs/source/en/faq.md

+2. Deep optimization could be difficlut to achieve if choosing PM2.
+3. Pattern like one leader process communicating with remote services, along with serveral follower processes delegating request to it (（[Cluster](./advanced/cluster.md)), is a rigid demand for reducing connections and data exchange load, espeically when facing applications in very large scale. egg originates from Ant Financial Group and Alibaba Group, we start with applications in that scale at first, so we take these goals into consideration. All of these goals above could be hard to achieve with PM2.
+
+Process management is very important. It defines the way we write code, meanwhile relates to deep runtime optimization. So we think it's better defined by framework itself.


It's better included?

define is a bit better

You don't define the process management

popomore · 2017-02-13T12:30:05Z

Commit message should start with docs

Closes #345

atian25 · 2017-02-13T12:30:28Z

docs/source/en/faq.md

+
+Process management is very important. It defines the way we write code, meanwhile relates to deep runtime optimization. So we think it's better defined by framework itself.
+
+__How to start application with PM2?__


** and __ have a same meaning

yes, but just use one style

shaoshuai0102 requested review from fengmk2, atian25 and popomore February 13, 2017 11:09

shaoshuai0102 mentioned this pull request Feb 13, 2017

documents optimization #354

Closed

7 tasks

fengmk2 reviewed Feb 13, 2017

View reviewed changes

shaoshuai0102 force-pushed the doc-faq-pm2 branch 2 times, most recently from c46a587 to d28a075 Compare February 13, 2017 11:15

fengmk2 reviewed Feb 13, 2017

View reviewed changes

shaoshuai0102 force-pushed the doc-faq-pm2 branch from d28a075 to e1a8fd7 Compare February 13, 2017 11:27

atian25 approved these changes Feb 13, 2017

View reviewed changes

shaoshuai0102 force-pushed the doc-faq-pm2 branch 2 times, most recently from 2b401ef to 68afc49 Compare February 13, 2017 11:46

dead-horse approved these changes Feb 13, 2017

View reviewed changes

atian25 approved these changes Feb 13, 2017

View reviewed changes

popomore reviewed Feb 13, 2017

View reviewed changes

popomore approved these changes Feb 13, 2017

View reviewed changes

docs: add pm2 faq

01dc2db

Closes #345

shaoshuai0102 force-pushed the doc-faq-pm2 branch from b56f05b to 01dc2db Compare February 13, 2017 12:31

atian25 reviewed Feb 13, 2017

View reviewed changes

f

cbaa597

atian25 approved these changes Feb 13, 2017

View reviewed changes

popomore merged commit ead4cec into master Feb 13, 2017

popomore deleted the doc-faq-pm2 branch February 13, 2017 15:27

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

doc: add pm2 faq #370

doc: add pm2 faq #370

shaoshuai0102 commented Feb 13, 2017 •

edited

Loading

mention-bot commented Feb 13, 2017

fengmk2 Feb 13, 2017

shaoshuai0102 Feb 13, 2017

codecov bot commented Feb 13, 2017 •

edited

Loading

fengmk2 Feb 13, 2017

shaoshuai0102 Feb 13, 2017

shaoshuai0102 Feb 13, 2017

atian25 Feb 13, 2017

shaoshuai0102 Feb 13, 2017

dead-horse commented Feb 13, 2017

shaoshuai0102 commented Feb 13, 2017

atian25 commented Feb 13, 2017

atian25 Feb 13, 2017

atian25 Feb 13, 2017

popomore Feb 13, 2017

shaoshuai0102 Feb 13, 2017

popomore Feb 13, 2017

shaoshuai0102 Feb 13, 2017

popomore Feb 13, 2017

popomore Feb 13, 2017

popomore Feb 13, 2017

shaoshuai0102 Feb 13, 2017

popomore Feb 13, 2017

popomore Feb 13, 2017

shaoshuai0102 Feb 13, 2017

atian25 commented Feb 13, 2017 via email

shaoshuai0102 commented Feb 13, 2017 •

edited

Loading

popomore Feb 13, 2017

shaoshuai0102 Feb 13, 2017

popomore Feb 13, 2017

popomore commented Feb 13, 2017

atian25 Feb 13, 2017

shaoshuai0102 Feb 13, 2017 •

edited

Loading

atian25 Feb 13, 2017

		If you have questions that is not contained below, please check [egg issues](https://github.com/eggjs/egg/issues).

		## Why not choose PM2 as process management tool?


		进程模型非常重要，会影响到开发模式，运行期间的深度优化等，我们认为可能由框架来控制比较合适。

		## 如何使用 PM2 启动应用？


		Process management is very important. It defines the way we write code, meanwhile relates to deep runtime optimization. So we think it's better defined by framework itself.

		__How to start application with PM2?__

doc: add pm2 faq #370

doc: add pm2 faq #370

Conversation

shaoshuai0102 commented Feb 13, 2017 • edited Loading

Checklist

Affected core subsystem(s)

Description of change

mention-bot commented Feb 13, 2017

Choose a reason for hiding this comment

Choose a reason for hiding this comment

codecov bot commented Feb 13, 2017 • edited Loading

Codecov Report

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

dead-horse commented Feb 13, 2017

shaoshuai0102 commented Feb 13, 2017

atian25 commented Feb 13, 2017

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

atian25 commented Feb 13, 2017 via email

shaoshuai0102 commented Feb 13, 2017 • edited Loading

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

popomore commented Feb 13, 2017

Choose a reason for hiding this comment

shaoshuai0102 Feb 13, 2017 • edited Loading

Choose a reason for hiding this comment

Choose a reason for hiding this comment

shaoshuai0102 commented Feb 13, 2017 •

edited

Loading

codecov bot commented Feb 13, 2017 •

edited

Loading

shaoshuai0102 commented Feb 13, 2017 •

edited

Loading

shaoshuai0102 Feb 13, 2017 •

edited

Loading