continuousphp · Farouk-Lamri · Jan 10, 2020 · Jan 10, 2020 · Jan 10, 2020 · Jan 10, 2020
diff --git a/docs/service/adding-service.md b/docs/service/adding-service.md
@@ -0,0 +1,109 @@
+In this doc we enumerate steps to add a new a service, we took redis service as an example.
+
+##  Changes in infra-worker 
+Add the new service inside the docker-compose which is in infra-worker/worker/files/default/docker
+
+Example: 
+
+```
+ redis507:
+    container_name: cphp-redis
+    image: redis:5.0.7
+    hostname: redis-server
+    ports:
+      - 6379:6379
+    networks:
+      default:
+        aliases:
+          - redis-server
+    entrypoint: redis-server --appendonly yes
+```
+
+You can refer to this <a href="https://github.com/continuousphp/infra-worker/pull/7/files">PR</a>
+
+##  Changes in worker 
+
+1. <b>Modification in common.php file </b>
+
+Add reference to the container at the level of shared key and assign false  to it 
+
+Example: 
+
+``` 
+'worker.compose.container.redis' => false,
+```
+
+Add reference to the container at the level of abstract_factories and assign \Worker\Compose\Container\ContainerAbstractFactory::class to it
+
+Example: 
+
+```
+ 'worker.compose.container.redis' => \Worker\Compose\Container\ContainerAbstractFactory::class,
+```
+
+2. <b>Modification in Composition.php file </b>
+
+Add condition to verify if the envirenement variable is set in the array named variables.
+
+```
+if (array_key_exists('CPHP_SERVICE_REDIS', $variables)) {
+            yield 'worker.compose.container.redis' => SemverObject::createFromString(
+                $variables['CPHP_SERVICE_REDIS']
+            );
+        }
+```
+
+3. <b>Add class</b> 
+
+Add class in the container folder. This class must extend the Container abstract class.
+Add the container name in the CONTAINER_NAME varibale according to the convention cphp-<servicename>
+
+Example: 
+
+```
+const CONTAINER_NAME = 'cphp-redis';
+```
+
+Add the dafault version in the DEFAULT_VERSION variable and mention all the available verions in the AVAILABLE_VERSIONS variabale. For every version you have to use the same name as in docker-compose file.
+
+Example:
+
+```
+'5.0.7' => 'redis507'
+```
+
+For each service, you can test it in the isReady function. For exemple, to check if the server is up you can perform an health check.
+
+Example for redis server :
+
+```
+ $commandDocker
+            ->enableConsole()
+            ->disableLogger()
+            ->showCommand()
+            ->setContainerReference($this->applicationContainerName)
+            ->exec('redis-cli info | grep uptime_in_seconds', $stats)
+        ;
+        $uptime_in_seconds = explode(":", $stats[0]);
+        if (!empty($stats) && $uptime_in_seconds[1] > 0) {
+            $this->getLogger()->stdout(BashColorInterface::colorize('Redis container started.',
+                BashColorInterface::GREEN,
+                true
+            ));
+            return true;
+        }
+```
+
+4. <b>Modifications in ContainerAbstractFactory.php file </b>
+
+Add a refernce to the container in CONTAINERS array.
+
+Example:
+```
+'worker.compose.container.redis' => Redis::class,
+```
+
+
+You can refer to this <a href="https://github.com/continuousphp/worker/pull/73/files">PR</a>
+
+