[docker] `docker compose` （docker コマンドのサブコマンドである compose）を全ユーザ向けにインストールする

概要

Linux で docker-compose ではなく docker compose（Docker Compose overview | Docker Documentation）を全ユーザ向けにインストールする記事です。

タイトル通りの内容で、方法も公式ドキュメントそのままです。
そのままやらずにつまづいた例のメモもあります。

インストール方法

ユーザごとにインストールするなら $HOME/.docker/cli-plugins ディレクトリを作成し、その中に docker-compose を配置します。
全ユーザ向けにインストールするなら /usr/local/lib/docker/cli-plugins ディレクトリを作成し、その中に docker-compose を配置します。

mkdir -p ~/.docker/cli-plugins/
curl -SL https://github.com/docker/compose/releases/download/v2.2.2/docker-compose-linux-x86_64 -o ~/.docker/cli-plugins/docker-compose
chmod +x ~/.docker/cli-plugins/docker-compose # 実行権限の付与

# 全ユーザ向け
mkdir -p /usr/local/lib/docker/cli-plugins
curl -SL https://github.com/docker/compose/releases/download/v2.2.2/docker-compose-linux-x86_64 -o /usr/local/lib/docker/cli-plugins/docker-compose
chmod +x /usr/local/lib/docker/cli-plugins/docker-compose # 実行権限の付与

version で確認できます。

$ docker compose version
Docker Compose version v2.2.2

$ /usr/local/lib/docker/cli-plugins/docker-compose version
Docker Compose version v2.2.2

公式ドキュメントの Install the plugin manually 部分そのままです。

つまづいた例

全ユーザ向けのインストールに指定したパスが
/usr/local/lib/docker/cli-plugins/docker-compose ではなく
/usr/local/bin/docker-compose でした。

$ /usr/local/bin/docker-compose version
Docker Compose version v2.2.2
$ docker-compose version
Docker Compose version v2.2.2
$ docker compose version
docker: 'compose' is not a docker command.

上のように PATH が通っているので docker-compose は成功します。
docker compose はプラグインディレクトリがないので失敗します。

docker-compose が成功するためインストール成功したと思い込んでいて、やや時間がつぶれました。