[POC] Run arbitrary bash commands in doc as test

[MortalHappiness]

This is a POC to automate the docs that requires manual testing by running arbitrary bash commands in doc as test using Jupyter notebooks.

This PR tries to convert KubeRay MobileNet example to automated test.

Note: It seems that currently the readthedoc CI build fails for all PRs. So there is no link for doc yet.

Run this PR

Prerequisites

• kind, helm, kubectl, python
• cd doc/source/cluster/kubernetes/
• pip install pytest nbval bash_kernel jupyterlab requests
• python -m bash_kernel.install
• wget https://raw.githubusercontent.com/ray-project/serve_config_examples/607d1264c2c998e4a85eaf5403efcd3bc9ed3039/mobilenet/mobilenet_req.py
• Prepare an image. And edit line 4 of the downloaded mobilenet_req.py to the path of your image.

Run test

py.test --nbval notebook.ipynb --nbval-kernel-name bash --sanitize-with doc_sanitize.cfg

Limitations

• We cannot use tab-set in Jupyter notebooks.

References

• https://nbval.readthedocs.io/en/latest/