Initalized CPN docs

doc/requirements.txt

@@ -8,5 +8,4 @@ reno>=3.1.0 # Apache-2.0
 otc-sphinx-directives>=0.1.0
 sphinx-minify>=0.0.1 # Apache-2.0
 git+https://gitea.eco.tsi-dev.otc-service.com/infra/otc-metadata.git#egg=otc_metadata
-setuptools
+setuptools
-gitpython

doc/source/apimon/index.rst

@@ -1,8 +0,0 @@
-=============================
-APImon Internal Documentation
-=============================
-
-.. toctree::
-   :maxdepth: 2
-
-   apimon_training/index

doc/source/captcha_service/configuration_of_a_new_site.rst

@@ -1,75 +0,0 @@
-===========================
-Configuration of a new Site
-===========================
-
-Getting Started
----------------
-
-1. Open the mCaptcha website: https://captcha.otc-service.com/
-2. Log-In with your credentials
-3. Click on "New Site"
-
-.. figure:: images/NewSite.png
-
-4. Click on "Advance Options" for specifying more difficulty breakpoints
-
-.. figure:: images/AdvanceOptions.png
-
-5. Specify a description, cooldown Duration and difficulty levels
-
-A good start for a contact formular would be the following paramneters:
-
-.. figure:: images/ExampleOptions.png
-
-6. Now you should be able to see your Captcha solution working by clicking on the "View Deployment" button.
-
-.. figure:: images/ViewDeployment.png
-
-
-Configuring your Frontend-Website
----------------------------------
-
-As you now have properly configured everything on mCaptcha you will need to start including the Captcha in your frontend application.
-For this you will need to aquire your sitekey and the URL to the captcha. You can simply copy the URL from the "View Deployment" button. It should look something like this: https://captcha.otc-service.com/widget/?sitekey=RxZhnXBKERnTNRUAuNABst0v1Zvj5DZe
-
-Once you have obtained this head over to GitHub and follow the instructions to include the Captcha on your page based on your used JavaScript framework: https://github.com/mCaptcha/glue
-
-Configuring your backend
-------------------------
-
-Your backend needs to check the validity of the captcha token which the user generated.
-You can do this easily by sending an request using the generated token from the client, your sitekey and your secret key to mCaptcha.
-
-.. code:: Javascript
-
-    const postData = {
-      token: captcha_token,
-      key: captcha_sitekey,
-      secret: process.env.MCAPTCHA_SECRET
-    };
-
-    const response = await fetch(process.env.MCAPTCHA_URL + 'api/v1/pow/siteverify', {
-      method: 'POST',
-      headers: {
-        'Content-Type': 'application/json'
-      },
-      body: JSON.stringify(postData)
-    });
-
-Send the request to https://captcha.otc-service.com/api/v1/pow/siteverify
-
-The response then includes a data field and must have the valid field set to true.
-
-.. code:: Javascript
-
-    if (!response.ok) {
-      throw new Error('Captcha response was not ok');
-    }
-
-    const data = await response.json();
-    if (data["valid"] !== true) {
-      return {
-        status: "fail",
-        message: "Captcha verification failed!"
-      };
-    }

doc/source/captcha_service/getting_access.rst

@@ -1,19 +0,0 @@
-=====================================
-Getting Access to the Captcha Service
-=====================================
-
-.. note::
-    Due to a current issue with mCaptcha we can't provide unqiue accounts yet and will instead provide only the required keys for setting up your captcha solution.
-
-If you need a captcha solution for one of your webpages please contact the Ecosystem Squad by writing an E-Mail to: `DL OTC Ecosystem Squad <mailto:otc_ecosystem_squad@t-systems.com>`
-Please state the following:
-
-1. Your application name
-
-.. tip::
-    For example a contact formular can take ~5s for a client to solve to prevent a lot of spam, while just checking before redirecting to a webpage should be done in less than 1s.
-
-2. Desired Average Solving time.
-
-We will provide you with a public sitekey which you will need to integrate the captcha access as well as a secret key which your backend needs for verifying whether the captcha was solved or not.
-

doc/source/captcha_service/index.rst

