In this episode, we started a brand new project! I had some internet troubles so this “stream” is actually a local recording from my computer. We created a new Django project from scratch and set up Heroku to handle deployments.
In spite of the streaming trouble,
we were able to get a bunch done.
We started the project from scratch
so we made a repository
.gitignore settings tailored
for Python projects.
The first step in the process was to get a tool to help manage packages. I chose pip-tools to make this process easier. After creating a virtual environment with:
$ python3 -m venv venv $ source venv/bin/activate
pip-tools to a
and installed it.
(venv) $ pip install -r requirements-dev.txt
Then we put Django into
(with Django 3.0, yay!)
pip-tools generate our
(venv) $ pip-compile --output-file requirements.txt requirements.in
Finally, we installed Django.
(venv) $ pip install -r requirements.txt
This process might seem roundabout, but it will ensure that we have exactly the packages we expect as we make future updates.
I took some time to explain some naming conventions
and places where we have choice in the structure
of our projects.
Ultimately, I picked the name of
to store my settings and WSGI files.
To do that, I used
(venv) $ django-admin startproject project .
Note the period at the end of that command! It’s important.
The next step was to fire up the site and check it out.
(venv) $ ./manage.py runserver
Not much there yet, but it was a start. I added all of this to source control as a checkpoint before we moved on.
For this project, I’m using Heroku as a Platform as a Service (PaaS) to host my application. Prior to the stream, I followed the Heroku tutorial and set up the command line tools.
To try to run Django locally with Heroku’s tools, I ran:
(venv) $ heroku local
This failed because the project was missing a
So, we created a
to run the app
with this line
(and added an installation
into our virtual environment).
web: gunicorn project.wsgi --log-file -
heroku local would start,
but we immediately hit an error
because of the
(which is the default
The failure is that the gunicorn default URL
is not in the
Instead of changing
I installed the
and added the following to the settings file.
import django_heroku django_heroku.settings(locals())
This amount of work tweaks the settings
to make Django cooperate
with Heroku better.
We then verified that
heroku local worked
and were ready to deploy online.
Deploying an app to Heroku for the first time is done in two command. Two commands! That’s amazing!
(venv) $ heroku create (venv) $ git push heroku master
The final result made it to Heroku on a randomly assigned domain name. We successfully deployed an awesome web framework on the internet in under an hour (with me explaining everything along the way).
That’s great progress,
but there is a lot of work left to do
to make the site ready
for general use!
On the next stream,
to make it painless
for users to sign up on the site.