How to use Docker?

仮想化技術

| 仮想化技術 | 製品例 | 説明 | 起動速度 | サイズ | セキュリティ | メリット | デメリット | |---|---|--- |--- |---|---|---|---| | VM
ハイパーバイザー型 | VMware ESXi
Microsoft Hyper-V
KVM
Xen | ベアメタル上で直接動作するハイパーバイザーが、
ハードウェアをエミュレートして各VMに独立した
ゲストOSを持たせる方式 | 遅い
(数十秒〜数分) | 大きい
(数GB〜数十GB) | 高い
(カーネルレベルで完全分離) |
  • 異なるOSを同時実行可能
  • 強い隔離性
  • 本番サーバー向け
|
  • リソース消費が大きい
  • 起動が遅い
  • 管理コストが高い
| | VM
ホスト型 | VMware Workstation
VirtualBox
Parallels Desktop | ホストOS上でアプリケーションとして動作する
ハイパーバイザーがVMを実行する方式 | 遅い
(数十秒〜数分) | 大きい
(数GB〜数十GB) | 中〜高
(ホストOS依存の分、Type1よりやや弱い) |
  • 導入が容易
  • 個人PCでの検証・学習に向く
|
  • ホストOSの負荷が重い
  • 本番運用にはあまり向かない
| | コンテナ | Docker
Podman | ホストOSのカーネルを共有しつつ、
  • namespace
  • cgroups
でプロセスやファイルシステムを隔離する軽量な
実行環境 | 速い
(数百ミリ秒〜数秒) | 小さい
(数十MB〜数百MB程度) | 中程度
(カーネル共有のため境界はVMより弱い) |
  • 軽量・高速起動
  • 環境の可搬性が高い
  • CI/CDと相性が良い
|
  • カーネルを共有するためVMより隔離性が弱い
  • 異なるOS種別は実行不可
| | コンテナオーケストレーション | Kubernetes
Docker Swarm
Nomad | 複数のコンテナの
  • 配置
  • スケーリング
  • 障害復旧
などを自動管理する仕組み | 速い
(既存コンテナの起動速度に準ずる) | コンテナ本体+管理コンポーネント分 | コンテナと同程度
(ネットワークポリシー等で強化可能) |
  • 大規模なコンテナ運用を自動化できる
  • スケーラビリティが高い
|
  • 学習コストが高い
  • 構成が複雑になりやすい
| | セキュアコンテナ
microVM型 | Kata Containers
Firecracker | コンテナのインターフェースを保ちつつ、内部では
軽量VMでワークロードを実行し隔離性を強化
する方式 | 中程度
(コンテナより遅く、通常のVMより速い) | 小〜中
(軽量VMのため通常のVMより小さい) | 高い
(VM相当のカーネル分離) |
  • コンテナの俊敏性とVM並みの隔離性を両立
|
  • 通常のコンテナよりオーバーヘッドがある
| | サンドボックス型コンテナ | gVisor | ユーザー空間でLinuxカーネルの機能を再実装し、
コンテナのシステムコールを仲介・制限することで
隔離性を高める方式 | 速い
(コンテナに近い) | 小さい
(コンテナに近い) | 中〜高
(カーネル機能の再実装により攻撃面を縮小) |
  • 既存コンテナ環境に組み込みやすくセキュリティを強化できる
|
  • 一部のシステムコールで性能低下や非互換が発生する場合がある
|

Docker (ドッカー)

  • コンテナ仮想化技術を利用したオープンプラットフォーム
  • アプリケーションの開発、デプロイ、実行を効率化出来る

メリット

  • 仮想環境であるため、隔離されており、実機に影響を及ぼしにくい
  • VMよりも軽量
  • 起動や動作が速い
  • 開発環境の共有や移行が容易

Dockerのインストール

Windows


Download

Linux

ターミナル
curl -fsSL https://download.docker.com/linux/debian/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/debian $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt update
sudo apt install -y docker-ce containerd.io docker-buildx-plugin docker-ce-cli docker-ce-rootless-extras docker-compose-plugin
sudo systemctl enable docker
sudo systemctl restart docker
sudo docker run hello-world # 確認
sudo usermod -aG docker $USER
newgrp docker