@@ -1,30 +0,0 @@
-===============================================
-Ecosystem Captcha Service - Powered by mCaptcha
-===============================================
-
-.. toctree::
-    :maxdepth: 1
-
-    getting_access
-    configuration_of_a_new_site
-
-General informations
---------------------
-
-The Captcha Service is powered by mCaptcha, the used source can be found here: https://github.com/opentelekomcloud-infra/mCaptcha.
-
-If you have any issues with the service feel free to open an issue there. If it's not related to our infrastructure we will either do an upstream fix or open an upstream issue.
-
-The privacy policy can be found here: https://mcaptcha.org/privacy-policy.
-In addition to that the whole Captcha server is hosted on OTC, so no user traffic or telemetry will leave our infrastructure.
-
-How it works
-------------
-
-Compared to classic Captcha Solutions like Google's Recaptcha this service does not have any image challenges, audio challenges or any Cookie tracking.
-Instead it is using a proof-of-work solution. Each user will get a small puzzle which the browser needs to solve. This works by using WebAssembly to compute the solution using the CPU of the device from the client.
-Typically this will not take longer than around one second, although this time can be modified in the settings of mCaptcha for each unique site. In case there will be lots of traffic the puzzle will get more complex and the time for solving it will increase.
-This effectively makes attacks from outside very hard to impossible as they would need a lot of compute power to break the Captcha.
-ReCaptcha works in the same way, if you solve a lot of Captchas they will get harder and harder, just that you need to click on more and more pictures there instead of solving mathematical puzzles with compute power.
-
-For more information on how to configure mCaptcha head over to `Configuration of a new Site <configuration_of_a_new_site>`

doc/source/conf.py

@@ -16,8 +16,6 @@
 
 import os
 import sys
