• Tutorial
    • Create a new project
      • Set up a project in the Cloud
        • Create your account
        • Create the project
        • Deploy the project
        • Log in to the project
      • About deployment
      • Explore the Dashboard
    • Set up the local development environment
      • Why does local development environment matter?
      • Before you start
      • Install the Divio CLI package
      • Log in
      • Add your public SSH key to the Control Panel
      • Install Docker and Docker Compose
        • Additional checklist for Docker installation on Windows
    • Set up your project locally
      • Build the project locally
      • Start the local project
      • Useful commands
        • Using divio
        • Using docker-compose
        • Using docker
    • Make changes and deploy them
      • Install a package
        • Configure the Django settings
      • Run migrations
      • Check the project
      • Deploy to the cloud
      • Using divio project push/pull
      • Where to go next?
    • Configure a more complex application
      • Add django-debug-toolbar to requirements.in
      • Configure settings.py
        • Configure INSTALLED_APPS
        • Configure middleware settings
        • Triggering the toolbar
      • Configure urls.py
      • See the results
  • How-to guides
    • Working in the local development environment
      • Get started with the Divio CLI
        • Pre-requisites
        • Install the CLI
        • Log in using the CLI
        • Add your public key to the Control Panel
        • Usage
      • Run the local server in Live mode
        • Build the project
        • Disable the volumes behaviour in docker-compose.yml (optional)
        • Turn off Django DEBUG mode
        • Collect static files
        • Run the migrate command
        • Use the production web server
    • Building your Docker application
      • Manage a project's base image
        • Choose a base image
        • Specify the base image in the Dockerfile
        • Caveats
      • Install system packages
    • Adding new functionality to a project
      • Set up Sass CSS compilation
        • What we want to do
        • Building this into the Dockerfile
        • Further frontend development
        • Using Boilerplates for quicker project creation
      • Configure Application Performance Monitoring
        • Set up the APM instance
        • Install and configure the Divio Telemetry addon
        • Check the results
      • Configure media serving on a custom domain
        • Set up the reverse proxy project
        • Configure media storage URLs in the application project
        • Caveats
    • Platform-specific guides
      • Python
        • Install Python dependencies
        • Pin all of your project's Python dependencies
      • Django
        • Add a Django application
        • Configure Django settings
        • Migrate an existing Django project to Divio
        • Create a multi-site Django project using Mirrors
        • Configure external logging
        • Configure Celery
        • Manage access authentication
        • Manage redirects in Django projects
        • Log in to a local Django project
        • Go-live checklist for Django projects
      • Node.js
        • Force HTTPS with Express.js
    • The development pipeline
      • Configure external Git hosting
        • Prepare the external Git repository
        • Add the Git repository URL to the Control Panel
        • Add your project’s public key to the Git host
        • Test access
        • Configure a webhook for the Git repository
        • Using the external Git remote
        • Options and special cases
        • Errors and what they mean
      • Use Git to manage your project
        • Important limitations
        • Git with the Divio app or Divio shell
        • Basic Git operations
      • Set up CI/CD
        • The basic principles
        • An example using Travis CI
        • Using the deployment API directly
        • Caveats
      • Use our API
        • Create a Divio account for use with the API
        • Connecting to the API
        • Basic requests
    • Managing a project’s resources
      • Interact with your project’s database
        • Interact with the local database
        • Interact with the Cloud database
        • Change the local database engine version
        • Usage examples for common basic operations
      • Interact with your project’s cloud media storage
        • Interact with your project’s cloud S3 storage
        • Use the Divio CLI for local access to Cloud storage
        • Storage ACLs (Access Control Lists)
    • Working with addons
      • Package an application as an addon
        • Register the addon
        • Add the packaging files
        • Add configuration
        • Check the addon
        • Upload the addon
      • Update an existing addon
        • Choose a local project to work with
        • Uninstall the addon locally if necessary
        • Clone the addon repository to addons-dev
        • Run divio project develop
        • Work on the code
        • Push your changes
        • Upload the new addon version
        • Test it on the Control Panel
        • Place the new version in the appropriate channel
    • Configuring uWSGI
      • Manage uWSGI configuration
        • uWSGI environment variables
        • More complex configuration
      • Fine-tune uWSGI server performance
        • Monitoring and profiling
        • Aldryn Django settings
    • Troubleshooting
      • Debug cloud deployment problems
        • Debugging checklist
        • Decision tree
      • Identify and resolve a Python dependency conflict
        • Identify the conflict
        • Identify the problem requirement
        • Identify where the requirement comes from
        • Repeat the process
        • How to prevent this from happening again
      • Get help when you have a problem
        • Grant support access
        • Provide key information
        • Template
        • Example report
        • Ensure that we have access to your project
        • What we can and can’t help with
  • Technical reference
    • Divio software components
      • The Divio application
        • Controls
        • First run
        • The Divio Shell
      • Divio CLI
        • divio-cli command reference
      • The Cloud and local shells
        • Using a Cloud shell
        • The local shell
      • The .aldryn file
    • Docker commands and configuration
      • Docker commands
        • The docker-compose command
        • The docker command
      • The Dockerfile
        • How the Dockerfile is automatically populated
      • The docker-compose.yml file
        • Function of docker-compose.yml
        • Services defined in docker-compose.yml
    • Python/Django application configuration
      • The settings.py file
        • INSTALLED_ADDONS
        • Automatic settings loading
      • Environment variables
        • Cloud (Live and Test) environments
        • Local environment
        • Environment variables and Django settings
        • Where and when environment variables are applied
        • Commonly-used environment variables
    • Coding in Divio applications
      • Working with your project’s media storage
        • Introduction
        • Working with our storage backends in Django
        • Loading media files into your applications’ pages
        • Storage speed and performance
      • File compression
        • Default behaviour in our projects
        • Using Django Compressor
      • Sending email
        • Configuration
        • Usage, testing and troubleshooting
    • Addons
      • Addon configuration with aldryn_config.py
        • The aldryn_config.py file
        • Managing settings
        • Adding form fields for user-configuration of the Addon
        • Custom field validation
        • What configuration method to provide?
      • Aldryn Django (core Django)
        • Control Panel options
        • Environment variable/settings.py options
      • Aldryn SSO (authentication)
        • Login methods
        • Test site protection
        • Aldryn SSO configuration options
      • Aldryn Addons (addon integration)
        • Aldryn Addons configuration options
    • Quick reference
      • Local commands cheatsheet
        • Project resource management
        • Running the local server
        • Working inside the containerised environment
        • Docker management
  • Background information
    • Our infrastructure
      • Overview
        • Cloud infrastructure
        • Local development environment
      • Docker basics
        • Docker on Macintosh and Windows
        • Key components
        • Glossary
      • IP addresses
        • Load-balancer IP addresses
        • Implications for customer projects
        • Other options
        • IPv6 support
    • Services
      • Service management (Beta)
        • Service management via the Control Panel
      • Available services
        • Database
        • Media object storage
        • Elasticsearch
        • RabbitMQ
    • How it works on Divio
      • HTTP redirects
        • Protocol redirects
        • 301 Permanent vs 302 Temporary redirects
      • Caching
        • Infrastructure-level caching
        • Application-level caching
      • Python package installation
        • Selective execution of commands
        • Summary of commands
        • Our wheels proxy
        • Caching
    • Projects
      • Project creation options
        • Platform
        • Type
        • Boilerplate
        • Git repository manager
      • Anatomy of a Divio project
        • Dockerfile
        • Local development files
        • Aldryn Addons directories
      • The project deployment process
        • Deployment steps
        • Zero-downtime cloud deployments
        • Differences between cloud deployment and local builds
        • Notes on Docker image building
      • Project environments
        • Default project conditions
      • Version control
        • All commits target the Test environment
        • Project repository branches
        • Custom Tracking Branches
      • Boilerplates
        • Boilerplates
        • Our built-in Boilerplates
        • How Boilerplates work
      • Multi-site projects on Divio
        • Using Mirrors
        • DIY implementation (for Django sites only)
        • Logging in to multi-site instances
        • Switching between sites in a local multi-site project
    • Django addons
      • What are addons, and why use them?
        • What are Divio addons?
        • Using addons is optional
        • Why use addons?
      • Anatomy of a Divio addon
        • Basic file structure
        • aldryn_config.py
        • addon.json
        • setup.py
      • How settings are handled in Django addons
        • Via addon settings in the Control Panel
        • Via environment variables
        • Manually in settings.py
      • Django addons and templates
        • On initial project creation
        • Subsequent addon updates
