Compare commits

..

2 Commits

Author SHA1 Message Date
b1bf66f027 Mega main
All checks were successful
gl/check check status: success (b1bf66f02730304b902c8c3de5bd423548f2b2a2)
2023-12-22 09:41:12 +00:00
5dc8684126 Changed conf.py.j2
Some checks failed
gl/check check status: failure (5dc868412622dad397f358be23a97282a1051709)
2023-07-10 10:16:57 +02:00
37 changed files with 92 additions and 246 deletions

3
.gitignore vendored
View File

@ -59,6 +59,3 @@ ChangeLog
# Files created by releasenotes build
releasenotes/build
bindep.txt
packages.txt

View File

@ -1,8 +0,0 @@
---
environment: public
link: /architecture-center/blueprints/
pdf_name: architecture-center-blueprints
rst_location: doc/blueprints/source
service_type: ac
title: Blueprints
type: blueprints

View File

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

View File

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

View File

@ -1,6 +0,0 @@
---
link: /business-dashboard/umn/
rst_location: umn/source
service_type: bd
title: User Guide
type: umn

View File

@ -1,7 +0,0 @@
---
link: /cloud-create/api-ref/
pdf_name: cc-api-ref
rst_location: api-ref/source
service_type: cc
title: API Reference
type: api-ref

View File

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

View File

@ -1,5 +1,6 @@
---
hc_location: bestpractice/css
environment: internal
html_location: docs/css/best-practice
link: /cloud-search-service/best-practice/
pdf_name: css-best-practice

View File

@ -1,5 +1,6 @@
---
hc_location: api/functiongraph
environment: internal
html_location: docs/fg/api-ref
link: /function-graph/api-ref/
pdf_name: fg-api-ref

View File

@ -1,5 +1,6 @@
---
hc_location: usermanual/functiongraph
environment: internal
html_location: docs/fg/umn
link: /function-graph/umn/
pdf_name: fg-umn

View File

@ -1,5 +1,6 @@
---
hc_location: api/ocr
environment: internal
html_location: docs/ocr/api-ref
link: /optical-character-recognition/api-ref/
pdf_name: ocr-api-ref

View File

@ -1,5 +1,6 @@
---
hc_location: usermanual/ocr
environment: internal
html_location: docs/ocr/umn
link: /optical-character-recognition/umn/
pdf_name: ocr-umn

View File

@ -0,0 +1,9 @@
---
hc_location: api/rts
html_location: docs/rts/api-ref
link: /resource-template-service/api-ref/
pdf_name: rts-api-ref
rst_location: api-ref/source
service_type: rts
title: API Reference
type: api-ref

View File

@ -0,0 +1,9 @@
---
hc_location: usermanual/rts
html_location: docs/rts/umn
link: /resource-template-service/umn/
pdf_name: rts-umn
rst_location: umn/source
service_type: rts
title: User Guide
type: umn

View File

@ -0,0 +1,9 @@
---
hc_location: usermanual/sd
html_location: docs/sd/umn
link: /status-dashboard/umn/
pdf_name: sd-umn
rst_location: umn/source
service_type: sd
title: User Guide
type: umn

View File

@ -0,0 +1,8 @@
---
html_location: docs/tcc/umn
link: /telekom-cloud-create/umn/
pdf_name: tcc-umn
rst_location: umn/source
service_type: tcc
title: User Guide
type: umn

View File

@ -1,16 +0,0 @@
---
environment: hidden
repositories:
- environment: internal
repo: docs/architecture-center
type: gitea
- environment: public
repo: opentelekomcloud-docs/architecture-center
type: github
service_category: other
service_title: Architecture Center
service_type: ac
service_uri: architecture-center
teams:
- name: docs-architecture-center-rw
permission: write

View File

@ -1,5 +1,5 @@
---
environment: internal
environment: public
repositories:
- environment: internal
repo: docs/api-usage

View File

@ -1,13 +0,0 @@
---
environment: internal
repositories:
- environment: internal
repo: docs/business-dashboard
type: gitea
service_category: other
service_title: Business Dashboard
service_type: bd
service_uri: business-dashboard
teams:
- name: docs-dashboard-rw
permission: write

View File

@ -1,13 +0,0 @@
---
environment: public
repositories:
- environment: public
repo: opentelekomcloud-docs/cloud-create
type: github
service_category: md
service_title: Cloud Create
service_type: cc
service_uri: cloud-create
teams:
- name: topology-designer-rw
permission: write

View File

