Django

Dalam sesi ini, kita akan bahas tentang penyetelan untuk kerangka kerja Django.

Table of Contents Arsitektur Memulai Project Aplikasi Cara Kerja Setting URL Router Web Gateway Static URL Gambar File js/css Templates Konfigurasi Core init.py manage.py Setelan urls.py wsgi.py settings.py Penerapan views.py models.py migrate.py Referensi

Arsitektur

• Tutorial Django
  
• DJANGO_SETTINGS_MODULE
  

Memulai

• Django admin and manage.py
  
• Python 'Virtual-Env' works to run Saleor on Cygwin
  

$ source virtual-env/bin/activate
(virtual-env)$ pip install Django
(virtual-env)$ python -m django --version
2.2
(virtual-env)$ export DJANGO_SETTINGS_MODULE=mysite.settings
(virtual-env)$ django-admin help
Type 'django-admin help <subcommand>' for help on a specific subcommand.
Available subcommands:
[django]
    check
    compilemessages
    createcachetable
    dbshell
    diffsettings
    dumpdata
    flush
    inspectdb
    loaddata
    makemessages
    makemigrations
    migrate
    runserver
    sendtestemail
    shell
    showmigrations
    sqlflush
    sqlmigrate
    sqlsequencereset
    squashmigrations
    startapp
    startproject
    test
    testserver

Project

• Start project
  

(virtual-env)$ django-admin startproject saleor
saleor/
    manage.py
    saleor/
        __init__.py
        settings.py
        urls.py
        wsgi.py
    static/
    templates/

file	mapping	dokumentasi
saleor/	fork directory / branch directory / virtual-env	saleor
manage.py	set("DJANGO_SETTINGS_MODULE", "saleor.settings") from django.core.management import execute_from_command_line	Arsitektur
saleor/__init__.py	from .celeryconf import app as celery_app	Celery
saleor/settings.py	ROOT_URLCONF = 'saleor.urls' WSGI_APPLICATION = 'saleor.wsgi.application'	Setting
saleor/urls.py	from django.conf import settings	URL-Router
saleor/wsgi.py	from django.core.wsgi import get_wsgi_application	Web-Gateway
static/ media/	STATICFILES_STORAGE / DEFAULT_FILE_STORAGE django.contrib.staticfiles.storage.StaticFilesStorage django.core.files.storage.FileSystemStorage	Static URL
templates/	templates directory	Templates

Aplikasi

• Database setup
  

(virtual-env)$ cd saleor 
(virtual-env)$ python manage.py runserver
(virtual-env)$ python manage.py startapp products
saleor/
    manage.py
    saleor/
        products/
            migrations/
                __init__.py
            models.py
            tests.py
            views.py        
        __init__.py
        settings.py
        urls.py
        wsgi.py
    static/
    templates/
        products/

Cara Kerja

• Settings
  

Setting

• Django settings
• Django ALLOWED_HOSTS IPs range

URL Router

• URL dispatcher
  

Untuk pemetaan URL aplikasi, Django membuat modul Python yang disebut URLconf (konfigurasi URL). Modul ini merupakan mapping antara ekspresi jalur URL ke fungsi Python (views).

implementasi

file	mapping	dokumentasi
saleor/urls.py	from django.conf import settings	Configuration

Web Gateway

Static URL

• Serving static files in Django

Gambar

SCRIPT_NAME=/market
MEDIA_URL=/market/media/
STATIC_URL=/market/static/

File js/css

Webpack digunakan untuk mengkompilasi modul JavaScript. Setelah diinstal, Anda dapat berinteraksi dengan baik dari CLI atau API-nya.

Templates

Secara detil setiap page di atas diproduksi seperti berikut

Konfigurasi

Core

init.py

manage.py

#!/usr/bin/env python
"""Django's command-line utility for administrative tasks."""
import os
import sys


def main():
    os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'dummy.settings')
    try:
        from django.core.management import execute_from_command_line
    except ImportError as exc:
        raise ImportError(
            "Couldn't import Django. Are you sure it's installed and "
            "available on your PYTHONPATH environment variable? Did you "
            "forget to activate a virtual environment?"
        ) from exc
    execute_from_command_line(sys.argv)


if __name__ == '__main__':
    main()

Setelan

urls.py

• Django url debugger

urlpatterns = non_translatable_urlpatterns + i18n_patterns(
    *translatable_urlpatterns)

if settings.DEBUG:
    import debug_toolbar
    urlpatterns += [
        url(r'^__debug__/', include(debug_toolbar.urls)),
        # static files (images, css, javascript, etc.)
        url(r'^static/(?P<path>.*)$', serve)] + static(
            '/media/', document_root=settings.MEDIA_ROOT)

Anda dapat mengasumsikan, bahwa request melewati urlpatterns dari atas ke bawah dengan pola yang pertama yang cocok (Y) akan dieksekusi seperti analogi berikut:

• jika Y sebelum X: maka pola Y akan dieksekusi (tetapi tidak selalu seharusnya)
• jika X adalah sebelum Y: pola X tidak cocok dengan url (tetapi harus didahulukan)

wsgi.py

• How to deploy with WSGI
  
• How to use Django with Gunicorn
  

Web Server Gateway Interface (WSGI) adalah konvensi untuk meneruskan URL ke aplikasi web atau kerangka kerja yang ditulis dalam bahasa pemrograman Python.

Untuk project saleor pengembang menggunakan uwsgi yang disetel fia Dockerfile:

CMD ["uwsgi", "--ini", "/app/saleor/wsgi/uwsgi.ini"]

Untuk pemasangan di GCP maka sesuai arahan kita pakai gunicorn via entry di app.yaml:

entrypoint: gunicorn -b :$PORT saleor.wsgi --timeout 120

Pembahasan lebih lanjut silahkan simak di sesi Gunicorn.

settings.py

• saleor.core.storages.S3MediaStorage
• storages.backends.s3boto3.S3Boto3Storage

Untuk file static/media sesuai requirements.txt Aplikasi Saleor menggunakan django-storages: versi 1.7.1 disetel di settings.py ke AWS Storage via migrasi boto3 library sebagai berikut:

if AWS_STORAGE_BUCKET_NAME:
    STATICFILES_STORAGE = 'storages.backends.s3boto3.S3Boto3Storage'

if AWS_MEDIA_BUCKET_NAME:
    DEFAULT_FILE_STORAGE = 'saleor.core.storages.S3MediaStorage'
    THUMBNAIL_DEFAULT_STORAGE = DEFAULT_FILE_STORAGE

Pembahasan lebih lanjut silahkan simak di sesi setelan GCP Storage.

Penerapan

views.py

models.py

migrate.py

Referensi

• WSGI master