Dockerで利用するファイル

ファイル 内容
compose.yml
docker-compose.yml
複数コンテナの一括定義・連携
Dockerfile
  • ベースイメージの指定
  • ポート指定 (情報提供のみで、実際のポートマッピングはdocker-compose.ymlで行う)
  • 必要なソフトウェアのインストール
  • 起動時に実行するコマンド等を指定

基本コマンド

コマンド 説明
docker compose up --build -d
Dockerfileに基づいてサービス用のDockerイメージを更新し、
バックグラウンドで全てのサービスを起動
docker compose up -d
バックグラウンドで全てのサービスを起動
docker compose up
全てのサービスをフォアグラウンドで起動し、ログを表示
docker compose build
Dockerfileに基づいてサービス用のDockerイメージをビルド
docker compose exec [サービス名] [コマンド]
既に実行中のコンテナ内で、新しいコマンドを実行する
docker compose run [サービス名] [コマンド]
一度限りのコマンドを実行
docker compose down
完全にコンテナを終了させる
docker compose stop
コンテナをサスペンドする
docker compose logs [サービス名]
ログの確認
-n [行数] : 最後の[行数]表示
-f : 追従
docker compose logs -n 10 -f [サービス名]
最後の10行表示した後、ログを追従する
docker compose logs -f [サービス名] | grep --line-buffered "[検索する言葉]"
ログを追従しながらリアルタイムで[検索する言葉]を含む行を表示する
docker inspect --format="{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}" [compose.yml内に書かれた container_name の値]
コンテナのIPアドレスを確認
docker system prune -a
不要になったイメージを削除

サンプル

.env
# compose.yml内で利用する環境変数の設定
COMPOSE_PROJECT_NAME=project1           # プロジェクト名(全て小文字)
CONTAINER_NAME=Docker_Linux

Dockerfile_DIR=.
Dockerfile=Dockerfile

VOLUME=./linux_data

TIME_ZONE=Asia/Tokyo
LANG=ja_JP.UTF8

NETWORK_NAME=ethd
IP_SUBNET_ADDR=192.168.10.0
IP_PREFIX=24
IP_GATEWAY_ADDR=192.168.10.1

PORT=3000

USER_NAME=PEN
PASSWORD=password

ENTRY_DIR=Programs
ENTRY_POINT=start.sh

WS=WS

compose.yml
# ==========================================
# compose.yml
#
# | 項目 | 内容 | 備考 |
# | --- | --- | --- |
# | name | プロジェクト名 | 全て小文字 |
# | services | 作成したいサービスを列挙 | YAMLはスペース2つ |
# | linux / db | 作成するサービスの名前 | docker composeで管理する際に必要 |
#
# ==========================================

# name: project1

