@cloudsnorkel/cdk-github-runners 0.9.3 → 0.9.5

package/.jsii

@@ -3114,7 +3114,7 @@
     "stability": "experimental"
   },
   "homepage": "https://github.com/CloudSnorkel/cdk-github-runners.git",
-  "jsiiVersion": "5.0.2 (build fc559a8)",
+  "jsiiVersion": "5.0.5 (build ba9b985)",
   "keywords": [
     "aws",
     "aws-cdk",
@@ -3138,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|                  | EC2               | CodeBuild                  | Fargate        | ECS            | Lambda        |\n|------------------|-------------------|----------------------------|----------------|----------------|---------------|\n| **Time limit**   | Unlimited         | 8 hours                    | Unlimited      | Unlimited      | 15 minutes    |\n| **vCPUs**        | Unlimited         | 2, 4, 8, or 72             | 0.25 to 4      | Unlimited      | 1 to 6        |\n| **RAM**          | Unlimited         | 3gb, 7gb, 15gb, or 145gb   | 512mb to 30gb  | Unlimited      | 128mb to 10gb |\n| **Storage**      | Unlimited         | 50gb to 824gb              | 20gb to 200gb  | Unlimited      | Up to 10gb    |\n| **Architecture** | x86_64, ARM64     | 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, 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\n* EC2 is useful when you want runners to have complete access to the host\n* ECS is useful when you want to control the infrastructure, like leaving the runner host running for faster startups\n* Lambda is useful for short jobs that can work within time, size and readonly system constraints\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 CodeBuildRunnerProvider(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 = CodeBuildRunnerProvider.imageBuilder(this, 'image builder', {\n   dockerfilePath: FargateRunner.LINUX_X64_DOCKERFILE_PATH,\n   runnerVersion: RunnerVersion.specific('2.291.0'),\n   rebuildInterval: Duration.days(14),\n});\nmyBuilder.addComponent(\n  RunnerImageComponent.custom({ commands: ['apt install -y nginx xz-utils'] })\n);\n\nconst myProvider = new FargateRunnerProvider(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(this, '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 can also be customized the same way.\n\n```typescript\nconst myWindowsBuilder = FargateRunnerProvider.imageBuilder(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(\n  RunnerImageComponent.custom({\n    name: 'Ninja',\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 FargateRunnerProvider(this, 'fargate runner', {\n  label: 'customized-windows-fargate',\n  vpc: vpc,\n  securityGroup: runnerSg,\n  imageBuidler: myWindowsBuilder,\n});\n\nnew GitHubRunners(this, 'runners', {\n  providers: [myProvider],\n});\n```\n\nThe runner OS and architecture is determined by the image it is set to use. For example, to create a Fargate runner provider for ARM64 set the `architecture` property for the image builder to `Architecture.ARM64` in the image builder properties.\n\n```typescript\nnew GitHubRunners(this, 'runners', {\n  providers: [\n    new FargateRunnerProvider(this, 'fargate runner', {\n      labels: ['arm64', 'fargate'],\n      imageBuidler: FargateRunnerProvider.imageBuilder(this, 'image builder', {\n        architecture: Architecture.ARM64,\n        os: Os.LINUX,\n      }),\n    }),\n  ],\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/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/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=apachemaven)][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* You are using GitHub Enterprise Server\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        | ECS            | Lambda        |\n|------------------|-------------------|----------------------------|----------------|----------------|---------------|\n| **Time limit**   | Unlimited         | 8 hours                    | Unlimited      | Unlimited      | 15 minutes    |\n| **vCPUs**        | Unlimited         | 2, 4, 8, or 72             | 0.25 to 4      | Unlimited      | 1 to 6        |\n| **RAM**          | Unlimited         | 3gb, 7gb, 15gb, or 145gb   | 512mb to 30gb  | Unlimited      | 128mb to 10gb |\n| **Storage**      | Unlimited         | 50gb to 824gb              | 20gb to 200gb  | Unlimited      | Up to 10gb    |\n| **Architecture** | x86_64, ARM64     | 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, 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\n* EC2 is useful when you want runners to have complete access to the host\n* ECS is useful when you want to control the infrastructure, like leaving the runner host running for faster startups\n* Lambda is useful for short jobs that can work within time, size and readonly system constraints\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 CodeBuildRunnerProvider(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 = CodeBuildRunnerProvider.imageBuilder(this, 'image builder', {\n   dockerfilePath: FargateRunner.LINUX_X64_DOCKERFILE_PATH,\n   runnerVersion: RunnerVersion.specific('2.291.0'),\n   rebuildInterval: Duration.days(14),\n});\nmyBuilder.addComponent(\n  RunnerImageComponent.custom({ commands: ['apt install -y nginx xz-utils'] })\n);\n\nconst myProvider = new FargateRunnerProvider(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(this, '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 can also be customized the same way.\n\n```typescript\nconst myWindowsBuilder = FargateRunnerProvider.imageBuilder(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(\n  RunnerImageComponent.custom({\n    name: 'Ninja',\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 FargateRunnerProvider(this, 'fargate runner', {\n  label: 'customized-windows-fargate',\n  vpc: vpc,\n  securityGroup: runnerSg,\n  imageBuidler: myWindowsBuilder,\n});\n\nnew GitHubRunners(this, 'runners', {\n  providers: [myProvider],\n});\n```\n\nThe runner OS and architecture is determined by the image it is set to use. For example, to create a Fargate runner provider for ARM64 set the `architecture` property for the image builder to `Architecture.ARM64` in the image builder properties.\n\n```typescript\nnew GitHubRunners(this, 'runners', {\n  providers: [\n    new FargateRunnerProvider(this, 'fargate runner', {\n      labels: ['arm64', 'fargate'],\n      imageBuidler: FargateRunnerProvider.imageBuilder(this, 'image builder', {\n        architecture: Architecture.ARM64,\n        os: Os.LINUX,\n      }),\n    }),\n  ],\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 jobs get stuck often and take a long time to start, cancel the pending jobs and start them 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## Monitoring\n\nThere are two important ways to monitor your runners:\n\n1. Make sure runners don't fail to start. When that happens, jobs may sit and wait. Use `GitHubRunners.metricFailed()` to get a metric for the number of failed runner starts. You should use this metric to trigger an alarm.\n2. Make sure runner images don't fail to build. Failed runner image builds mean you will get stuck with out-of-date software on your runners. It may lead to security vulnerabilities, or it may lead to slower runner start-ups as the runner software itself needs to be updated. Use `GitHubRunners.failedImageBuildsTopic()` to get SNS topic that gets notified of failed runner image builds. You should subscribe to this topic.\n\nOther useful metrics to track:\n\n1. Use `GitHubRunners.metricJobCompleted()` to get a metric for the number of completed jobs broken down by labels and job success.\n2. Use `GitHubRunners.metricTime()` to get a metric for the total time a runner is running. This includes the overhead of starting the runner.\n\n## Other Options\n\n1. [philips-labs/terraform-aws-github-runner][3] if you're using Terraform\n2. [actions/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/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",
@@ -3174,7 +3174,7 @@
       "base": "constructs.Construct",
       "docs": {
         "deprecated": "use RunnerImageBuilder",
-        "remarks": "Builders can be used with {@link Ec2Runner }.\n\nEach builder re-runs automatically at a set interval to make sure the AMIs contain the latest versions of everything.\n\nYou can create an instance of this construct to customize the AMI used to spin-up runners. Some runner providers may require custom components. Check the runner provider documentation.\n\nFor example, to set a specific runner version, rebuild the image every 2 weeks, and add a few packages for the EC2 provider, use:\n\n```\nconst builder = new AmiBuilder(this, 'Builder', {\n    runnerVersion: RunnerVersion.specific('2.293.0'),\n    rebuildInterval: Duration.days(14),\n});\nbuilder.addComponent(new ImageBuilderComponent(scope, id, {\n  platform: 'Linux',\n  displayName: 'p7zip',\n  description: 'Install some more packages',\n  commands: [\n    'set -ex',\n    'apt-get install p7zip',\n  ],\n}));\nnew Ec2Runner(this, 'EC2 provider', {\n    label: 'custom-ec2',\n    amiBuilder: builder,\n});\n```",
+        "remarks": "Builders can be used with {@link Ec2Runner }.\n\nEach builder re-runs automatically at a set interval to make sure the AMIs contain the latest versions of everything.\n\nYou can create an instance of this construct to customize the AMI used to spin-up runners. Some runner providers may require custom components. Check the runner provider documentation.\n\nFor example, to set a specific runner version, rebuild the image every 2 weeks, and add a few packages for the EC2 provider, use:\n\n```\nconst builder = new AmiBuilder(this, 'Builder', {\n    runnerVersion: RunnerVersion.specific('2.293.0'),\n    rebuildInterval: Duration.days(14),\n});\nbuilder.addComponent(new ImageBuilderComponent(scope, id, {\n  platform: 'Linux',\n  displayName: 'p7zip',\n  description: 'Install some more packages',\n  commands: [\n    'apt-get install p7zip',\n  ],\n}));\nnew Ec2Runner(this, 'EC2 provider', {\n    label: 'custom-ec2',\n    amiBuilder: builder,\n});\n```",
         "stability": "deprecated",
         "summary": "An AMI builder that uses AWS Image Builder to build AMIs pre-baked with all the GitHub Actions runner requirements."
       },
@@ -3184,8 +3184,8 @@
           "stability": "deprecated"
         },
         "locationInModule": {
-          "filename": "src/providers/image-builders/aws-image-builder/deprecated/ami.ts",
-          "line": 156
+          "filename": "src/image-builders/aws-image-builder/deprecated/ami.ts",
+          "line": 155
         },
         "parameters": [
           {
@@ -3214,8 +3214,8 @@
       ],
       "kind": "class",
       "locationInModule": {
-        "filename": "src/providers/image-builders/aws-image-builder/deprecated/ami.ts",
-        "line": 153
+        "filename": "src/image-builders/aws-image-builder/deprecated/ami.ts",
+        "line": 152
       },
       "methods": [
         {
@@ -3224,8 +3224,8 @@
             "summary": "Add a component to be installed."
           },
           "locationInModule": {
-            "filename": "src/providers/image-builders/aws-image-builder/deprecated/ami.ts",
-            "line": 224
+            "filename": "src/image-builders/aws-image-builder/deprecated/ami.ts",
+            "line": 223
           },
           "name": "addComponent",
           "parameters": [
@@ -3244,8 +3244,8 @@
             "summary": "Add extra trusted certificates."
           },
           "locationInModule": {
-            "filename": "src/providers/image-builders/aws-image-builder/deprecated/ami.ts",
-            "line": 239
+            "filename": "src/image-builders/aws-image-builder/deprecated/ami.ts",
+            "line": 238
           },
           "name": "addExtraCertificates",
           "parameters": [
@@ -3266,8 +3266,8 @@
             "summary": "Called by IRunnerProvider to finalize settings and create the AMI builder."
           },
           "locationInModule": {
-            "filename": "src/providers/image-builders/aws-image-builder/deprecated/ami.ts",
-            "line": 252
+            "filename": "src/image-builders/aws-image-builder/deprecated/ami.ts",
+            "line": 251
           },
           "name": "bindAmi",
           "overrides": "@cloudsnorkel/cdk-github-runners.IRunnerImageBuilder",
@@ -3284,8 +3284,8 @@
             "summary": "Build and return a Docker image with GitHub Runner installed in it."
           },
           "locationInModule": {
-            "filename": "src/providers/image-builders/aws-image-builder/deprecated/ami.ts",
-            "line": 355
+            "filename": "src/image-builders/aws-image-builder/deprecated/ami.ts",
+            "line": 356
           },
           "name": "bindDockerImage",
           "overrides": "@cloudsnorkel/cdk-github-runners.IRunnerImageBuilder",
@@ -3300,8 +3300,8 @@
             "stability": "deprecated"
           },
           "locationInModule": {
-            "filename": "src/providers/image-builders/aws-image-builder/deprecated/common.ts",
-            "line": 121
+            "filename": "src/image-builders/aws-image-builder/deprecated/common.ts",
+            "line": 126
           },
           "name": "createImage",
           "parameters": [
@@ -3350,7 +3350,7 @@
             "stability": "deprecated"
           },
           "locationInModule": {
-            "filename": "src/providers/image-builders/aws-image-builder/deprecated/common.ts",
+            "filename": "src/image-builders/aws-image-builder/deprecated/common.ts",
             "line": 97
           },
           "name": "createInfrastructure",
@@ -3379,7 +3379,7 @@
             "stability": "deprecated"
           },
           "locationInModule": {
-            "filename": "src/providers/image-builders/aws-image-builder/deprecated/common.ts",
+            "filename": "src/image-builders/aws-image-builder/deprecated/common.ts",
             "line": 89
           },
           "name": "createLog",
@@ -3403,8 +3403,8 @@
             "stability": "deprecated"
           },
           "locationInModule": {
-            "filename": "src/providers/image-builders/aws-image-builder/deprecated/common.ts",
-            "line": 138
+            "filename": "src/image-builders/aws-image-builder/deprecated/common.ts",
+            "line": 143
           },
           "name": "createPipeline",
           "parameters": [
@@ -3455,8 +3455,8 @@
             "summary": "Add a component to be installed before any other components."
           },
           "locationInModule": {
-            "filename": "src/providers/image-builders/aws-image-builder/deprecated/ami.ts",
-            "line": 210
+            "filename": "src/image-builders/aws-image-builder/deprecated/ami.ts",
+            "line": 209
           },
           "name": "prependComponent",
           "parameters": [
@@ -3477,7 +3477,7 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/aws-image-builder/deprecated/common.ts",
+            "filename": "src/image-builders/aws-image-builder/deprecated/common.ts",
             "line": 12
           },
           "name": "architecture",
@@ -3493,8 +3493,8 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/aws-image-builder/deprecated/common.ts",
-            "line": 168
+            "filename": "src/image-builders/aws-image-builder/deprecated/common.ts",
+            "line": 173
           },
           "name": "connections",
           "type": {
@@ -3507,7 +3507,7 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/aws-image-builder/deprecated/common.ts",
+            "filename": "src/image-builders/aws-image-builder/deprecated/common.ts",
             "line": 16
           },
           "name": "description",
@@ -3522,7 +3522,7 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/aws-image-builder/deprecated/common.ts",
+            "filename": "src/image-builders/aws-image-builder/deprecated/common.ts",
             "line": 13
           },
           "name": "os",
@@ -3537,7 +3537,7 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/aws-image-builder/deprecated/common.ts",
+            "filename": "src/image-builders/aws-image-builder/deprecated/common.ts",
             "line": 14
           },
           "name": "platform",
@@ -3552,7 +3552,7 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/aws-image-builder/deprecated/common.ts",
+            "filename": "src/image-builders/aws-image-builder/deprecated/common.ts",
             "line": 18
           },
           "name": "runnerVersion",
@@ -3566,7 +3566,7 @@
             "stability": "deprecated"
           },
           "locationInModule": {
-            "filename": "src/providers/image-builders/aws-image-builder/deprecated/common.ts",
+            "filename": "src/image-builders/aws-image-builder/deprecated/common.ts",
             "line": 20
           },
           "name": "components",
@@ -3581,7 +3581,7 @@
           }
         }
       ],
-      "symbolId": "src/providers/image-builders/aws-image-builder/deprecated/ami:AmiBuilder"
+      "symbolId": "src/image-builders/aws-image-builder/deprecated/ami:AmiBuilder"
     },
     "@cloudsnorkel/cdk-github-runners.AmiBuilderProps": {
       "assembly": "@cloudsnorkel/cdk-github-runners",
@@ -3593,7 +3593,7 @@
       "fqn": "@cloudsnorkel/cdk-github-runners.AmiBuilderProps",
       "kind": "interface",
       "locationInModule": {
-        "filename": "src/providers/image-builders/aws-image-builder/deprecated/ami.ts",
+        "filename": "src/image-builders/aws-image-builder/deprecated/ami.ts",
         "line": 28
       },
       "name": "AmiBuilderProps",
@@ -3607,7 +3607,7 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/aws-image-builder/deprecated/ami.ts",
+            "filename": "src/image-builders/aws-image-builder/deprecated/ami.ts",
             "line": 34
           },
           "name": "architecture",
@@ -3620,13 +3620,12 @@
           "abstract": true,
           "docs": {
             "default": "true",
-            "remarks": "You may want to disable this if you are building a Windows image and don't have a Docker Desktop license.",
             "stability": "experimental",
             "summary": "Install Docker inside the image, so it can be used by the runner."
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/aws-image-builder/deprecated/ami.ts",
+            "filename": "src/image-builders/aws-image-builder/deprecated/ami.ts",
             "line": 119
           },
           "name": "installDocker",
@@ -3644,7 +3643,7 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/aws-image-builder/deprecated/ami.ts",
+            "filename": "src/image-builders/aws-image-builder/deprecated/ami.ts",
             "line": 94
           },
           "name": "instanceType",
@@ -3663,7 +3662,7 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/aws-image-builder/deprecated/ami.ts",
+            "filename": "src/image-builders/aws-image-builder/deprecated/ami.ts",
             "line": 112
           },
           "name": "logRemovalPolicy",
@@ -3682,7 +3681,7 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/aws-image-builder/deprecated/ami.ts",
+            "filename": "src/image-builders/aws-image-builder/deprecated/ami.ts",
             "line": 103
           },
           "name": "logRetention",
@@ -3700,7 +3699,7 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/aws-image-builder/deprecated/ami.ts",
+            "filename": "src/image-builders/aws-image-builder/deprecated/ami.ts",
             "line": 41
           },
           "name": "os",
@@ -3719,7 +3718,7 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/aws-image-builder/deprecated/ami.ts",
+            "filename": "src/image-builders/aws-image-builder/deprecated/ami.ts",
             "line": 57
           },
           "name": "rebuildInterval",
@@ -3737,7 +3736,7 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/aws-image-builder/deprecated/ami.ts",
+            "filename": "src/image-builders/aws-image-builder/deprecated/ami.ts",
             "line": 48
           },
           "name": "runnerVersion",
@@ -3756,7 +3755,7 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/aws-image-builder/deprecated/ami.ts",
+            "filename": "src/image-builders/aws-image-builder/deprecated/ami.ts",
             "line": 73
           },
           "name": "securityGroup",
@@ -3774,7 +3773,7 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/aws-image-builder/deprecated/ami.ts",
+            "filename": "src/image-builders/aws-image-builder/deprecated/ami.ts",
             "line": 80
           },
           "name": "securityGroups",
@@ -3798,7 +3797,7 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/aws-image-builder/deprecated/ami.ts",
+            "filename": "src/image-builders/aws-image-builder/deprecated/ami.ts",
             "line": 87
           },
           "name": "subnetSelection",
@@ -3816,7 +3815,7 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/aws-image-builder/deprecated/ami.ts",
+            "filename": "src/image-builders/aws-image-builder/deprecated/ami.ts",
             "line": 64
           },
           "name": "vpc",
@@ -3826,7 +3825,7 @@
           }
         }
       ],
-      "symbolId": "src/providers/image-builders/aws-image-builder/deprecated/ami:AmiBuilderProps"
+      "symbolId": "src/image-builders/aws-image-builder/deprecated/ami:AmiBuilderProps"
     },
     "@cloudsnorkel/cdk-github-runners.ApiGatewayAccessProps": {
       "assembly": "@cloudsnorkel/cdk-github-runners",
@@ -4070,8 +4069,8 @@
       "fqn": "@cloudsnorkel/cdk-github-runners.AwsImageBuilderRunnerImageBuilderProps",
       "kind": "interface",
       "locationInModule": {
-        "filename": "src/providers/image-builders/aws-image-builder/builder.ts",
-        "line": 29
+        "filename": "src/image-builders/aws-image-builder/builder.ts",
+        "line": 32
       },
       "name": "AwsImageBuilderRunnerImageBuilderProps",
       "properties": [
@@ -4084,8 +4083,8 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/aws-image-builder/builder.ts",
-            "line": 35
+            "filename": "src/image-builders/aws-image-builder/builder.ts",
+            "line": 38
           },
           "name": "instanceType",
           "optional": true,
@@ -4094,7 +4093,7 @@
           }
         }
       ],
-      "symbolId": "src/providers/image-builders/aws-image-builder/builder:AwsImageBuilderRunnerImageBuilderProps"
+      "symbolId": "src/image-builders/aws-image-builder/builder:AwsImageBuilderRunnerImageBuilderProps"
     },
     "@cloudsnorkel/cdk-github-runners.CodeBuildImageBuilder": {
       "assembly": "@cloudsnorkel/cdk-github-runners",
@@ -4111,7 +4110,7 @@
           "stability": "deprecated"
         },
         "locationInModule": {
-          "filename": "src/providers/image-builders/codebuild-deprecated.ts",
+          "filename": "src/image-builders/codebuild-deprecated.ts",
           "line": 181
         },
         "parameters": [
@@ -4140,7 +4139,7 @@
       ],
       "kind": "class",
       "locationInModule": {
-        "filename": "src/providers/image-builders/codebuild-deprecated.ts",
+        "filename": "src/image-builders/codebuild-deprecated.ts",
         "line": 162
       },
       "methods": [
@@ -4151,7 +4150,7 @@
             "summary": "Add extra trusted certificates. This helps deal with self-signed certificates for GitHub Enterprise Server."
           },
           "locationInModule": {
-            "filename": "src/providers/image-builders/codebuild-deprecated.ts",
+            "filename": "src/image-builders/codebuild-deprecated.ts",
             "line": 288
           },
           "name": "addExtraCertificates",
@@ -4173,7 +4172,7 @@
             "summary": "Uploads a folder to the build server at a given folder name."
           },
           "locationInModule": {
-            "filename": "src/providers/image-builders/codebuild-deprecated.ts",
+            "filename": "src/image-builders/codebuild-deprecated.ts",
             "line": 222
           },
           "name": "addFiles",
@@ -4204,7 +4203,7 @@
             "summary": "Add a policy statement to the builder to access resources required to the image build."
           },
           "locationInModule": {
-            "filename": "src/providers/image-builders/codebuild-deprecated.ts",
+            "filename": "src/image-builders/codebuild-deprecated.ts",
             "line": 274
           },
           "name": "addPolicyStatement",
@@ -4226,7 +4225,7 @@
             "summary": "Adds a command that runs after `docker build` and `docker push`."
           },
           "locationInModule": {
-            "filename": "src/providers/image-builders/codebuild-deprecated.ts",
+            "filename": "src/image-builders/codebuild-deprecated.ts",
             "line": 249
           },
           "name": "addPostBuildCommand",
@@ -4248,7 +4247,7 @@
             "summary": "Adds a command that runs before `docker build`."
           },
           "locationInModule": {
-            "filename": "src/providers/image-builders/codebuild-deprecated.ts",
+            "filename": "src/image-builders/codebuild-deprecated.ts",
             "line": 237
           },
           "name": "addPreBuildCommand",
@@ -4271,7 +4270,7 @@
             "summary": "Build and return an AMI with GitHub Runner installed in it."
           },
           "locationInModule": {
-            "filename": "src/providers/image-builders/codebuild-deprecated.ts",
+            "filename": "src/image-builders/codebuild-deprecated.ts",
             "line": 533
           },
           "name": "bindAmi",
@@ -4288,7 +4287,7 @@
             "summary": "Called by IRunnerProvider to finalize settings and create the image builder."
           },
           "locationInModule": {
-            "filename": "src/providers/image-builders/codebuild-deprecated.ts",
+            "filename": "src/image-builders/codebuild-deprecated.ts",
             "line": 298
           },
           "name": "bindDockerImage",
@@ -4306,7 +4305,7 @@
             "summary": "Adds a build argument for Docker."
           },
           "locationInModule": {
-            "filename": "src/providers/image-builders/codebuild-deprecated.ts",
+            "filename": "src/image-builders/codebuild-deprecated.ts",
             "line": 262
           },
           "name": "setBuildArg",
@@ -4340,7 +4339,7 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/codebuild-deprecated.ts",
+            "filename": "src/image-builders/codebuild-deprecated.ts",
             "line": 527
           },
           "name": "connections",
@@ -4354,7 +4353,7 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/codebuild-deprecated.ts",
+            "filename": "src/image-builders/codebuild-deprecated.ts",
             "line": 181
           },
           "name": "props",
@@ -4363,7 +4362,7 @@
           }
         }
       ],
-      "symbolId": "src/providers/image-builders/codebuild-deprecated:CodeBuildImageBuilder"
+      "symbolId": "src/image-builders/codebuild-deprecated:CodeBuildImageBuilder"
     },
     "@cloudsnorkel/cdk-github-runners.CodeBuildImageBuilderProps": {
       "assembly": "@cloudsnorkel/cdk-github-runners",
@@ -4375,7 +4374,7 @@
       "fqn": "@cloudsnorkel/cdk-github-runners.CodeBuildImageBuilderProps",
       "kind": "interface",
       "locationInModule": {
-        "filename": "src/providers/image-builders/codebuild-deprecated.ts",
+        "filename": "src/image-builders/codebuild-deprecated.ts",
         "line": 36
       },
       "name": "CodeBuildImageBuilderProps",
@@ -4389,7 +4388,7 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/codebuild-deprecated.ts",
+            "filename": "src/image-builders/codebuild-deprecated.ts",
             "line": 54
           },
           "name": "dockerfilePath",
@@ -4406,7 +4405,7 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/codebuild-deprecated.ts",
+            "filename": "src/image-builders/codebuild-deprecated.ts",
             "line": 42
           },
           "name": "architecture",
@@ -4418,14 +4417,14 @@
         {
           "abstract": true,
           "docs": {
-            "default": "Ubuntu 20.04 for x64 and Amazon Linux 2 for ARM64",
+            "default": "Ubuntu 22.04 for x64 and Amazon Linux 2 for ARM64",
             "remarks": "This is the image that's going to run the code that builds the runner image.\n\nThe only action taken in CodeBuild is running `docker build`. You would therefore not need to change this setting often.",
             "stability": "experimental",
             "summary": "Build image to use in CodeBuild."
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/codebuild-deprecated.ts",
+            "filename": "src/image-builders/codebuild-deprecated.ts",
             "line": 108
           },
           "name": "buildImage",
@@ -4444,7 +4443,7 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/codebuild-deprecated.ts",
+            "filename": "src/image-builders/codebuild-deprecated.ts",
             "line": 99
           },
           "name": "computeType",
@@ -4463,7 +4462,7 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/codebuild-deprecated.ts",
+            "filename": "src/image-builders/codebuild-deprecated.ts",
             "line": 135
           },
           "name": "logRemovalPolicy",
@@ -4482,7 +4481,7 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/codebuild-deprecated.ts",
+            "filename": "src/image-builders/codebuild-deprecated.ts",
             "line": 126
           },
           "name": "logRetention",
@@ -4500,7 +4499,7 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/codebuild-deprecated.ts",
+            "filename": "src/image-builders/codebuild-deprecated.ts",
             "line": 49
           },
           "name": "os",
@@ -4519,7 +4518,7 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/codebuild-deprecated.ts",
+            "filename": "src/image-builders/codebuild-deprecated.ts",
             "line": 70
           },
           "name": "rebuildInterval",
@@ -4537,7 +4536,7 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/codebuild-deprecated.ts",
+            "filename": "src/image-builders/codebuild-deprecated.ts",
             "line": 61
           },
           "name": "runnerVersion",
@@ -4555,7 +4554,7 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/codebuild-deprecated.ts",
+            "filename": "src/image-builders/codebuild-deprecated.ts",
             "line": 84
           },
           "name": "securityGroup",
@@ -4573,7 +4572,7 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/codebuild-deprecated.ts",
+            "filename": "src/image-builders/codebuild-deprecated.ts",
             "line": 91
           },
           "name": "subnetSelection",
@@ -4592,7 +4591,7 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/codebuild-deprecated.ts",
+            "filename": "src/image-builders/codebuild-deprecated.ts",
             "line": 117
           },
           "name": "timeout",
@@ -4610,7 +4609,7 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/codebuild-deprecated.ts",
+            "filename": "src/image-builders/codebuild-deprecated.ts",
             "line": 77
           },
           "name": "vpc",
@@ -4620,7 +4619,7 @@
           }
         }
       ],
-      "symbolId": "src/providers/image-builders/codebuild-deprecated:CodeBuildImageBuilderProps"
+      "symbolId": "src/image-builders/codebuild-deprecated:CodeBuildImageBuilderProps"
     },
     "@cloudsnorkel/cdk-github-runners.CodeBuildRunner": {
       "assembly": "@cloudsnorkel/cdk-github-runners",
@@ -4677,23 +4676,23 @@
       "fqn": "@cloudsnorkel/cdk-github-runners.CodeBuildRunnerImageBuilderProps",
       "kind": "interface",
       "locationInModule": {
-        "filename": "src/providers/image-builders/codebuild.ts",
-        "line": 27
+        "filename": "src/image-builders/codebuild.ts",
+        "line": 28
       },
       "name": "CodeBuildRunnerImageBuilderProps",
       "properties": [
         {
           "abstract": true,
           "docs": {
-            "default": "Ubuntu 20.04 for x64 and Amazon Linux 2 for ARM64",
+            "default": "Ubuntu 22.04 for x64 and Amazon Linux 2 for ARM64",
             "remarks": "This is the image that's going to run the code that builds the runner image.\n\nThe only action taken in CodeBuild is running `docker build`. You would therefore not need to change this setting often.",
             "stability": "experimental",
             "summary": "Build image to use in CodeBuild."
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/codebuild.ts",
-            "line": 43
+            "filename": "src/image-builders/codebuild.ts",
+            "line": 44
           },
           "name": "buildImage",
           "optional": true,
@@ -4711,8 +4710,8 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/codebuild.ts",
-            "line": 34
+            "filename": "src/image-builders/codebuild.ts",
+            "line": 35
           },
           "name": "computeType",
           "optional": true,
@@ -4730,8 +4729,8 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/codebuild.ts",
-            "line": 52
+            "filename": "src/image-builders/codebuild.ts",
+            "line": 53
           },
           "name": "timeout",
           "optional": true,
@@ -4740,7 +4739,7 @@
           }
         }
       ],
-      "symbolId": "src/providers/image-builders/codebuild:CodeBuildRunnerImageBuilderProps"
+      "symbolId": "src/image-builders/codebuild:CodeBuildRunnerImageBuilderProps"
     },
     "@cloudsnorkel/cdk-github-runners.CodeBuildRunnerProvider": {
       "assembly": "@cloudsnorkel/cdk-github-runners",
@@ -5369,7 +5368,7 @@
           "stability": "deprecated"
         },
         "locationInModule": {
-          "filename": "src/providers/image-builders/aws-image-builder/deprecated/container.ts",
+          "filename": "src/image-builders/aws-image-builder/deprecated/container.ts",
           "line": 156
         },
         "parameters": [
@@ -5399,7 +5398,7 @@
       ],
       "kind": "class",
       "locationInModule": {
-        "filename": "src/providers/image-builders/aws-image-builder/deprecated/container.ts",
+        "filename": "src/image-builders/aws-image-builder/deprecated/container.ts",
         "line": 151
       },
       "methods": [
@@ -5409,7 +5408,7 @@
             "summary": "Add a component to be installed."
           },
           "locationInModule": {
-            "filename": "src/providers/image-builders/aws-image-builder/deprecated/container.ts",
+            "filename": "src/image-builders/aws-image-builder/deprecated/container.ts",
             "line": 218
           },
           "name": "addComponent",
@@ -5429,7 +5428,7 @@
             "summary": "Add extra trusted certificates. This helps deal with self-signed certificates for GitHub Enterprise Server."
           },
           "locationInModule": {
-            "filename": "src/providers/image-builders/aws-image-builder/deprecated/container.ts",
+            "filename": "src/image-builders/aws-image-builder/deprecated/container.ts",
             "line": 235
           },
           "name": "addExtraCertificates",
@@ -5452,7 +5451,7 @@
             "summary": "Build and return an AMI with GitHub Runner installed in it."
           },
           "locationInModule": {
-            "filename": "src/providers/image-builders/aws-image-builder/deprecated/container.ts",
+            "filename": "src/image-builders/aws-image-builder/deprecated/container.ts",
             "line": 345
           },
           "name": "bindAmi",
@@ -5469,7 +5468,7 @@
             "summary": "Called by IRunnerProvider to finalize settings and create the image builder."
           },
           "locationInModule": {
-            "filename": "src/providers/image-builders/aws-image-builder/deprecated/container.ts",
+            "filename": "src/image-builders/aws-image-builder/deprecated/container.ts",
             "line": 248
           },
           "name": "bindDockerImage",
@@ -5485,8 +5484,8 @@
             "stability": "deprecated"
           },
           "locationInModule": {
-            "filename": "src/providers/image-builders/aws-image-builder/deprecated/common.ts",
-            "line": 121
+            "filename": "src/image-builders/aws-image-builder/deprecated/common.ts",
+            "line": 126
           },
           "name": "createImage",
           "parameters": [
@@ -5535,7 +5534,7 @@
             "stability": "deprecated"
           },
           "locationInModule": {
-            "filename": "src/providers/image-builders/aws-image-builder/deprecated/common.ts",
+            "filename": "src/image-builders/aws-image-builder/deprecated/common.ts",
             "line": 97
           },
           "name": "createInfrastructure",
@@ -5564,7 +5563,7 @@
             "stability": "deprecated"
           },
           "locationInModule": {
-            "filename": "src/providers/image-builders/aws-image-builder/deprecated/common.ts",
+            "filename": "src/image-builders/aws-image-builder/deprecated/common.ts",
             "line": 89
           },
           "name": "createLog",
@@ -5588,8 +5587,8 @@
             "stability": "deprecated"
           },
           "locationInModule": {
-            "filename": "src/providers/image-builders/aws-image-builder/deprecated/common.ts",
-            "line": 138
+            "filename": "src/image-builders/aws-image-builder/deprecated/common.ts",
+            "line": 143
           },
           "name": "createPipeline",
           "parameters": [
@@ -5640,7 +5639,7 @@
             "summary": "Add a component to be installed before any other components."
           },
           "locationInModule": {
-            "filename": "src/providers/image-builders/aws-image-builder/deprecated/container.ts",
+            "filename": "src/image-builders/aws-image-builder/deprecated/container.ts",
             "line": 204
           },
           "name": "prependComponent",
@@ -5662,7 +5661,7 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/aws-image-builder/deprecated/common.ts",
+            "filename": "src/image-builders/aws-image-builder/deprecated/common.ts",
             "line": 12
           },
           "name": "architecture",
@@ -5678,8 +5677,8 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/aws-image-builder/deprecated/common.ts",
-            "line": 168
+            "filename": "src/image-builders/aws-image-builder/deprecated/common.ts",
+            "line": 173
           },
           "name": "connections",
           "type": {
@@ -5692,7 +5691,7 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/aws-image-builder/deprecated/common.ts",
+            "filename": "src/image-builders/aws-image-builder/deprecated/common.ts",
             "line": 16
           },
           "name": "description",
@@ -5707,7 +5706,7 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/aws-image-builder/deprecated/common.ts",
+            "filename": "src/image-builders/aws-image-builder/deprecated/common.ts",
             "line": 13
           },
           "name": "os",
@@ -5722,7 +5721,7 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/aws-image-builder/deprecated/common.ts",
+            "filename": "src/image-builders/aws-image-builder/deprecated/common.ts",
             "line": 14
           },
           "name": "platform",
@@ -5737,7 +5736,7 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/aws-image-builder/deprecated/container.ts",
+            "filename": "src/image-builders/aws-image-builder/deprecated/container.ts",
             "line": 152
           },
           "name": "repository",
@@ -5751,7 +5750,7 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/aws-image-builder/deprecated/common.ts",
+            "filename": "src/image-builders/aws-image-builder/deprecated/common.ts",
             "line": 18
           },
           "name": "runnerVersion",
@@ -5765,7 +5764,7 @@
             "stability": "deprecated"
           },
           "locationInModule": {
-            "filename": "src/providers/image-builders/aws-image-builder/deprecated/common.ts",
+            "filename": "src/image-builders/aws-image-builder/deprecated/common.ts",
             "line": 20
           },
           "name": "components",
@@ -5780,7 +5779,7 @@
           }
         }
       ],
-      "symbolId": "src/providers/image-builders/aws-image-builder/deprecated/container:ContainerImageBuilder"
+      "symbolId": "src/image-builders/aws-image-builder/deprecated/container:ContainerImageBuilder"
     },
     "@cloudsnorkel/cdk-github-runners.ContainerImageBuilderProps": {
       "assembly": "@cloudsnorkel/cdk-github-runners",
@@ -5792,7 +5791,7 @@
       "fqn": "@cloudsnorkel/cdk-github-runners.ContainerImageBuilderProps",
       "kind": "interface",
       "locationInModule": {
-        "filename": "src/providers/image-builders/aws-image-builder/deprecated/container.ts",
+        "filename": "src/image-builders/aws-image-builder/deprecated/container.ts",
         "line": 33
       },
       "name": "ContainerImageBuilderProps",
@@ -5806,7 +5805,7 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/aws-image-builder/deprecated/container.ts",
+            "filename": "src/image-builders/aws-image-builder/deprecated/container.ts",
             "line": 39
           },
           "name": "architecture",
@@ -5824,7 +5823,7 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/aws-image-builder/deprecated/container.ts",
+            "filename": "src/image-builders/aws-image-builder/deprecated/container.ts",
             "line": 106
           },
           "name": "instanceType",
@@ -5843,7 +5842,7 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/aws-image-builder/deprecated/container.ts",
+            "filename": "src/image-builders/aws-image-builder/deprecated/container.ts",
             "line": 124
           },
           "name": "logRemovalPolicy",
@@ -5862,7 +5861,7 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/aws-image-builder/deprecated/container.ts",
+            "filename": "src/image-builders/aws-image-builder/deprecated/container.ts",
             "line": 115
           },
           "name": "logRetention",
@@ -5880,7 +5879,7 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/aws-image-builder/deprecated/container.ts",
+            "filename": "src/image-builders/aws-image-builder/deprecated/container.ts",
             "line": 46
           },
           "name": "os",
@@ -5899,7 +5898,7 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/aws-image-builder/deprecated/container.ts",
+            "filename": "src/image-builders/aws-image-builder/deprecated/container.ts",
             "line": 53
           },
           "name": "parentImage",
@@ -5918,7 +5917,7 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/aws-image-builder/deprecated/container.ts",
+            "filename": "src/image-builders/aws-image-builder/deprecated/container.ts",
             "line": 69
           },
           "name": "rebuildInterval",
@@ -5936,7 +5935,7 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/aws-image-builder/deprecated/container.ts",
+            "filename": "src/image-builders/aws-image-builder/deprecated/container.ts",
             "line": 60
           },
           "name": "runnerVersion",
@@ -5955,7 +5954,7 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/aws-image-builder/deprecated/container.ts",
+            "filename": "src/image-builders/aws-image-builder/deprecated/container.ts",
             "line": 85
           },
           "name": "securityGroup",
@@ -5973,7 +5972,7 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/aws-image-builder/deprecated/container.ts",
+            "filename": "src/image-builders/aws-image-builder/deprecated/container.ts",
             "line": 92
           },
           "name": "securityGroups",
@@ -5996,7 +5995,7 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/aws-image-builder/deprecated/container.ts",
+            "filename": "src/image-builders/aws-image-builder/deprecated/container.ts",
             "line": 99
           },
           "name": "subnetSelection",
@@ -6014,7 +6013,7 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/aws-image-builder/deprecated/container.ts",
+            "filename": "src/image-builders/aws-image-builder/deprecated/container.ts",
             "line": 76
           },
           "name": "vpc",
@@ -6024,7 +6023,7 @@
           }
         }
       ],
-      "symbolId": "src/providers/image-builders/aws-image-builder/deprecated/container:ContainerImageBuilderProps"
+      "symbolId": "src/image-builders/aws-image-builder/deprecated/container:ContainerImageBuilderProps"
     },
     "@cloudsnorkel/cdk-github-runners.Ec2Runner": {
       "assembly": "@cloudsnorkel/cdk-github-runners",
@@ -6785,7 +6784,7 @@
           },
           "locationInModule": {
             "filename": "src/providers/ecs.ts",
-            "line": 449
+            "line": 453
           },
           "name": "getStepFunctionTask",
           "overrides": "@cloudsnorkel/cdk-github-runners.IRunnerProvider",
@@ -6814,7 +6813,7 @@
           },
           "locationInModule": {
             "filename": "src/providers/ecs.ts",
-            "line": 498
+            "line": 502
           },
           "name": "grantStateMachine",
           "overrides": "@cloudsnorkel/cdk-github-runners.IRunnerProvider",
@@ -6883,7 +6882,7 @@
           },
           "locationInModule": {
             "filename": "src/providers/ecs.ts",
-            "line": 501
+            "line": 505
           },
           "name": "status",
           "overrides": "@cloudsnorkel/cdk-github-runners.IRunnerProvider",
@@ -8127,7 +8126,7 @@
         },
         "locationInModule": {
           "filename": "src/runner.ts",
-          "line": 218
+          "line": 223
         },
         "parameters": [
           {
@@ -8154,9 +8153,26 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/runner.ts",
-        "line": 199
+        "line": 204
       },
       "methods": [
+        {
+          "docs": {
+            "remarks": "Runner images are rebuilt every week by default. This provides the latest GitHub Runner version and software updates.\n\nIf you want to be sure you are using the latest runner version, you can use this topic to be notified when a build fails.",
+            "stability": "experimental",
+            "summary": "Creates a topic for notifications when a runner image build fails."
+          },
+          "locationInModule": {
+            "filename": "src/runner.ts",
+            "line": 630
+          },
+          "name": "failedImageBuildsTopic",
+          "returns": {
+            "type": {
+              "fqn": "aws-cdk-lib.aws_sns.Topic"
+            }
+          }
+        },
         {
           "docs": {
             "remarks": "A failed runner usually means the runner failed to start and so a job was never executed. It doesn't necessarily mean the job was executed and failed. For that, see {@link metricJobCompleted}.",
@@ -8165,7 +8181,7 @@
           },
           "locationInModule": {
             "filename": "src/runner.ts",
-            "line": 607
+            "line": 612
           },
           "name": "metricFailed",
           "parameters": [
@@ -8191,7 +8207,7 @@
           },
           "locationInModule": {
             "filename": "src/runner.ts",
-            "line": 552
+            "line": 557
           },
           "name": "metricJobCompleted",
           "parameters": [
@@ -8217,7 +8233,7 @@
           },
           "locationInModule": {
             "filename": "src/runner.ts",
-            "line": 598
+            "line": 603
           },
           "name": "metricSucceeded",
           "parameters": [
@@ -8243,7 +8259,7 @@
           },
           "locationInModule": {
             "filename": "src/runner.ts",
-            "line": 614
+            "line": 619
           },
           "name": "metricTime",
           "parameters": [
@@ -8272,7 +8288,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/runner.ts",
-            "line": 203
+            "line": 208
           },
           "name": "providers",
           "type": {
@@ -8292,7 +8308,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/runner.ts",
-            "line": 208
+            "line": 213
           },
           "name": "secrets",
           "type": {
@@ -8306,7 +8322,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/runner.ts",
-            "line": 218
+            "line": 223
           },
           "name": "props",
           "optional": true,
@@ -8328,7 +8344,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/runner.ts",
-        "line": 30
+        "line": 35
       },
       "name": "GitHubRunnersProps",
       "properties": [
@@ -8343,7 +8359,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/runner.ts",
-            "line": 53
+            "line": 58
           },
           "name": "allowPublicSubnet",
           "optional": true,
@@ -8361,7 +8377,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/runner.ts",
-            "line": 83
+            "line": 88
           },
           "name": "extraCertificates",
           "optional": true,
@@ -8380,7 +8396,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/runner.ts",
-            "line": 90
+            "line": 95
           },
           "name": "idleTimeout",
           "optional": true,
@@ -8398,7 +8414,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/runner.ts",
-            "line": 97
+            "line": 102
           },
           "name": "logOptions",
           "optional": true,
@@ -8417,7 +8433,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/runner.ts",
-            "line": 36
+            "line": 41
           },
           "name": "providers",
           "optional": true,
@@ -8440,7 +8456,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/runner.ts",
-            "line": 58
+            "line": 63
           },
           "name": "securityGroup",
           "optional": true,
@@ -8459,7 +8475,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/runner.ts",
-            "line": 104
+            "line": 109
           },
           "name": "setupAccess",
           "optional": true,
@@ -8478,7 +8494,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/runner.ts",
-            "line": 123
+            "line": 128
           },
           "name": "statusAccess",
           "optional": true,
@@ -8496,7 +8512,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/runner.ts",
-            "line": 41
+            "line": 46
           },
           "name": "vpc",
           "optional": true,
@@ -8514,7 +8530,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/runner.ts",
-            "line": 46
+            "line": 51
           },
           "name": "vpcSubnets",
           "optional": true,
@@ -8533,7 +8549,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/runner.ts",
-            "line": 116
+            "line": 121
           },
           "name": "webhookAccess",
           "optional": true,
@@ -8604,8 +8620,8 @@
       "fqn": "@cloudsnorkel/cdk-github-runners.IRunnerImageBuilder",
       "kind": "interface",
       "locationInModule": {
-        "filename": "src/providers/image-builders/common.ts",
-        "line": 257
+        "filename": "src/image-builders/common.ts",
+        "line": 259
       },
       "methods": [
         {
@@ -8616,8 +8632,8 @@
             "summary": "Build and return an AMI with GitHub Runner installed in it."
           },
           "locationInModule": {
-            "filename": "src/providers/image-builders/common.ts",
-            "line": 276
+            "filename": "src/image-builders/common.ts",
+            "line": 278
           },
           "name": "bindAmi",
           "returns": {
@@ -8634,8 +8650,8 @@
             "summary": "Build and return a Docker image with GitHub Runner installed in it."
           },
           "locationInModule": {
-            "filename": "src/providers/image-builders/common.ts",
-            "line": 267
+            "filename": "src/image-builders/common.ts",
+            "line": 269
           },
           "name": "bindDockerImage",
           "returns": {
@@ -8646,7 +8662,7 @@
         }
       ],
       "name": "IRunnerImageBuilder",
-      "symbolId": "src/providers/image-builders/common:IRunnerImageBuilder"
+      "symbolId": "src/image-builders/common:IRunnerImageBuilder"
     },
     "@cloudsnorkel/cdk-github-runners.IRunnerImageStatus": {
       "assembly": "@cloudsnorkel/cdk-github-runners",
@@ -9031,8 +9047,8 @@
       "fqn": "@cloudsnorkel/cdk-github-runners.ImageBuilderAsset",
       "kind": "interface",
       "locationInModule": {
-        "filename": "src/providers/image-builders/aws-image-builder/builder.ts",
-        "line": 41
+        "filename": "src/image-builders/aws-image-builder/builder.ts",
+        "line": 44
       },
       "name": "ImageBuilderAsset",
       "properties": [
@@ -9044,8 +9060,8 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/aws-image-builder/builder.ts",
-            "line": 50
+            "filename": "src/image-builders/aws-image-builder/builder.ts",
+            "line": 53
           },
           "name": "asset",
           "type": {
@@ -9060,8 +9076,8 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/aws-image-builder/builder.ts",
-            "line": 45
+            "filename": "src/image-builders/aws-image-builder/builder.ts",
+            "line": 48
           },
           "name": "path",
           "type": {
@@ -9069,14 +9085,14 @@
           }
         }
       ],
-      "symbolId": "src/providers/image-builders/aws-image-builder/builder:ImageBuilderAsset"
+      "symbolId": "src/image-builders/aws-image-builder/builder:ImageBuilderAsset"
     },
     "@cloudsnorkel/cdk-github-runners.ImageBuilderComponent": {
       "assembly": "@cloudsnorkel/cdk-github-runners",
       "base": "aws-cdk-lib.Resource",
       "docs": {
         "deprecated": "Use `RunnerImageComponent` instead as this be internal soon.",
-        "remarks": "Components are the building blocks of images built by Image Builder.\n\nExample:\n\n```\nnew ImageBuilderComponent(this, 'AWS CLI', {\n  platform: 'Windows',\n  displayName: 'AWS CLI',\n  description: 'Install latest version of AWS CLI',\n  commands: [\n    '$ErrorActionPreference = \\'Stop\\'',\n    'Start-Process msiexec.exe -Wait -ArgumentList \\'/i https://awscli.amazonaws.com/AWSCLIV2.msi /qn\\'',\n  ],\n}\n```",
+        "remarks": "Components are the building blocks of images built by Image Builder.\n\nExample:\n\n```\nnew ImageBuilderComponent(this, 'AWS CLI', {\n  platform: 'Windows',\n  displayName: 'AWS CLI',\n  description: 'Install latest version of AWS CLI',\n  commands: [\n    '$p = Start-Process msiexec.exe -PassThru -Wait -ArgumentList \\'/i https://awscli.amazonaws.com/AWSCLIV2.msi /qn\\'',\n    'if ($p.ExitCode -ne 0) { throw \"Exit code is $p.ExitCode\" }',\n  ],\n}\n```",
         "stability": "deprecated",
         "summary": "Components are a set of commands to run and optional files to add to an image."
       },
@@ -9086,8 +9102,8 @@
           "stability": "deprecated"
         },
         "locationInModule": {
-          "filename": "src/providers/image-builders/aws-image-builder/builder.ts",
-          "line": 117
+          "filename": "src/image-builders/aws-image-builder/builder.ts",
+          "line": 127
         },
         "parameters": [
           {
@@ -9112,8 +9128,8 @@
       },
       "kind": "class",
       "locationInModule": {
-        "filename": "src/providers/image-builders/aws-image-builder/builder.ts",
-        "line": 104
+        "filename": "src/image-builders/aws-image-builder/builder.ts",
+        "line": 114
       },
       "methods": [
         {
@@ -9122,8 +9138,8 @@
             "summary": "Grants read permissions to the principal on the assets buckets."
           },
           "locationInModule": {
-            "filename": "src/providers/image-builders/aws-image-builder/builder.ts",
-            "line": 211
+            "filename": "src/image-builders/aws-image-builder/builder.ts",
+            "line": 229
           },
           "name": "grantAssetsRead",
           "parameters": [
@@ -9140,8 +9156,8 @@
             "stability": "deprecated"
           },
           "locationInModule": {
-            "filename": "src/providers/image-builders/aws-image-builder/builder.ts",
-            "line": 217
+            "filename": "src/image-builders/aws-image-builder/builder.ts",
+            "line": 235
           },
           "name": "prefixCommandsWithErrorHandling",
           "parameters": [
@@ -9179,7 +9195,7 @@
             "stability": "deprecated"
           },
           "locationInModule": {
-            "filename": "src/providers/image-builders/aws-image-builder/common.ts",
+            "filename": "src/image-builders/aws-image-builder/common.ts",
             "line": 15
           },
           "name": "version",
@@ -9220,8 +9236,8 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/aws-image-builder/builder.ts",
-            "line": 108
+            "filename": "src/image-builders/aws-image-builder/builder.ts",
+            "line": 118
           },
           "name": "arn",
           "type": {
@@ -9235,8 +9251,8 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/aws-image-builder/builder.ts",
-            "line": 113
+            "filename": "src/image-builders/aws-image-builder/builder.ts",
+            "line": 123
           },
           "name": "platform",
           "type": {
@@ -9244,7 +9260,7 @@
           }
         }
       ],
-      "symbolId": "src/providers/image-builders/aws-image-builder/builder:ImageBuilderComponent"
+      "symbolId": "src/image-builders/aws-image-builder/builder:ImageBuilderComponent"
     },
     "@cloudsnorkel/cdk-github-runners.ImageBuilderComponentProperties": {
       "assembly": "@cloudsnorkel/cdk-github-runners",
@@ -9256,8 +9272,8 @@
       "fqn": "@cloudsnorkel/cdk-github-runners.ImageBuilderComponentProperties",
       "kind": "interface",
       "locationInModule": {
-        "filename": "src/providers/image-builders/aws-image-builder/builder.ts",
-        "line": 56
+        "filename": "src/image-builders/aws-image-builder/builder.ts",
+        "line": 59
       },
       "name": "ImageBuilderComponentProperties",
       "properties": [
@@ -9270,8 +9286,8 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/aws-image-builder/builder.ts",
-            "line": 77
+            "filename": "src/image-builders/aws-image-builder/builder.ts",
+            "line": 80
           },
           "name": "commands",
           "type": {
@@ -9291,8 +9307,8 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/aws-image-builder/builder.ts",
-            "line": 70
+            "filename": "src/image-builders/aws-image-builder/builder.ts",
+            "line": 73
           },
           "name": "description",
           "type": {
@@ -9307,8 +9323,8 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/aws-image-builder/builder.ts",
-            "line": 65
+            "filename": "src/image-builders/aws-image-builder/builder.ts",
+            "line": 68
           },
           "name": "displayName",
           "type": {
@@ -9324,8 +9340,8 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/aws-image-builder/builder.ts",
-            "line": 60
+            "filename": "src/image-builders/aws-image-builder/builder.ts",
+            "line": 63
           },
           "name": "platform",
           "type": {
@@ -9340,8 +9356,8 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/aws-image-builder/builder.ts",
-            "line": 82
+            "filename": "src/image-builders/aws-image-builder/builder.ts",
+            "line": 85
           },
           "name": "assets",
           "optional": true,
@@ -9353,9 +9369,27 @@
               "kind": "array"
             }
           }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "false",
+            "stability": "experimental",
+            "summary": "Require a reboot after installing this component."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/image-builders/aws-image-builder/builder.ts",
+            "line": 92
+          },
+          "name": "reboot",
+          "optional": true,
+          "type": {
+            "primitive": "boolean"
+          }
         }
       ],
