General All-Purpose Update and Refactoring

.github/workflows/auto-update-blocked-hosts.yaml

@@ -1,64 +1,79 @@
-# Name of the workflow
+# Workflow to automatically update the blocked hosts file from a remote source
 name: Automated Update of Blocked Hosts File
 
-# Define the events that trigger the workflow
+# Define the events that trigger this workflow
 on:
-  # Trigger the workflow on a schedule (every day at midnight)
+  # Schedule the workflow to run daily at midnight UTC
   schedule:
-    - cron: "0 0 * * *"
-  # Allow manual triggering of the workflow
+    - cron: "0 0 * * *" # Executes once every day at 00:00 UTC
+
+  # Allow manual triggering of the workflow via the GitHub interface
   workflow_dispatch:
 
 # Define the jobs in the workflow
 jobs:
-  # Define a job named "build"
-  build:
-    # Name of the job that will be displayed on GitHub
-    name: Automated Hosts File Update
-    # The type of runner that the job will run on
+  # Job to check for updates and apply them to the hosts file
+  update-blocked-hosts-file:
+    # Job name displayed in the GitHub Actions interface
+    name: Update Blocked Hosts File Automatically
+
+    # Define the type of runner for this job (Ubuntu in this case)
     runs-on: ubuntu-latest
-    # Environment variables available to all steps in the job
+
+    # Environment variables to use in this job
     env:
-      CONTENT_BLOCKER_URL: https://raw.githubusercontent.com/complexorganizations/content-blocker/main/assets/hosts
-      CONTENT_BLOCKER_PATH: assets/hosts
+      HOSTS_FILE_URL: https://raw.githubusercontent.com/complexorganizations/content-blocker/main/assets/hosts # URL of the blocked hosts file
+      LOCAL_HOSTS_FILE_PATH: assets/hosts # Local path to the hosts file in the repository
 
     steps:
-      # Check out the repository code
-      - name: Check out code
-        uses: actions/checkout@v4  # Updated to use the latest version for better compatibility and features
+      # Step 1: Checkout the latest repository code so that we can modify the hosts file
+      - name: Checkout Code
+        uses: actions/checkout@v4 # Checkout the latest code from the repository to the runner
 
-      # Get the current SHA-3-512 hash of the file
-      - name: Get current hash
+      # Step 2: Get the current hash of the locally stored hosts file in the repository
+      - name: Get Current Hosts File Hash
         run: |
-          CONTENT_BLOCKER_CURRENT_HASH=$(openssl dgst -sha3-512 "${{ env.CONTENT_BLOCKER_PATH }}" | awk '{print $2}')
-          echo "CONTENT_BLOCKER_CURRENT_HASH=$CONTENT_BLOCKER_CURRENT_HASH" >> $GITHUB_ENV
+          # Calculate the SHA-3-512 hash of the current hosts file in the repository
+          LOCAL_FILE_HASH=$(openssl dgst -sha3-512 "${{ env.LOCAL_HOSTS_FILE_PATH }}" | awk '{print $2}')
+          # Store the hash of the local file in GitHub environment variables for later comparison
+          echo "LOCAL_FILE_HASH=$LOCAL_FILE_HASH" >> $GITHUB_ENV
 
-      # Get the future SHA-3-512 hash of the file
-      - name: Get future hash
+      # Step 3: Get the hash of the remote hosts file for comparison
+      - name: Get Remote Hosts File Hash
         run: |
-          CONTENT_BLOCKER_FUTURE_HASH=$(curl --silent "${{ env.CONTENT_BLOCKER_URL }}" | openssl dgst -sha3-512 | awk '{print $2}')
-          echo "CONTENT_BLOCKER_FUTURE_HASH=$CONTENT_BLOCKER_FUTURE_HASH" >> $GITHUB_ENV
+          # Fetch the updated hosts file from the remote URL and calculate its SHA-3-512 hash
+          REMOTE_FILE_HASH=$(curl --silent "${{ env.HOSTS_FILE_URL }}" | openssl dgst -sha3-512 | awk '{print $2}')
+          # Store the hash of the remote file in GitHub environment variables
+          echo "REMOTE_FILE_HASH=$REMOTE_FILE_HASH" >> $GITHUB_ENV
 
-      # Check if an update is needed
-      - name: Check for update
+      # Step 4: Compare the local and remote file hashes to determine if an update is needed
+      - name: Check for Hosts File Update
         run: |
