오픈소스SW입문 기말 최종 과제 보고서 및 코드

.gitignore

+HELP.md
+.gradle
+build/
+!gradle/wrapper/gradle-wrapper.jar
+!**/src/main/**/build/
+!**/src/test/**/build/
+
+### STS ###
+.apt_generated
+.classpath
+.factorypath
+.project
+.settings
+.springBeans
+.sts4-cache
+bin/
+!**/src/main/**/bin/
+!**/src/test/**/bin/
+
+### IntelliJ IDEA ###
+.idea
+*.iws
+*.iml
+*.ipr
+out/
+!**/src/main/**/out/
+!**/src/test/**/out/
+
+### NetBeans ###
+/nbproject/private/
+/nbbuild/
+/dist/
+/nbdist/
+/.nb-gradle/
+
+### VS Code ###
+.vscode/

Dockerfile

+FROM openjdk:11.0.9.1-jre
+COPY build/libs/dockertest-0.0.1-SNAPSHOT.jar application.jar
+ENTRYPOINT ["java", "-jar", "application.jar"]
\ No newline at end of file

README.md

+# 2020-2 오픈소스SW입문 기말 최종 과제 보고서
+
+과제: **도커(Docker)의 기본 개념 및 사용법**을 동영상으로 제작
+
+이름: 황재완
+
+학과: 소프트웨어학과
+
+학번: 201420993
+
+---
+
+### 주제 선정 이유
+
+SW캡스톤디자인을 수강하면서 프로젝트를 수행할 때 도커를 이용하여 많은 개발 능률이 향상되었고 DevOps를 경험할 수 있었다. 또한 교수님께서도 도커와 쿠버네티스를 설명하시면서 이에 대한 중요함을 많이 강조하셨다. 아직까지는 프로젝트 개발과 운영에서 선택사항이지만 마이크로 아키텍처와 클라우드 서비스를 통한 서비스 배포 패러다임이 주류를 이루고 발전해가면서 도커라는 오픈소스 리눅스 컨테이너 플랫폼이 DevOps에서 절대로 빠지지 않는 존재가 될 것이라고 생각한다. 하지만 도커에 대한 우리나라말로된 동영상 강의가 별로 존재하지 않아 오픈소스 소프트웨어 커뮤니티에 기여하기 위해 도커에 대한 기본 개념 및 실습을 동영상으로 제작하게 되었다.
+
+### 도커
+
+Docker는 개발자나 시스템 관리자가 애플리케이션 개발 배포 실행을 컨테이너를 통해 할 수 있도록 하는 오픈 플랫폼입니다. 위키피디아를 인용하자면 다음과 같습니다.
+
+> 도커 컨테이너는 일종의 소프트웨어를 소프트웨어의 실행에 필요한 모든 것을 포함하는 완전한 파일 시스템 안에 감싼다. 여기에는 코드, 런타임, 시스템 도구, 시스템 라이브러리 등 서버에 설치되는 무엇이든 아우른다. 이는 실행 중인 환경에 관계 없이 언제나 동일하게 실행될 것을 보증한다.
+
+즉 격리된 공간에서 프로세스가 동작하는 기술입니다. 또한 시스템 인프라에 상관없이 애플리케이션을 격리된 공간에서 빠르게 실행합니다.  Nginx나 아파치 웹서버를 우분투에서 실행하려 할땐 보통은 우분투 운영체제가 설치된 하드웨어나 가상머신이 필요합니다. 하지만 도커를 통해 우분투부터 아파치웹서버 그리고 실행할 모든 라이브러리와 애플리케이션 등을 하나의 컨테이너 안에서 모두 실행합니다. 따라서 호스트에 종속적이지 않습니다. 또한 개발과 실제 운영까지의 시간을 획기적으로 단축할 수 있습니다. 따라서 이 모든 것을 종합하면 도커란 곧 **컨테이너 기반의 오픈소스 가상화 플랫폼**이라 할 수 있습니다.
+
+### 도커의 장점
+
+도커의 장점은 정말 여러가지가 있습니다. 그 중 대표적으로 하나의 호스트에서 여러 컨테이너를 실행가능하다는 것입니다. 하나의 호스트는 도커 엔진을 통해 여러 컨테이너들을 동시에 실행할 수 있습니다. 각각의 컨테이너들을 프로세스로 격리되어 서로에 대해 영향을 미치지 않고 기존의 가상머신을 여러대 활용하는 것보다 획기적으로 성능이 좋습니다. 즉, Hypervisor와 같은  vmware나 virtualbox 등의 가상머신 소프트웨어에서 필요한 가상 머신 매니저를 필요로하지 않습니다. 따라서 이로인한 운영체제와 관련된 오버헤드가 없습니다. 또한 컨테이너가 호스트의 커널을 공유하여 컨테이너가 경량화 될 수 있습니다. 따라서 컨테이너의 빌드와 실행이 정말 빠릅니다
+
+### 도커 엔진
+
+도커의 엔진은 도커 이미지를 생성하거나 컨테이너를 실행하는 데 필요한 핵심 기능을 제공합니다. 또한 Client-Server구조로 3가지의 컴포넌트로 구성됩니다. 도커 서버의 도커 데몬 프로세스는  컨테이너의 빌드, 실행 배포 등 도커의 핵심 기능들을 담당합니다. 도커 REST API는 CLI나 다른 애플리케이션 프로그램들이 도커 데몬에게 명령을 수행하도록 지시할 때 사용하는 인터페이스 입니다. 커맨드를 사용하면 클라이언트는 도커 데몬에 도커 REST API를 통해 받은 커맨드를 보내고 도커 데몬은 이를 수행합니다.
+
+### 도커 이미지
+
+도커의 이미지는 애플리케이션을 실행하는데 필요한 코드, 런타임, 라이브러리 등 필요한 모든 것을 포함한 실행가능한 패키지 입니다. 도커의 이미지는 상태를 가지지 않고 변하지도 않습니다. 또한 이미지는 다른 이미지를 기반으로 만들어질 수 있습니다. 아래와 같이 애플리케이션을 실행하는 데 필요한 우분투 리눅스 이미지와 우분투에서 돌아갈 아파치웹서버 이미지 그리고 개발한 애플리케이션 까지 종합적으로해서 이미지의 레이어를 쌓아 하나의 이미지로 만듭니다.
+
+### 도커 컨테이너
+
+도커 컨테이너는 앞에서 설명한 도커 이미지의 런타임 인스턴스 입니다. 실행 시 메모리에서 상태가 있는 이미지, 즉 런타임 인스턴스가 됩니다. 따라서 도커 임지와 컨테이너의 관계를 더 쉽게 이해하기 위해서는 운영체제에서 배웠던 프로그램과 프로세스의 차이로 이해하시면 됩니다. 도커 컨테이너의 다음과 같은 특징이 있습니다. 먼저 **Flexible**합니다. 아무리 복잡한 애플리케이션, 예를 들어 아주 복잡한 의존성과 라이브러리, 플러그인들을 포함하여 컨테이너화(containerization) 시킬 수 있습니다. 또한 **Lightwieght**합니다. 즉 컨테이너는 호스트의 커널을 공유, 활용하기 때문에 별도의 가상머신을 사용하는 것보다 경량화 됩니다. **Interchangeable**함으로 컨테이너의 업데이트나 업그레이드를 배포하는 것이 용이합니다. **Portable**하므로 로컬에서 빌드하여 클라우드에 배포할 수 있고 로컬이든 클라우드든 어디든지 실행할 수 있습니다. **Scalable**해서 컨테이너 복제판을 여러군데에서 늘리거나 줄이면서 자동으로 배포할 수 있습니다. 마지막으로 **Stackable**하므로 서비스들을 수직으로 쌓아 올릴 수 있습니다.
+
+### 도커 아키텍처
+
+도커 아키텍처는 그림과 같이 클라이언트, 도커 호스트 그리고 레지스트리로 구성됩니다. 클라이언트에선 사용자나 애플리케이션으로 부터 명령어를 받고 도커 호스트에 보냅니다. 이를 처리한 결과를 클라이언트에서 다시 보여줄 수 있습니다. 도커 호스트는 도커 서버로서 필요한 이미지를 빌드, 다운로드하고 이들 이미지로 컨테이너를 실행하고 관리합니다. 이때  도커 호스트에 저장된 이미지가 없다면 도커 레지스트리 라는 곳에서 빌드된 이미지를 `pull`합니다. 이때 레지스트리는 **Docker Hub**와 같은 도커에서 공식적으로 관리하는 이미지 저장소가 될 수 있고, private한 레지스트리를 만들 수 도 있습니다.
+
+### Docker CLI Command
+
+- `docker version`은 도커 클라이언트와 도커 서버의 대략적인 정보를 알려줍니다.
+
+  <img src="./images/dockerversion.png" width="50%" height="50%"/>
+
+- `docker images`는 도커 서버에 저장된 이미지 목록을 볼 수 있습니다. `docker image ls`도 같은 기능을 수행합니다.
+
+  <img src="./images/dockerimages.png" width="50%" height="50%"/>
+
+- `docker ps`는 실행중인 컨테이너의 목록들을 볼 수 있고 `docker ps -a`은 실행또는 중지된 모든 컨테이너를 확인할 수 있습니다.
+
+  ![](./images/dockerps.png)
+
+- `docker contain ls`는 `docker ps`와 같은 기능이고 `docker container ls -a`는 `docker ps -a`와 같은 기능을 수행합니다.
+
+- `docker stop`은 현재 실행중인 컨테이너를 중지합니다.
+
+  <img src="./images/dockerstop.png" width="70%" height="70%"/>
+
+- `docker pull`은 이미지를 private registry나 Docker Hub에서 다운로드합니다. 이때 이미지 이름을 찾을때는 `docker search`를 통해 검색하거나 Docker Hub Web에서 검색할 수 있습니다.
+
+  <img src="./images/dockerpull.png" width="50%" height="50%"/>
+
+- `docker start`는 중지된 컨테이너를 다시 실행할 수 있습니다.
+
+  ![](./images/dockerstart.png)
+
+- `docker run`은 새로운 컨테이너를 실행하며 이때 이미지가 로컬에 없다면 `pull` 받아와 사용합니다. 이때
+  `-d` 옵션을 사용하면 detached mode로서 background로 실행되며 `-p`는 로컬호스트와 도커서버의 포트매핑옵션입니다. `-i`와 `-t` 옵션을 주고 `/bin/bash`를 명령어로 사용하면 아래와 같이 우분투 컨테이너 내부의 bash shell을 사용할 수 있습니다.
+
+  <img src="./images/dockerrun.png" width="50%" height="50%"/>
+
+- `docker rm`은 생성된 컨테이너를 삭제합니다.
+
+  ![](./images/dockerrm.png)
+
+- `docker rmi`는 이미지를 삭제합니다. (이때 삭제하려는 이미지를 사용하는 컨테이너가 있다면 그 컨테이너부터 삭제해야 이미지가 삭제됩니다.)
+
+  ![](./images/dockerrmi.png)
+
+### Reference
+
+  - 블로그 - https://darksoulstory.tistory.com/448
+  - 블로그 - https://subicura.com/2017/01/19/docker-guide-for-beginners-1.html
+  - 유튜브 영상 - https://www.youtube.com/watch?v=9tW0QSsrhwc
+  - 유튜브 영상 - https://www.youtube.com/watch?v=agbpWm2Ho_I
+  - Docker 공식 사이트 - https://docs.docker.com/get-started/

