deploy

Overview ¶

Package deploy provides simple functions for deploy ECS.

Usage:

import "github.com/h3poteto/ecs-goploy/deploy"

Service update ¶

When you want to update service in ECS, please use this package as follows.

Construct a new Service, then use deploy functions.

s, err := deploy.NewService("cluster", "service-name", "nginx:stable", nil, 5 * time.Minute, true, "", "", true)
if err != nil {
    log.Fatalf("[ERROR] %v", err)
}

// deploy new image
if err := s.Deploy(); err != nil {
    log.Fatalf("[ERROR] %v", err)
}

Or you can write a custom deploy recipe as you like.

For example:

s, err := deploy.NewService("cluster", "service-name", "nginx:stable", nil, 5 * time.Minute, true, "", "", true)
if err != nil {
    log.Fatal(err)
}

// get the current service
service, err := s.DescribeService()
if err != nil {
    log.Fatal(err)
}
currentTaskDefinition, err := s.TaskDefinition.DescribeTaskDefinition(service)
if err != nil {
    log.Fatal(err)
}

newTaskDefinition, err := s.RegisterTaskDefinition(currentTaskDefinition, s.NewImage)
if err != nil {
    log.Fatal(err)
}

// Do something

err = s.UpdateService(service, newTaskDefinition)
if err != nil {
    // Do something
}
log.Println("[INFO] Deploy success")

TaskDefinition update ¶

You can create a new revision of the task definition. Please use this task definition at `Task` and `ScheduledTask`.

For example:

taskDefinition := ecsdeploy.NewTaskDefinition("", "", true)
t, err := taskDefinition.Create("sample-task-definition:revision", "nginx:stable")
if err != nil {
    log.Fatal(err)
}
log.Println(*t.TaskDefinitionArn)

Run task ¶

When you want to run task on ECS at once, plese use this package as follows.

For example:

task, err := ecsdeploy.NewTask("cluster", "container-name", "echo hoge", "sample-task-definition:2", (5 * time.Minute), "", "", true)
if err != nil {
    log.Fatal(err)
}
if _, err := task.Run(); err != nil {
    log.Fatal(err)
}
log.Println("[INFO] Task success")

ScheduledTask update ¶

When you update the ECS Scheduled Task, please use this package.

For example:

scheduledTask := ecsdeploy.NewScheduledTask("", "", true)
scheduledTask("schedule-name", "sample-task-definition:2", 1)