Update otc_metadata/data/cloud_environments/swiss.yaml

Reviewed-on: infra/otc-metadata-rework#80
Reviewed-by: Tino Schreiber <tino.schreiber@t-systems.com>
Co-authored-by: Sebastian Gode <sebastian.gode@telekom.de>
Co-committed-by: Sebastian Gode <sebastian.gode@telekom.de>

.gitea/workflows/create-weekly-analytics-stats.yaml

@@ -0,0 +1,62 @@
+name: Create Weekly Analytics Stats
+
+on:
+  schedule:
+    # 03:00 UTC = 04:00 CET
+    - cron: "0 3 * * 1"
+  workflow_dispatch:
+
+jobs:
+  run-analytics:
+    runs-on: ubuntu
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          token: ${{ secrets.PUSH_TOKEN }}
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install requests otc-metadata
+
+      - name: Run analytics for eu_de
+        env:
+          UMAMI_USERNAME: ${{ secrets.UMAMI_USERNAME }}
+          UMAMI_PASSWORD: ${{ secrets.UMAMI_PASSWORD }}
+        run: |
+          python ./tools/collect_statistics.py \
+            --website-id "${{ secrets.UMAMI_WEBSITE_ID }}" \
+            --cloud-environment "eu_de" \
+            --environment "public" \
+            --limit "10"
+
+      - name: Run analytics for swiss
+        env:
+          UMAMI_USERNAME: ${{ secrets.UMAMI_USERNAME }}
+          UMAMI_PASSWORD: ${{ secrets.UMAMI_PASSWORD }}
+        run: |
+          python ./tools/collect_statistics.py \
+            --website-id "${{ secrets.UMAMI_WEBSITE_ID }}" \
+            --cloud-environment "swiss" \
+            --environment "public" \
+            --limit "10"
+
+      - name: Commit and push results
+        run: |
+          git config --global user.name "gitea-actions[bot]"
+          git config --global user.email "actions@users.noreply.local"
+          git checkout -B analytics-update
+          git add otc_metadata/analytics/
+          if git diff --cached --quiet; then
+            echo "No changes to commit"
+          else
+            git commit -m "chore: update analytics data"
+            git push origin analytics-update --force
+          fi

.gitea/workflows/python-tox.yaml

@@ -0,0 +1,18 @@
+name: Run Tox Check
+
+on:
+  pull_request:
+    types: [opened, reopened, synchronize, edited]
+
+jobs:
+  tox-py312:
+    runs-on: ubuntu
+    steps:
+      - uses: https://github.com/opentelekomcloud-infra/github-actions/.github/actions/tox-py-test@v1
+
+  tox-pep8:
+    runs-on: ubuntu
+    steps:
+      - uses: https://github.com/opentelekomcloud-infra/github-actions/.github/actions/tox-py-test@v1
+        with:
+          tox-env: pep8

.gitea/workflows/update_opensearch_filters.yaml

@@ -0,0 +1,32 @@
+name: Updates Opensearch filters
+
+on:
+  pull_request:
+    types:
+      - closed
+    branches:
+      - main
+
+jobs:
+    update-opensearch-filters:
+        if: github.event.pull_request.merged == true
+        runs-on: ubuntu
+
+        steps:
+            - name: Checkout code
+              uses: actions/checkout@v4
+
+            - name: Set up Python
+              uses: actions/setup-python@v5
+              with:
+                  python-version: '3.12'
+
+            - name: Install dependencies and local package otc-metadata package
+              run: |
+                  python -m pip install --upgrade pip
+                  pip install . -r tools-requirements.txt
+
+            - name: Update swiss and eu_de Opensearch indizies             
+              run: |
+                  python tools/index_metadata.py --hosts ${{ secrets.OPENSEARCH_HOST1 }} --target-environment public --index search_index_de --cloud-environment eu_de --username ${{ secrets.OPENSEARCH_USER }} --password ${{ secrets.OPENSEARCH_PW }} --delete-index
+                  python tools/index_metadata.py --hosts ${{ secrets.OPENSEARCH_HOST1 }} --target-environment public --index search_index_swiss --cloud-environment swiss --username ${{ secrets.OPENSEARCH_USER }} --password ${{ secrets.OPENSEARCH_PW }} --delete-index

otc_metadata/analytics/data.py

@@ -0,0 +1,48 @@
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+# implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from pathlib import Path
+import json
+
+BASE_DIR = Path(__file__).resolve().parent
+analytics_path = BASE_DIR / "public"
+
+cloud_environments = [
+    'eu_de',
+    'swiss'
+]
+analytics_data = {k: [] for k in cloud_environments}
+
+# Open and read the json data files
+for env in cloud_environments:
+    file_path = analytics_path / f"{env}.json"
+    with file_path.open(encoding="utf-8") as file:
+        analytics_data[env] = json.load(file)
+
+
+class AnalyticsData(object):
+    """Encapsulate OTC Analystics data"""
+
+    def __init__(self):
+        self._analytics_data = analytics_data
+
+    def all_analytics_data(self):
+        """returns all analytics data"""
+        return self._analytics_data
+
+    def analytics_data_by_cloud_environment(self, cloud_environment):
+        """returns all analytics data"""
+        if cloud_environment and cloud_environment in self._analytics_data:
+            return self._analytics_data[cloud_environment]
+        else:
+            raise ValueError(f"cloud_environment '{cloud_environment}' does not exist.")

otc_metadata/analytics/public/eu_de.json

@@ -0,0 +1,12 @@
+[
+  "evs",
+  "ims",
+  "ecs",
+  "obs",
+  "cce",
+  "elb",
+  "rds",
+  "sfs",
+  "iam",
+  "vpc"
+]

otc_metadata/analytics/public/swiss.json

@@ -0,0 +1,12 @@
+[
+  "evs",
+  "ims",
+  "ecs",
+  "obs",
+  "cce",
+  "elb",
+  "rds",
+  "iam",
+  "vpc",
+  "vpn"
+]

otc_metadata/data/cloud_environments/eu_de.yaml

@@ -0,0 +1,10 @@
+---
+name: eu_de
+internal_org: docs
+public_org: opentelekomcloud-docs
+regions:
+  - eu-de
+affected_locations:
+  - "EU-DE-01 AZ1 (Germany/Biere)"
+  - "EU-DE-02 AZ2 (Germany/Magdeburg)"
+  - "EU-DE-03 AZ3 (Germany/Biere)"

otc_metadata/data/cloud_environments/swiss.yaml

@@ -0,0 +1,11 @@
+---
+name: swiss
+table_suffix: _swiss
+internal_org: docs-swiss
+public_org: opentelekomcloud-docs-swiss
+regions:
+  - eu-ch2
+affected_locations:
+  - "EU-CH2-01 SwissCloud AZ1 (Switzerland/Zollikofen)"
+  - "EU-CH2-02 SwissCloud AZ2 (Switzerland/Bern)"
+  - "EU-CH2-03 SwissCloud AZ3 (Switzerland/Zollikofen)"

otc_metadata/data/documents/apig-dev.yaml

@@ -2,10 +2,10 @@
 hc_location: devg/apig
 html_location: docs/apig/dev
 link: /api-gateway/dev-guide/
-rst_location: dev_guide/source
+rst_location: doc/dev-guide/source
 service_type: apig
 title: Developer Guide
-type: dev
+type: dev-guide
 cloud_environments:
   - name: eu_de
     visibility: hidden

otc_metadata/data/documents/as-dev.yaml

@@ -2,10 +2,10 @@
 hc_location: devg/as
 html_location: docs/as/dev
 link: /auto-scaling/dev-guide/
-rst_location: dev_guide/source
+rst_location: doc/dev-guide/source
 service_type: as
 title: Developer Guide
-type: dev
+type: dev-guide
 cloud_environments:
   - name: eu_de
     visibility: public

otc_metadata/data/documents/bms-dev.yaml

