Un token escrito en definitions.py acaba en el control de versiones, en la interfaz y en cada copia del repositorio. Usa dg.EnvVar("SHOP_API_TOKEN") en su lugar: el resource guarda el nombre de la variable y Dagster lee su valor del entorno cuando empieza una ejecución. La interfaz muestra el nombre de la variable, nunca el secreto.
os.getenv("SHOP_API_TOKEN") parece lo mismo pero es peor: lee el valor al importar el módulo, lo muestra como cadena normal en la configuración del resource y pasa None en silencio cuando falta la variable.
Para números, dg.EnvVar.int("SHOP_PAGE_SIZE") convierte el texto en un entero. En local, un archivo .env junto al proyecto fija variables para dg dev; en un despliegue cada entorno fija sus propios valores, así preproducción y producción usan tokens distintos con el mismo código. Si falta una variable donde se ejecuta la ejecución, esta falla y el error la nombra. Esta área de trabajo ya fija SHOP_API_TOKEN y SHOP_PAGE_SIZE.
El token se resuelve desde el entorno cuando empieza la ejecución.