dockerコンテナ

dockerコンテナ

状態/ライフサイクル

dockerコンテナはイメージと違い、状態を持っている。状態は、実行中・停止・破棄がある。

実行中

docker container runで起動させると実行中となり、Dockerfileに記述されたCMDのコマンドを実行し終わるまで自動中となる。
よって、デーモン/サーバー系のコマンドであれば任意に停止、もしくは異常終了するまでそのコンテナは実行中となるが、そうでない場合(lsコマンドなど即座に終了するもの)は、そのコマンドを終えるまでが実行中となる。
CMDの実行が完了すると、コンテナは停止の状態へ移行する。

停止

実行中であったコンテナが停止した状態。停止した状態なので、再利用が可能。停止した時点の情報を持っているので、ディスクなどの容量は使用している。

破棄

停止状態のコンテナは明示的に破棄をしない限りディスクに残り続ける。頻繁に実行->停止を繰り返す運用の場合には、停止されたコンテナがたまるため(再利用されない限りは実行のたびに新たなコンテナが立ち上がる)、ディスク容量を圧迫していくことになる。完全に不要となったコンテナは削除を行った方がいい。
ただし、一度破棄したコンテナを再び利用することはできないため、退避しなければいけない情報がないか確認してから行うこと。

コンテナ操作

dockerのコンテナは、dockerイメージから作成を行う。作成が完了されると実行状態となる。
イメージの指定方法は、イメージ名かイメージに割り振られたIDを指定することができる。

イメージ名での作成

1
docker container run [options] イメージ名[:タグ] [コマンド] [コマンド引数...]

イメージIDでの作成

1
docker container run [options] イメージID [コマンド] [コマンド引数...]

名前付きコンテナ

イメージからコンテナを作成した場合、コンテナの名前は自動で割り振られる。

docker container ls [--all]を行った際にNAMES列に記載されているのが自動で割り振られたコンテナの名前。
オプション--allを指定することで、停止中のコンテナについている名前も確認することができる。この名前を利用して、再利用することも可能。
また、コンテナ起動時にオプションで名前を付けることもできる。

1
docker container run --name [任意のコンテナ名] [イメージ名]:[タグ]

イメージの指定の仕方はコンテナの起動の項目を参照。
ホスト側のポートは省略することができ、省略時は自動で空いているエフェメラルポートが割り当てられる。
割り当てられたポートはdocker container lsで表示されるportsの項目で確認できる。

実行中コンテナの標準出力を取得

1
docker container logs [-f] コンテナID/コンテナ名

-fをつけるとtail -fのように、指定したコンテナの標準出力を取得し続ける。

実行中コンテナでコマンドの実行

1
docker container exec [options] コンテナID/コンテナ名 コンテナで実行したいコマンド

-i -i / -it sh で実行中のコンテナにシェルで操作ができる。

コンテナとのファイルコピー

コンテナからホスト

1
docker contaner cp [options] コンテナID/コンテナ名:コピー元パス コピー先ホストパス

ホストからコンテナ

1
docker container cp [option] コピー元ホストパス コンテナID/コンテナ名:コピー先パス

コンテナの破棄

1
docker container prune [options]

停止中のコンテナを一括削除できる。

イメージの削除

1
docker image prune [options]

不要そうなdockerイメージをdockerが判断して削除してくれる。

いろいろ削除

1
docker system prune

停止中のコンテナ、ネットワーク、イメージ、ビルドキャッシュといった内容の削除をしてくれる。

コンテナの統計情報を取得

docker container stats [options] コンテナ名/コンテナID[ ...(複数指定可)]

Docker メモ

Dockerfile

インストラクション

FROM

 FROMは作成するDockerイメージのベースとなるイメージを指定でいる。
 FROMで指定できるDockerイメージはDocker Hubに公開されているものから指定できる。

LABEL

 イメージ作者の情報などを記述。

ENV

 Dockerコンテナ内で使える環境変数を設定できる。

ARG

 ビルド時に指定する引数から値を受け取ることができる。
 Dockerfile内で指定したARGの引数と、ビルド時に指定する引数はそろえる必要がある。

1
2
3
4
5
6
#コマンド:sampleargがそろえるべき名前
> docker image build --build-arg samplearg=okok -t example/dockerimage .