@@ -2,10 +2,10 @@
 hc_location: devg/bms
 html_location: docs/bms/dev
 link: /bare-metal-server/dev-guide/
-rst_location: dev_guide/source
+rst_location: doc/dev-guide/source
 service_type: bms
 title: Developer Guide
-type: dev
+type: dev-guide
 cloud_environments:
   - name: eu_de
     visibility: public

otc_metadata/data/documents/dli-dev.yaml

@@ -2,10 +2,10 @@
 hc_location: devg/dli
 html_location: docs/dli/dev
 link: /data-lake-insight/dev-guide/
-rst_location: dev_guide/source
+rst_location: doc/dev-guide/source
 service_type: dli
 title: Developer Guide
-type: dev
+type: dev-guide
 cloud_environments:
   - name: eu_de
     visibility: public

otc_metadata/data/documents/dms-dev.yaml

@@ -2,10 +2,10 @@
 hc_location: devg/dms
 html_location: docs/dms/dev
 link: /distributed-message-service/dev-guide/
-rst_location: dev_guide/source
+rst_location: doc/dev-guide/source
 service_type: dms
 title: Developer Guide
-type: dev
+type: dev-guide
 cloud_environments:
   - name: eu_de
     visibility: public

otc_metadata/data/documents/dms_rabbitmq-api-ref.yaml

@@ -0,0 +1,13 @@
+---
+hc_location: api/rabbitmq
+html_location: docs/dms_rabbitmq/api-ref
+link: /distributed-message-service-rabbitmq/api-ref/
+rst_location: api-ref/source
+service_type: dms_rabbitmq
+title: API Reference
+type: api-ref
+cloud_environments:
+  - name: eu_de
+    visibility: internal
+    pdf_visibility: public
+    pdf_enabled: true

otc_metadata/data/documents/dms_rabbitmq-umn.yaml

@@ -0,0 +1,13 @@
+---
+hc_location: usermanual/rabbitmq
+html_location: docs/dms_rabbitmq/umn
+link: /distributed-message-service-rabbitmq/umn/
+rst_location: umn/source
+service_type: dms_rabbitmq
+title: User Guide
+type: umn
+cloud_environments:
+  - name: eu_de
+    visibility: internal
+    pdf_visibility: public
+    pdf_enabled: true

otc_metadata/data/documents/dws-dev.yaml

@@ -2,10 +2,10 @@
 hc_location: devg/dws
 html_location: docs/dws/dev
 link: /data-warehouse-service/dev-guide/
-rst_location: dev_guide/source
+rst_location: doc/dev-guide/source
 service_type: dws
 title: Developer Guide
-type: dev
+type: dev-guide
 cloud_environments:
   - name: eu_de
     visibility: public

otc_metadata/data/documents/ecs-dev.yaml

@@ -2,10 +2,10 @@
 hc_location: devg/ecs
 html_location: docs/ecs/dev
 link: /elastic-cloud-server/dev-guide/
-rst_location: dev_guide/source
+rst_location: doc/dev-guide/source
 service_type: ecs
 title: Developer Guide
-type: dev
+type: dev-guide
 cloud_environments:
   - name: eu_de
     visibility: public

otc_metadata/data/documents/ed-alerting.yaml

@@ -0,0 +1,11 @@
+---
+link: /enterprise-dashboard/alerting/
+rst_location: doc/alerting/source
+service_type: ed
+title: Alerting
+type: alerting
+cloud_environments:
+  - name: eu_de
+    visibility: public
+    pdf_visibility: public
+    pdf_enabled: true

otc_metadata/data/documents/ed-sustainability.yaml

@@ -0,0 +1,11 @@
+---
+link: /enterprise-dashboard/sustainability/
+rst_location: doc/sustainability/source
+service_type: ed
+title: Sustainability
+type: sustainability
+cloud_environments:
+  - name: eu_de
+    visibility: public
+    pdf_visibility: public
+    pdf_enabled: true

otc_metadata/data/documents/eps-api-ref.yaml

