UPD: techdocs config

Author: NewerKey

.github/workflows/cd-workflow.yaml

@@ -113,6 +113,6 @@ jobs:
             --port=7007
             --add-cloudsql-instances=${{ secrets.GCP_SQL_CONNECTION_NAME }}
           env_vars: |
-            POSTGRES_HOST=/cloudsql/${{ secrets.GCP_SQL_CONNECTION_NAME }}
+            POSTGRES_HOST=${{ secrets.POSTGRES_HOST }}
             POSTGRES_PORT=5432
             BASE_URL=https://backstage.foundations-software-engineering.com

.github/workflows/techdocs-gcs.yml

@@ -0,0 +1,55 @@
+name: Build and Publish TechDocs to GCS
+
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - 'docs/**'
+      - 'mkdocs.yml'
+
+jobs:
+  publish-techdocs-site:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        node-version: ['20.x']
+    
+    env: 
+        TECHDOCS_BUCKET_NAME: ${{ secrets.TECHDOCS_BUCKET_NAME }}
+        TECHDOCS_GCS_CREDENTIALS: ${{ secrets.TECHDOCS_GCS_CREDENTIALS }}
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Enable Corepack
+        run: corepack enable
+
+      - name: Set Yarn Version
+        run: corepack prepare [email protected] --activate
+      
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node-version }}
+          cache: 'yarn'
+
+      - name: Setup Python
+        uses: actions/setup-python@v4
+        with:
+           python-version: '3.9'
+
+      - name: Install techdocs-cli
+        run: yarn global add @techdocs/cli
+
+      - name: Install mkdocs and mkdocs-plugin
+        run: python -m pip install mkdocs-techdocs-core==1.**
+    
+      - name: Generate docs site
+        run: techdocs-cli generate --no-docker --verbose
+
+      - name: Publish docs site
+        run: techdocs-cli publish --publisher-type googleGcs --storage-name ${{ env.TECHDOCS_BUCKET_NAME }} --gcs-credentials ${{ env.TECHDOCS_GCS_CREDENTIALS }}

app-config.yaml

@@ -44,8 +44,11 @@ integrations:
     - host: gitlab.com
       token: ${GITLAB_TOKEN}
 
+
 techdocs:
-  builder: 'external' 
+  builder: 'external'
+  generator:
+    runIn: 'local'
   publisher:
     type: 'googleGcs'
     googleGcs:

docs/CHANGELOG.md

@@ -8,6 +8,7 @@ nav:
     - Register Your Software Component: 'how-to-register-a-component.md'
   - Technical Documentation: 
     - Publish Your Docs: 'how-to-publish-documentation.md'
+  - CHANGELOG: 'CHANGELOG.md'
 
 plugins: 
   - techdocs-core