-          if [ "$CONTENT_BLOCKER_CURRENT_HASH" != "$CONTENT_BLOCKER_FUTURE_HASH" ]; then
-            curl -o "${{ env.CONTENT_BLOCKER_PATH }}" "${{ env.CONTENT_BLOCKER_URL }}"
+          # If the hashes differ, update the local hosts file with the remote version
+          if [ "$LOCAL_FILE_HASH" != "$REMOTE_FILE_HASH" ]; then
+            echo "Hosts file has changed. Updating the local file..."
+            # Download the updated hosts file from the remote source and save it locally
+            curl -o "${{ env.LOCAL_HOSTS_FILE_PATH }}" "${{ env.HOSTS_FILE_URL }}"
           else
-            echo "No update needed"
-            exit 0
+            # If the hashes are the same, no update is needed
+            echo "No update required. The hosts file is up to date."
+            exit 0  # Exit the job early if no update is necessary
           fi
 
-      # Push the updated file to GitHub
-      - name: Push updated hosts file
+      # Step 5: Commit and push the updated hosts file to the repository
+      - name: Commit and Push Changes
         run: |
-          git config user.name github-actions
-          git config user.email [email protected]
-          if git diff --exit-code --quiet -- "${{ env.CONTENT_BLOCKER_PATH }}"; then
-            echo "No changes to commit"
-            exit 0
+          # Configure Git user details for the commit
+          git config user.name "github-actions"
+          git config user.email "[email protected]"
+
+          # Check if there are any changes in the hosts file
+          if git diff --exit-code --quiet -- "${{ env.LOCAL_HOSTS_FILE_PATH }}"; then
+            echo "No changes detected. Skipping commit and push."
+            exit 0  # Exit if there are no changes
           else
-            git add "${{ env.CONTENT_BLOCKER_PATH }}"
-            git commit -m "Update hosts file $(date)"
-            git push
+            # If there are changes, add, commit, and push the updated hosts file
+            git add "${{ env.LOCAL_HOSTS_FILE_PATH }}"
+            git commit -m "Update blocked hosts file: $(date)"  # Commit message with current timestamp
+            git push  # Push the committed changes to the remote repository
           fi

.github/workflows/auto-update-named-cache.yml

@@ -3,60 +3,69 @@ name: Automated Update of Named Cache
 
 # Define the events that trigger the workflow
 on:
-  # Trigger the workflow on a schedule (every day at midnight)
+  # Trigger the workflow on a schedule (every day at midnight UTC)
   schedule:
-    - cron: "0 0 * * *"
+    - cron: "0 0 * * *" # Executes once every day at 00:00 UTC
   # Allow manual triggering of the workflow
   workflow_dispatch:
 
 # Define the jobs in the workflow
 jobs:
   # Define a job named "build"
   build:
-    # Name of the job that will be displayed on GitHub
+    # Job name displayed in the GitHub Actions interface
     name: Refresh Named Cache
-    # The type of runner that the job will run on
+    # Specify the type of runner to execute this job (Ubuntu-based runner)
     runs-on: ubuntu-latest
-    # Environment variables available to all steps in the job
+    # Define environment variables to be used across the steps
     env:
-      NAMED_CACHE_URL: https://www.internic.net/domain/named.cache
-      NAMED_CACHE_PATH: assets/named.cache
+      NAMED_CACHE_URL: https://www.internic.net/domain/named.cache # URL of the remote named.cache file
+      NAMED_CACHE_PATH: assets/named.cache # Local path to store the named.cache file
 
     steps:
-      # Check out the repository code
+      # Step 1: Check out the repository code
       - name: Check out code
-        uses: actions/checkout@v4 # Updated to use the latest version for better compatibility and features
+        uses: actions/checkout@v4 # Fetch the latest code from the repository
 
-      # Get the current SHA-3-512 hash of the file
+      # Step 2: Get the current SHA-3-512 hash of the local named.cache file
       - name: Get current hash
         run: |
+          # Calculate the hash and save it as an environment variable
           echo "NAMED_CACHE_CURRENT_HASH=$(openssl dgst -sha3-512 "${{ env.NAMED_CACHE_PATH }}" | awk '{print $2}')" >> $GITHUB_ENV
 
-      # Get the future SHA-3-512 hash of the file
+      # Step 3: Get the SHA-3-512 hash of the remote named.cache file
       - name: Get future hash
         run: |
