Merge from main

Author: pacphi

.env.example

@@ -0,0 +1,65 @@
+# Tanzu GenAI Showcase - Environment Variables
+# This file serves as a template for setting up GitHub repository secrets
+# Use the create-gh-secrets.sh script to create GitHub secrets from your .env file
+
+# ===== Cloud Foundry Authentication =====
+# Required for authenticating with Cloud Foundry during deployment
+CF_PASSWORD=your_cf_password_here                  # Used by all projects for CF authentication with username/password
+CF_SSO_REFRESH_TOKEN=your_sso_refresh_token_here   # Alternative to CF_PASSWORD when using SSO authentication
+
+# ===== Project-Specific API Keys =====
+
+# ----- dotnet-extensions-ai -----
+# Travel Advisor application using .NET and AI extensions
+GOOGLEMAPS_API_KEY=your_key_here                   # Required for location services
+                                                   # Obtain from: https://developers.google.com/maps/documentation/javascript/get-api-key
+
+# ----- go-fiber-langchaingo -----
+# Congress chatbot using Go Fiber and LangChain
+CONGRESS_API_KEY=your_key_here                     # Required for accessing Congress API
+                                                   # Obtain from: https://api.congress.gov/sign-up/
+
+# ----- java-spring-ai-mcp -----
+# Flight tracker application using Spring AI and MCP
+AVIATION_STACK_ACCESS_KEY=your_key_here            # Used by java-spring-ai-mcp/server for flight data
+                                                   # Obtain from: https://aviationstack.com/signup/free
+OPENAI_API_KEY=your_key_here                       # Used by java-spring-ai-mcp/client and other projects
+                                                   # Obtain from: https://platform.openai.com/api-keys
+
+# ----- java-spring-langgraph-mcp-angular -----
+# Event finder application using Spring, LangGraph, and Angular
+TICKETMASTER_API_KEY=your_key_here                 # Required for event data
+                                                   # Obtain from: https://developer.ticketmaster.com/products-and-docs/apis/getting-started/
+CITIES_API_KEY=your_key_here                       # Required for city data
+                                                   # Obtain from: https://api.api-ninjas.com/v1/city
+
+# ----- js-langchain-react -----
+# News aggregator using LangChain and React
+NEWS_API_KEY=your_key_here                         # Required for news data (also used by php-symfony-neuron)
+                                                   # Obtain from: https://newsapi.org/register
+LLM_API_KEY=your_key_here                          # Maps to API_KEY in the application
+                                                   # Use your OpenAI API key or other LLM provider key
+
+# ----- php-symfony-neuron -----
+# Financial advisor using PHP Symfony and Neuron
+STOCK_API_KEY=your_key_here                        # Required for stock market data
+                                                   # Obtain from: https://www.alphavantage.co/support/#api-key
+EDGAR_API_KEY=your_key_here                        # Required for SEC EDGAR database access
+                                                   # Obtain from: https://www.sec.gov/edgar/sec-api-documentation
+LINKEDIN_CLIENT_ID=your_id_here                    # Required for LinkedIn integration
+LINKEDIN_CLIENT_SECRET=your_secret_here            # Required for LinkedIn integration
+                                                   # Obtain both from: https://www.linkedin.com/developers/apps/new
+
+# ----- py-django-crewai -----
+# Movie recommendation chatbot using Django and CrewAI
+DJANGO_SECRET_KEY=your_secret_key_here             # Required for Django security
+                                                   # Generate with: python -c "import secrets; print(secrets.token_urlsafe(50))"
+TMDB_API_KEY=your_key_here                         # Required for movie database access
+                                                   # Obtain from: https://www.themoviedb.org/signup
+SERPAPI_API_KEY=your_key_here                      # Required for web search capabilities
+                                                   # Obtain from: https://serpapi.com/users/sign_up
+
+# ----- ruby-sinatra-fastmcp -----
+# Flight tracking bot using Ruby Sinatra and FastMCP
+AVIATIONSTACK_API_KEY=your_key_here                # Required for flight data
+                                                   # Obtain from: https://aviationstack.com/signup/free

.github/workflows/cf-auth.yml

@@ -0,0 +1,52 @@
+name: Cloud Foundry Authentication
+
+on:
+  workflow_call:
+    inputs:
+      cf_api:
+        required: true
+        type: string
+        description: 'Cloud Foundry API Endpoint'
+      cf_username:
+        required: false
+        type: string
+        description: 'Cloud Foundry Username (not required if using SSO)'
+      use_sso:
+        required: false
+        type: boolean
+        default: false
+        description: 'Whether to use SSO authentication instead of username/password'
+    secrets:
+      CF_PASSWORD:
+        required: false
+        description: 'Cloud Foundry Password (not required if using SSO)'
+      CF_SSO_REFRESH_TOKEN:
+        required: false
+        description: 'Cloud Foundry SSO Refresh Token (not required if using username/password)'
+
+jobs:
+  authenticate:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Install CF CLI v8
+        run: |
+          wget -q -O - https://packages.cloudfoundry.org/debian/cli.cloudfoundry.org.key | sudo apt-key add -
+          echo "deb https://packages.cloudfoundry.org/debian stable main" | sudo tee /etc/apt/sources.list.d/cloudfoundry-cli.list
+          sudo apt-get update
+          sudo apt-get install cf8-cli
+
+      - name: Authenticate to Cloud Foundry
+        run: |
+          cf api "${{ inputs.cf_api }}"
+
+          # Determine authentication method
+          if [[ "${{ inputs.use_sso }}" == "true" ]]; then
+            echo "Using SSO authentication with refresh token"
+            cf auth --sso-passcode "${{ secrets.CF_SSO_REFRESH_TOKEN }}"
+          else
+            echo "Using username/password authentication"
+            cf auth "${{ inputs.cf_username }}" "${{ secrets.CF_PASSWORD }}"
+          fi
+
+          # Verify authentication was successful
+          cf target || { echo "Authentication failed"; exit 1; }

.github/workflows/cf-create-services.yml

@@ -0,0 +1,84 @@
+name: Cloud Foundry Service Creation
+
+on:
+  workflow_call:
+    inputs:
+      genai_service_name:
+        required: false
+        type: string
+        description: 'Name of the GenAI service to create'
+      genai_plan:
+        required: false
+        type: string
+        description: 'GenAI Service Plan Name'
+      db_service_name:
+        required: false
+        type: string
+        description: 'Name of the database service to create'
+      db_service_type:
+        required: false
+        type: string
+        default: 'postgresql'
+        description: 'Database Service Type (e.g., postgresql, mysql)'
+      db_plan:
+        required: false
+        type: string
+        description: 'Database Service Plan Name'
+      ups_name:
+        required: false
+        type: string
+        description: 'Name of the user-provided service to create'
+      ups_credentials:
+        required: false
+        type: string
+        description: 'JSON string of credentials for the user-provided service'
+    secrets:
+      UPS_CREDENTIALS:
+        required: false
+        description: 'Secret credentials for user-provided service'
+
+jobs:
+  create_services:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Create GenAI Service
+        if: inputs.genai_service_name != '' && inputs.genai_plan != ''
+        run: |
+          if ! cf service "${{ inputs.genai_service_name }}"; then
+            echo "Creating GenAI service: ${{ inputs.genai_service_name }}"
+            cf create-service genai "${{ inputs.genai_plan }}" "${{ inputs.genai_service_name }}" -t genai,llm || echo "Service creation might have failed or already exists"
+          else
+            echo "GenAI service ${{ inputs.genai_service_name }} already exists."
+          fi
+        continue-on-error: true
+
+      - name: Create Database Service
+        if: inputs.db_service_name != '' && inputs.db_plan != ''
+        run: |
+          if ! cf service "${{ inputs.db_service_name }}"; then
+            echo "Creating DB service: ${{ inputs.db_service_name }}"
+            cf create-service "${{ inputs.db_service_type }}" "${{ inputs.db_plan }}" "${{ inputs.db_service_name }}" || echo "DB Service creation might have failed or already exists"
+          else
+            echo "DB service ${{ inputs.db_service_name }} already exists."
+          fi
+        continue-on-error: true
+
+      - name: Create User-Provided Service
+        if: inputs.ups_name != ''
+        run: |
+          if ! cf service "${{ inputs.ups_name }}"; then
+            echo "Creating user-provided service: ${{ inputs.ups_name }}"
+
+            # Use provided credentials JSON if available, otherwise use secret
+            if [[ -n "${{ inputs.ups_credentials }}" ]]; then
+              cf create-user-provided-service "${{ inputs.ups_name }}" -p '${{ inputs.ups_credentials }}' || echo "UPS creation might have failed or already exists"
+            elif [[ -n "${{ secrets.UPS_CREDENTIALS }}" ]]; then
+              cf create-user-provided-service "${{ inputs.ups_name }}" -p '${{ secrets.UPS_CREDENTIALS }}' || echo "UPS creation might have failed or already exists"
+            else
+              echo "No credentials provided for user-provided service"
+              exit 1
+            fi
+          else
+            echo "UPS ${{ inputs.ups_name }} already exists."
+          fi
+        continue-on-error: true

.github/workflows/cf-deploy.yml

