Поддержка¶
Если у вас есть вопросы о каналах, вам нужна помощь в отладке или техническая поддержка, вы можете обратиться к таким ресурсам сообщества, как:
Канал #django на PySlackers Slack group.
Если у вас есть конкретная ошибка или запрос функции (понятный и выполнимый), пожалуйста, оформите проблему в соответствующем проекте на GitHub.
К сожалению, если вы откроете вопрос на GitHub с неясной проблемой (например, «медленно работает!» или «соединения случайно обрываются!»), мы будем вынуждены закрыть его, поскольку у нас нет добровольцев, чтобы ответить на то количество вопросов, которое мы получим - пожалуйста, обратитесь в одно из других мест выше для получения поддержки от сообщества в целом.
Как правило, ваш вопрос достаточно конкретен для открытия проблемы, если вы можете предоставить точные шаги для воспроизведения в свежем, примерном проекте. Мы должны быть в состоянии воспроизвести это на нормальной, локальной машине разработчика - поэтому говорить, что что-то не работает в размещенной среде, к сожалению, не очень полезно для нас, и мы закроем проблему и направим вас сюда.
Извините, если это прозвучит резко, но, пожалуйста, поймите, что сопровождение и поддержка открытого кода занимает много времени, и если бы мы отвечали на все вопросы и запросы поддержки, не осталось бы времени на работу над самим кодом!
Создание воспроизводимых ошибок¶
Если вы боретесь с проблемой, которая возникает только в производственной среде, и не можете воспроизвести ее локально, чтобы либо вы могли исправить ее, либо кто-то мог вам помочь, используйте пошаговый подход к устранению различий между средами.
Во-первых, попробуйте изменить свое производственное окружение и посмотреть, поможет ли это - например, если между браузерами и каналами стоит Nginx/Apache/etc., попробуйте перейти напрямую к серверу Python и посмотреть, исправит ли это ситуацию. Отключите SSL, если он у вас включен. Попробуйте с разных браузеров и интернет-соединений. WebSockets, как известно, трудно отлаживать, и поэтому следует ожидать некоторого уровня неловкости от любого проекта, связанного с ними.
Затем проверьте версии пакетов в локальной и удаленной средах. Вы удивитесь, как легко забыть обновить что-то!
Когда вы убедитесь, что это не ошибка, попробуйте изменить свой проект. Создайте новый проект Django (или используйте один из примеров проектов Channels) и убедитесь, что в нем нет ошибки, затем работайте над добавлением кода в него из вашего проекта, пока ошибка не появится. В качестве альтернативы, возьмите свой проект и удаляйте части до базового уровня Django, пока он не заработает.
Сетевое программирование также является сложным в целом; вы должны ожидать определенного уровня переподключений и обрывов соединений как нечто само собой разумеющееся. Убедитесь, что то, что вы видите, не является нормальным для производственного приложения.
Как помочь проекту «Каналы¶
Если вы хотите помочь нам с поддержкой, первое, что нужно сделать, это оказать поддержку в сообществах, упомянутых вверху (Stack Overflow и список рассылки).
Если вы также хотите помочь в решении проблем, пожалуйста, свяжитесь с нами и упомяните, что вы хотели бы помочь, и мы сможем убедиться, что вы подготовлены и имеете хорошее представление о том, что нужно делать. Большая часть работы заключается в том, чтобы убедиться, что поступающие проблемы действительно действительны и могут быть приняты, и закрыть те, которые не являются действительными, и перенаправить их на эту страницу, вежливо объяснив причину.
Ниже приведены некоторые образцы шаблонов ответов.
Общий запрос на поддержку¶
Sorry, but we can't help out with general support requests here - the issue tracker is for reproduceable bugs and
concrete feature requests only! Please see our support documentation (http://channels.readthedocs.io/en/latest/support.html)
for more information about where you can get general help.
Неспецифическая ошибка/»Это не работает!».¶
I'm afraid we can't address issues without either direct steps to reproduce, or that only happen in a production
environment, as they may not be problems in the project itself. Our support documentation
(http://channels.readthedocs.io/en/latest/support.html) has details about how to take this sort of problem, diagnose it,
and either fix it yourself, get help from the community, or make it into an actionable issue that we can handle.
Sorry we have to direct you away like this, but we get a lot of support requests every week. If you can reduce the problem
to a clear set of steps to reproduce or an example project that fails in a fresh environment, please re-open the ticket
with that information.
Проблема в коде приложения¶
It looks like a problem in your application code rather than in Channels itself, so I'm going to close the ticket.
If you can trace it down to a problem in Channels itself (with exact steps to reproduce on a fresh or small example
project - see http://channels.readthedocs.io/en/latest/support.html) please re-open the ticket! Thanks.