Dockerfileの中身の確認

agentcore create コマンドが生成した Dockerfile の中身を確認します。本章ではこの Dockerfile は基本的に書き換えず、生成されたものをそのまま使います。中身は「Python ベースイメージを取得 → 高速なパッケージマネージャ uv を導入 → 非 root ユーザを作成 → uv.lock で依存関係を固定インストール → OpenTelemetry で自動計装しつつ HTTP サーバを起動」という流れで、AgentCore Runtime 向けコンテナの要件(ポート 8080 の /invocations と /ping)を満たしたうえで、本番運用に耐える構成になっています。

MyContainerAgent/app/MyContainerAgent/Dockerfile を開くと、以下のような構成になっているはずです(agentcore のバージョンによって差分はあります)。

FROM public.ecr.aws/docker/library/python:3.12-slim-trixie

RUN pip install --no-cache-dir uv

ARG UV_DEFAULT_INDEX
ARG UV_INDEX

WORKDIR /app

ENV UV_SYSTEM_PYTHON=1 \
    UV_COMPILE_BYTECODE=1 \
    UV_NO_PROGRESS=1 \
    PYTHONUNBUFFERED=1 \
    DOCKER_CONTAINER=1 \
    UV_DEFAULT_INDEX=${UV_DEFAULT_INDEX} \
    UV_INDEX=${UV_INDEX} \
    PATH="/app/.venv/bin:$PATH"

RUN useradd -m -u 1000 bedrock_agentcore

COPY pyproject.toml uv.lock ./
RUN uv sync --frozen --no-dev --no-install-project

COPY --chown=bedrock_agentcore:bedrock_agentcore . .
RUN uv sync --frozen --no-dev

USER bedrock_agentcore

EXPOSE 8080 8000 9000

CMD ["opentelemetry-instrument", "python", "-m", "main"]

コードを解説します。

FROM public.ecr.aws/docker/library/python:3.12-slim-trixie

Public ECR から Python ベースイメージを取得します。Public ECR は AWS が運営するパブリックコンテナレジストリで、Docker Hub の pull 制限を気にせず利用できます。--platform=linux/arm64 の指定はここでは行わず、後段の agentcore コマンド(agentcore dev や agentcore deploy)が docker buildx build --platform linux/arm64 で ARM64 向けにビルドします。

RUN pip install --no-cache-dir uv

ARG UV_DEFAULT_INDEX
ARG UV_INDEX

Python パッケージマネージャの uv をインストールします。uv は Rust で書かれた pip の後継で、依存関係の解決とインストールが大幅に高速化されます。ARG UV_DEFAULT_INDEX / UV_INDEX は、社内プライベート PyPI などを利用する場合に docker build --build-arg で外部から注入するためのビルド引数です。

WORKDIR /app

ENV UV_SYSTEM_PYTHON=1 \
    UV_COMPILE_BYTECODE=1 \
    UV_NO_PROGRESS=1 \
    PYTHONUNBUFFERED=1 \
    DOCKER_CONTAINER=1 \
    UV_DEFAULT_INDEX=${UV_DEFAULT_INDEX} \
    UV_INDEX=${UV_INDEX} \
    PATH="/app/.venv/bin:$PATH"

作業ディレクトリを /app に固定し、uv と Python の環境変数をまとめて設定します。主要なものは以下です。

環境変数 役割
UV_COMPILE_BYTECODE=1 インストール時に .pyc を事前生成して起動を高速化する
PYTHONUNBUFFERED=1 Python の標準出力のバッファリングを無効化し、CloudWatch にログが即時反映されるようにする
PATH="/app/.venv/bin:$PATH" uv sync でインストールされた python などの実行ファイルを PATH の先頭で解決させる
RUN useradd -m -u 1000 bedrock_agentcore

bedrock_agentcore という非 root ユーザを作成します。後段で USER bedrock_agentcore に切り替えることで、コンテナ内のプロセスを非 root 権限で実行し、AWS のセキュリティベストプラクティスに準拠します。

COPY pyproject.toml uv.lock ./
RUN uv sync --frozen --no-dev --no-install-project

COPY --chown=bedrock_agentcore:bedrock_agentcore . .
RUN uv sync --frozen --no-dev

依存関係のインストールとアプリケーションコードのコピーを2段階に分けます。先に pyproject.toml と uv.lock だけをコピーして uv sync --no-install-project で依存パッケージを入れておくことで、コードだけを変更した場合はこのレイヤをキャッシュから再利用でき、イメージビルドが速くなります。その後にアプリケーション本体を非 root ユーザ所有でコピーし、2回目の uv sync でプロジェクト本体を仮想環境にインストールします。--frozen は uv.lock のバージョンを厳密に守るオプションで、CI/CD 実行時に予期しないバージョン変動が起きるのを防ぎます。

USER bedrock_agentcore

EXPOSE 8080 8000 9000

CMD ["opentelemetry-instrument", "python", "-m", "main"]

実行ユーザを非 root に切り替え、AgentCore Runtime が扱う3つのポート(HTTP モード 8080/MCP モード 8000/A2A モード 9000)を公開します。本章のエージェントは HTTP モードのみ使うため、実際に受け付けるのは 8080 だけです。CMD は Python プロセスを opentelemetry-instrument 経由で起動することで、AgentCore Observability に必要なテレメトリを自動で計装します。BedrockAgentCoreApp の app.run() が /invocations と /ping の両エンドポイントを自動で提供するため、CMD 側は Python プロセスの起動を指示するだけで要件を満たせます。

独自のシステム依存を追加したい場合(apt パッケージなど)は、RUN apt-get update && apt-get install -y ... を差し込むだけで拡張できます。ここが Direct Code Deployment との大きな差です。