fix pep8 and add new content for helpcenter
Before Width: | Height: | Size: 109 KiB After Width: | Height: | Size: 109 KiB |
Before Width: | Height: | Size: 60 KiB After Width: | Height: | Size: 60 KiB |
Before Width: | Height: | Size: 68 KiB After Width: | Height: | Size: 68 KiB |
Before Width: | Height: | Size: 16 KiB After Width: | Height: | Size: 16 KiB |
@ -63,6 +63,3 @@ Th EpMon notification consists of several fields:
|
||||
+----------------------------+------------------------------------------------------------------+
|
||||
| **Request error response** | Error result of the requested API call |
|
||||
+----------------------------+------------------------------------------------------------------+
|
||||
|
||||
|
||||
|
Before Width: | Height: | Size: 188 KiB After Width: | Height: | Size: 188 KiB |
Before Width: | Height: | Size: 42 KiB After Width: | Height: | Size: 42 KiB |
Before Width: | Height: | Size: 56 KiB After Width: | Height: | Size: 56 KiB |
Before Width: | Height: | Size: 88 KiB After Width: | Height: | Size: 88 KiB |
Before Width: | Height: | Size: 321 KiB After Width: | Height: | Size: 321 KiB |
Before Width: | Height: | Size: 142 KiB After Width: | Height: | Size: 142 KiB |
Before Width: | Height: | Size: 157 KiB After Width: | Height: | Size: 157 KiB |
Before Width: | Height: | Size: 184 KiB After Width: | Height: | Size: 184 KiB |
Before Width: | Height: | Size: 33 KiB After Width: | Height: | Size: 33 KiB |
Before Width: | Height: | Size: 96 KiB After Width: | Height: | Size: 96 KiB |
Before Width: | Height: | Size: 165 KiB After Width: | Height: | Size: 165 KiB |
Before Width: | Height: | Size: 75 KiB After Width: | Height: | Size: 75 KiB |
Before Width: | Height: | Size: 101 KiB After Width: | Height: | Size: 101 KiB |
Before Width: | Height: | Size: 68 KiB After Width: | Height: | Size: 68 KiB |
Before Width: | Height: | Size: 66 KiB After Width: | Height: | Size: 66 KiB |
@ -25,4 +25,3 @@ ApiMon Flow Process
|
||||
alerts on Alerta.
|
||||
#. Notifications containing alert details are sent to Zulip
|
||||
#. Every test scenario stores it's job output log into Swift object storage for further analysis and investigation.
|
||||
|
8
doc/source/apimon/index.rst
Normal file
@ -0,0 +1,8 @@
|
||||
=============================
|
||||
APImon Internal Documentation
|
||||
=============================
|
||||
|
||||
.. toctree::
|
||||
:maxdepth: 2
|
||||
|
||||
apimon_training/index
|
79
doc/source/helpcenter/hc_ops/backstage_add_repo.rst
Normal file
@ -0,0 +1,79 @@
|
||||
===================================
|
||||
Add a new Repository with Backstage
|
||||
===================================
|
||||
|
||||
This document describes the steps to be done to register a new Helpcenter Repository.
|
||||
|
||||
1. Register the Service in infra/metadata
|
||||
-----------------------------------------
|
||||
|
||||
Modify the following sample files for your need and open a Pull Request in the respective Gitea Repository.
|
||||
|
||||
Service registration under: `otc_metadata/data/services <https://gitea.eco.tsi-dev.otc-service.com/infra/otc-metadata/src/branch/main/otc_metadata/data/services>`_
|
||||
|
||||
.. code::
|
||||
|
||||
---
|
||||
environment: public
|
||||
repositories:
|
||||
- environment: internal
|
||||
repo: docs/cloud-container-engine
|
||||
type: gitea
|
||||
- environment: public
|
||||
repo: opentelekomcloud-docs/cloud-container-engine
|
||||
type: github
|
||||
service_category: container
|
||||
service_title: Cloud Container Engine
|
||||
service_type: cce
|
||||
service_uri: cloud-container-engine
|
||||
teams:
|
||||
- name: docs-container-rw
|
||||
permission: write
|
||||
|
||||
Documents registration under: `otc_metadata/data/documents <https://gitea.eco.tsi-dev.otc-service.com/infra/otc-metadata/src/branch/main/otc_metadata/data/documents>`_
|
||||
|
||||
.. code::
|
||||
|
||||
---
|
||||
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
|
||||
|
||||
2. Use Backstage to create a Git internal / public Repository
|
||||
-------------------------------------------------------------
|
||||
|
||||
- Open Backstage under: https://backstage.eco.tsi-dev.otc-service.com/
|
||||
- Navigate to :code:`Create...` in the left sidebar
|
||||
- Choose :code:`Helpcenter Service` from the list in the main section
|
||||
- Fill in the necessary information to create a Helpcenter repository in Gitea (internal)
|
||||
|
||||
.. figure:: images/hc_service.png
|
||||
|
||||
- Fill in the necessary information to create a Helpcenter repository in GitHub (public)
|
||||
|
||||
.. image:: images/hc_service2.png
|
||||
|
||||
3. Use Backstage to register the repositories to Zuul and set proper gitstyring permissions
|
||||
-------------------------------------------------------------------------------------------
|
||||
|
||||
- Open Backstage under: https://backstage.eco.tsi-dev.otc-service.com/
|
||||
- Navigate to :code:`Create...` in the left sidebar
|
||||
- Choose :code:`Action: Register repository in Zuul` from the list in the main section
|
||||
- Fill in the necessary information as shown in the screenshots below
|
||||
|
||||
.. image:: images/hc_service3.png
|
||||
|
||||
.. image:: images/hc_service4.png
|
||||
|
||||
4. Approve Changes for gitstyring and Zuul
|
||||
------------------------------------------
|
||||
|
||||
- Navigate to gitstyring repository in Gitea: https://gitea.eco.tsi-dev.otc-service.com/infra/gitstyring/pulls/
|
||||
- Review and approve changes in the related Pull Request
|
||||
- Wait until Gate-process has been finished
|
||||
- Navigate to Zuul repository in Github: https://github.com/opentelekomcloud-infra/zuul-config/pulls
|
||||
- Review and approve changes in the related Pull Request
|
8
doc/source/helpcenter/hc_ops/index.rst
Normal file
@ -0,0 +1,8 @@
|
||||
=====================
|
||||
Helpcenter Operations
|
||||
=====================
|
||||
|
||||
.. toctree::
|
||||
:maxdepth: 2
|
||||
|
||||
backstage_add_repo
|
@ -14,5 +14,4 @@ If you have found any problems which affects the **production Helpcenter** pleas
|
||||
|
||||
If there is a request for completely new service or new document type (which was not yet introduced to HelpCenter 3.0) then please open an issue on the otc-metadata repository: https://gitea.eco.tsi-dev.otc-service.com/infra/otc-metadata/issues
|
||||
|
||||
|
||||
For general questions you can write an E-Mail to the `Ecosystems Squad <mailto:dl-pbcotcdeleco@t-systems.com>`_.
|
Before Width: | Height: | Size: 141 KiB After Width: | Height: | Size: 141 KiB |
Before Width: | Height: | Size: 101 KiB After Width: | Height: | Size: 101 KiB |
Before Width: | Height: | Size: 171 KiB After Width: | Height: | Size: 171 KiB |
Before Width: | Height: | Size: 104 KiB After Width: | Height: | Size: 104 KiB |
Before Width: | Height: | Size: 98 KiB After Width: | Height: | Size: 98 KiB |
Before Width: | Height: | Size: 25 KiB After Width: | Height: | Size: 25 KiB |