services:
  linux:
    # ==========================================
    # linuxサービスの設定項目
    #
    # | 項目 | 内容 | 備考 |
    # | --- | --- | --- |
    # | container_name | コンテナ名 | 外部から見た時の名前 |
    # | hostname | ホスト名 | - |
    # | build | Dockerfileの設定 | - |
    # | image | 使用するコンテナイメージ | Dockerfileが無い場合指定 |
    # | volumes | マウントするフォルダ設定(データを永続化) | ホストディレクトリ: コンテナ内ディレクトリ |
    # | restart | コンテナの起動設定 | no unless-stopped always ... |
    # | environment | コンテナ内の環境変数を設定 | Python の `os.environ.get` 等でも取得可能 |
    # | ports | 外部からアクセス可能なポートを設定 | ホストマシンのポート番号:コンテナのポート番号 |
    # | depends_on | サービス間の依存関係を定義 | - |
    # | command | サービスが起動したときに実行するコマンド | - |
    # 
    # IPアドレスの確認 : docker inspect --format="{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}" [${container_name}の値]
    #
    # ==========================================
    env_file: .env
    
    container_name: ${CONTAINER_NAME}

    hostname: ${CONTAINER_NAME}

    build: 
      # ==========================================
      # Dockerfileの設定項目
      #
      # | 項目 | 内容 |
      # | --- | --- |
      # | context/dockerfile | Dockerfileへの相対パス |
      # | args | Dockerfile内の環境変数を設定 |
      #
      # ==========================================

      context: ${Dockerfile_DIR}
      dockerfile: ${Dockerfile}
      args:
        WS:           ${WS}
        USER_NAME:    ${USER_NAME}
        PASSWORD:     ${PASSWORD}
        ENTRY_DIR:    ${ENTRY_DIR}
        ENTRY_POINT:  ${ENTRY_POINT}
        LANG:         ${LANG}
    
    # image: ubuntu:25.10

    volumes:
      - ${VOLUME}:/home/${USER_NAME}/${WS}

    restart: no

    environment:
      - TZ=${TIME_ZONE}
      - LANG=${LANG}
    
    ports:
      - "${PORT}:3000"
    
    # depends_on:
      # ==========================================
      # サービス間 依存関係の設定項目
      #
      # | 項目 | 内容 | 備考 |
      # | --- | --- | --- |
      # | db | 依存サービス名 | dbサービス参照 |
      #
      # ==========================================
      # - db                                # 先にdbサービスが動いていることを確認する

    command:
      - /home/${USER_NAME}/${ENTRY_DIR}/${ENTRY_POINT}
    
    networks:
      - docker_eth

networks:
  default:
    external: true
    name: bridge

  docker_eth:
    name: ${NETWORK_NAME}
    driver: bridge
    ipam:
      driver: default
      config:                               # 物理ネットワークに直接接続したい場合は実環境に合わせる
        - subnet: ${IP_SUBNET_ADDR}/${IP_PREFIX}
          gateway: ${IP_GATEWAY_ADDR}

Dockerfile
# FROM [イメージ] [タグ]
# Docker Hub (https://hub.docker.com/) 参照
FROM ubuntu:25.10

# 環境変数を docker-compose.yml から受け取る
ARG WS
ARG USER_NAME
ARG PASSWORD
ARG ENTRY_DIR
ARG ENTRY_POINT
ARG LANG

# 環境変数を設定
# 1000以上推奨
ENV USER_ID=1001
ENV GROUP_ID=1001

# RUN 命令はなるべく1つにまとめる
# コマンドが長くなる場合は \ で改行すること
RUN apt update && \
    apt upgrade -y && \
    apt install -y \
    sudo nano iproute2 iputils-ping language-pack-ja && \
    useradd -m -s /bin/bash -u ${USER_ID} ${USER_NAME} && \
    usermod -aG sudo ${USER_NAME} && \
    echo "root:${PASSWORD}" | chpasswd && \
    echo "${USER_NAME}:${PASSWORD}" | chpasswd && \
    mkdir -p /home/${USER_NAME}/${ENTRY_DIR} && \
    update-locale LANG=${LANG}

COPY ${ENTRY_POINT} /home/${USER_NAME}/${ENTRY_DIR}/${ENTRY_POINT}
RUN chmod +x /home/${USER_NAME}/${ENTRY_DIR}/${ENTRY_POINT}

USER ${USER_NAME}
WORKDIR /home/${USER_NAME}/${WS}

# 起動したら実行するコマンド
# 環境変数は使えないので注意
# ENTRYPOINT ["/Programs/start.sh"] 

# 起動したら実行するコマンド
# CMD ["/bin/bash", "-c", "while true; do sleep 1000; done"]
# 無限ループでbashを起動し続ける

start.sh
#!/usr/bin/env bash

grep -q "# Bashユーザ設定" ~/.bashrc || tee -a ~/.bashrc <<'EOF'
# Bashユーザ設定
RESET=$'\033[0m'