-      "symbolId": "src/providers/image-builders/aws-image-builder/builder:ImageBuilderComponentProperties"
+      "symbolId": "src/image-builders/aws-image-builder/builder:ImageBuilderComponentProperties"
     },
     "@cloudsnorkel/cdk-github-runners.LambdaAccess": {
       "abstract": true,
@@ -10140,7 +10174,7 @@
       },
       "kind": "class",
       "locationInModule": {
-        "filename": "src/providers/image-builders/aws-image-builder/deprecated/linux-components.ts",
+        "filename": "src/image-builders/aws-image-builder/deprecated/linux-components.ts",
         "line": 11
       },
       "methods": [
@@ -10149,8 +10183,8 @@
             "stability": "deprecated"
           },
           "locationInModule": {
-            "filename": "src/providers/image-builders/aws-image-builder/deprecated/linux-components.ts",
-            "line": 53
+            "filename": "src/image-builders/aws-image-builder/deprecated/linux-components.ts",
+            "line": 51
           },
           "name": "awsCli",
           "parameters": [
@@ -10185,8 +10219,8 @@
             "stability": "deprecated"
           },
           "locationInModule": {
-            "filename": "src/providers/image-builders/aws-image-builder/deprecated/linux-components.ts",
-            "line": 140
+            "filename": "src/image-builders/aws-image-builder/deprecated/linux-components.ts",
+            "line": 134
           },
           "name": "docker",
           "parameters": [
@@ -10221,8 +10255,8 @@
             "stability": "deprecated"
           },
           "locationInModule": {
-            "filename": "src/providers/image-builders/aws-image-builder/deprecated/linux-components.ts",
-            "line": 159
+            "filename": "src/image-builders/aws-image-builder/deprecated/linux-components.ts",
+            "line": 152
           },
           "name": "extraCertificates",
           "parameters": [
@@ -10257,8 +10291,8 @@
             "stability": "deprecated"
           },
           "locationInModule": {
-            "filename": "src/providers/image-builders/aws-image-builder/deprecated/linux-components.ts",
-            "line": 93
+            "filename": "src/image-builders/aws-image-builder/deprecated/linux-components.ts",
+            "line": 89
           },
           "name": "git",
           "parameters": [
@@ -10293,8 +10327,8 @@
             "stability": "deprecated"
           },
           "locationInModule": {
-            "filename": "src/providers/image-builders/aws-image-builder/deprecated/linux-components.ts",
-            "line": 77
+            "filename": "src/image-builders/aws-image-builder/deprecated/linux-components.ts",
+            "line": 74
           },
           "name": "githubCli",
           "parameters": [
@@ -10329,8 +10363,8 @@
             "stability": "deprecated"
           },
           "locationInModule": {
-            "filename": "src/providers/image-builders/aws-image-builder/deprecated/linux-components.ts",
-            "line": 107
+            "filename": "src/image-builders/aws-image-builder/deprecated/linux-components.ts",
+            "line": 102
           },
           "name": "githubRunner",
           "parameters": [
@@ -10371,7 +10405,7 @@
             "stability": "deprecated"
           },
           "locationInModule": {
-            "filename": "src/providers/image-builders/aws-image-builder/deprecated/linux-components.ts",
+            "filename": "src/image-builders/aws-image-builder/deprecated/linux-components.ts",
             "line": 12
           },
           "name": "requiredPackages",
