@cloudsnorkel/cdk-github-runners 0.5.7 → 0.6.0

package/.jsii

@@ -7,7 +7,7 @@
     ]
   },
   "dependencies": {
-    "aws-cdk-lib": "^2.29.0",
+    "aws-cdk-lib": "^2.50.0",
     "constructs": "^10.0.5"
   },
   "dependencyClosure": {
@@ -729,6 +729,32 @@
             }
           }
         },
+        "aws-cdk-lib.aws_connectcampaigns": {
+          "targets": {
+            "dotnet": {
+              "namespace": "Amazon.CDK.AWS.ConnectCampaigns"
+            },
+            "java": {
+              "package": "software.amazon.awscdk.services.connectcampaigns"
+            },
+            "python": {
+              "module": "aws_cdk.aws_connectcampaigns"
+            }
+          }
+        },
+        "aws-cdk-lib.aws_controltower": {
+          "targets": {
+            "dotnet": {
+              "namespace": "Amazon.CDK.AWS.ControlTower"
+            },
+            "java": {
+              "package": "software.amazon.awscdk.services.controltower"
+            },
+            "python": {
+              "module": "aws_cdk.aws_controltower"
+            }
+          }
+        },
         "aws-cdk-lib.aws_cur": {
           "targets": {
             "dotnet": {
@@ -1379,6 +1405,19 @@
             }
           }
         },
+        "aws-cdk-lib.aws_identitystore": {
+          "targets": {
+            "dotnet": {
+              "namespace": "Amazon.CDK.AWS.IdentityStore"
+            },
+            "java": {
+              "package": "software.amazon.awscdk.services.identitystore"
+            },
+            "python": {
+              "module": "aws_cdk.aws_identitystore"
+            }
+          }
+        },
         "aws-cdk-lib.aws_imagebuilder": {
           "targets": {
             "dotnet": {
@@ -1496,6 +1535,19 @@
             }
           }
         },
+        "aws-cdk-lib.aws_iotfleetwise": {
+          "targets": {
+            "dotnet": {
+              "namespace": "Amazon.CDK.AWS.IoTFleetWise"
+            },
+            "java": {
+              "package": "software.amazon.awscdk.services.iotfleetwise"
+            },
+            "python": {
+              "module": "aws_cdk.aws_iotfleetwise"
+            }
+          }
+        },
         "aws-cdk-lib.aws_iotsitewise": {
           "targets": {
             "dotnet": {
@@ -1847,6 +1899,19 @@
             }
           }
         },
+        "aws-cdk-lib.aws_m2": {
+          "targets": {
+            "dotnet": {
+              "namespace": "Amazon.CDK.AWS.M2"
+            },
+            "java": {
+              "package": "software.amazon.awscdk.services.m2"
+            },
+            "python": {
+              "module": "aws_cdk.aws_m2"
+            }
+          }
+        },
         "aws-cdk-lib.aws_macie": {
           "targets": {
             "dotnet": {
@@ -2198,6 +2263,19 @@
             }
           }
         },
+        "aws-cdk-lib.aws_redshiftserverless": {
+          "targets": {
+            "dotnet": {
+              "namespace": "Amazon.CDK.AWS.RedshiftServerless"
+            },
+            "java": {
+              "package": "software.amazon.awscdk.services.redshiftserverless"
+            },
+            "python": {
+              "module": "aws_cdk.aws_redshiftserverless"
+            }
+          }
+        },
         "aws-cdk-lib.aws_refactorspaces": {
           "targets": {
             "dotnet": {
@@ -2263,6 +2341,19 @@
             }
           }
         },
+        "aws-cdk-lib.aws_rolesanywhere": {
+          "targets": {
+            "dotnet": {
+              "namespace": "Amazon.CDK.AWS.RolesAnywhere"
+            },
+            "java": {
+              "package": "software.amazon.awscdk.services.rolesanywhere"
+            },
+            "python": {
+              "module": "aws_cdk.aws_rolesanywhere"
+            }
+          }
+        },
         "aws-cdk-lib.aws_route53": {
           "targets": {
             "dotnet": {
@@ -2692,6 +2783,19 @@
             }
           }
         },
+        "aws-cdk-lib.aws_supportapp": {
+          "targets": {
+            "dotnet": {
+              "namespace": "Amazon.CDK.AWS.SupportApp"
+            },
+            "java": {
+              "package": "software.amazon.awscdk.services.supportapp"
+            },
+            "python": {
+              "module": "aws_cdk.aws_supportapp"
+            }
+          }
+        },
         "aws-cdk-lib.aws_synthetics": {
           "targets": {
             "dotnet": {
@@ -3010,7 +3114,7 @@
     "stability": "experimental"
   },
   "homepage": "https://github.com/CloudSnorkel/cdk-github-runners.git",
-  "jsiiVersion": "1.70.0 (build 03c2f6f)",
+  "jsiiVersion": "1.71.0 (build f1f58ae)",
   "keywords": [
     "aws",
     "aws-cdk",
@@ -3034,7 +3138,7 @@
   },
   "name": "@cloudsnorkel/cdk-github-runners",
   "readme": {
-    "markdown": "# GitHub Self-Hosted Runners CDK Constructs\n\n[![NPM](https://img.shields.io/npm/v/@cloudsnorkel/cdk-github-runners?label=npm&logo=npm)][7]\n[![PyPI](https://img.shields.io/pypi/v/cloudsnorkel.cdk-github-runners?label=pypi&logo=pypi)][6]\n[![Maven Central](https://img.shields.io/maven-central/v/com.cloudsnorkel/cdk.github.runners.svg?label=Maven%20Central&logo=java)][8]\n[![Go](https://img.shields.io/github/v/tag/CloudSnorkel/cdk-github-runners?color=red&label=go&logo=go)][11]\n[![Nuget](https://img.shields.io/nuget/v/CloudSnorkel.Cdk.Github.Runners?color=red&&logo=nuget)][12]\n[![Release](https://github.com/CloudSnorkel/cdk-github-runners/actions/workflows/release.yml/badge.svg)](https://github.com/CloudSnorkel/cdk-github-runners/actions/workflows/release.yml)\n[![License](https://img.shields.io/badge/license-Apache--2.0-blue)](https://github.com/CloudSnorkel/cdk-github-runners/blob/main/LICENSE)\n\nUse this CDK construct to create ephemeral [self-hosted GitHub runners][1] on-demand inside your AWS account.\n\n* Easy to configure GitHub integration with a web-based interface\n* Customizable runners with decent defaults\n* Multiple runner configurations controlled by labels\n* Everything fully hosted in your account\n* Automatically updated build environment with latest runner version\n\nSelf-hosted runners in AWS are useful when:\n\n* You need easy access to internal resources in your actions\n* You want to pre-install some software for your actions\n* You want to provide some basic AWS API access (but [aws-actions/configure-aws-credentials][2] has more security controls)\n\nEphemeral (or on-demand) runners are the [recommended way by GitHub][14] for auto-scaling, and they make sure all jobs run with a clean image. Runners are started on-demand. You don't pay unless a job is running.\n\n## API\n\nThe best way to browse API documentation is on [Constructs Hub][13]. It is available in all supported programming languages.\n\n## Providers\n\nA runner provider creates compute resources on-demand and uses [actions/runner][5] to start a runner.\n\n|                  | CodeBuild                  | Fargate        | Lambda        |\n|------------------|----------------------------|----------------|---------------|\n| **Time limit**   | 8 hours                    | Unlimited      | 15 minutes    |\n| **vCPUs**        | 2, 4, 8, or 72             | 0.25 to 4      | 1 to 6        |\n| **RAM**          | 3gb, 7gb, 15gb, or 145gb   | 512mb to 30gb  | 128mb to 10gb |\n| **Storage**      | 50gb to 824gb              | 20gb to 200gb  | Up to 10gb    |\n| **Architecture** | x86_64, ARM64              | x86_64, ARM64  | x86_64, ARM64 |\n| **sudo**         | ✔                         | ✔              | ❌           |\n| **Docker**       | ✔ (Linux only)            | ❌              | ❌           |\n| **Spot pricing** | ❌                         | ✔              | ❌           |\n| **OS**           | Linux, Windows             | Linux, Windows | Linux         |\n\nThe best provider to use mostly depends on your current infrastructure. When in doubt, CodeBuild is always a good choice. Execution history and logs are easy to view, and it has no restrictive limits unless you need to run for more than 8 hours.\n\nYou can also create your own provider by implementing `IRunnerProvider`.\n\n## Installation\n\n1. Confirm you're using CDK v2\n2. Install the appropriate package\n   1. [Python][6]\n      ```\n      pip install cloudsnorkel.cdk-github-runners\n      ```\n   2. [TypeScript or JavaScript][7]\n      ```\n      npm i @cloudsnorkel/cdk-github-runners\n      ```\n   3. [Java][8]\n      ```xml\n      <dependency>\n      <groupId>com.cloudsnorkel</groupId>\n      <artifactId>cdk.github.runners</artifactId>\n      </dependency>\n      ```\n   4. [Go][11]\n      ```\n      go get github.com/CloudSnorkel/cdk-github-runners-go/cloudsnorkelcdkgithubrunners\n      ```\n   5. [.NET][12]\n      ```\n      dotnet add package CloudSnorkel.Cdk.Github.Runners\n      ```\n3. Use `GitHubRunners` construct in your code (starting with default arguments is fine)\n4. Deploy your stack\n5. Look for the status command output similar to `aws --region us-east-1 lambda invoke --function-name status-XYZ123 status.json`\n6. Execute the status command (you may need to specify `--profile` too) and open the resulting `status.json` file\n7. Open the URL in `github.setup.url` from `status.json` or [manually setup GitHub](SETUP_GITHUB.md) integration as an app or with personal access token\n8. Run status command again to confirm `github.auth.status` and `github.webhook.status` are OK\n9. Trigger a GitHub action that has a `self-hosted` label with `runs-on: [self-hosted, linux, codebuild]` or similar\n10. If the action is not successful, see [troubleshooting](#Troubleshooting)\n\n[![Demo](demo-thumbnail.jpg)](https://youtu.be/wlyv_3V8lIw)\n\n## Customizing\n\nThe default providers configured by `GitHubRunners` are useful for testing but probably not too much for actual production work. They run in the default VPC or no VPC and have no added IAM permissions. You would usually want to configure the providers yourself.\n\nFor example:\n\n```typescript\nlet vpc: ec2.Vpc;\nlet runnerSg: ec2.SecurityGroup;\nlet dbSg: ec2.SecurityGroup;\nlet bucket: s3.Bucket;\n\n// create a custom CodeBuild provider\nconst myProvider = new CodeBuildRunner(this, 'codebuild runner', {\n  label: 'my-codebuild',\n  vpc: vpc,\n  securityGroup: runnerSg,\n});\n// grant some permissions to the provider\nbucket.grantReadWrite(myProvider);\ndbSg.connections.allowFrom(runnerSg, ec2.Port.tcp(3306), 'allow runners to connect to MySQL database');\n\n// create the runner infrastructure\nnew GitHubRunners(this, 'runners', {\n   providers: [myProvider],\n});\n```\n\nAnother way to customize runners is by modifying the image used to spin them up. The image contains the [runner][5], any required dependencies, and integration code with the provider. You may choose to customize this image by adding more packages, for example.\n\n```typescript\nconst myBuilder = new CodeBuildImageBuilder(this, 'image builder', {\n  dockerfilePath: FargateRunner.LINUX_X64_DOCKERFILE_PATH,\n  runnerVersion: RunnerVersion.specific('2.291.0'),\n  rebuildInterval: Duration.days(14),\n});\nmyBuilder.setBuildArg('EXTRA_PACKAGES', 'nginx xz-utils');\n\nconst myProvider = new FargateRunner(this, 'fargate runner', {\n  label: 'customized-fargate',\n  vpc: vpc,\n  securityGroup: runnerSg,\n  imageBuilder: myBuilder,\n});\n\n// create the runner infrastructure\nnew GitHubRunners(stack, 'runners', {\n  providers: [myProvider],\n});\n```\n\nYour workflow will then look like:\n\n```yaml\nname: self-hosted example\non: push\njobs:\n  self-hosted:\n    runs-on: [self-hosted, customized-fargate]\n    steps:\n      - run: echo hello world\n```\n\nWindows images must be built with AWS Image Builder.\n\n```typescript\nconst myWindowsBuilder = new ContainerImageBuilder(this, 'Windows image builder', {\n  architecture: Architecture.X86_64,\n  os: Os.WINDOWS,\n  runnerVersion: RunnerVersion.specific('2.291.0'),\n  rebuildInterval: Duration.days(14),\n});\nmyWindowsBuilder.addComponent(new ImageBuilderComponent(this, 'Ninja Component',\n  {\n    displayName: 'Ninja',\n    description: 'Download and install Ninja build system',\n    platform: 'Windows',\n    commands: [\n      'Invoke-WebRequest -UseBasicParsing -Uri \"https://github.com/ninja-build/ninja/releases/download/v1.11.1/ninja-win.zip\" -OutFile ninja.zip',\n      'Expand-Archive ninja.zip -DestinationPath C:\\\\actions',\n      'del ninja.zip',\n    ],\n  }\n));\n\nconst myProvider = new FargateRunner(this, 'fargate runner', {\n  label: 'customized-windows-fargate',\n  vpc: vpc,\n  securityGroup: runnerSg,\n  imageBuiler: myWindowsBuilder,\n});\n\n// create the runner infrastructure\nnew GitHubRunners(stack, 'runners', {\n  providers: [myProvider],\n});\n```\n\n## Architecture\n\n![Architecture diagram](architecture.svg)\n\n## Troubleshooting\n\n1. Always start with the status function, make sure no errors are reported, and confirm all status codes are OK\n2. If jobs are stuck on pending:\n   1. Make sure `runs-on` in the workflow matches the expected labels set in the runner provider\n   2. If it happens every time, cancel the job and start it again\n4. Confirm the webhook Lambda was called by visiting the URL in `troubleshooting.webhookHandlerUrl` from `status.json`\n   1. If it's not called or logs errors, confirm the webhook settings on the GitHub side\n   2. If you see too many errors, make sure you're only sending `workflow_job` events\n5. When using GitHub app, make sure there are active installation in `github.auth.app.installations`\n6. Check execution details of the orchestrator step function by visiting the URL in `troubleshooting.stepFunctionUrl` from `status.json`\n   1. Use the details tab to find the specific execution of the provider (Lambda, CodeBuild, Fargate, etc.)\n   2. Every step function execution should be successful, even if the runner action inside it failed\n\n## Other Options\n\n1. [philips-labs/terraform-aws-github-runner][3] if you're using Terraform\n2. [actions-runner-controller/actions-runner-controller][4] if you're using Kubernetes\n\n\n[1]: https://docs.github.com/en/actions/hosting-your-own-runners/about-self-hosted-runners\n[2]: https://github.com/marketplace/actions/configure-aws-credentials-action-for-github-actions\n[3]: https://github.com/philips-labs/terraform-aws-github-runner\n[4]: https://github.com/actions-runner-controller/actions-runner-controller\n[5]: https://github.com/actions/runner\n[6]: https://pypi.org/project/cloudsnorkel.cdk-github-runners\n[7]: https://www.npmjs.com/package/@cloudsnorkel/cdk-github-runners\n[8]: https://search.maven.org/search?q=g:%22com.cloudsnorkel%22%20AND%20a:%22cdk.github.runners%22\n[9]: https://docs.github.com/en/developers/apps/getting-started-with-apps/about-apps\n[10]: https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token\n[11]: https://pkg.go.dev/github.com/CloudSnorkel/cdk-github-runners-go/cloudsnorkelcdkgithubrunners\n[12]: https://www.nuget.org/packages/CloudSnorkel.Cdk.Github.Runners/\n[13]: https://constructs.dev/packages/@cloudsnorkel/cdk-github-runners/\n[14]: https://docs.github.com/en/actions/hosting-your-own-runners/autoscaling-with-self-hosted-runners#using-ephemeral-runners-for-autoscaling\n"
+    "markdown": "# GitHub Self-Hosted Runners CDK Constructs\n\n[![NPM](https://img.shields.io/npm/v/@cloudsnorkel/cdk-github-runners?label=npm&logo=npm)][7]\n[![PyPI](https://img.shields.io/pypi/v/cloudsnorkel.cdk-github-runners?label=pypi&logo=pypi)][6]\n[![Maven Central](https://img.shields.io/maven-central/v/com.cloudsnorkel/cdk.github.runners.svg?label=Maven%20Central&logo=java)][8]\n[![Go](https://img.shields.io/github/v/tag/CloudSnorkel/cdk-github-runners?color=red&label=go&logo=go)][11]\n[![Nuget](https://img.shields.io/nuget/v/CloudSnorkel.Cdk.Github.Runners?color=red&&logo=nuget)][12]\n[![Release](https://github.com/CloudSnorkel/cdk-github-runners/actions/workflows/release.yml/badge.svg)](https://github.com/CloudSnorkel/cdk-github-runners/actions/workflows/release.yml)\n[![License](https://img.shields.io/badge/license-Apache--2.0-blue)](https://github.com/CloudSnorkel/cdk-github-runners/blob/main/LICENSE)\n\nUse this CDK construct to create ephemeral [self-hosted GitHub runners][1] on-demand inside your AWS account.\n\n* Easy to configure GitHub integration with a web-based interface\n* Customizable runners with decent defaults\n* Multiple runner configurations controlled by labels\n* Everything fully hosted in your account\n* Automatically updated build environment with latest runner version\n\nSelf-hosted runners in AWS are useful when:\n\n* You need easy access to internal resources in your actions\n* You want to pre-install some software for your actions\n* You want to provide some basic AWS API access (but [aws-actions/configure-aws-credentials][2] has more security controls)\n\nEphemeral (or on-demand) runners are the [recommended way by GitHub][14] for auto-scaling, and they make sure all jobs run with a clean image. Runners are started on-demand. You don't pay unless a job is running.\n\n## API\n\nThe best way to browse API documentation is on [Constructs Hub][13]. It is available in all supported programming languages.\n\n## Providers\n\nA runner provider creates compute resources on-demand and uses [actions/runner][5] to start a runner.\n\n|                  | EC2               | CodeBuild                  | Fargate        | Lambda        |\n|------------------|-------------------|----------------------------|----------------|---------------|\n| **Time limit**   | Unlimited         | 8 hours                    | Unlimited      | 15 minutes    |\n| **vCPUs**        | Unlimited         | 2, 4, 8, or 72             | 0.25 to 4      | 1 to 6        |\n| **RAM**          | Unlimited         | 3gb, 7gb, 15gb, or 145gb   | 512mb to 30gb  | 128mb to 10gb |\n| **Storage**      | Unlimited         | 50gb to 824gb              | 20gb to 200gb  | Up to 10gb    |\n| **Architecture** | x86_64, ARM64     | x86_64, ARM64              | x86_64, ARM64  | x86_64, ARM64 |\n| **sudo**         | ✔                 | ✔                         | ✔              | ❌           |\n| **Docker**       | ✔                 | ✔ (Linux only)            | ❌              | ❌           |\n| **Spot pricing** | ✔                 | ❌                         | ✔              | ❌           |\n| **OS**           | Linux, Windows    | Linux, Windows             | Linux, Windows | Linux         |\n\nThe best provider to use mostly depends on your current infrastructure. When in doubt, CodeBuild is always a good choice. Execution history and logs are easy to view, and it has no restrictive limits unless you need to run for more than 8 hours.\n\nYou can also create your own provider by implementing `IRunnerProvider`.\n\n## Installation\n\n1. Confirm you're using CDK v2\n2. Install the appropriate package\n   1. [Python][6]\n      ```\n      pip install cloudsnorkel.cdk-github-runners\n      ```\n   2. [TypeScript or JavaScript][7]\n      ```\n      npm i @cloudsnorkel/cdk-github-runners\n      ```\n   3. [Java][8]\n      ```xml\n      <dependency>\n      <groupId>com.cloudsnorkel</groupId>\n      <artifactId>cdk.github.runners</artifactId>\n      </dependency>\n      ```\n   4. [Go][11]\n      ```\n      go get github.com/CloudSnorkel/cdk-github-runners-go/cloudsnorkelcdkgithubrunners\n      ```\n   5. [.NET][12]\n      ```\n      dotnet add package CloudSnorkel.Cdk.Github.Runners\n      ```\n3. Use `GitHubRunners` construct in your code (starting with default arguments is fine)\n4. Deploy your stack\n5. Look for the status command output similar to `aws --region us-east-1 lambda invoke --function-name status-XYZ123 status.json`\n6. Execute the status command (you may need to specify `--profile` too) and open the resulting `status.json` file\n7. Open the URL in `github.setup.url` from `status.json` or [manually setup GitHub](SETUP_GITHUB.md) integration as an app or with personal access token\n8. Run status command again to confirm `github.auth.status` and `github.webhook.status` are OK\n9. Trigger a GitHub action that has a `self-hosted` label with `runs-on: [self-hosted, linux, codebuild]` or similar\n10. If the action is not successful, see [troubleshooting](#Troubleshooting)\n\n[![Demo](demo-thumbnail.jpg)](https://youtu.be/wlyv_3V8lIw)\n\n## Customizing\n\nThe default providers configured by `GitHubRunners` are useful for testing but probably not too much for actual production work. They run in the default VPC or no VPC and have no added IAM permissions. You would usually want to configure the providers yourself.\n\nFor example:\n\n```typescript\nlet vpc: ec2.Vpc;\nlet runnerSg: ec2.SecurityGroup;\nlet dbSg: ec2.SecurityGroup;\nlet bucket: s3.Bucket;\n\n// create a custom CodeBuild provider\nconst myProvider = new CodeBuildRunner(this, 'codebuild runner', {\n  label: 'my-codebuild',\n  vpc: vpc,\n  securityGroup: runnerSg,\n});\n// grant some permissions to the provider\nbucket.grantReadWrite(myProvider);\ndbSg.connections.allowFrom(runnerSg, ec2.Port.tcp(3306), 'allow runners to connect to MySQL database');\n\n// create the runner infrastructure\nnew GitHubRunners(this, 'runners', {\n   providers: [myProvider],\n});\n```\n\nAnother way to customize runners is by modifying the image used to spin them up. The image contains the [runner][5], any required dependencies, and integration code with the provider. You may choose to customize this image by adding more packages, for example.\n\n```typescript\nconst myBuilder = new CodeBuildImageBuilder(this, 'image builder', {\n  dockerfilePath: FargateRunner.LINUX_X64_DOCKERFILE_PATH,\n  runnerVersion: RunnerVersion.specific('2.291.0'),\n  rebuildInterval: Duration.days(14),\n});\nmyBuilder.setBuildArg('EXTRA_PACKAGES', 'nginx xz-utils');\n\nconst myProvider = new FargateRunner(this, 'fargate runner', {\n  label: 'customized-fargate',\n  vpc: vpc,\n  securityGroup: runnerSg,\n  imageBuilder: myBuilder,\n});\n\n// create the runner infrastructure\nnew GitHubRunners(stack, 'runners', {\n  providers: [myProvider],\n});\n```\n\nYour workflow will then look like:\n\n```yaml\nname: self-hosted example\non: push\njobs:\n  self-hosted:\n    runs-on: [self-hosted, customized-fargate]\n    steps:\n      - run: echo hello world\n```\n\nWindows images must be built with AWS Image Builder.\n\n```typescript\nconst myWindowsBuilder = new ContainerImageBuilder(this, 'Windows image builder', {\n  architecture: Architecture.X86_64,\n  os: Os.WINDOWS,\n  runnerVersion: RunnerVersion.specific('2.291.0'),\n  rebuildInterval: Duration.days(14),\n});\nmyWindowsBuilder.addComponent(new ImageBuilderComponent(this, 'Ninja Component',\n  {\n    displayName: 'Ninja',\n    description: 'Download and install Ninja build system',\n    platform: 'Windows',\n    commands: [\n      'Invoke-WebRequest -UseBasicParsing -Uri \"https://github.com/ninja-build/ninja/releases/download/v1.11.1/ninja-win.zip\" -OutFile ninja.zip',\n      'Expand-Archive ninja.zip -DestinationPath C:\\\\actions',\n      'del ninja.zip',\n    ],\n  }\n));\n\nconst myProvider = new FargateRunner(this, 'fargate runner', {\n  label: 'customized-windows-fargate',\n  vpc: vpc,\n  securityGroup: runnerSg,\n  imageBuiler: myWindowsBuilder,\n});\n\n// create the runner infrastructure\nnew GitHubRunners(stack, 'runners', {\n  providers: [myProvider],\n});\n```\n\n## Architecture\n\n![Architecture diagram](architecture.svg)\n\n## Troubleshooting\n\n1. Always start with the status function, make sure no errors are reported, and confirm all status codes are OK\n2. If jobs are stuck on pending:\n   1. Make sure `runs-on` in the workflow matches the expected labels set in the runner provider\n   2. If it happens every time, cancel the job and start it again\n4. Confirm the webhook Lambda was called by visiting the URL in `troubleshooting.webhookHandlerUrl` from `status.json`\n   1. If it's not called or logs errors, confirm the webhook settings on the GitHub side\n   2. If you see too many errors, make sure you're only sending `workflow_job` events\n5. When using GitHub app, make sure there are active installation in `github.auth.app.installations`\n6. Check execution details of the orchestrator step function by visiting the URL in `troubleshooting.stepFunctionUrl` from `status.json`\n   1. Use the details tab to find the specific execution of the provider (Lambda, CodeBuild, Fargate, etc.)\n   2. Every step function execution should be successful, even if the runner action inside it failed\n\n## Other Options\n\n1. [philips-labs/terraform-aws-github-runner][3] if you're using Terraform\n2. [actions-runner-controller/actions-runner-controller][4] if you're using Kubernetes\n\n\n[1]: https://docs.github.com/en/actions/hosting-your-own-runners/about-self-hosted-runners\n[2]: https://github.com/marketplace/actions/configure-aws-credentials-action-for-github-actions\n[3]: https://github.com/philips-labs/terraform-aws-github-runner\n[4]: https://github.com/actions-runner-controller/actions-runner-controller\n[5]: https://github.com/actions/runner\n[6]: https://pypi.org/project/cloudsnorkel.cdk-github-runners\n[7]: https://www.npmjs.com/package/@cloudsnorkel/cdk-github-runners\n[8]: https://search.maven.org/search?q=g:%22com.cloudsnorkel%22%20AND%20a:%22cdk.github.runners%22\n[9]: https://docs.github.com/en/developers/apps/getting-started-with-apps/about-apps\n[10]: https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token\n[11]: https://pkg.go.dev/github.com/CloudSnorkel/cdk-github-runners-go/cloudsnorkelcdkgithubrunners\n[12]: https://www.nuget.org/packages/CloudSnorkel.Cdk.Github.Runners/\n[13]: https://constructs.dev/packages/@cloudsnorkel/cdk-github-runners/\n[14]: https://docs.github.com/en/actions/hosting-your-own-runners/autoscaling-with-self-hosted-runners#using-ephemeral-runners-for-autoscaling\n"
   },
   "repository": {
     "type": "git",
@@ -3075,9 +3179,36 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/providers/common.ts",
-        "line": 33
+        "line": 42
       },
       "methods": [
+        {
+          "docs": {
+            "stability": "experimental",
+            "summary": "Checks if a given EC2 instance type matches this architecture."
+          },
+          "locationInModule": {
+            "filename": "src/providers/common.ts",
+            "line": 88
+          },
+          "name": "instanceTypeMatch",
+          "parameters": [
+            {
+              "docs": {
+                "summary": "instance type to check."
+              },
+              "name": "instanceType",
+              "type": {
+                "fqn": "aws-cdk-lib.aws_ec2.InstanceType"
+              }
+            }
+          ],
+          "returns": {
+            "type": {
+              "primitive": "boolean"
+            }
+          }
+        },
         {
           "docs": {
             "stability": "experimental",
@@ -3085,7 +3216,7 @@
           },
           "locationInModule": {
             "filename": "src/providers/common.ts",
-            "line": 56
+            "line": 65
           },
           "name": "is",
           "parameters": [
@@ -3104,6 +3235,38 @@
               "primitive": "boolean"
             }
           }
+        },
+        {
+          "docs": {
+            "stability": "experimental",
+            "summary": "Checks if this architecture is in a given list."
+          },
+          "locationInModule": {
+            "filename": "src/providers/common.ts",
+            "line": 74
+          },
+          "name": "isIn",
+          "parameters": [
+            {
+              "docs": {
+                "summary": "architectures to check."
+              },
+              "name": "arches",
+              "type": {
+                "collection": {
+                  "elementtype": {
+                    "fqn": "@cloudsnorkel/cdk-github-runners.Architecture"
+                  },
+                  "kind": "array"
+                }
+              }
+            }
+          ],
+          "returns": {
+            "type": {
+              "primitive": "boolean"
+            }
+          }
         }
       ],
       "name": "Architecture",
@@ -3117,7 +3280,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/providers/common.ts",
-            "line": 37
+            "line": 46
           },
           "name": "ARM64",
           "static": true,
