Rollenname

Bauen und Bereitstellen einer Django-Webanwendung (Uwsgi), Aufgabenanwendung (Celery) oder Beat-Anwendung (Celerybeat).

Anforderungen

Ein eingerichteter Ubuntu-Server. Uwsgi erwartet einen WSGI-Proxy über die Nginx-Rolle.

Rollenvariablen

Standardmäßig wird Django gebaut, aber nur die Uwsgi-Webanwendung bereitgestellt.

django_webapp: ja
django_taskapp: nein
django_beatapp: nein
django_monitorapp: nein
django_flowerapp: nein

Verwendet als Standard für virtualenv, lokalen Klon, Datenbankbenutzer/-namen/-passwort, ... Soll alphanumerisch und _ sein, nichts Illegales für Datenbanknamen, Verzeichnisse, ...

django_project_name: django

Das Projekt wird auf {{ django_project_home }}/{{ django_project_name }} geklont.

django_project_home: '{{ ansible_env.HOME }}'

Quellcode-Repo, Branch und Verzeichnisse

django_repo_url: ssh://[email protected]/myawesomeproject
django_repo_version: default
django_repo_type: git
django_local_repo: '{{ django_project_name }}'

Domain und Name (für die Standard-Django-Seite, Nginx usw.)

django_hostname: '{{ hostname }}'
django_project_description: '{{ description }}'

Site-Geheimnis

django_secret_key: 'änderndiesesekretkeyfurechtarget'

Muss mit einer Django-Einstellungen- .py in config/settings übereinstimmen, z.B. 'dev'

django_settings_module: 'config.settings.production'

Pip-Installationsanforderungen

django_pip_requirements: production.txt

Datenbankeinstellungen.

django_db_host: localhost
django_db_user: '{{ django_project_name }}'
django_db_name:  '{{ django_project_name }}'
django_db_password:  '{{ django_project_name }}'
django_db_superuser: postgres
django_db_superpassword: postgres
django_db_locale: en_US.UTF-8

Selten geänderte Einstellungen

django_upstream_hostkey: bitbucket.org ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAQEAubiN81eDcafrgMeLzaFPsw2kNvEcqTKl/VqLat/MaB33pZy0y3rJZtnqwR2qOOvbwKZYKiEO1O6VqNEBxKvJJelCq0dTXWT5pbO2gDXC6h6QDXCaHo6pOHGPUy+YBaGQRGuSusMEASYiWunYN0vCAI8QaXnWMXNMdFP3jHAJH0eDsoiGnLPBlBp4TNm6rYI74nMzgz3B9IikW4WVK+dc8KZJZWYjAuORU3jc1c/NPskD2ASinf8v3xnfXeukU0sJ5N6m5E8VLjObPEO+mN2t/FZTMZLiFqPWc/ALSqnMnnhwrNi2rbfg/rd/IpL8Le3pSBne8+seeFVBoGqzHM9yXw==
django_wsgi_addr: '{{ ansible_lo.ipv4.address }}'
django_wsgi_port: 10000
django_uwsgi_processes: '{{ ansible_processor_cores }}'
django_uwsgi_harakiri: 60

Pfade

django_project_path: '{{ django_project_home }}/{{ django_project_name }}' # normalerweise cdvirtualenv
django_log_path: '{{ django_project_path }}/log'
django_run_path: '{{ django_project_path }}/run'
django_media_root: '{{ django_project_path }}/media'
django_static_root: '{{ django_project_path }}/static'
django_repo_path: '{{ django_project_path }}/{{ django_project_name }}' # hier klonen
django_project_subdir: . # ändern, wenn sich das Django-Projekt unter django_project_path befindet
django_path: '{{ django_repo_path }}/{{ django_project_subdir }}'
django_collectstatic_once: nein # mit whitenoise, muss collectstatic auf allen Webanwendungsinstanzen ausgeführt werden

Standard-Django-Umgebungsvariablen

django_base_settings:
  DJANGO_SETTINGS_MODULE: '{{ django_settings_module }}'
  DJANGO_SECRET_KEY: '{{ django_secret_key }}'
  DATABASE_URL: 'postgres://{{ django_db_user }}:{{ django_db_password }}@{{ django_db_host }}/{{ django_db_name }}'

Zusätzliche Django-Umgebungsvariablen

django_extra_settings:

Normalerweise die Basis-Pakete so lassen, wie sie sind, hinzufügen mit django_extra_apt_packages:

django_base_apt_packages:
    # Unter der Annahme, dass bereits installiert für django_python-Einstellung
    # - python-pip
    # - python3.x
    # - python3.x-dev
    - gettext
    # Datenbank
    - python-psycopg2
    # gemeinsame Abhängigkeiten von:
    # Pillow, pylibmc
    - zlib1g-dev
    # Mysql, Postgresql und psycopg2-Abhängigkeiten
    - libpq-dev
    - libmysqlclient-dev
    # Pillow-Abhängigkeiten
    - libtiff5-dev
    - libjpeg8-dev
    - libfreetype6-dev
    - liblcms2-dev
    - libwebp-dev
    # django-extensions
    - graphviz-dev
    # für wsgi, celery Prozessmanagement
    - supervisor
    # devops-Annehmlichkeit
    - emacs24-nox
    # bis zu einem separaten Server migriert
    - redis-server

django_extra_apt_packages:

Celery-Einstellungen

celery_concurrency: '{{ ansible_processor_cores }}'
celery_numprocs: '{{ ansible_processor_cores }}'
celery_pool_implementation: prefork # prefork (Standard), eventlet, gevent oder solo
celery_beat_schedulers: django_celery_beat.schedulers:DatabaseScheduler

Abhängigkeiten

• rm-software.nginx
• rm-software.python
• rm-software.rabbitmq
• rm-software.redis
• rm-software.virtualenv

plus ein Datenbankserver, separat konfiguriert oder über

• rm-software.postgresql

Beispiel-Playbook

- hosts: appservers
  tasks:
    - import_role:
        name: postgresql
      vars:
        postgresql_install_client: ja
    - import_role:
        name: python
    - import_role:
        name: virtualenv
    - import_role:
        name: django
      vars:
        django_webapp: ja
        django_taskapp: nein
        django_beatapp: nein

Mit dem Großteil der django_-Variablen, die in group_vars gesetzt sind.