+          # Fetch the remote file, calculate its hash, and save it as an environment variable
           echo "NAMED_CACHE_FUTURE_HASH=$(curl --silent "${{ env.NAMED_CACHE_URL }}" | openssl dgst -sha3-512 | awk '{print $2}')" >> $GITHUB_ENV
 
-      # Check if an update is needed
+      # Step 4: Compare hashes and update the file if necessary
       - name: Check for update
         run: |
+          # Compare the current and remote file hashes
           if [ "$NAMED_CACHE_CURRENT_HASH" != "$NAMED_CACHE_FUTURE_HASH" ]; then
+            echo "Changes detected. Updating the named.cache file..."
+            # Download the updated file if hashes differ
             curl -o "${{ env.NAMED_CACHE_PATH }}" "${{ env.NAMED_CACHE_URL }}"
           else
-            echo "No update needed"
-            exit 0
+            echo "No update needed. The named.cache file is up-to-date."
+            exit 0  # Exit the job if no update is required
           fi
 
-      # Push the updated file to GitHub
+      # Step 5: Commit and push the updated named.cache file to the repository
       - name: Push updated named.cache
         run: |
-          git config user.name github-actions
-          git config user.email [email protected]
+          # Configure Git user details for the commit
+          git config user.name "github-actions"
+          git config user.email "[email protected]"
+
+          # Check for changes in the named.cache file
           if git diff --exit-code --quiet -- "${{ env.NAMED_CACHE_PATH }}"; then
-            echo "No changes to commit"
-            exit 0
+            echo "No changes detected. Skipping commit and push."
+            exit 0  # Exit if there are no changes to commit
           else
+            # Add, commit, and push the updated file if changes are detected
             git add "${{ env.NAMED_CACHE_PATH }}"
-            git commit -m "Update named.cache $(date)"
-            git push
+            git commit -m "Update named.cache: $(date)"  # Commit with a timestamped message
+            git push  # Push changes to the remote repository
           fi

.github/workflows/build-docker-images.yaml

