changing the team as fg is now in PAAS

removed environment: internal for ocr
Reviewed-by: Gode, Sebastian <sebastian.gode@t-systems.com> Reviewed-by: Hasko, Vladimir <vladimir.hasko@t-systems.com> Co-authored-by: Pruthi, Vineet <vineet.pruthi@t-systems.com> Co-committed-by: Pruthi, Vineet <vineet.pruthi@t-systems.com>
2024-04-04 11:53:20 +00:00 · 2024-04-02 15:25:26 +00:00 · 2024-03-08 09:57:21 +00:00 · 2024-03-08 09:57:11 +00:00 · 2024-02-27 14:38:12 +00:00 · 2024-02-27 14:17:34 +00:00
294 changed files with 3778 additions and 2025 deletions
@@ -59,3 +59,6 @@ ChangeLog

 # Files created by releasenotes build
 releasenotes/build
+
+bindep.txt
+packages.txt
@@ -1,3 +1,3 @@
 [DEFAULT]
-test_path=./otc-metadata/tests
+test_path=./otc_metadata/tests/
 top_dir=./
@@ -1,6 +1,9 @@
-===============================
-ssh://git@gitea.eco.tsi-dev.otc-service.com:2222/infra/otc-metadata.git
-===============================
+============
+otc-metadata
+============
+
+Link: ssh://git@gitea.eco.tsi-dev.otc-service.com:2222/infra/otc-metadata.git
+

 Metadata about OTC for Ecosystem

@@ -13,6 +16,39 @@ Note that this is a hard requirement.
 * Source: https://github.com/infra/ssh://git@gitea.eco.tsi-dev.otc-service.com:2222/infra/otc-metadata.git

 Features
--------
+========

 * TODO
+
+Overview: service.yaml
+======================
+
+The :code:`service.yaml` file contains all data about services, service
+categories and the related documents of each service. The file is
+used as a base for several internal and external applications or
+websites like the Helpcenter 3.0 where the information about the document
+repositories and its properties are stored.
+
+File structure
+--------------
+
+The file is based on the yaml-file format and has three main sections
+which can be compared with database tables in a relational database.
+
+* documents: contains the information about every single document and its type
+  like umn, api-ref etc.
+
+* service category: contains the keyword and title of the service category
+
+* services: contains the repository information about the internal (Gitea) and
+  external location (GitHub) and all the necessary parameters of the service itself
+
+These sections, or better "tables" have
+their own keys and foreign keys so that the tables are linked together and
+the related information can be fetched.
+For the :code:`services` table
+the key is :code:`service_type` which has the foreign key in the
+:code:`documents` table. So a service can have multiple documents and each
+document can only be linked to one service.
+The key :code:`service_category` table is :code:`name` of the service category
+which is then used in the :code:`services` table as foreign key.
@@ -9,13 +9,13 @@
 # WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
 # License for the specific language governing permissions and limitations
 # under the License.
-__all__ = ['__version__', 'Docs']
+__all__ = ["__version__", "Docs"]

 import pbr.version

 from otc_metadata.services import Services  # flake8: noqa

-__version__ = pbr.version.VersionInfo('otc-metadata').version_string()
+__version__ = pbr.version.VersionInfo("otc-metadata").version_string()
 _service_manager = None


@@ -12,29 +12,45 @@
 # limitations under the License.

 import os
+import pathlib
 import yaml

-__all__ = ['read_data']
+__all__ = ["read_data"]

 DATA_DIR = os.path.dirname(__file__)


 def read_data(filename):
-    """Return data that is shipped inside the Python package.
-
-    """
+    """Return data that is shipped inside the Python package."""

    filepath = os.path.join(DATA_DIR, filename)
-    with open(filepath, 'r') as fd:
-        return yaml.safe_load(fd)
+    with open(filepath, "r") as fd:
+        data = yaml.safe_load(fd)
+        # Merge data found in individual element files
+        data.setdefault("documents", list())
+        data.setdefault("services", list())
+        data.setdefault("service_categories", list())
+        for item in pathlib.Path(DATA_DIR, "documents").glob("*.yaml"):
+            with open(item, "r") as fp:
+                data["documents"].append(yaml.safe_load(fp))
+        for item in pathlib.Path(DATA_DIR, "services").glob("*.yaml"):
+            with open(item, "r") as fp:
+                data["services"].append(yaml.safe_load(fp))
+        for item in pathlib.Path(DATA_DIR, "service_categories").glob(
+            "*.yaml"
+        ):
+            with open(item, "r") as fp:
+                data["service_categories"].append(yaml.safe_load(fp))
+
+        return data
+

 def rewrite_data(filename, data):
