fix: server-api deploy (#1857)

Co-authored-by: Shurtu-gal <ashishpadhy1729@gmail.com>
Co-authored-by: asyncapi-bot <info@asyncapi.io>

Author: Shurtu-gal

.changeset/1857.md

@@ -0,0 +1,17 @@
+---
+'@asyncapi/cli': patch
+---
+
+fix: server-api deploy
+
+- 837be8a: fix: server-api release and deployment
+
+Signed-off-by: Shurtu-gal <ashishpadhy1729@gmail.com>
+- 09af23e: chore: add app platform spec
+
+Signed-off-by: Shurtu-gal <ashishpadhy1729@gmail.com>
+- a5eef9f: chore: install generator templates globally
+
+Signed-off-by: Shurtu-gal <ashishpadhy1729@gmail.com>
+
+

.github/workflows/release-server-api.yml

@@ -3,6 +3,11 @@ on:
   release:
     types: 
       - published
+  workflow_dispatch:
+    inputs:
+      version:
+        description: 'Version to release'
+        required: true
 jobs:
 
   publish-docker:
@@ -15,24 +20,25 @@ jobs:
       - name: Get version without v character
         id: version
         run: |
-          VERSION=${{github.event.release.tag_name}}
+          VERSION=${{github.event.release.tag_name || github.event.inputs.version}}
           VERSION_WITHOUT_V=${VERSION:1}
           echo "value=${VERSION_WITHOUT_V}" >> $GITHUB_OUTPUT
 
       - name: Set Up QEMU
-        uses: docker/setup-qemu-action@v2
+        uses: docker/setup-qemu-action@v3
 
       - name: Set Up Docker Buildx
-        uses: docker/setup-buildx-action@v2
+        uses: docker/setup-buildx-action@v3
 
       - name: Login to Docker Hub
-        uses: docker/login-action@v2
+        uses: docker/login-action@v3
         with:
           username: ${{ secrets.DOCKER_USERNAME }}
           password: ${{ secrets.DOCKER_PASSWORD }}
 
       - name: Build and Push Docker Image
-        uses: docker/build-push-action@v4
+        uses: docker/build-push-action@v6
+        id: push
         with:
           context: .
           file: ./src/apps/api/Dockerfile
@@ -41,8 +47,14 @@ jobs:
             asyncapi/server-api:${{ steps.version.outputs.value }}
             asyncapi/server-api:latest
           platforms: linux/amd64,linux/arm64
-          cache-from: type=gha
-          cache-to: type=gha
+          cache-from: |
+            type=gha,scope=server-api
+            type=registry,ref=asyncapi/server-api:cache
+          cache-to: |
+            type=gha,mode=max,scope=server-api
+            type=registry,ref=asyncapi/server-api:cache,mode=max
+          build-args: |
+            BUILDKIT_INLINE_CACHE=1
 
       - uses: meeDamian/sync-readme@82715041300710d9be7c726c9d6c683b70451087 #version 1.0.6 https://github.com/meeDamian/sync-readme/releases/tag/v1.0.6
         with:
@@ -52,14 +64,19 @@ jobs:
           readme: ./src/apps/api/README.md
           description: Server API providing official AsyncAPI tools
 
+    outputs:
+      digest: ${{ steps.push.outputs.digest }}
+
   deploy-app:
     name: Deploy to DigitalOcean App
     needs: publish-docker
     runs-on: ubuntu-latest
     steps:
       - name: Deploy to DigitalOcean App
-        uses: digitalocean/app_action@e583e1b463e8ac378854c0a01af1de8a5afd836b
+        uses: digitalocean/app_action@190f99be3ce4cbbe5d1ca0a63a8ac9d0add205d0
+        env:
+          DOCKER_DIGEST: ${{ needs.publish-docker.outputs.digest }}
         with:
-          app_name: "server-api"
           token: ${{ secrets.DIGITALOCEAN_ACCESS_TOKEN }}
-          images: '[{"name":"asyncapi-server-api","image":{"registry_type":"DOCKER_HUB","registry":"asyncapi","repository":"server-api","tag":"latest"}}]'
+          app_spec_location: ./src/apps/api/.do/app.yaml
+          print_deploy_logs: true

openapi.yaml

@@ -1,6 +1,6 @@
 openapi: 3.1.0
 info:
-  version: 0.1.0
+  version: 0.2.0
   title: AsyncAPI Server API
   description: Server API providing official AsyncAPI tools
   contact:
@@ -15,6 +15,31 @@ servers:
   - url: https://api.asyncapi.com/v1
 
 paths:
+  /version:
+    get:
+      summary: Get the current version of the AsyncAPI CLI.
+      operationId: getVersion
+      tags:
+        - version
+      responses:
+        "200":
+          description: Successfully retrieved the version.
+          content:
+            application/json:
+              schema:
+                ref: "#/components/schemas/VersionResponse"
+        "500":
+          description: Internal server error.
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/Problem"
+        default:
+          description: Unexpected problem.
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/Problem"
   /validate:
     post:
       summary: Validate the given AsyncAPI document.
@@ -581,3 +606,108 @@ components:
         - title
         - status
       additionalProperties: true
+    VersionResponse:
+      type: object
+      description: Version information for the AsyncAPI CLI API
+      properties:
+        version:
+          type: string
+          description: The current version of the AsyncAPI CLI
+          example: "3.5.1"
+        name:
+          type: string
+          description: The name of the application
+          example: "@asyncapi/cli"
+        description:
+          type: string
+          description: Description of the application
+          example: "All in one CLI for all AsyncAPI tools"
+        runtime:
+          type: object
+          description: Runtime information
+          properties:
+            node:
+              type: string
+              description: Node.js version
+              example: "v24.7.0"
+            environment:
+              type: string
+              description: Build environment
+              example: "development"
+              enum: ["development", "staging", "production"]
+            platform:
+              type: string
+              description: Operating system platform
+              example: "darwin"
+            arch:
+              type: string
+              description: System architecture
+              example: "arm64"
+            uptime:
+              type: string
+              description: Application uptime
+              example: "12 seconds"
+            startTime:
+              type: string
+              format: date-time
+              description: Application start time
+              example: "2025-09-12T05:08:25.171Z"
+          required:
+            - node
+            - environment
+            - platform
+            - arch
+            - uptime
+            - startTime
+        repository:
+          type: object
+          description: Repository information
+          properties:
+            url:
+              type: string
+              format: uri
+              description: Repository URL
+              example: "https://github.com/asyncapi/cli"
+            bugs:
+              type: string
+              format: uri
+              description: Bug tracker URL
+              example: "https://github.com/asyncapi/cli/issues"
+            license:
+              type: string
+              description: License type
+              example: "Apache-2.0"
+          required:
+            - url
+            - bugs
+            - license
+        api:
+          type: object
+          description: API metadata
+          properties:
+            basePath:
+              type: string
+              description: API base path
+              example: "/version"
+            timestamp:
+              type: string
+              format: date-time
+              description: Current timestamp
+              example: "2025-09-12T05:08:37.979Z"
+            health:
+              type: string
+              description: API health status
+              example: "ok"
+              enum: ["ok", "degraded", "error"]
+          required:
+            - basePath
+            - timestamp
+            - health
+      required:
+        - version
+        - name
+        - description
+        - build
+        - runtime
+        - repository
+        - api

src/apps/api/.do/app.yaml

@@ -0,0 +1,43 @@
+name: server-api
+region: sfo3
+
+domain:
+  name: api.asyncapi.com
+  type: PRIMARY
+
+ingress:
+  rules:
+    - component: asyncapi-server-api
+      match:
+        path:
+          prefix: /
+      cors:
+        allow_origins:
+          - exact: "*"
+        allow_methods: ["GET", "POST", "PUT", "DELETE", "OPTIONS"]
+        allow_headers: ["*"]
+
+services:
+  - name: asyncapi-server-api
+    image:
+      registry_type: DOCKER_HUB
+      registry: asyncapi
+      repository: server-api
+      digest: ${DOCKER_DIGEST}
+    http_port: 80
+    health_check:
+      http_path: /v1/help
+      port: 80
+    envs:
+      - key: PORT
+        value: "80"
+    instance_count: 1
+    instance_size_slug: basic-xs
+    alerts:
+      - rule: CPU_UTILIZATION
+        operator: GREATER_THAN
+        value: 80
+        window: TEN_MINUTES
+
+alerts:
+  - rule: DEPLOYMENT_FAILED

deployments/apps/.gitignore src/apps/api/.do/apps/.gitignoredeployments/apps/.gitignore renamed to src/apps/api/.do/apps/.gitignore

@@ -26,6 +26,17 @@ COPY *.json ./
 # 4. Build TypeScript or production-ready JS
 RUN npm run api:build
 
+# ---- Templates stage ----
+FROM base AS templates
+
+# Copy templates list
+COPY ./src/apps/api/templates.json /tmp/templates.json
+
+# Install generator templates globally using the templates.json array
+# This layer will be cached unless template versions change
+RUN TEMPLATES=$(node -e "console.log(JSON.parse(require('fs').readFileSync('/tmp/templates.json', 'utf8')).join(' '))") && \
+    npm install -g $TEMPLATES
+
 # ---- Release stage ----
 FROM base AS release
 
@@ -47,12 +58,19 @@ RUN npm ci --omit=dev --ignore-scripts \
   && npm cache clean --force \
   && npm prune --production
 
+# Copy globally installed templates from templates stage
+COPY --from=templates /usr/local/lib/node_modules /usr/local/lib/node_modules
+COPY --from=templates /usr/local/bin /usr/local/bin
+
 # Copy OpenAPI document
 COPY openapi.yaml ./
 
 # Change ownership of the app directory to the non-root user
 RUN chown -R asyncapi:nodejs /app
 
+# Change ownership of node_modules to the non-root user
+RUN chown -R asyncapi:nodejs /usr/local/lib/node_modules
+
 # Switch to non-root user
 USER asyncapi
 

deployments/apps/.terraform.lock.hcl src/apps/api/.do/apps/.terraform.lock.hcldeployments/apps/.terraform.lock.hcl renamed to src/apps/api/.do/apps/.terraform.lock.hcl

@@ -12,6 +12,7 @@ import { Controller } from '@/interfaces';
 import { logger } from '../../utils/logger';
 import { API_VERSION } from './constants';
 import { problemMiddleware } from './middlewares/problem.middleware';
+import { loggerMiddleware } from './middlewares/logger.middleware';
 
 export class App {
   private app: express.Application;
@@ -89,6 +90,7 @@ export class App {
         crossOriginEmbedderPolicy: false,
       }),
     );
+    this.app.use(loggerMiddleware);
   }
 
   private async initializeControllers() {