build.gradle

+plugins {
+    id 'org.springframework.boot' version '2.4.1'
+    id 'io.spring.dependency-management' version '1.0.10.RELEASE'
+    id 'java'
+}
+
+group = 'com.jaewan'
+version = '0.0.1-SNAPSHOT'
+sourceCompatibility = '11'
+
+repositories {
+    mavenCentral()
+}
+
+dependencies {
+    implementation 'org.springframework.boot:spring-boot-starter-web'
+    testImplementation 'org.springframework.boot:spring-boot-starter-test'
+}
+
+test {
+    useJUnitPlatform()
+}

gradle/wrapper/gradle-wrapper.properties

+distributionBase=GRADLE_USER_HOME
+distributionPath=wrapper/dists
+distributionUrl=https\://services.gradle.org/distributions/gradle-6.7.1-bin.zip
+zipStoreBase=GRADLE_USER_HOME
+zipStorePath=wrapper/dists

gradlew

+#!/usr/bin/env sh
+
+#
+# Copyright 2015 the original author or authors.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+
+##############################################################################
+##
+##  Gradle start up script for UN*X
+##
+##############################################################################
+
+# Attempt to set APP_HOME
+# Resolve links: $0 may be a link
+PRG="$0"
+# Need this for relative symlinks.
+while [ -h "$PRG" ]; do
+  ls=$(ls -ld "$PRG")
+  link=$(expr "$ls" : '.*-> \(.*\)$')
+  if expr "$link" : '/.*' >/dev/null; then
+    PRG="$link"
+  else
+    PRG=$(dirname "$PRG")"/$link"
+  fi
+done
+SAVED="$(pwd)"
+cd "$(dirname \"$PRG\")/" >/dev/null
+APP_HOME="$(pwd -P)"
+cd "$SAVED" >/dev/null
+
+APP_NAME="Gradle"
+APP_BASE_NAME=$(basename "$0")
+
+# Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
+DEFAULT_JVM_OPTS='"-Xmx64m" "-Xms64m"'
+
+# Use the maximum available, or set MAX_FD != -1 to use that value.
+MAX_FD="maximum"
+
+warn() {
+  echo "$*"
+}
+
+die() {
+  echo
+  echo "$*"
+  echo
+  exit 1
+}
+
+# OS specific support (must be 'true' or 'false').
+cygwin=false
+msys=false
+darwin=false
+nonstop=false
+case "$(uname)" in
+CYGWIN*)
+  cygwin=true
+  ;;
+Darwin*)
+  darwin=true
+  ;;
+MINGW*)
+  msys=true
+  ;;
+NONSTOP*)
+  nonstop=true
+  ;;
+esac
+
+CLASSPATH=$APP_HOME/gradle/wrapper/gradle-wrapper.jar
+
+# Determine the Java command to use to start the JVM.
+if [ -n "$JAVA_HOME" ]; then
+  if [ -x "$JAVA_HOME/jre/sh/java" ]; then
+    # IBM's JDK on AIX uses strange locations for the executables
+    JAVACMD="$JAVA_HOME/jre/sh/java"
+  else
+    JAVACMD="$JAVA_HOME/bin/java"
+  fi
+  if [ ! -x "$JAVACMD" ]; then
+    die "ERROR: JAVA_HOME is set to an invalid directory: $JAVA_HOME
+
+Please set the JAVA_HOME variable in your environment to match the
+location of your Java installation."
+  fi
+else
+  JAVACMD="java"
+  which java >/dev/null 2>&1 || die "ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH.
+
+Please set the JAVA_HOME variable in your environment to match the
+location of your Java installation."
+fi
+
+# Increase the maximum file descriptors if we can.
+if [ "$cygwin" = "false" -a "$darwin" = "false" -a "$nonstop" = "false" ]; then
+  MAX_FD_LIMIT=$(ulimit -H -n)
+  if [ $? -eq 0 ]; then
+    if [ "$MAX_FD" = "maximum" -o "$MAX_FD" = "max" ]; then
+      MAX_FD="$MAX_FD_LIMIT"
+    fi
+    ulimit -n $MAX_FD
+    if [ $? -ne 0 ]; then
+      warn "Could not set maximum file descriptor limit: $MAX_FD"
+    fi
+  else
+    warn "Could not query maximum file descriptor limit: $MAX_FD_LIMIT"
+  fi
+fi
+
+# For Darwin, add options to specify how the application appears in the dock
+if $darwin; then
+  GRADLE_OPTS="$GRADLE_OPTS \"-Xdock:name=$APP_NAME\" \"-Xdock:icon=$APP_HOME/media/gradle.icns\""
+fi
+
+# For Cygwin or MSYS, switch paths to Windows format before running java
+if [ "$cygwin" = "true" -o "$msys" = "true" ]; then
+  APP_HOME=$(cygpath --path --mixed "$APP_HOME")
+  CLASSPATH=$(cygpath --path --mixed "$CLASSPATH")
+
+  JAVACMD=$(cygpath --unix "$JAVACMD")
+
+  # We build the pattern for arguments to be converted via cygpath
+  ROOTDIRSRAW=$(find -L / -maxdepth 1 -mindepth 1 -type d 2>/dev/null)
+  SEP=""
+  for dir in $ROOTDIRSRAW; do
+    ROOTDIRS="$ROOTDIRS$SEP$dir"
+    SEP="|"
+  done
+  OURCYGPATTERN="(^($ROOTDIRS))"
+  # Add a user-defined pattern to the cygpath arguments
+  if [ "$GRADLE_CYGPATTERN" != "" ]; then
+    OURCYGPATTERN="$OURCYGPATTERN|($GRADLE_CYGPATTERN)"
+  fi
+  # Now convert the arguments - kludge to limit ourselves to /bin/sh
+  i=0
+  for arg in "$@"; do
+    CHECK=$(echo "$arg" | egrep -c "$OURCYGPATTERN" -)
+    CHECK2=$(echo "$arg" | egrep -c "^-") ### Determine if an option
+
+    if [ $CHECK -ne 0 ] && [ $CHECK2 -eq 0 ]; then ### Added a condition
+      eval $(echo args$i)=$(cygpath --path --ignore --mixed "$arg")
+    else
+      eval $(echo args$i)="\"$arg\""
+    fi
+    i=$(expr $i + 1)
+  done
+  case $i in
+  0) set -- ;;
+  1) set -- "$args0" ;;
+  2) set -- "$args0" "$args1" ;;
+  3) set -- "$args0" "$args1" "$args2" ;;
+  4) set -- "$args0" "$args1" "$args2" "$args3" ;;
+  5) set -- "$args0" "$args1" "$args2" "$args3" "$args4" ;;
+  6) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" ;;
+  7) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" ;;
+  8) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" "$args7" ;;
+  9) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" "$args7" "$args8" ;;
+  esac
+fi
+
+# Escape application args
+save() {
+  for i; do printf %s\\n "$i" | sed "s/'/'\\\\''/g;1s/^/'/;\$s/\$/' \\\\/"; done
+  echo " "
+}
+APP_ARGS=$(save "$@")
+
+# Collect all arguments for the java command, following the shell quoting and substitution rules
+eval set -- $DEFAULT_JVM_OPTS $JAVA_OPTS $GRADLE_OPTS "\"-Dorg.gradle.appname=$APP_BASE_NAME\"" -classpath "\"$CLASSPATH\"" org.gradle.wrapper.GradleWrapperMain "$APP_ARGS"
+
+exec "$JAVACMD" "$@"

gradlew.bat

+@rem
+@rem Copyright 2015 the original author or authors.
+@rem
+@rem Licensed under the Apache License, Version 2.0 (the "License");
+@rem you may not use this file except in compliance with the License.
+@rem You may obtain a copy of the License at
+@rem
+@rem      https://www.apache.org/licenses/LICENSE-2.0
+@rem
+@rem Unless required by applicable law or agreed to in writing, software
+@rem distributed under the License is distributed on an "AS IS" BASIS,
+@rem WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+@rem See the License for the specific language governing permissions and
+@rem limitations under the License.
+@rem
+
+@if "%DEBUG%" == "" @echo off
+@rem ##########################################################################
+@rem
+@rem  Gradle startup script for Windows
+@rem
+@rem ##########################################################################
+
+@rem Set local scope for the variables with windows NT shell
+if "%OS%"=="Windows_NT" setlocal
+
+set DIRNAME=%~dp0
+if "%DIRNAME%" == "" set DIRNAME=.
+set APP_BASE_NAME=%~n0
+set APP_HOME=%DIRNAME%
+
+@rem Resolve any "." and ".." in APP_HOME to make it shorter.
+for %%i in ("%APP_HOME%") do set APP_HOME=%%~fi
+
+@rem Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
+set DEFAULT_JVM_OPTS="-Xmx64m" "-Xms64m"
+
+@rem Find java.exe
+if defined JAVA_HOME goto findJavaFromJavaHome
+
+set JAVA_EXE=java.exe
+%JAVA_EXE% -version >NUL 2>&1
+if "%ERRORLEVEL%" == "0" goto execute
+
+echo.
+echo ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH.
+echo.
+echo Please set the JAVA_HOME variable in your environment to match the
+echo location of your Java installation.
+
+goto fail
+
+:findJavaFromJavaHome
+set JAVA_HOME=%JAVA_HOME:"=%
+set JAVA_EXE=%JAVA_HOME%/bin/java.exe
+
+if exist "%JAVA_EXE%" goto execute
+
+echo.
+echo ERROR: JAVA_HOME is set to an invalid directory: %JAVA_HOME%
+echo.
+echo Please set the JAVA_HOME variable in your environment to match the
+echo location of your Java installation.
+
+goto fail
+
+:execute
+@rem Setup the command line
+
+set CLASSPATH=%APP_HOME%\gradle\wrapper\gradle-wrapper.jar
+
+
+@rem Execute Gradle
+"%JAVA_EXE%" %DEFAULT_JVM_OPTS% %JAVA_OPTS% %GRADLE_OPTS% "-Dorg.gradle.appname=%APP_BASE_NAME%" -classpath "%CLASSPATH%" org.gradle.wrapper.GradleWrapperMain %*
+
+:end
+@rem End local scope for the variables with windows NT shell
+if "%ERRORLEVEL%"=="0" goto mainEnd
+
+:fail
+rem Set variable GRADLE_EXIT_CONSOLE if you need the _script_ return code instead of
+rem the _cmd.exe /c_ return code!
+if  not "" == "%GRADLE_EXIT_CONSOLE%" exit 1
+exit /b 1
+
+:mainEnd
+if "%OS%"=="Windows_NT" endlocal
+
+:omega

settings.gradle

+rootProject.name = 'dockertest'

src/main/java/com/jaewan/dockertest/DockertestApplication.java

+package com.jaewan.dockertest;
+
+import org.springframework.boot.SpringApplication;
+import org.springframework.boot.autoconfigure.SpringBootApplication;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+@SpringBootApplication
+@RestController
+public class DockertestApplication {
+
+    @GetMapping("/")
+    public String test() {
+        return "Spring Boot with Docker";
+    }
+    public static void main(String[] args) {
+        SpringApplication.run(DockertestApplication.class, args);
+    }
+
+}