community.general.django_manage – Управляет приложением Django.

Примечание

Этот плагин является частью коллекции community.general (версия 1.3.2).

Для его установки используйте: ansible-galaxy collection install community.general.

Для использования в playbook укажите: community.general.django_manage.

Обзор
Требования
Параметры
Примечания
Примеры

Обзор

Управляет приложением Django, используя manage.py интерфейс приложения для django-admin. С параметром virtualenv, все команды управления будут выполняться установкой virtualenv.

Требования

Ниже приведены требования, необходимые на хосте, который выполняет этот модуль.

virtualenv
django

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
apps строка		Список приложений, разделенных пробелами, для обработки. Используется командой `test`.
cache_table строка		Имя таблицы, используемой для кеширования на основе базы данных. Используется командой `createcachetable`.
clear логическое значение	Варианты: нет ← да	Очистить существующие файлы перед копированием или созданием ссылки на исходный файл. Используется только с командой «collectstatic». Аргумент `--noinput` будет добавлен автоматически.
command строка / обязательный		Имя команды управления Django для выполнения. Встроенные команды: `cleanup`, `collectstatic`, `flush`, `loaddata`, `migrate`, `syncdb`, `test`, и `validate`. Другие команды могут быть введены, но они завершатся ошибкой, если они неизвестны Django. Другие команды, которые могут запросить ввод пользователя, должны быть выполнены со флагом `--noinput`. Модуль выполнит базовую проверку параметров (применимо) для команд `cleanup`, `collectstatic`, `createcachetable`, `flush`, `loaddata`, `migrate`, `syncdb`, `test`, и `validate`.
database строка		База данных для обработки. Используется командами `createcachetable`, `flush`, `loaddata`, `syncdb`, и `migrate`.
failfast логическое значение	Варианты: нет ← да	Немедленно завершить команду, если тест завершится ошибкой. Используется командой `test`. псевдонимы: fail_fast
fixtures строка		Список файлов фикстур, разделенных пробелами, которые необходимо загрузить в базу данных. Обязательно для команды `loaddata`.
link логическое значение	Варианты: нет да	Создаст ссылки на файлы вместо копирования, может использоваться только с командой `collectstatic`.
liveserver строка		Этот параметр был реализован давно. Вероятно, он относится к пакету django-liveserver, который больше не обновляется. Следовательно, он будет считаться устаревшим и должен быть удален в будущей версии. псевдонимы: live_server
merge логическое значение	Варианты: нет да	Выполнит миграции в неправильном порядке или отсутствующие миграции, так как они не являются откатными миграциями. Используется только с командой `migrate`.
project_path путь / обязательный		Путь к корню приложения Django, где находится manage.py. псевдонимы: app_path, chdir
pythonpath путь		Директория для добавления в путь Python. Обычно используется для включения модуля настроек, если он находится вне каталога приложения. псевдонимы: python_path
settings путь		Путь Python к модулю настроек приложения, например, `myapp.settings`.
skip логическое значение	Варианты: нет да	Пропустит миграции в неправильном порядке или отсутствующие миграции. Используется только с командой `migrate`.
testrunner строка		Из документации Django: Управляет классом исполнителя тестов, используемым для запуска тестов. Этот параметр передаётся в `manage.py` в неизменном виде. псевдонимы: test_runner
virtualenv путь		Необязательный путь к установке virtualenv, которую нужно использовать при запуске приложения manage. псевдонимы: virtual_env

Примечания

Примечание

virtualenv (http://www.virtualenv.org) должен быть установлен на удалённом хосте, если указан параметр virtualenv.
Этот модуль создаст virtualenv, если параметр virtualenv указан, а virtualenv ещё не существует по заданному пути.
Этот модуль предполагает использование английских сообщений об ошибках для команды createcachetable для обнаружения существования таблицы, к сожалению.
Для использования команды migrate с версиями django < 1.7, необходимо установить south и добавить его как приложение в ваши настройки.
Для использования команды collectstatic необходимо включить staticfiles в ваших настройках.
Ваше приложение manage.py должно быть исполняемым (rwxr-xr-x) и иметь допустимый shebang, например, #!/usr/bin/env python, для вызова соответствующего интерпретатора Python.

Примеры

- name: Run cleanup on the application installed in django_dir
  community.general.django_manage:
    command: cleanup
    project_path: "{{ django_dir }}"

- name: Load the initial_data fixture into the application
  community.general.django_manage:
    command: loaddata
    project_path: "{{ django_dir }}"
    fixtures: "{{ initial_data }}"

- name: Run syncdb on the application
  community.general.django_manage:
    command: syncdb
    project_path: "{{ django_dir }}"
    settings: "{{ settings_app_name }}"
    pythonpath: "{{ settings_dir }}"
    virtualenv: "{{ virtualenv_dir }}"

- name: Run the SmokeTest test case from the main app. Useful for testing deploys
  community.general.django_manage:
    command: test
    project_path: "{{ django_dir }}"
    apps: main.SmokeTest

- name: Create an initial superuser
  community.general.django_manage:
    command: "createsuperuser --noinput --username=admin --email=admin@example.com"
    project_path: "{{ django_dir }}"

Авторы

Scott Anderson (@tastychutney)

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/community/general/django_manage_module.html