Merge pull request #186 from iij/2025/docker_docker_compose

ainamori-iij · web-flow · commit d09d854efb32 · 2025-07-22T10:02:52.000+09:00
Draft: 2025/docker docker compose
diff --git a/src/development/docker/docker/GETSTART.md b/src/development/docker/docker/GETSTART.md
@@ -18,7 +18,7 @@ prior_knowledge: 仮想化、CUI 操作
 $ docker version
 ```
 
-上記コマンドが実行できない方は事前にDocker（及びコマンド）のインストールが終わっているか否か確認し、未完了の人は、Docker のインストールを行ってください。
+上記コマンドが実行できない方は、Docker（及びコマンド）のインストールが終わっているか確認し、未完了であればDockerのインストールを行ってください。
 
 ## Docker コンテナを起動する
 
@@ -28,20 +28,21 @@ Dockerコンテナを使って仮想環境プラットフォームを構築す
 - Dockerコンテナの作成
 - Dockerコンテナの起動
 
-従って、Dockerコンテナを起動する為に最初にすべきことは**Dockerコンテナイメージ**を取得する事になります。
+まずは、**作成済みのDockerコンテナイメージ**を利用してコンテナを起動してみましょう。
 
-Dockerコンテナイメージは、自分で作成(ビルド)して取得する方法と、作成済みのDockerコンテナイメージを取得する方法の2種類があります。
-まずは、作成済みのイメージを利用してコンテナを起動することを試してみましょう。
+---
 
 ### 演習1 Dockerコンテナを起動する
 
-- **docker run**コマンドを使用して**getting-started**コンテナを起動する
-  ```bash
-  docker run --rm -p 80:80 docker/getting-started
-  ```
-<details><summary>実行中のログ</summary>
+**docker run** コマンドを使用して **getting-started** コンテナを起動します。
 
+```bash
+docker run --rm -p 80:80 docker/getting-started
 ```
+
+<details><summary>実行中のログ</summary>
+
+```bash
 Unable to find image 'docker/getting-started:latest' locally
 latest: Pulling from docker/getting-started
 c158987b0551: Pull complete