@@ -3134,7 +3297,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/providers/common.ts",
-            "line": 42
+            "line": 51
           },
           "name": "X86_64",
           "static": true,
@@ -3149,7 +3312,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/providers/common.ts",
-            "line": 48
+            "line": 57
           },
           "name": "name",
           "type": {
@@ -3639,7 +3802,7 @@
       "docs": {
         "remarks": "Creates a project that gets started for each job.\n\nThis construct is not meant to be used by itself. It should be passed in the providers property for GitHubRunners.",
         "stability": "experimental",
-        "summary": "GitHub Actions runner provider using CodeBuild to execute the actions."
+        "summary": "GitHub Actions runner provider using CodeBuild to execute jobs."
       },
       "fqn": "@cloudsnorkel/cdk-github-runners.CodeBuildRunner",
       "initializer": {
@@ -3648,7 +3811,7 @@
         },
         "locationInModule": {
           "filename": "src/providers/codebuild.ts",
-          "line": 150
+          "line": 160
         },
         "parameters": [
           {
@@ -3677,7 +3840,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/providers/codebuild.ts",
-        "line": 93
+        "line": 103
       },
       "methods": [
         {
@@ -3688,7 +3851,7 @@
           },
           "locationInModule": {
             "filename": "src/providers/codebuild.ts",
-            "line": 263
+            "line": 273
           },
           "name": "getStepFunctionTask",
           "overrides": "@cloudsnorkel/cdk-github-runners.IRunnerProvider",
@@ -3709,13 +3872,34 @@
             }
           }
         },
+        {
+          "docs": {
+            "remarks": "This can be used to add additional policy\nstatements to the state machine role that are not automatically added by the task returned from {@link getStepFunctionTask}.",
+            "stability": "experimental",
+            "summary": "An optional method that modifies the role of the state machine after all the tasks have been generated."
+          },
+          "locationInModule": {
+            "filename": "src/providers/codebuild.ts",
+            "line": 310
+          },
+          "name": "grantStateMachine",
+          "overrides": "@cloudsnorkel/cdk-github-runners.IRunnerProvider",
+          "parameters": [
+            {
+              "name": "_",
+              "type": {
+                "fqn": "aws-cdk-lib.aws_iam.IGrantable"
+              }
+            }
+          ]
+        },
         {
           "docs": {
             "stability": "experimental"
           },
           "locationInModule": {
             "filename": "src/providers/common.ts",
-            "line": 253
+            "line": 426
           },
           "name": "labelsFromProperties",
           "parameters": [
@@ -3756,6 +3940,32 @@
               }
             }
           }
+        },
+        {
+          "docs": {
+            "remarks": "Also gives the status function any needed permissions to query the Docker image or AMI.",
+            "stability": "experimental",
+            "summary": "Return status of the runner provider to be used in the main status function."
+          },
+          "locationInModule": {
+            "filename": "src/providers/codebuild.ts",
+            "line": 313
+          },
+          "name": "status",
+          "overrides": "@cloudsnorkel/cdk-github-runners.IRunnerProvider",
+          "parameters": [
+            {
+              "name": "statusFunctionRole",
+              "type": {
+                "fqn": "aws-cdk-lib.aws_iam.IGrantable"
+              }
+            }
+          ],
+          "returns": {
+            "type": {
+              "fqn": "@cloudsnorkel/cdk-github-runners.IRunnerProviderStatus"
+            }
+          }
         }
       ],
       "name": "CodeBuildRunner",
@@ -3770,7 +3980,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/providers/codebuild.ts",
-            "line": 118
+            "line": 128
           },
           "name": "LINUX_ARM64_DOCKERFILE_PATH",
           "static": true,
@@ -3788,7 +3998,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/providers/codebuild.ts",
-            "line": 105
+            "line": 115
           },
           "name": "LINUX_X64_DOCKERFILE_PATH",
           "static": true,
@@ -3804,7 +4014,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/providers/codebuild.ts",
-            "line": 303
+            "line": 333
           },
           "name": "connections",
           "overrides": "aws-cdk-lib.aws_ec2.IConnectable",
@@ -3820,7 +4030,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/providers/codebuild.ts",
-            "line": 143
+            "line": 153
           },
           "name": "grantPrincipal",
           "overrides": "aws-cdk-lib.aws_iam.IGrantable",
@@ -3830,16 +4040,16 @@
         },
         {
           "docs": {
+            "remarks": "The image is built by an image builder and is specific to CodeBuild.",
             "stability": "experimental",
-            "summary": "Docker image in CodeBuild project."
+            "summary": "Docker image loaded with GitHub Actions Runner and its prerequisites."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/providers/codebuild.ts",
-            "line": 148
+            "line": 158
           },
           "name": "image",
-          "overrides": "@cloudsnorkel/cdk-github-runners.IRunnerProvider",
           "type": {
             "fqn": "@cloudsnorkel/cdk-github-runners.RunnerImage"
           }
@@ -3852,7 +4062,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/providers/codebuild.ts",
-            "line": 128
+            "line": 138
           },
           "name": "labels",
           "overrides": "@cloudsnorkel/cdk-github-runners.IRunnerProvider",
@@ -3873,7 +4083,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/providers/codebuild.ts",
-            "line": 123
+            "line": 133
           },
           "name": "project",
           "type": {
@@ -3888,7 +4098,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/providers/codebuild.ts",
-            "line": 138
+            "line": 148
           },
           "name": "securityGroup",
           "optional": true,
@@ -3905,7 +4115,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/providers/codebuild.ts",
-            "line": 133
+            "line": 143
           },
           "name": "vpc",
           "optional": true,
@@ -3930,7 +4140,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/providers/codebuild.ts",
-        "line": 20
+        "line": 30
       },
       "name": "CodeBuildRunnerProps",
       "properties": [
@@ -3945,7 +4155,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/providers/codebuild.ts",
-            "line": 74
+            "line": 84
           },
           "name": "computeType",
           "optional": true,
@@ -3959,12 +4169,12 @@
             "default": "image builder with `CodeBuildRunner.LINUX_X64_DOCKERFILE_PATH` as Dockerfile",
             "remarks": "A user named `runner` is expected to exist with access to Docker-in-Docker.",
             "stability": "experimental",
-            "summary": "Provider running an image to run inside CodeBuild with GitHub runner pre-configured."
+            "summary": "Image builder for CodeBuild image with GitHub runner pre-configured."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/providers/codebuild.ts",
-            "line": 26
+            "line": 36
           },
           "name": "imageBuilder",
           "optional": true,
@@ -3983,7 +4193,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/providers/codebuild.ts",
-            "line": 34
+            "line": 44
           },
           "name": "label",
           "optional": true,
@@ -4002,7 +4212,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/providers/codebuild.ts",
-            "line": 45
+            "line": 55
           },
           "name": "labels",
           "optional": true,
@@ -4025,7 +4235,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/providers/codebuild.ts",
-            "line": 59
+            "line": 69
           },
           "name": "securityGroup",
           "optional": true,
@@ -4043,7 +4253,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/providers/codebuild.ts",
-            "line": 66
+            "line": 76
           },
           "name": "subnetSelection",
           "optional": true,
@@ -4062,7 +4272,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/providers/codebuild.ts",
-            "line": 83
+            "line": 93
           },
           "name": "timeout",
           "optional": true,
@@ -4080,7 +4290,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/providers/codebuild.ts",
-            "line": 52
+            "line": 62
           },
           "name": "vpc",
           "optional": true,
