django_manage — Управляет приложением Django.
Обзор
- Управляет приложением Django с помощью интерфейса командной строки manage.py, который обращается к django-admin. С параметром virtualenv все команды управления будут выполняться с указанной установкой virtualenv.
Требования
Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.
- virtualenv
- django
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| app_path обязательно | Путь к корню приложения Django, где находится manage.py. | |
| apps | Список приложений, разделенных пробелами, для обработки. Используется командой 'test'. | |
| cache_table | Имя таблицы, используемой для кэширования на основе базы данных. Используется командой 'createcachetable'. | |
| command обязательно |
| Имя команды управления Django для выполнения. Встроенные команды: cleanup, collectstatic, flush, loaddata, migrate, runfcgi, syncdb, test и validate. Можно ввести другие команды, но они завершатся ошибкой, если не известны Django. Другие команды, которые могут запросить ввод пользователя, должны запускаться с флагом --noinput. |
| database | База данных для обработки. Используется командами 'createcachetable', 'flush', 'loaddata' и 'syncdb'. | |
| failfast |
| Немедленно прервать команду, если тест завершится ошибкой. Используется командой 'test'. |
| fixtures | Список файлов фикстур, разделенных пробелами, которые нужно загрузить в базу данных. Требуется командой 'loaddata'. | |
| link (добавлен в 1.3) | Создает ссылки на файлы вместо их копирования. Можно использовать только с командой 'collectstatic'. | |
| merge (добавлен в 1.3) | Выполняет миграции, которые находятся не в порядке или отсутствуют, так как это не миграции отката. Можно использовать только с командой 'migrate'. | |
| pythonpath | Директория для добавления в путь Python. Обычно используется для включения модуля настроек, если он расположен вне каталога приложения. | |
| settings | Путь Python к модулю настроек приложения, например, 'myapp.settings'. | |
| skip (добавлен в 1.3) | Пропускает не расположенные в порядке или отсутствующие миграции. Можно использовать только с командой migrate
| |
| virtualenv | Необязательный путь к установке virtualenv, которую следует использовать при работе с приложением manage. псевдонимы: virtualenv |
Примечания
Примечание
- virtualenv (http://www.virtualenv.org) должен быть установлен на удаленном хосте, если указан параметр virtualenv.
- Этот модуль создаст virtualenv, если параметр virtualenv указан и virtualenv еще не существует по указанному пути.
- Этот модуль предполагает сообщения об ошибках на английском языке для команды 'createcachetable' для обнаружения существования таблицы, к сожалению.
- Для использования команды migrate с версиями django < 1.7 необходимо установить south и добавить его как приложение в ваши настройки.
- Для использования команды collectstatic необходимо включить staticfiles в ваших настройках.
- Начиная с Ansible 2.x, ваше приложение manage.py должно быть исполняемым (rwxr-xr-x) и иметь допустимый shebang, например, “#!/usr/bin/env python”, для вызова соответствующего интерпретатора Python.
Примеры
# Run cleanup on the application installed in 'django_dir'.
- django_manage:
command: cleanup
app_path: "{{ django_dir }}"
# Load the initial_data fixture into the application
- django_manage:
command: loaddata
app_path: "{{ django_dir }}"
fixtures: "{{ initial_data }}"
# Run syncdb on the application
- django_manage:
command: syncdb
app_path: "{{ django_dir }}"
settings: "{{ settings_app_name }}"
pythonpath: "{{ settings_dir }}"
virtualenv: "{{ virtualenv_dir }}"
# Run the SmokeTest test case from the main app. Useful for testing deploys.
- django_manage:
command: test
app_path: "{{ django_dir }}"
apps: main.SmokeTest
# Create an initial superuser.
- django_manage:
command: "createsuperuser --noinput --username=admin --email=admin@example.com"
app_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.5/modules/django_manage_module.html