Skip to content

Support multi-subnet fleets, explicit on-demand market type, terminate on shutdown #7

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
Alexander Chumakin (alexandrchumakin) merged 2 commits into from
Jul 17, 2026
Merged

Support multi-subnet fleets, explicit on-demand market type, terminate on shutdown #7

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
c6e3600
Support multi-subnet fleets and explicit on-demand market type
alexandrchumakin Jul 17, 2026
1851037
Define fleet launcher before its caller to satisfy no-use-before-define
alexandrchumakin Jul 17, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -204,15 +204,15 @@ Now you're ready to go!
| `github-token` | Always required. | GitHub Personal Access Token with the `repo` scope assigned. |
| `ec2-image-id` | Required if you use the `start` mode. | EC2 Image Id (AMI). <br><br> The new runner will be launched from this image. <br><br> The action is compatible with Amazon Linux 2 images. |
| `ec2-instance-type` | Required if you use the `start` mode. | EC2 Instance Type. |
| `subnet-id` | Required if you use the `start` mode. | VPC Subnet Id. <br><br> The subnet should belong to the same VPC as the specified security group. |
| `subnet-id` | Required if you use the `start` mode. | One or more VPC Subnet Ids, separated by commas or whitespace. <br><br> All subnets must belong to the same VPC as the specified security group. Subnets in several availability zones widen the spot pool choice and lower the interruption probability. |
| `security-group-id` | Required if you use the `start` mode. | EC2 Security Group Id. <br><br> The security group should belong to the same VPC as the specified subnet. <br><br> Only the outbound traffic for port 443 should be allowed. No inbound traffic is required. |
| `label` | Required if you use the `stop` mode. | Name of the unique label assigned to the runner. <br><br> The label is provided by the output of the action in the `start` mode. <br><br> The label is used to remove the runner from GitHub when the runner is not needed anymore. |
| `ec2-instance-id` | Required if you use the `stop` mode. | EC2 Instance Id of the created runner. <br><br> The id is provided by the output of the action in the `start` mode. <br><br> The id is used to terminate the EC2 instance when the runner is not needed anymore. |
| `iam-role-name` | Optional. Used only with the `start` mode. | IAM role name to attach to the created EC2 runner. <br><br> This allows the runner to have permissions to run additional actions within the AWS account, without having to manage additional GitHub secrets and AWS users. <br><br> Setting this requires additional AWS permissions for the role launching the instance (see above). |
| `aws-resource-tags` | Optional. Used only with the `start` mode. | Specifies tags to add to the EC2 instance and any attached storage. <br><br> This field is a stringified JSON array of tag objects, each containing a `Key` and `Value` field (see example below). <br><br> Setting this requires additional AWS permissions for the role launching the instance (see above). |
| `runner-home-dir` | Optional. Used only with the `start` mode. | Specifies a directory where pre-installed actions-runner software and scripts are located.<br><br> |
| `pre-runner-script` | Optional. Used only with the `start` mode. | Specifies bash commands to run before the runner starts. It's useful for installing dependencies with apt-get, yum, dnf, etc. For example:<pre> - name: Start EC2 runner<br> with:<br> mode: start<br> ...<br> pre-runner-script: \|<br> sudo yum update -y && \ <br> sudo yum install docker git libicu -y<br> sudo systemctl enable docker</pre> |
| `market-type` | Optional. Used only with the `start` mode. | The only valid option is `spot`. If `spot` is specified, a Spot instance will be requested. If left unspecified, an on-demand instance will be provisioned. |
| `market-type` | Optional. Used only with the `start` mode. | Valid options are `spot` and `on-demand`. If `spot` is specified, a Spot instance will be requested. If `on-demand` is specified or the input is left unspecified, an on-demand instance will be provisioned. |
| `block-device-mappings` | Optional. Used only with the `start` mode. | JSON string specifying the block device mappings for the EC2 instance. For example: <br> <pre>[{"DeviceName": "/dev/sda1", "Ebs": {"VolumeSize": 100, "VolumeType": "gp3"}}]</pre> See <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_BlockDeviceMapping.html">AWS BlockDeviceMapping docs</a> for all options. |
| `startup-quiet-period-seconds` | Optional | Default: 30 |
| `startup-retry-interval-seconds` | Optional | Default: 10 |
Expand Down
6 changes: 5 additions & 1 deletion action.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -51,8 +51,11 @@ inputs:
required: false
subnet-id:
description: >-
VPC Subnet Id. The subnet should belong to the same VPC as the specified security group.
One or more VPC Subnet Ids, separated by commas or whitespace. All subnets must belong to the same
VPC as the specified security group. Providing subnets in several availability zones widens the
pool choice for spot instances and lowers the interruption probability.
This input is required if you use the 'start' mode and don't provide availability-zones-config.
The 'subnetId' field of availability-zones-config entries accepts the same multi-subnet format.
required: false
security-group-id:
description: >-
Expand Down Expand Up @@ -97,6 +100,7 @@ inputs:
description: >-
Specifies the market (purchasing) option for the instance:
- 'spot' - Use a spot instance
- 'on-demand' - Use an on-demand instance (same as leaving the input empty)
required: false
block-device-mappings:
description: >-
Expand Down
Loading
Loading