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 との大きな差です。