concourse 0.24.0 → 0.25.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 69454c7a7cfcaa97aa0ae0e60154643107ec31e27f4870fb2c03e3cb5cf8e53a
-  data.tar.gz: b2d936d3806d0725a78549f984b5d25bd0bb02bb171d6cbcb13b47ecf0c61bf3
+  metadata.gz: d4b1fac24b6a006de483423b88d279800eace3d340f06ff3e44bd245c06b56ae
+  data.tar.gz: c31951fe43411e6b9249d78e084f5e06c65e1003a8529c4b695df265bf61f30d
 SHA512:
-  metadata.gz: 279c5aea4104ccb041bbfa02700625356dc31dbdf2e21f0c9f2cdd928883108f55f149609f06cc7e7a174434abc899760e744c50423ebca1753ab514fae52130
-  data.tar.gz: d298b46e242c2230984d7b7e503fd82ab6fd4ff6aa6d1b2803e6fd9731fa5733f1ac27ae53f7a6050c73269d9fb193b5f18f7f0b0581f2f194e6e07b52f03f93
+  metadata.gz: ffb2453c377421f1f7b35f2eafb17e8933471d716525c7bd8c7edf05d5839a280198b17d356d365e3fc96e7f6dcf4b5b02b5443a5a5e70894201ba76c52448fb
+  data.tar.gz: 9a136ccc848d40e06e58a8d98bf5a36dec2fdb814f2a423cbe9910b032763ca79b78d455cdb2ec261d9e81a078987e5a22831cd0ee95566e951ec2a9e90e6774

data/CHANGELOG.md

@@ -1,5 +1,10 @@
 # concourse-gem changelog
 
+## 0.25.0 / 2019-02-02
+
+* Support running a local ephemeral Concourse cluster with `docker-compose`.
+
+
 ## 0.24.0 / 2019-01-24
 
 ### Features

data/README.md

@@ -1,6 +1,6 @@
 # concourse (the rubygem)
 
-The `concourse` gem provides rake tasks to help you manage Concourse pipelines, jobs, and workers, and to assist in running tasks with `fly execute`.
+The `concourse` gem provides rake tasks to help you manage Concourse pipelines, jobs, and workers, to assist in running tasks with `fly execute`, and even run a local ephemeral deployment of Concourse on your development machine.
 
 If you're not familiar with Concourse CI, you can read up on it at https://concourse.ci
 
@@ -31,6 +31,10 @@ If you're not familiar with Concourse CI, you can read up on it at https://conco
   * [Run a Concourse task with `fly execute`](#run-a-concourse-task-with-fly-execute)
   * [Abort running builds](#abort-running-builds)
   * [Prune stalled concourse workers](#prune-stalled-concourse-workers)
+- [Running a local ephemeral Concourse](#running-a-local-ephemeral-concourse)
+  * [Spinning up a local deployment](#spinning-up-a-local-deployment)
+  * [Doing things with the local deployment](#doing-things-with-the-local-deployment)
+  * [Shutting down the local deployment](#shutting-down-the-local-deployment)
 - [Contributing](#contributing)
 - [License](#license)
 
@@ -319,6 +323,45 @@ rake concourse:prune-stalled-workers  # prune any stalled workers
 ```
 
 
+## Running a local ephemeral Concourse
+
+You can run a local Concourse deployment on your development system, if you have `docker` and `docker-compose` installed.
+
+
+### Spinning up a local deployment
+
+To spin up the local cluster:
+
+``` sh
+rake concourse:local:up
+```
+
+You can view that Concourse deployment at `http://127.0.0.1:8080` using the credentials `test`/`test`.
+
+
+### Doing things with the local deployment
+
+To target that local cluster, simply prepend the `concourse:local` task on the command line. For example, to `fly execute` a task on the local cluster:
+
+``` sh
+rake concourse:local concourse:task[ruby-2.4/rake-task]
+```
+
+Or to push your pipelines to that local cluster:
+
+``` sh
+rake concourse:local concourse:set
+```
+
+### Shutting down the local deployment
+
+Finally, to spin down the cluster (when you're done with it):
+
+``` sh
+rake concourse:local:down
+```
+
+
 ## Contributing
 
 Bug reports and pull requests are welcome on GitHub at https://github.com/flavorjones/concourse-gem. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct. See [`CODE_OF_CONDUCT.md`](CODE_OF_CONDUCT.md).

data/lib/concourse.rb

@@ -3,6 +3,7 @@ require "concourse/util"
 require "concourse/pipeline"
 require "yaml"
 require "tempfile"
+require "open-uri"
 
 class Concourse
   include Rake::DSL
@@ -17,6 +18,8 @@ class Concourse
   }
 
   DEFAULT_DIRECTORY = "concourse"
+  DEFAULT_FLY_TARGET = "default"
+  DEFAULT_SECRETS = "private.yml"
 
   attr_reader :project_name
   attr_reader :directory
@@ -24,6 +27,8 @@ class Concourse
   attr_reader :fly_target
   attr_reader :secrets_filename
 
+  CONCOURSE_DOCKER_COMPOSE = "docker-compose.yml"
+
   def self.url_for fly_target
     matching_line = `fly targets`.split("\n").grep(/^#{fly_target}/).first
     raise "invalid fly target #{fly_target}" unless matching_line
@@ -50,9 +55,9 @@ class Concourse
     @project_name = project_name
 
     @directory = options[:directory] || DEFAULT_DIRECTORY
-    @fly_target = options[:fly_target] || "default"
+    @fly_target = options[:fly_target] || DEFAULT_FLY_TARGET
 
-    base_secrets_filename = options[:secrets_filename] || "private.yml"
+    base_secrets_filename = options[:secrets_filename] || DEFAULT_SECRETS
     @secrets_filename = File.join(@directory, base_secrets_filename)
 
     @pipelines = []
@@ -85,7 +90,32 @@ class Concourse
     File.open pipeline.filename, "w" do |f|
       f.write erbify_file(pipeline.erb_filename, working_directory: directory)
     end
-    sh "fly validate-pipeline -c #{pipeline.filename}"
+    fly "validate-pipeline -c #{pipeline.filename}"
+  end
+
+  def rake_concourse_local
+    ensure_docker_compose_file
+    @fly_target = "local"
+    fly "login -u test -p test -c http://127.0.0.1:8080"
+  end
+
+  def ensure_docker_compose_file
+    return if File.exist?(docker_compose_path)
+    note "fetching docker compose file ..."
+    File.open(docker_compose_path, "w") do |f|
+      f.write open("https://concourse-ci.org/docker-compose.yml").read
+    end
+  end
+
+  def rake_concourse_local_up
+    ensure_docker_compose_file
+    docker_compose "up -d"
+    docker_compose "ps"
+  end
+
+  def rake_concourse_local_down
+    ensure_docker_compose_file
+    docker_compose "down"
   end
 
   def create_tasks!
@@ -137,7 +167,7 @@ class Concourse
             note "using #{secrets_filename} to resolve template vars in #{pipeline.filename}"
             options << "-l '#{secrets_filename}'"
           end
-          sh "fly -t #{fly_target} set-pipeline #{options.join(" ")}"
+          fly "set-pipeline #{options.join(" ")}"
         end
       end
 
@@ -148,7 +178,7 @@ class Concourse
         pipelines.each do |pipeline|
           desc "#{command} the #{pipeline.name} pipeline"
           task "#{command}:#{pipeline.name}" do
-            sh "fly -t #{fly_target} #{command}-pipeline -p #{pipeline.name}"
+            fly "#{command}-pipeline -p #{pipeline.name}"
           end
         end
       end
@@ -194,7 +224,7 @@ class Concourse
           f.write concourse_task["config"].to_yaml
           f.close
           Bundler.with_clean_env do
-            sh "fly -t #{fly_target} execute #{fly_execute_args} -c #{f.path}"
+            fly "execute #{fly_execute_args} -c #{f.path}"
           end
         end
       end
@@ -208,7 +238,7 @@ class Concourse
           pipeline_job, build_id, status = *line.split(/\s+/)[1,3]
           next unless status == "started"
 
-          sh "fly -t #{fly_target} abort-build -j #{pipeline_job} -b #{build_id}"
+          fly "abort-build -j #{pipeline_job} -b #{build_id}"
         end
       end
 
@@ -219,7 +249,26 @@ class Concourse
       task "prune-stalled-workers" do
         `fly -t #{fly_target} workers | fgrep stalled`.each_line do |line|
           worker_id = line.split.first
-          system("fly -t #{fly_target} prune-worker -w #{worker_id}")
+          fly "prune-worker -w #{worker_id}"
+        end
+      end
+
+      #
+      #  docker commands
+      #
+      task "local" do
+        rake_concourse_local
+      end
+
+      namespace "local" do
+        desc "start up a docker-compose cluster for local CI"
+        task "up" do
+          rake_concourse_local_up
+        end
+
+        desc "shut down the docker-compose cluster"
+        task "down" do
+          rake_concourse_local_down
         end
       end
     end

data/lib/concourse/util.rb

@@ -18,6 +18,18 @@ class Concourse
       File.open(GITIGNORE_FILE, "a") { |f| f.puts file_glob }
     end
 
+    def fly command
+      sh "fly -t #{fly_target} #{command}"
+    end
+
+    def docker_compose command
+      sh "docker-compose -f #{docker_compose_path} #{command}"
+    end
+
+    def docker_compose_path
+      File.join(directory, CONCOURSE_DOCKER_COMPOSE)
+    end
+
     def sh command
       running "(in #{Dir.pwd}) #{command}"
       Rake.sh command, verbose: false

data/lib/concourse/version.rb

@@ -2,5 +2,5 @@ require "rake"
 require "erb"
 
 class Concourse
-  VERSION = "0.24.0"
+  VERSION = "0.25.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: concourse
 version: !ruby/object:Gem::Version
-  version: 0.24.0
+  version: 0.25.0
 platform: ruby
 authors:
 - Mike Dalessio
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2019-01-25 00:00:00.000000000 Z
+date: 2019-02-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: term-ansicolor