{"componentChunkName":"component---src-templates-post-jsx","path":"/017-debug-django-with-docker-vs-code/","result":{"data":{"markdownRemark":{"html":"
    \n
  1. Install ptvsd as a dev dependency. The latest version at the time of writing is 4.3.2, but\ncheck it here.
    2. \n
  2. Add an environment variable to control enabling ptvsd. I opted for using VSCODE_DEBUGGER as\npart of our docker-compose env-file.
    3. \n
  3. Connect the ptvsd server in your manage.py. I do this just before the standard call to\nexecute_from_command_line(sys.argv), like so:
    4. \n
\n
  \"\"\"\n  Django runs twice to support live-reloading! In order to support live-reloading files and\n  attaching to the correct process, we use a bit of Django's internals to check if we need to\n  start up our debugger.\n\n  See:\n  - https://github.com/django/django/blob/master/django/utils/autoreload.py#L26\n  - https://ytec.nl/blog/debugging-django-vscode-without-using-noreload/\n  \"\"\"\n  if (os.environ.get(\"RUN_MAIN\") or os.environ.get(\"WERKZEUG_RUN_MAIN\")) and os.environ.get(\n      \"VSCODE_DEBUGGER\", False\n  ):\n      import ptvsd  # noqa\n\n      ptvsd_port = 4000\n\n      try:\n          ptvsd.enable_attach(address=(\"0.0.0.0\", ptvsd_port), redirect_output=True)\n          print(\"Started ptvsd at port %s.\" % ptvsd_port)\n      except OSError:\n          print(\"ptvsd port %s already in use.\" % ptvsd_port)
\n
    \n
  1. Expose the port for the ptvsd server. With docker-compose, you can add the port to the port\nmappings section, like so:
    2. \n
\n
version: "3"\nservices:\n  ... # Redacted for simplicity!\n\n  # Django application\n  app:\n    ... # Redacted for simplicity!\n    ports:\n      - "8000:8000" # django application portundefined you probably already have this\n      - "4000:4000" # ptvsd port for debugging
\n
    \n
  1. \n

    Set up the configuration for VS Code in .vscode/launch.json. You'll probably need to tweak the\nremoteRoot configuration. Note that I've opted to use port 4000, as it doesn't conflict with my\nnormal port usage.

    \n
    {\n \"version\": \"0.2.0\",\n \"configurations\": [\n   {\n     \"name\": \"[django:docker] runserver\",\n     \"type\": \"python\",\n     \"request\": \"attach\",\n     \"pathMappings\": [\n       {\n         \"localRoot\": \"${workspaceFolder}\",\n         \"remoteRoot\": \"/app\"\n       }\n     ],\n     \"port\": 4000,\n     \"host\": \"localhost\"\n   }\n ]\n}
    \n
    2. \n
  2. Document it! Here's a starter snippet for your README:
    3. \n
\n
## Debugging with Docker and VSCode\n\nSupport for debugging remotely if you're running with Docker is supported out-of-the-box.\n\nTo debug with Docker:\n\n1. Set the `VSCODE_DEBUGGER` value to `True` in your docker.local.env\n\n2. Rebuild and run your Docker containers as usual: `docker-compose up --build`\n\n3. Start the debug session from VS Code for the `[django:docker] runserver` configuration\n\n   1. Open up the debugger by by pressing `⌘-⇧-d`, or using the Command Palette and selecting\n      `View: Show Run and Debug`.\n\n   2. Select `[django:docker] runserver` from the dropdown near the Play button in the top left.\n\n   3. Hit the Play button or hit `F5` to start debugging\n\n      - Logs will redirect to your integrated terminal as well.\n\n4. Set some breakpoints!\n\n   - You can create a breakpoint by clicking to the left of a line number. When that code is\n     executed, the debugger will pause code execution so you can inspect the call stack and\n     variables. You can either resume code execution or manage code execution manually by stepping\n     into the next pieces of code, or over them.
","timeToRead":2,"excerpt":"Install as a dev dependency. The latest version at the time of writing is 4.3.2, but\ncheck it here. Add an environment variable to control…","frontmatter":{"title":"Adding Debug Support to Django with Docker and VS Code","cover":"https://images.unsplash.com/photo-1580792442187-93e20f48fa5a?ixlib=rb-1.2.1&ixid=eyJhcHBfaWQiOjEyMDd9&auto=format&fit=crop&w=1650&q=80","date":"2020-05-01","category":"tech","tags":["python","django","docker","vs-code"]},"fields":{"slug":"/017-debug-django-with-docker-vs-code/","date":"2020-05-01T06:00:00.000Z"}}},"pageContext":{"slug":"/017-debug-django-with-docker-vs-code/"}}}