guenbakku/simple-aws-manager

Simple CakePHP Plugin for managing AWS resources

Simple AWS Manager

A simple CakePHP 3 plugin for managing AWS resources. Currently this can only list and restart EC2 instances., _(*1)

Requirement

• PHP 7.0 or higher
• CakePHP 3.4 or higher

Installation

You can install this plugin into your CakePHP application using composer., _(*2)

The recommended way to install composer packages is:, _(*3)

composer require guenbakku/simple-aws-manager

Configure:

Load plugin

Add following into bottom of your bootstrap.php:, _(*4)

Plugin::load('Guenbakku/Sam', ['bootstrap' => true, 'routes' => true]);

Configure AWS credentials

Create file sam.php in your directory config with following content:, _(*5)

<?php
return [
    'Guenbakku/Sam' => [
        'credentials' => [
            'default' => [
                'key' => 'xxxxxx',
                'secret' => 'xxxxxx',
            ],
            'uses' => 'default',
        ]
    ],
];

Note:

• You can override plugin's config content by simply write same key into your config/sam.php.
• Please set right policy for credentials which you attend to use with this plugin.

Sample of AWS Policy:, _(*6)

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "ec2:DescribeInstances"
            ],
            "Resource": "*"
        },
        {
            "Effect": "Allow",
            "Action": [
                "ec2:RebootInstances"
            ],
            "Condition": {
                "StringEquals": {
                    "ec2:ResourceTag/User": "me"
                }
            },
            "Resource": "*"
        }
    ]
}

Access to plugin

Input following URL into web browser's address bar:, _(*7)

http://your.domain/path-to-cakephp-root/sam

path-to-cakephp-root is optional if your cakephp app is not pointed directed by your domain., _(*8)

Here is a screenshot of plugin:, _(*9)

, _(*10)