@@ -8,6 +8,6 @@ title: API Reference
 type: api-ref
 cloud_environments:
   - name: eu_de
-    visibility: internal
+    visibility: public
     pdf_visibility: public
     pdf_enabled: true

otc_metadata/data/documents/eps-umn.yaml

@@ -8,6 +8,6 @@ title: User Guide
 type: umn
 cloud_environments:
   - name: eu_de
-    visibility: internal
+    visibility: public
     pdf_visibility: public
     pdf_enabled: true

otc_metadata/data/documents/esw-umn.yaml

@@ -0,0 +1,13 @@
+---
+hc_location: usermanual/esw
+html_location: docs/esw/umn
+link: /enterprise-switch/umn/
+rst_location: umn/source
+service_type: esw
+title: User Guide
+type: umn
+cloud_environments:
+  - name: eu_de
+    visibility: public
+    pdf_visibility: public
+    pdf_enabled: true

otc_metadata/data/documents/evs-dev.yaml

@@ -2,10 +2,10 @@
 hc_location: devg/evs
 html_location: docs/evs/dev
 link: /elastic-volume-service/dev-guide/
-rst_location: dev_guide/source
+rst_location: doc/dev-guide/source
 service_type: evs
 title: Developer Guide
-type: dev
+type: dev-guide
 cloud_environments:
   - name: eu_de
     visibility: public

otc_metadata/data/documents/fg-dev.yaml

@@ -2,10 +2,10 @@
 hc_location: devg/functiongraph
 html_location: docs/fg/dev
 link: /function-graph/dev-guide/
-rst_location: dev_guide/source
+rst_location: doc/dev-guide/source
 service_type: fg
 title: Developer Guide
-type: dev
+type: dev-guide
 cloud_environments:
   - name: eu_de
     visibility: internal

otc_metadata/data/documents/ims-dev.yaml

@@ -2,10 +2,10 @@
 hc_location: devg/ims
 html_location: docs/ims/dev
 link: /image-management-service/dev-guide/
-rst_location: dev_guide/source
+rst_location: doc/dev-guide/source
 service_type: ims
 title: Developer Guide
-type: dev
+type: dev-guide
 cloud_environments:
   - name: eu_de
     visibility: public

otc_metadata/data/documents/obs-tool-guide-obsutil.yaml

@@ -0,0 +1,13 @@
+---
+hc_location: utiltg/obs
+html_location: docs/obs/tool-obsutil
+link: /object-storage-service/tool-guide-obsutil/
+rst_location: doc/tool-obsutil/source
+service_type: obs
+title: Tool Guide (obsutil)
+type: tool-guide-obsutil
+cloud_environments:
+  - name: eu_de
+    visibility: public
+    pdf_visibility: public
+    pdf_enabled: true

otc_metadata/data/documents/obs_3rd_party-dotnet-sdk.yaml

@@ -0,0 +1,13 @@
+---
+hc_location: sdk/dotnet-devg-obs
+html_location: docs/obs_3rd_party/dotnet_sdk
+link: /object-storage-service-3rd-party/dotnet-sdk/
+rst_location: doc/dotnet-sdk/source
+service_type: obs_3rd_party
+title: .NET SDK
+type: dotnet-sdk
+cloud_environments:
+  - name: eu_de
+    visibility: public
+    pdf_visibility: public
+    pdf_enabled: false

otc_metadata/data/documents/obs_3rd_party-nodejs-sdk-sdk.yaml

@@ -0,0 +1,13 @@
+---
+hc_location: sdk/nodejs-devg-obs
+html_location: docs/obs_3rd_party/nodejs_sdk
+link: /object-storage-service-3rd-party/nodejs-sdk/
+rst_location: doc/nodejs-sdk/source
+service_type: obs_3rd_party
+title: Node.js SDK
+type: nodejs-sdk
+cloud_environments:
+  - name: eu_de
+    visibility: public
+    pdf_visibility: public
+    pdf_enabled: false

otc_metadata/data/repositories/dms_rabbitmq.yaml