BOLD=$'\033[1m'          # 太字
DIM=$'\033[2m'           # 薄く
ITALIC=$'\033[3m'        # 斜体(非対応端末あり)
UNDER=$'\033[4m'         # 下線
BLINK=$'\033[5m'         # 点滅
REVERSE=$'\033[7m'       # 反転
HIDE=$'\033[8m'          # 非表示
STRIKE=$'\033[9m'        # 打ち消し線

FG_BLACK=$'\033[30m'
FG_RED=$'\033[31m'
FG_GREEN=$'\033[32m'
FG_YELLOW=$'\033[33m'
FG_BLUE=$'\033[34m'
FG_PURPLE=$'\033[35m'
FG_CYAN=$'\033[36m'
FG_WHITE=$'\033[37m'

FG_BRIGHT_BLACK=$'\033[90m'
FG_BRIGHT_RED=$'\033[91m'
FG_BRIGHT_GREEN=$'\033[92m'
FG_BRIGHT_YELLOW=$'\033[93m'
FG_BRIGHT_BLUE=$'\033[94m'
FG_BRIGHT_PURPLE=$'\033[95m'
FG_BRIGHT_CYAN=$'\033[96m'
FG_BRIGHT_WHITE=$'\033[97m'

BG_BLACK=$'\033[40m'
BG_RED=$'\033[41m'
BG_GREEN=$'\033[42m'
BG_YELLOW=$'\033[43m'
BG_BLUE=$'\033[44m'
BG_MAGENTA=$'\033[45m'
BG_CYAN=$'\033[46m'
BG_WHITE=$'\033[47m'

BG_BRIGHT_BLACK=$'\033[100m'
BG_BRIGHT_RED=$'\033[101m'
BG_BRIGHT_GREEN=$'\033[102m'
BG_BRIGHT_YELLOW=$'\033[103m'
BG_BRIGHT_BLUE=$'\033[104m'
BG_BRIGHT_PURPLE=$'\033[105m'
BG_BRIGHT_CYAN=$'\033[106m'
BG_BRIGHT_WHITE=$'\033[107m'

# ===== 256色 =====
FG_256() { printf "\033[38;5;%sm" "$1"; }
BG_256() { printf "\033[48;5;%sm" "$1"; }

# ===== TrueColor(24bitカラー) =====
FG_RGB() { printf "\033[38;2;%s;%s;%sm" "$1" "$2" "$3"; }
BG_RGB() { printf "\033[48;2;%s;%s;%sm" "$1" "$2" "$3"; }

DISP_STR(){
    for arg in "$@"; do
        printf "%s" "${arg}"
    done
}