Developer Handbook
Divio
  • Docs  » 
  • How-to guides

How-to guides¶

Working in the local development environment¶

  • Get started with the Divio CLI
  • Run the local server in Live mode

Building your Docker application¶

  • Manage a project's base image
  • Install system packages

Adding new functionality to a project¶

  • Set up Sass CSS compilation
  • Configure Application Performance Monitoring
  • Configure media serving on a custom domain

Platform-specific guides¶

Python Django Node.js

Python¶

  • Install Python dependencies
  • Pin all of your project's Python dependencies

Django¶

  • Add a Django application
  • Configure Django settings
  • Migrate an existing Django project to Divio
  • Create a multi-site Django project using Mirrors
  • Configure external logging
  • Configure Celery
  • Manage access authentication
  • Manage redirects in Django projects
  • Log in to a local Django project
  • Go-live checklist for Django projects

Node.js¶

  • Force HTTPS with Express.js

The development pipeline¶

  • Configure external Git hosting
  • Use Git to manage your project
  • Set up CI/CD
  • Use our API

Managing a project’s resources¶

  • Interact with your project’s database
  • Interact with your project’s cloud media storage

Working with addons¶

  • Package an application as an addon
  • Update an existing addon

'' Configuring uWSGI¶

  • Manage uWSGI configuration
  • Fine-tune uWSGI server performance

Troubleshooting¶

  • Debug cloud deployment problems
  • Identify and resolve a Python dependency conflict
  • Get help when you have a problem
Next Previous

© Copyright 2017-2020, Divio AG. Revision 1094d31d.

Edit on GitHub

Documentation v: latest
Versions
latest
rewrite-tutorial
our-pip-system
flavours
Downloads
pdf
html