snapshot of https://github.com/ent/ent.git (master, 2026-09-15; blobs > 131072B omitted)

examples/migration/README.md

@@ -0,0 +1,31 @@
+# Versioned Migration Example
+
+The full reference example for https://entgo.io/docs/versioned-migrations#create-a-migration-files-generator.
+
+### Migration directory
+
+Versioned migration files exists under `ent/migrate/migrations`.
+
+### Changes to the Ent schema
+
+1\. Change the `ent/schema`.
+
+2\. Run `go generate ./ent`
+
+### Generate a new migration file
+
+```bash
+atlas migrate diff <migration_name> \
+  --dir "file://ent/migrate/migrations" \
+  --to "ent://ent/schema" \
+  --dev-url "docker://mysql/8/ent"
+```
+
+### Run migration linting
+
+```bash
+atlas migrate lint \
+  --dev-url="docker://mysql/8/dev" \
+  --dir="file://ent/migrate/migrations" \
+  --latest=1
+```