@@ -0,0 +1,13 @@
+---
+service_type: dms_rabbitmq
+repositories:
+  - environment: public
+    repo: opentelekomcloud-docs/distributed-message-service-rabbitmq
+    type: github
+    cloud_environments:
+      - eu_de
+  - environment: internal
+    repo: docs/distributed-message-service-rabbitmq
+    type: gitea
+    cloud_environments:
+      - eu_de

otc_metadata/data/repositories/esw.yaml

@@ -0,0 +1,13 @@
+---
+service_type: esw
+repositories:
+  - environment: public
+    repo: opentelekomcloud-docs/enterprise-switch
+    type: github
+    cloud_environments:
+      - eu_de
+  - environment: internal
+    repo: docs/enterprise-switch
+    type: gitea
+    cloud_environments:
+      - eu_de

otc_metadata/data/services.yaml

@@ -17,6 +17,7 @@
 # documents/services/service_categories is being merged with
 # the content here.
 ---
+cloud_environments: []
 documents: []
 service_categories: []
 services: []

otc_metadata/data/services/apig.yaml

@@ -10,3 +10,4 @@ cloud_environments:
 teams:
   - name: docs-paas-rw
     permission: write
+description: API Gateway (APIG) is a high-performance, high-availability, and high-security API hosting service that helps you build, manage, and deploy APIs at any scale. With just a few clicks, you can integrate internal systems, and selectively expose capabilities with minimal costs and risks.

otc_metadata/data/services/cbr.yaml

@@ -12,3 +12,4 @@ cloud_environments:
     visibility: public
   - name: swiss
     visibility: public
+description: Cloud Backup and Recovery (CBR) allows you to back up cloud disks, elastic cloud servers, and bare metal servers, protecting the security and accuracy of your data to the greatest extent for service security.

otc_metadata/data/services/cce.yaml

@@ -12,3 +12,4 @@ cloud_environments:
   - name: swiss
     visibility: public
 is_global: false
+description: CCE provides highly scalable, high-performance, enterprise-class Kubernetes clusters. It supports native Kubernetes applications, tools and easy setup of container runtime environment.

otc_metadata/data/services/dms_rabbitmq.yaml

@@ -0,0 +1,12 @@
+---
+service_category: application
+service_title: Distributed Message Service (for RabbitMQ)
+service_type: dms_rabbitmq
+service_uri: distributed-message-service-rabbitmq
+teams:
+  - name: docs-paas-rw
+    permission: write
+cloud_environments:
+  - name: eu_de
+    visibility: internal
+is_global: false

otc_metadata/data/services/ecs.yaml

@@ -12,3 +12,4 @@ cloud_environments:
   - name: swiss
     visibility: public
 is_global: false
+description: An ECS is a computing server consisting of CPUs, memory, images, and Elastic Volume Service (EVS) disks that allow on-demand allocation and elastic scaling. ECSs integrate virtual private cloud (VPC), virtual firewalls, and multi-data-copy capabilities to create an efficient, reliable, and secure computing environment. This ensures stable and uninterrupted operation of services.

otc_metadata/data/services/elb.yaml

@@ -12,3 +12,4 @@ cloud_environments:
   - name: swiss
     visibility: public
 is_global: false
+description: Elastic Load Balancing (ELB) is a service that automatically distributes access traffic to multiple Elastic Cloud Servers (ECSs) to balance their service load. ELB enables you to achieve higher levels of fault tolerance in your applications and expand application service capabilities.

otc_metadata/data/services/eps.yaml

@@ -1,5 +1,5 @@
 ---
-service_category: security-services
+service_category: md
 service_title: Enterprise Project Service
 service_type: eps
 service_uri: enterprise-project-service
@@ -8,5 +8,5 @@ teams:
     permission: write
 cloud_environments:
   - name: eu_de
-    visibility: internal
+    visibility: public
 is_global: false

otc_metadata/data/services/esw.yaml

