v0.8.2.3

Author: bjorg

Docs/articles/CICD.md

@@ -248,15 +248,15 @@ fi
 
 ### Import module artifacts to deployment tier
 
-With the deployment tier upgraded, the previously built modules can now be imported. The following command copies the CloudFormation templates and artifacts produced by the _Build_ phase to the deployment tier bucket. All module dependencies must be imported explicitly when using the `--from-origin` option.
+With the deployment tier upgraded, the previously built modules can now be imported. The following command copies the CloudFormation templates and artifacts produced by the _Build_ phase to the deployment tier bucket. All module dependencies must be imported explicitly when using the `--from-bucket` option.
 
 > NOTE: `lash publish` can import multiple modules at once.
 
 ```bash
 lash publish ${LASH_OPTIONS} \
     --tier ${DEPLOYMENT_TIER} \
     --prompts-as-errors \
-    --from-origin ${BUILD_BUCKET} \
+    --from-bucket ${BUILD_BUCKET} \
     My.Module@${MODULE_ORIGIN}
 ```
 

Docs/articles/ReleaseNotes-Hicetas.md

@@ -4,7 +4,7 @@ description: Release notes for LambdaSharp "Hicetas" (v0.8)
 keywords: release, notes, hicetas
 ---
 
-# LambdaSharp "Hicetas" Release (v0.8.2.2) - 2021-03-17
+# LambdaSharp "Hicetas" Release (v0.8.2.3) - 2021-04-01
 
 > Hicetas was a Greek philosopher of the Pythagorean School. He was born in Syracuse. Like his fellow Pythagorean Ecphantus and the Academic Heraclides Ponticus, he believed that the daily movement of permanent stars was caused by the rotation of the Earth around its axis. When Copernicus referred to Nicetus Syracusanus (Nicetus of Syracuse) in _De revolutionibus orbium coelestium_ as having been cited by Cicero as an ancient who also argued that the Earth moved, it is believed that he was actually referring to Hicetas. [(Wikipedia)](https://en.wikipedia.org/wiki/Hicetas)
 
@@ -141,6 +141,36 @@ Part of this release, _LambdaSharp.Core_ functions were ported to .NET Core 3.1
 
 ## Releases
 
+### (v0.8.2.3) - 2021-04-01
+
+#### Features
+
+* CLI
+  * Added `--from-bucket` as alias for `--from-origin` to make the intent clearer (`--from-origin` is still supported for backwards compatibility).
+
+* Syntax
+  * Added `stack` as a scope keyword to make an item available from a nested stack, but not publicly available for import.
+  * Added `Module::RestApi::CorsOrigin` as a referenceable variable to the module environment.
+
+#### Fixes
+
+* CLI
+  * Fixed an issue where cached module versions were not refreshed when importing a new module to a bucket.
+  * Fixed an issue where `--existing-s3-bucket-name` was not respected when `--quick-start` was used.
+  * Fixed an issue where performance statistics were no longer shown for externally invoked tools.
+  * Fixed an issue where the `$default` WebSocket route could not respond with a custom payload.
+
+* Modules
+  * _LambdaSharp.App.Api_
+    * Use `stack` scope outputs variables instead of `public` scope to prevent them being accidentally imported.
+  * _LambdaSharp.App.Bucket_
+    * Use `stack` scope outputs variables instead of `public` scope to prevent them being accidentally imported.
+  * _LambdaSharp.App.EventBus_
+    * Enforce stricter adherence to protocol with client.
+    * Respond to unknown actions with an error instead of silently ignoring them.
+    * Use `stack` scope outputs variables instead of `public` scope to prevent them being accidentally imported.
+    * Added `WebSocketApiId` as output value so that the WebSocket API can be referenced from the parent stack.
+
 ### (v0.8.2.2) - 2021-03-17
 
 #### BREAKING CHANGES

Docs/articles/Setup.md

@@ -13,7 +13,7 @@ keywords: video, tutorial, getting started, overview, setup, install
 To get started, make sure you have signed-up for an AWS account and downloaded .NET Core.
 
 1. [AWS Account](https://portal.aws.amazon.com/billing/signup#/start)
-1. [.NET Core 3.1+](https://www.microsoft.com/net/download)
+1. [.NET 5+](https://www.microsoft.com/net/download)
 
 **NOTE for MacOS Users:** If you run `zsh` shell (default on MacOS Catalina and later), you must add `dotnet` to your environment path variable manually by adding the following line to your `~/.zshrc` file.
 ```bash

Docs/articles/VideoTutorials.md

@@ -31,3 +31,9 @@ Learn how you can build and deploy your serverless solution in minutes using Lam
 This presentation covers some of the serverless design patterns, such as CQRS (Command and Query Responsibility Separation), CloudFormation stacks, sharing of resources, nested vs. side-by-side composition, and then put it all together with some code samples found at: https://github.com/LambdaSharp/ServerlessPatterns-ServiceComposition
 
 <iframe width="560" height="315" src="https://www.youtube.com/embed/P8o7ZI8XCRg" frameborder="0" allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
+
+## Serverless .NET Patterns: Publishing and Sharing
+
+This presentation dives into the details of how modules are published. It shows how artifacts from the build process are copied to the deployment bucket. As well as how to stage builds for validation, before publishing the approved artifacts. It is a deep-dive into one of the most critical features in LambdaSharp to ensure a safe development process for production environments. Code samples can be found at: https://github.com/LambdaSharp/ServerlessPatterns-PublishingAndSharing
+
+<iframe width="560" height="315" src="https://www.youtube.com/embed/d7J0cyhCZUc" frameborder="0" allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>

Docs/articles/toc.yml

@@ -57,7 +57,7 @@
 - name: Releases
   items:
 
-    - name: Hicetas (v0.8.2.2)
+    - name: Hicetas (v0.8.2.3)
       href: ReleaseNotes-Hicetas.md
 
     - name: Geminus (v0.7.0.17)

Docs/cli/Tool-Deploy.md

@@ -153,10 +153,10 @@ If the argument refers to a module definition, the `deploy` command invokes the
 (optional) Override module build date [yyyyMMddHHmmss]
 </dd>
 
-<dt><code>--from-origin &lt;ORIGIN&gt;</code></dt>
+<dt><code>--from-bucket &lt;BUCKET&gt;</code></dt>
 <dd>
 
-(optional) Use specified origin to import module instead of module origin
+(optional) Use specified S3 bucket to import module from instead of module origin
 </dd>
 
 <dt><code>--force-build</code></dt>

Docs/cli/Tool-Publish.md

@@ -81,10 +81,10 @@ lash new function MyNewFunction
 (optional) Override module build date [yyyyMMddHHmmss]
 </dd>
 
-<dt><code>--from-origin &lt;ORIGIN&gt;</code></dt>
+<dt><code>--from-bucket &lt;BUCKET&gt;</code></dt>
 <dd>
 
-(optional) Use specified origin to import module instead of module origin
+(optional) Use specified S3 bucket to import module from instead of module origin
 </dd>
 
 <dt><code>--force-build</code></dt>

Docs/modules/LambdaSharp-App-Api.md

@@ -209,7 +209,13 @@ The <code>RootPath</code> outputs contains the root path for the app API.
 
 ## REST API
 
-The API key is computed by concatenating the app version identifier with the colon character (i.e. `':'`) and the CloudFormation stack identifier, and then applying a base 64 encoding to the result. When `DevMode` is enabled, the API key only uses the CloudFormation stack identifier.
+The REST API endpoint can be found in the `Url` output value of the nested stack.
+
+### Authentication
+
+The REST API expects a `X-Api-Key` header in the request to validate access to the API.
+
+The API key is computed by concatenating `AppVersionId` with the colon character (i.e. `':'`) and the CloudFormation stack identifier, and then applying a base 64 encoding to the result. When `DevMode` is enabled, the API key only uses the CloudFormation stack identifier.
 
 To compute the effective API key, base 64 decode the `ApiKey` output value and concatenate it to the app version identifier:
 ```javascript