@@ -4095,9 +4305,9 @@
       "assembly": "@cloudsnorkel/cdk-github-runners",
       "base": "constructs.Construct",
       "docs": {
-        "remarks": "Builders can be used with runner providers.\n\nThe CodeBuild builder is better and faster. Only use this one if you have no choice. For example, if you need Windows containers.\n\nEach builder re-runs automatically at a set interval to make sure the images contain the latest versions of everything.\n\nYou can create an instance of this construct to customize the image used to spin-up runners. Some runner providers may require custom components. Check the runner provider documentation. The default components work with CodeBuild and Fargate.\n\nFor example, to set a specific runner version, rebuild the image every 2 weeks, and add a few packages for the Fargate provider, use:\n\n```\nconst builder = new ContainerImageBuilder(this, 'Builder', {\n     runnerVersion: RunnerVersion.specific('2.293.0'),\n     rebuildInterval: Duration.days(14),\n});\nnew CodeBuildRunner(this, 'CodeBuild provider', {\n     label: 'windows-codebuild',\n     imageBuilder: builder,\n});\n```",
+        "remarks": "Builders can be used with runner providers.\n\nThe CodeBuild builder is better and faster. Only use this one if you have no choice. For example, if you need Windows containers.\n\nEach builder re-runs automatically at a set interval to make sure the images contain the latest versions of everything.\n\nYou can create an instance of this construct to customize the image used to spin-up runners. Some runner providers may require custom components. Check the runner provider documentation. The default components work with CodeBuild and Fargate.\n\nFor example, to set a specific runner version, rebuild the image every 2 weeks, and add a few packages for the Fargate provider, use:\n\n```\nconst builder = new ContainerImageBuilder(this, 'Builder', {\n     runnerVersion: RunnerVersion.specific('2.293.0'),\n     rebuildInterval: Duration.days(14),\n});\nnew CodeBuildRunner(this, 'CodeBuild provider', {\n     label: 'custom-codebuild',\n     imageBuilder: builder,\n});\n```",
         "stability": "experimental",
-        "summary": "An image builder that uses Image Builder to build Docker images pre-baked with all the GitHub Actions runner requirements."
+        "summary": "An image builder that uses AWS Image Builder to build Docker images pre-baked with all the GitHub Actions runner requirements."
       },
       "fqn": "@cloudsnorkel/cdk-github-runners.ContainerImageBuilder",
       "initializer": {
@@ -4106,7 +4316,7 @@
         },
         "locationInModule": {
           "filename": "src/providers/image-builders/container.ts",
-          "line": 451
+          "line": 221
         },
         "parameters": [
           {
@@ -4136,7 +4346,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/providers/image-builders/container.ts",
-        "line": 430
+        "line": 216
       },
       "methods": [
         {
@@ -4146,7 +4356,7 @@
           },
           "locationInModule": {
             "filename": "src/providers/image-builders/container.ts",
-            "line": 595
+            "line": 283
           },
           "name": "addComponent",
           "parameters": [
@@ -4166,7 +4376,7 @@
           },
           "locationInModule": {
             "filename": "src/providers/image-builders/container.ts",
-            "line": 612
+            "line": 300
           },
           "name": "addExtraCertificates",
           "parameters": [
@@ -4188,7 +4398,7 @@
           },
           "locationInModule": {
             "filename": "src/providers/image-builders/container.ts",
-            "line": 633
+            "line": 321
           },
           "name": "bind",
           "overrides": "@cloudsnorkel/cdk-github-runners.IImageBuilder",
@@ -4200,71 +4410,104 @@
         },
         {
           "docs": {
-            "remarks": "Useful for required system settings like certificates or proxy settings.",
-            "stability": "experimental",
-            "summary": "Add a component to be installed before any other components."
+            "stability": "experimental"
           },
           "locationInModule": {
-            "filename": "src/providers/image-builders/container.ts",
-            "line": 581
+            "filename": "src/providers/image-builders/common.ts",
+            "line": 446
           },
-          "name": "prependComponent",
+          "name": "createImage",
           "parameters": [
             {
-              "name": "component",
+              "name": "infra",
               "type": {
-                "fqn": "@cloudsnorkel/cdk-github-runners.ImageBuilderComponent"
+                "fqn": "aws-cdk-lib.aws_imagebuilder.CfnInfrastructureConfiguration"
+              }
+            },
+            {
+              "name": "dist",
+              "type": {
+                "fqn": "aws-cdk-lib.aws_imagebuilder.CfnDistributionConfiguration"
+              }
+            },
+            {
+              "name": "log",
+              "type": {
+                "fqn": "aws-cdk-lib.aws_logs.LogGroup"
+              }
+            },
+            {
+              "name": "imageRecipeArn",
+              "optional": true,
+              "type": {
+                "primitive": "string"
+              }
+            },
+            {
+              "name": "containerRecipeArn",
+              "optional": true,
+              "type": {
+                "primitive": "string"
               }
             }
-          ]
-        }
-      ],
-      "name": "ContainerImageBuilder",
-      "properties": [
-        {
-          "docs": {
-            "stability": "experimental"
-          },
-          "immutable": true,
-          "locationInModule": {
-            "filename": "src/providers/image-builders/container.ts",
-            "line": 431
-          },
-          "name": "architecture",
-          "type": {
-            "fqn": "@cloudsnorkel/cdk-github-runners.Architecture"
+          ],
+          "protected": true,
+          "returns": {
+            "type": {
+              "fqn": "aws-cdk-lib.aws_imagebuilder.CfnImage"
+            }
           }
         },
         {
           "docs": {
             "stability": "experimental"
           },
-          "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/container.ts",
-            "line": 435
+            "filename": "src/providers/image-builders/common.ts",
+            "line": 422
           },
-          "name": "description",
-          "type": {
-            "primitive": "string"
+          "name": "createInfrastructure",
+          "parameters": [
+            {
+              "name": "managedPolicies",
+              "type": {
+                "collection": {
+                  "elementtype": {
+                    "fqn": "aws-cdk-lib.aws_iam.IManagedPolicy"
+                  },
+                  "kind": "array"
+                }
+              }
+            }
+          ],
+          "protected": true,
+          "returns": {
+            "type": {
+              "fqn": "aws-cdk-lib.aws_imagebuilder.CfnInfrastructureConfiguration"
+            }
           }
         },
         {
           "docs": {
             "stability": "experimental"
           },
-          "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/container.ts",
-            "line": 446
+            "filename": "src/providers/image-builders/common.ts",
+            "line": 414
           },
-          "name": "instanceTypes",
-          "type": {
-            "collection": {
-              "elementtype": {
+          "name": "createLog",
+          "parameters": [
+            {
+              "name": "recipeName",
+              "type": {
                 "primitive": "string"
-              },
-              "kind": "array"
+              }
+            }
+          ],
+          "protected": true,
+          "returns": {
+            "type": {
+              "fqn": "aws-cdk-lib.aws_logs.LogGroup"
             }
           }
         },
@@ -4272,28 +4515,88 @@
           "docs": {
             "stability": "experimental"
           },
-          "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/container.ts",
-            "line": 449
+            "filename": "src/providers/image-builders/common.ts",
+            "line": 463
           },
-          "name": "logRemovalPolicy",
-          "type": {
-            "fqn": "aws-cdk-lib.RemovalPolicy"
+          "name": "createPipeline",
+          "parameters": [
+            {
+              "name": "infra",
+              "type": {
+                "fqn": "aws-cdk-lib.aws_imagebuilder.CfnInfrastructureConfiguration"
+              }
+            },
+            {
+              "name": "dist",
+              "type": {
+                "fqn": "aws-cdk-lib.aws_imagebuilder.CfnDistributionConfiguration"
+              }
+            },
+            {
+              "name": "log",
+              "type": {
+                "fqn": "aws-cdk-lib.aws_logs.LogGroup"
+              }
+            },
+            {
+              "name": "imageRecipeArn",
+              "optional": true,
+              "type": {
+                "primitive": "string"
+              }
+            },
+            {
+              "name": "containerRecipeArn",
+              "optional": true,
+              "type": {
+                "primitive": "string"
+              }
+            }
+          ],
+          "protected": true,
+          "returns": {
+            "type": {
+              "fqn": "aws-cdk-lib.aws_imagebuilder.CfnImagePipeline"
+            }
           }
         },
+        {
+          "docs": {
+            "remarks": "Useful for required system settings like certificates or proxy settings.",
+            "stability": "experimental",
+            "summary": "Add a component to be installed before any other components."
+          },
+          "locationInModule": {
+            "filename": "src/providers/image-builders/container.ts",
+            "line": 269
+          },
+          "name": "prependComponent",
+          "parameters": [
+            {
+              "name": "component",
+              "type": {
+                "fqn": "@cloudsnorkel/cdk-github-runners.ImageBuilderComponent"
+              }
+            }
+          ]
+        }
+      ],
+      "name": "ContainerImageBuilder",
+      "properties": [
         {
           "docs": {
             "stability": "experimental"
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/container.ts",
-            "line": 448
+            "filename": "src/providers/image-builders/common.ts",
+            "line": 343
           },
-          "name": "logRetention",
+          "name": "architecture",
+          "protected": true,
           "type": {
-            "fqn": "aws-cdk-lib.aws_logs.RetentionDays"
+            "fqn": "@cloudsnorkel/cdk-github-runners.Architecture"
           }
         },
         {
@@ -4302,12 +4605,13 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/container.ts",
-            "line": 432
+            "filename": "src/providers/image-builders/common.ts",
+            "line": 347
           },
-          "name": "os",
+          "name": "description",
+          "protected": true,
           "type": {
-            "fqn": "@cloudsnorkel/cdk-github-runners.Os"
+            "primitive": "string"
           }
         },
         {
@@ -4316,12 +4620,13 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/container.ts",
-            "line": 433
+            "filename": "src/providers/image-builders/common.ts",
+            "line": 344
           },
-          "name": "platform",
+          "name": "os",
+          "protected": true,
           "type": {
-            "primitive": "string"
+            "fqn": "@cloudsnorkel/cdk-github-runners.Os"
           }
         },
         {
@@ -4330,12 +4635,13 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/container.ts",
-            "line": 447
+            "filename": "src/providers/image-builders/common.ts",
+            "line": 345
           },
-          "name": "rebuildInterval",
+          "name": "platform",
+          "protected": true,
           "type": {
-            "fqn": "aws-cdk-lib.Duration"
+            "primitive": "string"
           }
         },
         {
@@ -4345,7 +4651,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/providers/image-builders/container.ts",
-            "line": 439
+            "line": 217
           },
           "name": "repository",
           "type": {
@@ -4358,10 +4664,11 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/container.ts",
-            "line": 437
+            "filename": "src/providers/image-builders/common.ts",
+            "line": 349
           },
           "name": "runnerVersion",
+          "protected": true,
           "type": {
             "fqn": "@cloudsnorkel/cdk-github-runners.RunnerVersion"
           }
@@ -4370,36 +4677,20 @@
           "docs": {
             "stability": "experimental"
           },
-          "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/container.ts",
-            "line": 445
+            "filename": "src/providers/image-builders/common.ts",
+            "line": 351
           },
-          "name": "securityGroupIds",
-          "optional": true,
+          "name": "components",
+          "protected": true,
           "type": {
             "collection": {
               "elementtype": {
-                "primitive": "string"
+                "fqn": "@cloudsnorkel/cdk-github-runners.ImageBuilderComponent"
               },
               "kind": "array"
             }
           }
-        },
-        {
-          "docs": {
-            "stability": "experimental"
-          },
-          "immutable": true,
-          "locationInModule": {
-            "filename": "src/providers/image-builders/container.ts",
-            "line": 444
-          },
-          "name": "subnetId",
-          "optional": true,
-          "type": {
-            "primitive": "string"
-          }
         }
       ],
       "symbolId": "src/providers/image-builders/container:ContainerImageBuilder"
@@ -4415,7 +4706,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/providers/image-builders/container.ts",
-        "line": 28
+        "line": 29
       },
       "name": "ContainerImageBuilderProps",
       "properties": [
@@ -4429,7 +4720,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/providers/image-builders/container.ts",
-            "line": 34
+            "line": 35
           },
           "name": "architecture",
           "optional": true,
@@ -4447,7 +4738,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/providers/image-builders/container.ts",
-            "line": 92
+            "line": 93
           },
           "name": "instanceType",
           "optional": true,
@@ -4466,7 +4757,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/providers/image-builders/container.ts",
-            "line": 110
+            "line": 111
           },
           "name": "logRemovalPolicy",
           "optional": true,
@@ -4485,7 +4776,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/providers/image-builders/container.ts",
-            "line": 101
+            "line": 102
           },
           "name": "logRetention",
           "optional": true,
@@ -4503,7 +4794,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/providers/image-builders/container.ts",
-            "line": 41
+            "line": 42
           },
           "name": "os",
           "optional": true,
@@ -4522,7 +4813,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/providers/image-builders/container.ts",
-            "line": 48
+            "line": 49
           },
           "name": "parentImage",
           "optional": true,