@@ -10407,8 +10441,8 @@
             "stability": "deprecated"
           },
           "locationInModule": {
-            "filename": "src/providers/image-builders/aws-image-builder/deprecated/linux-components.ts",
-            "line": 38
+            "filename": "src/image-builders/aws-image-builder/deprecated/linux-components.ts",
+            "line": 37
           },
           "name": "runnerUser",
           "parameters": [
@@ -10440,7 +10474,7 @@
         }
       ],
       "name": "LinuxUbuntuComponents",
-      "symbolId": "src/providers/image-builders/aws-image-builder/deprecated/linux-components:LinuxUbuntuComponents"
+      "symbolId": "src/image-builders/aws-image-builder/deprecated/linux-components:LinuxUbuntuComponents"
     },
     "@cloudsnorkel/cdk-github-runners.LogOptions": {
       "assembly": "@cloudsnorkel/cdk-github-runners",
@@ -10453,7 +10487,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/runner.ts",
-        "line": 129
+        "line": 134
       },
       "name": "LogOptions",
       "properties": [
@@ -10467,7 +10501,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/runner.ts",
-            "line": 140
+            "line": 145
           },
           "name": "includeExecutionData",
           "optional": true,
@@ -10485,7 +10519,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/runner.ts",
-            "line": 147
+            "line": 152
           },
           "name": "level",
           "optional": true,
