Docker - Dockerfileのソースを表示

== 概要 ==
Dockerfileは、Dockerイメージを作成するための設計図のようなものである。<br>
テキストファイル (yamlファイル) であり、Dockerイメージの構築に必要な一連の指示が含まれている。<br>
<br>
Dockerfileは、アプリケーションの依存関係、実行環境、設定等を明確に定義して、一貫性のある再現可能なコンテナイメージを作成するための強力なツールである。<br>
<br>
Dockerfileを使用する時の注意点を以下に示す。<br>
* 軽量なベースイメージを使用する。
* 関連する命令をグループ化してレイヤー数を減らす。
* dockerignoreファイルを使用して不要なファイルを除外する。
<br>
Dockerfileの要素と特徴を以下に示す。<br>
<br>
* 基本構造
*: Dockerfileは一連のコマンドとその引数で構成されている。
*: 各行は通常1つの指示を表し、大文字で始まる。 (例: FROM, RUN, COPY)
*: <br>
* 主要な命令
** FROM
**: ベースイメージを指定する。
**: 全てのDockerfileはこの命令で始まる。
** RUN
**: コンテナ内でコマンドを実行する。
** COPY / ADD
**: ホストからコンテナにファイルをコピーする。
** WORKDIR
**: 作業ディレクトリを設定する。
** ENV
**: 環境変数を設定する。
** EXPOSE
**: コンテナがリッスンするポートを指定する。
** CMD / ENTRYPOINT
**: コンテナ起動時に実行されるコマンドを定義する。
*: <br>
* レイヤー構造
*: 各命令は新しいレイヤーを作成する。
**: レイヤーは軽量で再利用可能である。
*: <br>
* キャッシュ機能
*: Dockerはビルド時に各レイヤーをキャッシュする。
*: 変更が無い場合、キャッシュされたレイヤーを再利用して高速化する。
*: <br>
* マルチステージビルド
*: 複数のFROM命令を使用して、ビルド環境と実行環境を分離できる。
*: 最終イメージのサイズを小さくするのに役立つ。
*: <br>
* セキュリティ考慮事項
*: 最小権限の原則に従う。
*: 機密情報を直接Dockerfileに記述しない。
*: <br>
* 拡張性と再利用性
*: ARG命令を使用してビルド時の変数を定義できる。
*: 環境に応じて柔軟に設定を変更できる。
<br><br>

== Dockerfileの基礎 ==
==== Dockerfileの概要 ====
Dockerfileは、Dockerイメージの設計図のようなものである。
Dockerfileを作成することにより、任意のDockerイメージを作成できる。
<br>
DockerfileからDockerイメージを作成するには、Dockerfileが存在するディレクトリで以下のコマンドを実行する。<br>
 # イメージ名およびタグ名、Dockerファイル名を指定する場合
 sudo docker build -t <イメージ名>:<タグ名> -f <Dockerファイル名> .
 
 # イメージ名およびタグ名、Dockerファイル名(Dockerファイル名が<u>'''dockerfile'''</u>の場合のみ)は省略できる
 sudo docker build .
<br>
Dockerfileで使用するコマンドを、以下に示す。<br>
* FROM
* RUN
* CMD
* ENTRYPOINT
* COPY
* ADD
* ENV
* WORKDIR
<br>

==== Dockerfileの作成手順 ====
* FROM
*: ベースとなるイメージを決定するコマンドである。
*: Dockerfileの先頭に記述する。
*: FROMの後には、基本的にOSを記述する。
<br>
 例1. FROM centos7:latest
 例2. FROM ruby:2.5
<br>
* RUN
*: FROMで記述したOSに対応するコマンドを実行するコマンドである。
*: RUNごとにLayerが作成される。(Dockerイメージは、レイヤーを積み重ねていくように作成される)
*: <br>
*: 以下の例では、Dockerイメージには、centos7のレイヤーにtouch /usr/bin/testのレイヤーが追加作成される。<br>
*: (/usr/bin/testファイルを作成するDockerイメージを作成している)<br>
 例. FROM centos7:latest
     RUN ["touch", "/usr/bin/test"]
:: <br>
:: 以下の例では、Dockerイメージには、centos7のレイヤーにcurlとnginxという2つのパッケージをインストールするレイヤーが追加作成される。<br>
:: (yum updateはインストールするパッケージを新しいものにするために記述して、yum install -yはパッケージをインストールするために記述している)<br>
 例. FROM centos7:latest
     RUN yum update && yum install -y curl nginx
