[{"_1":2,"_154":-5,"_155":-5},"loaderData",{"_3":4,"_13":14,"_21":22,"_133":134},"root",{"_5":-5,"_6":-7,"_7":8,"_9":-7,"_10":11,"_12":-7},"currentUser","primaryEmail","siteVerification","6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI","toast","enableDev",false,"incidentStatus","routes/_layout",{"_15":-5,"_16":17,"_18":17,"_19":11,"_20":11},"username","isAskGordonEnabled",true,"isUsingNewTemplate","showMinimalLanding","showHoneypotTrap","routes/_layout.r.$namespace.$reponame",{"_23":24,"_25":-5,"_26":11,"_27":11,"_28":29,"_30":31,"_32":-5,"_33":11,"_34":35,"_84":-5,"_85":86,"_124":-5,"_125":11,"_126":17,"_127":11,"_128":-5,"_129":11,"_130":-5,"_131":132},"canonicalUrl","https://hub.docker.com/r/edwin5588/dsc180a-docker/tags","mcpServer","canSeeDockerfile","canSeeAutobuilds","namespace","edwin5588","reponame","dsc180a-docker","cloudBuildSource","isAutobuildsAvailable","repo",{"_36":37,"_38":39,"_41":42,"_43":44,"_45":11,"_46":47,"_48":49,"_50":51,"_53":31,"_28":29,"_54":55,"_56":40,"_57":58,"_59":60,"_61":62,"_63":-5,"_64":58,"_65":66,"_67":11,"_68":29,"_69":70,"_75":11,"_76":77,"_81":29,"_82":83},"categories",[],"content_types",[40],"image","date_registered","2020-11-02T22:08:25.761235Z","description","","is_private","last_updated","2021-03-07T06:49:45.972315Z","last_modified","2024-10-16T13:48:34.145251Z","media_types",[52],"application/vnd.docker.container.image.v1+json","name","pull_count",368,"repository_type","star_count",0,"status",1,"status_description","active","source","collaborator_count","full_description","# Instructions on Building a Custom Image for DataHub/DSMLP\n\nThis guide is for advanced DSMLP users (both students and instructors) who want to add or modify applications on their working environment using a custom Docker container. \n\n## Introduction\n\nA Docker **image** is a snapshot of packaged applications, dependencies and the underlying operating system. Users can use the same Docker image anywhere on any machine running the Docker platform while having the same software functionality and behavior. **DockerHub** is a public container registry you can download (\"pull\") and upload (\"push\") Docker images. Just like GitHub hosts git repositories, DockerHub hosts and distributes Docker images. In this guide, we will design a custom Docker image by modifying a **Dockerfile**, build the image and publish it on DockerHub. \n\n## Step 0: Prerequisites\n\n- A new GitHub git repo using this as a template. Click \"Use this template\" at upper-right corner. You can also use an existing repo by adding a `Dockerfile` at the repo's root level.\n\n- A Docker Hub account. Register at . You will need this for publishing your new image and configuring automated builds.\n\n- A new public repo on DockerHub. You can name it whatever you want.\n\n## Step 1: Customize the Dockerfile\n\n- Choose the base container by uncommenting the corresponding line that set the `BASE_CONTAINER` argument\n - [An overview of standard Datahub/DSMLP containers maintained by UCSD EdTech Services](https://support.ucsd.edu/its?id=kb_article_view&sysparm_article=KB0032173&sys_kb_id=12459737dbe69810a4bc41db13961976)\n - `datascience-notebook` base image includes conda and basic python packages for data science (pandas, scipy, matplotlib) from [miniconda](https://docs.conda.io/en/latest/miniconda.html).\n - `scipy-ml` image has a wider range of packages including tensorflow, pytorch, including CUDA 10 support, generally used for GPU-accelerated workflows.\n - Note: Although `scipy-ml` has more functionality, the build process may take longer and result in a larger image.\n\n- Use `USER root` to gain root privileges for installing system packages. This line is already typed out for you.\n\n- Install system-level packages using `apt-get`\n - The example at line 19 installs a system utility called `htop`.\n\n- Install conda packages\n - Use `RUN conda install --yes ` to install all required conda packages in one go\n - (Optional) Use `RUN conda clean -tipy` to reduce image size\n - Recommended: Use conda to install least amount of packages required. Solving conda dependency graphs takes a much longer time than using pip.\n\n- Install pip packages\n - Use `pip install --no-cache-dir ` for installing pip packages\n\n- Leave the rest of the Dockerfile as is\n\n\n## Step 2: Build the Image\n\nIn this step you will build the image using the Dockerfile you created. Here you have two options: \n1. Build the image locally and push (upload) it to DockerHub. This will require you have [Docker Desktop](https://www.docker.com/products/docker-desktop) installed on your local Windows PC/Mac or [Docker Engine](https://docs.docker.com/engine/install/) for Linux. \n2. Make use of the free [automated build](https://docs.docker.com/docker-hub/builds/#configure-automated-build-settings) service and DockerHub will build and distribute the image for you. If you are feeling confident, go straight to this option, but it is quite difficult to debug and pinpoint the build issue if there is one.\n\nIt is recommended to try both routes for easier debugging and shorter turnaround time on successful builds. If you don't want to install Docker on your local machine, you can always use a $50 DigitalOcean credit from the [GitHub Student Developer Pack](https://education.github.com/pack) and launch a Docker Droplet there.\n\n### Option 1: Use Docker Desktop/Docker Engine\n- After Docker is installed, launch a terminal and navigate to the git directory containing the Dockerfile.\n- Type `docker build -t test .` and hit Enter. Docker will build the image according to the local Dockerfile. The resulting image will be labeled test. If the build fails, take note of the last command Docker ran and start debugging from there. Run the command again to rebuild after the Dockerfile is edited.\n- Once the image is successfully built, use `docker run --rm -it test /bin/bash` to enter the image in a container. Test if it has all the functionality you want. Use `exit` to exit from the container. The container will be automatically deleted.\n- (Optional if option 2 is also used) Log in to DockerHub on your local Docker instance. Retag the image by using `docker tag test /`. And push the image `docker push /`.\n- Another method for modifying the image without modifying the image is by doing changes in a lasting container from `docker run -it test /bin/bash`, use CTRL+P-Q to detach from container, find the running container in `docker ps` and `docker commit CONTAINER_ID /` followed by `docker push /`.\n\n### Option 2: Setup automated builds on DockerHub\n- Commit and push local changes to GitHub\n- Link GitHub account to DockerHub: [instructions](https://docs.docker.com/docker-hub/builds/link-source/#link-to-a-github-user-account)\n- Set up automated builds: [instructions](https://docs.docker.com/docker-hub/builds/link-source/#link-to-a-github-user-account)\n- Wait for the build to finish. It can take up to 2 hours for a complex build during business hours.\n\n## Step 3: Launch a Pod on DSMLP\n- Log in to dsmlp-login.ucsd.edu\n- RUN `launch-scipy-ml.sh -i /`\n- Wait for the node to download the image. Download time depends on the image size.\n- If it timeout/fails to launch, check `kubectl logs ` or contact ETS service desk for help.\n\n\n# Tips\n\n- If you are repeatedly using the pod or sharing the custom image among a few other people within a day, use the same node to reduce spawn time (without download). You can do this by adding a `-n ` at the end of the launch command.\n- To disable launching jupyter notebook upon entry, override the default executable by adding `CMD [\"/bin/bash\"]` as the last layer (as last line in `Dockerfile`). You can always launch the notebook again and manually port-forward on dsmlp-login. `kubectl port-forward pods/ :8888`\n\n# Resources/Further Reading\n- [Best practices for writing Dockerfiles](https://docs.docker.com/develop/develop-images/dockerfile_best-practices/)\n- [Docker Cheat Sheet (pdf)](https://www.docker.com/sites/default/files/d8/2019-09/docker-cheat-sheet.pdf)\n- [Original version of this guide](https://docs.google.com/document/d/1LPfqHvk2Itm_ckafrxRVxXQdr5BSozjsv_TURQDj9x8/edit)\n","has_starred","hub_user","immutable_tags_settings",{"_71":11,"_72":73},"enabled","rules",[74],".*","is_automated","permissions",{"_78":17,"_79":11,"_80":11},"read","write","admin","user","storage_size",4901529613,"orgData","recentTags",[87],{"_88":40,"_89":90,"_91":92,"_93":94,"_95":96,"_46":113,"_114":90,"_115":29,"_116":52,"_53":117,"_118":119,"_120":104,"_121":113,"_122":62,"_123":17},"content_type","creator",11200551,"full_size",2018888509,"id",124202002,"images",[97],{"_98":99,"_100":101,"_102":44,"_103":104,"_105":106,"_107":108,"_109":44,"_110":-5,"_111":92,"_59":62,"_112":-5},"architecture","amd64","digest","sha256:019347186e9a87f1a116f7e97855629c4da094de45d0f3e9b2dead48009674b1","features","last_pulled","2026-09-22T22:10:12.791882526Z","last_pushed","2021-03-07T06:49:46Z","os","linux","os_features","os_version","size","variant","2021-03-07T06:49:45.616553Z","last_updater","last_updater_username","media_type","latest","repository",10151573,"tag_last_pulled","tag_last_pushed","tag_status","v2","sbxKitMetadata","isPotentialSpam","isHubSbxKitsEnabled","showSbxLogoOverride","sbxTrademarkText","displaySecurityMetadata","tagAttestations","tagsHaveAttestations",[],"routes/_layout.r.$namespace.$reponame.tags",{"_34":135,"_142":143,"_131":152,"_153":11},{"_36":136,"_38":137,"_41":42,"_43":44,"_45":11,"_46":47,"_48":49,"_50":138,"_53":31,"_28":29,"_54":55,"_56":40,"_57":58,"_59":60,"_61":62,"_63":-5,"_64":58,"_65":66,"_67":11,"_68":29,"_69":139,"_75":11,"_76":141,"_81":29,"_82":83},[],[40],[52],{"_71":11,"_72":140},[74],{"_78":17,"_79":11,"_80":11},"tags",{"_144":60,"_145":-5,"_146":-5,"_147":148},"count","next","previous","results",[149],{"_88":40,"_89":90,"_91":92,"_93":94,"_95":150,"_46":113,"_114":90,"_115":29,"_116":52,"_53":117,"_118":119,"_120":104,"_121":113,"_122":62,"_123":17},[151],{"_98":99,"_100":101,"_102":44,"_103":104,"_105":106,"_107":108,"_109":44,"_110":-5,"_111":92,"_59":62,"_112":-5},[],"canDeleteTags","actionData","errors"]

edwin5588/dsc180a-docker

Tags for edwin5588/dsc180a-docker