Debian に Docker Desktop をインストール

このページは、 Debian ディストリビューションに Docker Desktop をインストール、起動、更新する仕方の情報を含みます。

動作条件

Docker Desktop を正しくインストールするには、以下が必須です。

  • システム要件 に一致

  • Debian 11 の 64-bit バージョンを所有

  • Docker Desktop for Linux の tech preview かβバージョンの場合、アンインストールする:

$ sudo apt remove docker-desktop

完全に削除するには、 $HOME/.docker/desktop にある設定やファイルを削除し、 /usr/local/bin/com.docker.cli のシンボリックリンクを削除し、残っている systemd サービスファイルを切り離します。

$ rm -r $HOME/.docker/desktop
$ sudo rm /usr/local/bin/com.docker.cli
$ sudo apt purge docker-desktop

注釈

既に Docker Desktop for Linux tech preview やベータ版をインストール済みの場合、各パッケージによって作成されたファイルを全て削除する必要があります(例: ~/.config/systemd/user/docker-desktop.service~/.local/share/systemd/user/docker-desktop.service )。

Gnome Desktop 環境では、 Gnome 拡張 の AppIndicator と KStatusNotifierItem のインストールが必要です。

Gnome Desktop 環境でない場合、 gnome-terminal のインストールが必要です:

$ sudo apt install gnome-terminal

Docker Desktop のインストール

Debian に Docker Desktop をインストールするため、推奨する手順:

  1. Docker のパッケージ リポジトリをセットアップ

  2. 最新の DEB パッケージ をダウンロード

  3. 以下のように apt でパッケージをインストール:

$ sudo apt-get update
$ sudo apt-get install ./docker-desktop-<version>-<arch>.deb

注釈

インストール処理の最後に、 apt はダウンロードしたパッケージに関するエラーを表示します。このエラーメッセージは無視できます。

N: Download is performed unsandboxed as root, as file '/home/user/Downloads/docker-desktop.deb' couldn't be accessed by user '_apt'. - pkgAcquire::Run (13: Permission denied)

deb パッケージ内に含まれる post-install スクリプトによって、いくつかの post-install 設定ステップが処理されます。

post-install スクリプト:

  • Docker Desktop バイナリに対してケーパビリティを設定し、特権ポートの割り当てと、リソース制限を設定できるようにする

  • Kubernetes 用の DNS 名を /etc/hosts に追加する

  • /usr/bin/docker から /usr/local/bin/com.docker.cli にリンクを作成する

Docker Desktop の起動

Docker Desktop for Linux を開始するには、 Applications メニューから Docker Desktop を探して開きます。これはクジラのメニューアイコンを起動すると、 Docker Dashboard が開き、Docker Desktop の状態を報告します。

あるいは、ターミナルを開き、次のように実行します:

$ systemctl --user start docker-desktop

Docker Desktop を起動すると、専用の コンテクスト を作成し、これを Docker CLI の操作対象となるよう、現在使用するコンテクストとして設定します。これは、デフォルトのコンテクストとして使われている、 Linux ホスト上の Docker Engine がクラッシュするのを避けるためです。Docker Desktop を終了すると、以前のコンテクストを現在の設定に戻します。

Docker Desktop インストーラは、ホスト上の Docker Compose と Docker CLI バイナリを更新します。Docker Compose V2 がインストールされますが、ユーザは設定パネルから docker-compose としてリンクするかどうかを選べます。Docker Desktop は新しい Docker CLI バイナリをインストールします。これはクラウド統合機能を含んでおり、 /usr/local/bin にインストールし、 古い Docker CLI は``/usr/local/bin/com.docker.cli`` にシンボリックリンクを作成します。

Docker Desktop のインストールに成功すると、以下のコマンドを実行し、各バイナリのバージョンを確認できます。

$ docker compose version
Docker Compose version v2.5.0

$ docker --version
Docker version 20.10.14, build a224086349

$ docker version
Client: Docker Engine - Community
Cloud integration: 1.0.24
Version:           20.10.14
API version:       1.41
...

ログイン時に Docker Desktop を起動するよう設定するには、Docker メニューから、 Settings > General > Start Docker Desktop when you log in を選びます。

あるいは、ターミナルを開き、次のように実行します。

$ systemctl --user enable docker-desktop

Docker Desktop を停止するには、トレイアイコンのクジラメニューをクリックし、Docker メニューを開き Quit Docker Desktop を選びます。

あるいは、ターミナルを開き、次のように実行します。

$ systemctl --user stop docker-desktop

Docker Desktop の更新

新しいバージョンの Docker Desktop がリリースされると、 Docker UI は通知を表示します。Docker Desktop を更新したい場合は、都度新しいパッケージをダウンロードし、次のように実行します。

$ sudo apt-get install ./docker-desktop-<version>-<arch>.deb

Docker Desktop のアンインストール

Docker Desktop for Linux を削除するには、次のように実行します。

$ sudo apt remove docker-desktop

完全に削除するには、 $HOME/.docker/desktop にある設定ファイルとデータを削除し、 /usr/local/bin/com.docker.cli を削除し、残っている systemd サービスファイルを削除します。

$ rm -r $HOME/.docker/desktop
$ sudo rm /usr/local/bin/com.docker.cli
$ sudo apt purge docker-desktop

$HOME/.docker/config.json から credsStorecurrentContext プロパティを削除します。加えて、変更を加えた設定ファイルは、手動で削除する必要があります。

次のステップ

  • イメージの構築方法やコンテナ化したアプリケーションを実行する方法を学ぶには、 Get Started をご覧ください。

  • Docker を使って新しいアプリケーションを構築する方法を学ぶには、 Docker で開発 にあるトピックをご覧ください。

参考

Install Docker Desktop on Debian

https://docs.docker.com/desktop/install/debian/