@@ -4541,7 +4832,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/providers/image-builders/container.ts",
-            "line": 64
+            "line": 65
           },
           "name": "rebuildInterval",
           "optional": true,
@@ -4559,7 +4850,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/providers/image-builders/container.ts",
-            "line": 55
+            "line": 56
           },
           "name": "runnerVersion",
           "optional": true,
@@ -4577,7 +4868,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/providers/image-builders/container.ts",
-            "line": 78
+            "line": 79
           },
           "name": "securityGroup",
           "optional": true,
@@ -4595,7 +4886,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/providers/image-builders/container.ts",
-            "line": 85
+            "line": 86
           },
           "name": "subnetSelection",
           "optional": true,
@@ -4613,7 +4904,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/providers/image-builders/container.ts",
-            "line": 71
+            "line": 72
           },
           "name": "vpc",
           "optional": true,
@@ -4630,7 +4921,7 @@
       "docs": {
         "remarks": "Creates a task definition with a single container that gets started for each job.\n\nThis construct is not meant to be used by itself. It should be passed in the providers property for GitHubRunners.",
         "stability": "experimental",
-        "summary": "GitHub Actions runner provider using Fargate to execute the actions."
+        "summary": "GitHub Actions runner provider using Fargate to execute jobs."
       },
       "fqn": "@cloudsnorkel/cdk-github-runners.FargateRunner",
       "initializer": {
@@ -4639,7 +4930,7 @@
         },
         "locationInModule": {
           "filename": "src/providers/fargate.ts",
-          "line": 263
+          "line": 273
         },
         "parameters": [
           {
@@ -4668,7 +4959,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/providers/fargate.ts",
-        "line": 184
+        "line": 194
       },
       "methods": [
         {
@@ -4679,7 +4970,7 @@
           },
           "locationInModule": {
             "filename": "src/providers/fargate.ts",
-            "line": 346
+            "line": 356
           },
           "name": "getStepFunctionTask",
           "overrides": "@cloudsnorkel/cdk-github-runners.IRunnerProvider",
@@ -4700,13 +4991,34 @@
             }
           }
         },
+        {
+          "docs": {
+            "remarks": "This can be used to add additional policy\nstatements to the state machine role that are not automatically added by the task returned from {@link getStepFunctionTask}.",
+            "stability": "experimental",
+            "summary": "An optional method that modifies the role of the state machine after all the tasks have been generated."
+          },
+          "locationInModule": {
+            "filename": "src/providers/fargate.ts",
+            "line": 406
+          },
+          "name": "grantStateMachine",
+          "overrides": "@cloudsnorkel/cdk-github-runners.IRunnerProvider",
+          "parameters": [
+            {
+              "name": "_",
+              "type": {
+                "fqn": "aws-cdk-lib.aws_iam.IGrantable"
+              }
+            }
+          ]
+        },
         {
           "docs": {
             "stability": "experimental"
           },
           "locationInModule": {
             "filename": "src/providers/common.ts",
-            "line": 253
+            "line": 426
           },
           "name": "labelsFromProperties",
           "parameters": [
@@ -4747,6 +5059,32 @@
               }
             }
           }
+        },
+        {
+          "docs": {
+            "remarks": "Also gives the status function any needed permissions to query the Docker image or AMI.",
+            "stability": "experimental",
+            "summary": "Return status of the runner provider to be used in the main status function."
+          },
+          "locationInModule": {
+            "filename": "src/providers/fargate.ts",
+            "line": 409
+          },
+          "name": "status",
+          "overrides": "@cloudsnorkel/cdk-github-runners.IRunnerProvider",
+          "parameters": [
+            {
+              "name": "statusFunctionRole",
+              "type": {
+                "fqn": "aws-cdk-lib.aws_iam.IGrantable"
+              }
+            }
+          ],
+          "returns": {
+            "type": {
+              "fqn": "@cloudsnorkel/cdk-github-runners.IRunnerProviderStatus"
+            }
+          }
         }
       ],
       "name": "FargateRunner",
@@ -4761,7 +5099,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/providers/fargate.ts",
-            "line": 201
+            "line": 211
           },
           "name": "LINUX_ARM64_DOCKERFILE_PATH",
           "static": true,
@@ -4779,7 +5117,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/providers/fargate.ts",
-            "line": 192
+            "line": 202
           },
           "name": "LINUX_X64_DOCKERFILE_PATH",
           "static": true,
@@ -4795,7 +5133,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/providers/fargate.ts",
-            "line": 241
+            "line": 251
           },
           "name": "assignPublicIp",
           "type": {
@@ -4810,7 +5148,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/providers/fargate.ts",
-            "line": 206
+            "line": 216
           },
           "name": "cluster",
           "type": {
@@ -4825,7 +5163,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/providers/fargate.ts",
-            "line": 251
+            "line": 261
           },
           "name": "connections",
           "overrides": "aws-cdk-lib.aws_ec2.IConnectable",
@@ -4841,7 +5179,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/providers/fargate.ts",
-            "line": 216
+            "line": 226
           },
           "name": "container",
           "type": {
@@ -4856,7 +5194,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/providers/fargate.ts",
-            "line": 246
+            "line": 256
           },
           "name": "grantPrincipal",
           "overrides": "aws-cdk-lib.aws_iam.IGrantable",
@@ -4866,16 +5204,16 @@
         },
         {
           "docs": {
+            "remarks": "The image is built by an image builder and is specific to Fargate tasks.",
             "stability": "experimental",
-            "summary": "Docker image used to start a new Fargate task."
+            "summary": "Docker image loaded with GitHub Actions Runner and its prerequisites."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/providers/fargate.ts",
-            "line": 261
+            "line": 271
           },
           "name": "image",
-          "overrides": "@cloudsnorkel/cdk-github-runners.IRunnerProvider",
           "type": {
             "fqn": "@cloudsnorkel/cdk-github-runners.RunnerImage"
           }
@@ -4888,7 +5226,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/providers/fargate.ts",
-            "line": 221
+            "line": 231
           },
           "name": "labels",
           "overrides": "@cloudsnorkel/cdk-github-runners.IRunnerProvider",
@@ -4909,7 +5247,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/providers/fargate.ts",
-            "line": 256
+            "line": 266
           },
           "name": "spot",
           "type": {
@@ -4924,7 +5262,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/providers/fargate.ts",
-            "line": 211
+            "line": 221
           },
           "name": "task",
           "type": {
@@ -4939,7 +5277,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/providers/fargate.ts",
-            "line": 236
+            "line": 246
           },
           "name": "securityGroup",
           "optional": true,
@@ -4956,7 +5294,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/providers/fargate.ts",
-            "line": 231
+            "line": 241
           },
           "name": "subnetSelection",
           "optional": true,
@@ -4972,7 +5310,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/providers/fargate.ts",
-            "line": 226
+            "line": 236
           },
           "name": "vpc",
           "optional": true,
@@ -4998,7 +5336,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/providers/fargate.ts",
-        "line": 20
+        "line": 30
       },
       "name": "FargateRunnerProps",
       "properties": [
@@ -5013,7 +5351,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/providers/fargate.ts",
-            "line": 82
+            "line": 92
           },
           "name": "assignPublicIp",
           "optional": true,
@@ -5031,7 +5369,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/providers/fargate.ts",
-            "line": 73
+            "line": 83
           },
           "name": "cluster",
           "optional": true,
@@ -5050,7 +5388,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/providers/fargate.ts",
-            "line": 101
+            "line": 111
           },
           "name": "cpu",
           "optional": true,
@@ -5069,7 +5407,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/providers/fargate.ts",
-            "line": 128
+            "line": 138
           },
           "name": "ephemeralStorageGiB",
           "optional": true,
@@ -5088,7 +5426,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/providers/fargate.ts",
-            "line": 26
+            "line": 36
           },
           "name": "imageBuilder",
           "optional": true,
@@ -5107,7 +5445,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/providers/fargate.ts",
-            "line": 34
+            "line": 44
           },
           "name": "label",
           "optional": true,
@@ -5126,7 +5464,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/providers/fargate.ts",
-            "line": 45
+            "line": 55
           },
           "name": "labels",
           "optional": true,
@@ -5150,7 +5488,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/providers/fargate.ts",
-            "line": 119
+            "line": 129
           },
           "name": "memoryLimitMiB",
           "optional": true,
@@ -5168,7 +5506,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/providers/fargate.ts",
-            "line": 66
+            "line": 76
           },
           "name": "securityGroup",
           "optional": true,
@@ -5187,7 +5525,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/providers/fargate.ts",
-            "line": 138
+            "line": 148
           },
           "name": "spot",
           "optional": true,
@@ -5205,7 +5543,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/providers/fargate.ts",
-            "line": 59
+            "line": 69
           },
           "name": "subnetSelection",
           "optional": true,
@@ -5223,7 +5561,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/providers/fargate.ts",
-            "line": 52
+            "line": 62
           },
           "name": "vpc",
           "optional": true,