@@ -0,0 +1,98 @@
+name: Cloud Foundry Application Deployment
+
+on:
+  workflow_call:
+    inputs:
+      project_path:
+        required: true
+        type: string
+        description: 'Path to the project directory'
+      env_vars:
+        required: false
+        type: string
+        description: 'JSON string of environment variables to set'
+      random_route:
+        required: false
+        type: boolean
+        default: false
+        description: 'Whether to use a random route for the application'
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Download environment variables artifact
+        uses: actions/download-artifact@v4
+        with:
+          name: env-vars
+          path: ./
+        continue-on-error: true
+      - name: Push Application to Cloud Foundry
+        working-directory: ${{ inputs.project_path }}
+        run: |
+          # Determine app name from manifest or project name
+          APP_NAME=$(grep 'name:' manifest.yml | head -n 1 | awk '{print $2}')
+          if [ -z "$APP_NAME" ]; then
+            APP_NAME=$(basename "${{ inputs.project_path }}") # Fallback to directory name
+          fi
+          echo "Deploying application: $APP_NAME from project: ${{ inputs.project_path }}"
+
+          # Push the application without starting it
+          if [ "${{ inputs.random_route }}" == "true" ]; then
+            echo "Pushing with random route..."
+            cf push "$APP_NAME" -f manifest.yml --no-start --random-route || echo "cf push failed, check logs."
+          else
+            echo "Pushing with route from manifest..."
+            cf push "$APP_NAME" -f manifest.yml --no-start || echo "cf push failed, check logs."
+          fi
+
+      - name: Set Input Environment Variables
+        working-directory: ${{ inputs.project_path }}
+        if: inputs.env_vars != ''
+        run: |
+          APP_NAME=$(grep 'name:' manifest.yml | head -n 1 | awk '{print $2}')
+          if [ -z "$APP_NAME" ]; then
+            APP_NAME=$(basename "${{ inputs.project_path }}")
+          fi
+
+          echo "Setting input environment variables..."
+          ENV_VARS_JSON='${{ inputs.env_vars }}'
+          for key in $(echo "$ENV_VARS_JSON" | jq -r 'keys[]'); do
+            value=$(echo "$ENV_VARS_JSON" | jq -r --arg key "$key" '.[$key]')
+            echo "Setting $key from inputs"
+            cf set-env "$APP_NAME" "$key" "$value"
+          done
+
+      - name: Set Environment Variables from Artifact
+        working-directory: ${{ inputs.project_path }}
+        run: |
+          if [ -f "../env_vars.json" ]; then
+            APP_NAME=$(grep 'name:' manifest.yml | head -n 1 | awk '{print $2}')
+            if [ -z "$APP_NAME" ]; then
+              APP_NAME=$(basename "${{ inputs.project_path }}")
+            fi
+
+            echo "Setting environment variables from artifact..."
+            ENV_VARS_JSON=$(cat ../env_vars.json)
+            for key in $(echo "$ENV_VARS_JSON" | jq -r 'keys[]'); do
+              value=$(echo "$ENV_VARS_JSON" | jq -r --arg key "$key" '.[$key]')
+              echo "Setting $key from artifact"
+              cf set-env "$APP_NAME" "$key" "$value"
+            done
+          else
+            echo "No environment variables artifact found, skipping this step"
+          fi
+
+      - name: Start Application
+        working-directory: ${{ inputs.project_path }}
+        run: |
+          APP_NAME=$(grep 'name:' manifest.yml | head -n 1 | awk '{print $2}')
+          if [ -z "$APP_NAME" ]; then
+            APP_NAME=$(basename "${{ inputs.project_path }}")
+          fi
+
+          echo "Starting application..."
+          cf start "$APP_NAME"
+        env:
+          CF_STAGING_TIMEOUT: 15
+          CF_STARTUP_TIMEOUT: 5

.github/workflows/cf-org-space.yml

@@ -0,0 +1,39 @@
+name: Cloud Foundry Org and Space Setup
+
+on:
+  workflow_call:
+    inputs:
+      cf_org:
+        required: true
+        type: string
+        description: 'Cloud Foundry Target Organization'
+      cf_space:
+        required: true
+        type: string
+        description: 'Cloud Foundry Target Space'
+
+jobs:
+  setup_org_space:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check/Create Organization
+        run: |
+          if ! cf org --guid "${{ inputs.cf_org }}"; then
+            echo "Organization '${{ inputs.cf_org }}' not found. Creating..."
+            cf create-org "${{ inputs.cf_org }}"
+          else
+            echo "Organization '${{ inputs.cf_org }}' found."
+          fi
+
+      - name: Check/Create Space
+        run: |
+          if ! cf space --guid "${{ inputs.cf_space }}" -o "${{ inputs.cf_org }}"; then
+            echo "Space '${{ inputs.cf_space }}' not found in org '${{ inputs.cf_org }}'. Creating..."
+            cf create-space "${{ inputs.cf_space }}" -o "${{ inputs.cf_org }}"
+          else
+            echo "Space '${{ inputs.cf_space }}' found."
+          fi
+
+      - name: Target Org and Space
+        run: |
+          cf target -o "${{ inputs.cf_org }}" -s "${{ inputs.cf_space }}"