Merge pull request #2 from ProfessionalLinuxUsersGroup/add-github-action

feat: Add GH action workflow and unit index

Author: kolkhis

.github/workflows/mdbook.yml

@@ -0,0 +1,94 @@
+# Sample workflow for building and deploying a mdBook site to GitHub Pages
+#
+# To get started with mdBook see: https://rust-lang.github.io/mdBook/index.html
+#
+name: Deploy mdBook site to Pages
+
+on:
+  # Runs on pushes targeting the default branch
+  push:
+    branches: ["main"]
+
+  # Allows you to run this workflow manually from the Actions tab
+  workflow_dispatch:
+
+# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+# Allow only one concurrent deployment, skipping runs queued between the run in-progress and latest queued.
+# However, do NOT cancel in-progress runs as we want to allow these production deployments to complete.
+concurrency:
+  group: "pages"
+  cancel-in-progress: false
+
+jobs:
+  # Build job
+  build:
+    runs-on: ubuntu-latest
+    env:
+      MDBOOK_VERSION: 0.4.45
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Dynamically generate resources.md file
+        run: ./scripts/generate_resources.sh
+
+      # Install rust with GitHub's 'setup-rs' action (most recent stable version)
+      - name: Install Rust
+        uses: actions-rs/toolchain@v1
+        with:
+          toolchain: stable  # Or specify a version
+          override: true     # ensure this version is used globally in the workflow
+          components: cargo
+
+      # Cache rust crates (mdbook dependencies) so reinstalls don't take long
+      - name: Cache the cargo registry and build artifacts
+        uses: actions/cache@v3
+        with:
+          path: |
+            ~/.cargo/registry
+            ~/.cargo/git
+            target
+          key: cargo-${{ runner.os }}-${{ hashFiles('**/Cargo.lock') }}
+          restore-keys: cargo-${{ runner.os }}-
+
+      # Cache the mdbook binary so we don't need to install it every time
+      - name: Cache mdbook binary
+        id: cache-mdbook
+        uses: actions/cache@v3
+        with:
+          path: ~/.cargo/bin/mdbook
+          key: mdbook-${{ runner.os }}-${{ env.MDBOOK_VERSION }}
+          restore-keys: mdbook-${{ runner.os }}-
+
+      # Install mdbook if it's not cached
+      - name: Install mdBook
+        if: steps.cache-mdbook.outputs.cache-hit != 'true'
+        run: cargo install --version ${MDBOOK_VERSION} mdbook --force
+
+      - name: Setup Pages
+        id: pages
+        uses: actions/configure-pages@v5
+
+      - name: Build with mdBook
+        run: mdbook build
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: ./book
+
+  # Deployment job
+  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

src/unitindex.md

@@ -0,0 +1,25 @@
+<div class="flex-container" style="justify-content:center;">
+        <img src="https://github.com/ProfessionalLinuxUsersGroup/img/blob/main/Assets/Logos/ProLUG_Round_Transparent_LOGO.png?raw=true" width="64" height="64"></img>
+    <p>
+        <h1>Table of Contents</h1>
+    </p>
+</div>
+
+| Unit |                                                 Topic                                                 |
+| :--: | :---------------------------------------------------------------------------------------------------: |
+|  1   |   [Automation tools installation and execution]()    |
+|  2   |   [Interacting with the Operating system]()   |
+|  3   | [Making and using inventories]()  |
+|  4   |      [Admin commands and one-offs]()      |
+|  5   |  [Environment and Local Variables in systems]()  |
+|  6   |     [Automating Docker Builds]()     |
+|  7   |       [Automating Docker environments]()       |
+|  8   | [Automating K8s environments]() |
+|  9   |     [Build and Deploy Linux systems]()     |
+|  10  |      [Harden Linux systems]()       |
+|  11  |      [Update and patch systems]()       |
+|  12  |      [Configure Network Devices]()       |
+|  13  |      [Remediating and Reporting on Drift]()       |
+|  14  |      [CI/CD Pipelines and Make v. Buy v. Adopt Decisions]()       |
+|  15  |      [Troubleshooting/Testing 1]()       |
+|  16  |      [Troubleshooting/Testing 2]()       |