Python + Docker + Poetry開発環境を構築してみる

こんにちは！たぬきうどんです！

私は2018年に非IT業界から未経験でエンジニアに転職し、現在までエンジニアとして働いています。

この記事ではPython + Docker + Poetry開発環境の構築方法について書いています。

Dockerを使用することで、環境を汚染することなくPython + Poetry環境を構築できるので、Docker環境でPython + Poetryを使ってみたいと思っている方はぜひご覧ください！

Poetryとは

PoetryはPythonのパッケージ管理ツールです。

Poetryを使用することでプロジェクトが依存しているライブラリの管理が楽になります。

環境構築方法

環境

今回の実行環境＆エディタは下記です。

また、下記のVisual Studio Codeの拡張を使用します。

１．Dockerfile作成

まず、Dockerfileを作成しましょう。

FROM python:3.9-buster

RUN apt-get update &&\
    apt-get -y install locales &&\
    localedef -f UTF-8 -i ja_JP ja_JP.UTF-8
ENV LANG ja_JP.UTF-8
ENV LANGUAGE ja_JP:ja
ENV LC_ALL ja_JP.UTF-8
ENV TZ JST-9
ENV TERM xterm

RUN pip install --upgrade pip
RUN curl -sSL https://install.python-poetry.org | python -

ENV PATH /root/.local/bin:$PATH

Poetryはcurl -sSL https://install.python-poetry.org | python -でインストールするようにします。

インストール後にはENV PATH /root/.local/bin:$PATHにて環境変数PATHにPoetryのパスを設定しておきます。

また、仮想環境については実行環境がコンテナ環境であるため特に必要がありません。

poetry config virtualenvs.create falseをコンテナ内で実行するようにしておき、Poetryが仮想環境を作成しないようにしておきましょう。

２．コンテナを起動し、コンテナ内に入る

それではコンテナを起動しましょう。

上記のDockerfileを起点にRemote-Containersを使用して、コンテナを起動しましょう。

VS Codeのステータスバー左部にある緑の><のところを押して、

Reopen in Containerを選択。

From 'Dockerfile'を選択します。

コンテナのビルド＆起動に成功すれば、VS Codeのステータス左部が

に変わり、コンテナ内に入ります。

また、作業フォルダ下にコンテナ内のVS Codeの設定ファイルである.devcontaine/devcontainer.jsonが作成されます。

３．プロジェクトの初期化

それではプロジェクトを初期化します。

今回はexample-appというプロジェクト名で初期化します。

以下のコマンドを実行します。

$ poetry new example-app

初期化に成功すると以下のようなプロジェクトが生成されます。

example-app
├── pyproject.toml
├── README.rst
├── example-app
│   └── __init__.py
└── tests
    ├── __init__.py
    └── test_example_app.py

パッケージを入れたい場合は作業ディレクトリをexample-appを移し、

poetry add 入れたいパッケージ名

で入れることができます。

{
    "python.analysis.typeCheckingMode": "strict",
    "python.analysis.extraPaths": [
        "/path/to/poetry/cache/virtualenvs/test-example-py3.10/lib/python3.10/site-packages"
    ],
    "python.languageServer": "Pylance"
}

$ poetry env info

Virtualenv
Python:         3.10.1
Implementation: CPython
Path:           /path/to/poetry/cache/virtualenvs/test-example-py3.10
Valid:          True

Base
Platform: darwin
OS:       posix
Python:   /path/to/main/python 

お疲れ様でした！

さいごに

以上がPython + Docker + Poetry開発環境構築方法でした。

Dockerを使用することで、環境を汚すことなくPython + Poetry実行環境が構築できます。

「Poetryを更に知りたい！」というかたは公式のドキュメントを見てみてください。

この記事が皆さんの助けになれば幸いです！

最後まで読んでいただき、ありがとうございました！

参考文献

参考

Pythonでimportの対象ディレクトリのパスを確認・追加（sys.pathなど） | note.nkmk.me

参考

【Importパスエラー解消】Docker環境下でPoetry＋Pylanceで開発を進めている時のVS Codeの設定

Zenn