Skip to content

[18.03] update documentation for "SCTP port mapping" #6039

Closed

Description

@thaJeztah

Problem description

docker/cli#278 completed the "coding" side of a series of pull requests to add support for the SCTP protocol when publishing ports (see the graph at the top of moby/moby#33922 (comment)).

Documentation changes are likely needed in some locations to mention the new option, and possibly some examples and/or description when to use this (?).

ping @AkihiroSuda @ishidawataru

/cc @gbarr01

Project version(s) affected

Engine 18.03 and up

Activity

  1. added this to the engine/18.03 milestone on Feb 21, 2018
  2. AkihiroSuda commented on Feb 26, 2018

    @AkihiroSuda
    Contributor
  3. ishidawataru commented on Feb 26, 2018

    @ishidawataru

    @AkihiroSuda Thanks, LGTM

  4. gbarr01 commented on Mar 12, 2018

    @gbarr01
    Contributor
  5. gbarr01 commented on Mar 12, 2018

    @gbarr01
    Contributor

    Hi, @thaJeztah @AkihiroSuda, I scraped together some documentation from your various PRs but the example at bottom did not work for me. I wonder if there is a simpler example we can use.

    For this page: https://docs.docker.com/engine/swarm/ingress/

    Docker supports SCTP (Stream Control Transmission Protocol) port mapping. SCTP is widely used as a transport protocol for cellular networks. With SCTP support, you can run applications such as Diameter within your Docker containers.

    Example:

    $ docker run -p 10000:20000/sctp mgoelzer/alpine-socat socat sctp-listen:20000 system:cat
    $ docker run -it --net=host mgoelzer/alpine-socat socat stdin sctp4-connect:127.0.0.1:10000,bind=127.0.0.1
    hello
    hello
    

    Should I expect something like this for the CLI page? https://docs.docker.com/engine/reference/commandline/service_create/#publish-service-ports-externally-to-the-swarm--p-publish

    Option: protocol
    Short syntax: --publish 8080:80/sctp
    Long syntax: --publish published=8080,target=80,protocol=sctp
    Description: Non-native protocol accessible by mapping TCP port.

  6. AkihiroSuda commented on Mar 19, 2018

    @AkihiroSuda
    Contributor

    @ishidawataru

    Do you know any free and practical Docker image that is suitable as an example usecase?

  7. gbarr01 commented on Apr 11, 2018

    @gbarr01
    Contributor

    Addressed here: #6078

  8. docker-robott commented on Mar 12, 2023

    @docker-robott
    Collaborator

    Closed issues are locked after 30 days of inactivity.
    This helps our team focus on active issues.

    If you have found a problem that seems similar to this, please open a new issue.

    /lifecycle locked

  9. locked and limited conversation to collaborators on Mar 12, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    Type

    No type

    Projects

    No projects

      Milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions