Update Docker instructions (#1254)

* Update README.rst

Update Docker usage

Author: dhoomakethu

README.rst

@@ -12,6 +12,9 @@ PyModbus - A Python Modbus Stack
 .. image:: https://pepy.tech/badge/pymodbus
    :target: https://pepy.tech/project/pymodbus
    :alt: Downloads
+.. image:: https://ghcr-badge.deta.dev/pymodbus-dev/pymodbus/tags?label=Docker
+   :target: https://github.com/pymodbus-dev/pymodbus/pkgs/container/pymodbus
+   :alt: Docker Tags
 
 ------------------------------------------------------------
 Supported versions
@@ -229,9 +232,7 @@ This installs pymodbus in your virtual environment with pointers directly to the
 Either method will install all the required dependencies
 (at their appropriate versions) for your current python distribution.
 
-------------------------------------------------------------
-Repository structure
-------------------------------------------------------------
+   
 The repository contains a number of important branches and tags.
   * **dev** is where all development happens, this branch is not always stable.
   * **master** is where are releases are kept.
@@ -242,6 +243,88 @@ If a maintenance release of an old version is needed (e.g. v2.5.4),
 the release tag is used to create a branch with the same name,
 and maintenance development is merged here.
 
+-----------------------------------------------------------
+Install with Docker
+-----------------------------------------------------------
+Pull the latest image on ``dev`` branch with ``docker pull ghcr.io/pymodbus-dev/pymodbus:dev``::
+
+   doker pull ghcr.io/pymodbus-dev/pymodbus:dev
+   dev: Pulling from pymodbus-dev/pymodbus
+   548fcab5fe88: Pull complete
+   a4d3f9f008ef: Pull complete
+   eb83acb05730: Pull complete
+   71cd28d529fd: Pull complete
+   66607ad8f4f0: Pull complete
+   64dff4c66d3b: Pull complete
+   8b26e5718a7a: Pull complete
+   dc87d8707532: Pull complete
+   Digest: sha256:cfeee09a87dde5863574779416490fd47cacbb6f37332a3cdaf995c416e16b69
+   Status: Downloaded newer image for ghcr.io/pymodbus-dev/pymodbus:dev
+   ghcr.io/pymodbus-dev/pymodbus:dev
+   
+The image when run with out any further options supplied will start a repl server in non interactive mode.::
+
+   ❯ docker run -it --rm -p 8080:8080 -p 5020:5020 ghcr.io/pymodbus-dev/pymodbus:dev
+
+   Reactive Modbus Server started.
+   ======== Running on http://127.0.0.1:8080 ========
+
+   ===========================================================================
+   Example Usage:
+   curl -X POST http://127.0.0.1:8080 -d "{"response_type": "error", "error_code": 4}"
+   ===========================================================================
+
+The default command can be overridden by passing any valid command at the end.::
+
+   ❯ docker run -p 8080:8080 -p 5020:5020 -it --rm ghcr.io/pymodbus-dev/pymodbus:dev bash -c "pymodbus.server --help"
+
+    Usage: pymodbus.server [OPTIONS] COMMAND [ARGS]...
+
+    Reactive modebus server
+
+   ╭─ Options ──────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
+   │ --host                                    TEXT     Host address [default: localhost]                                       │
+   │ --web-port                                INTEGER  Web app port [default: 8080]                                            │
+   │                       -b                           Support broadcast messages                                              │
+   │ --repl                    --no-repl                Enable/Disable repl for server [default: repl]                          │
+   │ --verbose                 --no-verbose             Run with debug logs enabled for pymodbus [default: no-verbose]          │
+   │ --install-completion                               Install completion for the current shell.                               │
+   │ --show-completion                                  Show completion for the current shell, to copy it or customize the      │
+   │                                                    installation.                                                           │
+   │ --help                                             Show this message and exit.                                             │
+   ╰────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
+   ╭─ Commands ─────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
+   │ run              Run Reactive Modbus server.                                                                               │
+   ╰────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
+
+To check the repl console.::
+
+   ❯ docker run -p 8080:8080 -p 5020:5020 -it --rm ghcr.io/pymodbus-dev/pymodbus:dev bash -c "pymodbus.console --help"
+   Usage: pymodbus.console [OPTIONS] COMMAND [ARGS]...
+
+     Run Main.
+
+   Options:
+     --version                       Show the version and exit.
+     --verbose                       Verbose logs
+     --broadcast-support             Support broadcast messages
+     --retry-on-empty                Retry on empty response
+     --retry-on-error                Retry on error response
+     --retries INTEGER               Retry count
+     --reset-socket / --no-reset-socket
+                                     Reset client socket on error
+     --help                          Show this message and exit.
+
+   Commands:
+     serial  Define serial communication.
+     tcp     Define TCP.
+     
+To run examples (assuming server is running). ::
+
+   ❯ docker run -p 8080:8080 -p 5020:5020 -it --rm ghcr.io/pymodbus-dev/pymodbus:dev bash -c "examples/client_async.py"
+   14:52:13 INFO  client_async:44 ### Create client object
+   14:52:13 INFO  client_async:120 ### Client starting
+
 ------------------------------------------------------------
 Current Work In Progress
 ------------------------------------------------------------