FluentDocker v3.0.0

.github/workflows/ci.yml

@@ -5,7 +5,7 @@ on:
     branches:
       - master
       - main
-      - ci-gh-action-migration  # For testing GitHub Action Workflows
+      - fdv3
   pull_request:
 
 jobs:
@@ -23,7 +23,7 @@ jobs:
           else
             echo "running_in_act=false" >> $GITHUB_OUTPUT
           fi
-      
+
       - name: Echo environment
         run: |
           echo "Running in act environment: ${{ steps.detect-env.outputs.running_in_act }}"
@@ -37,15 +37,14 @@ jobs:
         uses: actions/setup-dotnet@v4
         with:
           dotnet-version: |
-            6.0.x
             8.0.x
-            9.0.x
+            10.0.x
 
       - name: Install GitVersion
         uses: gittools/actions/gitversion/setup@v1
         with:
           versionSpec: '5.x'
-      
+
       - name: Determine version
         id: gitversion
         uses: gittools/actions/gitversion/execute@v1
@@ -80,60 +79,24 @@ jobs:
             --filter "TestCategory=CI" \
             --logger "console;verbosity=detailed"
 
-      - name: Run tests (in GitHub)
+      - name: Run tests with coverage (in GitHub)
         if: steps.detect-env.outputs.running_in_act != 'true'
         run: >
-          dotnet test 
-          --no-build 
-          --configuration Release 
+          dotnet test
+          --no-build
+          --configuration Release
           --framework net8.0
           --filter "TestCategory=CI"
-          --collect:"XPlat Code Coverage" 
+          --collect:"XPlat Code Coverage"
           --results-directory ./coverage
           --settings coverletArgs.runsettings
 
-      - name: Detect branch for SonarCloud
-        id: detect-branch
-        run: |
-          if [ "${{ steps.detect-env.outputs.running_in_act }}" == "true" ]; then
-            # Use git to determine branch name when running in act
-            BRANCH_NAME=$(git rev-parse --abbrev-ref HEAD)
-            echo "Using git to determine branch: $BRANCH_NAME"
-            echo "branch=$BRANCH_NAME" >> $GITHUB_OUTPUT
-          else
-            # In GitHub Actions, we can use GitHub's environment variables
-            echo "Using GitHub environment for branch info"
-            echo "branch=$GITHUB_REF_NAME" >> $GITHUB_OUTPUT
-          fi
-
-      # Prepare environment variables for SonarCloud
-      - name: Setup SonarCloud environment variables
-        id: sonar-env
-        run: |
-          # Ensure the token is available regardless of environment
-          if [ "${{ steps.detect-env.outputs.running_in_act }}" == "true" ] && [ -n "$SONAR_TOKEN" ]; then
-            echo "Using SONAR_TOKEN from environment file"
-            echo "token=$SONAR_TOKEN" >> $GITHUB_OUTPUT
-          else
-            echo "Using SONAR_TOKEN from GitHub secrets"
-            echo "token=${{ secrets.SONAR_TOKEN }}" >> $GITHUB_OUTPUT
-          fi
-
-      # Single SonarCloud scan step for both environments
-      - name: SonarCloud Scan
-        uses: SonarSource/sonarqube-scan-action@master
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-          SONAR_TOKEN: ${{ steps.sonar-env.outputs.token }}
+      - name: Upload coverage reports to Codecov
+        if: steps.detect-env.outputs.running_in_act != 'true'
+        uses: codecov/codecov-action@v5
         with:
-          args: >
-            -Dsonar.projectKey=mariotoffia_FluentDocker
-            -Dsonar.organization=mariotoffia
-            -Dsonar.cs.opencover.reportsPaths=./coverage/**/coverage.opencover.xml
-            -Dsonar.coverage.exclusions=**Tests*.cs
-            -Dsonar.branch.name=${{ steps.detect-branch.outputs.branch }}
-            -Dsonar.projectVersion=${{ steps.gitversion.outputs.AssemblySemVer }}
-
+          token: ${{ secrets.CODECOV_TOKEN }}
+
       - name: Create NuGet packages
         run: |
           echo "Creating NuGet packages with version: ${{ steps.gitversion.outputs.NuGetVersion }}"
@@ -143,7 +106,7 @@ jobs:
         run: |
           echo "Created NuGet packages:"
           ls -la packages/*.nupkg
-          
+
       - name: Upload NuGet packages as artifacts
         uses: actions/upload-artifact@v4
         with:
@@ -158,7 +121,7 @@ jobs:
           echo "Publishing NuGet packages with version: ${{ steps.gitversion.outputs.NuGetVersion }}"
           dotnet nuget push "packages/*.nupkg" --api-key ${{ secrets.NUGET_API_KEY }} --source https://api.nuget.org/v3/index.json --skip-duplicate
         continue-on-error: ${{ steps.detect-env.outputs.running_in_act == 'true' }}
-        
+
       - name: Create and push Git tag for release
         if: (github.ref == 'refs/heads/master' || github.ref == 'refs/heads/main') && steps.detect-env.outputs.running_in_act != 'true'
         run: |
@@ -168,4 +131,40 @@ jobs:
           git tag ${{ steps.gitversion.outputs.NuGetVersion }}
           git push origin ${{ steps.gitversion.outputs.NuGetVersion }}
         env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+  # CodeQL Security Analysis
+  codeql:
+    name: CodeQL Security Analysis
+    runs-on: ubuntu-latest
+    if: github.event_name == 'pull_request' || github.ref == 'refs/heads/master' || github.ref == 'refs/heads/main'
+    permissions:
+      security-events: write
+      actions: read
+      contents: read
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Initialize CodeQL
+        uses: github/codeql-action/init@v3
+        with:
+          languages: csharp
+          queries: +security-and-quality
+
+      - name: Setup .NET
+        uses: actions/setup-dotnet@v4
+        with:
+          dotnet-version: |
+            8.0.x
+            10.0.x
+
+      - name: Build for CodeQL
+        run: |
+          dotnet restore
+          dotnet build --configuration Release
+
+      - name: Perform CodeQL Analysis
+        uses: github/codeql-action/analyze@v3
+        with:
+          category: "/language:csharp"

.github/workflows/pages.yml

@@ -0,0 +1,62 @@
+name: Deploy Documentation to GitHub Pages
+
+on:
+  push:
+    branches:
+      - master
+      - main
+    paths:
+      - 'docs/**'
+      - '.github/workflows/pages.yml'
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: "pages"
+  cancel-in-progress: false
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: '3.2'
+          bundler-cache: true
+          working-directory: docs
+
+      - name: Setup Pages
+        id: pages
+        uses: actions/configure-pages@v4
+
+      - name: Build with Jekyll
+        run: |
+          cd docs
+          bundle install
+          bundle exec jekyll build --baseurl "${{ steps.pages.outputs.base_path }}"
+        env:
+          JEKYLL_ENV: production
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: docs/_site
+
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    needs: build
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

.gitignore

@@ -224,4 +224,5 @@ _Pvt_Extensions/
 ModelManifest.xml
 
 # JetBrains IDEs
-.idea
+.idea
+.claude

.vscode/settings.json

@@ -19,5 +19,9 @@
     "dotnet-test-explorer.runInParallel": false,
     "dotnet-test-explorer.treeMode": "full",
     "dotnet.completion.showCompletionItemsFromUnimportedNamespaces": true,
-    "dotnet.formatting.organizeImportsOnFormat": true
+    "dotnet.formatting.organizeImportsOnFormat": true,
+    "chat.tools.terminal.autoApprove": {
+        "dotnet test": true,
+        "dotnet build": true
+    }
 }