Compare commits
1 Commits
fix_genera
...
sd_iam_add
Author | SHA1 | Date | |
---|---|---|---|
ad1ca5c356 |
@ -1,4 +1,5 @@
|
|||||||
---
|
---
|
||||||
|
environment: internal
|
||||||
hc_location: api/dwaf
|
hc_location: api/dwaf
|
||||||
html_location: docs/wafd/api-ref
|
html_location: docs/wafd/api-ref
|
||||||
link: /web-application-firewall-dedicated/api-ref/
|
link: /web-application-firewall-dedicated/api-ref/
|
||||||
|
@ -1,4 +1,5 @@
|
|||||||
---
|
---
|
||||||
|
environment: internal
|
||||||
hc_location: usermanual/dwaf
|
hc_location: usermanual/dwaf
|
||||||
html_location: docs/wafd/umn
|
html_location: docs/wafd/umn
|
||||||
link: /web-application-firewall-dedicated/umn/
|
link: /web-application-firewall-dedicated/umn/
|
||||||
|
@ -122,58 +122,6 @@ class Services(object):
|
|||||||
res[cat]["docs"].append(res_doc)
|
res[cat]["docs"].append(res_doc)
|
||||||
return res
|
return res
|
||||||
|
|
||||||
def service_types_with_doc_types(self, environment=None):
|
|
||||||
"""Retrieve type and title from services and corresponding docs.
|
|
||||||
As well as a list of all available doc types with title.
|
|
||||||
|
|
||||||
:param str environment: Optional service environment.
|
|
||||||
"""
|
|
||||||
service_list = []
|
|
||||||
docs = []
|
|
||||||
|
|
||||||
for service in self.all_services:
|
|
||||||
if "environment" in service:
|
|
||||||
if service["environment"] != environment:
|
|
||||||
continue
|
|
||||||
if not service["service_title"]:
|
|
||||||
continue
|
|
||||||
if not service["service_type"]:
|
|
||||||
continue
|
|
||||||
|
|
||||||
doc_list = []
|
|
||||||
for doc in self.all_docs:
|
|
||||||
if "environment" in doc:
|
|
||||||
if doc["environment"] != environment:
|
|
||||||
continue
|
|
||||||
if doc["service_type"] == service["service_type"]:
|
|
||||||
doc_list.append({
|
|
||||||
"title": doc["title"],
|
|
||||||
"type": doc["type"]
|
|
||||||
})
|
|
||||||
|
|
||||||
new_doc = {
|
|
||||||
"type": doc["type"],
|
|
||||||
"title": doc["title"]
|
|
||||||
}
|
|
||||||
type_exists = any(
|
|
||||||
doc_dict["type"] == new_doc["type"] for doc_dict in docs
|
|
||||||
)
|
|
||||||
if not type_exists:
|
|
||||||
docs.append(new_doc)
|
|
||||||
|
|
||||||
service_list.append({
|
|
||||||
"service_title": service["service_title"],
|
|
||||||
"service_type": service["service_type"],
|
|
||||||
"docs": doc_list
|
|
||||||
})
|
|
||||||
|
|
||||||
res = {
|
|
||||||
"services": service_list,
|
|
||||||
"docs": docs
|
|
||||||
}
|
|
||||||
|
|
||||||
return res
|
|
||||||
|
|
||||||
def docs_by_service_category(self, category, environment=None):
|
def docs_by_service_category(self, category, environment=None):
|
||||||
"""List services matching category
|
"""List services matching category
|
||||||
|
|
||||||
@ -237,8 +185,6 @@ class Services(object):
|
|||||||
srv_res = dict(
|
srv_res = dict(
|
||||||
service_title=srv["service_title"],
|
service_title=srv["service_title"],
|
||||||
service_type=srv["service_type"],
|
service_type=srv["service_type"],
|
||||||
service_category=srv["service_category"],
|
|
||||||
service_environment=environment,
|
|
||||||
docs=[],
|
docs=[],
|
||||||
)
|
)
|
||||||
if "teams" in srv:
|
if "teams" in srv:
|
||||||
@ -262,7 +208,6 @@ class Services(object):
|
|||||||
rst_location=doc["rst_location"],
|
rst_location=doc["rst_location"],
|
||||||
title=doc["title"],
|
title=doc["title"],
|
||||||
type=doc.get("type", "dummy"),
|
type=doc.get("type", "dummy"),
|
||||||
link=doc["link"],
|
|
||||||
)
|
)
|
||||||
if "pdf_name" in doc:
|
if "pdf_name" in doc:
|
||||||
doc_res["pdf_name"] = doc["pdf_name"]
|
doc_res["pdf_name"] = doc["pdf_name"]
|
||||||
|
@ -26,6 +26,7 @@ extensions = [
|
|||||||
|
|
||||||
otcdocs_auto_name = False
|
otcdocs_auto_name = False
|
||||||
otcdocs_auto_version = False
|
otcdocs_auto_version = False
|
||||||
|
otcdocs_search_environment = 'hc_swiss'
|
||||||
|
|
||||||
project = '{{ project }}'
|
project = '{{ project }}'
|
||||||
otcdocs_repo_name = '{{ repo_name }}'
|
otcdocs_repo_name = '{{ repo_name }}'
|
||||||
@ -37,17 +38,6 @@ otcdocs_git_fqdn = '{{ git_fqdn }}'
|
|||||||
otcdocs_git_type = '{{ git_type }}'
|
otcdocs_git_type = '{{ git_type }}'
|
||||||
{%- endif %}
|
{%- 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_swiss'
|
|
||||||
otcdocs_search_url = "https://opensearch.eco.tsi-dev.otc-service.com/"
|
|
||||||
|
|
||||||
# If extensions (or modules to document with autodoc) are in another directory,
|
# If extensions (or modules to document with autodoc) are in another directory,
|
||||||
# add these directories to sys.path here. If the directory is relative to the
|
# add these directories to sys.path here. If the directory is relative to the
|
||||||
# documentation root, use os.path.abspath to make it absolute, like shown here.
|
# documentation root, use os.path.abspath to make it absolute, like shown here.
|
||||||
|
@ -24,9 +24,7 @@ commands = {posargs}
|
|||||||
# This env is invoked in the periodic pipeline and is therefore responsible to
|
# This env is invoked in the periodic pipeline and is therefore responsible to
|
||||||
# build all relevant docs at once.
|
# build all relevant docs at once.
|
||||||
[testenv:docs]
|
[testenv:docs]
|
||||||
deps =
|
deps = -r{toxinidir}/doc/requirements.txt
|
||||||
-r{toxinidir}/doc/requirements.txt
|
|
||||||
-c https://raw.githubusercontent.com/opentelekomcloud-docs-swiss/docs-constraints/main/constraints.txt
|
|
||||||
allowlist_externals =
|
allowlist_externals =
|
||||||
mkdir
|
mkdir
|
||||||
cp
|
cp
|
||||||
@ -42,7 +40,7 @@ commands =
|
|||||||
{%- endfor %}
|
{%- endfor %}
|
||||||
|
|
||||||
[testenv:docs-pdf]
|
[testenv:docs-pdf]
|
||||||
deps = {[testenv:docs]deps}
|
deps = -r{toxinidir}/doc/requirements.txt
|
||||||
allowlist_externals =
|
allowlist_externals =
|
||||||
rm
|
rm
|
||||||
mkdir
|
mkdir
|
||||||
@ -61,7 +59,7 @@ commands =
|
|||||||
{% set loc = doc.rst_location | replace('/source', '') %}
|
{% set loc = doc.rst_location | replace('/source', '') %}
|
||||||
# HTML version
|
# HTML version
|
||||||
[testenv:{{ doc.type }}]
|
[testenv:{{ doc.type }}]
|
||||||
deps = {[testenv:docs]deps}
|
deps = -r{toxinidir}/doc/requirements.txt
|
||||||
allowlist_externals =
|
allowlist_externals =
|
||||||
cp
|
cp
|
||||||
mkdir
|
mkdir
|
||||||
@ -80,7 +78,7 @@ commands =
|
|||||||
|
|
||||||
# Json version (for search)
|
# Json version (for search)
|
||||||
[testenv:json-{{ doc.type }}]
|
[testenv:json-{{ doc.type }}]
|
||||||
deps = {[testenv:docs]deps}
|
deps = -r{toxinidir}/doc/requirements.txt
|
||||||
allowlist_externals =
|
allowlist_externals =
|
||||||
cp
|
cp
|
||||||
mkdir
|
mkdir
|
||||||
@ -104,7 +102,7 @@ commands =
|
|||||||
{% if doc.pdf_name -%}
|
{% if doc.pdf_name -%}
|
||||||
# PDF version
|
# PDF version
|
||||||
[testenv:{{ doc.type }}-pdf-docs]
|
[testenv:{{ doc.type }}-pdf-docs]
|
||||||
deps = {[testenv:docs]deps}
|
deps = -r{toxinidir}/doc/requirements.txt
|
||||||
allowlist_externals =
|
allowlist_externals =
|
||||||
rm
|
rm
|
||||||
mkdir
|
mkdir
|
||||||
|
@ -150,23 +150,6 @@ def process_repositories(args, service):
|
|||||||
site_name="Internal Documentation Portal",
|
site_name="Internal Documentation Portal",
|
||||||
logo_url="https://docs-int.otc-service.com",
|
logo_url="https://docs-int.otc-service.com",
|
||||||
)
|
)
|
||||||
context["doc_environment"] = args.target_environment
|
|
||||||
if doc['link']:
|
|
||||||
context["doc_link"] = doc['link']
|
|
||||||
else:
|
|
||||||
context["doc_link"] = (
|
|
||||||
'/'
|
|
||||||
+ service['service_uri']
|
|
||||||
+ '/'
|
|
||||||
+ doc['type']
|
|
||||||
+ '/'
|
|
||||||
)
|
|
||||||
context["doc_title"] = doc['title']
|
|
||||||
context["doc_type"] = doc['type']
|
|
||||||
context["service_category"] = service['service_category']
|
|
||||||
context["service_title"] = service['service_title']
|
|
||||||
context["service_type"] = service['service_type']
|
|
||||||
|
|
||||||
conf_py_content = conf_py_template.render(**context)
|
conf_py_content = conf_py_template.render(**context)
|
||||||
with open(conf_py_path, "w", encoding="utf-8", newline="") as out:
|
with open(conf_py_path, "w", encoding="utf-8", newline="") as out:
|
||||||
logging.debug(f"Generating {conf_py_path} from template...")
|
logging.debug(f"Generating {conf_py_path} from template...")
|
||||||
@ -184,8 +167,6 @@ def process_repositories(args, service):
|
|||||||
title=f"{service['service_title']} - Service Based View",
|
title=f"{service['service_title']} - Service Based View",
|
||||||
service_type=service["service_type"]
|
service_type=service["service_type"]
|
||||||
)
|
)
|
||||||
context["service_category"] = service['service_category']
|
|
||||||
context["service_title"] = service['service_title']
|
|
||||||
if not copy_path.exists():
|
if not copy_path.exists():
|
||||||
logging.info("Path for sbv does not exist")
|
logging.info("Path for sbv does not exist")
|
||||||
copy_path.mkdir(parents=True, exist_ok=True)
|
copy_path.mkdir(parents=True, exist_ok=True)
|
||||||
@ -267,7 +248,7 @@ def process_repositories(args, service):
|
|||||||
args.commit_description
|
args.commit_description
|
||||||
)
|
)
|
||||||
push_args = ["--set-upstream", "origin", branch_name]
|
push_args = ["--set-upstream", "origin", branch_name]
|
||||||
if args.force_push:
|
if args.branch_force:
|
||||||
push_args.append("--force")
|
push_args.append("--force")
|
||||||
repo_to.git.push(*push_args)
|
repo_to.git.push(*push_args)
|
||||||
if "github" in url_to:
|
if "github" in url_to:
|
||||||
@ -347,11 +328,6 @@ def main():
|
|||||||
help=("Whether to overwrite index.rst for service-based-view."
|
help=("Whether to overwrite index.rst for service-based-view."
|
||||||
+ "\nCan only be used if --update-sbv is also specified")
|
+ "\nCan only be used if --update-sbv is also specified")
|
||||||
)
|
)
|
||||||
parser.add_argument(
|
|
||||||
"--force-push",
|
|
||||||
action="store_true",
|
|
||||||
help="Whether to force push the commit"
|
|
||||||
)
|
|
||||||
parser.add_argument(
|
parser.add_argument(
|
||||||
"--commit-description",
|
"--commit-description",
|
||||||
default=(
|
default=(
|
||||||
|
@ -10,7 +10,6 @@ import otc_metadata.services
|
|||||||
|
|
||||||
def main():
|
def main():
|
||||||
data = otc_metadata.services.Services()
|
data = otc_metadata.services.Services()
|
||||||
data._sort_data()
|
|
||||||
|
|
||||||
_yaml = YAML()
|
_yaml = YAML()
|
||||||
_yaml.indent(mapping=2, sequence=4, offset=2)
|
_yaml.indent(mapping=2, sequence=4, offset=2)
|
||||||
|
Reference in New Issue
Block a user