-    """Rewrites data formatting it
-
-    """
+    """Rewrites data formatting it"""
    from ruamel.yaml import YAML
+
    _yaml = YAML()
    _yaml.indent(mapping=2, sequence=4, offset=2)
    filepath = os.path.join(DATA_DIR, filename)
-    with open(filepath, 'w') as fd:
+    with open(filepath, "w") as fd:
        _yaml.dump(data, fd)
@@ -0,0 +1,8 @@
+---
+environment: public
+link: /architecture-center/blueprints/
+pdf_name: architecture-center-blueprints
+rst_location: doc/blueprints/source
+service_type: ac
+title: Blueprints
+type: blueprints
@@ -0,0 +1,8 @@
+---
+environment: internal
+link: /architecture-center/caf/
+pdf_name: architecture-center-cloud-adoption-framework
+rst_location: doc/caf/source
+service_type: ac
+title: Cloud Adoption Framework
+type: caf
@@ -0,0 +1,9 @@
+---
+hc_location: api/antiddos
+html_location: docs/antiddos/api-ref
+link: /anti-ddos/api-ref/
+pdf_name: antiddos-api-ref
+rst_location: api-ref/source
+service_type: antiddos
+title: API Reference
+type: api-ref
@@ -0,0 +1,9 @@
+---
+hc_location: usermanual/antiddos
+html_location: docs/antiddos/umn
+link: /anti-ddos/umn/
+pdf_name: antiddos-umn
+rst_location: umn/source
+service_type: antiddos
+title: User Guide
+type: umn
@@ -0,0 +1,9 @@
+---
+hc_location: api/aom
+html_location: docs/aom/api-ref
+link: /application-operations-management/api-ref/
+pdf_name: aom-api-ref
+rst_location: api-ref/source
+service_type: aom
+title: API Reference
+type: api-ref
@@ -0,0 +1,9 @@
+---
+hc_location: usermanual/aom
+html_location: docs/aom/umn
+link: /application-operations-management/umn/
+pdf_name: aom-umn
+rst_location: umn/source
+service_type: aom
+title: User Guide
+type: umn
@@ -0,0 +1,10 @@
+---
+environment: internal
+hc_location: usermanual2/aom
+html_location: docs/aom/umn2
+link: /application-operations-management/umn2/
+pdf_name: aom-umn2.0
+rst_location: umn2/source
+service_type: aom
+title: User Guide 2.0
+type: umn2
@@ -0,0 +1,9 @@
+---
+hc_location: api/apig
+html_location: docs/apig/api-ref
+link: /api-gateway/api-ref/
+pdf_name: apig-api-ref
+rst_location: api-ref/source
+service_type: apig
+title: API Reference
+type: api-ref
@@ -0,0 +1,9 @@
+---
+hc_location: usermanual/apig
+html_location: docs/apig/umn
+link: /api-gateway/umn/
+pdf_name: apig-umn
+rst_location: umn/source
+service_type: apig
+title: User Guide
+type: umn
@@ -0,0 +1,10 @@
+---
+environment: internal
+hc_location: api-usage/guidelines
+html_location: docs/apiu/guidelines
+link: /api-usage/guidelines/
+pdf_name: apiu-guidelines
+rst_location: doc/guidelines/source
+service_type: apiu
+title: API Usage Guidelines
+type: guidelines
@@ -0,0 +1,10 @@
+---
+environment: internal
+hc_location: api/apm
+html_location: docs/apm/api-ref
+link: /application-performance-management/api-ref/
+pdf_name: apm-api-ref
+rst_location: api-ref/source
+service_type: apm
+title: API Reference
+type: api-ref
@@ -0,0 +1,10 @@
+---
+environment: internal
+hc_location: usermanual/apm
+html_location: docs/apm/umn
+link: /application-performance-management/umn/
+pdf_name: apm-umn
+rst_location: umn/source
+service_type: apm
+title: User Guide
+type: umn
@@ -0,0 +1,9 @@
+---
+hc_location: api/as
+html_location: docs/as/api-ref
+link: /auto-scaling/api-ref/
+pdf_name: as-api-ref
+rst_location: api-ref/source
+service_type: as
+title: API Reference
+type: api-ref
@@ -0,0 +1,9 @@
+---
+hc_location: devg/as
+html_location: docs/as/dev
+link: /auto-scaling/dev-guide/
+pdf_name: as-dev-guide
+rst_location: dev_guide/source
+service_type: as
+title: Developer Guide
+type: dev
@@ -0,0 +1,9 @@
+---
+hc_location: usermanual/as
+html_location: docs/as/umn
+link: /auto-scaling/umn/
+pdf_name: as-umn
+rst_location: umn/source
+service_type: as
+title: User Guide
+type: umn
@@ -0,0 +1,6 @@
+---
+link: /business-dashboard/umn/
+rst_location: umn/source
+service_type: bd
+title: User Guide
+type: umn
@@ -0,0 +1,10 @@
+---
+hc_location: bestpractice/blueprints
+environment: internal
+html_location: docs/blueprints/best-practice
+link: /blueprints/best-practice/
+pdf_name: blueprints-best-practice
+rst_location: doc/best-practice/source
+service_type: blueprints
+title: Best Practice
+type: best-practice
@@ -0,0 +1,9 @@
+---
+hc_location: api/bms
+html_location: docs/bms/api-ref
+link: /bare-metal-server/api-ref/
+pdf_name: bms-api-ref
+rst_location: api-ref/source
+service_type: bms
+title: API Reference
+type: api-ref
@@ -0,0 +1,9 @@
+---
+hc_location: devg/bms
+html_location: docs/bms/dev
+link: /bare-metal-server/dev-guide/
+pdf_name: bms-dev-guide
+rst_location: dev_guide/source
+service_type: bms
+title: Developer Guide
+type: dev
@@ -0,0 +1,9 @@
+---
+hc_location: bpicg/bms
+html_location: docs/bms/image-creation-guide
+link: /bare-metal-server/image-creation-guide/
+pdf_name: bms-image-creation-guide
+rst_location: doc/image-creation-guide/source
+service_type: bms
+title: Private Image Creation Guide
+type: image-creation-guide
@@ -0,0 +1,9 @@
+---
+hc_location: usermanual/bms
+html_location: docs/bms/umn
+link: /bare-metal-server/umn/
+pdf_name: bms-umn
+rst_location: umn/source
+service_type: bms
+title: User Guide
+type: umn
@@ -0,0 +1,9 @@
+---
+hc_location: api/cbr
+html_location: docs/cbr/api-ref
+link: /cloud-backup-recovery/api-ref/
+pdf_name: cbr-api-ref
+rst_location: api-ref/source
+service_type: cbr
+title: API Reference
+type: api-ref
@@ -0,0 +1,10 @@
+---
+hc_location: bestpractice/cbr
+environment: internal
+html_location: docs/cbr/best-practice
+link: /cloud-backup-recovery/best-practice/
+pdf_name: cbr-best-practice
+rst_location: doc/best-practice/source
+service_type: cbr
+title: Best Practice
+type: best-practice
@@ -0,0 +1,9 @@
+---
+hc_location: usermanual/cbr
+html_location: docs/cbr/umn
+link: /cloud-backup-recovery/umn/
+pdf_name: cbr-umn
+rst_location: umn/source
+service_type: cbr
+title: User Guide
+type: umn
@@ -0,0 +1,7 @@
+---
+link: /cloud-create/api-ref/
+pdf_name: cc-api-ref
+rst_location: api-ref/source
+service_type: cc
+title: API Reference
+type: api-ref
@@ -0,0 +1,8 @@
+---
+html_location: docs/cc/umn
+link: /cloud-create/umn/
+pdf_name: cc-umn
+rst_location: umn/source
+service_type: cc
+title: User Guide
+type: umn
@@ -0,0 +1,9 @@
+---
+hc_location: api2/cce
+html_location: docs/cce/api-ref
+link: /cloud-container-engine/api-ref/
+pdf_name: cce-api-ref
+rst_location: api-ref/source
+service_type: cce
+title: API Reference
+type: api-ref
@@ -0,0 +1,10 @@
+---
+hc_location: bestpractice/cce
+environment: internal
+html_location: docs/cce/best-practice
+link: /cloud-container-engine/best-practice/
+pdf_name: cce-best-practice
+rst_location: doc/best-practice/source
+service_type: cce
+title: Best Practice
+type: best-practice
@@ -0,0 +1,8 @@
+---
+hc_location: usermanual2/cce
+html_location: docs/cce/umn
+link: /cloud-container-engine/umn/
+rst_location: umn/source
+service_type: cce
+title: User Guide
+type: umn
@@ -0,0 +1,10 @@
+---
+hc_location: api/cci
+environment: internal
+html_location: docs/cci/api-ref
+link: /cloud-container-instance/api-ref/
+pdf_name: cci-api-ref
+rst_location: api-ref/source
+service_type: cci
+title: API Reference
+type: api-ref
@@ -0,0 +1,10 @@
+---
+hc_location: usermanual/cci
+environment: internal
+html_location: docs/cci/umn
+link: /cloud-container-instance/umn/
+pdf_name: cci-umn
+rst_location: umn/source
+service_type: cci
+title: User Guide
+type: umn
@@ -0,0 +1,9 @@
+---
+hc_location: api/ces
+html_location: docs/ces/api-ref
+link: /cloud-eye/api-ref/
+pdf_name: ces-api-ref
+rst_location: api-ref/source
+service_type: ces
+title: API Reference
+type: api-ref
@@ -0,0 +1,9 @@
+---
+hc_location: usermanual/ces
+html_location: docs/ces/umn
+link: /cloud-eye/umn/
+pdf_name: ces-umn
+rst_location: umn/source
+service_type: ces
+title: User Guide
+type: umn
@@ -0,0 +1,9 @@
+---
+hc_location: api/csbs
+html_location: docs/csbs/api-ref
+link: /cloud-server-backup-service/api-ref/
+pdf_name: csbs-api-ref
+rst_location: api-ref/source
+service_type: csbs
+title: API Reference
+type: api-ref
@@ -0,0 +1,9 @@
+---
+hc_location: usermanual/csbs
+html_location: docs/csbs/umn
+link: /cloud-server-backup-service/umn/
+pdf_name: csbs-umn
+rst_location: umn/source
+service_type: csbs
+title: User Guide
+type: umn
@@ -0,0 +1,10 @@
+---
+hc_location: api/cse
+environment: internal
+html_location: docs/cse/api-ref
+link: /cloud-service-engine/api-ref/
+pdf_name: cse-api-ref
+rst_location: api-ref/source
+service_type: cse
+title: API Reference
+type: api-ref
@@ -0,0 +1,10 @@
+---
+hc_location: usermanual/cse
+environment: internal
+html_location: docs/cse/umn
+link: /cloud-service-engine/umn/
+pdf_name: cse-umn
+rst_location: umn/source
+service_type: cse
+title: User Guide
+type: umn
@@ -0,0 +1,9 @@
+---
+hc_location: api/css
+html_location: docs/css/api-ref
+link: /cloud-search-service/api-ref/
+pdf_name: css-api-ref
+rst_location: api-ref/source
+service_type: css
+title: API Reference
+type: api-ref
@@ -0,0 +1,9 @@
+---
+hc_location: bestpractice/css
+html_location: docs/css/best-practice
+link: /cloud-search-service/best-practice/
+pdf_name: css-best-practice
+rst_location: doc/best-practice/source
+service_type: css
+title: Best Practice
+type: best-practice
@@ -0,0 +1,9 @@
+---
+hc_location: usermanual/css
+html_location: docs/css/umn
+link: /cloud-search-service/umn/
+pdf_name: css-umn
+rst_location: umn/source
+service_type: css
+title: User Guide
+type: umn
@@ -0,0 +1,9 @@
+---
+hc_location: api/cts
+html_location: docs/cts/api-ref
+link: /cloud-trace-service/api-ref/
+pdf_name: cts-api-ref
+rst_location: api-ref/source
+service_type: cts
+title: API Reference
+type: api-ref
@@ -0,0 +1,9 @@
+---
+hc_location: usermanual/cts
+html_location: docs/cts/umn
+link: /cloud-trace-service/umn/
+pdf_name: cts-umn
+rst_location: umn/source
+service_type: cts
+title: User Guide
+type: umn
@@ -0,0 +1,9 @@
+---
+hc_location: api/dataartsstudio
+html_location: docs/dataartsstudio/api-ref
+link: /data-arts-studio/api-ref/
+pdf_name: dataarts_studio-api-ref
+rst_location: api-ref/source
+service_type: dataarts_studio
+title: API Reference
+type: api-ref
@@ -0,0 +1,9 @@
+---
+hc_location: usermanual/dataartsstudio
+html_location: docs/dataartsstudio/umn
+link: /data-arts-studio/umn/
+pdf_name: dataarts_studio-umn
+rst_location: umn/source
+service_type: dataarts_studio
+title: User Guide
+type: umn
@@ -0,0 +1,9 @@
+---
+hc_location: usermanual/dbss
+html_location: docs/dbss/umn
+link: /database-security-service/umn/
+pdf_name: dbss-umn
+rst_location: umn/source
+service_type: dbss
+title: User Guide
+type: umn
--- a/Show More
+++ b/Show More