cdk-github-microvm-runners 0.1.4__tar.gz → 0.1.6__tar.gz

{cdk_github_microvm_runners-0.1.4/src/cdk_github_microvm_runners.egg-info → cdk_github_microvm_runners-0.1.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: cdk-github-microvm-runners
-Version: 0.1.4
+Version: 0.1.6
 Summary: CDK construct for running GitHub Actions jobs on AWS Lambda MicroVMs, with one ephemeral runner per job.
 Home-page: https://runnerset.dev
 Author: Court Schuett

{cdk_github_microvm_runners-0.1.4 → cdk_github_microvm_runners-0.1.6}/setup.py

@@ -5,7 +5,7 @@ kwargs = json.loads(
     """
 {
     "name": "cdk-github-microvm-runners",
-    "version": "0.1.4",
+    "version": "0.1.6",
     "description": "CDK construct for running GitHub Actions jobs on AWS Lambda MicroVMs, with one ephemeral runner per job.",
     "license": "Apache-2.0",
     "url": "https://runnerset.dev",
@@ -26,7 +26,7 @@ kwargs = json.loads(
     ],
     "package_data": {
         "cdk_github_microvm_runners._jsii": [
-            "cdk-github-microvm-runners@0.1.4.jsii.tgz"
+            "cdk-github-microvm-runners@0.1.6.jsii.tgz"
         ],
         "cdk_github_microvm_runners": [
             "py.typed"

{cdk_github_microvm_runners-0.1.4 → cdk_github_microvm_runners-0.1.6}/src/cdk_github_microvm_runners/__init__.py

@@ -1403,8 +1403,17 @@ class GithubMicrovmRunnersMetrics(
 
         A value that stays above zero means the runner set is
         failing to reconcile — VMs left running, runners left unreaped — even
-        though each sweep completes. It fires on one error over a single 5-minute
-        period; pass ``RunnerAlarmOptions`` to change that.
+        though each sweep completes. It fires on one error in each of three
+        consecutive 5-minute periods; pass ``RunnerAlarmOptions`` to change that.
+
+        The three periods are the point. A single sweep error is usually a
+        transient fault the next sweep sails past — a GitHub API call that lost
+        its connection, a throttled describe — and the sweep is convergent, so
+        the work is retried five minutes later either way. Alarming on one such
+        blip pages an operator for something already fixed by the time they
+        read it. A genuine reconciliation failure (expired credentials, a broken
+        table, a revoked App installation) fails every sweep, so it still
+        announces itself within fifteen minutes.
 
         Requires ``GithubMicrovmRunnersProps.emitMetrics``, and throws at synth
         without it.
@@ -1414,7 +1423,7 @@ class GithubMicrovmRunnersMetrics(
         :param period: Aggregation period for the metric. Default: Duration.minutes(5)
         :param threshold: Value at or above which the alarm fires. Default: 1
 
-        :default: threshold 1, 1 evaluation period, 5-minute period
+        :default: threshold 1, 3 evaluation periods, 5-minute period
         '''
         if __debug__:
             type_hints = cached_type_hints(_typecheckingstub__971f59e7dc4d5b4245765d41b7dcc4075c4dd91870a15df6b9f345ee393cdc61)
@@ -2198,7 +2207,7 @@ class ImagePipeline(
         :param id: -
         :param image: The runner image to build: ``RunnerImage.fromOptions()`` for a synthesized Dockerfile, ``RunnerImage.fromInline(text)`` for Dockerfile text, or ``RunnerImage.fromDockerfile(dir)`` for a Dockerfile and build context on disk.
         :param network: How the build and the VMs reach the network.
-        :param runner_set_id: Identifier for the runner set this image belongs to. It is combined with the first 8 hex characters of the image's ``contentHash`` to form the image's name, so a content change publishes a new image and an unchanged one is a no-op. Must match ``^[a-zA-Z0-9-_]+$``, and must be 55 characters or fewer so that ``<runnerSetId>-<8-hex-chars>`` stays within the service's 64-character name limit.
+        :param runner_set_id: Identifier for the runner set this image belongs to, used verbatim as the image's name. It is deliberately stable: the name is the only property whose change forces CloudFormation to replace the image, so holding it still keeps every content change an in-place update that adds a version. A content change is still picked up — the build context is a content-hashed CDK asset, so it moves ``codeArtifact`` — and an unchanged one is still a no-op. Must match ``^[a-zA-Z0-9-_]+$`` and be 64 characters or fewer, the service's name limit.
         :param size: The size the built image runs at, which becomes its memory floor.
         :param base_image_version: Version of the managed ``al2023-1`` base image to build from. Default: '0'
         :param image_logs: Where the build's logs go. Left unset, the build emits no logs; ``ImageLogs.enabled()`` sends them to the platform's group, and ``ImageLogs.enabled(logGroup)`` to a group you supply.
@@ -2237,7 +2246,7 @@ class ImagePipeline(
     @builtins.property
     @jsii.member(jsii_name="imageName")
     def image_name(self) -> builtins.str:
-        '''Name of the built MicroVM image, ``<runnerSetId>-<8 hex characters of the content hash>``.'''
+        '''Name of the built MicroVM image — the per-class ``runnerSetId``, stable for the life of the runner class.'''
         return typing.cast(builtins.str, jsii.get(self, "imageName"))
 
     @builtins.property
@@ -2246,6 +2255,12 @@ class ImagePipeline(
         '''The underlying ``AWS::Lambda::MicrovmImage`` resource.'''
         return typing.cast("_aws_cdk_aws_lambda_ceddda9d.CfnMicrovmImage", jsii.get(self, "imageResource"))
 
+    @builtins.property
+    @jsii.member(jsii_name="imageVersion")
+    def image_version(self) -> builtins.str:
+        '''The image's latest active version, which advances every time the image is rebuilt in place.'''
+        return typing.cast(builtins.str, jsii.get(self, "imageVersion"))
+
 
 @jsii.data_type(
     jsii_type="cdk-github-microvm-runners.ImagePipelineProps",
@@ -2278,7 +2293,7 @@ class ImagePipelineProps:
 
         :param image: The runner image to build: ``RunnerImage.fromOptions()`` for a synthesized Dockerfile, ``RunnerImage.fromInline(text)`` for Dockerfile text, or ``RunnerImage.fromDockerfile(dir)`` for a Dockerfile and build context on disk.
         :param network: How the build and the VMs reach the network.
-        :param runner_set_id: Identifier for the runner set this image belongs to. It is combined with the first 8 hex characters of the image's ``contentHash`` to form the image's name, so a content change publishes a new image and an unchanged one is a no-op. Must match ``^[a-zA-Z0-9-_]+$``, and must be 55 characters or fewer so that ``<runnerSetId>-<8-hex-chars>`` stays within the service's 64-character name limit.
+        :param runner_set_id: Identifier for the runner set this image belongs to, used verbatim as the image's name. It is deliberately stable: the name is the only property whose change forces CloudFormation to replace the image, so holding it still keeps every content change an in-place update that adds a version. A content change is still picked up — the build context is a content-hashed CDK asset, so it moves ``codeArtifact`` — and an unchanged one is still a no-op. Must match ``^[a-zA-Z0-9-_]+$`` and be 64 characters or fewer, the service's name limit.
         :param size: The size the built image runs at, which becomes its memory floor.
         :param base_image_version: Version of the managed ``al2023-1`` base image to build from. Default: '0'
         :param image_logs: Where the build's logs go. Left unset, the build emits no logs; ``ImageLogs.enabled()`` sends them to the platform's group, and ``ImageLogs.enabled(logGroup)`` to a group you supply.
@@ -2326,14 +2341,15 @@ class ImagePipelineProps:
 
     @builtins.property
     def runner_set_id(self) -> builtins.str:
-        '''Identifier for the runner set this image belongs to.
-
-        It is combined with
-        the first 8 hex characters of the image's ``contentHash`` to form the
-        image's name, so a content change publishes a new image and an unchanged
-        one is a no-op. Must match ``^[a-zA-Z0-9-_]+$``, and must be 55 characters
-        or fewer so that ``<runnerSetId>-<8-hex-chars>`` stays within the service's
-        64-character name limit.
+        '''Identifier for the runner set this image belongs to, used verbatim as the image's name.
+
+        It is deliberately stable: the name is the only property
+        whose change forces CloudFormation to replace the image, so holding it
+        still keeps every content change an in-place update that adds a version.
+        A content change is still picked up — the build context is a
+        content-hashed CDK asset, so it moves ``codeArtifact`` — and an unchanged
+        one is still a no-op. Must match ``^[a-zA-Z0-9-_]+$`` and be 64 characters
+        or fewer, the service's name limit.
         '''
         result = self._values.get("runner_set_id")
         assert result is not None, "Required property 'runner_set_id' is missing"

{cdk_github_microvm_runners-0.1.4 → cdk_github_microvm_runners-0.1.6}/src/cdk_github_microvm_runners/_jsii/__init__.py

@@ -19,9 +19,9 @@ import constructs._jsii
 
 __jsii_assembly__ = jsii.JSIIAssembly.load(
     "cdk-github-microvm-runners",
-    "0.1.4",
+    "0.1.6",
     __name__[0:-6],
-    "cdk-github-microvm-runners@0.1.4.jsii.tgz",
+    "cdk-github-microvm-runners@0.1.6.jsii.tgz",
 )
 
 __all__ = [

{cdk_github_microvm_runners-0.1.4 → cdk_github_microvm_runners-0.1.6}/src/cdk_github_microvm_runners/_jsii/bin/cdk-github-microvm-runners

@@ -9,9 +9,9 @@ if "JSII_RUNTIME_PACKAGE_CACHE" not in os.environ:
 
 __jsii_assembly__ = jsii.JSIIAssembly.load(
     "cdk-github-microvm-runners",
-    "0.1.4",
+    "0.1.6",
     "cdk_github_microvm_runners",
-    "cdk-github-microvm-runners@0.1.4.jsii.tgz",
+    "cdk-github-microvm-runners@0.1.6.jsii.tgz",
 )
 
 exit_code = __jsii_assembly__.invokeBinScript(

{cdk_github_microvm_runners-0.1.4 → cdk_github_microvm_runners-0.1.6/src/cdk_github_microvm_runners.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: cdk-github-microvm-runners
-Version: 0.1.4
+Version: 0.1.6
 Summary: CDK construct for running GitHub Actions jobs on AWS Lambda MicroVMs, with one ephemeral runner per job.
 Home-page: https://runnerset.dev
 Author: Court Schuett

{cdk_github_microvm_runners-0.1.4 → cdk_github_microvm_runners-0.1.6}/src/cdk_github_microvm_runners.egg-info/SOURCES.txt

@@ -11,5 +11,5 @@ src/cdk_github_microvm_runners.egg-info/dependency_links.txt
 src/cdk_github_microvm_runners.egg-info/requires.txt
 src/cdk_github_microvm_runners.egg-info/top_level.txt
 src/cdk_github_microvm_runners/_jsii/__init__.py
-src/cdk_github_microvm_runners/_jsii/cdk-github-microvm-runners@0.1.4.jsii.tgz
+src/cdk_github_microvm_runners/_jsii/cdk-github-microvm-runners@0.1.6.jsii.tgz
 src/cdk_github_microvm_runners/_jsii/bin/cdk-github-microvm-runners