Initial import

Author: mriva

.gitignore

@@ -0,0 +1,3 @@
+/vendor
+/bin/jp.php
+/.idea

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2019 Soisy
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -0,0 +1,63 @@
+## Description
+Codedeployer is a small library that helps deploying any application or codebase to groups of ec2 instances through AWS Codedeploy.
+The deploy process needs pre-configuration on the AWS side, so ask your nearest ops.
+
+The deployment works like this:
+- an archive is created containing the codebase and a special `appspec.yml` file needed by Codedeploy
+- this archive is uploaded to S3
+- a series of calls is made to the Codedeploy API to initiate deployments
+- an agent installed on all supported instances polls Codedeploy waiting for deployment instructions
+- when the agent receives a deployment instruction, it downloads the archive from S3 and executes the steps defined in the `appspec.yml` file
+
+This process shifts the deployment from a push system like Idephix or Deployer that requires ssh access to machines in order to rsync the code, to a poll system where the instances are notified of a new deployment request by the agent and download the application archive, running all the configured scripts to complete the deployment.
+
+## Installation and usage
+1. Run `composer require mriva/codedeployer`
+2. Run `bin/deploy --setup`
+3. Create directories named as deployment groups
+4. Add scripts inside deployment groups directories
+5. Compile `config.php`
+6. Run `bin/deploy`
+
+**Point 1** and **2** are self explanatory.
+
+**Point 3** requires you to create a directory under `deploy/hook-script` for each instance group you want to deploy to.
+For example, if you wish to deploy to `ec2-alfa` and `ec2-beta` instance groups, the tree will look like this:
+
+```
+deploy/
+└── hook-scripts/
+    ├── ec2-alfa/
+    └── ec2-beta/
+```
+
+**Point 4** requires you to populate the directories from point 3.
+AWS Codedeploy offers various hooks during the process, for simplicity the default setup only uses `AfterInstall` but other hooks can be easily added to `appspec.yml` if needed.
+
+`AfterInstall` is the first hook available and is run after the agent has downloaded and extracted the revision archive to a temporary directory;
+it is used to actually copy all the code to the real target directory and execute any post-install script that might be needed (ie. clearing cache, recreating snapshots, etc).
+
+For more information on AWS Codedeploy hooks see: https://docs.aws.amazon.com/codedeploy/latest/userguide/reference-appspec-file-structure-hooks.html#appspec-hooks-server
+
+Now add scripts in those directories named after these hooks, so assuming you go for the easy version with just `AfterInstall`, your tree should look like this:
+
+```
+deploy/
+└── hook-scripts/
+    ├── ec2-alfa/
+    │   └── AfterInstall.sh
+    └── ec2-beta/
+        └── AfterInstall.sh
+
+```
+
+these script will be run by the main `hook-wrapper.sh` which is defined as the main hook in `appspec.yml`
+
+There are two example scripts ready to be used with minimal configuration for simple copy and rotating releases deploy in the `config/hook-scripts/example-scripts/` directory.
+
+**Point 5** only requires you to compile a few application related options, the file should be self explanatory as well.
+
+## TODO
+- refactor config.php with some other form of configuration
+- write Codedeploy new activation (app + groups) through CLI skipping web console
+- sanity checks

bin/deploy

@@ -0,0 +1,40 @@
+#!/usr/bin/env php
+<?php
+
+use Codedeployer\Deploy;
+use Composer\Autoload\ClassLoader;
+
+$file = __DIR__ . '/../../../autoload.php';
+
+if (file_exists($file)) {
+    define('CODEDEPLOYER_COMPOSER_INSTALL', $file);
+}
+
+if (!defined('CODEDEPLOYER_COMPOSER_INSTALL')) {
+    fwrite(STDERR, 'You need to set up the project dependencies using Composer');
+
+    die(1);
+}
+
+require CODEDEPLOYER_COMPOSER_INSTALL;
+
+$reflection = new \ReflectionClass(ClassLoader::class);
+$rootDir = dirname($reflection->getFileName(), 3);
+
+if (isset($argv[1]) && $argv[1] == '--setup') {
+    $packageDir = dirname(__DIR__, 1);
+
+    $deployDir = $rootDir . '/deploy/';
+
+    if (!is_dir($deployDir)) {
+        mkdir($deployDir);
+    }
+
+    exec("cp -a {$packageDir}/config/* {$deployDir}");
+
+    echo "Config files successfully installed\n";
+    exit(0);
+}
+
+$deployer = new Deploy();
+$deployer->run($rootDir);

composer.json

@@ -0,0 +1,29 @@
+{
+    "name": "soisy/codedeployer",
+    "description": "Deploy tool interacting with AWS Codedeploy",
+    "type": "library",
+    "keywords": ["soisy", "aws", "codedeploy", "deploy"],
+    "license": "MIT",
+    "authors": [
+        {
+            "name": "Matteo Riva",
+            "email": "[email protected]",
+            "role": "Developer"
+        }
+    ],
+    "require": {
+        "php": ">=7.0",
+        "aws/aws-sdk-php": "^3.100"
+    },
+    "bin": [
+        "bin/deploy"
+    ],
+    "config": {
+        "bin-dir": "bin"
+    },
+    "autoload": {
+        "psr-0": {
+            "Codedeployer": "src/"
+        }
+    }
+}