-from git import Repo
-from datetime import datetime
 
 extensions = [
     'otcdocstheme',
@@ -113,9 +111,3 @@ html_copy_source = False
 
 # -- Options for PDF output --------------------------------------------------
 latex_documents = []
-
-# Get the Git commit values for last updated timestamp on each page
-repo = Repo(search_parent_directories=True)
-commit = repo.head.commit
-current_commit_hash = commit.hexsha
-current_commit_time = commit.committed_datetime.strftime('%Y-%m-%d %H:%M')

doc/source/cpn/backend/index.rst

@@ -10,5 +10,5 @@ You can update the Backend by following those steps:
 1. Merge the Pull-Request
 2. Wait until the gate job has been passed
 3. Look at the Zuul-logs from the gate job. Find the line with `Successfully tagged quay.io` and remember the `:change_xx_latest` value
-4. Open a Pull-Request to adjust the kustomization config to the new tag from step 3. https://github.com/opentelekomcloud-infra/system-config/blob/main/kubernetes/circle-partner-navigator/overlays/prod/kustomization.yaml#L20
+4. Open a Pull-Request to adjust the kustomization config to the new tag from step 3. https://github.com/opentelekomcloud-infra/system-config/blob/main/kubernetes/circle-partner-navigator/base/kustomization.yaml#L14
 5. Merge this Pull-Request and wait 10 minutes.

doc/source/cpn/frontend/index.rst

@@ -8,9 +8,9 @@ Updating the Frontend
 You can update the Frontend by following those steps:
 
 1. Merge the Pull-Request
-2. Wait at least 10 minutes
+2. Tag the desired commit and push the tag to Github. It should be visible afterwards on this page: https://github.com/opentelekomcloud-infra/circle-partner-navigator-frontend/tags
-3. Check whether your tag has been successfully published to the container repository: https://quay.io/repository/opentelekomcloud/circle-partner-navigator-frontend?tab=tags
+3. Wait at least 10 minutes
-4. Open a Pull-Request to adjust the kustomization config to the new tag. https://github.com/opentelekomcloud-infra/system-config/blob/main/kubernetes/circle-partner-navigator/overlays/prod/kustomization.yaml#L22
+4. Open a Pull-Request to adjust the kustomization config to the new tag. https://github.com/opentelekomcloud-infra/system-config/blob/main/kubernetes/circle-partner-navigator/base/kustomization.yaml#L16
 5. Merge this Pull-Request and wait 10 minutes.
 
 Be aware that updating the Frontend will also pull the data from the Backend again and as a result will also update the partner data on the website.

doc/source/cpn/index.rst

@@ -3,7 +3,7 @@ Circle Partner Navigator
 ========================
 
 .. toctree::
-    :maxdepth: 1
+    :maxdepth: 1  
 
     backend/index
     frontend/index

doc/source/helpcenter/hc_ops/backstage_add_repo.rst

@@ -1,79 +0,0 @@
-===================================
-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

doc/source/helpcenter/hc_ops/index.rst

@@ -1,9 +0,0 @@
-=====================
-Helpcenter Operations
-=====================
-
-.. toctree::
-   :maxdepth: 2
-
-   backstage_add_repo
-   service_based_view

doc/source/helpcenter/hc_ops/service_based_view.rst

@@ -1,87 +0,0 @@
-============================
-Service Based View knowledge
-============================
-
-This document describe necessary knowledge about our Service Based View (SVB)
-which is the landing page for the specific service. There you have a short
-description of the service and you get all the links for the service
-documents.
-
-Service Based View Code Snippets
---------------------------------
-
-The following Code Snippets represents the necessary information which is
-needed that SVB can run properly.
-
-Internal SVB Code Snippet
-^^^^^^^^^^^^^^^^^^^^^^^^^
-
-.. code::
-
-    Cloud Container Engine
-    ======================
-
-    CCE provides highly scalable, high-performance, enterprise-class Kubernetes clusters. It supports native Kubernetes applications, tools and easy setup of container runtime environment.
-
-    .. directive_wrapper::
-      :class: container-sbv
-
-      .. service_card::
-          :service_type: cce
-          :environment: internal
-          :umn: Describes the basic concepts, functions, key terms, best practices, FAQs and steps for quickly creating clusters and containerized applications.
-          :api-ref: Describes the APIs provided by CCE including the functions, parameters, and examples of each API.
-          :best-practice: To use Cloud Container Engine more securely, reliably, flexibly, and efficiently, you are advised to follow the following best practices.
-
-    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>`_
-
-
-Public SVB Code Snippet
-^^^^^^^^^^^^^^^^^^^^^^^
-
-.. code::
-
-    Cloud Container Engine
-    ======================
-
-    CCE provides highly scalable, high-performance, enterprise-class Kubernetes clusters. It supports native Kubernetes applications, tools and easy setup of container runtime environment.
-
-    .. directive_wrapper::
-      :class: container-sbv
-
-      .. service_card::
-          :service_type: cce
-          :umn: Describes the basic concepts, functions, key terms, best practices, FAQs and steps for quickly creating clusters and containerized applications.
-          :api-ref: Describes the APIs provided by CCE including the functions, parameters, and examples of each API.
-          :best-practice: To use Cloud Container Engine more securely, reliably, flexibly, and efficiently, you are advised to follow the following best practices.
-
-    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>`_
-
-Possible Document Names
-^^^^^^^^^^^^^^^^^^^^^^^
-
-The following document short names can be used to reference specific document types which are listed in the `Helpcenter Metadata <https://gitea.eco.tsi-dev.otc-service.com/infra/otc-metadata>`_ .
-New document types can be requested by creating an issue under https://github.com/opentelekomcloud-docs/docsportal/issues or get in contact
-with Ecosystem Squad.
-
-* api-ref
-* blueprints
-* caf
-* dev
-* image-creation-guide
-* tool-guide
-* mycredential
-* public-images
-* sdk-ref
-* operation-guide
-* operation-guide-lts
-* parallel-file-system
-* permissions-configuration-guide
-* permissions
-* swiftapi
-* s3api
-* umn
-* umn2
-* best-practice
-* sqlreference
-* guidelines

doc/source/helpcenter/helpcenter_training/faq/how_to_update_a_component_page.rst

@@ -1,94 +0,0 @@
-============================
-How to update component page
-============================
-
-**Goal**
-
-Mark service as depricated
-
-.. image:: faq_images/storage_component_overview2.png
-   :target: faq_images/storage_component_overview2.png
-   :alt: storage_component_overview
-
-
-1)**Create fork on github**
-
-You need to create fork only in case  you don’t have existing  already
-
-.. image:: faq_images/create_github_fork_1.png
-   :target: faq_images/create_github_fork_1.png
-   :alt: create_fork_1
-
-Choose your name as owner
-
-.. image:: faq_images/create_github_fork_2.png
-   :target: faq_images/create_github_fork_2.png
-   :alt: create_fork_2
-
-2)**In case you have existing fork**
-
-You need to sync your fork with main. Then go to branches.
-
-.. image:: faq_images/github_sync_fork.png
-   :target: faq_images/github_sync_fork.png
-   :alt: sync_fork
-
-3)**Create new branch**
-
-.. image:: faq_images/github_new_branch.png
-   :target: faq_images/github_new_branch.png
-   :alt: new_branch
-
-Add new branch name:
-
-.. image:: faq_images/github_new_branch2.png
-   :target: faq_images/github_new_branch2.png
-   :alt: new_branch2
-
-4)**Edit index.rst**
-
-.. image:: faq_images/edit_index_rst.png
-   :target: faq_images/edit_index_rst.png
-   :alt: edit_index.rst
-
-5)**Edit conf.py **
-
-.. image:: faq_images/edit_conf_py.png
-   :target: faq_images/edit_conf_py.png
-   :alt: edit_conf_py
-
-6)**Commit changes**
-
-Once you finish with editing of pages click commit changes.
-
-.. image:: faq_images/commit_changes.png
-   :target: faq_images/commit_changes.png
-   :alt: commit_changes
-
-7)**Compare & pull request**
-
-.. image:: faq_images/compare_pull_request.png
-   :target: faq_images/compare_pull_request.png
-   :alt: compare_changes
-
-8)**Comparing changes**
-
-Check correct source and target pull request and branch. Then create pull request.
-
-.. image:: faq_images/compare_changes.png
-   :target: faq_images/compare_changes.png
-   :alt: compare_changes2
-
-9)**Wait for checks, approve and gate**
-
-.. image:: faq_images/check_approve_gate.png
-   :target: faq_images/check_approve_gate.png
-   :alt: check_approve_gate
-
-10)**Delete branch**
-
-After successful merge delete branch.
-
-.. image:: faq_images/delete_branch.png
-   :target: faq_images/delete_branch.png
-   :alt: delete_branch

