Merge pull request #3 from idrislab/develop

Develop

Author: luispittagros

LICENSE

@@ -1 +1,117 @@
-# Laravel Docker Services
+# Laravel Docker Containers
+
+Automate your docker containers inside Laravel
+
+## Installation
+```sh
+composer require idrislab/laravel-docker-containers
+```
+
+Register DockerContainers with Artisan in *app/Console/Kernel.php*
+
+```php
+protected $commands = [
+    DockerContainers::class,
+  ];
+```
+
+Set the following environment variables (inside your .env file)
+
+```sh
+DOCKER_SOCKET=unix:///var/run/docker.sock
+DOCKER_CONTAINERS=mysql,redis
+```
+
+## Usage
+
+```
+php artisan containers <start|stop|restart> [--name=]
+```
+
+### Examples
+Starting all containers
+```sh
+php artisan containers start
+```
+
+Stopping only one container
+```sh
+php artisan containers stop --name=mysql
+```
+
+## Adding Containers
+Create a new Artisan command
+```sh
+php artisan make:command Containers
+```
+
+Register the new command with Artisan in *app/Console/Kernel.php* and remove *DockerContainers::class* if registered
+```php
+protected $commands = [
+       Commands\Containers::class,
+  ];
+```
+
+Update your command to look like
+```php
+<?php
+namespace App\Console\Commands;
+
+use luisgros\DockerContainers;
+
+/**
+ * Class  Containers
+ *
+ * @package App\Console\Commands
+ */
+class Containers extends DockerContainers
+{
+    /**
+     * Execute the console command.
+     *
+     * @return mixed
+     */
+    public function handle()
+    {
+
+    }
+}
+```
+
+Add your container(s) inside method *handle()*, in this case we're adding a [MySQL Group Replication Container](https://hub.docker.com/r/mysql/mysql-gr/)
+```php
+      $containers = [
+            'MySQLGr' => [
+                'repo'      => 'mysql/mysql-gr',
+                'tag'       => 'latest',
+                'instances' => 3,
+                'commands'   => [
+                    1 =>
+                        '-d --net=group1 -e MYSQL_ROOT_PASSWORD=ENV[DB_PASSWORD] \\'.
+                        '-e MYSQL_REPLICATION_USER=ENV[DB_PASSWORD] -e MYSQL_REPLICATION_PASSWORD=ENV[DB_PASSWORD] \\'.
+                        'mysql/mysql-gr --group_replication_group_seeds=\'ENV[MYSQLGR2]:6606,ENV[MYSQLGR3]:6606\' \\'.
+                        '--server-id=ENV[INSTANCE_NAME]',
+                    2 =>
+                        '-d --net=group1 -e MYSQL_ROOT_PASSWORD=ENV[DB_PASSWORD] \\'.
+                        '-e MYSQL_REPLICATION_USER=ENV[DB_PASSWORD] -e MYSQL_REPLICATION_PASSWORD=ENV[DB_PASSWORD] \\'.
+                        'mysql/mysql-gr --group_replication_group_seeds=\'ENV[MYSQLGR1]:6606,ENV[MYSQLGR3]:6606\' \\'.
+                        '--server-id=ENV[INSTANCE_NAME]',
+                    3 =>
+                        '-d --net=group1 -e MYSQL_ROOT_PASSWORD=ENV[DB_PASSWORD] \\'.
+                        '-e MYSQL_REPLICATION_USER=ENV[DB_PASSWORD] -e MYSQL_REPLICATION_PASSWORD=ENV[DB_PASSWORD] \\'.
+                        'mysql/mysql-gr --group_replication_group_seeds=\'ENV[MYSQLGR1]:6606,ENV[MYSQLGR2]:6606\' \\'.
+                        '--server-id=ENV[INSTANCE_NAME]',
+                ],
+                'network' => 'group1',
+                'docker' => [
+                    'pre' => [
+                        'network create group1 &>/dev/null',
+                    ]
+                ]
+            ],
+        ];
+
+        $this->addContainers($containers);
+        
+        parent::handle();
+```

README.md

@@ -1,10 +1,10 @@
 {
-    "name": "idrislab/laravel-docker-services",
-    "description": "Laravel docker services",
+    "name": "idrislab/laravel-docker-containers",
+    "description": "Automate your docker containers inside laravel",
     "authors": [
         {
             "name": "Luís Pitta Grós",
-            "email": "luis.gros@olx.com"
+            "email": "luis@idris.pt"
         }
     ],
     "keywords": ["laravel", "docker", "services"],

composer.json

@@ -1,5 +1,7 @@
 <?php
-
+/**
+ * @author Luís Pitta Grós <luis@idris.pt>
+ */
 namespace luisgros;
 
 use Docker\DockerClient;
@@ -79,17 +81,18 @@ public function isNamedContainerRunning($name)
 
     /**
      * @param $name
+     * @param $network
      *
      * @return string
      */
-    public function getNamedContainerIp($name)
+    public function getNamedContainerIp($name, $network)
     {
         $containerManager = $this->client->getContainerManager();
         $containers = $containerManager->findAll();
 
         foreach ($containers as $container) {
             if ($container->getNames()[0] == "/".$name) {
-                return $container->getNetworkSettings()->getNetworks()['bridge']->getIPAddress();
+                return $container->getNetworkSettings()->getNetworks()[$network]->getIPAddress();
             }
         }