はじめに

本記事は業務でDockerやKubernetesを利用するようになったものの、初心者すぎてよくわかっていない私が様々な書籍や講座で調べて学んだ内容を残していくものになっています。
Dockerについてある程度学習した後、Kubernetesの内容に進んでいく予定です。

今回は初心者がDockerを学ぶ　Part1 -Dockerとは-の続きで、Dockerコマンドをいろいろ使ってみようと思います。

本記事でわかること

Dockerのイメージを取得したり、実際にコンテナを作成して実行したりするときの基本的なコマンドの使い方がわかります。
記事タイトルの通りですが初心者向けです。

実行環境

Part1の記事でも最後に書いていますが、私はMacBookを使っているのでDocker Desktop for Macの手順でDocker Desktopをインストールしています。

Docker Desktop for Mac : https://docs.docker.com/docker-for-mac/install/
Docker Desktop for Windows: https://docs.docker.com/docker-for-windows/install/
Linux: https://docs.docker.com/engine/install/

インストールできたかどうかは以下のコマンドで確認できます。
正常にインストールできていればバージョン情報が出てきます。

$ docker --version
Docker version 20.10.20, build 9fdeb9c

Docker Engineの起動と終了

上記の方法でインストールを行なった場合、Docker Engineの起動、終了は以下のようになると思います。

MacとWindowsの場合

MacまたはWindows環境の方はとても簡単です。インストールしたDocker Desktopのアプリケーションを起動するだけです。
終了もアプリケーションを終了させればOKです。

Linuxの場合

Docker Engineの起動、終了はroot権限で行います。それぞれ以下のようなコマンドになるかと思います。

起動

sudo systemctl start docker

終了

sudo systemctl stop docker

自動起動の設定

sudo systemctl enable docker

nginxのイメージを使って色々試してみる

Dockerイメージを探す

まずは公開されているnginxのイメージを検索してみます。

$ docker search nginx
NAME                                              DESCRIPTION                                     STARS     OFFICIAL   AUTOMATED
nginx                                             Official build of Nginx.                        17828     [OK]       
linuxserver/nginx                                 An Nginx container, brought to you by LinuxS…   181                  
bitnami/nginx                                     Bitnami nginx Docker Image                      149                  [OK]
ubuntu/nginx                                      Nginx, a high-performance reverse proxy & we…   71                   
bitnami/nginx-ingress-controller                  Bitnami Docker Image for NGINX Ingress Contr…   22                   [OK]
rancher/nginx-ingress-controller                                                                  11                   
kasmweb/nginx                                     An Nginx image based off nginx:alpine and in…   4

なにやらいっぱい出てきましたが、一番上のOfficial build of Nginx.とかいてあるImageを使っていきましょう。

Dockerイメージを取得する

実際にイメージを取得するコマンドはdocker pullを使います。

$ docker pull nginx
Using default tag: latest
latest: Pulling from library/nginx
025c56f98b67: Pull complete 
ec0f5d052824: Pull complete 
cc9fb8360807: Pull complete 
defc9ba04d7c: Pull complete 
885556963dad: Pull complete 
f12443e5c9f7: Pull complete 
Digest: sha256:75263be7e5846fc69cb6c42553ff9c93d653d769b94917dbda71d42d3f3c00d3
Status: Downloaded newer image for nginx:latest
docker.io/library/nginx:latest

pullのあとにイメージ名を指定します。

Dockerイメージの表示

docker imagesで取得したイメージを表示できます。

$ docker images
REPOSITORY   TAG       IMAGE ID       CREATED      SIZE
nginx        latest    3964ce7b8458   4 days ago   142MB

Dockerイメージの削除

イメージを削除するにはdocker rmi <イメージ名>を実行します。

$ docker rmi nginx
Untagged: nginx:latest
Untagged: nginx@sha256:75263be7e5846fc69cb6c42553ff9c93d653d769b94917dbda71d42d3f3c00d3
Deleted: sha256:3964ce7b84589cf9bc585415741b642b7167229e0afde03f502f6c848ed3279d
Deleted: sha256:d074856927ea4224de9fa86b95620c7e4a26da5512db98ccd50cd31b972679a3
Deleted: sha256:815f0d9df09812d9a61725d270fc09f565ab24af22acbda11a953ac9740bb920
Deleted: sha256:dd1c6be5fb8e83f9dc81c628a614dee835cd881c1e244f7f893f2acc49c4fd3b
Deleted: sha256:1d76f7083f6e373335df2263cbd7e272c53df65f226bedbf4849149dddbfd9d7
Deleted: sha256:f95e777ae8eeb4c90475fda98d997771924baaf2975f406d62fa92a1a5b4e502
Deleted: sha256:b5ebffba54d3e3f7fd80435fcdc34c4a96fdb2ecab0f0a298fe08f74c2f69d29

docker imagesでも表示されません。

$ docker images
REPOSITORY   TAG       IMAGE ID   CREATED   SIZE

今回はこの後も使いたいのでもう一回取得しておきます。

