fixes #76 - adds support for CodeBuild projects using GitHub Action r…

…unners

.vscode/settings.json

@@ -16,6 +16,7 @@
     "cSpell.enabled": true,
     "cSpell.words": [
         "Allman",
+        "amazonlinux",
         "APACHELICENSE",
         "Aperta",
         "appveyor",

docs/CHANGELOG.md

@@ -5,32 +5,34 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [2.9.0]
+## [2.10.0]
 
 - Catesta template module changes
     - CI/CD Changes:
-        - AWS:
+        - GitHub Actions with CodeBuild (***new***):
+            - Added support for new CI/CD option which leverages GitHub Actions that run on AWS CodeBuild. This option generates both GitHub Action workflows as well as CFN templates for deployment to AWS for creating CodeBuild projects that integrate with the actions of your GitHub project.
+        - AWS CodeBuild:
             - GitLab added as a supported source for CodeBuild projects
             - Each CodeBuild project now has its own `AWS::Logs::LogGroup` created with a configurable retention policy.
             - Minor changes to formatting in CFNs to satisfy new `cfn-lint` requirements.
             - Windows CodeBuild project containers upgraded to latest image:
                 - `aws/codebuild/windows-base:2019-2.0` to `aws/codebuild/windows-base:2019-3.0`
-            - Linux CodeBuild project containers upgraded to latest images:
-                - Previously hard set to: `aws/codebuild/standard:7.0`
-                - Linux CodeBuild project image now parameterized and supports either:
-                    - `aws/codebuild/standard:7.0` (default)
-                    - `aws/codebuild/amazonlinux2-x86_64-standard:5.0`
+            - Linux CodeBuild project image now parameterized (Previously hard set to: `aws/codebuild/standard:7.0`) and supports either:
+                - `aws/codebuild/standard:7.0` (default)
+                - `aws/codebuild/amazonlinux2-x86_64-standard:5.0`
             - Updated CodeCommit based builds Lambda triggers from `python3.9` to `python3.12` runtime.
             - Buildspec updates:
                 - `buildspec_pwsh_linux.yml` updated to dot net 8.
                 - `buildspec_pwsh_windows.yml` updated to dot net 8.
             - AWS.Tools.Common bumped from `4.1.133` to `4.1.572`
-        - GitHub:
+        - GitHub Actions:
             - Workflow actions now include the module name in the action name
         - InvokeBuild bumped from `5.10.5` to `5.11.1`
         - PSScriptAnalyzer bumped from `1.21.0` to `1.22.0`
 - Catesta primary module changes
-    - Added additional tests for new AWS changes
+    - Added additional tests for:
+        - new AWS changes
+        - new GitHub Actions with Codebuild capabilities
     - InvokeBuild bumped from `5.10.5` to `5.11.1`
     - PSScriptAnalyzer bumped from `1.21.0` to `1.22.0`
     - Documentation updates

docs/Catesta-Basics.md

@@ -37,6 +37,7 @@ New-VaultProject -DestinationPath $outPutPath
     * [M] Module Only
     * [G] GitHub Actions
     * [C] AWS CodeBuild
+    * [S] GitHub Actions on AWS CodeBuild
     * [P] Appveyor
     * [L] GitLab CI/CD
     * [B] BitBucket Pipelines
@@ -70,6 +71,7 @@ The options listed in the prompt represent the different CI/CD tools that Catest
 [M] Module Only
 [G] GitHub Actions
 [C] AWS CodeBuild
+[S] GitHub Actions on AWS CodeBuild
 [P] Appveyor
 [L] GitLab CI/CD
 [B] BitBucket Pipelines
@@ -84,11 +86,13 @@ It's important to note that the choice you make here will impact the setup and c
 
 If you need help with the options or are unsure which to choose, you can review additional Catesta documentation that covers the process of each CI/CD integration in depth:
 
-* [Catesta - AWS Doc](catesta_cicd/Catesta-AWS.md)
 * [Catesta - GitHub Actions Doc](catesta_cicd/Catesta-GHActions.md)
-* [Catesta - Azure Pipelines Doc](catesta_cicd/Catesta-Azure.md)
-* [Catesta - Bitbucket Doc](catesta_cicd/Catesta-Bitbucket.md)
+* [Catesta - AWS CodeBuild Doc](catesta_cicd/Catesta-AWS.md)
+* [Catesta - GitHub Actions on AWS CodeBuild Doc](catesta_cicd/Catesta-GHActionsAWSCodeBuild.md)
+* [Catesta - AppVeyor Doc](catesta_cicd/Catesta-AppVeyor.md)
 * [Catesta - GitLab Doc](catesta_cicd/Catesta-GitLab.md)
+* [Catesta - Bitbucket Doc](catesta_cicd/Catesta-Bitbucket.md)
+* [Catesta - Azure Pipelines Doc](catesta_cicd/Catesta-Azure.md)
 
 #### Understanding Build Configuration Selection
 

docs/Catesta-ModuleSchema.md

@@ -40,6 +40,8 @@ choices:
     help : CI/CD using GitHub Actions.
     value : CODEBUILD
     help : CI/CD using AWS CodeBuild
+    value : GHACODEBUILD
+    help : CI/CD using GitHub Actions running on AWS CodeBuild.
     value : APPVEYOR
     help : CI/CD using AWS Appveyor
     value : GITLAB
@@ -56,7 +58,7 @@ choices:
     value : windows
     help : Adds a Windows PowerShell based Workflow action.
     value : pwshcore
-    help : Adds a Windows pwsh based pipeline job.
+    help : Adds a Windows pwsh based Workflow action.
     value : linux
     help : Adds a Linux based Workflow action.
     value : macos
@@ -77,6 +79,17 @@ name : S3Bucket
 type : text
 default : PSGallery
 
+name : GitHubACBOptions
+type : multichoice
+condition : $PLASTER_PARAM_CICD -eq 'GHACODEBUILD'
+choices:
+    value : ps
+    help : Adds a Windows PowerShell based Workflow action powered by CodeBuild
+    value : pwshcore
+    help : Adds a Windows pwsh based Workflow action powered by CodeBuild.
+    value : pwsh
+    help : Adds a Linux based Workflow action powered by CodeBuild.
+
 name : AppveyorOptions
 type : multichoice
 condition : $PLASTER_PARAM_CICD -eq 'APPVEYOR'
@@ -236,28 +249,29 @@ The example below showcases all the available options for the `New-ModuleProject
 ```powershell
 $moduleParameters = @{
     
-VAULT           = 'text'
-ModuleName      = 'text'
-Description     = 'text'
-Version         = '0.0.1'
-FN              = 'user full name'
-CICD            = 'GITHUB'
-GitHubAOptions  = 'windows','pwshcore','linux','macos'
-AWSOptions      = 'ps','pwshcore','pwsh'
-AppveyorOptions = 'windows','pwshcore','linux','macos'
-GitLabOptions   = 'windows','pwshcore','linux'
-AzureOptions    = 'windows','pwshcore','linux','macos'
-RepoType        = 'GITHUB'
-License         = 'MIT'
-Changelog       = 'CHANGELOG'
-COC             = 'CONDUCT'
-Contribute      = 'CONTRIBUTING'
-Security        = 'SECURITY'
-ReadtheDocs     = 'READTHEDOCS'
-RTDTheme        = 'READTHEDOCSTHEME'
-CodingStyle     = 'Stroustrup'
-Help            = 'Yes'
-Pester          = '5'
+VAULT            = 'text'
+ModuleName       = 'text'
+Description      = 'text'
+Version          = '0.0.1'
+FN               = 'user full name'
+CICD             = 'GITHUB'
+GitHubAOptions   = 'windows','pwshcore','linux','macos'
+AWSOptions       = 'ps','pwshcore','pwsh'
+GitHubACBOptions = 'ps','pwshcore','pwsh'
+AppveyorOptions  = 'windows','pwshcore','linux','macos'
+GitLabOptions    = 'windows','pwshcore','linux'
+AzureOptions     = 'windows','pwshcore','linux','macos'
+RepoType         = 'GITHUB'
+License          = 'MIT'
+Changelog        = 'CHANGELOG'
+COC              = 'CONDUCT'
+Contribute       = 'CONTRIBUTING'
+Security         = 'SECURITY'
+ReadtheDocs      = 'READTHEDOCS'
+RTDTheme         = 'READTHEDOCSTHEME'
+CodingStyle      = 'Stroustrup'
+Help             = 'Yes'
+Pester           = '5'
 
 
 }

docs/Catesta.md

@@ -2,7 +2,7 @@
 Module Name: Catesta
 Module Guid: 6796b193-9013-468a-b022-837749af2d06
 Download Help Link: NA
-Help Version: 2.9.0
+Help Version: 2.10.0
 Locale: en-US
 ---