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