Solución de problemas de la actualización a Python 3.12 - Amazon Braket
Descripción general de Mensajes de error comunesCuadernos gestionados por BraketDecorador Hybrid JobBring-Your-Own-Container (BYOC)Actualización de la instancia de Braket Notebook

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Solución de problemas de la actualización a Python 3.12

Fecha de entrada en vigor: 21 de enero de 2026

Descripción general de

A partir del 21 de enero de 2026, Amazon Braket actualizará el entorno de ejecución de Python de la versión 3.10 a la 3.12 para todas las instancias de Notebook y las imágenes de contenedores gestionadas (Base, CUDA-Q y). TensorFlow PyTorch Esta guía proporciona soluciones para los problemas de compatibilidad más comunes.

Mensajes de error comunes

Error de discordancia de la versión de Python del SDK

Error:

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

Causa: el SDK de Braket detectó que tu portátil ejecuta Python 3.10, pero el contenedor Hybrid Job ejecuta Python 3.12.

Solución: actualice su bloc de notas a Python 3.12 o fíjelo a contenedores de Python 3.10.

Error de serialización de Cloudpickle

Error:

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

Causa: si se omite la validación del SDK, cloudpickle no puede serializar el código entre Python 3.10 y 3.12 debido a un cambio de constructor CodeType en Python 3.12.

Solución: asegúrese de que el bloc de notas y el contenedor utilicen la misma versión de Python.

Cuadernos gestionados por Braket

Si ejecuta una instancia de Braket Notebook en Python 3.10 y envía trabajos híbridos, se producirán errores de desajuste de versiones porque los contenedores de trabajos ahora usan Python 3.12 de forma predeterminada.

Tiene dos opciones:

  1. [Recomendado] Cree una nueva instancia de Notebook con Python 3.12; consulte Actualización de instancias de Braket Notebook

  2. Fije a los contenedores de Python 3.10; consulte Hybrid Job Decorator

Decorador Hybrid Job

Para usar el @hybrid_job decorador, la versión de Python de su entorno debe coincidir con la versión de Python del contenedor.

Opción 1: usar contenedores de Python 3.12 (recomendado)

Si ha actualizado su entorno a Python 3.12, utilizará la última etiqueta (comportamiento predeterminado).

Opción 2: usar contenedores de Python 3.10

Si debe permanecer en Python 3.10, especifique explícitamente el image_uri parámetro en el @hybrid_job decorador.

Etiquetas de contenedor de Python 3.10:

Nombre de la imagen

Tag

Base

1.0-cpu-py310-ubuntu22.04

CUDA-Q

0.12.0-cpu-py310-0.12.0

PyTorch

2.2.0-gpu-py310-cu121-ubuntu20.04

TensorFlow

2.14.1-gpu-py310-cu118-ubuntu20.04

En el siguiente ejemplo es para la región us-west-2.

Imagen completa: 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

Ejemplo:

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
nota

Bring-Your-Own-Container (BYOC)

Si tu Dockerfile usa una imagen gestionada por Braket con la etiqueta más reciente, si se reconstruye después del 21 de enero de 2026, se obtendrán imágenes compatibles con Python 3.12.

Para seguir utilizando las imágenes gestionadas por Braket compatibles con Python 3.10, actualiza tu Dockerfile:

Antes (obtiene Python 3.12 después de la actualización):

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

Después (permanece en 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

Actualización de la instancia de Braket Notebook

Siga estos pasos para actualizar a Python 3.12:

importante

Antes de eliminar su instancia de bloc de notas, asegúrese de haber descargado todos los blocs de notas y archivos que desee conservar. Estos datos no se pueden recuperar después de eliminarlos.

  1. Descargue todos los cuadernos que haya creado o modificado en una unidad local.

  2. Detenga la instancia de cuaderno.

  3. Elimine la instancia de cuaderno.

  4. Cree una nueva instancia de bloc de notas con un nombre diferente.

  5. Sube tus libretas a la nueva instancia.