Nombre del rol

Construir y desplegar una aplicación web de Django (Uwsgi), tarea (Celery) o beat (Celerybeat).

Requisitos

Un servidor Ubuntu configurado. Uwsgi espera un proxy wsgi a través del rol de nginx.

Variables del rol

Por defecto se construye Django, pero solo se despliega la aplicación web en uwsgi.

django_webapp: sí
django_taskapp: no
django_beatapp: no
django_monitorapp: no
django_flowerapp: no

Usado como valor por defecto para el entorno virtual, clon local, usuario/nombre/contraseña de la base de datos, etc. Debe ser alfanumérico y contener _, nada ilegal para nombres de bases de datos, directorios, etc.

django_project_name: django

El proyecto se clonará en {{ django_project_home }}/{{ django_project_name }}

django_project_home: '{{ ansible_env.HOME }}'

Repositorio del código fuente, rama y directorios.

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

Dominio y nombre (para el sitio por defecto de Django, nginx, etc.)

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

Secreto del sitio

django_secret_key: 'cambiar_estos_secretos_por_cada_objetivo'

Debe coincidir con un settings .py de Django en config/settings, por ejemplo, 'dev'

django_settings_module: 'config.settings.production'

Requerimientos de instalación de pip.

django_pip_requirements: production.txt

Configuraciones de la base de datos.

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

Configuraciones que rara vez cambian.

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

Rutas

django_project_path: '{{ django_project_home }}/{{ django_project_name }}' # usualmente 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 }}' # clonar aquí
django_project_subdir: . # cambiar si el proyecto de django está bajo django_project_path
django_path: '{{ django_repo_path }}/{{ django_project_subdir }}'
django_collectstatic_once: no # con whitenoise, debe ejecutar collectstatic en todas las instancias de la aplicación web

Variables estándar de configuración del entorno de Django

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 }}'

Variables adicionales de configuración del entorno de Django

django_extra_settings:

Normalmente se dejan los paquetes base tal como están, se pueden agregar con django_extra_apt_packages:

django_base_apt_packages:
    # Asumir que ya están instalados para la configuración de django_python
    # - python-pip
    # - python3.x
    # - python3.x-dev
    - gettext
    # base de datos
    - python-psycopg2
    # dependencias compartidas de:
    # Pillow, pylibmc
    - zlib1g-dev
    # Mysql, dependencias de Postgresql y psycopg2
    - libpq-dev
    - libmysqlclient-dev
    # dependencias de Pillow
    - libtiff5-dev
    - libjpeg8-dev
    - libfreetype6-dev
    - liblcms2-dev
    - libwebp-dev
    # django-extensions
    - graphviz-dev
    # para wsgi, gestión de procesos de celery
    - supervisor
    # conveniencia para DevOps
    - emacs24-nox
    # hasta que se migre a un servidor separado
    - redis-server

django_extra_apt_packages:

Configuraciones de Celery

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

Dependencias

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

más un servidor de base de datos, configurado por separado o a través de

• rm-software.postgresql

Ejemplo de Playbook

- hosts: appservers
  tasks:
    - import_role:
        name: postgresql
      vars:
        postgresql_install_client: sí
    - import_role:
        name: python
    - import_role:
        name: virtualenv
    - import_role:
        name: django
      vars:
        django_webapp: sí
        django_taskapp: no
        django_beatapp: no

Con la mayoría de las variables django_ configuradas en group_vars.