fastlane-plugin-wpmreleasetoolkit 13.1.2 → 13.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 58554aababcf0bef878ca3af98c8380c5a90f03ece833bfb3686e12f9f34bbf1
-  data.tar.gz: 65889ef19ebb737a8bc141c05ff86cf86974af4cc63c5c5735d4b03faf263380
+  metadata.gz: b96cfe534c654f80942c7623819cac09dd3241fc5ba706a21c0ed3db1eef26aa
+  data.tar.gz: 22a84da84041c275c535beac3f347a432a793b4dc3690df855c29771e78b8483
 SHA512:
-  metadata.gz: 89f80c2ff710910c5c24c4971bcd44a508d33db3f6bb6944fd37a337202b2c320175fd7a844e1f293900831e92258e355680b8ddbebf47a0a5dee27003df1c92
-  data.tar.gz: 0a7a0c11bdbd423900d8bfbbc0f4b03740480992984a56138c57fd018d574204af27a5b9cd44a43598285cbe128b2d78d895ee66eeaa79a4cc78909df4d28d3b
+  metadata.gz: 5d2ef6a47af19fb7370eb894fa9db53d39a1688bc8c862269243702e8f91ebbf68060478653311b5989d46c39ce86e1308675ed4153b9aecb9350e5bc45f1214
+  data.tar.gz: 6833e063d42b40d2f6aa2f6f918b8ecab482f8fdca7ca28871b9f0b024f8250a7ce21339f2844c8d4ed23ac29783126491db97aa34204fcb790efff7eb3f69e1

data/lib/fastlane/plugin/wpmreleasetoolkit/actions/common/buildkite_add_trigger_step_action.rb

