shipitron 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 7095a94bea4704f586b521f342b71374ebf80324
-  data.tar.gz: bcb1526aefa4b5033e41e8a63bafb46753561e42
+  metadata.gz: 26404f4e8acd7b859cc8dc2e74a399ccb08ff293
+  data.tar.gz: 5654cccd96d69d418e468f1a95217d89000f6edf
 SHA512:
-  metadata.gz: e2046e7a26028f1f3952390b0d5bd032fe32aaaa0f93c2982a1ed7bfcff8b14dfd932490315c1b34417cf7c976b3bcaa5bbca4024e25c394c3554dde442d079f
-  data.tar.gz: 16d2caab5ed2026e4886d1a8ec6fddbdbadd587a751f19d73976f88f0c90f331534bc63f2a1fe1bb160cfb74aa3a52ba7656d2fd03db12ed4884cc90f1b3c9d4
+  metadata.gz: 24a5b2934c357f1204d315c32c7fcba122aad527e165feb4015c5b44f77335f7e7ed5226833216417da210711077204ce9d93f0c7d779ca454781be8713f40ff
+  data.tar.gz: b1978b9a83fae96d8c7d992253f46e0d4ebd87a3943080bdb0d697c36677100a6a27498376d48b415eb58ea690528abc38b6a5080b4eb5045f4ef6cafe97adea

data/.dockerignore

@@ -0,0 +1,4 @@
+/shipitron/
+/pkg/
+Gemfile.lock
+/tmp/

data/.gitignore

@@ -0,0 +1,4 @@
+/shipitron/
+/pkg/
+Gemfile.lock
+/tmp/

data/.rspec

@@ -0,0 +1,3 @@
+--color
+--require spec_helper
+--format Fivemat

data/Dockerfile

@@ -0,0 +1,60 @@
+FROM ruby:2.3.1-alpine
+MAINTAINER Ryan Schlesinger <ryan@outstand.com>
+
+RUN addgroup -S shipitron && \
+    adduser -S -G shipitron shipitron && \
+    addgroup -g 1101 docker && \
+    addgroup shipitron docker
+
+ENV GOSU_VERSION 1.9
+ENV DUMB_INIT_VERSION 1.1.3
+
+RUN apk add --no-cache ca-certificates gnupg && \
+    mkdir -p /tmp/build && \
+    cd /tmp/build && \
+    gpg --keyserver pool.sks-keyservers.net --recv-keys B42F6819007F00F88E364FD4036A9C25BF357DD4 && \
+    curl -o gosu -L "https://github.com/tianon/gosu/releases/download/${GOSU_VERSION}/gosu-amd64" && \
+    curl -o gosu.asc -L "https://github.com/tianon/gosu/releases/download/${GOSU_VERSION}/gosu-amd64.asc" && \
+    gpg --verify gosu.asc && \
+    chmod +x gosu && \
+    cp gosu /bin/gosu && \
+    curl -O -L https://github.com/Yelp/dumb-init/releases/download/v${DUMB_INIT_VERSION}/dumb-init_${DUMB_INIT_VERSION}_amd64 && \
+    curl -O -L https://github.com/Yelp/dumb-init/releases/download/v${DUMB_INIT_VERSION}/sha256sums && \
+    grep dumb-init_${DUMB_INIT_VERSION}_amd64$ sha256sums | sha256sum -c && \
+    chmod +x dumb-init_${DUMB_INIT_VERSION}_amd64 && \
+    cp dumb-init_${DUMB_INIT_VERSION}_amd64 /bin/dumb-init && \
+    cd /tmp && \
+    rm -rf /tmp/build && \
+    apk del gnupg && \
+    rm -rf /root/.gnupg
+
+RUN apk add --no-cache \
+    build-base \
+    git \
+    openssh \
+    perl \
+    bash
+
+ENV USE_BUNDLE_EXEC true
+ENV BUNDLE_GEMFILE /shipitron/Gemfile
+
+WORKDIR /app
+COPY Gemfile shipitron.gemspec /shipitron/
+COPY lib/shipitron/version.rb /shipitron/lib/shipitron/
+COPY scripts/fetch-bundler-data.sh /shipitron/scripts/fetch-bundler-data.sh
+
+ARG bundler_data_host
+RUN /shipitron/scripts/fetch-bundler-data.sh ${bundler_data_host} && \
+      (bundle check || bundle install) && \
+      git config --global push.default simple
+COPY . /shipitron/
+RUN ln -s /shipitron/exe/shipitron /usr/local/bin/shipitron && \
+    mkdir -p /home/shipitron/.ssh && \
+    chown shipitron:shipitron /home/shipitron/.ssh && \
+    chmod 700 /home/shipitron/.ssh
+
+COPY scripts/docker-entrypoint.sh /docker-entrypoint.sh
+
+ENV DUMB_INIT_SETSID 0
+ENTRYPOINT ["/docker-entrypoint.sh"]
+CMD ["help"]

