postman image readme files added

docker/xfce-postman/README-dockerhub.md

@@ -0,0 +1,249 @@
+# Headless Ubuntu/Xfce container with VNC/noVNC and Postman desktop app
+
+## accetto/ubuntu-vnc-xfce-postman-g3
+
+[Docker Hub][this-docker] - [Git Hub][this-github] - [Dockerfile][this-dockerfile] - [Full Readme][this-readme-full] - [Changelog][this-changelog] - [Project Readme][this-readme-project] - [Wiki][sibling-wiki] - [Discussions][sibling-discussions]
+
+![badge-docker-pulls][badge-docker-pulls]
+![badge-docker-stars][badge-docker-stars]
+![badge-github-release][badge-github-release]
+![badge-github-release-date][badge-github-release-date]
+
+![badge_latest_created][badge_latest_created]
+[![badge_latest_version-sticker][badge_latest_version-sticker]][link_latest_version-sticker-verbose]
+
+***
+
+**Tip:** This is the **short README** version for Docker Hub. There is also the [full-length README][this-readme-full] on GitHub.
+
+***
+
+### TL;DR
+
+I try to keep the images slim. Consequently you can encounter missing dependencies while adding more applications yourself. You can track the missing libraries on the [Ubuntu Packages Search][ubuntu-packages-search] page and install them subsequently.
+
+You can also try to fix it by executing the following (the default `sudo` password is **headless**):
+
+```shell
+### apt cache needs to be updated only once
+sudo apt-get update
+
+sudo apt --fix-broken install
+```
+
+The fastest way to build the images locally:
+
+```shell
+### PWD = project root
+./docker/hooks/build dev postman-vnc
+./docker/hooks/build dev postman-vnc-chromium
+./docker/hooks/build dev postman-vnc-firefox
+./docker/hooks/build dev postman-vnc-firefox-plus
+./docker/hooks/build dev postman-vnc-novnc
+./docker/hooks/build dev postman-vnc-novnc-chromium
+./docker/hooks/build dev postman-vnc-novnc-firefox
+./docker/hooks/build dev postman-vnc-novnc-firefox-plus
+```
+
+### Table of contents
+
+- [Headless Ubuntu/Xfce container with VNC/noVNC and Postman desktop app](#headless-ubuntuxfce-container-with-vncnovnc-and-postman-desktop-app)
+  - [accetto/ubuntu-vnc-xfce-postman-g3](#accettoubuntu-vnc-xfce-postman-g3)
+    - [TL;DR](#tldr)
+    - [Table of contents](#table-of-contents)
+    - [Image tags](#image-tags)
+    - [Ports](#ports)
+    - [Volumes](#volumes)
+  - [Using headless containers](#using-headless-containers)
+    - [Overriding VNC/noVNC parameters](#overriding-vncnovnc-parameters)
+    - [Startup options and help](#startup-options-and-help)
+    - [More information](#more-information)
+  - [Issues, Wiki and Discussions](#issues-wiki-and-discussions)
+  - [Credits](#credits)
+
+This is the **third generation** (G3) of my headless images. More information about the image generations can be found in the [sibling project README][sibling-readme-project] file and the [sibling Wiki][sibling-wiki].
+
+**Remark:** The images can optionally contain the current `Chromium Browser` version from the `Ubuntu 18.04 LTS` distribution. This is because the version for `Ubuntu 20.04 LTS` depends on `snap`, which is not working correctly in Docker at this time. They can also optionally contain the latest version of the current [Firefox][firefox] browser for `Ubuntu 20.04 LTS`.
+
+**Attention:** If you will build an image containing the [Chromium Browser][chromium], then the browser will run in the `--no-sandbox` mode. You should be aware of the implications. The image is intended for testing and development.
+
+**Attention:** If you will build an image containing the [Firefox][firefox] browser, then the browser will run in the `multi-process` mode. Be aware, that this mode requires larger shared memory (`/dev/shm`). At least 256MB is recommended. Please check the **Firefox multi-process** page in [this Wiki][that-wiki-firefox-multiprocess] for more information and the instructions, how to set the shared memory size in different scenarios.
+
+The main features and components of the images in the default configuration are:
+
+- utilities **ping**, **wget**, **sudo**, **dconf-editor** (Ubuntu distribution)
+- current version of JSON processor [jq][jq]
+- light-weight [Xfce][xfce] desktop environment (Ubuntu distribution)
+- current version of high-performance [TigerVNC][tigervnc] server and client
+- current version of [noVNC][novnc] HTML5 clients (full and lite) (TCP port **6901**)
+- popular text editor [nano][nano] (Ubuntu distribution)
+- lite but advanced graphical editor [mousepad][mousepad] (Ubuntu distribution)
+- current version of [tini][tini] as the entry-point initial process (PID 1)
+- support for overriding both the container user account and its group
+- support of **version sticker** (see below)
+- optionally the current version of [Chromium Browser][chromium] open-source web browser (from the `Ubuntu 18.04 LTS` distribution)
+- optionally the current version of [Firefox][firefox] web browser and optionally also some additional **plus** features described in the [sibling image README][sibling-readme-xfce-firefox]
+
+All images include the current version of the [Postman][postman] desktop application.
+
+The history of notable changes is documented in the [CHANGELOG][this-changelog].
+
+![container-screenshot][this-screenshot-container]
+
+### Image tags
+
+The following images will be regularly rebuilt and published on Docker Hub:
+
+- `latest` is identical to `vnc-novnc`
+
+    ![badge_latest_created][badge_latest_created]
+    [![badge_latest_version-sticker][badge_latest_version-sticker]][link_latest_version-sticker-verbose]
+
+- `vnc` implements only VNC
+
+    ![badge_vnc_created][badge_vnc_created]
+    [![badge_vnc_version-sticker][badge_vnc_version-sticker]][link_vnc_version-sticker-verbose]
+
+- `vnc-novnc` implements VNC and noVNC
+
+    ![badge_vnc-novnc_created][badge_vnc-novnc_created]
+    [![badge_vnc-novnc_version-sticker][badge_vnc-novnc_version-sticker]][link_vnc-novnc_version-sticker-verbose]
+
+- `vnc-chromium` adds [Chromium Browser][chromium], implements only VNC
+
+    ![badge_vnc-chromium_created][badge_vnc-chromium_created]
+    [![badge_vnc-chromium_version-sticker][badge_vnc-chromium_version-sticker]][link_vnc-chromium_version-sticker-verbose]
+
+- `vnc-novnc-chromium` adds [Chromium Browser][chromium], implements VNC and noVNC
+
+    ![badge_vnc-novnc-chromium_created][badge_vnc-novnc-chromium_created]
+    [![badge_vnc-novnc-chromium_version-sticker][badge_vnc-novnc-chromium_version-sticker]][link_vnc-novnc-chromium_version-sticker-verbose]
+
+- `vnc-firefox-plus` adds [Firefox][firefox] with **plus features** (described in the [sibling image README][sibling-readme-xfce-firefox]), implements only VNC
+
+    ![badge_vnc-firefox-plus_created][badge_vnc-firefox-plus_created]
+    [![badge_vnc-firefox-plus_version-sticker][badge_vnc-firefox-plus_version-sticker]][link_vnc-firefox-plus_version-sticker-verbose]
+
+- `vnc-novnc-firefox-plus` adds [Firefox][firefox] with **plus features**, implements VNC and noVNC
+
+    ![badge_vnc-novnc-firefox-plus_created][badge_vnc-novnc-firefox-plus_created]
+    [![badge_vnc-novnc-firefox-plus_version-sticker][badge_vnc-novnc-firefox-plus_version-sticker]][link_vnc-novnc-firefox-plus_version-sticker-verbose]
+
+Clicking on the version sticker badge in the [README on Docker Hub][this-readme-dockerhub] reveals more information about the actual configuration of the image.
+
+### Ports
+
+Following **TCP** ports are exposed by default:
+
+- **5901** is used for access over **VNC**
+- **6901** is used for access over [noVNC][novnc]
+
+The VNC/noVNC default ports and also some other parameters can be overridden several ways as it is described in the [sibling image README file][sibling-readme-xfce].
+
+### Volumes
+
+The containers do not create or use any external volumes by default.
+
+Both **named volumes** and **bind mounts** can be used. More about volumes can be found in [Docker documentation][docker-doc] (e.g. [Manage data in Docker][docker-doc-managing-data]).
+
+However, the container's mounting point `/srv/projects/` is intended for sharing the projects between the container and the host computer:
+
+```shell
+docker run -v /my_local_projects:/srv/projects ...
+
+### or using the newer syntax
+docker run --mount source=/my_local_projects,target=/srv/projects ...
+```
+
+## Using headless containers
+
+More information about using headless containers can be found in the [full-length README][this-readme-full] file on GitHub.
+
+### Overriding VNC/noVNC parameters
+
+This image supports several ways of overriding the VNC/noVNV parameters. The [sibling image README file][sibling-readme-xfce] describes how to do it.
+
+### Startup options and help
+
+The startup options and help are also described in the [sibling image README file][sibling-readme-xfce].
+
+### More information
+
+More information about these images can be found in the [full-length README][this-readme-full] file on GitHub.
+
+## Issues, Wiki and Discussions
+
+If you have found a problem or you just have a question, please check the [Issues][this-issues], the [sibling Issues][sibling-issues] and the [sibling Wiki][sibling-wiki] first. Please do not overlook the closed issues.
+
+If you do not find a solution, you can file a new issue. The better you describe the problem, the bigger the chance it'll be solved soon.
+
+If you have a question or an idea and you don't want to open an issue, you can use the [sibling Discussions][sibling-discussions].
+
+## Credits
+
+Credit goes to all the countless people and companies, who contribute to open source community and make so many dreamy things real.
+
+***
+
+<!-- GitHub project common -->
+
+[this-changelog]: https://github.com/accetto/headless-coding-g3/blob/master/CHANGELOG.md
+[this-github]: https://github.com/accetto/headless-coding-g3/
+[this-issues]: https://github.com/accetto/headless-coding-g3/issues
+[this-readme-dockerhub]: https://hub.docker.com/r/accetto/ubuntu-vnc-xfce-nodejs-g3
+[this-readme-full]: https://github.com/accetto/headless-coding-g3/blob/master/docker/xfce-postman/README.md
+[this-readme-project]: https://github.com/accetto/headless-coding-g3/blob/master/README.md
+
+[sibling-discussions]: https://github.com/accetto/ubuntu-vnc-xfce-g3/discussions
+[sibling-github]: https://github.com/accetto/ubuntu-vnc-xfce-g3/
+[sibling-issues]: https://github.com/accetto/ubuntu-vnc-xfce-g3/issues
+[sibling-readme-project]: https://github.com/accetto/ubuntu-vnc-xfce-g3/blob/master/README.md
+[sibling-readme-xfce]: https://github.com/accetto/ubuntu-vnc-xfce-g3/blob/master/docker/xfce/README.md
+[sibling-readme-xfce-firefox]: https://github.com/accetto/ubuntu-vnc-xfce-g3/blob/master/docker/xfce-firefox/README.md
+[sibling-wiki]: https://github.com/accetto/ubuntu-vnc-xfce-g3/wiki
+
+<!-- Docker image specific -->
+
+[this-docker]: https://hub.docker.com/r/accetto/ubuntu-vnc-xfce-postman-g3/
+[this-dockerfile]: https://github.com/accetto/headless-coding-g3/blob/master/docker/Dockerfile.xfce.postman
+
+[this-screenshot-container]: https://raw.githubusercontent.com/accetto/headless-coding-g3/master/docker/xfce-postman/ubuntu-vnc-xfce-postman.jpg
+
+<!-- Previous generations -->
+
+[that-wiki-firefox-multiprocess]: https://github.com/accetto/xubuntu-vnc/wiki/Firefox-multiprocess
+
+<!-- External links -->
+
+[docker-ubuntu]: https://hub.docker.com/_/ubuntu/
+[ubuntu-packages-search]: https://packages.ubuntu.com/
+
+[docker-doc]: https://docs.docker.com/
+[docker-doc-managing-data]: https://docs.docker.com/storage/
+
+[chromium]: https://www.chromium.org/Home
+[firefox]: https://www.mozilla.org
+[jq]: https://stedolan.github.io/jq/
+[mousepad]: https://github.com/codebrainz/mousepad
+[nano]: https://www.nano-editor.org/
+[newman]: https://github.com/postmanlabs/newman
+[novnc]: https://github.com/kanaka/noVNC
+[postman]: https://www.postman.com/downloads/
+[tigervnc]: http://tigervnc.org
+[tightvnc]: http://www.tightvnc.com
+[tini]: https://github.com/krallin/tini
+[xfce]: http://www.xfce.org
+
+<!-- github badges common -->
+
+[badge-github-release]: https://badgen.net/github/release/accetto/headless-coding-g3?icon=github&label=release
+
+[badge-github-release-date]: https://img.shields.io/github/release-date/accetto/headless-coding-g3?logo=github
+
+<!-- docker badges specific -->
+
+[badge-docker-pulls]: https://badgen.net/docker/pulls/accetto/ubuntu-vnc-xfce-postman-g3?icon=docker&label=pulls
+
+[badge-docker-stars]: https://badgen.net/docker/stars/accetto/ubuntu-vnc-xfce-postman-g3?icon=docker&label=stars
+
+<!-- Appendix -->