Software sequencing (#181)

Author: danielscholl

.github/workflows/documentation.yml

@@ -1,4 +1,4 @@
-name: Auto - Documentation
+name: Auto - Doc
 
 on:
   # Trigger spell check on pull requests

bicep/modules/aks_cluster.bicep

@@ -336,7 +336,6 @@ var outboundTrafficType = aksOutboundTrafficType=='natGateway' ? ( custom_vnet ?
 
 @description('System Pool presets are derived from the recommended system pool specs')
 var systemPoolPresets = {
-  // 4 vCPU, 16 GiB RAM, 32 GiB Temp Disk, (3600) IOPS, 128 GB Managed OS Disk
   Burstable : {
     vmSize: 'Standard_B2ms'
     minCount: 1
@@ -350,7 +349,6 @@ var systemPoolPresets = {
     osDiskSize: 128
     maxPods: 30
   }
-  // 2 vCPU, 7 GiB RAM, 14 GiB SSD, (8000) IOPS, 128 GB Managed OS Disk
   Standard : {
     vmSize: 'Standard_D2s_v5'
     minCount: 1
@@ -393,10 +391,9 @@ var systemPoolProfile = {
 
 @description('First User Pool presets')
 var userPoolPresets = {
-  // 4 vCPU, 16 GiB RAM, 32 GiB Temp Disk, (3600) IOPS, 128 GB Managed OS Disk
   Burstable : {
     vmSize: 'Standard_B4ms'
-    minCount: 3
+    minCount: 4
     maxCount: 20
     availabilityZones: [
       '1'
@@ -405,12 +402,11 @@ var userPoolPresets = {
     ]
     osDiskType: 'Managed'
     osDiskSize: 128
-    maxPods: 30
+    maxPods: 60
   }
-  // 4 vCPU, 32 GiB RAM, 64 GiB SSD, (8000) IOPS, 128 GB Managed OS Disk
   Standard : {
     vmSize: 'Standard_D4s_v5'
-    minCount: 3
+    minCount: 4
     maxCount: 20
     availabilityZones: [
       '1'
@@ -419,7 +415,7 @@ var userPoolPresets = {
     ]
     osDiskType: 'Managed'
     osDiskSize: 128
-    maxPods: 30
+    maxPods: 60
   }
 }
 

docs/pipelines.md

@@ -6,6 +6,8 @@ A number of CI workflows are leveraged in this repo to test the bicep files to e
 
 It's essential to catch as many problems before a single resource is deployed to real infrastructure. There are a lot of tools and techniques that can be leveraged to catch functional or syntactical problems.
 
+![[1]][1]
+
 #### PSRule for Azure
 
 An interesting project for performing pre/post validation of Azure Resources against the [Well Architected Framework](https://learn.microsoft.com/en-us/azure/architecture/framework/) is [PSRule for Azure](https://azure.github.io/PSRule.Rules.Azure/). Over [200 rules](https://azure.github.io/PSRule.Rules.Azure/en/baselines/Azure.All/) will be evaluated against the Arm template, ranging from Security configuration to naming conventions.
@@ -42,25 +44,28 @@ The fact that a deployment completes successfully is a great sign, however there
 
 In this case we are installing software and we are testing the software is installed.
 
-## Solution actions used in this repo
+## Github Actions
+
+This section outlines the key GitHub Actions implemented in this repository to ensure code quality, automate builds, and streamline releases. These actions form the backbone of the continuous integration and deployment pipeline, enhancing our development workflow and maintaining high standards across our project.
 
-### Infra - Test
+![[0]][0]
+
+#### Infra - Test
 
 This action will run a Validate Step to ensure any changes to bicep is acceptable. It also will trigger a Standards Check that is non blocking in order to determine if the solution passes the PSRule checks.
 
-### Infra - Build
+#### Infra - Build
 
 This action ensures that the bicep can build properly.
 
-### Infra - Release
+#### Infra - Release
 
 The release action will run whenever a release is created to ensure we have a copy of the ARM template from that release that could then be used by other systems as necessary.
 
 <!--- https://diagrams.helpful.dev/ --->
 ```mermaid
 sequenceDiagram
     participant Workflow as "GitHub Workflow"
-
     participant Azure as "Azure/login@v2"
     participant extension1 as "[email protected]"
     participant bashCommand as "bash"
@@ -69,7 +74,6 @@ sequenceDiagram
     participant EndBug as "add-and-commit@v9"
     participant extension3 as "release-action@v1"
 
-
     Workflow->>Workflow: Manual Trigger
     Workflow->>Workflow: Code Checkout
     Workflow->>Azure: Azure Login
@@ -82,9 +86,7 @@ sequenceDiagram
     Workflow->>extension3: Create Release
 ```
 
-## Misc actions used in this repo
-
-### Auto -Documentation Check
+#### Auto - Doc
 
 This action performs two main functions:
 
@@ -94,10 +96,13 @@ This action performs two main functions:
 
 The action is triggered on pull requests that modify markdown files, pushes to the main branch that affect the docs/src directory, and can also be run manually from the Actions tab. This comprehensive approach helps maintain high-quality, current documentation for the project.
 
-### Auto - Greet
+#### Auto - Greet
 
 This is an auto action for a bot to reply to open issues and open pull requests.
 
-### Auto - Label
+#### Auto - Label
 
 This is an auto action for a bot to automatically apply labels based on detection of type of code change.
+
+[0]: src/images/pipeline_1.png "Validation Diagram"
+[1]: src/images/pipeline_2.png "Pipeline Diagram"

docs/src/architecture.md

@@ -7,13 +7,6 @@
     This provides valuable insights into best practices and design
     considerations of azure workloads.
 
-
-**Cost Optimization** - Create a cost-effective solution while balancing security.
-
-**Security** - Enhance security within a development context, adhering to a zero trust model.
-
-**Operational Excellence** - Prioritize standards with automation to ensure efficient operations and robust monitoring.
-
 #### Desired State Configuration
 
 Bicep is a domain-specific language (DSL) for deploying Azure resources declaratively. It simplifies authoring ARM templates and allows you to define the desired state of your Infrastructure as Code (IaC). Azure Resource Manager (ARM) processes the Bicep file to ensure the Azure environment matches the defined desired state, correcting any drift through redeployment.
@@ -103,4 +96,7 @@ A GitOps configuration resides in this Git repository and uses a customized [rep
 
 A GitOps approach simplifies the process of deploying and managing software, making it easier to maintain and update, as well as providing a configurable way of leveraging other software configurations by pointing to alternate repositories hosting other configurations. By leveraging this method, we ensure that our deployments can be extended to things that not only include the default software load.
 
+![[1]][1]
+
 [0]: images/architecture.png "Architecture Diagram"
+[1]: images/architecture_2.png "Gitops Diagram"

docs/src/images/architecture_2.png

@@ -9,6 +9,8 @@ OSDU Developer is an open-source solution designed to enable the creation of lig
 
 The primary goal for this solution is to provide an environment that can help function within an inner loop process providing faster feedback for developers. This personal environment strives to be user-friendly yet maintain compliance with varying organizational standards. It offers a flexible framework to facilitate deeper exploration of OSDU™ capabilities.
 
+![[0]][0]
+
 Deploying personal instances provide valuable insights into early-stage development and integration processes. It emphasizes transparency, cost-efficiency, and flexibility, empowering developers to engage in essential application and cloud development scenarios.
 
 !!! Note
@@ -40,6 +42,8 @@ Several use cases illustrate the practical applications for this approach.
 
 **Training and Onboarding:**  Train new employees on the OSDU™ platform, offering hands-on experience in a controlled environment.
 
+![[1]][1]
+
 
 ## Features
 
@@ -61,3 +65,5 @@ Several use cases illustrate the practical applications for this approach.
 
 Follow the instructions in the "Tutorials" to quickly bring online a personal instance.
 
+[0]: images/overview_1.png "Overview Diagram"
+[1]: images/overview_2.png "Use Cases Diagram"