data/Dockerfile.release

@@ -0,0 +1,49 @@
+FROM ruby:2.3.1-alpine
+MAINTAINER Ryan Schlesinger <ryan@outstand.com>
+
+RUN addgroup -S shipitron && \
+    adduser -S -G shipitron shipitron && \
+    addgroup -g 1101 docker && \
+    addgroup shipitron docker
+
+ENV GOSU_VERSION 1.9
+ENV DUMB_INIT_VERSION 1.1.3
+
+RUN apk add --no-cache ca-certificates gnupg && \
+    mkdir -p /tmp/build && \
+    cd /tmp/build && \
+    gpg --keyserver pool.sks-keyservers.net --recv-keys B42F6819007F00F88E364FD4036A9C25BF357DD4 && \
+    curl -o gosu -L "https://github.com/tianon/gosu/releases/download/${GOSU_VERSION}/gosu-amd64" && \
+    curl -o gosu.asc -L "https://github.com/tianon/gosu/releases/download/${GOSU_VERSION}/gosu-amd64.asc" && \
+    gpg --verify gosu.asc && \
+    chmod +x gosu && \
+    cp gosu /bin/gosu && \
+    curl -O -L https://github.com/Yelp/dumb-init/releases/download/v${DUMB_INIT_VERSION}/dumb-init_${DUMB_INIT_VERSION}_amd64 && \
+    curl -O -L https://github.com/Yelp/dumb-init/releases/download/v${DUMB_INIT_VERSION}/sha256sums && \
+    grep dumb-init_${DUMB_INIT_VERSION}_amd64$ sha256sums | sha256sum -c && \
+    chmod +x dumb-init_${DUMB_INIT_VERSION}_amd64 && \
+    cp dumb-init_${DUMB_INIT_VERSION}_amd64 /bin/dumb-init && \
+    cd /tmp && \
+    rm -rf /tmp/build && \
+    apk del gnupg && \
+    rm -rf /root/.gnupg
+
+RUN apk add --no-cache \
+    git \
+    perl \
+    bash
+
+WORKDIR /app
+
+ENV SHIPITRON_VERSION=0.2.0
+
+RUN gem install shipitron -v ${SHIPITRON_VERSION} && \
+    mkdir -p /home/shipitron/.ssh && \
+    chown shipitron:shipitron /home/shipitron/.ssh && \
+    chmod 700 /home/shipitron/.ssh
+
+COPY scripts/docker-entrypoint.sh /docker-entrypoint.sh
+
+ENV DUMB_INIT_SETSID 0
+ENTRYPOINT ["/docker-entrypoint.sh"]
+CMD ["help"]

data/README.md

@@ -1,13 +1,47 @@
 # shipitron
 A deployment tool for use with Docker and ECS
 