@@ -10502,7 +10536,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/runner.ts",
-            "line": 133
+            "line": 138
           },
           "name": "logGroupName",
           "optional": true,
@@ -10521,7 +10555,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/runner.ts",
-            "line": 156
+            "line": 161
           },
           "name": "logRetention",
           "optional": true,
@@ -11012,7 +11046,7 @@
       "fqn": "@cloudsnorkel/cdk-github-runners.RunnerImageAsset",
       "kind": "interface",
       "locationInModule": {
-        "filename": "src/providers/image-builders/common.ts",
+        "filename": "src/image-builders/common.ts",
         "line": 119
       },
       "name": "RunnerImageAsset",
@@ -11026,7 +11060,7 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/common.ts",
+            "filename": "src/image-builders/common.ts",
             "line": 123
           },
           "name": "source",
@@ -11042,7 +11076,7 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/common.ts",
+            "filename": "src/image-builders/common.ts",
             "line": 128
           },
           "name": "target",
@@ -11051,7 +11085,7 @@
           }
         }
       ],
-      "symbolId": "src/providers/image-builders/common:RunnerImageAsset"
+      "symbolId": "src/image-builders/common:RunnerImageAsset"
     },
     "@cloudsnorkel/cdk-github-runners.RunnerImageBuilder": {
       "abstract": true,
@@ -11068,8 +11102,8 @@
           "stability": "experimental"
         },
         "locationInModule": {
-          "filename": "src/providers/image-builders/common.ts",
-          "line": 285
+          "filename": "src/image-builders/common.ts",
+          "line": 287
         },
         "parameters": [
           {
@@ -11101,7 +11135,7 @@
       ],
       "kind": "class",
       "locationInModule": {
-        "filename": "src/providers/image-builders/api.ts",
+        "filename": "src/image-builders/api.ts",
         "line": 15
       },
       "methods": [
@@ -11112,7 +11146,7 @@
             "summary": "Create a new image builder based on the provided properties."
           },
           "locationInModule": {
-            "filename": "src/providers/image-builders/api.ts",
+            "filename": "src/image-builders/api.ts",
             "line": 19
           },
           "name": "new",
@@ -11151,8 +11185,8 @@
             "summary": "Add a component to the image builder."
           },
           "locationInModule": {
-            "filename": "src/providers/image-builders/common.ts",
-            "line": 305
+            "filename": "src/image-builders/common.ts",
+            "line": 307
           },
           "name": "addComponent",
           "parameters": [
@@ -11175,8 +11209,8 @@
             "summary": "Build and return an AMI with GitHub Runner installed in it."
           },
           "locationInModule": {
-            "filename": "src/providers/image-builders/common.ts",
-            "line": 295
+            "filename": "src/image-builders/common.ts",
+            "line": 297
           },
           "name": "bindAmi",
           "overrides": "@cloudsnorkel/cdk-github-runners.IRunnerImageBuilder",
@@ -11194,8 +11228,8 @@
             "summary": "Build and return a Docker image with GitHub Runner installed in it."
           },
           "locationInModule": {
-            "filename": "src/providers/image-builders/common.ts",
-            "line": 293
+            "filename": "src/image-builders/common.ts",
+            "line": 295
           },
           "name": "bindDockerImage",
           "overrides": "@cloudsnorkel/cdk-github-runners.IRunnerImageBuilder",
@@ -11212,8 +11246,8 @@
             "summary": "Remove a component from the image builder."
           },
           "locationInModule": {
-            "filename": "src/providers/image-builders/common.ts",
-            "line": 314
+            "filename": "src/image-builders/common.ts",
+            "line": 316
           },
           "name": "removeComponent",
           "parameters": [
@@ -11239,8 +11273,8 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/common.ts",
-            "line": 297
+            "filename": "src/image-builders/common.ts",
+            "line": 299
           },
           "name": "connections",
           "overrides": "aws-cdk-lib.aws_ec2.IConnectable",
@@ -11256,8 +11290,8 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/common.ts",
-            "line": 298
+            "filename": "src/image-builders/common.ts",
+            "line": 300
           },
           "name": "grantPrincipal",
           "overrides": "aws-cdk-lib.aws_iam.IGrantable",
@@ -11270,8 +11304,8 @@
             "stability": "experimental"
           },
           "locationInModule": {
-            "filename": "src/providers/image-builders/common.ts",
-            "line": 283
+            "filename": "src/image-builders/common.ts",
+            "line": 285
           },
           "name": "components",
           "protected": true,
@@ -11285,7 +11319,7 @@
           }
         }
       ],
-      "symbolId": "src/providers/image-builders/api:RunnerImageBuilder"
+      "symbolId": "src/image-builders/api:RunnerImageBuilder"
     },
     "@cloudsnorkel/cdk-github-runners.RunnerImageBuilderProps": {
       "assembly": "@cloudsnorkel/cdk-github-runners",
@@ -11296,7 +11330,7 @@
       "fqn": "@cloudsnorkel/cdk-github-runners.RunnerImageBuilderProps",
       "kind": "interface",
       "locationInModule": {
-        "filename": "src/providers/image-builders/common.ts",
+        "filename": "src/image-builders/common.ts",
         "line": 131
       },
       "name": "RunnerImageBuilderProps",
@@ -11310,7 +11344,7 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/common.ts",
+            "filename": "src/image-builders/common.ts",
             "line": 137
           },
           "name": "architecture",
@@ -11328,8 +11362,8 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/common.ts",
-            "line": 233
+            "filename": "src/image-builders/common.ts",
+            "line": 235
           },
           "name": "awsImageBuilderOptions",
           "optional": true,
