Uploaded image for project: 'Marathon'
  1. Marathon
  2. MARATHON-7197

Documentation related to ports is not clear enough

    Details

    • Type: Task
    • Status: Open
    • Priority: Medium
    • Resolution: Unresolved
    • Affects Version/s: None
    • Fix Version/s: None
    • Component/s: Docs

      Description

      I'm trying to understand how ports configuration works in Marathon and I've found that documentation (https://mesosphere.github.io/marathon/docs/ports.html) about it is not clear enought (at least for me...). There are lots of networking modes and attributes to set ports and I feel it's a bit confusing.

      For example:

      • Definitions of USER and BRIDGE networking seem to be the same.
      • Definition of servicePort doesn't explain what it is used for. It's explained in a different paragraph, in the examples section...

      In general, there is a lot of text but I think it could be more concise and better organized, taking into account that it's a key section.

      This isssue has been created automatically from Marathon GitHub Issue 5357.

        Attachments

          Activity

            People

            • Assignee:
              Unassigned
              Reporter:
              marathon-bot Marathon Bot
              Team:
              Orchestration Team
              Watchers:
              jorgenota, Marathon Bot, Suzanne Scala (Inactive)
            • Watchers:
              3 Start watching this issue

              Dates

              • Created:
                Updated: