Expose --remote-executor-image in the Automation API (#587)

Forgot about this one, as it wasn't listed on the ticket. This PR makes
the `--remote-executor-image` flags accessible in the `dotnet`
Automation API.

* pulumi/pulumi#19286
* pulumi/pulumi#15697
* pulumi/pulumi#19304

Fixes pulumi/pulumi#15693.

---------

Co-authored-by: Thomas Gummerer <t.gummerer@gmail.com>

Author: i-am-tom

.changes/unreleased/Improvements-587.yaml

@@ -0,0 +1,6 @@
+component: sdk/auto
+kind: Improvements
+body: Expose `--remote-executor-*` flags in the Automation API
+time: 2025-05-06T15:07:46.076901+02:00
+custom:
+    PR: "587"

sdk/Pulumi.Automation/DockerImageCredentials.cs

@@ -0,0 +1,26 @@
+// Copyright 2016-2025, Pulumi Corporation
+
+namespace Pulumi.Automation
+{
+    /// <summary>
+    /// Credentials for the remote execution Docker image.
+    /// </summary>
+    public class DockerImageCredentials
+    {
+        /// <summary>
+        /// The username for the image.
+        /// </summary>
+        public string Username { get; set; }
+
+        /// <summary>
+        /// The password for the image.
+        /// </summary>
+        public string Password { get; set; }
+
+        public DockerImageCredentials(string username, string password)
+        {
+            this.Username = username;
+            this.Password = password;
+        }
+    }
+}

sdk/Pulumi.Automation/ExecutorImage.cs

@@ -0,0 +1,25 @@
+// Copyright 2016-2025, Pulumi Corporation
+
+namespace Pulumi.Automation
+{
+    /// <summary>
+    /// Information about the remote execution image.
+    /// </summary>
+    public class ExecutorImage
+    {
+        public ExecutorImage(string image)
+        {
+            this.Image = image;
+        }
+
+        /// <summary>
+        /// The Docker image to use.
+        /// </summary>
+        public string Image { get; set; }
+
+        /// <summary>
+        /// Credentials for the remote execution Docker image.
+        /// </summary>
+        public DockerImageCredentials? Credentials { get; set; }
+    }
+}

sdk/Pulumi.Automation/LocalWorkspace.cs

@@ -39,6 +39,7 @@ public sealed class LocalWorkspace : Workspace
         private readonly IDictionary<string, EnvironmentVariableValue>? _remoteEnvironmentVariables;
         private readonly IList<string>? _remotePreRunCommands;
         private readonly bool _remoteSkipInstallDependencies;
+        private readonly ExecutorImage? _remoteExecutorImage;
 
         internal Task ReadyTask { get; }
 
@@ -334,6 +335,7 @@ internal LocalWorkspace(
                 this.Remote = options.Remote;
                 this._remoteGitProgramArgs = options.RemoteGitProgramArgs;
                 this._remoteSkipInstallDependencies = options.RemoteSkipInstallDependencies;
+                this._remoteExecutorImage = options.RemoteExecutorImage;
 
                 if (options.EnvironmentVariables != null)
                     this.EnvironmentVariables = new Dictionary<string, string?>(options.EnvironmentVariables);
@@ -1004,6 +1006,21 @@ internal IReadOnlyList<string> GetRemoteArgs()
                 args.Add("--remote-skip-install-dependencies");
             }
 
+            if (_remoteExecutorImage != null)
+            {
+                args.Add("--remote-executor-image");
+                args.Add(_remoteExecutorImage.Image);
+
+                if (_remoteExecutorImage.Credentials != null)
+                {
+                    args.Add("--remote-executor-image-username");
+                    args.Add(_remoteExecutorImage.Credentials.Username);
+
+                    args.Add("--remote-executor-image-password");
+                    args.Add(_remoteExecutorImage.Credentials.Password);
+                }
+            }
+
             return args;
         }
 

sdk/Pulumi.Automation/LocalWorkspaceOptions.cs

@@ -91,6 +91,11 @@ public class LocalWorkspaceOptions
         /// </summary>
         internal IList<string>? RemotePreRunCommands { get; set; }
 
+        /// <summary>
+        /// Optional information about a remote execution image.
+        /// </summary>
+        internal ExecutorImage? RemoteExecutorImage { get; set; }
+
         /// <summary>
         /// Whether to skip the default dependency installation step.
         /// </summary>

sdk/Pulumi.Automation/Pulumi.Automation.xml

@@ -34,5 +34,10 @@ public IList<string> PreRunCommands
         /// Whether to skip the default dependency installation step.
         /// </summary>
         public bool SkipInstallDependencies { get; set; }
+
+        /// <summary>
+        /// Information about a remote execution image.
+        /// </summary>
+        public ExecutorImage? ExecutorImage { get; set; }
     }
 }