From f34883333b0d2c9a53c512d4d0b99eb5b563c6cd Mon Sep 17 00:00:00 2001 From: "Gregory M. Kapfhammer" Date: Fri, 30 Aug 2019 06:18:23 -0400 Subject: [PATCH] Update introduction on the installation of docker in cs101F2019_practical01. --- practical01/cs101F2019_practical01.tex | 60 +++++++++++++++++++++++--- 1 file changed, 54 insertions(+), 6 deletions(-) diff --git a/practical01/cs101F2019_practical01.tex b/practical01/cs101F2019_practical01.tex index 7e04134..9c0e4ce 100644 --- a/practical01/cs101F2019_practical01.tex +++ b/practical01/cs101F2019_practical01.tex @@ -144,11 +144,14 @@ \section*{Suggestions for Success} you can post it to the designated channel. Or, you can ask a student sitting next to you or talk with a teaching assistant or the course instructor. -% \item {\bf Store your files in GitHub}. Starting with this practical assignment, you will be responsible for storing -% all of your files (e.g., Java source code and Markdown-based writing) in a Git repository using GitHub Classroom. -% Please verify that you have saved your source code in your Git repository by using \command{git status} to ensure that -% everything is updated. You can see if your assignment submission meets the established correctness requirements by -% using the provided checking tools on your local computer and in checking the commits in GitHub. +% \item {\bf Store your files in GitHub}. Starting with this practical assignment, +% you will be responsible for storing all of your files (e.g., Java source code +% and Markdown-based writing) in a Git repository using GitHub Classroom. Please +% verify that you have saved your source code in your Git repository by using +% \command{git status} to ensure that everything is updated. You can see if your +% assignment submission meets the established correctness requirements by using +% the provided checking tools on your local computer and in checking the commits +% in GitHub. % \item {\bf Keep all of your files}. Don't delete your programs, output files, % and written reports after you submit them through GitHub; you will need them @@ -199,11 +202,56 @@ \section*{Reading Assignment} complete this part of the reading assignment, please visit the web site of each tool. +Once you have bookmarked references for each of the aforementioned web sites and +reviewed some of the printed guides, please access the Slack workspace that we +will use in this course, available for signup at +\url{https://join.slack.com/t/cmpsc101fall2019/signup}. Once you have access to +the Slack workspace, please join the \url{#practicals} channel and post one +thing that you have learned about Docker, your chosen text editor, and your +package manager. In addition to posting what you learned, please review the +comments from other students, always attempting to post something that is not +already in the channel. Please make sure that you keep Slack open throughout +your completion of this practical assignment as we will continue to use it for +you to communicate with each other, the technical leaders, and the course +instructor, who will read and assess your insights. + +\section*{Installing and Using Docker} + +Docker is a platform for software engineers and system administrators to +develop, deploy, and run software applications with containers that house +full-fledged executable programs. When software engineers use Docker, they no +longer have to focus on installing the programs that come inside of the Docker +container. Instead, they can use a program in a Docker container as if it was +installed on their development workstation, regardless of whether they are using +Windows, Linux, or MacOS. A wide variety of companies, such as Visa and PayPal, +use Docker. Throughout this semester, you will receive Docker containers that +house programs like Java, Gradle, and GatorGrader. These containers will also +hold the supporting libraries and packages needed to run the aforementioned +programs. With that said, please note that you should not store source code or +technical writing inside of a Docker container because it is a ``transient'' +software application that does not store its state upon shut-down. Finally, the +provided Docker container will not include programs like Git or your text editor +as the instructor expects that each student will install these programs +separately. + +The Department of Computer Science has adopted Docker for all computer science +courses. The course instructor, student technical leaders, and the departmental +systems administrator will support the use of Docker on laptops running Windows, +Linux, and MacOS. The instructor in this course will provide Docker containers +with all the necessary software to run all class exercises, laboratory and +practical assignments. Students will then be able to develop and run Java +program on their own laptops, using instructor-provided Docker container. Before +being able to use Docker, students must first complete the installation of +Docker, following steps that are specific to the operating system on your +laptop. Bearing in mind that you must follow steps customized to your laptop, +please talk to the instructor or a technical leader if you get stuck on these +steps. + \section*{Summary of the Required Deliverables} \noindent Students do not need to submit printed source code or technical writing for any assignment in this course. Instead, this assignment invites you -to submit, using GitHub, the following deliverables. +to submit, using Slack the following deliverables. \vspace*{-.025in}