:: <br>
:: DockerfileからDockerイメージを1度作成したものはキャッシュされるため、RUNを複数記述することにより、ビルドの時間を短くすることができる。<br>
:: ただし、レイヤー数は少ない方が望ましいため、&&や\を使用して、RUNの記述を少なくする。<br>
<br>
* CMD
*: コンテナの実行コマンドを指定するコマンドである。
*: Dockerfileの最後に記述する。
*: <br>
*: 以下の例では、DockerfileからDockerイメージを作成、docker runコマンドによりコンテナを作成した後、/bin/bashを実行している。<br>
 例. FROM centos7:latest
     RUN yum update && yum install -y curl nginx
     CMD ["/bin/bash"]
<br>
* ENTRYPOINT
*: CMDに近い役割を持つコマンドである。
*: CMDは、Dockerコンテナを作成・実行する時(docker runコマンド)、コマンドを上書きできるが、
*: (例. docker run lsコマンドを実行する場合、上記のCMDの例ではbashではなく、lsが実行される)
*: ENTRYPOINTを使用する場合、コマンドは上書きできなくなり、CMDはENTRYPOINTのオプションを記述する形となる。
*: <br>
*: 以下の例では、<code>ENTRYPOINT</code>に<code>ls</code>コマンドを記述することにより、コンテナ実行時(<code>docker run</code>コマンド)に、<code>ls</code>以外のコマンドが実行できなくなる。<br>
*: なお、<code>CMD</code>では、<code>--help</code>オプションを指定している。<br>
 例. FROM centos7:latest
     RUN yum update && yum install -y curl nginx
     ENTRYPOINT ["ls"]
     CMD ["--help"]
<br>
* COPY
*: Dockerfileが存在するディレクトリ(BuildContextという)にあるファイルを、Dockerイメージにコピーするコマンドである。
*: DockerfileをビルドしてDockerイメージからコンテナを作成した後、コンテナにNewDirディレクトリを作成して、Test.txtファイルをコピーしている。
*: この時、Dockerイメージのレイヤーが追加・作成される。
 例. FROM ubuntu:latest
     RUN mkdir /NewDir
     COPY Test.txt /NewDir
     CMD ["/bin/bash"]
<br>
* ADD
*: COPYのコマンドと似ていて、同じくコピーができるインストラクションです。
*: <br>
*: ADDとCOPYとの違い
*: ADDは圧縮ファイルをコピーした際、コピーと解凍の両方を行います。
*: COPYは単純なコピーのみです。
*: 圧縮ファイルをコピー・解凍する時にはADD、圧縮ファイルが関係ない単純なコピーにはCOPYを使います。
*: <br>
*: 以下の例では、Dockerfileをbuildした際、DockerImageにsample.tarを/(ルート直下)にコピー・解凍するLayerを作成されます。
*: コンテナを作成した際に、コンテナのルート直下にsample.tarが解凍されたものが作成されています。
 例. FROM ubuntu:latest
     ADD sample.tar /
     CMD ["/bin/bash"]
<br>
* ENV
*: 環境変数を設定するインストラクションです。
*: <br>
*: 以下の例では、コンテナ作成時にkey1=valueという環境変数が設定されるDockerImageが作成されます。
 例. FROM ubuntu:latest
     ENV key1 value
     CMD ["/bin/bash"]
<br>
* WORKDIR
*: インストラクションの実行ディレクトリを変更するインストラクションです。
*: <br>
*: 以下の例では、sample_folderというディレクトリを作り、sample_folder内でsample_fileを作成するLayerとなります。
*: (WORKDIRを使ったことで、コンテナ内に作成した/sample_folderの中でRUNの実行ができます。)
 例. FROM ubuntu:latest
     RUN mkdir sample_folder
     WORKDIR /sample_folder
     RUN touch sample_file
<br><br>


{{#seo:
|title={{PAGENAME}} : Exploring Electronics and SUSE Linux | MochiuWiki
|keywords=MochiuWiki,Mochiu,Wiki,Mochiu Wiki,Electric Circuit,Electric,pcb,Mathematics,AVR,TI,STMicro,AVR,ATmega,MSP430,STM,Arduino,Xilinx,FPGA,Verilog,HDL,PinePhone,Pine Phone,Raspberry,Raspberry Pi,C,C++,C#,Qt,Qml,MFC,Shell,Bash,Zsh,Fish,SUSE,SLE,Suse Enterprise,Suse Linux,openSUSE,open SUSE,Leap,Linux,uCLnux,電気回路,電子回路,基板,プリント基板
|description={{PAGENAME}} - 電子回路とSUSE Linuxに関する情報 | This page is {{PAGENAME}} in our wiki about electronic circuits and SUSE Linux
|image=/resources/assets/MochiuLogo_Single_Blue.png
}}

__FORCETOC__
[[カテゴリ:Web]][[カテゴリ:コンテナ]]