* Add frontend for the Tensorboard Web-app This commit contains the code for the frontend of the Tensorboard web-app. It completes the GSoC 2020 project for building the standalone TWA for Kubeflow. The app is not yet fully integrated to the Kubeflow dashboard, so the README.md file contains documentation on how to build, run and use the web-app locally. Also, a Dockerfile was added in order to build a playground image of the web-app. The 'deploy' folder contains manifests that will enable the TWA to properlly run on the cluster in the future. * Update README.md |
||
|---|---|---|
| .. | ||
| backend | ||
| deploy | ||
| frontend | ||
| Dockerfile | ||
| Dockerfile.dockerignore | ||
| Makefile | ||
| README.md | ||
README.md
GSoC 2020 - Tensorboard web-app
This part of the project entails the code for the FRONTEND and BACKEND of the Tensorboard web-app. The project also entailed extending the Tensorboard controller to support RWO PVCs as log storages for Tensorboard servers. You can find the code for the Tensorboard controller here, and you can also find the corresponding documentation here.
Run Tensorboard web-app locally
Prequisites to run the BACKEND locally:
- Python 3.8
Run the BACKEND:
-
Clone the repository
-
Change directories to
components/crud-web-apps/tensorboards/backend -
Create and activate a Python virtual environment
-
Run:
make install-depsto install backend dependencies inside the virtual environment -
Run:
make run-devto run the backend locally
Prequisites to run the FRONTEND locally:
-
NodeJS 12
-
npm
-
Angular CLI 8.3.20
Run the FRONTEND:
-
Change directories to
components/crud-web-apps/common/frontend/kubeflow-common-lib -
Run:
npm run buildτο build the necessarykubeflowmodule and then change directories to the child directorydist/kubeflow -
Run:
npm link -
Change directories to
components/crud-web-apps/tensorboards/frontend -
Run:
npm installto install the dependencies needed -
Run:
npm link kubeflowto link thekubeflowmodule to the frontend -
Run:
ng serve
To use the whole app, you will also need to run the Tensorboard Controller.
- The UI of the TWA is simple and intuitive
- It follows the style of the Jupyter web-app
- You can create, delete, list Tensorboard CRs and connect to Tensorboard servers to visualize your logs
Since the TWA is not yet fully integrated with Kubeflow, in order to connect to a created Tensorboard server, you can:
- Run:
kubectl port-forward svc/istio-ingressgateway -n istio-system 8000:80 - Go to:
localhost:8000to login to Kubeflow - Change to:
localhost:8000/tensorboard/namespace/name/in order to visualize your logs, wherenameandnamespaceare the metadata of the Tensorboard CR
Build Tensorboard web-app image
Prequisites to build the image:
- Docker
Build the image:
-
Change directories to
components/crud-web-apps/tensorboards -
Run:
make image IMG=YOUR_REPO VER=YOUR_VERSION
Challenges of the project
Due to the nature of this project, which entailed the development of 3 major parts of the TWA (controller, backend and frontend), we faced a lot of difficulties during the summer. These mainly included building errors and library code malfunctions. Kimonas and Ilias, my mentors, were really helpful as the always provided feedback and made sure I was moving towards the right direction.
In addition, the covid-19 pandemic greatly affected my work schedule as my college exams were pushed forward in the summer and scheduled in July, which was a crucial month for the development of my GSoC project.
Further Improvements
I hope to be able to maintain and improve the TWA, using it where possibly throughout my further studies. Some identifiable improvements are:
- The creation of a scipt to auto build the Tensorboard web app image
- The integration of the TWA in the Kubeflow dashboard
- The development of an extensible story for deploying our stateful apps, like Jupyter and Tensorboard
Acknowledgements
First and foremost, I would like to thank my mentors Kimonas and Ilias. Both of them, despite their busy timelines were always willing to answer my (very often) questions and provide suggestions. They were always there for me, and I can't thank them enough for that. Also, Kubeflow, which introduced me to the world of open-source programming and gave me the opportunity to work on such an exiting project. Finally the Google Summer of Code program, that provided the necessary funding so I could undertake this project throughout the summer months and have a wonderful experience.