-## TODO
-- [ ] user runs `docker run -it --rm outstand/shipit deploy production`
-- [ ] shipit container calls `RunTask` to schedule the actual build
-- [ ] ECS runs `docker run -t outstand/shipit-server deploy production`
-- [ ] shipit container pulls git updates (pull cache from S3 in v2)
-- [ ] shipit container calls `build-prod.sh` script to build production container
-- [ ] `docker push`
-- [ ] `RegisterTaskDefinition`
-- [ ] `RunTask` (`rake db:migrate`) or `docker run`
-- [ ] `UpdateService` (updates service to use new task definition)
+## Usage
+
+Example config file:
+```yaml
+applications:
+  dummy-app:
+    repository: git@github.com:outstand/dummy-app
+    cache_bucket: bucket
+    image_name: outstand/dummy-app
+    build_script: shipitron/build.sh
+    post_builds:
+      - ecs_task: dummy-app
+        container_name: dummy-app
+        command: echo postbuild
+    ecs_clusters:
+      - name: us-east-1-prod-blue
+        region: us-east-1
+      - name: us-east-1-prod-green
+        region: us-east-1
+    shipitron_task: shipitron
+    ecs_task_defs:
+      - dummy-app
+    ecs_services:
+      - dummy-app
+```
+
+- Create shipitron.yml file
+- `docker run -it --rm -v shipitron.yml:/shipitron/config/shipitron.yml outstand/shipitron:<version> deploy <app>`
+
+## Development
+
+- `docker volume create --name shipitron_fog`
+- `./build_dev.sh`
+- `docker run -it --rm -v $(pwd):/shipitron -v shipitron_fog:/fog -e FOG_LOCAL=true outstand/shipitron:dev rspec spec` to run specs
+- `docker run -it --rm -v $(pwd):/shipitron outstand/shipitron:dev deploy <app>` to run client side
+- `docker run -it --rm -v $(pwd):/shipitron outstand/shipitron:dev deploy <app> --simulate` to get the arguments for `server_deploy` below
+- `docker run -it --rm --dns 10.10.10.2 -v /path/to/shipitron:/shipitron -v $(pwd):/app -v /bin/docker:/bin/docker -v /var/run/docker.sock:/var/run/docker.sock -v shipitron_fog:/fog -e FOG_LOCAL=true -e CONSUL_HOST=consul outstand/shipitron:dev server_deploy --name dummy-app --repository git@github.com:outstand/dummy-app --bucket outstand-shipitron --image-name outstand/dummy-app --region us-east-1 --cluster-name us-east-1-prod-blue --ecs-task-defs dummy-app --ecs-services dummy-app --build-script shipitron/build.sh --post-builds 'ecs_task:dummy-app,container_name:dummy-app,command:echo postbuild' --ecs-task-def-templates LS0tCmZhbWlseTogZHVtbXktYXBwCmNvbnRhaW5lcl9kZWZpbml0aW9uczoKICAtIG5hbWU6IGR1bW15LWFwcAogICAgaW1hZ2U6IG91dHN0YW5kL2R1bW15LWFwcDp7e3RhZ319CiAgICBtZW1vcnk6IDEyOAogICAgZXNzZW50aWFsOiB0cnVlCiAgICBwb3J0X21hcHBpbmdzOgogICAgICAtIGNvbnRhaW5lcl9wb3J0OiA4MAogICAgZW52aXJvbm1lbnQ6CiAgICAgIC0gbmFtZTogU0VSVklDRV84MF9OQU1FCiAgICAgICAgdmFsdWU6IGR1bW15Cg== --ecs-service-templates LS0tCmNsdXN0ZXI6IHt7Y2x1c3Rlcn19CnNlcnZpY2VfbmFtZTogZHVtbXktYXBwCnRhc2tfZGVmaW5pdGlvbjogZHVtbXktYXBwe3tyZXZpc2lvbn19CmRlc2lyZWRfY291bnQ6IHt7Y291bnR9fQojcm9sZToge3tyb2xlfX0KZGVwbG95bWVudF9jb25maWd1cmF0aW9uOgogIG1heGltdW1fcGVyY2VudDogMjAwCiAgbWluaW11bV9oZWFsdGh5X3BlcmNlbnQ6IDUwCg== --debug` to run server side (dummy-app is an example)
+
+To release a new version:
+- Update the version number in `version.rb` and `Dockerfile.release` and commit the result.
+- `./build_dev.sh`
+- `docker run -it --rm -v ~/.gitconfig:/root/.gitconfig -v ~/.gitconfig.user:/root/.gitconfig.user -v ~/.ssh/id_rsa:/root/.ssh/id_rsa -v ~/.gem:/root/.gem -w /shipitron outstand/shipitron:dev rake release`
+- `docker build -t outstand/shipitron:VERSION -f Dockerfile.release .`
+- `docker push outstand/shipitron:VERSION`

data/build_dev.sh