@@ -11340,14 +11374,15 @@
         {
           "abstract": true,
           "docs": {
-            "default": "latest Ubuntu 20.04 AMI for Os.LINUX_UBUNTU, latest Amazon Linux 2 AMI for Os.LINUX_AMAZON_2, latest Windows Server 2022 AMI for Os.WINDOWS",
+            "default": "latest Ubuntu 22.04 AMI for Os.LINUX_UBUNTU, latest Amazon Linux 2 AMI for Os.LINUX_AMAZON_2, latest Windows Server 2022 AMI for Os.WINDOWS",
+            "remarks": "This can be an actual AMI or an AWS Image Builder ARN that points to the latest AMI. For example `arn:aws:imagebuilder:us-east-1:aws:image/ubuntu-server-22-lts-x86/x.x.x` would always use the latest version of Ubuntu 22.04 in each build. If you want a specific version, you can replace `x.x.x` with that version.",
             "stability": "experimental",
             "summary": "Base AMI from which runner AMIs will be built."
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/common.ts",
-            "line": 158
+            "filename": "src/image-builders/common.ts",
+            "line": 160
           },
           "name": "baseAmi",
           "optional": true,
@@ -11364,7 +11399,7 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/common.ts",
+            "filename": "src/image-builders/common.ts",
             "line": 151
           },
           "name": "baseDockerImage",
@@ -11381,8 +11416,8 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/common.ts",
-            "line": 223
+            "filename": "src/image-builders/common.ts",
+            "line": 225
           },
           "name": "builderType",
           "optional": true,
@@ -11399,8 +11434,8 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/common.ts",
-            "line": 228
+            "filename": "src/image-builders/common.ts",
+            "line": 230
           },
           "name": "codeBuildOptions",
           "optional": true,
@@ -11417,8 +11452,8 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/common.ts",
-            "line": 172
+            "filename": "src/image-builders/common.ts",
+            "line": 174
           },
           "name": "components",
           "optional": true,
@@ -11441,8 +11476,8 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/common.ts",
-            "line": 218
+            "filename": "src/image-builders/common.ts",
+            "line": 220
           },
           "name": "logRemovalPolicy",
           "optional": true,
@@ -11460,8 +11495,8 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/common.ts",
-            "line": 209
+            "filename": "src/image-builders/common.ts",
+            "line": 211
           },
           "name": "logRetention",
           "optional": true,
@@ -11478,7 +11513,7 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/common.ts",
+            "filename": "src/image-builders/common.ts",
             "line": 144
           },
           "name": "os",
@@ -11497,8 +11532,8 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/common.ts",
-            "line": 181
+            "filename": "src/image-builders/common.ts",
+            "line": 183
           },
           "name": "rebuildInterval",
           "optional": true,
@@ -11515,8 +11550,8 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/common.ts",
-            "line": 165
+            "filename": "src/image-builders/common.ts",
+            "line": 167
           },
           "name": "runnerVersion",
           "optional": true,
@@ -11532,8 +11567,8 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/common.ts",
-            "line": 193
+            "filename": "src/image-builders/common.ts",
+            "line": 195
           },
           "name": "securityGroups",
           "optional": true,
@@ -11555,8 +11590,8 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/common.ts",
-            "line": 200
+            "filename": "src/image-builders/common.ts",
+            "line": 202
           },
           "name": "subnetSelection",
           "optional": true,
@@ -11573,8 +11608,8 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/common.ts",
-            "line": 188
+            "filename": "src/image-builders/common.ts",
+            "line": 190
           },
           "name": "vpc",
           "optional": true,
@@ -11583,7 +11618,7 @@
           }
         }
       ],
-      "symbolId": "src/providers/image-builders/common:RunnerImageBuilderProps"
+      "symbolId": "src/image-builders/common:RunnerImageBuilderProps"
     },
     "@cloudsnorkel/cdk-github-runners.RunnerImageBuilderType": {
       "assembly": "@cloudsnorkel/cdk-github-runners",
@@ -11593,8 +11628,8 @@
       "fqn": "@cloudsnorkel/cdk-github-runners.RunnerImageBuilderType",
       "kind": "enum",
       "locationInModule": {
-        "filename": "src/providers/image-builders/common.ts",
-        "line": 236
+        "filename": "src/image-builders/common.ts",
+        "line": 238
       },
       "members": [
         {
@@ -11615,7 +11650,7 @@
         }
       ],
       "name": "RunnerImageBuilderType",
-      "symbolId": "src/providers/image-builders/common:RunnerImageBuilderType"
+      "symbolId": "src/image-builders/common:RunnerImageBuilderType"
     },
     "@cloudsnorkel/cdk-github-runners.RunnerImageComponent": {
       "abstract": true,
@@ -11633,7 +11668,7 @@
       },
       "kind": "class",
       "locationInModule": {
-        "filename": "src/providers/image-builders/components.ts",
+        "filename": "src/image-builders/components.ts",
         "line": 39
       },
       "methods": [
@@ -11643,8 +11678,8 @@
             "summary": "A component to install the AWS CLI."
           },
           "locationInModule": {
-            "filename": "src/providers/image-builders/components.ts",
-            "line": 148
+            "filename": "src/image-builders/components.ts",
+            "line": 149
           },
           "name": "awsCli",
           "returns": {
@@ -11661,7 +11696,7 @@
             "summary": "Define a custom component that can run commands in the image, copy files into the image, and run some Docker commands."
           },
           "locationInModule": {
-            "filename": "src/providers/image-builders/components.ts",
+            "filename": "src/image-builders/components.ts",
             "line": 49
           },
           "name": "custom",
@@ -11682,13 +11717,13 @@
         },
         {
           "docs": {
-            "remarks": "On Windows this installs Docker Desktop.",
+            "remarks": "On Windows this sets up dockerd for Windows containers without Docker Desktop. If you need Linux containers on Windows, you'll need to install Docker Desktop which doesn't seem to play well with servers (PRs welcome).",
             "stability": "experimental",
             "summary": "A component to install Docker."
           },
           "locationInModule": {
-            "filename": "src/providers/image-builders/components.ts",
-            "line": 330
+            "filename": "src/image-builders/components.ts",
+            "line": 336
           },
           "name": "docker",
           "returns": {
@@ -11704,8 +11739,8 @@
             "summary": "A component to install Docker-in-Docker."
           },
           "locationInModule": {
-            "filename": "src/providers/image-builders/components.ts",
-            "line": 371
+            "filename": "src/image-builders/components.ts",
+            "line": 398
           },
           "name": "dockerInDocker",
           "returns": {
@@ -11722,8 +11757,8 @@
             "summary": "A component to add a trusted certificate authority."
           },
           "locationInModule": {
-            "filename": "src/providers/image-builders/components.ts",
-            "line": 420
+            "filename": "src/image-builders/components.ts",
+            "line": 447
           },
           "name": "extraCertificates",
           "parameters": [
@@ -11759,8 +11794,8 @@
             "summary": "A component to install the GitHub CLI."
           },
           "locationInModule": {
-            "filename": "src/providers/image-builders/components.ts",
-            "line": 220
+            "filename": "src/image-builders/components.ts",
+            "line": 223
           },
           "name": "git",
           "returns": {
@@ -11776,8 +11811,8 @@
             "summary": "A component to install the GitHub CLI."
           },
           "locationInModule": {
-            "filename": "src/providers/image-builders/components.ts",
-            "line": 183
+            "filename": "src/image-builders/components.ts",
+            "line": 185
           },
           "name": "githubCli",
           "returns": {
@@ -11794,8 +11829,8 @@
             "summary": "A component to install the GitHub Actions Runner."
           },
           "locationInModule": {
-            "filename": "src/providers/image-builders/components.ts",
-            "line": 259
+            "filename": "src/image-builders/components.ts",
+            "line": 263
           },
           "name": "githubRunner",
           "parameters": [
@@ -11823,8 +11858,8 @@
             "summary": "A component to set up the required Lambda entrypoint for Lambda runners."
           },
           "locationInModule": {
-            "filename": "src/providers/image-builders/components.ts",
-            "line": 470
+            "filename": "src/image-builders/components.ts",
+            "line": 497
           },
           "name": "lambdaEntrypoint",
           "returns": {
@@ -11840,7 +11875,7 @@
             "summary": "A component to install the required packages for the runner."
           },
           "locationInModule": {
-            "filename": "src/providers/image-builders/components.ts",
+            "filename": "src/image-builders/components.ts",
             "line": 74
           },
           "name": "requiredPackages",
@@ -11857,8 +11892,8 @@
             "summary": "A component to prepare the required runner user."
           },
           "locationInModule": {
-            "filename": "src/providers/image-builders/components.ts",
-            "line": 116
+            "filename": "src/image-builders/components.ts",
+            "line": 117
           },
           "name": "runnerUser",
           "returns": {
@@ -11875,8 +11910,8 @@
             "summary": "Returns assets to copy into the built image."
           },
           "locationInModule": {
-            "filename": "src/providers/image-builders/components.ts",
-            "line": 519
+            "filename": "src/image-builders/components.ts",
+            "line": 546
           },
           "name": "getAssets",
           "parameters": [
@@ -11912,8 +11947,8 @@
             "summary": "Returns commands to run to in built image."
           },
           "locationInModule": {
-            "filename": "src/providers/image-builders/components.ts",
-            "line": 514
+            "filename": "src/image-builders/components.ts",
+            "line": 541
           },
           "name": "getCommands",
           "parameters": [
@@ -11948,8 +11983,8 @@
             "summary": "Returns Docker commands to run to in built image."
           },
           "locationInModule": {
-            "filename": "src/providers/image-builders/components.ts",
-            "line": 528
+            "filename": "src/image-builders/components.ts",
+            "line": 555
           },
           "name": "getDockerCommands",
           "parameters": [
@@ -11976,6 +12011,36 @@
               }
             }
           }
+        },
+        {
+          "docs": {
+            "stability": "experimental",
+            "summary": "Returns true if the image builder should be rebooted after this component is installed."
+          },
+          "locationInModule": {
+            "filename": "src/image-builders/components.ts",
+            "line": 562
+          },
+          "name": "shouldReboot",
+          "parameters": [
+            {
+              "name": "_os",
+              "type": {
+                "fqn": "@cloudsnorkel/cdk-github-runners.Os"
+              }
+            },
+            {
+              "name": "_architecture",
+              "type": {
+                "fqn": "@cloudsnorkel/cdk-github-runners.Architecture"
+              }
+            }
+          ],
+          "returns": {
+            "type": {
+              "primitive": "boolean"
+            }
+          }
         }
       ],
       "name": "RunnerImageComponent",
@@ -11989,8 +12054,8 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/components.ts",
-            "line": 509
+            "filename": "src/image-builders/components.ts",
+            "line": 536
           },
           "name": "name",
           "type": {
@@ -11998,7 +12063,7 @@
           }
         }
       ],
-      "symbolId": "src/providers/image-builders/components:RunnerImageComponent"
+      "symbolId": "src/image-builders/components:RunnerImageComponent"
     },
     "@cloudsnorkel/cdk-github-runners.RunnerImageComponentCustomProps": {
       "assembly": "@cloudsnorkel/cdk-github-runners",
@@ -12009,7 +12074,7 @@
       "fqn": "@cloudsnorkel/cdk-github-runners.RunnerImageComponentCustomProps",
       "kind": "interface",
       "locationInModule": {
-        "filename": "src/providers/image-builders/components.ts",
+        "filename": "src/image-builders/components.ts",
         "line": 8
       },
       "name": "RunnerImageComponentCustomProps",
@@ -12022,7 +12087,7 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/components.ts",
+            "filename": "src/image-builders/components.ts",
             "line": 24
           },
           "name": "assets",
@@ -12044,7 +12109,7 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/components.ts",
+            "filename": "src/image-builders/components.ts",
             "line": 19
           },
           "name": "commands",
@@ -12067,7 +12132,7 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/components.ts",
+            "filename": "src/image-builders/components.ts",
             "line": 33
           },
           "name": "dockerCommands",
@@ -12090,7 +12155,7 @@
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "src/providers/image-builders/components.ts",
+            "filename": "src/image-builders/components.ts",
             "line": 14
           },
           "name": "name",
@@ -12100,7 +12165,7 @@
           }
         }
       ],
-      "symbolId": "src/providers/image-builders/components:RunnerImageComponentCustomProps"
+      "symbolId": "src/image-builders/components:RunnerImageComponentCustomProps"
     },
     "@cloudsnorkel/cdk-github-runners.RunnerProviderProps": {
       "assembly": "@cloudsnorkel/cdk-github-runners",
@@ -12500,7 +12565,7 @@
       },
       "kind": "class",
       "locationInModule": {
-        "filename": "src/providers/image-builders/static.ts",
+        "filename": "src/image-builders/static.ts",
         "line": 10
       },
       "methods": [
@@ -12511,7 +12576,7 @@
             "summary": "Create a builder from an existing Docker Hub image."
           },
           "locationInModule": {
-            "filename": "src/providers/image-builders/static.ts",
+            "filename": "src/image-builders/static.ts",
             "line": 48
           },
           "name": "fromDockerHub",
@@ -12572,7 +12637,7 @@
             "summary": "Create a builder (that doesn't actually build anything) from an existing image in an existing repository."
           },
           "locationInModule": {
-            "filename": "src/providers/image-builders/static.ts",
+            "filename": "src/image-builders/static.ts",
             "line": 19
           },
           "name": "fromEcrRepository",
@@ -12626,7 +12691,7 @@
         }
       ],
       "name": "StaticRunnerImage",
-      "symbolId": "src/providers/image-builders/static:StaticRunnerImage"
+      "symbolId": "src/image-builders/static:StaticRunnerImage"
     },
     "@cloudsnorkel/cdk-github-runners.WindowsComponents": {
       "assembly": "@cloudsnorkel/cdk-github-runners",
@@ -12644,8 +12709,8 @@
       },
       "kind": "class",
       "locationInModule": {
-        "filename": "src/providers/image-builders/aws-image-builder/deprecated/windows-components.ts",
-        "line": 11
+        "filename": "src/image-builders/aws-image-builder/deprecated/windows-components.ts",
+        "line": 12
       },
       "methods": [
         {
@@ -12653,8 +12718,8 @@
             "stability": "deprecated"
           },
           "locationInModule": {
-            "filename": "src/providers/image-builders/aws-image-builder/deprecated/windows-components.ts",
-            "line": 24
+            "filename": "src/image-builders/aws-image-builder/deprecated/windows-components.ts",
+            "line": 25
           },
           "name": "awsCli",
           "parameters": [
@@ -12683,8 +12748,8 @@
             "stability": "deprecated"
           },
           "locationInModule": {
-            "filename": "src/providers/image-builders/aws-image-builder/deprecated/windows-components.ts",
-            "line": 12
+            "filename": "src/image-builders/aws-image-builder/deprecated/windows-components.ts",
+            "line": 13
           },
           "name": "cloudwatchAgent",
           "parameters": [
@@ -12713,8 +12778,8 @@
             "stability": "deprecated"
           },
           "locationInModule": {
-            "filename": "src/providers/image-builders/aws-image-builder/deprecated/windows-components.ts",
-            "line": 104
+            "filename": "src/image-builders/aws-image-builder/deprecated/windows-components.ts",
+            "line": 99
           },
           "name": "docker",
           "parameters": [
@@ -12743,8 +12808,8 @@
             "stability": "deprecated"
           },
           "locationInModule": {
-            "filename": "src/providers/image-builders/aws-image-builder/deprecated/windows-components.ts",
-            "line": 124
+            "filename": "src/image-builders/aws-image-builder/deprecated/windows-components.ts",
+            "line": 109
           },
           "name": "extraCertificates",
           "parameters": [
@@ -12779,8 +12844,8 @@
             "stability": "deprecated"
           },
           "locationInModule": {
-            "filename": "src/providers/image-builders/aws-image-builder/deprecated/windows-components.ts",
-            "line": 55
+            "filename": "src/image-builders/aws-image-builder/deprecated/windows-components.ts",
+            "line": 54
           },
           "name": "git",
           "parameters": [
@@ -12809,8 +12874,8 @@
             "stability": "deprecated"
           },
           "locationInModule": {
-            "filename": "src/providers/image-builders/aws-image-builder/deprecated/windows-components.ts",
-            "line": 36
+            "filename": "src/image-builders/aws-image-builder/deprecated/windows-components.ts",
+            "line": 37
           },
           "name": "githubCli",
           "parameters": [
@@ -12839,8 +12904,8 @@
             "stability": "deprecated"
           },
           "locationInModule": {
-            "filename": "src/providers/image-builders/aws-image-builder/deprecated/windows-components.ts",
-            "line": 76
+            "filename": "src/image-builders/aws-image-builder/deprecated/windows-components.ts",
+            "line": 74
           },
           "name": "githubRunner",
           "parameters": [
@@ -12872,9 +12937,9 @@
         }
       ],
       "name": "WindowsComponents",
-      "symbolId": "src/providers/image-builders/aws-image-builder/deprecated/windows-components:WindowsComponents"
+      "symbolId": "src/image-builders/aws-image-builder/deprecated/windows-components:WindowsComponents"
     }
   },
-  "version": "0.9.3",
-  "fingerprint": "wm90SjuWDjOEdZ2XvCRnYQeU6aZ0JZPKovmkSiB3B2I="
+  "version": "0.9.5",
+  "fingerprint": "V+KyphB/VHigagS07H6ZFAsLHZDxDcwHuUU2M43SHDw="
 }