@@ -57,54 +58,73 @@ Digest: sha256:d79336f4812b6547a53e735480dde67f8f8f7071b414fbd9297609ffb989abc1
 Status: Downloaded newer image for docker/getting-started:latest
 89e2c9780f5caf3b5250013e002e8aaf9f8ea74c2e940eca49b890dfc019ab5e
 ```
+
 </details>
 
-- 起動の確認
-  - ブラウザを開き、以下のURLを入力します
-    ```
-    http://localhost:80
-    ```
-  - 以下のような画面が表示されれば成功です
-    ![getting-started](./images/getting-started.png)
-- コンテナの終了
- **Ctrl + c** を押す
-- ターミナルが戻ってくる
-
-### 発展課題1
-
-先ほどの作業ではフォアグラウンドで実行している為、ターミナルが占有されてしまいます。
-また、このような起動では例えばssh等で接続している場合はセッション切断と共にコンテナが停止してしまう為、発展課題ではこれを永続化する事をやってみましょう。
-
-デーモン起動をすると、ターミナルは返ってきてしまうため起動確認は `docker ps`を使って確認します。
-
-- コンテナのデーモン起動
-  ```bash
-  docker run --rm -p 80:80 docker/getting-started
-  ```
-- コンテナの起動確認
-  ```bash
-  CONTAINER ID   IMAGE                    COMMAND                   CREATED         STATUS         PORTS                               NAMES
-  38ebcf110f45   docker/getting-started   "/docker-entrypoint.…"   3 seconds ago   Up 2 seconds   0.0.0.0:80->80/tcp, :::80->80/tcp   fervent_shaw
-  ```
-  - ここで**NAMES**に表示されている値を記憶、若しくは記録しておいてください
-- 起動の確認
-  - ブラウザを開き、以下のURLを入力します
-    ```
-    http://localhost:80
-    ```
-  - 以下のような画面が表示されれば成功です
-    ![getting-started](./images/getting-started.png)
-- コンテナの終了
-  - **docker stop**コマンドを用いてdockerコンテナを停止します
-  ```
-  docker stop <NAME>
-  ```
-- コンテナが停止したことの確認
-  - ブラウザにて **http://localhost**にアクセスし、アクセスできないことを確認する
-  - **docker ps**コマンドを用いて、何も表示されないことを確認する
-    ```
-    docker ps
-    CONTAINER ID   IMAGE     COMMAND   CREATED   STATUS    PORTS     NAMES
-    ```
-
-<credit-footer/>
+#### 起動の確認
+
+- ブラウザで以下のURLを入力します：
+
+  http://localhost:80
+
+- 以下のような画面が表示されれば成功です：
+
+  ![getting-started](./images/getting-started.png)
+
+#### コンテナの終了
+
+**Ctrl + C** を押して終了します。
+
+---
+
+## 発展課題1: デーモンとして起動する
+
+先ほどはフォアグラウンド実行だったため、ターミナルが占有されていました。
+ここではバックグラウンド（デーモン）で起動し、ターミナルを占有しない方法を学びます。
+起動後は `docker ps` を使用して確認します。
+
+### ステップ1: バックグラウンドで起動
+
+```bash
+docker run --rm -d -p 80:80 docker/getting-started
+```
+
+### ステップ2: コンテナの起動確認
+
+```bash
+docker ps
+
+（出力例）
+
+CONTAINER ID   IMAGE                    COMMAND                   CREATED         STATUS         PORTS                               NAMES
+38ebcf110f45   docker/getting-started   "/docker-entrypoint.…"   3 seconds ago   Up 2 seconds   0.0.0.0:80->80/tcp, :::80->80/tcp   fervent_shaw
+```
+
+- **NAMES** に表示されている値を控えておいてください。
+
+### ステップ3: ブラウザで確認
+
+http://localhost:80 にアクセスし、画面が表示されれば成功です。
+
+![getting-started](./images/getting-started.png)
+
+### ステップ4: コンテナの停止
+
+```bash
+docker stop <NAME>
+```
+
+### ステップ5: 停止の確認
+
+- http://localhost にアクセスして、表示されないことを確認。
+- 以下のコマンドで、コンテナが停止していることを確認。
+
+```bash
+docker ps
+
+（何も表示されなければ停止しています）
+
+CONTAINER ID   IMAGE     COMMAND   CREATED   STATUS    PORTS     NAMES
+```
+
+<credit-footer/>
diff --git a/src/development/docker/docker/README.md b/src/development/docker/docker/README.md
@@ -1,9 +1,10 @@
 ---
-footer: CC BY-SA Licensed | Copyright (c) 2023, Internet Initiative Japan Inc.
+footer: CC BY-SA Licensed | Copyright (c) 2024, Internet Initiative Japan Inc.
 title: Dockerを触ってみよう
 description: Docker の概要を学び、コンテナ操作を体験します
 time: 1h
-prior_knowledge: 仮想化、CUI 操作
+prior_knowledge: 仮想化、CUI 操作、Linux基本操作（推奨）
+updated: 2025-07
 ---
 
 <header-table/>
@@ -12,54 +13,63 @@ prior_knowledge: 仮想化、CUI 操作
 
 ## はじめに
 
-Docker は、Docker, Incが開発しているコンテナ型の仮想環境プラットフォームです。
-コンテナとは仮想マシンのように1台のコンピュータの上で、仮想的に複数のアプリケーションを動作させる技術・仕組みの1つです。
+Dockerは、当初 Docker Inc. によって開発され、現在は Mirantis を中心にコミュニティと共に保守・開発が続けられている、コンテナ型の仮想環境プラットフォームです。
+コンテナとは、1台のコンピュータ上で複数のアプリケーションを分離して動かすための、軽量かつ高速な仮想化技術のひとつです。
 
-Docker(コンテナ仮想化プラットフォーム)を使用すると、アプリケーションやその依存関係をコンテナと呼ばれる独立した環境にパッケージ化することができます。
-では、コンテナと仮想マシンは何が異なるのでしょう？
+Dockerを利用することで、アプリケーションとその依存関係を「コンテナ」と呼ばれる独立した実行環境としてパッケージ化し、どこでも同じように動作させることができます。
 
-一般的に、仮想マシンと呼ばれるソフトウェアでは、ホストOS上で仮想マシン用のソフトウェア（VirtualBox等）を動かすことでホストOSとは異なるOSを起動します。
-一方、コンテナによる仮想化は、ホストOS上にアプリケーション実行用の専用領域を作成し、その中で実行する仕組みとなっています。
+では、「コンテナ」と「仮想マシン」には、どのような違いがあるのでしょうか？
+
+従来の仮想マシンでは、ホストOS上に仮想化ソフトウェア（例：VirtualBox、VMwareなど）を動かし、その中でゲストOSを実行します。
+一方、コンテナはホストOSのカーネルを共有しつつ、独立したユーザー空間を構築することで、軽量で高速な実行環境を提供します。
 
 ### 本講義の目的
 
-- Dockerについて正しい基礎知識と理解を得る
-- DockerFile および dockerコマンドを用いてdocker containerを作成・操作できるようにする
+- Dockerについての基礎的な知識と仕組みを理解する
+- Dockerfile および `docker` コマンドを使って、コンテナの作成・操作を体験する
 
 #### 本講義で扱わないこと
 
-- dockerコマンドのオプション・細かい操作に対する解説
-- コンテナイメージレイヤーの細かい解説
+- `docker` コマンドのすべてのオプション解説
+- コンテナイメージのレイヤー構造などの詳細な内部仕様
 
 ### 本講義の目標
 
-- dockerコマンドを利用してコンテナの取得・起動・停止ができるようになる
-- DockerFileの読み方・書き方を知り、自分で作成もしくは加筆修正するなど、自分の目的に沿ったコンテナを作成できるようになる
+- `docker` コマンドを使って、コンテナの取得・起動・停止ができるようになる
+- Dockerfileの基本的な書き方・読み方を理解し、自分の目的に応じてコンテナを構築できるようになる
 
 ### "Docker" とは
 
-**はじめに** で Docker = コンテナ型仮想環境プラットフォーム、として説明しましたが、本講義で扱う"Docker"は、コンテナ仮想プラットフォームを扱う上での技術的な概念やコマンド等を示します。
+ここで扱う "Docker" とは、コンテナ仮想化プラットフォームおよびその周辺ツール群を指します。
+
+以下はDockerを扱う上で基本となる概念です。
+
+- **Docker コンテナ**
+  アプリケーションとその実行環境をパッケージ化したもの。OSやハードウェアに依存せず、どこでも同じ動作を再現できます。
 
-以下にDockerを扱う上で重要となる概念を記載します。
+- **Docker イメージ**
+  コンテナの元となるファイルシステムのテンプレート。アプリケーションとその依存ファイル、設定が含まれており、Dockerfileを用いて構築します。
 
-- Docker コンテナ
-  - Dockerは、アプリケーションとその依存関係をコンテナと呼ばれる軽量な仮想環境にパッケージ化します。コンテナは、ホストマシンとは独立して実行され、一貫した動作を提供します。コンテナはポータブルであり、異なる環境やプラットフォームで実行できます。
-- Docker イメージ
-  - Dockerコンテナは、Dockerイメージから作成されます。イメージは、アプリケーションの実行に必要なすべての依存関係と設定を含むファイルシステムのスナップショットです。イメージは、**Dockerfile**と呼ばれるテキストファイルに定義され、ビルドコマンドを使用して作成されます。
+- **コンテナオーケストレーション**
+  複数のコンテナを効率よく展開・管理する仕組み。シンプルな構成管理には `docker compose` を、より大規模なシステムには `Kubernetes`（k8s）がよく利用されます。
 
-- コンテナオーケストレーション
-  - Dockerは、コンテナのデプロイメントと管理を容易にするための機能を提供します。複数のコンテナを管理するためのツールとして、**Docker Compose**や**Kubernetes**(*)などがあります。これらのツールを使用すると、複雑なマルチコンテナ環境を構築し、スケーリングやロードバランシングなどの機能を実現することができます。
-- イメージの共有
-  - Docker HubやDocker Registryなどのオンラインリポジトリを使用することで、Dockerイメージを共有および配布することができます。これにより、他の開発者との協力や、既存のイメージを再利用することが容易になります。
+  ※ 本講義では `docker compose`（Docker Compose v2 以降）を前提とします。従来の `docker-compose`（v1）は非推奨です。
 
-本講では主に仮想環境プラットフォームである「**Docker コンテナ**」を中心に行いますが、一方で「**Docker イメージ**」についても学び、自身にとって扱いやすい仮想環境プラットフォームを扱えることを目的と致します。
+- **イメージの共有と配布**
+  Docker Hub や GitHub Container Registry などのリポジトリを通じて、コンテナイメージを共有・再利用できます。
 
-「**コンテナオーケストレーション**」については続く docker-compose の項で扱います。
+- **OCI (Open Container Initiative)**
+  現在、コンテナ技術は OCI により標準化されており、Dockerはその仕様に準拠した実装のひとつです。Podmanやcontainerdなども同様にOCI準拠です。
+
+本講義では「Dockerコンテナ」と「Dockerイメージ」の操作を中心に学習を進めていきます。
+「コンテナオーケストレーション」については、後続の `docker compose` の講義で触れます。
 
 ### 講義の進め方
 
-本講義では、予めDockerがインストールされていることを前提としています。
-Dockerのインストールが完了していない方は、「ハンズオン事前準備」を済ませてください。
+この講義は、Dockerがあらかじめインストールされている環境を前提としています。
+未インストールの場合は、事前準備ガイド「ハンズオン事前準備」に従ってセットアップを済ませてください。
+
+> 💡 注意：Docker Desktop は商用利用に制限があります。Linux では `docker-ce` や `podman` などの代替も検討してください。
 
 ## Chapters
 
@@ -71,20 +81,34 @@ Dockerのインストールが完了していない方は、「ハンズオン
 ## 参考
 
 ### 仮想マシン vs コンテナ
-仮想マシンとコンテナ、どちらが優れており、どちらを使うべきなのでしょう？
 
-それは一概にどちらが優れているからそうすべき、といった類いの物ではありません。
-コンテナは仮想マシンと比べて後発であるため、仮想マシンが抱えていた問題を解決しているのは確かですが、上位互換という事ではありません。
-コンテナには仮想マシンには無いメリットもありますがデメリットもあります。
-コンテナは仮想マシンと異なり、OS の中で別のOSを起動するという事が無いため、セットアップや起動時においてもOSに関わる処理を必要としない為、時間を大幅に短縮することが可能です。また、ハードウェアにアクセスする際もゲストOSを介することが無いため、オーバーヘッドが少なく高速な動作が期待できます。
+仮想マシンとコンテナ、どちらが「優れている」というよりは、それぞれ用途や目的に応じた使い分けが重要です。
+
+コンテナは、仮想マシンよりも軽量かつ高速な環境構築が可能であり、CI/CDやマイクロサービスアーキテクチャとの相性が良いのが特徴です。
+ただし、仮想マシンのように完全に分離された環境を必要とする場合は、VMの方が適していることもあります。
+
+例）
+
+- コンテナ：Linux 上で Linux アプリケーションを高速起動したい
+- 仮想マシン：Linux 上で Windows アプリケーションを実行したい
+
+### Docker のアーキテクチャ
+
+![Docker Image](https://docs.docker.com/get-started/images/docker-architecture.webp)
+
+### Docker Hubのレート制限について
+
+Docker Hub には、匿名ユーザでのpull操作に対してレート制限（1時間に最大100回）が設けられています。大量にpullする場合は `docker login` を行うことで制限緩和されます。
 
-しかし、その一方で仮想マシンと比べてホストOSとの独立性が少ないため、ホストOSとアーキテクチャが大きく異なるコンテナを共存させることはできません。
+### セキュリティの観点（発展）
 
-例）Linux 上で Windows コンテナを起動・実行する
+実務では、以下のセキュリティ対策が重要です：
 
+- コンテナイメージの脆弱性スキャン：`trivy`, `dockle`, `Grype` などのツール
+- Dockerfileでの `USER` 指定（root実行の回避）
 
-###  Docker のアーキテクチャ
+### 発展：DockerとWebAssembly（WASM）
 
-![Docker Image](https://docs.docker.com/guides/images/docker-architecture.webp)
+近年は Docker が WebAssembly（WASM）との統合にも対応し始めており、軽量かつクロスプラットフォームな実行環境として注目されています。
 
-<credit-footer/>
+<credit-footer/>