@@ -5481,7 +5819,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/providers/common.ts",
-        "line": 128
+        "line": 188
       },
       "methods": [
         {
@@ -5490,11 +5828,11 @@
             "remarks": "This method can be called multiple times if the image is bound to multiple providers. Make sure you cache the image when implementing or return an error if this builder doesn't support reusing images.",
             "returns": "image",
             "stability": "experimental",
-            "summary": "ECR repository containing the image."
+            "summary": "Finalize and return all required information about the Docker image built by this builder."
           },
           "locationInModule": {
             "filename": "src/providers/common.ts",
-            "line": 136
+            "line": 196
           },
           "name": "bind",
           "returns": {
@@ -5507,50 +5845,32 @@
       "name": "IImageBuilder",
       "symbolId": "src/providers/common:IImageBuilder"
     },
-    "@cloudsnorkel/cdk-github-runners.IRunnerImageStatus": {
+    "@cloudsnorkel/cdk-github-runners.IRunnerAmiStatus": {
       "assembly": "@cloudsnorkel/cdk-github-runners",
       "docs": {
         "stability": "experimental",
-        "summary": "Interface for runner image status used by status.json."
+        "summary": "AMI status returned from runner providers to be displayed as output of status function."
       },
-      "fqn": "@cloudsnorkel/cdk-github-runners.IRunnerImageStatus",
+      "fqn": "@cloudsnorkel/cdk-github-runners.IRunnerAmiStatus",
       "kind": "interface",
       "locationInModule": {
         "filename": "src/providers/common.ts",
-        "line": 192
+        "line": 320
       },
-      "name": "IRunnerImageStatus",
+      "name": "IRunnerAmiStatus",
       "properties": [
         {
           "abstract": true,
           "docs": {
             "stability": "experimental",
-            "summary": "Log group name for the image builder where history of image builds can be analyzed."
-          },
-          "immutable": true,
-          "locationInModule": {
-            "filename": "src/providers/common.ts",
-            "line": 206
-          },
-          "name": "imageBuilderLogGroup",
-          "optional": true,
-          "type": {
-            "primitive": "string"
-          }
-        },
-        {
-          "abstract": true,
-          "docs": {
-            "stability": "experimental",
-            "summary": "Image repository where runner image is pushed."
+            "summary": "Id of launch template pointing to the latest AMI built by the AMI builder."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/providers/common.ts",
-            "line": 196
+            "line": 324
           },
-          "name": "imageRepository",
-          "optional": true,
+          "name": "launchTemplate",
           "type": {
             "primitive": "string"
           }
@@ -5559,57 +5879,123 @@
           "abstract": true,
           "docs": {
             "stability": "experimental",
-            "summary": "Tag of image that should be used."
+            "summary": "Log group name for the AMI builder where history of builds can be analyzed."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/providers/common.ts",
-            "line": 201
+            "line": 329
           },
-          "name": "imageTag",
+          "name": "amiBuilderLogGroup",
           "optional": true,
           "type": {
             "primitive": "string"
           }
         }
       ],
-      "symbolId": "src/providers/common:IRunnerImageStatus"
+      "symbolId": "src/providers/common:IRunnerAmiStatus"
     },
-    "@cloudsnorkel/cdk-github-runners.IRunnerProvider": {
+    "@cloudsnorkel/cdk-github-runners.IRunnerImageStatus": {
       "assembly": "@cloudsnorkel/cdk-github-runners",
       "docs": {
-        "remarks": "Implementations create all required resources and return a step function task that starts those resources from {@link getStepFunctionTask}.",
         "stability": "experimental",
-        "summary": "Interface for all runner providers."
+        "summary": "Image status returned from runner providers to be displayed in status.json."
       },
-      "fqn": "@cloudsnorkel/cdk-github-runners.IRunnerProvider",
-      "interfaces": [
-        "aws-cdk-lib.aws_ec2.IConnectable",
-        "aws-cdk-lib.aws_iam.IGrantable"
-      ],
+      "fqn": "@cloudsnorkel/cdk-github-runners.IRunnerImageStatus",
       "kind": "interface",
       "locationInModule": {
         "filename": "src/providers/common.ts",
-        "line": 212
+        "line": 300
       },
-      "methods": [
+      "name": "IRunnerImageStatus",
+      "properties": [
         {
           "abstract": true,
           "docs": {
-            "remarks": "Called by GithubRunners and shouldn't be called manually.",
             "stability": "experimental",
-            "summary": "Generate step function tasks that execute the runner."
+            "summary": "Image repository where image builder pushes runner images."
           },
+          "immutable": true,
           "locationInModule": {
             "filename": "src/providers/common.ts",
-            "line": 244
+            "line": 304
           },
-          "name": "getStepFunctionTask",
-          "parameters": [
-            {
-              "docs": {
-                "summary": "specific build parameters."
-              },
+          "name": "imageRepository",
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "Tag of image that should be used."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/providers/common.ts",
+            "line": 309
+          },
+          "name": "imageTag",
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "Log group name for the image builder where history of image builds can be analyzed."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/providers/common.ts",
+            "line": 314
+          },
+          "name": "imageBuilderLogGroup",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        }
+      ],
+      "symbolId": "src/providers/common:IRunnerImageStatus"
+    },
+    "@cloudsnorkel/cdk-github-runners.IRunnerProvider": {
+      "assembly": "@cloudsnorkel/cdk-github-runners",
+      "docs": {
+        "remarks": "Implementations create all required resources and return a step function task that starts those resources from {@link getStepFunctionTask}.",
+        "stability": "experimental",
+        "summary": "Interface for all runner providers."
+      },
+      "fqn": "@cloudsnorkel/cdk-github-runners.IRunnerProvider",
+      "interfaces": [
+        "aws-cdk-lib.aws_ec2.IConnectable",
+        "aws-cdk-lib.aws_iam.IGrantable"
+      ],
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "src/providers/common.ts",
+        "line": 375
+      },
+      "methods": [
+        {
+          "abstract": true,
+          "docs": {
+            "remarks": "Called by GithubRunners and shouldn't be called manually.",
+            "stability": "experimental",
+            "summary": "Generate step function tasks that execute the runner."
+          },
+          "locationInModule": {
+            "filename": "src/providers/common.ts",
+            "line": 402
+          },
+          "name": "getStepFunctionTask",
+          "parameters": [
+            {
+              "docs": {
+                "summary": "specific build parameters."
+              },
               "name": "parameters",
               "type": {
                 "fqn": "@cloudsnorkel/cdk-github-runners.RunnerRuntimeParameters"
@@ -5621,27 +6007,63 @@
               "fqn": "aws-cdk-lib.aws_stepfunctions.IChainable"
             }
           }
-        }
-      ],
-      "name": "IRunnerProvider",
-      "properties": [
+        },
         {
           "abstract": true,
           "docs": {
-            "remarks": "Can be Docker image, AMI, or something else.",
+            "remarks": "This can be used to add additional policy\nstatements to the state machine role that are not automatically added by the task returned from {@link getStepFunctionTask}.",
             "stability": "experimental",
-            "summary": "Image used to create a new resource compute."
+            "summary": "An optional method that modifies the role of the state machine after all the tasks have been generated."
           },
-          "immutable": true,
           "locationInModule": {
             "filename": "src/providers/common.ts",
-            "line": 235
+            "line": 410
           },
-          "name": "image",
-          "type": {
-            "fqn": "@cloudsnorkel/cdk-github-runners.RunnerImage"
-          }
+          "name": "grantStateMachine",
+          "parameters": [
+            {
+              "docs": {
+                "summary": "role for the state machine that executes the task returned from {@link getStepFunctionTask}."
+              },
+              "name": "stateMachineRole",
+              "type": {
+                "fqn": "aws-cdk-lib.aws_iam.IGrantable"
+              }
+            }
+          ]
         },
+        {
+          "abstract": true,
+          "docs": {
+            "remarks": "Also gives the status function any needed permissions to query the Docker image or AMI.",
+            "stability": "experimental",
+            "summary": "Return status of the runner provider to be used in the main status function."
+          },
+          "locationInModule": {
+            "filename": "src/providers/common.ts",
+            "line": 417
+          },
+          "name": "status",
+          "parameters": [
+            {
+              "docs": {
+                "summary": "grantable for the status function."
+              },
+              "name": "statusFunctionRole",
+              "type": {
+                "fqn": "aws-cdk-lib.aws_iam.IGrantable"
+              }
+            }
+          ],
+          "returns": {
+            "type": {
+              "fqn": "@cloudsnorkel/cdk-github-runners.IRunnerProviderStatus"
+            }
+          }
+        }
+      ],
+      "name": "IRunnerProvider",
+      "properties": [
         {
           "abstract": true,
           "docs": {
@@ -5652,7 +6074,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/providers/common.ts",
-            "line": 220
+            "line": 383
           },
           "name": "labels",
           "type": {
@@ -5673,7 +6095,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/providers/common.ts",
-            "line": 230
+            "line": 393
           },
           "name": "securityGroup",
           "optional": true,
@@ -5690,7 +6112,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/providers/common.ts",
-            "line": 225
+            "line": 388
           },
           "name": "vpc",
           "optional": true,
@@ -5701,6 +6123,145 @@
       ],
       "symbolId": "src/providers/common:IRunnerProvider"
     },
+    "@cloudsnorkel/cdk-github-runners.IRunnerProviderStatus": {
+      "assembly": "@cloudsnorkel/cdk-github-runners",
+      "docs": {
+        "stability": "experimental",
+        "summary": "Interface for runner image status used by status.json."
+      },
+      "fqn": "@cloudsnorkel/cdk-github-runners.IRunnerProviderStatus",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "src/providers/common.ts",
+        "line": 335
+      },
+      "name": "IRunnerProviderStatus",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "Labels associated with provider."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/providers/common.ts",
+            "line": 344
+          },
+          "name": "labels",
+          "type": {
+            "collection": {
+              "elementtype": {
+                "primitive": "string"
+              },
+              "kind": "array"
+            }
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "Runner provider type."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/providers/common.ts",
+            "line": 339
+          },
+          "name": "type",
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "Details about AMI used by this runner provider."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/providers/common.ts",
+            "line": 369
+          },
+          "name": "ami",
+          "optional": true,
+          "type": {
+            "fqn": "@cloudsnorkel/cdk-github-runners.IRunnerAmiStatus"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "Details about Docker image used by this runner provider."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/providers/common.ts",
+            "line": 364
+          },
+          "name": "image",
+          "optional": true,
+          "type": {
+            "fqn": "@cloudsnorkel/cdk-github-runners.IRunnerImageStatus"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "Role attached to runners."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/providers/common.ts",
+            "line": 359
+          },
+          "name": "roleArn",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "Security group attached to runners."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/providers/common.ts",
+            "line": 354
+          },
+          "name": "securityGroup",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "VPC where runners will be launched."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/providers/common.ts",
+            "line": 349
+          },
+          "name": "vpcArn",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        }
+      ],
+      "symbolId": "src/providers/common:IRunnerProviderStatus"
+    },
     "@cloudsnorkel/cdk-github-runners.ImageBuilderAsset": {
       "assembly": "@cloudsnorkel/cdk-github-runners",
       "datatype": true,
@@ -5711,8 +6272,8 @@
       "fqn": "@cloudsnorkel/cdk-github-runners.ImageBuilderAsset",
       "kind": "interface",
       "locationInModule": {
-        "filename": "src/providers/image-builders/container.ts",
-        "line": 155
+        "filename": "src/providers/image-builders/common.ts",
+        "line": 69
       },
       "name": "ImageBuilderAsset",
       "properties": [
@@ -5724,8 +6285,8 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/container.ts",
-            "line": 164
+            "filename": "src/providers/image-builders/common.ts",
+            "line": 78
           },
           "name": "asset",
           "type": {
@@ -5740,8 +6301,8 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/container.ts",
-            "line": 159
+            "filename": "src/providers/image-builders/common.ts",
+            "line": 73
           },
           "name": "path",
           "type": {
@@ -5749,7 +6310,7 @@
           }
         }
       ],
-      "symbolId": "src/providers/image-builders/container:ImageBuilderAsset"
+      "symbolId": "src/providers/image-builders/common:ImageBuilderAsset"
     },
     "@cloudsnorkel/cdk-github-runners.ImageBuilderComponent": {
       "assembly": "@cloudsnorkel/cdk-github-runners",
@@ -5765,8 +6326,8 @@
           "stability": "experimental"
         },
         "locationInModule": {
-          "filename": "src/providers/image-builders/container.ts",
-          "line": 229
+          "filename": "src/providers/image-builders/common.ts",
+          "line": 143
         },
         "parameters": [
           {
@@ -5791,8 +6352,8 @@
       },
       "kind": "class",
       "locationInModule": {
-        "filename": "src/providers/image-builders/container.ts",
-        "line": 216
+        "filename": "src/providers/image-builders/common.ts",
+        "line": 130
       },
       "methods": [
         {
@@ -5801,8 +6362,8 @@
             "summary": "Grants read permissions to the principal on the assets buckets."
           },
           "locationInModule": {
-            "filename": "src/providers/image-builders/container.ts",
-            "line": 321
+            "filename": "src/providers/image-builders/common.ts",
+            "line": 236
           },
           "name": "grantAssetsRead",
           "parameters": [
@@ -5819,8 +6380,8 @@
             "stability": "experimental"
           },
           "locationInModule": {
-            "filename": "src/providers/image-builders/container.ts",
-            "line": 122
+            "filename": "src/providers/image-builders/common.ts",
+            "line": 36
           },
           "name": "version",
           "parameters": [
@@ -5860,8 +6421,8 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/container.ts",
-            "line": 220
+            "filename": "src/providers/image-builders/common.ts",
+            "line": 134
           },
           "name": "arn",
           "type": {
@@ -5875,8 +6436,8 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/container.ts",
-            "line": 225
+            "filename": "src/providers/image-builders/common.ts",
+            "line": 139
           },
           "name": "platform",
           "type": {
@@ -5884,7 +6445,7 @@
           }
         }
       ],
-      "symbolId": "src/providers/image-builders/container:ImageBuilderComponent"
+      "symbolId": "src/providers/image-builders/common:ImageBuilderComponent"
     },
     "@cloudsnorkel/cdk-github-runners.ImageBuilderComponentProperties": {
       "assembly": "@cloudsnorkel/cdk-github-runners",
@@ -5896,8 +6457,8 @@
       "fqn": "@cloudsnorkel/cdk-github-runners.ImageBuilderComponentProperties",
       "kind": "interface",
       "locationInModule": {
-        "filename": "src/providers/image-builders/container.ts",
-        "line": 170
+        "filename": "src/providers/image-builders/common.ts",
+        "line": 84
       },
       "name": "ImageBuilderComponentProperties",
       "properties": [
@@ -5910,8 +6471,8 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/container.ts",
-            "line": 191
+            "filename": "src/providers/image-builders/common.ts",
+            "line": 105
           },
           "name": "commands",
           "type": {
@@ -5931,8 +6492,8 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/container.ts",
-            "line": 184
+            "filename": "src/providers/image-builders/common.ts",
+            "line": 98
           },
           "name": "description",
           "type": {
@@ -5947,8 +6508,8 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/container.ts",
-            "line": 179
+            "filename": "src/providers/image-builders/common.ts",
+            "line": 93
           },
           "name": "displayName",
           "type": {
@@ -5964,8 +6525,8 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/container.ts",
-            "line": 174
+            "filename": "src/providers/image-builders/common.ts",
+            "line": 88
           },
           "name": "platform",
           "type": {
@@ -5980,8 +6541,8 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/container.ts",
-            "line": 196
+            "filename": "src/providers/image-builders/common.ts",
+            "line": 110
           },
           "name": "assets",
           "optional": true,
@@ -5995,7 +6556,7 @@
           }
         }
       ],