@@ -0,0 +1,39 @@
+#!/bin/bash
+set -e -x
+
+build_image=outstand/shipitron:dev
+dockerfile=Dockerfile
+bundler_data_dir=tmp
+
+bundler_data_container=''
+tar_container=''
+
+function cleanup {
+  if [ -n "$bundler_data_container" ]; then
+    docker stop bundler-data
+    docker rm -fv bundler-data
+  fi
+
+  if [ -n "$tar_container" ]; then
+    docker rm -fv ${tar_container}
+  fi
+
+  rm -f ${bundler_data_dir}/cidfile
+}
+
+trap cleanup EXIT
+
+build_args=''
+mkdir -p ${bundler_data_dir}
+
+if [ -f $(pwd)/${bundler_data_dir}/bundler-data.tar.gz ]; then
+  docker run --name bundler-data -v $(pwd)/${bundler_data_dir}/bundler-data.tar.gz:/usr/share/nginx/html/bundler-data.tar.gz:ro -d nginx:stable-alpine
+  bundler_data_container=bundler-data
+  build_args="--build-arg bundler_data_host=$(docker inspect --format '{{ .NetworkSettings.IPAddress }}' bundler-data)"
+fi
+
+docker build -t ${build_image} -f ${dockerfile} ${build_args} .
+
+docker run -t --cidfile=${bundler_data_dir}/cidfile -w /usr/local/bundle ${build_image} tar -zcf /tmp/bundler-data.tar.gz .
+tar_container=$(cat ${bundler_data_dir}/cidfile)
+docker cp ${tar_container}:/tmp/bundler-data.tar.gz ${bundler_data_dir}/bundler-data.tar.gz

data/exe/shipitron

@@ -0,0 +1,5 @@
+#!/usr/bin/env ruby
+
+require 'shipitron/cli'
+
+Shipitron::CLI.start

data/lib/shipitron/cli.rb

@@ -0,0 +1,132 @@
+require 'thor'
+require 'shipitron'
+
+module Shipitron
+  class CLI < Thor
+    desc 'version', 'Print out the version string'
+    def version
+      require 'shipitron/version'
+      say Shipitron::VERSION.to_s
+    end
+
+    desc 'deploy <app>', 'Deploys the app'
+    option :config_file, default: 'shipitron/config.yml'
+    option :secrets_file, default: 'shipitron/secrets.yml'
+    option :ember, type: :boolean, default: false
+    option :ember_only, type: :boolean, default: false
+    option :debug, type: :boolean, default: false
+    option :simulate, type: :boolean, default: false
+    def deploy(app)
+      setup(
+        config_file: options[:config_file],
+        secrets_file: options[:secrets_file]
+      )
+
+      require 'shipitron/client/deploy_application'
+      result = Client::DeployApplication.call(
+        application: app,
+        simulate: options[:simulate]
+      )
+
+      if result.failure?
+        result.errors.each do |error|
+          Logger.fatal error
+        end
+        Logger.fatal 'Deploy failed.'
+      end
+    end
+
+    desc 'server_deploy', 'Server-side component of deploy'
+    option :name, required: true
+    option :repository, required: true
+    option :branch, default: 'master'
+    option :bucket, required: true
+    option :image_name, required: true
+    option :region, required: true
+    option :cluster_name, required: true
+    option :ecs_task_defs, type: :array, required: true
+    option :ecs_task_def_templates, type: :array, default: []
+    option :ecs_services, type: :array, required: true
+    option :ecs_service_templates, type: :array, default: []
+    option :build_script, default: nil
+    option :post_builds, type: :array
+    option :secrets_file, default: 'shipitron/secrets.yml'
+    option :debug, type: :boolean, default: false
+    def server_deploy
+      setup(
+        secrets_file: options[:secrets_file]
+      )
+
+      require 'shipitron/server/transform_cli_args'
+      cli_args = Server::TransformCliArgs.call!(
+        application: options[:name],
+        repository_url: options[:repository],
+        repository_branch: options[:branch],
+        s3_cache_bucket: options[:bucket],
+        image_name: options[:image_name],
+        region: options[:region],
+        cluster_name: options[:cluster_name],
+        ecs_task_defs: options[:ecs_task_defs],
+        ecs_task_def_templates: options[:ecs_task_def_templates],
+        ecs_services: options[:ecs_services],
+        ecs_service_templates: options[:ecs_service_templates],
+        build_script: options[:build_script],
+        post_builds: options[:post_builds]
+      ).cli_args
+
+      require 'shipitron/server/deploy_application'
+      result = Server::DeployApplication.call(
+        cli_args
+      )
+
+      if result.failure?
+        result.errors.each do |error|
+          Logger.fatal error
+        end
+        Logger.fatal 'Deploy failed.'
+      end
+    end
+
+    desc 'bootstrap <app>', 'Bootstrap ECS task definitions and services'
+    option :region, required: true
+    option :cluster_name, required: true
+    option :service_count, type: :numeric, default: 3
+    option :task_def_dir, default: 'shipitron/ecs_task_defs'
+    option :service_dir, default: 'shipitron/ecs_services'
+    option :secrets_file, default: 'shipitron/secrets.yml'
+    option :debug, type: :boolean, default: false
+    def bootstrap(app)
+      setup(
+        secrets_file: options[:secrets_file]
+      )
+
+      require 'shipitron/client/bootstrap_application'
+      result = Client::BootstrapApplication.call(
+        application: app,
+        region: options[:region],
+        cluster_name: options[:cluster_name],
+        service_count: options[:service_count],
+        task_def_directory: options[:task_def_dir],
+        service_directory: options[:service_dir]
+      )
+
+      if result.failure?
+        result.errors.each do |error|
+          Logger.fatal error
+        end
+        Logger.fatal 'Bootstrap failed.'
+      end
+    end
+
+    private
+    def setup(config_file:nil, secrets_file:nil)
+      $stdout.sync = true
+      if options[:debug] == false
+        Logger.level = :info
+      end
+
+      Shipitron.config_file = config_file unless config_file.nil?
+      Shipitron.secrets_file = secrets_file unless secrets_file.nil?
+    end
+  end
+end

