Skip to content

GitLab

Note: The default ITS GitLab runner is a shared resource and is subject to slowdowns during heavy usage.
You can run your own GitLab runner that is dedicated just to your group if you need to avoid processing delays.

Last edited by Kris Steinhoff
Page history

Home

Umich Django Project Template

The following project provides a template for creating a Django application with University of Michigan styling and branding.

See the ITS style guide for additional details.

Bootstrap is the underlying CSS framework used.

Additional features include:

  • Deployment-friendly Dockerfile
  • Docker Compose setup for local development
  • Basic GitLab CI config

Quickstart

  • Requirement: Django installed in your current environment (pip install django)

Run django-admin startproject --template https://gitlab.umich.edu/its-inf-net-software/umich-django-project-template/-/archive/master/umich-django-project-template-master.zip --name=Dockerfile your_project_name [optional_project_directory]

This will create a project under "your_project_name" that uses umich styling by default, and is ready to be deployed and configured with OIDC for authentication.

Docker

The see the docker documentation for help with the "start_project.sh" helper script is

Authentication

This template is set up for Shibboleth/OIDC configuration. See this page for more details.

Deployment

See Deployment Notes for details.