@@ -0,0 +1,12 @@
+---
+service_category: network
+service_title: Enterprise Switch
+service_type: esw
+service_uri: enterprise-switch
+teams:
+  - name: docs-network-rw
+    permission: write
+cloud_environments:
+  - name: eu_de
+    visibility: public
+is_global: false

otc_metadata/data/services/evs.yaml

@@ -12,3 +12,4 @@ cloud_environments:
   - name: swiss
     visibility: public
 is_global: false
+description: Elastic Volume Service (EVS) offers scalable block storage for servers. With high reliability, high performance, and rich specifications, EVS disks can be used for distributed file systems, development and testing environments, data warehouse applications, and high-performance computing (HPC) scenarios to meet diverse service requirements.

otc_metadata/data/services/iam.yaml

@@ -12,3 +12,4 @@ cloud_environments:
   - name: swiss
     visibility: public
 is_global: false
+description: Identity and Access Management (IAM) provides a public cloud system (Open Telekom Cloud) with user identity management and access control.

otc_metadata/data/services/ims.yaml

@@ -12,3 +12,4 @@ cloud_environments:
   - name: swiss
     visibility: public
 is_global: false
+description: Image Management Service (IMS) provides flexible self-service and comprehensive image management capabilities. You can use a public image or create a private image to apply for an Elastic Cloud Server (ECS) or multiple ECSs in batches.

otc_metadata/data/services/obs.yaml

@@ -12,3 +12,4 @@ cloud_environments:
   - name: swiss
     visibility: public
 is_global: false
+description: Object Storage Service (OBS) is an object-based storage service that provides customers with massive, secure, reliable, and cost-effective data storage capabilities, such as bucket creation, modification, and deletion, as well as object upload, download, and deletion.

otc_metadata/data/services/rds.yaml

@@ -12,3 +12,4 @@ cloud_environments:
   - name: swiss
     visibility: public
 is_global: false
+description: Relational Database Service (RDS) is an online relational database service based on the cloud computing platform. The RDS is reliable, scalable, secure, and easy to manage, allowing you to deploy a database within minutes.

otc_metadata/data/services/sfs.yaml

@@ -10,3 +10,4 @@ cloud_environments:
   - name: eu_de
     visibility: public
 is_global: false
+description: Scalable File Service (SFS) provides high-performance file storage that is scalable on demand. It can be shared with multiple Elastic Cloud Servers (ECS).

otc_metadata/data/services/vpc.yaml

@@ -12,3 +12,4 @@ cloud_environments:
   - name: swiss
     visibility: public
 is_global: false
+description: The Virtual Private Cloud (VPC) service enables you to provision logically isolated, configurable, and manageable virtual networks for Elastic Cloud Servers (ECSs), improving the security of resources in the cloud system and simplifying network deployment.

otc_metadata/services.py

@@ -62,10 +62,20 @@ class Services(object):
         if other in self._service_data["service_categories"]:
             self._service_data["service_categories"].remove(other)
             self._service_data["service_categories"].append(other)
+        # sort cloud environments by <name>
+        self._service_data["cloud_environments"] = sorted(
+            self._service_data["cloud_environments"],
+            key=lambda x: f"{x.get('name')}",
+        )
 
     def _rewrite_data(self):
         otc_metadata.data.rewrite_data("services.yaml", self._service_data)
 
+    @property
+    def all_cloud_environments(self):
+        "Cloud Environments data listing."
+        return copy.deepcopy(self._service_data["cloud_environments"])
+
     @property
     def all_services(self):
         "Service Categories data listing."
@@ -197,7 +207,7 @@ class Services(object):
                     if cloud_environment_doc["name"] == cloud_environment:
                         cloud_environment_doc_check = True
                         if environment:
-                            if cloud_environment_service["visibility"] == environment:
+                            if cloud_environment_doc["visibility"] == environment:
                                 cloud_doc_visibility_check = True
                         else:
                             cloud_doc_visibility_check = True
@@ -453,3 +463,55 @@ class Services(object):
         res.sort(key=lambda x: x.get("name", "").lower())
 
         return res
