Docker 入門

主要概念

• Container：

  • Image を元に作成されるプログラムの実行環境
    • Image が実行状態となったインスタンスのこと
    • Image と Container の関係性は、クラスとインスタンスの関係性に似ている
  • 各 Container は、それぞれ独立している
    • 例えば、ある Container にインストールされたアプリケーションは、他の Container には影響を与えない
  • Container はポータブルであり、どのOSでも実行可能

• Image：

  • Container を作成するための設計図
  • Container を構成する全ての要素と、その他メタデータを含む
    • これら要素やメタデータはそれぞれ Layer と呼ばれ、Dockerfile の各命令に対応する

• Dockerfile：

  • Dockerfile は、Image を作成するための設定ファイル。
  • Dockerfile の個々の命令（e.g. RUN ..., COPY ...）が、それぞれ Image の Layer となる。
  • Dockerfile の書き換えによって Image を再構築する際は、変更された Layer のみ再構築される。

1. Dockerfile (設定ファイル) から Image (設計図) を作る

    $ docker image build <path-to-dockerfile> 

2. Image (設計図) から Container (実体) を作る

    $ docker container create <image-name> 

3. Container (実体) でやりたいことを実行する

    $ docker container exec <command> 

参考文献

Docker 概要 — Docker-docs-ja 24.0 ドキュメント

docs.docker.jp

Get started

Get started with Docker

docs.docker.com

２部: Docker を理解するためのポイント｜実践 Docker - ソフトウェアエンジニアの「Docker よくわからない」を終わりにする本

zenn.dev

Container 基本操作

 $ docker container run \       # コンテナを起動するよ
         --name web-server \   # 名前はweb-serverにするよ
         --rm \                # 終了時にコンテナを削除してね
         --detach \            # バックグラウンドで起動するよ
         --publish 8080:80 \   # contaierの80番ポートをhostの8080番ポートに公開するよ
         nginx:latest          # nginxのlatestイメージを使うよ 

その他操作：

 $ docker container exec web-server \
         bash -c "echo 'Hello, World!'" 

簡単のため、一部コマンドのみを記載している。詳しくは、コマンドラインリファレンスを参照されたい。

参考文献

docker container run

docs.docker.com

docker container — Docker-docs-ja 24.0 ドキュメント

docs.docker.jp

Image 基本操作

 $ docker image build \
         --tag my-ubuntu:v2 \
         . 

その他操作：

簡単のため、一部コマンドのみを記載している。詳しくは、コマンドラインリファレンスを参照されたい。

参考文献

docker buildx build

docs.docker.com

docker image — Docker-docs-ja 24.0 ドキュメント

docs.docker.jp

Dockerfile

 # ベースとなるImageを指定する
FROM ubuntu:latest

# 以降の命令は、このディレクトリを作業ディレクトリとして実行される
WORKDIR /app

# 依存関係を更新し、curl をインストールする
RUN apt-get update && apt-get install -y \
    curl \
    && rm -rf /var/lib/apt/lists/*

# ホストマシンの`./hello.sh`を、Imageにコピーする
COPY ./hello.sh .

# コンテナ起動時に実行するコマンドを指定する
CMD ["/hello.sh"] 

参考文献

Dockerfile reference

Find all the available commands you can use in a Dockerfile and learn how to use them, including COPY, ARG, ENTRYPOINT, and more.

docs.docker.com

Dockerfile リファレンス — Docker-docs-ja 24.0 ドキュメント

docs.docker.jp

Dockerfile を書くベストプラクティス — Docker-docs-ja 24.0 ドキュメント

docs.docker.jp

ボリューム (マウント)

• ボリューム：

  • コンテナ内のファイルをホストマシン上でDockerが管理してくれる仕組み
  • ホストマシン上のどこに保存されているかは関心がなく、とにかくデータを永続化するのに使う

• ボリュームの作成：

   $ docker volume create <volume-name> 

• ボリュームの削除：

   $ docker volume rm <volume-name> 

• ボリュームの一覧表示：

   $ docker volume ls 

• ボリュームをコンテナにマウントする：

  • --volumeもしくは--mountオプションを使う
    • --mountの方が詳細に設定可能であり、可読性が高いので、こちらを推奨したい
  • それぞれのオプションの書き方は以下の通り。両者は同じ意味である

    • --volume <ボリューム名>:<マウント先(コンテナ上のパス)>

    • --mount type=volume,src=<ボリューム名>,dst=<マウント先(コンテナ上のパス)>

  例）

  my-volume という名前のボリュームを、/var/lib/mysql にマウントする場合の例：

   # --volumeオプションを使う場合
  $ docker container run \
           --volume my-volume:/var/lib/mysql \
           my-container:db 

   # --mountオプションを使う場合
  $ docker container run \
           --mount type=volume,src=my-volume,dst=/var/lib/mysql \
           my-container:db 

参考文献

Volumes

Learn how to create, manage, and use volumes instead of bind mounts for persisting data generated and used by Docker.

docs.docker.com

３部: ボリューム｜実践 Docker - ソフトウェアエンジニアの「Docker よくわからない」を終わりにする本

zenn.dev

バインドマウント

• バインドマウント：

  • ホストマシン上の任意のディレクトリを、コンテナ上にマウントする仕組み
  • ボリュームと違い、ホストマシン上のどこに保存されるかに関心がある
  • ホストマシンとコンテナ双方がファイルの変更に関心がある場合に有用である

• volumeによるバインドマウント：

  • :で区切られた値の一つ目を絶対パスにすると、バインドマウントとなる

   $ docker container run \
           --volume $(pwd)/src:/src \
           my-container:app 

• --mountによるバインドマウント

   $ docker container run \
           --mount type=bind,src=$(pwd)/src,dst=/src \
           my-container:app 

参考文献

Bind mounts

Using bind mounts

docs.docker.com

３部: バインドマウント｜実践 Docker - ソフトウェアエンジニアの「Docker よくわからない」を終わりにする本

zenn.dev