nginxのコンテナを生成して起動してみる

イメージからコンテナを生成して起動するにはdocker runを使います。

$ docker run -p 8080:80 --name nginx-server nginx

実行して起動に成功するとコマンド入力が使えなくなると思います。
これを回避する方法は後ほど出てきますので、一旦慌てず別ターミナルを立ちあげてください。

コマンドの内容を見るとdocker runで実行するとは聞いてたけど、聞いてないオプションを使ってますよね。
一つずつ見ていきましょう。

-p 8080:80 : ポートの設定をしています。ホストの8080（任意で好きなポートを設定してOKです）と生成するコンテナのポート80を繋ぐという内容です。

--name niginx-server : 生成するコンテナに名前をつけています。こちらも好きな名前にしてOKです。名前を付けなくても実行できるんですが、後々管理がめんどくさくなったりするかもなので付けておきましょう。

nginx: 最後の部分ですが、利用するイメージの名前を指定しています。

ブラウザでlocalhost:8080にアクセスすると以下のようにWelcome to nginx!が表示されると思います。

ひとまずnginxのイメージからコンテナを生成して実行するまでできました！

起動しているコンテナの一覧を確認する

docker psで起動中のコンテナ一覧を表示できます。

$ docker ps
CONTAINER ID   IMAGE     COMMAND                  CREATED          STATUS          PORTS                  NAMES
dcd2fa8b5a1b   nginx     "/docker-entrypoint.…"   15 minutes ago   Up 15 minutes   0.0.0.0:8080->80/tcp   nginx-server

ランダムな値が振られるコンテナIDや、元となったイメージ名、
ステータスやポートの設定、コンテナ名を確認することができますね。

停止中のコンテナを含めたすべてのコンテナを表示したい場合は以下のようになります。

$ docker ps -a

または

$ docker ps --all

どっちでも同じ結果が出ます。

コンテナを停止する

コンテナを停止したいときは以下のように実行します。

$ docker stop nginx-server
nginx-server

起動中のコンテナ一覧に表示されなくなりました。

$ docker ps
CONTAINER ID   IMAGE     COMMAND   CREATED   STATUS    PORTS     NAMES

docker ps -aで確認するとステータスがExitedになっていることが分かります。

$ docker ps -a
CONTAINER ID   IMAGE     COMMAND                  CREATED          STATUS                          PORTS     NAMES
dcd2fa8b5a1b   nginx     "/docker-entrypoint.…"   25 minutes ago   Exited (0) About a minute ago             nginx-server

停止したコンテナの削除

停止したコンテナを削除したいときは以下のように実行します。

$ docker rm nginx-server
nginx-server

docker ps -aを実行すると一覧から消えていることが分かりますね。

$ docker ps -a
CONTAINER ID   IMAGE     COMMAND   CREATED   STATUS    PORTS     NAMES

コンテナをバックグラウンドで起動する

先程のdocker runコマンドでコマンド入力が使えない状態になったと思います。回避するには以下のように-dオプションをつけることでバックグラウンド起動にできます。

$ docker run -d -p 8080:80 --name nginx-server nginx
a81d2a5f8d7ee6c1f20e19e94919e1825a75a2a6240cd5c9d62acc2d86021bd6

起動したコンテナのシェルに入る

以下のコマンドでバックグラウンドで起動したコンテナの中に入ってみます。

$ docker exec -it nginx-server /bin/bash
root@a81d2a5f8d7e:/#

exec : 実行中のコンテナ内で指定のプログラム、コマンドを実行します。
-it : ホストの標準入出力をコンテナに結びつけます。
nginx-server : コンテナ名です。
/bin/bash : 今回実行したいコマンドです。

コンテナから抜けたいときは以下のようにします。

root@a81d2a5f8d7e:/# exit
exit

コンテナにホストからファイルをコピーする

最後にホスト側のファイルをコンテナ内にコピーする方法を試してみましょう。
まずは以下のようにHello World From Hostとだけ書いたindex.htmlファイルを準備します。

Hello World From Host

カレントディレクトリにindex.htmlがある状態です。

$ ls
index.html

続いて以下のようにコマンドを実行します。

$ docker run -d -v "$(pwd)":/usr/share/nginx/html -p 8080:80 --rm --name nginx-server nginx
0be609db1d250cf216f666bca9f946cbfd7b23df05603e4da6cf9a2540b74c20

-v "$(pwd)":/usr/share/nginx/html : ホストのディレクトリ$(pwd)をコンテナのディレクトリ/usr/share/nginx/htmlとしてマウントします。今回はnginxのデフォルトのHTMLを用意したものに変更しました。

--rm : 今回の内容には直接関係ないですが、コンテナ停止時に同時に削除も行うという意味です。

再度ブラウザでlocalhost:8080にアクセスすると以下のように表示が変わっていることが分かります。

最後に

今回はDockerの基本的なコマンド操作を行いました。
少しだけDockerを使えるようになってきました。
Part3に続きます。