doc/source/helpcenter/helpcenter_training/faq/how_to_update_a_landing_page.rst

@@ -1,89 +0,0 @@
-=============================
-How to update landing page
-=============================
-
-**Goal**
-
-Mark service as depricated
-
-.. image:: faq_images/storage_component_overview.png
-   :target: faq_images/storage_component_overview.png
-   :alt: storage_component_overview
-
-1)**Create fork on gitea**
-
-You need to create fork only in case  you don’t have existing  already
-
-.. image:: faq_images/infra_otc_metadata.png
-   :target: faq_images/infra_otc_metadata.png
-   :alt: infra_otc_metadata
-
-https://gitea.eco.tsi-dev.otc-service.com/marmulle/otc-metadata/src/branch/main/otc_metadata/data/documents
-
-2)**Sync fork**
-
-Sync work with main currently do not support sync in console and you need to do it manually.
-
-- you need to configure .ssh/config.ssh/config
-
-.. code-block:: text
-
-   Host gitea.eco.tsi-dev.otc-service.com
-   User git
-   Port 2222
-   HostName gitea.eco.tsi-dev.otc-service.com
-   IdentityFile ~/.ssh/id_rsa
-
-You should be able to ssh gitea and get You've successfully authenticated  message.
-
-.. code-block:: text
-
- ssh gitea.eco.tsi-dev.otc-service.com
-
-Clone your branch, not main:
-
-.. code-block:: text
-
-   git clone ssh://git@gitea.eco.tsi-dev.otc-service.com:2222/marmulle/otc-metadata.git
-
-Then follow instructions to recover fork: https://gitea.eco.tsi-dev.otc-service.com/docs/doc-exports/wiki/Recovering-Fork
-
-3)**Update necessary file**
-
-In this case I was updating obs-swiftapi.yaml located in https://gitea.eco.tsi-dev.otc-service.com/marmulle/otc-metadata/src/branch/main/otc_metadata/data/documents
-
-4)**Propose file changes**
-
-After update file propose file changes. Name of branch or pull request should be as short as possible,but meaningful.
-
-.. image:: faq_images/propose_file_change.png
-   :target: faq_images/propose_file_change.png
-   :alt: faq_file_change
-
-5)**Create new pull request**
-
-Change destination branch into infra:main and click New Pull Request.
-
-.. image:: faq_images/gitea_new_pull_request.png
-   :target: faq_images/gitea_new_pull_request.png
-   :alt: gitea_new_pull_request
-
-Change destination branch into infra:main and click New Pull Request
-
-.. image:: faq_images/gitea_new_pull_request2.png
-   :target: faq_images/gitea_new_pull_request2.png
-   :alt: gitea_new_pull_request2
-
-Once again -  New Pull Request
-
-.. image:: faq_images/gitea_new_pull_request3.png
-   :target: faq_images/gitea_new_pull_request3.png
-   :alt: gitea_new_pull_request3
-
-6)**New pull request  approve, gate**
-
-.. image:: faq_images/gitea_new_pull_request_approve_gate.png
-   :target: faq_images/gitea_new_pull_request_approve_gate.png
-   :alt: gitea_new_pull_request_approve_gate
-
-7)**Delete branch**