+
+    def all_services_by_cloud_environment(self, cloud_environment, environments):
+        """Retrieve all services filtered by cloud_environment
+        """
+        res = []
+        for srv in self.all_services:
+            if environments and cloud_environment:
+                for srv_cloud_environment in srv["cloud_environments"]:
+                    if srv_cloud_environment["name"] == cloud_environment:
+                        for environment in environments:
+                            if srv_cloud_environment["visibility"] == environment:
+                                res.append(srv)
+                    else:
+                        continue
+            else:
+                raise Exception("No cloud_environment or environments "
+                                "specified in function all_services_by_cloud_environment.")
+
+        # Sort services
+        res.sort(key=lambda x: x.get("service_title", "").lower())
+
+        return res
+
+    def all_services_by_cloud_environment_as_dict(self, cloud_environment, environments):
+        """Retrieve all services filtered by cloud_environment
+        Returns a dict keyed by service_type.
+        """
+
+        res = {}
+
+        if not (environments and cloud_environment):
+            raise Exception(
+                "No cloud_environment or environments specified in function all_services_by_cloud_environment."
+            )
+
+        for srv in self.all_services:
+            for srv_cloud_environment in srv.get("cloud_environments", []):
+                if srv_cloud_environment.get("name") == cloud_environment:
+                    for environment in environments:
+                        if srv_cloud_environment.get("visibility") == environment:
+                            service_type = srv.get("service_type")
+                            if service_type:
+                                res[service_type] = srv
+                            break
+        res = dict(
+            sorted(
+                res.items(),
+                key=lambda item: item[1].get("service_type", "").lower()
+            )
+        )
+
+        return res

otc_metadata/templates/build-html-docs.yaml.j2

@@ -0,0 +1,62 @@
+name: Build HTML Docs
+on:
+  pull_request:
+    types: [opened, reopened, synchronize, edited]
+jobs:
+  tox-docs:
+    runs-on: ubuntu-latest
+    steps:
+      {%- if environment == 'internal' %}
+      - uses: https://github.com/opentelekomcloud-infra/github-actions/.github/actions/tox-run-env@v1
+        with:
+          tox-env: docs
+          
+      - name: Upload documentation preview
+        {% raw -%}
+        if: ${{ github.event.pull_request.head.repo.full_name == github.repository }}
+        {%- endraw %}
+        uses: https://github.com/opentelekomcloud-infra/github-actions/.github/actions/tox-upload-swift@v1
+      {%- elif environment == 'public' %}
+      - uses: opentelekomcloud-infra/github-actions/.github/actions/tox-run-env@v1
+        with:
+          tox-env: docs
+          
+      - name: Upload documentation preview
+        {% raw -%}
+        if: ${{ github.event.pull_request.head.repo.full_name == github.repository }}
+        {%- endraw %}
+        uses: opentelekomcloud-infra/github-actions/.github/actions/tox-upload-swift@v1
+      {%- endif %}
+        with:
+          docs_path: "doc/build/html"
+          docs_service: {{ service_uri }}
+          {%- if environment == 'internal' %}
+          {% raw -%}
+          swift_container: "gitea_action_logs"
+          otc_swift_username: ${{ secrets.OTC_SWIFT_USERNAME }}
+          otc_swift_password: ${{ secrets.OTC_SWIFT_PASSWORD }}
+          otc_swift_project_name: ${{ secrets.OTC_SWIFT_PROJECT_NAME }}
+          otc_swift_domain: ${{ secrets.OTC_SWIFT_DOMAIN }}
+          otc_swift_endpoint: ${{ secrets.OTC_SWIFT_ENDPOINT }}
+          gitea_token: ${{ secrets.GITEA_TOKEN }}
+          gitea_server_url: ${{ gitea.server_url }}
+          repo: ${{ gitea.repository }}
+          pr_number: ${{ gitea.event.pull_request.number }}
+          run_id: ${{ gitea.run_id }}
+          ci_platform: gitea
+          {%- endraw %}
+          {%- elif environment == 'public' %}
+          {% raw -%}
+          swift_container: "gh_action_logs"
+          otc_swift_username: ${{ secrets.OTC_SWIFT_USERNAME }}
+          otc_swift_password: ${{ secrets.OTC_SWIFT_PASSWORD }}
+          otc_swift_project_name: ${{ secrets.OTC_SWIFT_PROJECT_NAME }}
+          otc_swift_domain: ${{ secrets.OTC_SWIFT_DOMAIN }}
+          otc_swift_endpoint: ${{ secrets.OTC_SWIFT_ENDPOINT }}
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          repo: ${{ github.repository }}
+          pr_number: ${{ github.event.pull_request.number }}
+          run_id: ${{ github.run_id }}
+          ci_platform: github
+          {%- endraw %}
+          {%- endif %}

