Overview
Django CI/CD Workflow Boilerplate apps are a collection of apps that can be used as a base for starting a new Django project. They are designed to provide a basic setup and structure, allowing developers to quickly get started with their projects without having to recreate everything from scratch.
Features
- Boilerplate Apps: Provides a collection of apps that can be easily copied and used as a starting point for new Django projects.
- Docker Setup: Instructions on how to set up the boilerplate apps using Docker, allowing for easy containerization and deployment.
- Local Setup: Instructions on how to set up the boilerplate apps locally, including setting up a virtual environment and installing the necessary requirements.
- Environment Variables: Guidance on setting up and modifying environment variables as needed for the project.
- Database Migrations: Instructions on running database migrations to ensure the database schema is up to date.
- Superuser Setup: Steps to create a superuser account for administrative purposes.
- Testing: Instructions on running tests to ensure the functionality of the boilerplate apps.
- Server Run: Steps to run the server and start developing on top of the Django boilerplate.
Docker Setup:
- Clone the repository.
- Run the following command to build and run the Docker container:
docker-compose up -d
- Run the database migrations using the following command:
docker-compose run app python manage.py migrate
- Create a superuser by running the command:
docker-compose run app python manage.py createsuperuser
- Run tests using the command:
docker-compose run app python manage.py test
- Start the server by running:
docker-compose up
Local Setup:
- Clone the repository.
- Create and activate a virtual environment.
- Install the required dependencies by running:
pip install -r requirements.txt
- Set up the environment variables and modify their values as needed.
- Run the database migrations using the command:
python manage.py migrate
- Create a superuser by running the following command:
python manage.py createsuperuser
- Run tests using the command:
python manage.py test
- Start the server by running:
python manage.py runserver
Summary
Django CI/CD Workflow Boilerplate apps provide a convenient collection of apps that serve as a starting point for new Django projects. It offers both Docker and local setup options, allowing developers to choose their preferred method of running the apps. With this boilerplate, setting up a new Django project is simplified by providing step-by-step instructions for setup, including database migrations, superuser creation, and running tests.