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

Примечание

Этот плагин входит в коллекцию community.general (версия 2.0.1).

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

Для использования в книге задач укажите: 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–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/community/general/django_manage_module.html