기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

Python 3.12 업그레이드 문제 해결

발효일: 2026년 1월 21일

개요

2026년 1월 21일부터 Amazon Braket은 모든 노트북 인스턴스 및 관리형 컨테이너 이미지(기본, CUDA-Q, TensorFlow 및 PyTorch)에 대해 Python 런타임을 3.10에서 3.12로 업그레이드합니다. 이 가이드에서는 일반적인 호환성 문제에 대한 솔루션을 제공합니다.

일반 오류 메시지

SDK Python 버전 불일치 오류

오류:

RuntimeError: Python version must match between local environment and container. Client is running Python 3.10 locally, but container uses Python 3.12.

원인: Braket SDK가 노트북이 Python 3.10을 실행하고 있지만 하이브리드 작업 컨테이너가 Python 3.12를 실행하고 있음을 감지했습니다.

해결 방법: 노트북을 Python 3.12로 업그레이드하거나 Python 3.10 컨테이너에 고정합니다.

Cloudpickle 직렬화 오류

오류:

TypeError: code() argument 13 must be str, not int

원인: SDK 검증을 우회하면 Python 3.12의 CodeType 생성자 변경으로 인해 cloudpickle이 Python 3.10과 3.12 사이의 코드를 직렬화하지 못합니다.

해결 방법: 노트북과 컨테이너가 동일한 Python 버전을 사용하는지 확인합니다.

Braket 관리형 노트북

Python 3.10에서 Braket 노트북 인스턴스를 실행하고 하이브리드 작업을 제출하는 경우 작업 컨테이너가 이제 기본적으로 Python 3.12를 사용하기 때문에 버전 불일치 오류가 발생합니다.

여기에는 두 가지 옵션이 있습니다.

하이브리드 작업 데코레이터

@hybrid_job 데코레이터를 사용하려면 환경의 Python 버전이 컨테이너의 Python 버전과 일치해야 합니다.

옵션 1: Python 3.12 컨테이너 사용(권장)

환경을 Python 3.12로 업그레이드한 경우 최신 태그(기본 동작)를 사용합니다.

옵션 2: Python 3.10 컨테이너 사용

Python 3.10을 유지해야 하는 경우 @hybrid_job 데코레이터에서 image_uri 파라미터를 명시적으로 지정합니다.

Python 3.10 컨테이너 태그:

다음 예제는 us-west-2 리전에 대한 것입니다.

전체 이미지 URIs:

Base:       292282985366.dkr.ecr.us-west-2.amazonaws.com/amazon-braket-base-jobs:1.0-cpu-py310-ubuntu22.04
CUDA-Q:     292282985366.dkr.ecr.us-west-2.amazonaws.com/amazon-braket-cudaq-jobs:0.12.0-cpu-py310-0.12.0
PyTorch:    292282985366.dkr.ecr.us-west-2.amazonaws.com/amazon-braket-pytorch-jobs:2.2.0-gpu-py310-cu121-ubuntu20.04
TensorFlow: 292282985366.dkr.ecr.us-west-2.amazonaws.com/amazon-braket-tensorflow-jobs:2.14.1-gpu-py310-cu118-ubuntu20.04

예:

from braket.jobs.hybrid_job import hybrid_job
from braket.devices import Devices

device_arn = Devices.Amazon.SV1

@hybrid_job(
    device=device_arn,
    image_uri="292282985366.dkr.ecr.us-west-2.amazonaws.com/amazon-braket-base-jobs:1.0-cpu-py310-ubuntu22.04"
)
def my_job():
    pass

기존 Bring-Your-Own-Container(BYOC)

Dockerfile이 최신 태그와 함께 Braket 관리형 이미지를 사용하는 경우 2026년 1월 21일 이후에 재구축하면 Python 3.12 지원 이미지가 풀링됩니다.

Python 3.10 지원 Braket 관리형 이미지를 유지하려면 Dockerfile을 업데이트합니다.

이전(업그레이드 후 Python 3.12 획득):

FROM 292282985366.dkr.ecr.us-west-2.amazonaws.com/amazon-braket-base-jobs:latest
FROM 292282985366.dkr.ecr.us-west-2.amazonaws.com/amazon-braket-cudaq-jobs:latest
FROM 292282985366.dkr.ecr.us-west-2.amazonaws.com/amazon-braket-tensorflow-jobs:latest
FROM 292282985366.dkr.ecr.us-west-2.amazonaws.com/amazon-braket-pytorch-jobs:latest

이후(Python 3.10 유지):

FROM 292282985366.dkr.ecr.us-west-2.amazonaws.com/amazon-braket-base-jobs:1.0-cpu-py310-ubuntu22.04
FROM 292282985366.dkr.ecr.us-west-2.amazonaws.com/amazon-braket-cudaq-jobs:0.12.0-cpu-py310-0.12.0
FROM 292282985366.dkr.ecr.us-west-2.amazonaws.com/amazon-braket-pytorch-jobs:2.2.0-gpu-py310-cu121-ubuntu20.04
FROM 292282985366.dkr.ecr.us-west-2.amazonaws.com/amazon-braket-tensorflow-jobs:2.14.1-gpu-py310-cu118-ubuntu20.04

Braket 노트북 인스턴스 업그레이드

다음 단계에 따라 Python 3.12로 업그레이드합니다.