django_manage – Управляет приложением Django
Описание
- Управляет приложением Django с помощью командного интерфейса manage.py, обращаясь к django-admin. С параметром virtualenv все управляющие команды будут выполняться с использованием указанной установки virtualenv.
Требования
Ниже перечислены требования к хосту, на котором выполняется данный модуль.
- virtualenv
- django
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| app_path - / обязательно | Путь к корню приложения Django, где находится manage.py. | |
| apps - | Список приложений, разделенных пробелами. Используется командой 'test'. | |
| cache_table - | Имя таблицы, используемой для кэширования на основе базы данных. Используется командой 'createcachetable'. | |
| clear boolean |
| Очистить существующие файлы перед копированием или связыванием исходного файла. Используется только с командой 'collectstatic'. Аргумент --noinput будет добавлен автоматически. |
| command - / обязательно |
| Имя команды управления Django, которую нужно запустить. Встроенные команды: cleanup, collectstatic, flush, loaddata, migrate, runfcgi, syncdb, test и validate. Можно ввести другие команды, но они завершатся с ошибкой, если неизвестны Django. Другие команды, которые могут запросить ввод от пользователя, следует запускать с флагом --noinput. |
| database - | База данных, на которую нужно нацелиться. Используется командами 'createcachetable', 'flush', 'loaddata' и 'syncdb'. | |
| failfast boolean |
| Немедленно завершить команду, если тест завершится неудачно. Используется командой 'test'. |
| fixtures - | Список фикстурных файлов, разделенных пробелами, которые нужно загрузить в базу данных. Обязательно для команды 'loaddata'. | |
| link boolean |
| Создаст ссылки на файлы вместо копирования. Можно использовать только с командой 'collectstatic'. |
| merge boolean |
| Выполнит миграции в неправильном порядке или отсутствующие, так как это не отменяющие миграции. Можно использовать только с командой 'migrate'. |
| pythonpath - | Директория, которая будет добавлена в путь Python. Обычно используется для включения модуля настроек, если он расположен вне каталога приложения. | |
| settings - | Путь Python к модулю настроек приложения, например, 'myapp.settings'. | |
| skip boolean |
| Пропустит миграции, находящиеся вне порядка или отсутствующие. Можно использовать только с командой 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 }}"
Статус
- Этот модуль не гарантирует обратную совместимость интерфейса. [превью]
- Этот модуль поддерживается сообществом Ansible. [сообщество]
Авторы
- 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.8/modules/django_manage_module.html