zydronium/manage.get.gov
1
0
Fork 0
mirror of https://github.com/cisagov/manage.get.gov.git synced 2025-07-23 19:20:47 +02:00
Code Issues Projects Releases Packages Wiki Activity

Merge pull request #627 from cisagov/rjm/document-local-migrations

Browse source 
Document local migrations, mention --wait for cf migrations
This commit is contained in:
rachidatecs 2023-05-19 10:23:54 -04:00 • committed by GitHub
commit 9b2c6ca045
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
1 changed files with 18 additions and 3 deletions
Download patch file Download diff file Expand all files Collapse all files

21
docs/developer/database-access.md
View file

@ -12,19 +12,34 @@ to get a `psql` shell on the sandbox environment's database.
## Running Migrations
When new code changes the database schema, we need to apply Django's migrations.
When new code changes the database schema (ie, you change a model or pull some
code that has), we need to apply Django's migrations.
### On Local
```shell
docker-compose exec app bash
./manage.py makemigrations
```
Then perform docker-compose down & docker-compose up to run with the new migrations.
### On Cloud.gov
We can run these using CloudFoundry's tasks to run the `manage.py migrate`
command in the correct environment. For any developer environment, developers
can manually run the task with
```shell
cf run-task getgov-ENVIRONMENT --command 'python manage.py migrate' --name migrate
cf run-task getgov-ENVIRONMENT --wait --command 'python manage.py migrate' --name migrate
```
(The optional 'wait' argument will wait until the environment is stable)
Optionally, load data from fixtures as well
```shell
cf run-task getgov-ENVIRONMENT --command 'python manage.py load' --name loaddata
cf run-task getgov-ENVIRONMENT --wait --command 'python manage.py load' --name loaddata
```
For the `stable` environment, developers don't have credentials so we need to