django-cloud-deployer 1.0.2

Hybrid cloud deployment (IaaS/PaaS and FaaS) of Django web applications.

Django Cloud Deployer

This package facilitates hybrid cloud deployment (IaaS/PaaS and FaaS) of Django web applications. By annotating project urls with the plugin's wrapper functions, a developer can indicate in which cloud deployment model each url resource should be executed.

Requirements

To use this package, you will need the following Software tools:

• Git
• npm
• Serverless Framework CLI

You will also need the CLI tools of the cloud providers you will be using:

• Heroku CLI
• Azure CLI

Setup

First, install the package:

pip install django-cloud-deployer

Then, make sure to add the package (and its requirements) to your project's requirements file:

pip freeze > requirements.txt

Usage

The package features two functions, runInPaaS and runInFaaS, that may be used to indicate in which cloud deployment model (PaaS or FaaS, respectively) a url resource should be executed.

Example:

# urls.py

from django.urls import include, path
from django_cloud_deployer import runInPaaS, runInFaaS
from . import views

urlpatterns = [
    path('', views.home, name='home'),
    runInPaaS(path('faq/', views.faq, name='faq')),
    runInPaaS(path('polls/', include('polls.urls'))),
    runInFaaS(path('auth/', include('auth.urls'))),
]

Note that, by default, url resources with run in FaaS.

CLI tool

The package may be used as a CLI tool:

$ python -m django_cloud_deployer

Usage: django_cloud_deployer <operation> 

Available operations:
- deploy 
- check_deploy
- destroy 

Check Deploy

The check_deploy command allows the developer to observe, based on the annotated urls, where each resource will be deployed and executed.

Usage:

$ python -m django_cloud_deployer check_deploy

Example:

$ python -m django_cloud_deployer check_deploy

Please enter the name of the Django settings module (e.g., 'mysite.settings'):
> mysite.settings

The following urls will run in the FaaS provider:
^/?$
^auth/login/?$
^auth/logout/?$

The following urls will run in the PaaS provider:
^polls/?$
^polls/(?P<pk>[0-9]+)/?$
^polls/(?P<pk>[0-9]+)/results/?$
^polls/(?P<question_id>[0-9]+)/vote/?$

Deploy

The deploy command allows the developer to deploy the django project, based on the annotated urls.

Usage:

$ python -m django_cloud_deployer deploy <paas provider> <faas provider>

Available PaaS providers:
- heroku
Available FaaS providers:
- azure

Note that you will need to be logged in to the chosen PaaS and FaaS providers CLIs. If you are not, you will be asked to login first.

After the deployment is completed, a django_cloud_deployer.json configuration file will be produced:

{
        "projectName": "...",
        "paasConfig": {
            "provider": "...",
            "resource": "...",
            "url": "..."
        },
        "faasConfig": {
            "provider": "...",
            "resource": "...",
            "url": "..."
        }
}

Destroy

The destroy command allows the developer to delete all the infrastructure resources created with the deployment of the Django project.

Usage:

$ python -m django_cloud_deployer destroy