otc_metadata/templates/build-pdf-docs.yaml.j2

@@ -0,0 +1,62 @@
+name: Build PDF Docs
+on:
+  pull_request:
+    types: [opened, reopened, synchronize, edited]
+jobs:
+  tox-pdf-docs:
+    runs-on: ubuntu-latest
+    steps:
+      {%- if environment == 'internal' %}
+      - uses: https://github.com/opentelekomcloud-infra/github-actions/.github/actions/tox-run-env@v1
+        with:
+          tox-env: pdf-docs
+          
+      - name: Upload documentation preview
+        {% raw -%}
+        if: ${{ github.event.pull_request.head.repo.full_name == github.repository }}
+        {%- endraw %}
+        uses: https://github.com/opentelekomcloud-infra/github-actions/.github/actions/tox-upload-swift@v1
+      {%- elif environment == 'public' %}
+      - uses: opentelekomcloud-infra/github-actions/.github/actions/tox-run-env@v1
+        with:
+          tox-env: pdf-docs
+          
+      - name: Upload documentation preview
+        {% raw -%}
+        if: ${{ github.event.pull_request.head.repo.full_name == github.repository }}
+        {%- endraw %}
+        uses: opentelekomcloud-infra/github-actions/.github/actions/tox-upload-swift@v1
+      {%- endif %}
+        with:
+          docs_path: "doc/build/pdf"
+          docs_service: {{ service_uri }}
+          {%- if environment == 'internal' %}
+          {% raw -%}
+          swift_container: "gitea_action_logs"
+          otc_swift_username: ${{ secrets.OTC_SWIFT_USERNAME }}
+          otc_swift_password: ${{ secrets.OTC_SWIFT_PASSWORD }}
+          otc_swift_project_name: ${{ secrets.OTC_SWIFT_PROJECT_NAME }}
+          otc_swift_domain: ${{ secrets.OTC_SWIFT_DOMAIN }}
+          otc_swift_endpoint: ${{ secrets.OTC_SWIFT_ENDPOINT }}
+          gitea_token: ${{ secrets.GITEA_TOKEN }}
+          gitea_server_url: ${{ gitea.server_url }}
+          repo: ${{ gitea.repository }}
+          pr_number: ${{ gitea.event.pull_request.number }}
+          run_id: ${{ gitea.run_id }}
+          ci_platform: gitea
+          {%- endraw %}
+          {%- elif environment == 'public' %}
+          {% raw -%}
+          swift_container: "gh_action_logs"
+          otc_swift_username: ${{ secrets.OTC_SWIFT_USERNAME }}
+          otc_swift_password: ${{ secrets.OTC_SWIFT_PASSWORD }}
+          otc_swift_project_name: ${{ secrets.OTC_SWIFT_PROJECT_NAME }}
+          otc_swift_domain: ${{ secrets.OTC_SWIFT_DOMAIN }}
+          otc_swift_endpoint: ${{ secrets.OTC_SWIFT_ENDPOINT }}
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          repo: ${{ github.repository }}
+          pr_number: ${{ github.event.pull_request.number }}
+          run_id: ${{ github.run_id }}
+          ci_platform: github
+          {%- endraw %}
+          {%- endif %}