dagster/user-code-example

镜像概述

本镜像为示例用户代码仓库，专门设计用于与dagster-k8s或dagster-celery-k8s镜像集成，提供用户代码在Dagster Kubernetes环境中的组织、部署及集成的参考示例，帮助用户快速理解和上手Dagster在Kubernetes集群中的代码管理流程。

核心功能与特性

• 示例代码结构：包含符合Dagster规范的用户代码组织方式，展示pipeline、solid、资源等核心组件的定义与编排示例。
• 兼容性：与dagster-k8s和dagster-celery-k8s镜像无缝兼容，支持Dagster在Kubernetes环境中的部署模式。
• 即开即用：提供完整的示例配置，用户可直接参考或修改，减少从零构建用户代码仓库的工作量。
• 学习参考：通过实际代码示例，直观展示用户代码与Dagster Kubernetes组件（如Dagit、Celery workers）的交互方式。

使用场景与适用范围

• 学习与调研：供开发者学习Dagster在Kubernetes环境中用户代码的组织规范和最佳实践。
• 集成测试：用于测试dagster-k8s或dagster-celery-k8s镜像的功能完整性及集成流程。
• 模板参考：作为用户自定义代码仓库的基础模板，帮助用户快速构建符合Dagster K8s部署要求的代码仓库。

使用方法与配置说明

镜像获取

若镜像已发布至容器仓库，可通过以下命令拉取（示例镜像名假设为dagster/example-user-code-repo）：

bash
docker pull docker.xuanyuan.run/dagster/example-user-code-repo:latest

与dagster-k8s/dagster-celery-k8s镜像配合使用

该示例镜像通常作为用户代码的载体，与dagster-k8s或dagster-celery-k8s镜像配合使用。典型使用方式包括：

1. 作为卷挂载（推荐用于开发/测试）

将示例代码仓库挂载至dagster-k8s或dagster-celery-k8s容器中，覆盖默认用户代码路径：

bash
# 示例：与dagster-k8s镜像配合使用
docker run -d \
  --name dagster-k8s-example \
  -v $(docker docker.xuanyuan.run/inspect -f '{{ .Config.Volumes }}' dagster/example-user-code-repo | awk -F'/' '{print $2}'):/opt/dagster/app \
  dagster/dagster-k8s:latest

2. 作为基础镜像构建自定义用户代码仓库（推荐用于生产）

以本示例镜像为基础，添加自定义代码，构建个性化用户代码仓库镜像：

dockerfile
# Dockerfile示例
FROM docker.xuanyuan.run/dagster/example-user-code-repo:latest

# 添加自定义pipeline代码
COPY ./my_pipelines /opt/dagster/app/my_pipelines

构建并使用自定义镜像：

bash
docker build -t my-custom-user-code-repo .
docker run -d --name my-dagster-app docker.xuanyuan.run/dagster/dagster-k8s:latest --user-code-image my-custom-user-code-repo:latest

注意事项

• 本镜像为示例性质，不建议直接用于生产环境，用户需根据实际需求修改并构建自定义用户代码仓库。
• 确保使用与dagster-k8s或dagster-celery-k8s镜像版本匹配的示例代码仓库镜像，避免版本兼容性问题。
• 示例代码中的配置（如资源定义、Kubernetes相关参数）需根据实际集群环境调整。