Merge ~valentinviennot/ubuntu-docker-images:update-redis-readme-app-description into ~ubuntu-docker-images/ubuntu-docker-images/+git/redis:edge

[Valentin Viennot]

Did some cleaning/consistency work, added extra params, and my dear TZ variable. Please leave comments and don't hesitate to discuss the choices made here.

[Richard Harding (rharding)]

review: Approve

diff --git a/README.md b/README.md
index ba45320..ef2ca35 100644
--- a/README.md
+++ b/README.md
@@ -2,6 +2,7 @@
 
 ## About Redis
 
+"Redis is an open source (BSD licensed), in-memory data structure store, used as a database, cache and message broker. It supports data structures such as strings, hashes, lists, sets, sorted sets with range queries, bitmaps, hyperloglogs, geospatial indexes with radius queries and streams. Redis has built-in replication, Lua scripting, LRU eviction, transactions and different levels of on-disk persistence, and provides high availability via Redis Sentinel and automatic partitioning with Redis Cluster. [Learn more](https://redis.io/topics/introduction)." (from [redis.io](redis.io))
 
 ## Tags
 
@@ -16,21 +17,21 @@
 ### Docker CLI
 
 ```sh
-$ docker run --name redis -e ALLOW_EMPTY_PASSWORD=yes squeakywheel/redis:edge
+$ docker network create --driver bridge redis-network
+$ docker run --name redis-container --network redis-network -e TZ=Europe/London -e REDIS_PASSWORD=mypassword squeakywheel/redis:edge
 ```
 
-**WARNING**: use of `ALLOW_EMPTY_PASSWORD=yes` is not
-recommended in production environments.  For production environments specify the `REDIS_PASSWORD` environment variable, or instruct the entrypoint script to create a random password for you by specifying `REDIS_RANDOM_PASSWORD=1`.
-
-
 #### Parameters
 | Parameter | Description |
 |---|---|
+| `-e TZ` | Timezone, e.g. `Europe/London` |
 | `-e ALLOW_EMPTY_PASSWORD` | Set to `yes` to allow connections to `redis-server` without a password.  **This setting is not recommended in production environments**. |
 | `-e REDIS_PASSWORD` | Set the desired password to be used |
 | `-e REDIS_RANDOM_PASSWORD` | Set this variable to `1` if you would like the entrypoint script to generate a random password for you.  You will be able to see the generated password in the logs (`docker logs`) |
-| `-e REDIS_ALLOW_REMOTE_CONNECTIONS=yes` | Set to `no` to disallow remote connections to `redis-server` (i.e., make `redis-server` listen to `127.0.0.1` only).
+| `-e REDIS_ALLOW_REMOTE_CONNECTIONS=yes` | Set to `no` to disallow remote connections to `redis-server` (i.e., make `redis-server` listen to `127.0.0.1` only)
 | `-e REDIS_EXTRA_FLAGS` | Specify extra flags to be passed to `redis-server` when initializing it |
+| `-p 6079:6379` | Expose redis on `localhost:6079` |
+| `-v /path/to/redis.conf:/etc/redis/redis.conf` | Mount local [configuration file](https://redis.io/topics/config) `redis.conf` (download this [example file](https://git.launchpad.net/~canonical-server/ubuntu-server-oci/+git/memcached/plain/examples/redis.conf)) |
 
 
 #### Testing/Debugging
@@ -41,23 +42,8 @@ In case you need to debug what it is happening with the container you can run `d
 $ docker exec -it <name_of_the_container> /bin/bash
 ```
 
-You can specify your own `redis.conf` such as this [example](https://git.launchpad.net/~canonical-server/ubuntu-server-oci/+git/memcached/plain/examples/redis.conf) file by mounting it:
-
-```
-$ docker run -d --name redis /myredis/redis.conf:/etc/redis/redis.conf -e ALLOW_EMPTY_PASSWORD=yes squeakywheel/redis:edge
-```
-
-
-If you want, you can launch another container with the `redis-cli` program,
+With this same image, you can launch another container with the `redis-cli` program,
 and connect to the `redis-server` that is running in the first container.
-For example, suppose that you already have a docker network named
-`redis-network` configured, and you launch `redis-server` like this:
-
-```
-$ docker run --network redis-network --name redis-container -e REDIS_PASSWORD=mypassword -d squeakywheel/redis:edge
-```
-
-You can now launch `redis-cli` by doing:
 
 ```
 $ docker run --network redis-network --rm squeakywheel/redis:edge redis-cli -h redis-container
@@ -140,6 +126,8 @@ spec:
 $ microk8s kubectl apply -f redis-deployment.yml
 ```
 
+You will now be able to connect to the redis server on `localhost:30073`.
+
 ## Bugs and Features request
 
 If you find a bug in our image or want to request a specific feature file a bug here: