appengine 0.4.3 → 0.4.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 2f0b0ccf502def04a72e834f3086b4d49067616e
-  data.tar.gz: 6911772b6e335e325cb7569d4bc83e2662888974
+  metadata.gz: d298df52ab28ad90dbfa6b51f3bf960d2ba63793
+  data.tar.gz: 1be692b4bd2c5099004e59e2e429d0d8092d35d8
 SHA512:
-  metadata.gz: 1e2144f96a6afb55b57933f1c5f8603df938a23bdaa778ba7b2bf5c7e1040dc410abf1941d1ee8b2724dce8e7b188372e50f3fef5d18ef2e4c3f50b9bb6d1b96
-  data.tar.gz: 747253cd3457c8ec7c9aa909c1927e5e622d49df4baab4649a9a4930b4b8d16666d056cea9056fda78fab43379e093111ea4f180b8b70f4434f44d3c92fcc79e
+  metadata.gz: 8e0821d8d628018e27e4bafa2274f919a2bce599cc3feef9dea46192c12ca4efa6f4646e942183c37cd00338b9f6364d0d3d3293332138c258663a482ac27d0a
+  data.tar.gz: 281b510a47e74e2faecd180552e7a5d4c22de52942b48dd0aec87f988b0ac1bcf01e83e2f9b364423f031ed1f96ae8cafc3e7d7ddfce59a1bfe8749e8a98e31a

data/CHANGELOG.md

@@ -2,6 +2,10 @@
 
 This is the change history for the appengine gem.
 
+## v0.4.4 (2017-10-03)
+
+*   Windows compatibility for appengine:exec task. (gkaykck)
+
 ## v0.4.3 (2017-09-20)
 
 *   Fixed incorrect namespace in the handler for gcloud errors.

data/README.md

@@ -32,6 +32,10 @@ To install, include the "appengine" gem in your Gemfile. e.g.
 
     gem "appengine"
 
+## Quick Start
+
+### Rails Quick Start
+
 If you are running [Ruby On Rails](http://rubyonrails.org/) 4.0 or later, this
 gem will automatically install a Railtie that provides its capabilities. You
 may need to include the line:
@@ -41,10 +45,40 @@ may need to include the line:
 in your `config/application.rb` file if you aren't already requiring all
 bundled gems.
 
-If you are running a different web framework, you may need to add some
-initialization code to activate the features listed below.
+### Rack Quick Start
+
+If you are running a different Rack-based web framework, include the following
+line in your main Ruby file or `config.ru`:
+
+    require "appengine"
+
+Then, to activate Stackdriver instrumentation, add the following middleware:
+
+    use Google::Cloud::Logging::Middleware
+    use Google::Cloud::ErrorReporting::Middleware
+    use Google::Cloud::Trace::Middleware
+    use Google::Cloud::Debugger::Middleware
 
-## Logging and monitoring
+You can add the Rake tasks to your application by adding the following to your
+Rakefile:
+
+    require "appengine/tasks"
+
+### Necessary permissions for remote execution rake tasks
+
+If you are using the `appengine:exec` rake task, you may need to grant
+additional permissions to the Cloud Container Builder service account that
+runs the task, especially if you are using Cloud SQL (which is not covered by
+the default permissions granted to the account). If your task is failing with
+authorization errors, pen the
+[IAM tab](https://pantheon.corp.google.com/iam-admin/iam/project) of the
+cloud console, select your project, and find the service account with the name
+`[your-project-number]@cloudbuild.gserviceaccount.com`. Add the Project Editor
+role to this service account.
+
+## Using this library
+
+### Logging and monitoring
 
 This library automatically installs the "stackdriver" gem, which instruments
 your application to report logs, unhandled exceptions, and latency traces to
@@ -54,16 +88,19 @@ monitoring features of Google App Engine, see:
 * [google-cloud-logging instrumentation](http://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud-logging/latest/guides/instrumentation)
 * [google-cloud-error_reporting instrumentation](http://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud-error_reporting/latest/guides/instrumentation)
 * [google-cloud-trace instrumentation](http://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud-trace/latest/guides/instrumentation)
+* [google-cloud-debugger instrumentation](http://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud-debugger/latest/guides/instrumentation)
 
 Rails applications automatically activate this instrumentation when the gem
 is present. You may opt out of individual services by providing appropriate
 Rails configuration. See {AppEngine::Railtie} for more information.
 
 Non-Rails applications must provide initialization code to activate this
-instrumentation, typically by installing a Rack middleware. See the individual
-service documentation links above for more information.
+instrumentation, typically by installing a Rack middleware. You can find the
+basic code for installing these middlewares in the Rack Quick Start section
+above. See the individual service documentation links above for more
+information and configuration options.
 
-## App Engine remote execution
+### App Engine remote execution
 
 This library provides rake tasks for App Engine remote execution, allowing
 App Engine applications to perform on-demand tasks in the App Engine
@@ -86,6 +123,11 @@ tasks are available automatically in Rails applications when the gem is
 present. Non-Rails applications may install the tasks by adding the line
 `require "appengine/tasks"` to the `Rakefile`.
 
+Note that you may need to grant additional roles to the Container Builder
+service account that runs your tasks. If your task is failing with API
+authorization errors, try granting the Project Editor role to the CloudBuild
+service account.
+
 ## Development and support
 
 The source code for this gem is available on Github at

data/lib/appengine/exec.rb

@@ -15,6 +15,7 @@
 
 require "yaml"
 require "json"
+require "shellwords"
 
 require "appengine/util/gcloud"
 
@@ -113,7 +114,7 @@ module AppEngine
     @default_timeout = "10m".freeze
     @default_service = "default".freeze
     @default_config_path = "./app.yaml".freeze
-    @default_wrapper_image = "gcr.io/google-appengine/exec-wrapper".freeze
+    @default_wrapper_image = "gcr.io/google-appengine/exec-wrapper:latest".freeze
 
 
     ##

data/lib/appengine/util/gcloud.rb

@@ -78,8 +78,12 @@ module AppEngine
         #
         def binary_path
           unless defined? @binary_path
-            @binary_path = `which gcloud`.strip
-            @binary_path = nil if @binary_path.empty?
+            if Gem.win_platform?
+              @binary_path = `where gcloud` == '' ? nil : 'gcloud'
+            else
+              @binary_path = `which gcloud`.strip
+              @binary_path = nil if @binary_path.empty?
+            end
           end
           @binary_path
         end
@@ -162,7 +166,8 @@ module AppEngine
         #     depending on the value of the `capture` parameter.
         #
         def execute args, echo: false, capture: false, assert: true
-          joined_args = ::Shellwords.join args
+          joined_args = Gem.win_platform? ? args.join(" ") : Shellwords.join(args)
+
           cmd = "#{binary_path!} #{joined_args}"
           puts cmd if echo
           result = capture ? `#{cmd}` : system(cmd)

data/lib/appengine/version.rb

@@ -16,6 +16,6 @@
 module AppEngine
 
   # The current version of this gem, as a string.
-  VERSION = '0.4.3'.freeze
+  VERSION = '0.4.4'.freeze
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: appengine
 version: !ruby/object:Gem::Version
-  version: 0.4.3
+  version: 0.4.4
 platform: ruby
 authors:
 - Daniel Azuma
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-09-20 00:00:00.000000000 Z
+date: 2017-10-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-cloud-env