update readme

Author: FriendlyCM

README.md

@@ -42,6 +42,12 @@ Please ensure you have the latest versions of Docker and Docker Compose installe
   - Docker: [Install Docker on Linux](https://docs.docker.com/desktop/setup/install/linux/)
   - Docker Compose standalone: [Install Docker Compose on Linux](https://docs.docker.com/compose/install/standalone/)
 
+## Official Docker image
+There are two official Docker images for java-tron:
+
+- `tronprotocol/java-tron`: This image is based on the official [java-tron](https://github.com/tronprotocol/java-tron) repository, used for the Mainnet, and mostly can be used for the Nile testnet too. (**All the demo in this repository are based on this image**)
+- `tronnile/java-tron`: This image is based on the [nile-testnet](https://github.com/tron-nile-testnet/nile-testnet) repository which is forked from [java-tron](https://github.com/tronprotocol/java-tron). You need to use this image for the Nile testnet when there is new test release from java-tron and before it was released, especially for the hard fork test on Nile. Information about code release of the Nile testnet, please refer to this [website](https://nileex.io/).
+
 ## Quick Start
 To quickly start a java-tron node that connects to the Mainnet, simply use the following Docker command:
 

tools/docker/README.md

@@ -30,17 +30,29 @@ tronprotocol/java-tron   1.0.0      76702facd55e   23 seconds ago   549MB
 
 ### What ./gradlew sourceDocker do?
 
-It will trigger the execution of `task sourceDocker` in [build.gradle](build.gradle). Reviewing the logic, `task sourceDocker` essentially copies the Dockerfile and shell script to a build directory, then runs the docker build. From the logic, you can run `./gradlew sourceDocker` with customised `dockerOrgName`, `dockerArtifactName`, and `release.releaseVersion`.
+It will trigger the execution of `task sourceDocker` in [build.gradle](build.gradle). Reviewing the logic, `task sourceDocker` essentially copies the Dockerfile and shell script to a build directory, then runs the docker build. From the logic, you can run `./gradlew sourceDocker` with customised `dockerOrgName`, `dockerArtifactName`, `release.releaseVersion` and `network`.
 
 For example:
+```sh
+# build java-tron image with customised dockerOrgName, dockerArtifactName and release.releaseVersion
+./gradlew --no-daemon sourceDocker -PdockerOrgName=YourOrgName -PdockerArtifactName=ArtifactName -Prelease.releaseVersion=V1.1.0
+
+# build java-tron docker image for nile testnet with specified org, artifact and version.
+# Using code from https://github.com/tron-nile-testnet/nile-testnet.git
+./gradlew --no-daemon sourceDocker -PdockerOrgName=YourOrgName -PdockerArtifactName=ArtifactName -Prelease.releaseVersion=V1.1.0 -Pnetwork=nile
 ```
-./gradlew --no-daemon sourceDocker -PdockerOrgName=yourOrgName -PdockerArtifactName=test -Prelease.releaseVersion=V1.1.0
-```
+
 ## Test image
 
 Test the java-tron image use the command below.
-```
+``` ssh
 ./gradlew --no-daemon testDocker
+
+# test image with customised dockerOrgName, dockerArtifactName and release.releaseVersion
+./gradlew --no-daemon testDocker -PdockerOrgName=YourOrgName -PdockerArtifactName=ArtifactName -Prelease.releaseVersion=V1.1.0
+
+# test image for nile testnet with specified org, artifact and version.
+./gradlew --no-daemon testDocker -PdockerOrgName=YourOrgName -PdockerArtifactName=ArtifactName -Prelease.releaseVersion=V1.1.0 -Pnetwork=nile
 ```
 This will trigger the execution of `task testDocker` in [build.gradle](build.gradle). According to this logic, it will run the [test.sh](test.sh) script with the parameter of the Docker image name.