@cloudsnorkel/cdk-github-runners 0.14.21 → 0.14.23
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.jsii +102 -30
- package/API.md +60 -8
- package/README.md +65 -0
- package/assets/setup.lambda/index.html +7 -7
- package/lib/access.js +1 -1
- package/lib/delete-failed-runner-function.d.ts +5 -0
- package/lib/delete-failed-runner-function.js +3 -2
- package/lib/idle-runner-repear-function.d.ts +5 -0
- package/lib/idle-runner-repear-function.js +3 -2
- package/lib/image-builders/api.js +1 -1
- package/lib/image-builders/aws-image-builder/base-image.js +2 -2
- package/lib/image-builders/aws-image-builder/builder.js +1 -1
- package/lib/image-builders/aws-image-builder/delete-resources-function.d.ts +5 -0
- package/lib/image-builders/aws-image-builder/delete-resources-function.js +3 -2
- package/lib/image-builders/aws-image-builder/deprecated/ami.js +1 -1
- package/lib/image-builders/aws-image-builder/deprecated/container.js +1 -1
- package/lib/image-builders/aws-image-builder/deprecated/linux-components.js +1 -1
- package/lib/image-builders/aws-image-builder/deprecated/windows-components.js +1 -1
- package/lib/image-builders/aws-image-builder/filter-failed-builds-function.d.ts +5 -0
- package/lib/image-builders/aws-image-builder/filter-failed-builds-function.js +3 -2
- package/lib/image-builders/build-image-function.d.ts +5 -0
- package/lib/image-builders/build-image-function.js +3 -2
- package/lib/image-builders/codebuild-deprecated.js +1 -1
- package/lib/image-builders/components.d.ts +15 -6
- package/lib/image-builders/components.js +101 -14
- package/lib/image-builders/static.js +1 -1
- package/lib/providers/ami-root-device-function.d.ts +5 -0
- package/lib/providers/ami-root-device-function.js +3 -2
- package/lib/providers/codebuild.js +2 -2
- package/lib/providers/common.js +3 -3
- package/lib/providers/composite.js +1 -1
- package/lib/providers/ec2.js +2 -2
- package/lib/providers/ecs.js +1 -1
- package/lib/providers/fargate.js +2 -2
- package/lib/providers/lambda.js +4 -3
- package/lib/providers/update-lambda-function.d.ts +5 -0
- package/lib/providers/update-lambda-function.js +3 -2
- package/lib/runner.d.ts +7 -1
- package/lib/runner.js +13 -6
- package/lib/secrets.js +6 -2
- package/lib/setup-function.d.ts +5 -0
- package/lib/setup-function.js +3 -2
- package/lib/status-function.d.ts +5 -0
- package/lib/status-function.js +3 -2
- package/lib/token-retriever-function.d.ts +5 -0
- package/lib/token-retriever-function.js +3 -2
- package/lib/webhook-handler-function.d.ts +5 -0
- package/lib/webhook-handler-function.js +3 -2
- package/lib/webhook-redelivery-function.d.ts +5 -0
- package/lib/webhook-redelivery-function.js +3 -2
- package/package.json +17 -17
package/README.md
CHANGED
|
@@ -6,6 +6,7 @@
|
|
|
6
6
|
[][11]
|
|
7
7
|
[][12]
|
|
8
8
|
[](https://github.com/CloudSnorkel/cdk-github-runners/actions/workflows/release.yml)
|
|
9
|
+
[][20]
|
|
9
10
|
[](https://github.com/CloudSnorkel/cdk-github-runners/blob/main/LICENSE)
|
|
10
11
|
|
|
11
12
|
Use this CDK construct to create ephemeral [self-hosted GitHub runners][1] on-demand inside your AWS account.
|
|
@@ -25,6 +26,23 @@ Self-hosted runners in AWS are useful when:
|
|
|
25
26
|
|
|
26
27
|
Ephemeral (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.
|
|
27
28
|
|
|
29
|
+
## Table of Contents
|
|
30
|
+
|
|
31
|
+
- [API](#api)
|
|
32
|
+
- [Providers](#providers)
|
|
33
|
+
- [Installation](#installation)
|
|
34
|
+
- [Customizing](#customizing)
|
|
35
|
+
- [Composite Providers](#composite-providers)
|
|
36
|
+
- [Custom Provider Selection](#custom-provider-selection)
|
|
37
|
+
- [Examples](#examples)
|
|
38
|
+
- [Architecture](#architecture)
|
|
39
|
+
- [Troubleshooting](#troubleshooting)
|
|
40
|
+
- [Monitoring](#monitoring)
|
|
41
|
+
- [Getting Help](#getting-help)
|
|
42
|
+
- [Contributing](#contributing)
|
|
43
|
+
- [Sponsors](#sponsors)
|
|
44
|
+
- [Other Options](#other-options)
|
|
45
|
+
|
|
28
46
|
## API
|
|
29
47
|
|
|
30
48
|
The best way to browse API documentation is on [Constructs Hub][13]. It is available in all supported programming languages.
|
|
@@ -523,6 +541,14 @@ Other useful metrics to track:
|
|
|
523
541
|
1. Use `GitHubRunners.metricJobCompleted()` to get a metric for the number of completed jobs broken down by labels and job success.
|
|
524
542
|
2. Use `GitHubRunners.metricTime()` to get a metric for the total time a runner is running. This includes the overhead of starting the runner.
|
|
525
543
|
|
|
544
|
+
## Getting Help
|
|
545
|
+
|
|
546
|
+
Need help? We're here for you!
|
|
547
|
+
|
|
548
|
+
* 💬 **GitHub Discussions**: Ask questions, share ideas, or get help from the community by opening a [discussion][18]
|
|
549
|
+
* 🐛 **GitHub Issues**: Report bugs or request features by opening an [issue][16]
|
|
550
|
+
* 💬 **Discord**: Join our [Discord community][20] for real-time help and discussions
|
|
551
|
+
|
|
526
552
|
## Contributing
|
|
527
553
|
|
|
528
554
|
If you use and love this project, please consider contributing.
|
|
@@ -535,6 +561,43 @@ If you use and love this project, please consider contributing.
|
|
|
535
561
|
* Allow edits from maintainers so small adjustments can be made easily.
|
|
536
562
|
1. 💵 Consider [sponsoring][15] the project to show your support and optionally get your name listed below.
|
|
537
563
|
|
|
564
|
+
## Sponsors
|
|
565
|
+
|
|
566
|
+
Thanks to our generous sponsors who helped make this project possible!
|
|
567
|
+
|
|
568
|
+
<table>
|
|
569
|
+
<tr>
|
|
570
|
+
<td align="center">
|
|
571
|
+
<a href="https://github.com/threat-down">
|
|
572
|
+
<img src="https://github.com/threat-down.png?size=100" width="100" height="100" alt="ThreatDown" />
|
|
573
|
+
<br />
|
|
574
|
+
<sub><b>ThreatDown</b></sub>
|
|
575
|
+
</a>
|
|
576
|
+
</td>
|
|
577
|
+
<td align="center">
|
|
578
|
+
<a href="https://github.com/magicbell">
|
|
579
|
+
<img src="https://github.com/magicbell.png?size=100" width="100" height="100" alt="MagicBell" />
|
|
580
|
+
<br />
|
|
581
|
+
<sub><b>MagicBell</b></sub>
|
|
582
|
+
</a>
|
|
583
|
+
</td>
|
|
584
|
+
<td align="center">
|
|
585
|
+
<a href="https://github.com/fragment-dev">
|
|
586
|
+
<img src="https://github.com/fragment-dev.png?size=100" width="100" height="100" alt="Fragment" />
|
|
587
|
+
<br />
|
|
588
|
+
<sub><b>Fragment</b></sub>
|
|
589
|
+
</a>
|
|
590
|
+
</td>
|
|
591
|
+
<td align="center">
|
|
592
|
+
<a href="https://github.com/andresionek91">
|
|
593
|
+
<img src="https://github.com/andresionek91.png?size=100" width="100" height="100" alt="Andre Sionek" />
|
|
594
|
+
<br />
|
|
595
|
+
<sub><b>Andre Sionek</b></sub>
|
|
596
|
+
</a>
|
|
597
|
+
</td>
|
|
598
|
+
</tr>
|
|
599
|
+
</table>
|
|
600
|
+
|
|
538
601
|
## Other Options
|
|
539
602
|
|
|
540
603
|
1. [github-aws-runners/terraform-aws-github-runner][3] if you're using Terraform
|
|
@@ -558,3 +621,5 @@ If you use and love this project, please consider contributing.
|
|
|
558
621
|
[15]: https://github.com/sponsors/CloudSnorkel
|
|
559
622
|
[16]: https://github.com/CloudSnorkel/cdk-github-runners/issues
|
|
560
623
|
[17]: https://github.com/CloudSnorkel/cdk-github-runners/pulls
|
|
624
|
+
[18]: https://github.com/CloudSnorkel/cdk-github-runners/discussions
|
|
625
|
+
[20]: https://discord.gg/vdrTUTqQKv
|