Skip to content

Add DVC to lakeFS migration sample#282

Draft
iddoavn wants to merge 2 commits into
mainfrom
dvc-to-lakefs-migration
Draft

Add DVC to lakeFS migration sample#282
iddoavn wants to merge 2 commits into
mainfrom
dvc-to-lakefs-migration

Conversation

@iddoavn

@iddoavn iddoavn commented Jun 30, 2026

Copy link
Copy Markdown
Contributor

What

Adds a new self-contained standalone example: DVC to lakeFS Migration, under 01_standalone_examples/dvc-to-lakefs-migration/.

It migrates a Git-backed DVC project into lakeFS using the dvc-to-lakefs package, then validates the result — all running locally via Docker Compose (MinIO as the object store, lakeFS backed by MinIO, and a Jupyter notebook driving the migration).

What the demo proves

  • A Git-backed DVC project with both a dvc add output and a dvc.yaml pipeline output migrates into lakeFS.
  • Two Git branches (main and experiment) become lakeFS branches of the same name.
  • The migration is zero-copy — imported objects are referenced from the DVC remote, not copied (DVC remote and lakeFS storage namespace share the same MinIO instance).
  • File contents read back through lakeFS match the contents tracked on the corresponding DVC branch.
  • Each lakeFS commit records the source Git SHA in its git_sha commit metadata.

Contents

  • DVC to lakeFS Migration.ipynb — the notebook that drives and verifies the migration
  • Dockerfile, docker-compose.yml, docker-compose.override.yml.example — local stack (MinIO + lakeFS + Jupyter)
  • README.md — walkthrough, verification steps, preconditions, and how to adapt to your own DVC repo
  • .gitignore

How to run

docker compose up --build

Then open the notebook at http://127.0.0.1:8888/lab/tree/work and run all cells. See the README for full details.

🤖 Generated with Claude Code

iddoavn and others added 2 commits June 22, 2026 11:56
End-to-end, notebook-driven standalone example that migrates a Git-backed
DVC project into lakeFS using the dvc-to-lakefs package, then validates the
result. Runs locally on MinIO + lakeFS via Docker Compose.

The package is installed from GitHub by default; a git-ignored compose
override allows building against a local checkout for development.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
dvc-to-lakefs is now published on PyPI (v0.1.0). Pin to the released
version for reproducibility instead of tracking the unpinned git main.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant