Update README.md

README.md

@@ -28,7 +28,29 @@ export CI_WRAPPER_HOME=${HOME}/.ci-wrappers
 ## Usage
 
   - `ci-install-software` <br/>
-  Installs GitHub CLI, Docker client, docker compose plugin, vagrant and terraform in $CI_WRAPPERS_HOME
+    Installs GitHub CLI, Docker client, docker compose plugin, vagrant and terraform in `$CI_WRAPPERS_HOME`
+    
+### Setup docker
+
+  - if you have an http proxy :
+    - sets the needed variables `HTTP_PROXY`, `HTTPS_PROXY` and `NO_PROXY`
+    - and adds the variables `VAGRANT_HTTP_PROXY`, `VAGRANT_HTTPS_PROXY` and `VAGRANT_NO_PROXY`
+    - install the vagrant plugin for proxies : <br/>
+      `vagrant plugin install vagrant-proxyconf`
+  - To install a docker engine with http proxy support in a Virtualbox VM with vagrant :
+    - run `provision-docker-engine` once to create the VM
+        - `docker-vagrant` is a wrapper for this specific Docker vagrant Box.
+        - `docker-vagrant up` and `docker-vagrant halt` to create/start and stop the vm.
+        - `docker-vagrant ssh` to log in the VM.
+        - `docker-vagrant suspend`, `docker-vagrant resume` and `docker-vagrant status` to suspend, resume and get VM
+          status.
+        - `docker-vagrant destroy` to destroy it (**docker named volumes will be lost**).
+    - `use-vagrant-docker` sets $DOCKER_HOST for the docker client in the current shell.
+    - to test `docker run --rm hello-world`
+    - `vagrant destroy` to destroy the VM AND THE DATA.
+
+### Continuous Integration (C.I.)
+
   - `new-java-project testci fr.univtln.bruno.tests` <br/>
     Creates a new maven projects ready for C.I.
   - `docker-mvn` <br/>
@@ -37,12 +59,4 @@ export CI_WRAPPER_HOME=${HOME}/.ci-wrappers
   - `ci-github-runner-repo` or `ci-github-runner-org` <br/>
     Creates and register a new GitHub runner in a docker container for the current repository
     or the organisation (account).
-- A docker engine with http proxy support in VM :
-    - `docker-vagrant` is a wrapper for a specific Docker vagrant Box (Docker in a VBox VM).
-        - `docker-vagrant up` and `docker-vagrant halt` to create/start and stop the vm.
-        - `docker-vagrant ssh` to log in the VM.
-        - `docker-vagrant suspend`, `docker-vagrant resume` and `docker-vagrant status` to suspend, resume and get VM
-          status.
-        - `docker-vagrant destroy` to destroy it (**docker named volumes will be lost**).
-    - `use-vagrant-docker` to sets docker client to used in the current shell (sets $DOCKER_HOST).
-    - `vagrant destroy` to destroy it.
+