data/lib/shipitron/client/bootstrap_application.rb

@@ -0,0 +1,35 @@
+require 'shipitron'
+require 'shipitron/client/register_ecs_task_definitions'
+require 'shipitron/client/create_ecs_services'
+
+module Shipitron
+  module Client
+    class BootstrapApplication
+      include Metaractor
+      include Interactor::Organizer
+
+      required :application
+      required :region
+      required :cluster_name
+      required :service_count
+      required :task_def_directory
+      required :service_directory
+
+      organize [
+        RegisterEcsTaskDefinitions,
+        CreateEcsServices
+      ]
+
+      def call
+        Logger.info "==> Bootstrapping #{application}"
+        super
+        Logger.info "==> Done"
+      end
+
+      private
+      def application
+        context.application
+      end
+    end
+  end
+end

data/lib/shipitron/client/create_ecs_services.rb

@@ -0,0 +1,81 @@
+require 'shipitron'
+require 'shipitron/ecs_client'
+require 'shipitron/mustache_yaml_parser'
+
+module Shipitron
+  module Client
+    class CreateEcsServices
+      include Metaractor
+      include EcsClient
+
+      required :region
+      required :service_directory
+      required :cluster_name
+      required :service_count
+
+      def call
+        Logger.info 'Creating ECS services'
+
+        service_defs = Pathname.new(service_directory)
+        unless service_defs.directory?
+          fail_with_error!(
+            message: "service directory '#{service_directory}' does not exist"
+          )
+        end
+
+        service_defs.find do |path|
+          next if path.directory?
+
+          service_def = Smash.load(
+            path.to_s,
+            parser: MustacheYamlParser.new(
+              context: {
+                cluster: cluster_name,
+                revision: nil, # ECS will default to latest ACTIVE
+                count: service_count
+              }
+            )
+          ).merge(
+            client_token: SecureRandom.uuid
+          )
+
+          Logger.info "Creating service '#{service_def.service_name}'"
+          Logger.debug "Service definition: #{service_def.to_h}"
+          begin
+            ecs_client(region: region).create_service(
+              service_def.to_h
+            )
+          rescue Aws::ECS::Errors::InvalidParameterException => e
+            raise if e.message != 'Creation of service was not idempotent.'
+
+            Logger.info "Service '#{service_def.service_name}' already exists."
+          end
+        end
+
+        Logger.info 'Done'
+      rescue Aws::ECS::Errors::ServiceError => e
+        fail_with_errors!(messages: [
+          "Error: #{e.message}",
+          e.backtrace.join("\n")
+        ])
+      end
+
+      private
+      def region
+        context.region
+      end
+
+      def service_directory
+        context.service_directory
+      end
+
+      def cluster_name
+        context.cluster_name
+      end
+
+      def service_count
+        context.service_count
+      end
+    end
+  end
+end

data/lib/shipitron/client/deploy_application.rb

