Migration Ihres Django-Projekts zu Heroku

Obwohl diese Methode der Verwendung von zwei Einstellungsdateien seit einigen Jahren üblich ist, verwenden viele Python-Entwickler jetzt ein anderes Muster namens The One True Way. Wir werden uns dieses Muster möglicherweise in einem zukünftigen Tutorial ansehen.

Einstellungen.py aktualisieren

Wir müssen drei Änderungen an unserer aktuellen settings.py vornehmen Datei:

Ändern Sie DEBUG Modus auf false:

DEBUG = False

Fügen Sie den folgenden Code am Ende der Datei hinzu:

# Allow all host hosts/domain names for this site
ALLOWED_HOSTS = ['*']

# Parse database configuration from $DATABASE_URL
import dj_database_url

DATABASES = { 'default' : dj_database_url.config()}

# Honor the 'X-Forwarded-Proto' header for request.is_secure()
SECURE_PROXY_SSL_HEADER = ('HTTP_X_FORWARDED_PROTO', 'https')

# try to load local_settings.py if it exists
try:
  from local_settings import *
except Exception as e:
  pass

Aktualisieren Sie die Datenbankeinstellungen:

# we only need the engine name, as heroku takes care of the rest
DATABASES = {
    "default": {
        "ENGINE": "django.db.backends.postgresql_psycopg2",
    }
}

Erstellen Sie Ihre local_settings.py Datei:

$ touch local_settings.py
$ pip install dj_database_url

Fügen Sie dann den folgenden Code hinzu:

from settings import PROJECT_ROOT, SITE_ROOT
import os

DEBUG = True
TEMPLATE_DEBUG = True

DATABASES = {
    "default": {
        "ENGINE": "django.db.backends.postgresql_psycopg2",
        "NAME": "django_deploy",
        "USER": "foo",
        "PASSWORD": "bar",
        "HOST": "localhost",
        "PORT": "5432",
    }
}

Starten Sie den Testserver, um sicherzustellen, dass alles noch funktioniert. Fügen Sie der Datenbank ein paar weitere Datensätze hinzu.

Heroku-Setup

Fügen Sie dem Hauptverzeichnis eine Proc-Datei hinzu:

$ touch Procfile

und fügen Sie der Datei den folgenden Code hinzu:

web: python manage.py runserver 0.0.0.0:$PORT --noreload

Installieren Sie den Heroku-Toolbelt:

$ pip install django-toolbelt

Abhängigkeiten einfrieren:

$ pip freeze > requirements.txt

Aktualisieren Sie wsgi.py Datei:

from django.core.wsgi import get_wsgi_application
from dj_static import Cling

application = Cling(get_wsgi_application())

Testen Sie Ihre Heroku-Einstellungen lokal:

$ foreman start

Navigieren Sie zu http://localhost:5000/.

Gut aussehen? Lassen Sie uns Amazon S3 zum Laufen bringen.

Amazon S3

Obwohl es hypothetisch möglich ist, statische Dateien in Ihrem Heroku-Repo zu hosten, ist es am besten, einen Drittanbieter-Host zu verwenden, insbesondere wenn Sie eine kundenorientierte Anwendung haben. S3 ist einfach zu verwenden und erfordert nur wenige Änderungen an Ihrer settings.py Datei.

Abhängigkeiten installieren:

$ pip install django-storages
$ pip install boto

Fügen Sie storages hinzu und boto zu Ihren INSTALLED_APPS in „settings.py“

Fügen Sie den folgenden Code am Ende von „settings.py“ hinzu:

# Storage on S3 settings are stored as os.environs to keep settings.py clean
if not DEBUG:
   AWS_STORAGE_BUCKET_NAME = os.environ['AWS_STORAGE_BUCKET_NAME']
   AWS_ACCESS_KEY_ID = os.environ['AWS_ACCESS_KEY_ID']
   AWS_SECRET_ACCESS_KEY = os.environ['AWS_SECRET_ACCESS_KEY']
   STATICFILES_STORAGE = 'storages.backends.s3boto.S3BotoStorage'
   S3_URL = 'http://%s.s3.amazonaws.com/' % AWS_STORAGE_BUCKET_NAME
   STATIC_URL = S3_URL

Die AWS-umgebungsabhängigen Einstellungen werden als Umgebungsvariablen gespeichert. Wir müssen diese also nicht jedes Mal vom Terminal aus festlegen, wenn wir den Entwicklungsserver ausführen, wir können diese in unserer virtuellen Umgebung activate festlegen Skript. Holen Sie sich den Namen des AWS-Buckets, die Zugriffsschlüssel-ID und den geheimen Zugriffsschlüssel von S3. Öffnen Sie myenv/bin/activate und fügen Sie den folgenden Code hinzu (stellen Sie sicher, dass Sie Ihre spezifischen Informationen hinzufügen, die Sie gerade aus S3 gezogen haben):

# S3 deployment info
export AWS_STORAGE_BUCKET_NAME=[YOUR AWS S3 BUCKET NAME]
export AWS_ACCESS_KEY=XXXXXXXXXXXXXXXXXXXX
export AWS_SECRET_ACCESS_KEY=XXXXXXXXXXXXXXXXXXXX

Deaktivieren und reaktivieren Sie Ihre virtuelle Umgebung und starten Sie dann den lokalen Server, um sicherzustellen, dass die Änderungen wirksam werden:

$ foreman start

Beenden Sie den Server und aktualisieren Sie dann die requirements.txt Datei:

$ pip freeze > requirements.txt

Zu Github und Heroku pushen

Lassen Sie uns unsere Dateien auf Github sichern, bevor wir sie an Heroku PUSHen:

$ git add .
$ git commit -m "update project for heroku and S3"
$ git push -u origin master

Erstellen Sie ein Heroku-Projekt/Repo:

$ heroku create <name>

$ git push heroku master

$ heroku config:set AWS_STORAGE_BUCKET_NAME=[YOUR AWS S3 BUCKET NAME]
$ heroku config:set AWS_ACCESS_KEY=XXXXXXXXXXXXXXXXXXXX
$ heroku config:set AWS_SECRET_ACCESS_KEY=XXXXXXXXXXXXXXXXXXXX

$ heroku run python manage.py collectstatic

$ heroku addons:add heroku-postgresql:dev
Adding heroku-postgresql on deploy_django... done, v13 (free)
Attached as HEROKU_POSTGRESQL_COPPER_URL
Database has been created and is available
! This database is empty. If upgrading, you can transfer
! data from another database with pgbackups:restore.
Use `heroku addons:docs heroku-postgresql` to view documentation.
$ heroku pg:promote HEROKU_POSTGRESQL_COPPER_URL
Promoting HEROKU_POSTGRESQL_COPPER_URL to DATABASE_URL... done

$ heroku run python manage.py syncdb

$ heroku addons:add pgbackups

$ pg_dump -h localhost  -Fc library  > db.dump

$ heroku pgbackups:restore DATABASE http://www.example.com/db.dump

ALLOWED_HOSTS = ['[your-project-name].herokuapp.com']

$ heroku open

$ pip install fabric

$ touch fabfile.py

from fabric.api import local

def deploy():
   local('pip freeze > requirements.txt')
   local('git add .')
   print("enter your git commit comment: ")
   comment = raw_input()
   local('git commit -m "%s"' % comment)
   local('git push -u origin master')
   local('heroku maintenance:on')
   local('git push heroku master')
   local('heroku maintenance:off')

$ fab deploy