refactor(plantuml): change plantuml renderer

Change plantuml renderer to locally render via docker container

Author: nickkkccc

.github/workflows/dev-documentation.yml

@@ -18,26 +18,51 @@ permissions:
 jobs:
   deploy:
     name: Deploy dev documentation
-    runs-on: ubuntu-22.04
+    runs-on: ubuntu-20.04-self-hosted
+    env:
+      RENDERER_NETWORK: renderer-net
+      RENDERER_IMAGE: plantuml/plantuml-server:jetty-v1.2026.0
+      RENDERER_CONTAINER_NAME: renderer
+      RENDERER_REGISTRY: "registry.ps.tarantool.io/"
     defaults:
       run:
         working-directory: documentation
     steps:
       - uses: actions/checkout@v6
         with:
           fetch-depth: 0
+
+      - name: Docker login to private registry
+        run: docker login "${{ secrets.PS_REGISTRY_URL }}" -u admin -p "${{ secrets.PS_REGISTRY_PASSWORD }}"
+
+      - name: Start renderer service locally
+        run: |
+          docker network create "$RENDERER_NETWORK"
+          docker run -d -p 7036:8080 --name "$RENDERER_CONTAINER_NAME" --network "$RENDERER_NETWORK" ${RENDERER_REGISTRY}${RENDERER_IMAGE}
+
       - name: Configure Git user
         run: |
           git config user.email "actions@github.com"
           git config user.name "GitHub Actions"
+
       - name: Setup python
         uses: actions/setup-python@v5
         with:
           python-version: 3.x
           cache: 'pip'
+
       - name: Download mkdocs plugins
         run: pip install -r requirements.txt
+
       - name: Deploy documentation into gh-pages branch
         run: mike deploy dev --push
+
       - name: Setup default version
         run: mike set-default dev --push
+
+      - name: Cleanup renderer container
+        if: always()
+        run: |
+          docker rm -f "$RENDERER_CONTAINER_NAME"
+          docker network rm -f "$RENDERER_NETWORK" 
+          docker rmi -f ${RENDERER_REGISTRY}${RENDERER_IMAGE}

.github/workflows/release-documentation.yml

@@ -20,7 +20,12 @@ permissions:
 jobs:
   deploy:
     name: Deploy release documentation
-    runs-on: ubuntu-22.04
+    runs-on: ubuntu-20.04-self-hosted
+    env:
+      RENDERER_NETWORK: renderer-net
+      RENDERER_IMAGE: plantuml/plantuml-server:jetty-v1.2026.0
+      RENDERER_CONTAINER_NAME: renderer
+      RENDERER_REGISTRY: "registry.ps.tarantool.io/"
     steps:
       - name: Validate semver tag  format
         id: validate-tag
@@ -38,12 +43,21 @@ jobs:
           echo "✅ Valid tag: $TAG"
           echo "Version for docs: $VERSION"
           echo "version=$VERSION" >> $GITHUB_OUTPUT
+
       - name: Checkout repository with tag
         uses: actions/checkout@v6
         with:
           ref: "${{ github.event.inputs.tag }}"
           fetch-depth: 0
 
+      - name: Docker login to private registry
+        run: docker login "${{ secrets.PS_REGISTRY_URL }}" -u admin -p "${{ secrets.PS_REGISTRY_PASSWORD }}"
+
+      - name: Start renderer service locally
+        run: |
+          docker network create "$RENDERER_NETWORK"
+          docker run -d -p 7036:8080 --name "$RENDERER_CONTAINER_NAME" --network "$RENDERER_NETWORK" ${RENDERER_REGISTRY}${RENDERER_IMAGE}
+
       - name: Configure Git user
         run: |
           git config user.email "actions@github.com"
@@ -66,3 +80,10 @@ jobs:
 #        env:
 #          # Для дебага, если нужно
 #          MIKE_VERBOSE: 1
+
+      - name: Cleanup renderer container
+        if: always()
+        run: |
+          docker rm -f "$RENDERER_CONTAINER_NAME"
+          docker network rm -f "$RENDERER_NETWORK" 
+          docker rmi -f ${RENDERER_REGISTRY}${RENDERER_IMAGE}

documentation/README.md

@@ -13,8 +13,11 @@
     source venv/bin/activate
     pip install -r requirements.txt
     ```
-
-2. Соберите или запустите сайт:
+2. Необходим `docker`. Запустите сервер рендеринга локально:
+   ```shell
+   docker run -d -p 7036:8080 plantuml/plantuml-server:jetty-v1.2026.0
+   ```
+3. Соберите или запустите сайт:
 
    ```shell
    mkdocs build

documentation/README_EN.md

@@ -13,8 +13,11 @@ To deploy documentation locally on current branch/tag:
     source venv/bin/activate
     pip install -r requirements.txt
     ```
-
-2. Build or serve site:
+2. Requires `docker`. Start the render server locally:
+   ```shell
+   docker run -d -p 7036:8080 plantuml/plantuml-server:jetty-v1.2026.0
+   ```
+3. Build or serve site:
 
    ```shell
    mkdocs build

documentation/mkdocs.yml

@@ -47,7 +47,7 @@ plugins:
   - drawio:
       darkmode: true
   - plantuml:
-      puml_url: https://www.plantuml.com/plantuml/
+      puml_url: http://localhost:7036
       # в секундах(in seconds)
       request_timeout: 300