![How to build your Docker image
● Prepare a Dockerfile (example: teapot-pharo-vnc-supervisor)
FROM mumez/pharo-vnc-supervisor
LABEL maintainer="Masashi Umezawa <ume@softumeya.com>"
ARG TEAPOT_DIR=/root/teapot
RUN setup.sh && ¥
save-pharo.sh get Teapot && ¥
cp -r /root/data ${TEAPOT_DIR}
ENV PHARO_HOME=${TEAPOT_DIR}
VOLUME [ "${TEAPOT_DIR}" ]
Define a new pharo image root
Copy the saved image to a new
root
Install libs / apps by save-pharo.sh
Set PHARO_HOME to the new root](https://image.slidesharecdn.com/5hyybqqrq2ko9dqm7a8d-signature-f48e07b4ac831a2db40ba26f10a47bfb3fb94957234cfdd81d5eaf069f1f2b3b-poli-180419134331/85/Dockerizing-pharo-9-320.jpg)
![Customizing startup scripts
● If you add xxx.st to $PHARO_HOME/config, it will be
called on Pharo startup
ADD ./config/startup.st ${PHARO_HOME}/config/
● In teapot-pharo-vnc-supervisor startup.st:
teapot := Teapot configure: {#port -> 9000}.
teapot
GET: '/cat/<a>/<b>' -> [:req | (req at: #a) , ' is ' , (req at: #b)];
start.](https://image.slidesharecdn.com/5hyybqqrq2ko9dqm7a8d-signature-f48e07b4ac831a2db40ba26f10a47bfb3fb94957234cfdd81d5eaf069f1f2b3b-poli-180419134331/85/Dockerizing-pharo-10-320.jpg)
Dockerizing pharo
- 1. Dockerizing Pharo Develop & Deploy Pharo with Docker 111th #st_study @ Tokyo 2018 Masashi Umezawa SoftUmeYa, LLC
- 2. Docker? ● Container-based virtualization platform ○ Lightweight ○ Programmable ○ Sharable ■ https://hub.docker.com/ ● Docker container is like Smalltalk image ○ Universal ○ Self-contained ● With Docker, you can develop/deploy Pharo applications more easily
- 4. pharo-vnc-supervisor ● pharo-vnc-supervisor ○ Supports Pharo 5, 6 & 7 ○ Debuggable via VNC and Web Browser ○ Daemonized with supervisord ○ Web browser installed (Chromium, Firefox) ○ Inspired by SORABITO in-house Pharo docker image ○ Easily customizable ● teapot-pharo-vnc-supervisor ○ Example of pharo-vnc-supervisor customization ○ Runs Teapot on startup
- 5. Run a container ● Run Pharo with VNC ports opened docker run --name my_pharo -d -p 5901:5901 -p 6901:6901 mumez/pharo-vnc-supervisor ● VNC Client ○ yourhost:5901 ● Web Browser ○ http://yourhost:6901/?password=vncpassword ○ For Pharo 7, specify pharo70 tag mumez/pharo-vnc- supervisor:pharo70
- 6. Build a customized Pharo image ● Use save-pharo <command> <args> docker run --rm -p 5901:5901 -p 6901:6901 ¥ -v=$HOME/teapot:/root/data ¥ mumez/pharo-vnc-supervisor ¥ save-pharo get Teapot ○ You can save Pharo image on a mounted volume ○ Pharo image will be built by a temporary container ○ Teapot installed image will be saved in $HOME/teapot and can be used later
- 7. save-pharo options ● get <Project name> ○ Install a project on Catalog Browser ● config <URL> <Configuration name> -- install=<version> ○ Install via ConfigurationOfXXX ● metacello <metacello arguments> ○ Install via BaseLineOfXXX ○ Only available on Pharo 7 based container
- 8. Run with a customized Pharo image ● Just mount an exsiting volume with -v option docker run -p 5901:5901 -p 6901:6901 ¥ -v=$HOME/teapot:/root/data ¥ mumez/pharo-vnc-supervisor ○ Pharo image can be persisted as usual ○ Use -e PHARO_IMAGE=<image_file_name> to specify Pharo image name
- 9. How to build your Docker image ● Prepare a Dockerfile (example: teapot-pharo-vnc-supervisor) FROM mumez/pharo-vnc-supervisor LABEL maintainer="Masashi Umezawa <ume@softumeya.com>" ARG TEAPOT_DIR=/root/teapot RUN setup.sh && ¥ save-pharo.sh get Teapot && ¥ cp -r /root/data ${TEAPOT_DIR} ENV PHARO_HOME=${TEAPOT_DIR} VOLUME [ "${TEAPOT_DIR}" ] Define a new pharo image root Copy the saved image to a new root Install libs / apps by save-pharo.sh Set PHARO_HOME to the new root
- 10. Customizing startup scripts ● If you add xxx.st to $PHARO_HOME/config, it will be called on Pharo startup ADD ./config/startup.st ${PHARO_HOME}/config/ ● In teapot-pharo-vnc-supervisor startup.st: teapot := Teapot configure: {#port -> 9000}. teapot GET: '/cat/<a>/<b>' -> [:req | (req at: #a) , ' is ' , (req at: #b)]; start.
- 11. Auto-build your Docker image ● Publish your Dockerfile (and st sources) to GitHub ● Register the repository as a “automated build” in DockerHub ● If you commit something, a new image will be built
- 12. Summing up ● “pharo-vnc-supervisor” provides a handy environment for web application development with Pharo ● By “save-pharo” command, you can build a new Pharo image by command line ● A new Docker image having a customized Pharo image can be easily created with a simple Dockerfile ● Enjoy Dockernzing Pharo!