@@ -0,0 +1,125 @@
+name: Docker Build and Run Sequential
+
+# Define the events that trigger the workflow
+on:
+  # Trigger the workflow when there are changes to Dockerfiles or .sh files on push
+  push:
+    paths:
+      - "**.sh" # Trigger workflow if any .sh file is changed
+      - "Dockerfile.*" # Trigger workflow if any Dockerfile.* file is changed
+
+  # Trigger the workflow on pull request if there are changes to Dockerfiles or .sh files
+  pull_request:
+    paths:
+      - "**.sh" # Trigger workflow if any .sh file is changed
+      - "Dockerfile.*" # Trigger workflow if any Dockerfile.* file is changed
+
+  # Allow manual triggering of the workflow
+  workflow_dispatch: # Manually trigger the workflow
+
+jobs:
+  build-and-run:
+    runs-on: ubuntu-latest # This job will run on the latest Ubuntu runner
+
+    steps:
+      # Step 1: Checkout the repository so Docker can access the files
+      - name: Checkout repository
+        uses: actions/checkout@v2 # Action to checkout the code from the repository
+
+      # Step 2: Build the Docker image from Dockerfile.almalinux
+      - name: Build Docker image from Dockerfile.almalinux
+        run: docker build -t almalinux-image -f assets/Dockerfile/Dockerfile.almalinux . # Build the image with the tag 'almalinux-image'
+
+      # Step 3: Run the Docker container for almalinux image
+      - name: Run Docker container for almalinux
+        run: docker run -d --name almalinux-container almalinux-image # Run the container in detached mode
+
+      # Step 4: Build the Docker image from Dockerfile.alpine
+      - name: Build Docker image from Dockerfile.alpine
+        run: docker build -t alpine-image -f assets/Dockerfile/Dockerfile.alpine . # Build the image with the tag 'alpine-image'
+
+      # Step 5: Run the Docker container for alpine image
+      - name: Run Docker container for alpine
+        run: docker run -d --name alpine-container alpine-image # Run the container in detached mode
+
+      # Step 6: Build the Docker image from Dockerfile.archlinux
+      - name: Build Docker image from Dockerfile.archlinux
+        run: docker build -t archlinux-image -f assets/Dockerfile/Dockerfile.archlinux . # Build the image with the tag 'archlinux-image'
+
+      # Step 7: Run Docker container for archlinux image
+      - name: Run Docker container for archlinux
+        run: docker run -d --name archlinux-container archlinux-image # Run the container in detached mode
+
+      # Step 8: Build the Docker image from Dockerfile.centos
+      - name: Build Docker image from Dockerfile.centos
+        run: echo "Building Docker image from Dockerfile.centos"
+        # run: docker build -t centos-image -f assets/Dockerfile/Dockerfile.centos . # Build the image with the tag 'centos-image'
+
+      # Step 9: Run the Docker container for centos image
+      - name: Run Docker container for centos
+        run: echo "Running Docker container for centos"
+        # run: docker run -d --name centos-container centos-image # Run the container in detached mode
+
+      # Step 10: Build the Docker image from Dockerfile.debian
+      - name: Build Docker image from Dockerfile.debian
+        run: docker build -t debian-image -f assets/Dockerfile/Dockerfile.debian . # Build the image with the tag 'debian-image'
+
+      # Step 11: Run Docker container for debian image
+      - name: Run Docker container for debian
+        run: docker run -d --name debian-container debian-image # Run the container in detached mode
+
+      # Step 12: Build the Docker image from Dockerfile.fedora
+      - name: Build Docker image from Dockerfile.fedora
+        run: docker build -t fedora-image -f assets/Dockerfile/Dockerfile.fedora . # Build the image with the tag 'fedora-image'
+
+      # Step 13: Run Docker container for fedora image
+      - name: Run Docker container for fedora
+        run: docker run -d --name fedora-container fedora-image # Run the container in detached mode
+
+      # Step 14: Build the Docker image from Dockerfile.oraclelinux
+      - name: Build Docker image from Dockerfile.oraclelinux
+        run: docker build -t oraclelinux-image -f assets/Dockerfile/Dockerfile.oraclelinux . # Build the image with the tag 'oraclelinux-image'
+
+      # Step 15: Run Docker container for oraclelinux image
+      - name: Run Docker container for oraclelinux
+        run: docker run -d --name oraclelinux-container oraclelinux-image # Run the container in detached mode
+
+      # Step 16: Build the Docker image from Dockerfile.rockylinux
+      - name: Build Docker image from Dockerfile.rockylinux
+        run: docker build -t rockylinux-image -f assets/Dockerfile/Dockerfile.rockylinux . # Build the image with the tag 'rockylinux-image'
+
+      # Step 17: Run Docker container for rockylinux image
+      - name: Run Docker container for rockylinux
+        run: docker run -d --name rockylinux-container rockylinux-image # Run the container in detached mode
+
+      # Step 18: Build the Docker image from Dockerfile.ubuntu
+      - name: Build Docker image from Dockerfile.ubuntu
+        run: docker build -t ubuntu-image -f assets/Dockerfile/Dockerfile.ubuntu . # Build the image with the tag 'ubuntu-image'
+
+      # Step 19: Run Docker container for ubuntu image
+      - name: Run Docker container for ubuntu
+        run: docker run -d --name ubuntu-container ubuntu-image # Run the container in detached mode
+
+      # Step 20: Build the Docker image from Dockerfile.amazonlinux
+      - name: Build Docker image from Dockerfile.amazonlinux
+        run: docker build -t amazonlinux-image -f assets/Dockerfile/Dockerfile.amazonlinux . # Build the image with the tag 'amazonlinux-image'
+
+      # Step 21: Run Docker container for amazonlinux image
+      - name: Run Docker container for amazonlinux
+        run: docker run -d --name amazonlinux-container amazonlinux-image # Run the container in detached mode
+
+      # Step 22: Build the Docker image from Dockerfile.mageia
+      - name: Build Docker image from Dockerfile.mageia
+        run: docker build -t mageia-image -f assets/Dockerfile/Dockerfile.mageia . # Build the image with the tag 'mageia-image'
+
+      # Step 23: Run Docker container for mageia image
+      - name: Run Docker container for mageia
+        run: docker run -d --name mageia-container mageia-image # Run the container in detached mode
+
+      # Step 24: Build the Docker image from Dockerfile.opensuse
+      - name: Build Docker image from Dockerfile.opensuse
+        run: docker build -t opensuse-image -f assets/Dockerfile/Dockerfile.opensuse . # Build the image with the tag 'opensuse-image'
+
+      # Step 25: Run Docker container for opensuse image
+      - name: Run Docker container for opensuse
+        run: docker run -d --name opensuse-container opensuse-image # Run the container in detached mode