About the project
About the company
Orange County Lettings is a start-up in the real estate rental industry with an online platform.
The project design and technologies
Technologies
The online platform is made with the
Djangoweb framework.Its data is stored in a relational database
sqlite.The Python testing framework used for that project is
pytest, coupled withcoverage.The log messages inserted in the code and Django’s errors messages are tracked and monitored by
Sentry.The chosen CI/CD platform to automate the build, test, and deployment is
CircleCI.Commits on
masterbranch trigger build and push of aDockerimage to theDockerHubregistry.The Docker image is then auto-deployed on the
Renderweb service host.The documentation is build with
sphinxand deployed onReadTheDocs.
More details
Read Development Guide to know more about the testing and the deployment process.
Read Internals to know more about technical aspects of the web application (models, URLs, etc.).
Quick-start
git clone this repository:
git clone https://github.com/nanakin/OC-P13-Django-CICD.git Django-CICD
Move to the project directory:
cd Django-CICD
Install poetry (if not installed yet), by following the official documentation.
Install project dependencies in a new virtual environment using poetry:
poetry install
Rename a
.env.examplefile as.env:mv .env.example .env
Edit the
.envfile to set the environment variablesApply database migrations:
poetry run python manage.py migrate
Collect static files (if your environment variable DEBUG is False):
poetry run python manage.py collectstatic
Run a development server locally:
poetry run python manage.py runserver
Open your browser and go to http://127.0.0.1:8000/ to see the application running.