@@ -0,0 +1,34 @@
+require 'shipitron'
+require 'shipitron/client/load_application_config'
+require 'shipitron/client/load_templates'
+require 'shipitron/client/ensure_deploy_not_running'
+require 'shipitron/client/run_ecs_tasks'
+
+module Shipitron
+  module Client
+    class DeployApplication
+      include Metaractor
+      include Interactor::Organizer
+
+      required :application
+
+      organize [
+        LoadApplicationConfig,
+        LoadTemplates,
+        EnsureDeployNotRunning,
+        RunEcsTasks
+      ]
+
+      def call
+        Logger.info "==> Deploying #{application}"
+        super
+        Logger.info "==> Done"
+      end
+
+      private
+      def application
+        context.application
+      end
+    end
+  end
+end

data/lib/shipitron/client/ensure_deploy_not_running.rb

@@ -0,0 +1,54 @@
+require 'shipitron'
+require 'shipitron/ecs_client'
+
+# Note: This is a best effort client side check to make sure there
+# isn't a deploy running.  The server side check has more guarantees.
+
+module Shipitron
+  module Client
+    class EnsureDeployNotRunning
+      include Metaractor
+      include EcsClient
+
+      required :clusters
+      optional :simulate
+
+      def call
+        return if simulate?
+
+        clusters.each do |cluster|
+          %w[PENDING RUNNING].each do |status|
+            begin
+              response = ecs_client(region: cluster.region).list_tasks(
+                cluster: cluster.name,
+                started_by: 'shipitron',
+                max_results: 1,
+                desired_status: status
+              )
+              if !response.task_arns.empty?
+                fail_with_errors!(messages: [
+                  'Shipitron says "THERE CAN BE ONLY ONE"',
+                  'Deploy is already running.'
+                ])
+              end
+            rescue Aws::ECS::Errors::ClusterNotFoundException
+              fail_with_errors!(messages: [
+                'Shipitron says "PUNY HUMAN IS MISSING A CLUSTER"',
+                "Cluster '#{cluster.name}' not found in region #{cluster.region}."
+              ])
+            end
+          end
+        end
+      end
+
+      private
+      def clusters
+        context.clusters
+      end
+
+      def simulate?
+        context.simulate == true
+      end
+    end
+  end
+end

data/lib/shipitron/client/load_application_config.rb

@@ -0,0 +1,41 @@
+require 'shipitron'
+require 'shipitron/post_build'
+
+module Shipitron
+  module Client
+    class LoadApplicationConfig
+      include Metaractor
+
+      required :application
+
+      def call
+        context.repository_url = config.repository
+        context.s3_cache_bucket = config.cache_bucket
+        context.image_name = config.image_name
+        context.build_script = config.build_script
+        context.post_builds = begin
+                                if config.post_builds.nil?
+                                  []
+                                else
+                                  config.post_builds.map {|pb| PostBuild.new(pb) }
+                                end
+                              end
+        context.clusters = config.ecs_clusters
+        context.shipitron_task = config.shipitron_task
+        context.ecs_task_defs = config.ecs_task_defs
+        context.ecs_services = config.ecs_services
+        context.ecs_task_def_dir = config.ecs_task_def_dir
+        context.ecs_service_dir = config.ecs_service_dir
+      end
+
+      private
+      def application
+        context.application
+      end
+
+      def config
+        @config ||= Shipitron.config.applications[application]
+      end
+    end
+  end
+end

data/lib/shipitron/client/load_templates.rb

@@ -0,0 +1,45 @@
+require 'shipitron'
+
+module Shipitron
+  module Client
+    class LoadTemplates
+      include Metaractor
+
+      required :ecs_task_def_dir
+      required :ecs_service_dir
+
+      def call
+        context.ecs_task_def_templates = load_templates(ecs_task_def_dir)
+        context.ecs_service_templates = load_templates(ecs_service_dir)
+      end
+
+      private
+      def ecs_task_def_dir
+        context.ecs_task_def_dir
+      end
+
+      def ecs_service_dir
+        context.ecs_service_dir
+      end
+
+      def load_templates(dir)
+        search_path = Pathname.new(dir)
+        unless search_path.directory?
+          fail_with_error!(
+            message: "directory '#{dir}' does not exist"
+          )
+        end
+
+        templates = []
+        search_path.find do |path|
+          next if path.directory?
+
+          templates << path.read
+        end
+
+        Logger.debug "Templates loaded: #{templates.inspect}"
+        templates
+      end
+    end
+  end
+end