trim() {
    local var="$1"
    var="${var#"${var%%[![:space:]]*}"}"   # 前
    var="${var%"${var##*[![:space:]]}"}"   # 後
    echo "$var"
}

# ===== ログ出力用 =====
LOG(){
    local name=$(trim "${1:-USERAPP}")
    local state=$(trim "${2:-LOG}")
    local action=$(trim "${3:-ACTION}")
    local nowtime="$(date '+%Y/%m/%d %H:%M:%S')"
    local detail=$(trim "${4:-log detail}")
    local header="[${name}][${state}][${action}]"
    local headerSize="${5:-50}"
    
    printf "%-${headerSize}s %s %s\n" "${header}" "${nowtime}" "${detail}"
}

LOG_INFO(){
    local name="${1:-USERAPP}"
    local state="INFO"
    local action="${2:-ACTION}"
    local detail="${3:-detail}"
    local headerSize="${4:-50}"

    DISP_STR "${FG_BRIGHT_CYAN}" "${BG_BLACK}"
    LOG "${name}" "${state}" "${action}" "${detail}" "${headerSize}"
    DISP_STR "${RESET}"
}

LOG_WARN(){
    local name="${1:-USERAPP}"
    local state="WARN"
    local action="${2:-ACTION}"
    local detail="${3:-detail}"
    local headerSize="${4:-50}"

    DISP_STR "${FG_YELLOW}" "${BG_BLACK}"
    LOG "${name}" "${state}" "${action}" "${detail}" "${headerSize}"
    DISP_STR "${RESET}"
}

LOG_OK(){
    local name="${1:-USERAPP}"
    local state="OK"
    local action="${2:-ACTION}"
    local detail="${3:-detail}"
    local headerSize="${4:-50}"

    DISP_STR "${FG_GREEN}" "${BG_BLACK}"
    LOG "${name}" "${state}" "${action}" "${detail}" "${headerSize}"
    DISP_STR "${RESET}"
}

LOG_ERROR(){
    local name="${1:-USERAPP}"
    local state="ERROR"
    local action="${2:-ACTION}"
    local detail="${3:-detail}"
    local headerSize="${4:-50}"

    DISP_STR "${FG_RED}" "${BG_BLACK}"
    LOG "${name}" "${state}" "${action}" "${detail}" "${headerSize}"
    DISP_STR "${RESET}"
}

LOG_FAIL(){
    local name="${1:-USERAPP}"
    local state="FAIL"
    local action="${2:-ACTION}"
    local detail="${3:-detail}"
    local headerSize="${4:-50}"

    DISP_STR "$(FG_RGB 204 51 0)" "${BG_BLACK}"
    LOG "${name}" "${state}" "${action}" "${detail}" "${headerSize}"
    DISP_STR "${RESET}"
}

# ===== フールプルーフ =====
BLOCKED_COMMANDS=("chmod" "chown" "rm")
BLOCKED_DIRS=("/")
ROOT_CHILD_LIMIT=3

_guard_check() {
    local cmd_name
    cmd_name="$(basename -- "$1")"
    shift

    local blocked=1 c
    for c in "${BLOCKED_COMMANDS[@]}"; do
        [[ "$cmd_name" == "$c" ]] && blocked=0
    done
    (( blocked == 0 )) || return 0

    local arg resolved bd parent
    local end_opts=0 root_children=0

    for arg in "$@"; do
        if [[ "$arg" == "--no-preserve-root" ]]; then
            echo "[Reject] --no-preserve-root は使用禁止 ($cmd_name)" >&2
            return 1
        fi
        if (( end_opts == 0 )); then
            [[ "$arg" == "--" ]] && { end_opts=1; continue; }
            [[ "$arg" == -* ]] && continue
        fi

        # 存在しないパスも正規化できるよう -m を使う (GNU coreutils)
        resolved="$(realpath -m -- "$arg" 2>/dev/null)" || continue

        for bd in "${BLOCKED_DIRS[@]}"; do
            if [[ "$resolved" == "$bd" ]]; then
                echo "[Reject] '$arg' は '$bd' に解決されます (pwd=$PWD, cmd=$cmd_name)" >&2
                return 1
            fi
        done

        # `/*` はシェルが展開してから渡されるため、/ 直下が大量に並ぶ形で検出する
        parent="$(dirname -- "$resolved")"
        if [[ "$parent" == "/" && "$resolved" != "/" && -d "$resolved" ]]; then
            root_children=$((root_children + 1))
        fi
    done

    if (( root_children >= ROOT_CHILD_LIMIT )); then
        echo "[Reject] '/' 直下のディレクトリが ${root_children} 個指定されています (/* 展開の疑い, cmd=$cmd_name)" >&2
        return 1
    fi
    return 0
}

sudo() {
    local args=("$@") i=0
    while (( i < ${#args[@]} )); do
        case "${args[i]}" in
            -u|-g|-C|-D|-h|-p|-R|-r|-T|-t|-U) i=$((i + 2)) ;;
            -*) i=$((i + 1)) ;;
            *) break ;;
        esac
    done
    if (( i < ${#args[@]} )); then
        _guard_check "${args[@]:i}" || return 1
    fi
    command sudo "$@"
}

for _guard_cmd in "${BLOCKED_COMMANDS[@]}"; do
    eval "${_guard_cmd}() { _guard_check ${_guard_cmd} \"\$@\" || return 1; command ${_guard_cmd} \"\$@\"; }"
done
unset _guard_cmd

EOF

while true; do
    sleep 1000 
done