@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.
Files changed (51) hide show
  1. package/.jsii +102 -30
  2. package/API.md +60 -8
  3. package/README.md +65 -0
  4. package/assets/setup.lambda/index.html +7 -7
  5. package/lib/access.js +1 -1
  6. package/lib/delete-failed-runner-function.d.ts +5 -0
  7. package/lib/delete-failed-runner-function.js +3 -2
  8. package/lib/idle-runner-repear-function.d.ts +5 -0
  9. package/lib/idle-runner-repear-function.js +3 -2
  10. package/lib/image-builders/api.js +1 -1
  11. package/lib/image-builders/aws-image-builder/base-image.js +2 -2
  12. package/lib/image-builders/aws-image-builder/builder.js +1 -1
  13. package/lib/image-builders/aws-image-builder/delete-resources-function.d.ts +5 -0
  14. package/lib/image-builders/aws-image-builder/delete-resources-function.js +3 -2
  15. package/lib/image-builders/aws-image-builder/deprecated/ami.js +1 -1
  16. package/lib/image-builders/aws-image-builder/deprecated/container.js +1 -1
  17. package/lib/image-builders/aws-image-builder/deprecated/linux-components.js +1 -1
  18. package/lib/image-builders/aws-image-builder/deprecated/windows-components.js +1 -1
  19. package/lib/image-builders/aws-image-builder/filter-failed-builds-function.d.ts +5 -0
  20. package/lib/image-builders/aws-image-builder/filter-failed-builds-function.js +3 -2
  21. package/lib/image-builders/build-image-function.d.ts +5 -0
  22. package/lib/image-builders/build-image-function.js +3 -2
  23. package/lib/image-builders/codebuild-deprecated.js +1 -1
  24. package/lib/image-builders/components.d.ts +15 -6
  25. package/lib/image-builders/components.js +101 -14
  26. package/lib/image-builders/static.js +1 -1
  27. package/lib/providers/ami-root-device-function.d.ts +5 -0
  28. package/lib/providers/ami-root-device-function.js +3 -2
  29. package/lib/providers/codebuild.js +2 -2
  30. package/lib/providers/common.js +3 -3
  31. package/lib/providers/composite.js +1 -1
  32. package/lib/providers/ec2.js +2 -2
  33. package/lib/providers/ecs.js +1 -1
  34. package/lib/providers/fargate.js +2 -2
  35. package/lib/providers/lambda.js +4 -3
  36. package/lib/providers/update-lambda-function.d.ts +5 -0
  37. package/lib/providers/update-lambda-function.js +3 -2
  38. package/lib/runner.d.ts +7 -1
  39. package/lib/runner.js +13 -6
  40. package/lib/secrets.js +6 -2
  41. package/lib/setup-function.d.ts +5 -0
  42. package/lib/setup-function.js +3 -2
  43. package/lib/status-function.d.ts +5 -0
  44. package/lib/status-function.js +3 -2
  45. package/lib/token-retriever-function.d.ts +5 -0
  46. package/lib/token-retriever-function.js +3 -2
  47. package/lib/webhook-handler-function.d.ts +5 -0
  48. package/lib/webhook-handler-function.js +3 -2
  49. package/lib/webhook-redelivery-function.d.ts +5 -0
  50. package/lib/webhook-redelivery-function.js +3 -2
  51. package/package.json +17 -17
package/README.md CHANGED
@@ -6,6 +6,7 @@
6
6
  [![Go](https://img.shields.io/github/v/tag/CloudSnorkel/cdk-github-runners?color=red&label=go&logo=go)][11]
7
7
  [![Nuget](https://img.shields.io/nuget/v/CloudSnorkel.Cdk.Github.Runners?color=red&&logo=nuget)][12]
8
8
  [![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)
9
+ [![Discord](https://img.shields.io/badge/Discord-5865F2?logo=discord&logoColor=white)][20]
9
10
  [![License](https://img.shields.io/badge/license-Apache--2.0-blue)](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