Merge branch 'main' into docs

Author: corradodebari

.github/workflows/documentation.yml

@@ -1,13 +1,14 @@
 # Workflow for deploying static documentation
-name: Deploy Documentation to Pages
+name: Deploy Documentation/Helm to Pages
 
 on:
   push:
     branches:
       - main
-    # Limit runs to only when docs change
+    # Limit runs to only when docs/helm change
     paths:
-      - 'docs/**'
+      - "docs/**"
+      - "helm/**"
 
   # Allows running this workflow manually
   workflow_dispatch:
@@ -34,28 +35,36 @@ jobs:
   build:
     runs-on: ubuntu-latest
     env:
-      HUGO_VERSION: 0.134.1
+      HUGO_VERSION: 0.145.0
     steps:
       - name: Install Hugo CLI
         run: |
           wget -O ${{ runner.temp }}/hugo.deb https://github.com/gohugoio/hugo/releases/download/v${HUGO_VERSION}/hugo_extended_${HUGO_VERSION}_linux-amd64.deb \
-          && sudo dpkg -i ${{ runner.temp }}/hugo.deb          
+          && sudo dpkg -i ${{ runner.temp }}/hugo.deb
+
       - name: Install Dart Sass
         run: sudo snap install dart-sass
+
       - name: Checkout
         uses: actions/checkout@v4
         with:
           submodules: recursive
           fetch-depth: 0
+
       - name: Download Hugo Theme
         run: |
           mkdir -p docs/themes/relearn \
-          && wget -qO- $(curl -s https://api.github.com/repos/McShelby/hugo-theme-relearn/releases/latest | grep "tarball_url" | awk -F'"' '{print $4}') | tar --exclude='*/exampleSite' -xz -C docs/themes/relearn --strip-components=1
+          && curl -L $(curl -s https://api.github.com/repos/McShelby/hugo-theme-relearn/releases/latest \
+          | grep "tarball_url" | cut -d '"' -f 4) \
+          | tar -xz -C docs/themes/relearn --strip-components=1 --exclude='*/exampleSite'
+
       - name: Setup Pages
         id: pages
         uses: actions/configure-pages@v5
+
       - name: Install Node.js dependencies
         run: "[[ -f package-lock.json || -f npm-shrinkwrap.json ]] && npm ci || true"
+
       - name: Build with Hugo
         env:
           HUGO_CACHEDIR: ${{ runner.temp }}/hugo_cache
@@ -66,7 +75,14 @@ jobs:
             --gc \
             --minify \
             --source docs \
-            --baseURL "${{ steps.pages.outputs.base_url }}/"          
+            --baseURL "${{ steps.pages.outputs.base_url }}/"
+
+      - name: Package Helm chart
+        run: |
+          mkdir -p docs/public/helm
+          helm package helm -d docs/public/helm
+          helm repo index docs/public/helm --url "${{ steps.pages.outputs.base_url }}/helm"
+
       - name: Upload artifact
         uses: actions/upload-pages-artifact@v3
         with:

.github/workflows/pytest.yml

@@ -0,0 +1,59 @@
+# Workflow for running tests on server code
+name: Test Suite
+
+on:
+  pull_request:
+    types:
+      - opened
+      - synchronize
+      - reopened
+      - ready_for_review
+
+  # Allows running this workflow manually
+  workflow_dispatch:
+
+jobs:
+  check:
+    if: github.event.pull_request.draft == false
+    runs-on: ubuntu-latest
+    services:
+      docker:
+        image: docker:latest
+        options: --privileged
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 2
+
+      - uses: docker/setup-buildx-action@v3
+        with:
+          version: latest
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Cache dependencies
+        uses: actions/cache@v4
+        with:
+          path: |
+            ~/.cache/pip
+            src/.tox
+          key: ${{ runner.os }}-pip-${{ hashFiles('src/pyproject.toml') }}
+          restore-keys: |
+            ${{ runner.os }}-pip-
+
+      - name: Install dependencies
+        run: |
+          cd src/
+          python -m pip install --upgrade pip wheel setuptools
+          pip install torch==2.7.0+cpu -f https://download.pytorch.org/whl/cpu/torch
+          pip install -e ".[all-test]"
+
+      - name: Run All Tests
+        run: pytest
+
+    # Block merging if the job fails
+    permissions:
+      pull-requests: write

.github/workflows/releases.yml

@@ -0,0 +1,39 @@
+name: Build Release
+on:
+  release:
+    types: [published]
+
+env:
+  IAC: ${GITHUB_REPOSITORY#${GITHUB_REPOSITORY_OWNER}/}-stack.zip
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      packages: write
+      id-token: write
+
+    steps:
+      - name: Output Environment
+        run: |
+          echo "IaC: ${{ env.IAC }}"
+      
+      - name: Validate Tag Name
+        run: |
+          if [[ ! $GITHUB_REF_NAME =~ ^v[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}$ ]]; then
+            echo "Invalid tag name format. Must be in the format vMAJOR.MINOR.PATCH"
+            exit 1
+          fi
+
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Build and Push Infrastructure as Code
+        run: |
+          cd opentofu
+          zip -r ${{ env.IAC }} . -x "terraform*" ".terraform*" "*/terraform*" "*/.terraform*" "generated/*"
+          gh release upload ${{github.event.release.tag_name}} ${{ env.IAC }} --clobber
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        shell: bash

.gitignore

@@ -1,46 +1,66 @@
-## Copyright (c) 2023, 2024, Oracle and/or its affiliates.
-## Licensed under the Universal Permissive License v1.0 as shown at http://oss.oracle.com/licenses/upl.
-##############################################################################
-# Developer Custom
-##############################################################################
-assets/docos/samples/oracle-ai-vector-search-users-guide-qa.jsonl
-assets/docos/oracle-ai-vector-search-users-guide.pdf
-
+# spell-checker: disable
 ##############################################################################
 # Project/User Specific
 ##############################################################################
+**/*.log
+**/*.zip
 **/requirements.txt
-!app/requirements.txt
-app/THIRD_PARTY_LICENSES.txt
-rag/**
+**/THIRD_PARTY_LICENSES.txt
 sbin/**
-helm/values.yaml
 **/*.bak
+**/tmp/**
+**/temp/**
+**/chatbot_graph.png
+**/*.sh
+!opentofu/**/cloudinit-oke.sh
+!src/entrypoint.sh
+!src/client/spring_ai/templates/env.sh
+tests/db_startup_temp/**
 
 ##############################################################################
-# Enviroment (PyVen, IDE, etc.)
+# Environment (PyVen, IDE, etc.)
 ##############################################################################
 **/.venv
 **/.vscode
 **/.DS_Store
 **/*.swp
 **/.scannerwork
+**/.cursorignore
+**/tns_admin
 sonar-project.properties
 
 ##############################################################################
 # Python
 ##############################################################################
 __pycache__/
+.pytest_cache
 *.py[cod]
 *$py.class
-spring_ai/src/main/resources/data/sandbox_settings.json
+*/*.egg-info
+**/build/
+
+##############################################################################
+# IaC
+##############################################################################
+**/**.tfvars
+**/.terraform*
+**/terraform.tfstate*
+**/*.pem
+opentofu/**/generated/*.*
+opentofu/**/generated/kubeconfig
+
+##############################################################################
+# Helm
+##############################################################################
+helm/values*.yaml
+!helm/values.yaml
+
+##############################################################################
+# Random
+##############################################################################
+spring_ai/src/main/resources/data/optimizer_settings.json
 spring_ai/target/**
 spring_ai/create_user.sql
 spring_ai/drop.sql
-start.sh
-spring_ai/env.sh
-temp/rag_agent.ipynb
-temp/tools.ipynb
-temp/tools.py
-temp/json-dual.sql
-env.sh
+src/client/spring_ai/target/classes/*
+api_server_key