@@ -0,0 +1,171 @@
+# frozen_string_literal: true
+
+require 'open3'
+
+module Fastlane
+  module Actions
+    class BuildkiteAddTriggerStepAction < Action
+      BUILDKITE_ENV_ERROR_MESSAGE = 'This action can only be run from within a Buildkite build'
+
+      def self.run(params)
+        unless ENV.key?('BUILDKITE_JOB_ID')
+          UI.user_error!(BUILDKITE_ENV_ERROR_MESSAGE)
+        end
+
+        # Extract parameters
+        pipeline_file = params[:pipeline_file]
+        build_name = File.basename(pipeline_file, '.yml')
+        message = params[:message] || build_name
+        branch = params[:branch] || sh('git', 'rev-parse', '--abbrev-ref', 'HEAD').strip
+        environment = params[:environment] || {}
+        buildkite_pipeline_slug = params[:buildkite_pipeline_slug]
+        async = params[:async]
+        label = params[:label] || ":buildkite: Trigger #{build_name} on #{branch}"
+        depends_on = params[:depends_on]&.then { |v| v.empty? ? nil : Array(v) }
+
+        # Add the PIPELINE environment variable to the environment hash
+        environment = environment.merge('PIPELINE' => pipeline_file)
+
+        # Create the trigger step YAML
+        trigger_yaml = {
+          'steps' => [
+            {
+              'trigger' => buildkite_pipeline_slug,
+              'label' => label,
+              'async' => async,
+              'build' => {
+                'branch' => branch,
+                'message' => message,
+                'env' => environment
+              },
+              'depends_on' => depends_on
+            }.compact,
+          ]
+        }.to_yaml
+
+        # Use buildkite-agent to upload the pipeline
+        _stdout, stderr, status = Open3.capture3('buildkite-agent', 'pipeline', 'upload', stdin_data: trigger_yaml)
+
+        # Check for errors
+        UI.user_error!("Failed to upload pipeline: #{stderr}") unless status.success?
+
+        # Log success
+        UI.success("Added a trigger step to the current Buildkite build to start a new build for #{pipeline_file} on branch #{branch}")
+      end
+
+      def self.description
+        'Adds a trigger step to the current Buildkite pipeline to start a new build from this one'
+      end
+
+      def self.details
+        <<~DETAILS
+          This action adds a `trigger` step to the current Buildkite build, to start a separate build from the current one.
+
+          This is slightly different from `buildkite-agent pipeline upload`-ing the YAML steps of the build directly to the current build,
+            as this approach ensures the triggered build starts from a clean and independent context.
+            - This is particularly important if the build being triggered rely on the fact that the current build pushed new commits
+              to the Git branch and we want the new build's steps to start from the new commit.
+            - This is also necessary for cases where we run builds on a mirror of the original Git repo (e.g. for pipelines of repos hosted
+              in a private GitHub Enterprise server, mirrored on GitHub.com for CI building purposes) and we want the new build being triggered
+              to initiate a new sync of the Git repo as part of the CI build bootstrap process, to get the latest commits.
+        DETAILS
+      end
+
+      def self.available_options
+        [
+          FastlaneCore::ConfigItem.new(
+            key: :buildkite_pipeline_slug,
+            env_name: 'BUILDKITE_PIPELINE_SLUG',
+            description: 'The slug of the Buildkite pipeline to trigger. Defaults to the same slug as the current pipeline, so usually not necessary to provide explicitly',
+            type: String,
+            optional: false # But most likely to be auto-provided by the ENV var of the current build and thus not needed to be provided explicitly
+          ),
+          FastlaneCore::ConfigItem.new(
+            key: :label,
+            description: 'Custom label for the trigger step. If not provided, defaults to ":buildkite: Trigger {`pipeline_file`\'s basename} on {branch}"',
+            type: String,
+            optional: true
+          ),
+          FastlaneCore::ConfigItem.new(
+            key: :pipeline_file,
+            description: 'The path (relative to `.buildkite/`) to the pipeline YAML file to use for the triggered build',
+            type: String,
+            optional: false
+          ),
+          FastlaneCore::ConfigItem.new(
+            key: :branch,
+            description: 'The branch to trigger the build on. Defaults to the Git branch currently checked out at the time of running the action (which is not necessarily the same as the `BUILDKITE_BRANCH` the current build initially started on)',
+            type: String,
+            optional: true
+          ),
+          FastlaneCore::ConfigItem.new(
+            key: :message,
+            description: 'The message / title to use for the triggered build. If not provided, defaults to the `pipeline_file`\'s basename',
+            type: String,
+            optional: true
+          ),
+          FastlaneCore::ConfigItem.new(
+            key: :environment,
+            description: 'Environment variables to pass to the triggered build (in addition to the PIPELINE={pipeline_file} that will be automatically injected)',
+            type: Hash,
+            default_value: {},
+            optional: true
+          ),
+          FastlaneCore::ConfigItem.new(
+            key: :async,
+            description: 'Whether to trigger the build asynchronously (true) or wait for it to complete (false). Defaults to false',
+            type: Boolean,
+            default_value: false
+          ),
+          FastlaneCore::ConfigItem.new(
+            key: :depends_on,
+            env_name: 'BUILDKITE_STEP_KEY', # This is the env var that Buildkite sets for the current step
+            description: 'The steps to depend on before triggering the build. Defaults to the current step this action is called from, if said step has a `key:` attribute set. Use an empty array to explicitly not depend on any step even if the current step has a `key`',
+            type: Array,
+            default_value: [],
+            optional: true
+          ),
+        ]
+      end
+
+      def self.return_value
+        'Returns true if the pipeline was successfully uploaded. Throws a `user_error!` if it failed to upload the `trigger` step to the current build'
+      end
+
+      def self.authors
+        ['Automattic']
+      end
+
+      def self.is_supported?(platform)
+        true
+      end
+
+      def self.example_code
+        [
+          <<~CODE,
+            # Use default/inferred values for most parameters
+            buildkite_add_trigger_step(
+              pipeline_file: "release-build.yml",
+              environment: { "RELEASE_VERSION" => "1.2.3" },
+            )
+          CODE
+          <<~CODE,
+            # Use custom values for most parameters
+            buildkite_add_trigger_step(
+              label: "🚀 Trigger Release Build",
+              pipeline_file: "release-build.yml",
+              branch: "release/1.2.3",
+              message: "Release Build (123)",
+              environment: { "RELEASE_VERSION" => "1.2.3" },
+              async: false,
+            )
+          CODE
+        ]
+      end
+
+      def self.category
+        :building
+      end
+    end
+  end
+end

data/lib/fastlane/plugin/wpmreleasetoolkit/version.rb

@@ -2,6 +2,6 @@
 
 module Fastlane
   module Wpmreleasetoolkit
-    VERSION = '13.1.2'
+    VERSION = '13.2.0'
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: fastlane-plugin-wpmreleasetoolkit
 version: !ruby/object:Gem::Version
-  version: 13.1.2
+  version: 13.2.0
 platform: ruby
 authors:
 - Automattic
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-04-15 00:00:00.000000000 Z
+date: 2025-05-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -404,6 +404,7 @@ files:
 - lib/fastlane/plugin/wpmreleasetoolkit/actions/android/android_send_app_size_metrics.rb
 - lib/fastlane/plugin/wpmreleasetoolkit/actions/android/android_shutdown_emulator_action.rb
 - lib/fastlane/plugin/wpmreleasetoolkit/actions/android/android_update_release_notes.rb
+- lib/fastlane/plugin/wpmreleasetoolkit/actions/common/buildkite_add_trigger_step_action.rb
 - lib/fastlane/plugin/wpmreleasetoolkit/actions/common/buildkite_annotate_action.rb
 - lib/fastlane/plugin/wpmreleasetoolkit/actions/common/buildkite_metadata_action.rb
 - lib/fastlane/plugin/wpmreleasetoolkit/actions/common/buildkite_pipeline_upload_action.rb