72 lines
2.1 KiB
Markdown
Executable File
72 lines
2.1 KiB
Markdown
Executable File
## 0. setup environment
|
||
|
||
On Mac :
|
||
|
||
brew install ariga/tap/atlas
|
||
|
||
On Linux :
|
||
|
||
curl -sSf https://atlasgo.sh | sh -s -- --community
|
||
|
||
Setup to you database url :
|
||
|
||
export ATLAS_URL="mysql://coze:coze123@localhost:3306/opencoze?charset=utf8mb4&parseTime=True"
|
||
|
||
## 2. init baseline
|
||
|
||
# cd ./docker/atlas
|
||
atlas migrate diff initial --env local --to $ATLAS_URL
|
||
|
||
# The following command is the same as the one above.
|
||
atlas migrate diff initial \
|
||
--dir "file://migrations" \
|
||
--to $ATLAS_URL \
|
||
--dev-url "docker://mysql/8/"
|
||
|
||
## 3. update database table
|
||
|
||
On developer machine（I want add/update table for my business）
|
||
|
||
# First, add or update your table as needed.
|
||
|
||
# Second, autogenerate diff sql
|
||
# cd ./docker/atlas
|
||
atlas migrate diff update --env local --to $ATLAS_URL # step 1
|
||
|
||
# The following command is the same as the one above.
|
||
atlas migrate diff update \
|
||
--dir "file://migrations" \
|
||
--to $ATLAS_URL \
|
||
--dev-url "docker://mysql/8/"
|
||
# will autogenerate some xxxxx_update.sql in margrations
|
||
|
||
|
||
# Third, Check whether the contents of the new xxxx_update.sql file are correct.
|
||
# If any changes are needed, please modify it manually.
|
||
# If you manually modified margrations file, you need to run the following command to update its hash value.
|
||
# If you did not manually modify margrations file, do not run the following command.
|
||
atlas migrate hash # step 2 if need
|
||
atlas migrate status --url $ATLAS_URL --dir "file://migrations" # check status
|
||
|
||
# Last, dump the latest database schema for other developer
|
||
atlas schema inspect -u $ATLAS_URL --exclude "atlas_schema_revisions,table_*" > opencoze_latest_schema.hcl # step 3
|
||
|
||
## 4. apply migration
|
||
|
||
On developer machine（I want to update my local database with the changes that others developer have made）
|
||
|
||
# cd ./docker/atlas
|
||
atlas schema apply -u $ATLAS_URL --to file://opencoze_latest_schema.hcl # step 1 for developer on mac, this command will execute in start_debug.sh
|
||
|
||
On Server machine
|
||
|
||
atlas migrate apply --url $ATLAS_URL --dir "file://migrations" --baseline "20250703095335" # step 1 for dev server
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|