Skip to content
Proud to collaborate with Microsoft for Startups

runner.environment-scale-gce ​

Set the target size of the GCE MIG backing a runner group (native scale).

Overview ​

PropertyValue
Workflow typeDag
LibraryApp-runners
Version1.0

Input Schema ​

FieldTypeRequiredDefaultDescription
runner_group_uuiduuidYes—UUID of the RunnerGroup this wrapper step operates on, picked from the organization's list of runner groups.
organization_uuiduuidNo—UUID of the caller's organization, injected server-side from the authenticated request; scopes the operation to the correct tenant. Optional here because this wrapper step is invoked programmatically by a parent DAG, which forwards it from its own context rather than the caller supplying it directly.
workflow_run_uuidstringNo—DAG run id forwarded by the parent step's action_start. Engine workflow-run identifier; not a platform entity foreign key despite the name. System-generated, no source needed.
workflow_run_idstringNo—Engine DAG run id forwarded by child step execution.
new_desired_countintegerNo—Target MIG size, forwarded by runner.pool-reconcile / the caller.
desired_countintegerNo—Fallback target size when new_desired_count is absent.

Output Schema ​

FieldTypeRequiredDefaultDescription
runner_group_uuiduuidNo—UUID of the RunnerGroup this wrapper step operates on, picked from the organization's list of runner groups.
organization_uuiduuidNo—UUID of the caller's organization, injected server-side from the authenticated request; scopes the operation to the correct tenant.
primitive_inputjsonNo——
primitive_outputjsonNo——
workflow_run_uuidstringNo—Internal engine DAG-run correlation id forwarded by the parent step; not a platform entity foreign key despite the name. System-generated, no source attached by design.
workflow_run_idstringNo——
prejsonNo——
primitivejsonNo——
postjsonNo——
cluster_arnjsonNo——
cluster_statusjsonNo——
log_group_namejsonNo——
retention_in_daysjsonNo——
task_definition_arnjsonNo——
launch_template_refjsonNo——
launch_template_idjsonNo——
auto_scaling_group_namejsonNo——
capacity_provider_namejsonNo——
ami_refjsonNo——
ami_idjsonNo——
instance_profile_arnjsonNo——
instance_profile_namejsonNo——
connection_uuidjsonNo—UUID of the Connection backing this primitive's cloud backend, picked from the organization's connections.
cloud_connection_uuidjsonNo—UUID of the CloudConnection backing this primitive's cloud backend, picked from the organization's connections.
namespacejsonNo——
namejsonNo——
deployment_namejsonNo——
registration_secret_namejsonNo——
failed_stepjsonNo——
failed_layerjsonNo——
failed_at_statejsonNo——
compensation_triggerjsonNo——
comp_current_layerjsonNo——
comp_queuejsonNo——
comp_retry_countjsonNo——
errorstringNo——
error_typestringNo——
failure_reasonstringNo——
connection_refjsonNo——
existedjsonNo——
deletedjsonNo——
tagsjsonNo——
capacity_providersjsonNo——
default_capacity_provider_strategyjsonNo——
statusjsonNo——
cluster_namejsonNo——
new_desired_countintegerNo—Target MIG size, forwarded by runner.pool-reconcile / the caller.
desired_countintegerNo—Fallback target size when new_desired_count is absent.

DAG Layers ​

#LayerStepsCompensation
1prerunner.environment-scale-gce__pre—
2primitivegcp.compute.instance_group_manager.resize—
3postrunner.environment-scale-gce__post—

Execution Flow ​

Sub-workflows ​

Sub-workflowStep name
runner.environment-scale-gce__prepre
gcp.compute.instance_group_manager.resizeprimitive
runner.environment-scale-gce__postpost

API Usage ​

bash
POST /api/workflows/start
Content-Type: application/json

{
  "workflow_type": "runner.environment-scale-gce",
  "initial_data": {
    "runner_group_uuid": "value"
  }
}