oasis
UCSD Oasis platform
Local project setup
- Install Docker Compose and make sure you have Pip installed
- Clone the project and go to the project folder in your console
- Run
./dev-setupto build the project- Tip: Make sure to run this command regularly, or at least, every time you start something fresh from
master!
- Tip: Make sure to run this command regularly, or at least, every time you start something fresh from
- To run the app:
docker-compose up- navigate to http://localhost:3000 to see it!🚀 - All API endpoints are available in
http://localhost:8000/api/{endpoint-name-here}
- All API endpoints are available in
Adding packages to the frontend
If you need to add packages to the frontend app, make sure to do so with yarn and within the docker environment:
docker-compose run --rm ui yarn add PACKAGE_NAME_HERE
Creating new backend apps with models
If you're creating an app on the backend and it contains models, you'll need to set up a couple of things to make sure migrations work. To begin with, in your app's models.py make sure to import the app's declarative base and creating your models based off that:
from database import Base
class YourCoolModel(Base):
__tablename__ = "super_cool_models"
id = Column(Integer, primary_key=True, index=True)
# all your cool model attributes go here
After that, head over to alembic.env and import your models on the top section of the file:
from users import models
from yourcoolapp import models
That's about it! Migrations should auto-generate correctly with that set up!
Generating & running migrations
As part of our everyday work, data models may change from time to time. When you change a model in the backend, make sure to run the following code to generate any necessary Alembic migrations:
docker-compose run --rm api alembic revision --autogenerate -m "Migration name here!"
When possible, keep the migration name descriptive!
When a new migration file is available, apply it by running
./dev-setup.sh
If you want to run them manually you can also do:
docker-compose run --rm api alembic upgrade head
You can also roll back migrations by doing
docker-compose run --rm api alembic downgrade -1
Seeding data
To populate development database with seed data, which is located in /backend/almebic/seed_data directory, run:
docker-compose run --rm api python alembic/seed.py
To add seed data or modify existing one, apply changes in <entity>.json file for the target entity in aforementioned /backend/alembic/seed_data directory. Make sure that the script uses the data you are interested in, by checking the "files to be imported" at the top of the script.
Running backend tests
All tests for the backed are within the /backend/tests folder, and they're run automatically on branches and PRs by Travis. You can run them by doing:
docker-compose run --rm -e DATABASE_NAME='dbtest' api pytest
Building & deploying
Builds are generated automatically whenever we:
- Push to
master(updates thedevimage) - Push to a branch named
release/something(updates an image calledrelease/something-dev) - Tag the project (generates a
tag-nameimage)
After doing any of these actions, you can head over to Travis to see how the build is faring.
With the build ready, head over to Rancher to upgrade the Oasis instances in the environment you need to deploy to.
Make sure to:
- first upgrade the
db-migrationcontainer if there is any new migration, - then the
appcontainer adding any necessary environment variables
[email protected]">
18 Sep 10, 2022
11 Nov 19, 2022
3 Jan 10, 2022
182 Dec 30, 2022
64 Dec 27, 2022
20.5k Jan 08, 2023
195 Dec 29, 2022
24 Dec 25, 2022
196 Dec 17, 2022
14 Dec 03, 2022
11.4k Dec 27, 2022
101 Dec 27, 2022
19 Jul 22, 2022
51 Dec 25, 2022
1 Jan 01, 2022
2 Oct 18, 2021
83 Jan 01, 2023
6 Apr 18, 2022
75 Dec 22, 2022
3 Aug 24, 2022