#Dockerfileでは以下のように名前を指定して二行目のように値を取り出すことができる。
ARG samplearg
ENV BUILD_ARG=${samplearg}

RUN

 RUNはDockerイメージビルド時に、Dockerコンテナ内で実行するコマンドを定義する。
 RUNの引数には実行したいコマンドをそのまま記述する。

COPY

 COPYはDockerを動作させているホストマシン上のファイルやディレクトリをDockerコンテナ内にコピーするためのインストラクション。

CMD

 CMDはDockerコンテナとして実行する際に、コンテナ内で実行するプロセスを指定する。
 RUNはイメージをビルドするために使い、CMDはコンテナ起動時に一度実行される。

ENTRYPOINT

 ENTRYPOINTにはコマンドを記述する。CMDはENTRYPOINTへの引数となる。–entrypointでrun時に指定することで上書きできる。

ビルド

1
docker image build -t イメージ[:タグ名] Dockerfileまでのパス

タグ名は省略するとlatestとなる。

イメージからコンテナの実行

1
docker [container] run [-d] [-i] [-t] [-rm] [-v ホスト側ディレクトリ:コンテナ側ディレクトリ] イメージ名[/追加のパス]:タグ名

-dオプションをつけないとフォアグランドで実行されてしまう。-dをつけて起動した場合はコンテナIDが標準出力に出力される。
containerは省略可能だが、最近の風潮ではタイプが長くなるがつけて記述するほうが好まれるらしい。

-i起動後にコンテナの標準入力との結びつきを維持する。

-t疑似端末を有効にする。大抵の場合-iと同時に用いられ、同時指定の-itが省略形として存在する。コンテナ起動後に、疑似端末が有効となり標準入力からコマンドを実行できるようになる。

-rmコンテナの終了時にコンテナを破棄する。

-vホストとコンテナ間でディレクトリやファイルの共有を行う。

そのほかオプション

-f Dockerfileのファイル名を指定できる。省略時はDockerfile

--pull=true ビルド時にFROMで指定したイメージをレジストリからダウンロードを必ず行う。省略時は、すでにダウンロード済みであれば、ホスト内のキャッシュからビルドを行い、存在しない場合はレジストリからダウンロードする。

起動中のコンテナの確認

1
2
docker container ls
docker ps

上記二つはどちらも同じ動作。
表示項目のフィルタリングもできる。コンテナIDだけ抽出する場合は以下。

1
docker container ls --filter "ancestor=[イメージ名]" [-q]

-q でコンテナIDのみの抽出

起動中のコンテナの停止

1
docker container stop コンテナID/コンテナ名

docker container lsと組み合わせることができる。

1
docker container stop $(docker container ls --filter "ancestor=[イメージ名" -q])

停止中のコンテナの再起動

1
docker container restart コンテナID/コンテナ名

停止中のコンテナの破棄

1
docker container rm [-f] コンテナID/コンテナ名

-fオプションで実行中のコンテナの削除も可能。

dockerイメージの検索

1
docker search [options] 検索キーワード

-f, --filter filter 出力をフィルターする。
--format 文字列 出力をフォーマットする。
--limit 数値 表示件数を指定の数値に制限する。
--no-trunc 出力を省略せずに表示する。

dockerイメージの取得

1
docker image pull [options] リポジトリ名[:タグ名]

例によってタグ名を省略した場合はlatestが指定される。

ホスト内のイメージの一覧を取得

1
docker image ls [options] [リポジトリ[:タグ名]]

ダウンロード済み、ビルド済みのイメージの一覧を表示する。

dockerイメージのタグ付け

1
docker image tag 元のイメージ名[:タグ名] 新しいイメージ名[:タグ名]

タグ名を省略時はlatest

docker Hub へログイン

1
docker login [-u id] [-p パスワード]

オプションを省略した場合は対話式に進めることができる。ID&PASSを入力して認証する。

docker hub イメージの登録

1
docker image push [options] リポジトリ名[:タグ名]

ログイン済みであれば、自分のリポジトリにイメージを登録することができる。

ポートフォワーディング

ポートフォワーディングはdocker container runの起動コマンド時に-pオプションで指定できる。

1
docker container run -d -p [ホストポート]:コンテナポート イメージの指定