doc/source/helpcenter/helpcenter_training/introduction.rst

@@ -1,51 +0,0 @@
-============
-Introduction
-============
-
-The Helpcenter 3 (HC3) is an Open Telekom Cloud product developed by the Ecosystem Squad introducing
-a new approach in documentation management. It improves the documentation exchange between
-delivery partners and the service squads of the Open Telekom Cloud. The documentation
-platform comes with processes based on GitOps and introduces the following features and benefits:
-
--  Openness,
--  Transparency,
--  Comprehensive review capabilities,
--  Full control during the documentation lifecycle, and
--  Documentation as source code.
-
-The target of the platform is to store and maintain all documents in Git. This provides benefits of precise identification of changes
-and preventing undesired versions to be published. The process is heavily streamlined. Once, those changes are approved and merged,
-the connected pipelines ensure that the documentation is published fully automated which eases the document auditing and enables users
-to see the complete history of changes tracked by git itself.
-
-.. figure:: /_static/images/helpcenter_gitops.png
-
-Solution is based on open source components. Its HLD is described at https://docs.otc-service.com/system-config/docsportal.html
-The implementation is based on these building blocks:
-
--  Restructured Text (RST) as source documentation format,
--  Gitea/Github as a repository,
--  Zuul as a CI/CD engine for workflows,
--  Sphinx as a documentation rendering framework creating for example HTML or PDF documents,
--  OpenSearch as a search engine,
--  Swift object storage as a storage for documentation,
--  Pandoc as a documentation converter, and
--  a lot of OTC Infrastructure (ECS, CCE, ELB, ...)
-
-HC3 comes with following features:
-
--  Support of UMN, API, DEV and other public facing documents
--  PROD and PREPROD documentation portal:
-
-   -  docs.otc.t-systems.com
-   -  docs-int.otc.service.com
-
--  Support of all old HC links redirections
--  Search functionality
--  Mobile-ready UI layout
--  Report issue functionality directly on any page
--  Suggest documentation fix functionality
--  Consolidation of extra content like blueprints, tools, and libraries for developers
--  One repository represents one cloud service
--  Each squad can control and manage their documentation independently
--  Automatization and check jobs across whole documentation lifecycle (from import to release)

doc/source/helpcenter/index.rst

@@ -1,9 +0,0 @@
-=================================
-Helpcenter Internal Documentation
-=================================
-
-.. toctree::
-   :maxdepth: 2
-
-   hc_ops/index
-   helpcenter_training/index

doc/source/index.rst

@@ -3,12 +3,7 @@ Internal Documentation
 ======================
 
 .. toctree::
-   :maxdepth: 1
+   :maxdepth: 2    
 
-   APImon <apimon/index>
+   training/index
-   Captcha Service <captcha_service/index>
+   cpn/index
-   Status Dashboard <status_dashboard/index>
-   Helpcenter <helpcenter/index>
-   Circle Partner Navigator <cpn/index>
-   otcdocstheme <otcdocstheme/index>
-   OTC Terraform Provider <terraform/index>

doc/source/otcdocstheme/index.rst

@@ -1,9 +0,0 @@
-==========================
-otcdocstheme Documentation
-==========================
-
-.. toctree::
-    :maxdepth: 1
-
-    updating_the_theme
-    parsed_confpy_settings