メインコンテンツへスキップ
見出し画像

【40代の学び直し】あえてCLIを選ぶ現場的理由。open.Yellow.os(Debian系)へのDocker Engine導入手順 | 40代マネージャーのDocker学習録 vol.3

    はじめに

    中堅SIerに所属し、日ごろから基礎技術の研鑽に邁進する40代マネージャーである。
    前回のvol.2「【40代の学び直し】「テストで動くのに本番で動かない」を解決。「Docker」に魅了された理由」では、Dockerの概要とその魅力について語ってみた。

    前々回のvol.1「【40代の学び直し】Ubuntu断念からopen.Yellow.osへ。中古PCで始めるLinux生活」でも触れたが、現在手元に、open.Yellow.osを導入したノートPCがある。今回はこのノートPCに対して、Dockerを導入してみた。

    ネット上にUbuntuへの導入手順が多くある中で、Debianベースの手順はなかったので、意外と戸惑うポイントがあったので、その点も含めて導入手順を整理してみた。

    ■この連載を最初から読みたい方■
    vol.1 【40代の学び直し】Ubuntu断念からopen.Yellow.osへ。中古PCで始めるLinux生活

    ■前回の記事■
    vol.2 【40代の学び直し】「テストで動くのに本番で動かない」を解決。「Docker」に魅了された理由

    ■Windowsユーザー向け■
    Windows11環境でお試しの方は、番外編(vol.3.5)へどうぞ。
    vol.3.5 【Windowsユーザー向け】Docker Engineを選ぶ実践的理由と導入手順

    Dockerは2種類ある、なにを導入するか

    さて、Docker導入を始めよう。
    導入するにしても、以下、2つがある。

    • Docker Desktop (GUI操作可能なパッケージ)

    • Docker Engine (Dockerそのもの。CLIで操作)

    開発現場での利用や、理解度向上を目的として、「Docker Engine」導入を選ぼう。

    【コラム①】なぜ、CLI操作を選ぶのか

    初心者向けの解説では、「Docker Desktop」(GUI)の手順が多い認識である。画面キャプチャとともにグラフィカルに解説される手順は、直感的で理解しやすく見える。

    実際にはその通りであると思う。

    しかし、開発現場に目を向けてみると逆の認識である。再現性や保守コスト、障害時の調査コストを考えると、圧倒的にCLIでの操作がよいと考える。

    再現性とドキュメント保守コスト:
    GUIの画面ツールを開発現場で導入した場合、初回はよい。画面キャプチャで作成した手順書はわかりやすく、とっつきやすい。しかし、GUIの画面はアプリケーションがバージョンアップするにつれて、変わっていく。そのたびに手順書の画面キャプチャをアップデートするのは一苦労、以上の労力がかかる。そしてついには陳腐化するのがままあることだ。さらには、手順通りにできないメンバーも初心者には多い。そのサポートもまた大変である。

    対して、CLIであれば、手順書(エクセル等)のコマンドをコピペすれば、だれでも実行可能であり、かつ、同じ結果になる。意味はわからなくとも、早い。さらに、コマンド自体は簡単には変化しないので、いつでも同じであり、陳腐化しようがない。

    実行プロセス(ログ)が残る強み:
    GUI操作の場合、こまめに画面キャプチャを取らない限り、途中の操作が残らない。「うまくいかない」というときに、結果はわかっても途中の操作がブラックボックス化して、原因調査が難しくなってしまう。  
    対して、CLIであれば、実行したコマンド、その結果のログ、と操作した過程が一目瞭然に端末(ターミナル)上に出力されている。それらを見れば、うまくいかない理由もすぐに簡単にできる。このなにかあったときの原因究明のスピード感もCLIを推す理由である。

    開発現場ではGUIよりもCLIの割合が多い印象である。現場のエンジニアと会話していくうえでも、本質的な仕組みをつかんでいく意味でも、ここではGUIで楽をするよりも、CLIコマンドの手触り感を少しでも身につけておく方が、将来的に大きなリターンになって返ってくると考える。

    Docker導入手順

    OSを確認

    このあとの手順にも関係するのだが、いまのOSについて知る必要がある。ターミナルで以下のコマンドを入力して確認する。

    $ cat /etc/os-release

    上記コマンドの出力結果は、私のノートPC(open.Yellow.os)の場合は以下のとおりとなる。

    PRETTY_NAME="open.Yellow.os 24.08 (Freesia)"
    NAME="open.Yellow.os"
    VERSION_ID="24.08"
    VERSION="24.08 (Freesia)"
    VERSION_CODENAME=bookworm
    ID=debian
    ID_LIKE=debian
    HOME_URL="https://openyellowos.com/"
    BUG_REPORT_URL="https://github.com/openyellowos/open-Yellow-os/"

    コマンド出力結果における「ID=debian」より、このOSは「debian」ベースであることがわかった。

    必要なパッケージインストール

    Docker導入に向けて、いくつか必要なパッケージがあるので、事前にインストールする。

    • ca-certificates

    • curl

    • gnupg

    • lsb-release

    $ sudo apt install ca-certificates curl gnupg lsb-release

    だいたいは、インストール済みの場合が多い気がする。

    リポジトリ導入

    Dockerソフトウェアのインストール、アップデートを行うために、aptリポジトリを導入する。

    $ sudo mkdir -p /etc/apt/keyrings
    $ curl -fsSL https://download.docker.com/linux/debian/gpg | sudo gpg --dearmor -o  /etc/apt/keyrings/docker.gpg
    $ sudo chmod a+r /etc/apt/keyrings/docker.gpg
    $ echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/debian $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

    上記出てくるURLが「〜/linux/debian」は、Ubuntu系列のOSの場合は、「〜/linux/ubuntu」になる。なにが用意されているかは、実際に「https://download.docker.com/linux」に接続してみてみるとわかる。

    ここで指定するURLは、インターネット上の解説記事だと「〜/linux/ubuntu」のケースが多い。実際、私はURLを「〜/linux/ubuntu」のパターンで実行してしまっていた。このパターン実行すると、私のノートPC(open.Yellow.os=Debian系ディストロ)では、次の手順で「sudo apt update」を実行したところで、うまくいかず(正確にはソフトウェアパッケージの情報を取得できず)、失敗する。ここで理由がわからず、何度か試行錯誤した。

    Dockerインストール

    さて、Dockerコンテナの各ソフトウェアパッケージをインストールする。

    $ sudo apt update
    $ sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

    インストール結果確認

    上記でインストールは完了したので、実際にできたのか、バージョン確認をしてみる。

    $ docker --version
    Docker version 29.7.1, build e9452d6

    さらに、Docker Compose のバージョンを確認する。

    $ docker compose version
    Docker Compose version v5.4.0

    sudoなしで実行できるようにする

    実は、ここまででインストールは完了しており、Dockerは普通に使えるのだが、このままでは、各コマンドに「sudo」が必要になる。一般ユーザーでは権限が足りない。そこで、「sudo」なしでDockerコマンドを実行できるようにする。
    まずはdockerのグループができていることを確認する。

    $ cat /etc/group | grep docker
    docker:x:995:

    このdockerグループに、いま使っているユーザーを追加する。

    $ sudo gpasswd -a [ユーザーID] docker

    最後に、PCを再起動、もしくは一度ログアウトして再ログインする。これにより、設定が反映される。

    設定確認

    Docker を sudo コマンドなしに実行できるか確認する。以下のコマンドを実行してエラーがでなければ、設定完了だ。

    $ docker image ls -a

    【コラム②】セキュリティと生産性のトレードオフ

    上記手順でDockerコマンドを「sudoなしで実行できる」ようにした。これは、開発作業時のコマンド入力時に、いちいち「sudo 」の5文字、および、パスワード入力を省略するので、地味に生産性を向上させる。よって、他の一般的な入門記事でも、「sudoなしで実行できる」手順は紹介されている。

    しかし、実務や本番運用を考えると、セキュリティリスクとのトレードオフを意識する必要がある

    vol.1において、個人のLinux環境における最低限のセキュリティ(ClamAVやUFWなど)に触れたが、Dockerのセキュリティもまた、便利さの裏にあるリスク設計を正しく理解することが重要になってくる。

    個人の開発環境の場合:
    当記事のように自分しかさわらないクローズなPC環境であれば、利便性と生産性を重視して、当記事に記載のとおり「sudoなしで実行できる」ようにしたほうがよい。なにかあってもまだ自己責任の範疇である。

    複数人で共有する開発環境や本番環境:
    sudoなしとするのは、Dockerコンテナを通して、root権限をユーザーに与えてしまうことと同義である。よって、基本は「sudoあり」とするべきであり、「sudoなしで実行できる」手順は実行しないべきである。さらに、Dockerコンテナを通して、root権限をもった操作をホスト環境で実行されないようにするために、そもそもコンテナ内での実行ユーザーを「一般ユーザー」として動作するようにコンテナイメージを変更するなどの対策を講じることで、セキュリティリスク低減を図っていくことが大事となる。

    まとめ

    以上、Dockerの導入手順である。この手順で、DockerとDocker Composeが導入されている。
    次回は、実際にWEBサーバーコンテナを立ててみる。

    ■次の記事■
    vol.4 【40代の学び直し】まずは動かして感動。10分でつくるDocker Webサーバー構築

    ■前回の記事■
    vol.2 【40代の学び直し】「テストで動くのに本番で動かない」を解決。「Docker」に魅了された理由

    ■マガジン紹介■
    一連の記事をマガジン化しました。他の記事もどうぞ。


    あなたへのおすすめ