-      "symbolId": "src/providers/image-builders/container:ImageBuilderComponentProperties"
+      "symbolId": "src/providers/image-builders/common:ImageBuilderComponentProperties"
     },
     "@cloudsnorkel/cdk-github-runners.LambdaRunner": {
       "assembly": "@cloudsnorkel/cdk-github-runners",
@@ -6003,7 +6564,7 @@
       "docs": {
         "remarks": "Creates a Docker-based function that gets executed for each job.\n\nThis construct is not meant to be used by itself. It should be passed in the providers property for GitHubRunners.",
         "stability": "experimental",
-        "summary": "GitHub Actions runner provider using Lambda to execute the actions."
+        "summary": "GitHub Actions runner provider using Lambda to execute jobs."
       },
       "fqn": "@cloudsnorkel/cdk-github-runners.LambdaRunner",
       "initializer": {
@@ -6012,7 +6573,7 @@
         },
         "locationInModule": {
           "filename": "src/providers/lambda.ts",
-          "line": 153
+          "line": 163
         },
         "parameters": [
           {
@@ -6041,7 +6602,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/providers/lambda.ts",
-        "line": 104
+        "line": 114
       },
       "methods": [
         {
@@ -6052,7 +6613,7 @@
           },
           "locationInModule": {
             "filename": "src/providers/lambda.ts",
-            "line": 233
+            "line": 243
           },
           "name": "getStepFunctionTask",
           "overrides": "@cloudsnorkel/cdk-github-runners.IRunnerProvider",
@@ -6073,13 +6634,34 @@
             }
           }
         },
+        {
+          "docs": {
+            "remarks": "This can be used to add additional policy\nstatements to the state machine role that are not automatically added by the task returned from {@link getStepFunctionTask}.",
+            "stability": "experimental",
+            "summary": "An optional method that modifies the role of the state machine after all the tasks have been generated."
+          },
+          "locationInModule": {
+            "filename": "src/providers/lambda.ts",
+            "line": 301
+          },
+          "name": "grantStateMachine",
+          "overrides": "@cloudsnorkel/cdk-github-runners.IRunnerProvider",
+          "parameters": [
+            {
+              "name": "_",
+              "type": {
+                "fqn": "aws-cdk-lib.aws_iam.IGrantable"
+              }
+            }
+          ]
+        },
         {
           "docs": {
             "stability": "experimental"
           },
           "locationInModule": {
             "filename": "src/providers/common.ts",
-            "line": 253
+            "line": 426
           },
           "name": "labelsFromProperties",
           "parameters": [
@@ -6120,6 +6702,32 @@
               }
             }
           }
+        },
+        {
+          "docs": {
+            "remarks": "Also gives the status function any needed permissions to query the Docker image or AMI.",
+            "stability": "experimental",
+            "summary": "Return status of the runner provider to be used in the main status function."
+          },
+          "locationInModule": {
+            "filename": "src/providers/lambda.ts",
+            "line": 304
+          },
+          "name": "status",
+          "overrides": "@cloudsnorkel/cdk-github-runners.IRunnerProvider",
+          "parameters": [
+            {
+              "name": "statusFunctionRole",
+              "type": {
+                "fqn": "aws-cdk-lib.aws_iam.IGrantable"
+              }
+            }
+          ],
+          "returns": {
+            "type": {
+              "fqn": "@cloudsnorkel/cdk-github-runners.IRunnerProviderStatus"
+            }
+          }
         }
       ],
       "name": "LambdaRunner",
@@ -6134,7 +6742,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/providers/lambda.ts",
-            "line": 121
+            "line": 131
           },
           "name": "LINUX_ARM64_DOCKERFILE_PATH",
           "static": true,
@@ -6152,7 +6760,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/providers/lambda.ts",
-            "line": 112
+            "line": 122
           },
           "name": "LINUX_X64_DOCKERFILE_PATH",
           "static": true,
@@ -6168,7 +6776,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/providers/lambda.ts",
-            "line": 222
+            "line": 232
           },
           "name": "connections",
           "overrides": "aws-cdk-lib.aws_ec2.IConnectable",
@@ -6184,7 +6792,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/providers/lambda.ts",
-            "line": 126
+            "line": 136
           },
           "name": "function",
           "type": {
@@ -6199,7 +6807,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/providers/lambda.ts",
-            "line": 146
+            "line": 156
           },
           "name": "grantPrincipal",
           "overrides": "aws-cdk-lib.aws_iam.IGrantable",
@@ -6209,16 +6817,16 @@
         },
         {
           "docs": {
+            "remarks": "The image is built by an image builder and is specific to Lambda.",
             "stability": "experimental",
-            "summary": "Docker image used to start Lambda function."
+            "summary": "Docker image loaded with GitHub Actions Runner and its prerequisites."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/providers/lambda.ts",
-            "line": 151
+            "line": 161
           },
           "name": "image",
-          "overrides": "@cloudsnorkel/cdk-github-runners.IRunnerProvider",
           "type": {
             "fqn": "@cloudsnorkel/cdk-github-runners.RunnerImage"
           }
@@ -6231,7 +6839,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/providers/lambda.ts",
-            "line": 131
+            "line": 141
           },
           "name": "labels",
           "overrides": "@cloudsnorkel/cdk-github-runners.IRunnerProvider",
@@ -6252,7 +6860,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/providers/lambda.ts",
-            "line": 141
+            "line": 151
           },
           "name": "securityGroup",
           "optional": true,
@@ -6269,7 +6877,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/providers/lambda.ts",
-            "line": 136
+            "line": 146
           },
           "name": "vpc",
           "optional": true,
@@ -6294,7 +6902,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/providers/lambda.ts",
-        "line": 19
+        "line": 29
       },
       "name": "LambdaRunnerProps",
       "properties": [
@@ -6308,7 +6916,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/providers/lambda.ts",
-            "line": 64
+            "line": 74
           },
           "name": "ephemeralStorageSize",
           "optional": true,
@@ -6328,7 +6936,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/providers/lambda.ts",
-            "line": 28
+            "line": 38
           },
           "name": "imageBuilder",
           "optional": true,
@@ -6347,7 +6955,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/providers/lambda.ts",
-            "line": 36
+            "line": 46
           },
           "name": "label",
           "optional": true,
@@ -6366,7 +6974,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/providers/lambda.ts",
-            "line": 47
+            "line": 57
           },
           "name": "labels",
           "optional": true,
@@ -6390,7 +6998,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/providers/lambda.ts",
-            "line": 57
+            "line": 67
           },
           "name": "memorySize",
           "optional": true,
@@ -6408,7 +7016,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/providers/lambda.ts",
-            "line": 87
+            "line": 97
           },
           "name": "securityGroup",
           "optional": true,
@@ -6426,7 +7034,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/providers/lambda.ts",
-            "line": 94
+            "line": 104
           },
           "name": "subnetSelection",
           "optional": true,
@@ -6445,7 +7053,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/providers/lambda.ts",
-            "line": 73
+            "line": 83
           },
           "name": "timeout",
           "optional": true,
@@ -6463,7 +7071,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/providers/lambda.ts",
-            "line": 80
+            "line": 90
           },
           "name": "vpc",
           "optional": true,
@@ -6474,6 +7082,287 @@
       ],
       "symbolId": "src/providers/lambda:LambdaRunnerProps"
     },
+    "@cloudsnorkel/cdk-github-runners.LinuxUbuntuComponents": {
+      "assembly": "@cloudsnorkel/cdk-github-runners",
+      "docs": {
+        "remarks": "These cannot be used by {@link CodeBuildImageBuilder}.",
+        "stability": "experimental",
+        "summary": "Components for Ubuntu Linux that can be used with AWS Image Builder based builders."
+      },
+      "fqn": "@cloudsnorkel/cdk-github-runners.LinuxUbuntuComponents",
+      "initializer": {
+        "docs": {
+          "stability": "experimental"
+        }
+      },
+      "kind": "class",
+      "locationInModule": {
+        "filename": "src/providers/image-builders/linux-components.ts",
+        "line": 8
+      },
+      "methods": [
+        {
+          "docs": {
+            "stability": "experimental"
+          },
+          "locationInModule": {
+            "filename": "src/providers/image-builders/linux-components.ts",
+            "line": 48
+          },
+          "name": "awsCli",
+          "parameters": [
+            {
+              "name": "scope",
+              "type": {
+                "fqn": "constructs.Construct"
+              }
+            },
+            {
+              "name": "id",
+              "type": {
+                "primitive": "string"
+              }
+            },
+            {
+              "name": "architecture",
+              "type": {
+                "fqn": "@cloudsnorkel/cdk-github-runners.Architecture"
+              }
+            }
+          ],
+          "returns": {
+            "type": {
+              "fqn": "@cloudsnorkel/cdk-github-runners.ImageBuilderComponent"
+            }
+          },
+          "static": true
+        },
+        {
+          "docs": {
+            "stability": "experimental"
+          },
+          "locationInModule": {
+            "filename": "src/providers/image-builders/linux-components.ts",
+            "line": 134
+          },
+          "name": "docker",
+          "parameters": [
+            {
+              "name": "scope",
+              "type": {
+                "fqn": "constructs.Construct"
+              }
+            },
+            {
+              "name": "id",
+              "type": {
+                "primitive": "string"
+              }
+            },
+            {
+              "name": "_architecture",
+              "type": {
+                "fqn": "@cloudsnorkel/cdk-github-runners.Architecture"
+              }
+            }
+          ],
+          "returns": {
+            "type": {
+              "fqn": "@cloudsnorkel/cdk-github-runners.ImageBuilderComponent"
+            }
+          },
+          "static": true
+        },
+        {
+          "docs": {
+            "stability": "experimental"
+          },
+          "locationInModule": {
+            "filename": "src/providers/image-builders/linux-components.ts",
+            "line": 88
+          },
+          "name": "git",
+          "parameters": [
+            {
+              "name": "scope",
+              "type": {
+                "fqn": "constructs.Construct"
+              }
+            },
+            {
+              "name": "id",
+              "type": {
+                "primitive": "string"
+              }
+            },
+            {
+              "name": "_architecture",
+              "type": {
+                "fqn": "@cloudsnorkel/cdk-github-runners.Architecture"
+              }
+            }
+          ],
+          "returns": {
+            "type": {
+              "fqn": "@cloudsnorkel/cdk-github-runners.ImageBuilderComponent"
+            }
+          },
+          "static": true
+        },
+        {
+          "docs": {
+            "stability": "experimental"
+          },
+          "locationInModule": {
+            "filename": "src/providers/image-builders/linux-components.ts",
+            "line": 72
+          },
+          "name": "githubCli",
+          "parameters": [
+            {
+              "name": "scope",
+              "type": {
+                "fqn": "constructs.Construct"
+              }
+            },
+            {
+              "name": "id",
+              "type": {
+                "primitive": "string"
+              }
+            },
+            {
+              "name": "_architecture",
+              "type": {
+                "fqn": "@cloudsnorkel/cdk-github-runners.Architecture"
+              }
+            }
+          ],
+          "returns": {
+            "type": {
+              "fqn": "@cloudsnorkel/cdk-github-runners.ImageBuilderComponent"
+            }
+          },
+          "static": true
+        },
+        {
+          "docs": {
+            "stability": "experimental"
+          },
+          "locationInModule": {
+            "filename": "src/providers/image-builders/linux-components.ts",
+            "line": 102
+          },
+          "name": "githubRunner",
+          "parameters": [
+            {
+              "name": "scope",
+              "type": {
+                "fqn": "constructs.Construct"
+              }
+            },
+            {
+              "name": "id",
+              "type": {
+                "primitive": "string"
+              }
+            },
+            {
+              "name": "runnerVersion",
+              "type": {
+                "fqn": "@cloudsnorkel/cdk-github-runners.RunnerVersion"
+              }
+            },
+            {
+              "name": "architecture",
+              "type": {
+                "fqn": "@cloudsnorkel/cdk-github-runners.Architecture"
+              }
+            }
+          ],
+          "returns": {
+            "type": {
+              "fqn": "@cloudsnorkel/cdk-github-runners.ImageBuilderComponent"
+            }
+          },
+          "static": true
+        },
+        {
+          "docs": {
+            "stability": "experimental"
+          },
+          "locationInModule": {
+            "filename": "src/providers/image-builders/linux-components.ts",
+            "line": 9
+          },
+          "name": "requiredPackages",
+          "parameters": [
+            {
+              "name": "scope",
+              "type": {
+                "fqn": "constructs.Construct"
+              }
+            },
+            {
+              "name": "id",
+              "type": {
+                "primitive": "string"
+              }
+            },
+            {
+              "name": "architecture",
+              "type": {
+                "fqn": "@cloudsnorkel/cdk-github-runners.Architecture"
+              }
+            }
+          ],
+          "returns": {
+            "type": {
+              "fqn": "@cloudsnorkel/cdk-github-runners.ImageBuilderComponent"
+            }
+          },
+          "static": true
+        },
+        {
+          "docs": {
+            "stability": "experimental"
+          },
+          "locationInModule": {
+            "filename": "src/providers/image-builders/linux-components.ts",
+            "line": 35
+          },
+          "name": "runnerUser",
+          "parameters": [
+            {
+              "name": "scope",
+              "type": {
+                "fqn": "constructs.Construct"
+              }
+            },
+            {
+              "name": "id",
+              "type": {
+                "primitive": "string"
+              }
+            },
+            {
+              "name": "_architecture",
+              "type": {
+                "fqn": "@cloudsnorkel/cdk-github-runners.Architecture"
+              }
+            }
+          ],
+          "returns": {
+            "type": {
+              "fqn": "@cloudsnorkel/cdk-github-runners.ImageBuilderComponent"
+            }
+          },
+          "static": true
+        }
+      ],
+      "name": "LinuxUbuntuComponents",
+      "symbolId": "src/providers/image-builders/linux-components:LinuxUbuntuComponents"
+    },
     "@cloudsnorkel/cdk-github-runners.Os": {
       "assembly": "@cloudsnorkel/cdk-github-runners",
       "docs": {
@@ -6484,27 +7373,59 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/providers/common.ts",
-        "line": 64
+        "line": 102
       },
       "methods": [
         {
           "docs": {
             "stability": "experimental",
-            "summary": "Checks if the given OS is the same as this one."
+            "summary": "Checks if the given OS is the same as this one."
+          },
+          "locationInModule": {
+            "filename": "src/providers/common.ts",
+            "line": 125
+          },
+          "name": "is",
+          "parameters": [
+            {
+              "docs": {
+                "summary": "OS to compare."
+              },
+              "name": "os",
+              "type": {
+                "fqn": "@cloudsnorkel/cdk-github-runners.Os"
+              }
+            }
+          ],
+          "returns": {
+            "type": {
+              "primitive": "boolean"
+            }
+          }
+        },
+        {
+          "docs": {
+            "stability": "experimental",
+            "summary": "Checks if this OS is in a given list."
           },
           "locationInModule": {
             "filename": "src/providers/common.ts",
-            "line": 87
+            "line": 134
           },
-          "name": "is",
+          "name": "isIn",
           "parameters": [
             {
               "docs": {
-                "summary": "OS to compare."
+                "summary": "list of OS to check."
               },
-              "name": "os",
+              "name": "oses",
               "type": {
-                "fqn": "@cloudsnorkel/cdk-github-runners.Os"
+                "collection": {
+                  "elementtype": {
+                    "fqn": "@cloudsnorkel/cdk-github-runners.Os"
+                  },
+                  "kind": "array"
+                }
               }
             }
           ],
@@ -6526,7 +7447,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/providers/common.ts",
-            "line": 68
+            "line": 106
           },
           "name": "LINUX",
           "static": true,
@@ -6543,7 +7464,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/providers/common.ts",
-            "line": 73
+            "line": 111
           },
           "name": "WINDOWS",
           "static": true,
@@ -6558,7 +7479,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/providers/common.ts",
-            "line": 79
+            "line": 117
           },
           "name": "name",
           "type": {
@@ -6572,13 +7493,14 @@
       "assembly": "@cloudsnorkel/cdk-github-runners",
       "datatype": true,
       "docs": {
-        "stability": "experimental"
+        "stability": "experimental",
+        "summary": "Description of a Docker image built by {@link IImageBuilder}."
       },
       "fqn": "@cloudsnorkel/cdk-github-runners.RunnerImage",
       "kind": "interface",
       "locationInModule": {
         "filename": "src/providers/common.ts",
-        "line": 92
+        "line": 147
       },
       "name": "RunnerImage",
       "properties": [
@@ -6591,7 +7513,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/providers/common.ts",
-            "line": 106
+            "line": 161
           },
           "name": "architecture",
           "type": {
@@ -6607,7 +7529,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/providers/common.ts",
-            "line": 96
+            "line": 151
           },
           "name": "imageRepository",
           "type": {
@@ -6623,7 +7545,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/providers/common.ts",
-            "line": 101
+            "line": 156
           },
           "name": "imageTag",
           "type": {
@@ -6639,13 +7561,29 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/providers/common.ts",
-            "line": 111
+            "line": 166
           },
           "name": "os",
           "type": {
             "fqn": "@cloudsnorkel/cdk-github-runners.Os"
           }
         },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "Installed runner version."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/providers/common.ts",
