Dockerの環境をセットアップしてみよう！初心者向けにインストールから動作確認まで解説¶
こんにちは、インフラエンジニアのryuです。
今回は、Dockerをこれから使ってみたい方向けに、Dockerの環境を自分のPCにセットアップする方法を解説します。
Dockerの概要はなんとなく分かったけれど、いざ使おうとすると何をインストールすればよいのか分からない。そんな方も多いのではないでしょうか。
Dockerは、最初の環境構築さえできれば、その後はコマンドを使ってコンテナを起動したり停止したりできます。この記事では、WindowsとMacを中心に、初心者でも迷いにくい流れで進めていきます。
Docker自体がまだよく分からない方は、先にこちらの記事を読んでおくと理解しやすいです。
【関連記事】Dockerとは？初心者向けにわかりやすく解説
この記事を最後まで進めると、Docker Desktopのインストールからdocker versionの確認、最初のコンテナ起動までできるようになります。
Dockerを使うには何をインストールすればいい？¶
WindowsやMacでDockerを学習する場合は、Docker Desktopを使うのが分かりやすい方法です。
Docker Desktopには、Docker Engine、Docker CLI、Docker Composeなど、Dockerを利用するために必要な機能がまとめられています。
| 環境 | 初心者におすすめの方法 | 補足 |
|---|---|---|
| Windows | Docker Desktop | WSL 2を利用する構成が基本 |
| Mac | Docker Desktop | Apple silicon / Intelに合ったものを選ぶ |
| Linux | Docker Engine | UbuntuなどOSごとに手順が異なる |
Linuxで直接Docker Engineを入れたい方は、別の記事で詳しく解説しています。
【関連記事】LinuxにDockerをインストールする方法
Docker Desktopをダウンロードする¶
まずはDocker公式サイトからDocker Desktopをダウンロードします。
WindowsとMacではインストーラーが異なるため、自分が使っているOSに合ったものを選んでください。
上の画像は以前のDocker Desktopダウンロード画面です。現在は画面デザインが変わっている可能性がありますが、WindowsならWindows版、MacならMacのCPUに合った版を選ぶという考え方は同じです。
Macの場合は、Apple siliconとIntelでインストーラーが分かれています。自分のMacがどちらか分からない場合は、Appleメニューから「このMacについて」を開いて確認できます。
以前のDocker DesktopにはStableやEdgeといった配布の違いがありましたが、現在はその選択を前提にする必要はありません。初心者の方は、Docker公式サイトから通常のDocker Desktopをダウンロードすれば大丈夫です。
WindowsではWSL 2を確認しておこう¶
WindowsでDocker Desktopを使う場合、現在はWSL 2を利用する構成が基本です。
WSLはWindows Subsystem for Linuxの略で、Windows上でLinux環境を利用するための仕組みです。Docker Desktopでは、このWSL 2をバックエンドとしてLinuxコンテナを動かせます。
仮想化やWSLと言われると、一気に難しく感じますよね。
ただ、Dockerを始める段階では細かな内部構造をすべて理解する必要はありません。Docker DesktopがLinuxコンテナを動かすために、Windowsの仮想化機能を利用しているくらいの理解で十分です。
WSLの状態を確認する¶
PowerShellまたはコマンドプロンプトを開き、次のコマンドを実行します。
wsl --version
バージョン情報が表示されれば、WSLが利用できる状態です。
WSLが入っていない場合は、管理者権限でPowerShellを開き、次のコマンドでインストールできます。
wsl --install
すでにWSLを使っている場合でも、古いバージョンだとDocker Desktopが正常に動かないことがあります。その場合は次のコマンドで更新できます。
wsl --update
Docker Desktopの対応OSや必要なWSLのバージョンは変わることがあるため、実際にインストールする際はDocker公式ドキュメントのシステム要件も確認してください。
Hyper-Vの画面が出てくる記事もある¶
以前は、WindowsでDocker Desktopを使うためにHyper-Vを有効化する手順がよく紹介されていました。
上の画像はHyper-Vを有効化する場合の設定画面です。現在のDocker DesktopではWSL 2が多くのユーザー向けの標準的な構成になっているため、初心者の方が必ずHyper-Vを有効にしなければならないわけではありません。
古い記事を見ながら作業すると、Hyper-VとWSL 2のどちらを使えばよいのか迷うことがあります。特別な理由がなければ、まずはDocker Desktopの案内に従ってWSL 2を使う形で進めると分かりやすいです。
Docker Desktopをインストールする¶
準備ができたら、ダウンロードしたDocker Desktopのインストーラーを実行します。
Windowsではインストーラーの案内に従って進めます。WSL 2を利用する設定が表示された場合は、そのままWSL 2を利用する構成で進めればよいでしょう。
インストールが終わったら、Docker Desktopを起動します。
初回起動では利用規約への同意や設定画面が表示されることがあります。Docker Desktopが起動し、エラーが表示されていなければ次へ進みましょう。
Macでも流れはほとんど同じです。ダウンロードしたDocker Desktopをインストールし、アプリケーションから起動します。
Dockerが正常に動くか確認してみよう¶
Docker Desktopを起動できたら、いよいよコマンドを実行してみます。
WindowsならPowerShellやコマンドプロンプト、Macならターミナルを開いてください。
Dockerのバージョンを確認する¶
まずは次のコマンドを入力します。
docker version
正常にDockerへ接続できていれば、ClientとServerの情報が表示されます。
もっと簡単にインストールされているDockerのバージョンだけ確認したい場合は、次のコマンドでも大丈夫です。
docker --version
ここでdocker: command not foundなどのエラーが出る場合は、Docker Desktopのインストールが完了しているか、Docker Desktopが起動しているかを確認してください。
hello-worldを動かしてみる¶
バージョンが確認できたら、最初のコンテナを動かしてみましょう。
docker run hello-world
初回はhello-worldのDockerイメージがPC内にないため、Docker Hubから自動的に取得されます。その後コンテナが起動し、Dockerが正常に動作していることを示すメッセージが表示されます。
ここまでできれば、Dockerの環境構築はひとまず完了です。
Docker Hubからイメージを取得する流れをもう少し詳しく知りたい方は、次の記事も参考にしてください。
【関連記事】Docker Hubの使い方｜イメージを取得して起動する方法
Docker Desktopが動かないときに確認したいこと¶
Dockerのセットアップでは、インストールそのものよりもPC側の設定でつまずくことがあります。
特にWindowsでは、WSLが古い、仮想化機能が無効になっている、Docker Desktopを起動していない、といった原因が多いです。
まずは次のように確認してみてください。
| 症状 | 確認すること |
|---|---|
dockerコマンドが見つからない |
Docker Desktopがインストールされているか |
| Dockerに接続できない | Docker Desktopが起動しているか |
| WSL関連のエラーが出る | wsl --updateでWSLを更新する |
| 起動時に仮想化エラーが出る | BIOS/UEFIの仮想化設定を確認する |
| コンテナが起動しない | docker logsなどでエラーを確認する |
エラー文が表示された場合は、内容をそのまま検索したり生成AIに貼り付けたりするのも便利です。ただし、表示されたコマンドを意味も分からず実行するのではなく、何を変更する処理なのかは確認してから実行しましょう。
次はDockerコンテナを実際に操作してみよう¶
Dockerはインストールしただけでは、なかなか身につきません。
docker runでコンテナを起動し、docker psで確認し、docker stopで停止する。このように少しずつ手を動かすと、Dockerの仕組みが分かりやすくなります。
Dockerをどの順番で学べばよいか迷っている方は、こちらの学習ロードマップも参考にしてください。
【関連記事】Docker初心者向け学習ロードマップ
InfraAcademyでは、DockerだけでなくLinuxやネットワークなど、インフラの基礎から実際に手を動かしながら学習できます。
Dockerを触ってみたものの、Linuxコマンドやポート番号、ネットワークの部分で分からなくなってしまった方は、周辺知識も一緒に学ぶと理解しやすくなります。
InfraAcademyでDocker・Linux・ネットワークを学ぶ
まずはDocker Desktopを起動して、docker run hello-worldまで試してみてください。そこまでできれば、Docker学習のスタートラインには立てています。
