h3poteto / ecs-goploy Goto Github PK

View Code? Open in Web Editor NEW

33.0 6.0 8.0 200 KB

re-implementation of ecs-deploy in Golang

License: MIT License

Go 98.61% Makefile 1.39%

golang aws-ecs continuous-deployment ecs-deploy ecs-goploy

ecs-goploy's Introduction

ecs-goploy

ecs-goploy is a re-implementation of ecs-deploy in Golang.

This is a command line tool, but you can use deploy as a package. So when you write own deploy script for AWS ECS, you can embed deploy package in your golang source code and customize deploy recipe. Please check godoc.

Install

Get binary from github:

$ wget https://github.com/h3poteto/ecs-goploy/releases/download/v0.5.0/ecs-goploy_v0.5.0_linux_amd64.zip
$ unzip ecs-goploy_v0.5.0_linux_amd64.zip
$ ./ecs-goploy --help

Usage

$ ./ecs-goploy --help
Deploy commands for ECS

Usage:
  ecs-goploy [command]

Available Commands:
  help        Help about any command
  run         Run command
  update      Update some ECS resource
  version     Print the version number

Flags:
  -h, --help             help for ecs-goploy
      --profile string   AWS profile (detault is none, and use environment variables)
      --region string    AWS region (default is none, and use AWS_DEFAULT_REGION)
  -v, --verbose          Enable verbose mode

Use "ecs-goploy [command] --help" for more information about a command.

Deploy an ECS Service

Please specify cluser, service name and image(family:revision).

$ ./ecs-goploy update service --cluster my-cluster --service-name my-service --image nginx:stable --skip-check-deployments --enable-rollback

If you specify --base-task-definition, ecs-goploy updates the task definition with the image and deploy ecs service. If you does not specify --base-task-definition, ecs-goploy get current task definition of the service, and update with the image, and deploy ecs service.

Run Task

At first, you must update the task definition which is used to run ecs task. After that, you can run ecs task.

$ NEW_TASK_DEFINITION=`./ecs-goploy update task-definition --base-task-definition my-task-definition:1 --image nginx:stable`
$ ./ecs-goploy run task --cluster my-cluster --container-name web --task-definition $NEW_TASK_DEFINITION --command "some commands"

Update Scheduled Task

At first, you must update the task definition which is used to run scheduled task. After that, you can update the scheduled task.

$ NEW_TASK_DEFINITION=`./ecs-goploy update task-definition --base-task-definition my-task-definition:1 --image nginx:stable`
$ ./ecs-goploy update scheduled-task --count 1 --name schedule-name --task-definition $NEW_TASK_DEFINITION

Configuration

AWS Configuration

ecs-goploy calls AWS API via aws-skd-go, so you need export environment variables:

$ export AWS_ACCESS_KEY_ID=XXXXX
$ export AWS_SECRET_ACCESS_KEY=XXXXX
$ export AWS_DEFAULT_REGION=XXXXX

or set your credentials in $HOME/.aws/credentials:

[default]
aws_access_key_id = XXXXX
aws_secret_access_key = XXXXX

or prepare IAM Role or IAM Task Role.

AWS region can be set command argument: --region.

AWS IAM Policy

Below is a basic IAM Policy required for ecs-goploy.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "AllowUserToECSDeploy",
      "Effect": "Allow",
      "Action": [
        "ecr:DescribeRepositories",
        "ecr:DescribeImages",
        "ecs:DescribeServices",
        "ecs:DescribeTaskDefinition",
        "ecs:RegisterTaskDefinition",
        "ecs:UpdateService",
        "ecs:RunTask",
        "ecs:DescribeTasks",
        "ecs:ListTasks",
        "events:DescribeRule",
        "events:ListTargetsByRule",
        "events:PutTargets",
        "iam:PassRole"
      ],
      "Resource": "*"
    }
  ]
}

License

The package is available as open source under the terms of the MIT License.

ecs-goploy's People

Contributors

Stargazers

Watchers

Forkers

suusan2go atijust yolitals miseyu crowdworks holidayworking lpasha connectedservices

ecs-goploy's Issues

Rescue when task does not exist

When there is no task, ecs-goploy failed with error at:
https://github.com/h3poteto/ecs-goploy/blob/master/deploy/service.go#L187

because runningTask is empty.

2018/07/02 06:37:17 [ERROR] InvalidParameterException: Tasks cannot be empty.
	status code: 400, request id: 5d54b58d-7dc2-11e8-bc39-859bfd2af623

Dependabot can't resolve your Go dependency files

Dependabot can't resolve your Go dependency files.

As a result, Dependabot couldn't update your dependencies.

The error Dependabot encountered was:

github.com/h3poteto/ecs-goploy/cmd: cannot find module providing package github.com/h3poteto/ecs-goploy/cmd

If you think the above is an error on Dependabot's side please don't hesitate to get in touch - we'll do whatever we can to fix it.

View the update logs.

Ignored linuxParameters after service update

Hi! Thank you for developing such a great tool.

However, after switching from using tini in our containers to embedded initProcessEnabled docker parameter I have discovered the following issue:

after updating any ECS service with ecs-goploy (and ecs-deploy too) linuxParameters section of task definition (which contains the needed initProcessEnabled parameter) is set to null. See example below.

before ecs-goploy:

"linuxParameters": {
        "capabilities": null,
        "sharedMemorySize": null,
        "tmpfs": null,
        "devices": null,
        "initProcessEnabled": true
      }

after updating the service:

"linuxParameters": null

NEW_TASK_DEFINITION=`ecs-goploy task-definition new --base-task-definition=hogehoge:1 --image=ecs_image:revision`
ecs-goploy task --task-definition=${NEW_TASK_DEFINITION}...`

$ ecs-goploy  --command='/bin/sh -c "echo $DATABASE_URL"'

However, the current implementation simply splits command by space.

https://github.com/crowdworks/ecs-goploy/blob/e3326d2706411e598db5be91a42a2c1a192c777d/deploy/task.go#L63

It would be great if the command can be split the string containing quotes properly.