+            "line": 176
+          },
+          "name": "runnerVersion",
+          "type": {
+            "fqn": "@cloudsnorkel/cdk-github-runners.RunnerVersion"
+          }
+        },
         {
           "abstract": true,
           "docs": {
@@ -6655,7 +7593,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/providers/common.ts",
-            "line": 116
+            "line": 171
           },
           "name": "logGroup",
           "optional": true,
@@ -6677,7 +7615,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/providers/common.ts",
-        "line": 142
+        "line": 250
       },
       "name": "RunnerProviderProps",
       "properties": [
@@ -6692,7 +7630,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/providers/common.ts",
-            "line": 150
+            "line": 258
           },
           "name": "logRetention",
           "optional": true,
@@ -6715,7 +7653,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/providers/common.ts",
-        "line": 162
+        "line": 270
       },
       "name": "RunnerRuntimeParameters",
       "properties": [
@@ -6729,7 +7667,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/providers/common.ts",
-            "line": 176
+            "line": 284
           },
           "name": "githubDomainPath",
           "type": {
@@ -6745,7 +7683,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/providers/common.ts",
-            "line": 181
+            "line": 289
           },
           "name": "ownerPath",
           "type": {
@@ -6761,7 +7699,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/providers/common.ts",
-            "line": 186
+            "line": 294
           },
           "name": "repoPath",
           "type": {
@@ -6778,7 +7716,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/providers/common.ts",
-            "line": 171
+            "line": 279
           },
           "name": "runnerNamePath",
           "type": {
@@ -6794,7 +7732,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/providers/common.ts",
-            "line": 166
+            "line": 274
           },
           "name": "runnerTokenPath",
           "type": {
@@ -6880,6 +7818,33 @@
             }
           },
           "static": true
+        },
+        {
+          "docs": {
+            "stability": "experimental",
+            "summary": "Check if two versions are the same."
+          },
+          "locationInModule": {
+            "filename": "src/providers/common.ts",
+            "line": 34
+          },
+          "name": "is",
+          "parameters": [
+            {
+              "docs": {
+                "summary": "version to compare."
+              },
+              "name": "other",
+              "type": {
+                "fqn": "@cloudsnorkel/cdk-github-runners.RunnerVersion"
+              }
+            }
+          ],
+          "returns": {
+            "type": {
+              "primitive": "boolean"
+            }
+          }
         }
       ],
       "name": "RunnerVersion",
@@ -7031,7 +7996,7 @@
           },
           "locationInModule": {
             "filename": "src/providers/image-builders/static.ts",
-            "line": 43
+            "line": 44
           },
           "name": "fromDockerHub",
           "parameters": [
@@ -7146,8 +8111,217 @@
       ],
       "name": "StaticRunnerImage",
       "symbolId": "src/providers/image-builders/static:StaticRunnerImage"
+    },
+    "@cloudsnorkel/cdk-github-runners.WindowsComponents": {
+      "assembly": "@cloudsnorkel/cdk-github-runners",
+      "docs": {
+        "remarks": "These cannot be used by {@link CodeBuildImageBuilder}.",
+        "stability": "experimental",
+        "summary": "Components for Windows that can be used with AWS Image Builder based builders."
+      },
+      "fqn": "@cloudsnorkel/cdk-github-runners.WindowsComponents",
+      "initializer": {
+        "docs": {
+          "stability": "experimental"
+        }
+      },
+      "kind": "class",
+      "locationInModule": {
+        "filename": "src/providers/image-builders/windows-components.ts",
+        "line": 8
+      },
+      "methods": [
+        {
+          "docs": {
+            "stability": "experimental"
+          },
+          "locationInModule": {
+            "filename": "src/providers/image-builders/windows-components.ts",
+            "line": 21
+          },
+          "name": "awsCli",
+          "parameters": [
+            {
+              "name": "scope",
+              "type": {
+                "fqn": "constructs.Construct"
+              }
+            },
+            {
+              "name": "id",
+              "type": {
+                "primitive": "string"
+              }
+            }
+          ],
+          "returns": {
+            "type": {
+              "fqn": "@cloudsnorkel/cdk-github-runners.ImageBuilderComponent"
+            }
+          },
+          "static": true
+        },
+        {
+          "docs": {
+            "stability": "experimental"
+          },
+          "locationInModule": {
+            "filename": "src/providers/image-builders/windows-components.ts",
+            "line": 9
+          },
+          "name": "cloudwatchAgent",
+          "parameters": [
+            {
+              "name": "scope",
+              "type": {
+                "fqn": "constructs.Construct"
+              }
+            },
+            {
+              "name": "id",
+              "type": {
+                "primitive": "string"
+              }
+            }
+          ],
+          "returns": {
+            "type": {
+              "fqn": "@cloudsnorkel/cdk-github-runners.ImageBuilderComponent"
+            }
+          },
+          "static": true
+        },
+        {
+          "docs": {
+            "stability": "experimental"
+          },
+          "locationInModule": {
+            "filename": "src/providers/image-builders/windows-components.ts",
+            "line": 98
+          },
+          "name": "docker",
+          "parameters": [
+            {
+              "name": "scope",
+              "type": {
+                "fqn": "constructs.Construct"
+              }
+            },
+            {
+              "name": "id",
+              "type": {
+                "primitive": "string"
+              }
+            }
+          ],
+          "returns": {
+            "type": {
+              "fqn": "@cloudsnorkel/cdk-github-runners.ImageBuilderComponent"
+            }
+          },
+          "static": true
+        },
+        {
+          "docs": {
+            "stability": "experimental"
+          },
+          "locationInModule": {
+            "filename": "src/providers/image-builders/windows-components.ts",
+            "line": 52
+          },
+          "name": "git",
+          "parameters": [
+            {
+              "name": "scope",
+              "type": {
+                "fqn": "constructs.Construct"
+              }
+            },
+            {
+              "name": "id",
+              "type": {
+                "primitive": "string"
+              }
+            }
+          ],
+          "returns": {
+            "type": {
+              "fqn": "@cloudsnorkel/cdk-github-runners.ImageBuilderComponent"
+            }
+          },
+          "static": true
+        },
+        {
+          "docs": {
+            "stability": "experimental"
+          },
+          "locationInModule": {
+            "filename": "src/providers/image-builders/windows-components.ts",
+            "line": 33
+          },
+          "name": "githubCli",
+          "parameters": [
+            {
+              "name": "scope",
+              "type": {
+                "fqn": "constructs.Construct"
+              }
+            },
+            {
+              "name": "id",
+              "type": {
+                "primitive": "string"
+              }
+            }
+          ],
+          "returns": {
+            "type": {
+              "fqn": "@cloudsnorkel/cdk-github-runners.ImageBuilderComponent"
+            }
+          },
+          "static": true
+        },
+        {
+          "docs": {
+            "stability": "experimental"
+          },
+          "locationInModule": {
+            "filename": "src/providers/image-builders/windows-components.ts",
+            "line": 71
+          },
+          "name": "githubRunner",
+          "parameters": [
+            {
+              "name": "scope",
+              "type": {
+                "fqn": "constructs.Construct"
+              }
+            },
+            {
+              "name": "id",
+              "type": {
+                "primitive": "string"
+              }
+            },
+            {
+              "name": "runnerVersion",
+              "type": {
+                "fqn": "@cloudsnorkel/cdk-github-runners.RunnerVersion"
+              }
+            }
+          ],
+          "returns": {
+            "type": {
+              "fqn": "@cloudsnorkel/cdk-github-runners.ImageBuilderComponent"
+            }
+          },
+          "static": true
+        }
+      ],
+      "name": "WindowsComponents",
+      "symbolId": "src/providers/image-builders/windows-components:WindowsComponents"
     }
   },
-  "version": "0.5.7",
-  "fingerprint": "44NDaZbB6QGS9Amryqeegiig6X5hEIrH7yjHrLntVY4="
+  "version": "0.6.0",
+  "fingerprint": "hscwjQdZoW1Xlx10opRG51XHwCVQr0oA3/mq4GIIRJU="
 }