{"id":21152752,"url":"https://github.com/aodin/django-example","last_synced_at":"2026-04-12T17:47:04.844Z","repository":{"id":49826703,"uuid":"375758401","full_name":"aodin/django-example","owner":"aodin","description":"Example Django project","archived":false,"fork":false,"pushed_at":"2024-04-14T23:24:06.000Z","size":431,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-01-21T08:29:41.695Z","etag":null,"topics":["ansible","aws","django","terraform"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/aodin.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-06-10T16:11:58.000Z","updated_at":"2022-06-16T23:50:44.000Z","dependencies_parsed_at":"2024-04-13T22:29:29.301Z","dependency_job_id":"3af796a5-3643-4d5d-82b7-b4300de7651f","html_url":"https://github.com/aodin/django-example","commit_stats":null,"previous_names":[],"tags_count":0,"template":true,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aodin%2Fdjango-example","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aodin%2Fdjango-example/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aodin%2Fdjango-example/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aodin%2Fdjango-example/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aodin","download_url":"https://codeload.github.com/aodin/django-example/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243597783,"owners_count":20316842,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ansible","aws","django","terraform"],"created_at":"2024-11-20T10:46:22.765Z","updated_at":"2025-12-29T17:22:09.253Z","avatar_url":"https://github.com/aodin.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"Django Example\n====\n\nAn example [Django](https://www.djangoproject.com) project. Includes:\n\n- [X] MIT license\n- [X] Dependency management with [Poetry](https://python-poetry.org/docs/master/)\n- [X] A [custom User model](https://docs.djangoproject.com/en/dev/topics/auth/customizing/#substituting-a-custom-user-model)\n- [X] Extensible local settings\n- [X] Example app using a namespaced URL\n- [X] Example model, view, and admin classes\n- [X] Example unit tests for models and views\n- [ ] Example template tags\n- [X] Form-rendering with [Crispy Forms](https://django-crispy-forms.readthedocs.io/en/latest/)\n- [X] Usage of [ManifestStaticFilesStorage](https://docs.djangoproject.com/en/dev/ref/contrib/staticfiles/#manifeststaticfilesstorage)\n- [X] Example JS bundling with [esbuild](https://esbuild.github.io)\n- [X] Example [SCSS](https://sass-lang.com) to CSS transpilation\n- [X] Code formatting with [Black](https://github.com/psf/black)\n- [ ] Dockerfile\n- [X] Terraform configuration for AWS with IPv6 support\n- [X] Roles for deployment via Ansible\n- [X] Support for ARM architecture\n- [ ] Emails with [AWS SES](https://aws.amazon.com/ses/)\n- [ ] HTTPS support via Let's Encrypt\n\n\nThis project is tested on Python 3.12, but may support older Python versions.\n\n\n### Python Dependency Management with Poetry\n\nTo install the project's dependencies, first install [Poetry](https://python-poetry.org/docs/#installation) and then run:\n\n    poetry install\n\nOnce installed, you can start a virtual environment with:\n\n    poetry shell\n\nTo create a `requirements.txt` file for the production dependencies:\n\n    poetry export -f requirements.txt --output requirements.txt --without-hashes\n\n\n### Customized Bootstrap CSS via SCSS\n\nA custom version of Bootstrap 5.1 can be produced by modifying `custom.scss` in the static folder and then running:\n\n    npm run bootstrap\n\n\n### Backwards Compatible Javascript via esbuild\n\nAn `example.js` files is included in the static directory. It can be built with:\n\n    npm run esbuild\n\n\n### Provision AWS Infrastructure via Terraform\n\nAdd a key named `django-key` or change the `key_name` variable.\n\nThe first run requires initializing with:\n\n    terraform init\n\nThen (or on subsequent runs):\n\n    terraform plan --out=plan.tmp\n    terraform apply \"plan.tmp\"\n\nThe configuration is for the `us-west-2` region. You can deploy to other region by changing the `aws_region` and `instance_ami` variables. [Here is the list of available Ubuntu AMIs.](https://cloud-images.ubuntu.com/locator/ec2/)\n\nTo destroy the provisioned infrastructure:\n\n    terraform plan -destroy --out=plan.tmp\n    terraform apply \"plan.tmp\"\n\n\n### Configure Server via Ansible\n\nAdd a [deploy key to your Github repository](https://docs.github.com/en/developers/overview/managing-deploy-keys).\n\nAnsible variables that may need to be updated in `site.yml` or in `ansible-playbook` with the `--extra-vars` flag:\n\n- domain\n- deploy_key\n\nYou can add your AWS access key to your current shell with:\n\n    ssh-add path/to/key.pem\n\nYou may need to add your current IP address to the AWS security group.\n\nAnsible deployment is performed with:\n\n    ansible-playbook -e 'ansible_python_interpreter=python3' -i aws_ec2.yml -u ubuntu site.yml\n\nAnsible inventory can be viewed with:\n\n    ansible-inventory -i aws_ec2.yml --list\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faodin%2Fdjango-example","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faodin%2Fdjango-example","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faodin%2Fdjango-example/lists"}