@ -1,13 +0,0 @@
---
environment: hidden
repositories:
- environment: public
repo: opentelekomcloud-docs/docs_on_docs
type: github
service_category: other
service_title: Documentation about documentation
service_type: dod
service_uri: docs-on-docs
teams:
- name: docs-eco-rw
permission: write

View File

@ -1,5 +1,5 @@
---
environment: public
environment: internal
repositories:
- environment: internal
repo: docs/function-graph
@ -12,5 +12,5 @@ service_title: FunctionGraph
service_type: fg
service_uri: function-graph
teams:
- name: docs-container-rw
- name: docs-compute-rw
permission: write

View File

@ -1,16 +0,0 @@
---
environment: hidden
repositories:
- environment: internal
repo: docs/glossary
type: gitea
- environment: public
repo: opentelekomcloud-docs/glossary
type: github
service_category: other
service_title: Glossary
service_type: gloss
service_uri: glossary
teams:
- name: docs-eco-rw
permission: write

View File

@ -1,13 +0,0 @@
---
environment: internal
repositories:
- environment: internal
repo: docs/internal-documentation
type: gitea
service_category: other
service_title: Internal Documentation
service_type: intdocs
service_uri: internal-documentation
teams:
- name: docs-eco-rw
permission: write

View File

@ -1,5 +1,5 @@
---
environment: public
environment: internal
repositories:
- environment: internal
repo: docs/optical-character-recognition

View File

@ -1,16 +0,0 @@
---
environment: hidden
repositories:
- environment: internal
repo: docs/regions-and-endpoints
type: gitea
- environment: public
repo: opentelekomcloud-docs/regions-and-endpoints
type: github
service_category: other
service_title: Regions and Endpoints
service_type: rae
service_uri: regions-and-endpoints
teams:
- name: docs-eco-rw
permission: write

View File

@ -0,0 +1,16 @@
---
environment: public
repositories:
- environment: internal
repo: docs/resource-template-service
type: gitea
- environment: public
repo: opentelekomcloud-docs/resource-template-service
type: github
service_category: md
service_title: Resource Template Service
service_type: rts
service_uri: resource-template-service
teams:
- name: docs-orchestration-rw
permission: write

View File

@ -1,5 +1,5 @@
---
environment: public
environment: hidden
repositories:
- environment: internal
repo: docs/status-dashboard
@ -10,7 +10,7 @@ repositories:
service_category: other
service_title: Status Dashboard
service_type: sd
service_uri: status-dashboard
service_uri: status-dashboard/umn
teams:
- name: docs-eco-rw
permission: write

View File

@ -1,16 +0,0 @@
---
environment: hidden
repositories:
- environment: internal
repo: docs/security
type: gitea
- environment: public
repo: opentelekomcloud-docs/security
type: github
service_category: other
service_title: Security
service_type: sec
service_uri: security
teams:
- name: docs-eco-rw
permission: write

View File

@ -0,0 +1,13 @@
---
environment: hidden
repositories:
- environment: public
repo: opentelekomcloud-docs/telekom-cloud-create
type: github
service_category: other
service_title: Telekom Cloud Create
service_type: tcc
service_uri: telekom-cloud-create
teams:
- name: topology-designer-rw
permission: write

View File

