feat(v2): add support for serve command

[anshulrgoyal]

Motivation

The easy serving of build directory. Fix #3062

Have you read the Contributing Guidelines on pull requests?

Yes

Test Plan

Simple Serve

Combining Build

[docusaurus-bot]

Deploy preview for docusaurus-2 ready!

Built with commit 7d051d4

https://deploy-preview-3080--docusaurus-2.netlify.app

[slorber]

That looks nice thanks.
I'd rather use the existing choosePort fn

Also need to add some doc :)

[slorber]

Thanks, that looks great to merge.

I think we should add more documentation for this.

For example:
https://v2.docusaurus.io/docs/deployment/
We should mention that docusaurus serve can be used to test your local build deployment, or can also be used as a self-hosting solution.

https://v2.docusaurus.io/docs/cli/#docusaurus-build
I'd like to mention on the docusaurus build command that it's possible to test the production build using docusaurus serve :)

I think it would be nice for discoverability to enhance this message with something like "hey, use docusaurus serve command to test your production site"

[anshulrgoyal]

@slorber I don't think we shouldn't add it as a self-hosting solution. It is always ideal to use a load balancer or some production-ready software to serve these resources.

[slorber]

@slorber I don't think we shouldn't add it as a self-hosting solution. It is always ideal to use a load balancer or some production-ready software to serve these resources.

I think we should add it, and add a caution admonition to tell the user that it may not be the most performant option. Some users simply know what they are doing, and would be happy to know it's possible to self host the thing. I'm pretty sure someone at some point will run docusaurus on a raspberry pi :p

[anshulrgoyal]

@slorber I don't think we shouldn't add it as a self-hosting solution. It is always ideal to use a load balancer or some production-ready software to serve these resources.

I think we should add it, and add a caution admonition to tell the user that it may not be the most performant option. Some users simply know what they are doing, and would be happy to know it's possible to self host the thing. I'm pretty sure someone at some point will run docusaurus on a raspberry pi :p

done

[slorber]

thanks :)