この記事について

私は、Dockerでuvを使用してPython環境を構築しようとした際に発生した環境変数についての問題を記事にしたものです。

`uv`とは

Rust で書かれた、非常に高速な Python パッケージおよびプロジェクトマネージャーです。
Rustで使用されているパッケージ管理システムであるCargoをPythonに導入したもので、pip準拠なより高速なインストールを可能としています。

`uv`のインストール先の変更

以下のような過去の記事を参考にDockerfileを作成し、uvを使用したPython環境を構築しました。

FROM python:3.12-slim-bookworm

# The installer requires curl (and certificates) to download the release archive
RUN apt-get update && apt-get install -y --no-install-recommends curl ca-certificates

# Download the latest installer
ADD https://astral.sh/uv/install.sh /uv-installer.sh

# Run the installer then remove it
RUN sh /uv-installer.sh && rm /uv-installer.sh

# Ensure the installed binary is on the `PATH`
ENV PATH="/root/.cargo/env/:$PATH"

COPY --from=ghcr.io/astral-sh/uv:0.6.10 /uv /uvx /bin/

今回このコンテナをビルドすると

$ docker compose up --build

 => ERROR [app 6/6] RUN . $HOME/.bashrc && uv sync                                                                                0.2s
------                                                                                                                                 
 > [app 6/6] RUN . $HOME/.bashrc && uv sync:
0.121 /bin/sh: 21: .: cannot open /root/.cargo/env: No such file
------
failed to solve: process "/bin/sh -c . $HOME/.bashrc && uv sync" did not complete successfully: exit code: 2

となりました。

以前のリポジトリでは問題なく使用できていることから、uvのインストール先について何かしらの変更が加えられている可能性がありました。

するとこのようなPRが見つかりました。

このIssueは、uvのインストール先を.cargo/envから.local/binに変更されたということが書かれています。これは、uvがRustで使用されていた背景があり、インストール先も.cargo/env配下になっていました。しかしこのPRではXDGに準拠するためにインストール先を変更したと記述されています。では、このXDGとはなんでしょうか？

解決策

この問題を解決するには、以下のようにDockerfileを修正してください。

# 修正後のDockerfile
FROM python:3.12-slim-bookworm

RUN apt-get update && apt-get install -y --no-install-recommends curl ca-certificates

ADD https://astral.sh/uv/install.sh /uv-installer.sh

RUN sh /uv-installer.sh && rm /uv-installer.sh

# PATHに.local/binを追加
ENV PATH="/root/.local/bin:$PATH"

COPY --from=ghcr.io/astral-sh/uv:0.6.10 /uv /uvx /bin/

XDGとは

Various specifications specify files and file formats. This specification defines where these files should be looked for by defining one or more base directories relative to which files should be located.

XDG Base Directory Specification ~Introduction~¹

XDGは、様々な仕様でファイルやファイル形式が指定されている中で、ファイルの配置場所の基準として定義されたものです。dotfileなど、設定ファイルとかデータなどの保存場所がアプリケーション毎にバラバラだと、$homeなどディレクトリが汚染されてしまいます。今回の環境変数については、このXDGに準拠するために変更されたものです。

この話のきっかけとしては、ユーザがRustを使用していないために.cargoではない別の空間に保存する必要があるということで始まりました。使用しているマシンによって異なるディレクトリを指定すると混乱を生じさせるため、変更が行われました。

まとめ

以上より、uvにおける環境変数のインストール先の変更が行われました。uvがCargoを起源としているからこその今回の問題の発生原因だったのかなと思います。

XDG Base Directory Specification ↩