Merge branch 'kirtangajjar-add-service-command' into develop

Author: mbtamuli

.distignore

@@ -0,0 +1,16 @@
+.DS_Store
+.git
+.gitignore
+.gitlab-ci.yml
+.editorconfig
+.travis.yml
+behat.yml
+circle.yml
+bin/
+features/
+utils/
+*.zip
+*.tar.gz
+*.swp
+*.txt
+*.log

.editorconfig

@@ -0,0 +1,25 @@
+# This file is for unifying the coding style for different editors and IDEs
+# editorconfig.org
+
+# WordPress Coding Standards
+# https://make.wordpress.org/core/handbook/coding-standards/
+
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+indent_style = tab
+
+[{.jshintrc,*.json,*.yml,*.feature}]
+indent_style = space
+indent_size = 2
+
+[{*.txt,wp-config-sample.php}]
+end_of_line = crlf
+
+[composer.json]
+indent_style = space
+indent_size = 4

.gitignore

@@ -0,0 +1,12 @@
+.DS_Store
+ee.local.yml
+node_modules/
+vendor/
+*.zip
+*.tar.gz
+*.swp
+*.txt
+*.log
+composer.lock
+.idea
+*.db

README.md

@@ -1 +1,21 @@
-# service-command
+# EasyEngine/service-command
+
+Manages global `ee-nginx-proxy` container.
+
+## About `ee-nginx-proxy`
+`ee-nginx-proxy` is the main container which routes all incoming request to site-specific containers.
+
+So let's say you have foo.com and bar.com on same ee server. When anyone requests either website, the request will first go to `ee-nginx-proxy` which will forward the request to appropriate nginx container of site (In this case foo.com or bar.com).
+
+## Usage:
+
+```
+ee service [start|stop|restart|reload] <service-name>
+
+ee service start ee-nginx-proxy   # starts ee-nginx-proxy container
+ee service restart ee-nginx-proxy   # restarts ee-nginx-proxy container
+ee service stop ee-nginx-proxy   # stops ee-nginx-proxy container
+ee service reload ee-nginx-proxy   # reloads the configuration of ee-nginx-proxy container
+```
+
+For more info run ee service --help

composer.json

@@ -0,0 +1,28 @@
+{
+    "name": "easyengine/service-command",
+    "description": "Command to manager global containers/services in EasyEngine",
+    "type": "ee-cli-package",
+    "homepage": "https://github.com/easyengine/service-command",
+    "license": "MIT",
+    "authors": [],
+    "minimum-stability": "dev",
+    "prefer-stable": true,
+    "autoload": {
+        "psr-4": {
+            "": "src/"
+        },
+        "files": [ "service-command.php" ]
+    },
+    "extra": {
+        "branch-alias": {
+            "dev-master": "1.x-dev"
+        },
+        "bundled": true,
+        "commands": [
+            "service start",
+            "service stop",
+            "service restart",
+            "service reload"
+        ]
+    }
+}

ee.yml

@@ -0,0 +1,2 @@
+require:
+  - service-command.php

service-command.php

@@ -0,0 +1,12 @@
+<?php
+
+if ( ! class_exists( 'EE' ) ) {
+	return;
+}
+
+$autoload = dirname( __FILE__ ) . '/vendor/autoload.php';
+if ( file_exists( $autoload ) ) {
+	require_once $autoload;
+}
+
+EE::add_command( 'service', 'Service_Command' );

src/Service_Command.php

@@ -0,0 +1,115 @@
+<?php
+
+use EE\Utils;
+
+/**
+ * Manages global services of EasyEngine.
+ *
+ * ## EXAMPLES
+ *
+ *     # Restarts global nginx proxy service
+ *     $ ee service restart nginx-proxy
+ *
+ * @package ee-cli
+ */
+class Service_Command extends EE_Command {
+
+	/**
+	 * @var array Array of services defined in global docker-compose.yml
+	 */
+	private $whitelisted_services = [
+		'nginx-proxy',
+	];
+
+	/**
+	 * Service_Command constructor.
+	 *
+	 * Changes directory to EE_CONF_ROOT since that's where all docker-compose commands will be executed
+	 */
+	public function __construct() {
+		chdir( EE_CONF_ROOT );
+	}
+
+	/**
+	 * Starts global services.
+	 *
+	 * ## OPTIONS
+	 *
+	 * <service-name>
+	 * : Name of service.
+	 */
+	public function start( $args, $assoc_args ) {
+		$service = $this->filter_service( $args );
+
+		EE::exec( "docker-compose start $service", true, true );
+	}
+
+	/**
+	 * Returns valid service name from arguments.
+	 */
+	private function filter_service( $args ) {
+		$services = array_intersect( $this->whitelisted_services, $args );
+
+		if ( empty( $services ) ) {
+			EE::error( "Unable to find global EasyEngine service $args[0]" );
+		}
+
+		return $services[0];
+	}
+
+	/**
+	 * Stops global services.
+	 *
+	 * ## OPTIONS
+	 *
+	 * <service-name>
+	 * : Name of service.
+	 */
+	public function stop( $args, $assoc_args ) {
+		$service = $this->filter_service( $args );
+		EE::exec( "docker-compose stop $service", true, true );
+	}
+
+	/**
+	 * Restarts global services.
+	 *
+	 * ## OPTIONS
+	 *
+	 * <service-name>
+	 * : Name of service.
+	 */
+	public function restart( $args, $assoc_args ) {
+		$service = $this->filter_service( $args );
+		EE::exec( "docker-compose restart $service", true, true );
+	}
+
+	/**
+	 * Reloads global service without restarting services.
+	 *
+	 * ## OPTIONS
+	 *
+	 * <service-name>
+	 * : Name of service.
+	 */
+	public function reload( $args, $assoc_args ) {
+		$service = $this->filter_service( $args );
+		$command   = $this->service_reload_command( $service );
+		EE::exec( "docker-compose exec $service $command", true, true );
+	}
+
+	/**
+	 * Returns reload command of a service.
+	 * This is necessary since command to reload each service can be different.
+	 *
+	 * @param $service string name of service
+	 *
+	 * @return mixed
+	 */
+	private function service_reload_command( string $service ) {
+		$command_map = [
+			'nginx-proxy' => "sh -c 'nginx -t && service nginx reload'",
+		];
+
+		return $command_map[ $service ];
+	}
+}