@ -246,19 +246,12 @@ class Services(object):
x for x in srv["teams"] if x["permission"] == "write"
]
if "repositories" in srv and environment:
internal_exists = False
for repo in srv["repositories"]:
if (
"environment" in repo
and repo["environment"] == environment
):
srv_res["repository"] = repo["repo"]
if repo["environment"] == "internal":
internal_exists = True
# internal repo does not exist
# service will be left out from metadata.yaml
if not internal_exists:
continue
for doc in self.all_docs:
if (
"html_location" in doc

View File

@ -38,14 +38,14 @@ otcdocs_git_type = '{{ git_type }}'
{%- endif %}
# Those variables are needed for indexing into OpenSearch
otcdocs_doc_environment = '{{ doc_environment }}'
otcdocs_doc_link = '{{ doc_link }}'
otcdocs_doc_title = '{{ doc_title }}'
otcdocs_doc_type = '{{ doc_type }}'
otcdocs_service_category = '{{ service_category }}'
otcdocs_service_title = '{{ service_title }}'
otcdocs_service_type = '{{ service_type }}'
otcdocs_search_environment = 'hc_de'
otcdocs_doc_environment = "{{ doc_environment }}"
otcdocs_doc_link = "{{ doc_link }}"
otcdocs_doc_title = "{{ doc_title }}"
otcdocs_doc_type = "{{ doc_type }}"
otcdocs_service_category = "{{ service_category }}"
otcdocs_service_title = "{{ service_title }}"
otcdocs_service_type = "{{ service_type }}"
otcdocs_search_environment = "hc_de"
otcdocs_search_url = "https://opensearch.eco.tsi-dev.otc-service.com/"
# If extensions (or modules to document with autodoc) are in another directory,

View File

@ -1,6 +1,6 @@
sphinx>=2.0.0,!=2.1.0 # BSD
{% if target_environment == 'public' %}
otcdocstheme<2.0.0 # Apache-2.0
otcdocstheme<1.0.0 # Apache-2.0
{% elif target_environment == 'internal' %}
otcdocstheme # Apache-2.0
{% else %}
@ -12,4 +12,3 @@ 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

View File

@ -13,8 +13,6 @@ commands = stestr run {posargs}
stestr slowest
[testenv:pep8]
allowlist_externals =
doc8
commands =
doc8 doc/source README.rst
@ -45,19 +43,15 @@ commands =
{%- endfor %}
[testenv:docs-pdf]
deps =
{[testenv:docs]deps}
{[testenv:bindeps]deps}
deps = {[testenv:docs]deps}
allowlist_externals =
rm
mkdir
wget
make
bash
cp
commands =
mkdir -p doc/build/pdf
{[testenv:bindeps]commands}
{%- for doc in docs %}
{%- if doc.pdf_name %}
{[testenv:{{ doc.type }}-pdf-docs]commands}
@ -124,21 +118,6 @@ commands =
{% endif %}
{% endfor %}
[testenv:bindeps]
deps =
bindep
allowlist_externals =
wget
rm
bash
commands =
rm -rf {toxinidir}/bindep.txt
rm -rf {toxinidir}/packages.txt
wget -O {toxinidir}/bindep.txt https://raw.githubusercontent.com/opentelekomcloud/otcdocstheme/main/bindep.txt
bash -c "bindep test -b -f {toxinidir}/bindep.txt > {toxinidir}/packages.txt || true"
bash -c 'if [ -s {toxinidir}/packages.txt ]; then if command -v apt &>/dev/null; then apt update && xargs apt install --no-install-recommends -y < {toxinidir}/packages.txt; fi; fi'
bash -c 'if [ -s {toxinidir}/packages.txt ]; then if command -v dnf &>/dev/null; then dnf install -y $(cat {toxinidir}/packages.txt); fi; fi'
[doc8]
ignore = D001
extensions = .rst, .yaml

View File

@ -1,12 +0,0 @@
---
- project:
merge-mode: squash-merge
default-branch: main
templates:
- helpcenter-base-jobs
check:
jobs:
- noop
gate:
jobs:
- noop

View File

@ -50,7 +50,6 @@ def process_repositories(args, service):
)
conf_py_template = env.get_template("conf.py.j2")
tox_ini_template = env.get_template("tox.ini.j2")
zuul_yaml_template = env.get_template("zuul.yaml.j2")
index_sbv_template = env.get_template("index_sbv.rst.j2")
doc_requirements_template = env.get_template("doc_requirements.txt.j2")
@ -260,16 +259,6 @@ def process_repositories(args, service):
out.write(doc_requirements_content)
repo_to.index.add(["doc/requirements.txt"])
if args.update_zuul:
"""Update zuul.yaml"""
zuul_yaml_content = zuul_yaml_template.render(**context)
zuul_yaml_path = pathlib.Path(copy_to, "zuul.yaml")
with open(zuul_yaml_path, "w", encoding="utf-8", newline="") as out:
logging.debug(f"Generating {zuul_yaml_path} from template...")
out.write(zuul_yaml_content)
repo_to.index.add(["zuul.yaml"])
if len(repo_to.index.diff("HEAD")) == 0:
# Nothing to commit
logging.debug(
@ -355,11 +344,6 @@ def main():
action="store_true",
help="Whether to update service-based-view"
)
parser.add_argument(
"--update-zuul",
action="store_true",
help="Whether to update zuul.yaml"
)
parser.add_argument(
"--overwrite-index-sbv",
action="store_true",

View File

@ -95,12 +95,12 @@ def process_repositories(args, service):
f"due to the doc-type filter."
)
continue
# if doc.get("environment"):
# logging.info(
# f"Skipping synchronizing {doc['title']} "
# f"since it is environment bound."
# )
# continue
if doc.get("environment"):
logging.info(
f"Skipping synchronizing {doc['title']} "
f"since it is environment bound."
)
continue
branch_name = f"{args.branch_name}#{doc['type']}"
remote_ref = SymbolicReference.create(