Improve openapi_json fallback fetching

As a fallback we tried fetching from some git remote, but we didnt'
have a guarantee that this was associated with the pulp-docs official
remote git url. This applies a more robust approach explicit fetching
from that url.

Author: pedro-psb

src/pulp_docs/plugin.py

@@ -307,6 +307,13 @@ def log_pulp_config(
     log.info(display_str)
 
 
+def get_pulpdocs_git_url(config: PulpDocsPluginConfig):
+    for component in config.components:
+        if component.path == "pulp-docs":
+            return component.git_url
+    raise RuntimeError("Did pulp-docs changed it's name or was removed from mkdocs.yml?")
+
+
 class PulpDocsPlugin(BasePlugin[PulpDocsPluginConfig]):
     def on_config(self, config: MkDocsConfig) -> MkDocsConfig | None:
         # mkdocs may default to the installation dir
@@ -320,14 +327,15 @@ def on_config(self, config: MkDocsConfig) -> MkDocsConfig | None:
 
         self.mkdocs_yml_dir = Path(config.docs_dir).parent
         self.find_path = ctx_path.get() or [str(Path().cwd().parent)]
-        self.config.components = load_components(self.find_path, self.config, self.draft)
+        self.loaded_components = load_components(self.find_path, self.config, self.draft)
+        self.pulpdocs_git_url = get_pulpdocs_git_url(self.config)
 
         mkdocs_file = self.mkdocs_yml_dir / "mkdocs.yml"
-        log_pulp_config(mkdocs_file, self.find_path, self.config.components, config.site_dir)
+        log_pulp_config(mkdocs_file, self.find_path, self.loaded_components, config.site_dir)
 
         mkdocstrings_config = config.plugins["mkdocstrings"].config
         components_var = []
-        for component in self.config.components:
+        for component in self.loaded_components:
             components_var.append(get_component_data(component))
             config.watch.append(str(component.component_dir / "docs"))
             component_dir = str(component.component_dir.resolve())
@@ -350,8 +358,8 @@ def on_config(self, config: MkDocsConfig) -> MkDocsConfig | None:
         return config
 
     def on_files(self, files: Files, /, *, config: MkDocsConfig) -> Files | None:
-        log.info(f"Loading Pulp components: {self.config.components}")
-        pulp_docs_component = [c for c in self.config.components if c.path == "pulp-docs"]
+        log.info(f"Loading Pulp components: {self.loaded_components}")
+        pulp_docs_component = [c for c in self.loaded_components if c.path == "pulp-docs"]
         if pulp_docs_component:
             pulp_docs_git = Repo(pulp_docs_component[0].repository_dir)
         else:
@@ -360,7 +368,7 @@ def on_files(self, files: Files, /, *, config: MkDocsConfig) -> Files | None:
 
         user_nav: dict[str, t.Any] = {}
         dev_nav: dict[str, t.Any] = {}
-        for component in self.config.components:
+        for component in self.loaded_components:
             component_dir = component.component_dir
 
             log.info(f"Fetching docs from '{component.title}'.")
@@ -493,10 +501,10 @@ def get_openapi_spec(self, component, pulp_docs_git: Repo):
                 f"docs-data:data/openapi_json/{component.rest_api}-api.json"
             )
         except GitCommandError:
-            # Try again on the first remote.
-            remote = pulp_docs_git.remotes[0]
+            # Not found locally. Try again fetching from the official remote url
+            pulp_docs_git.git.fetch(self.pulpdocs_git_url, "docs-data")
             api_json = pulp_docs_git.git.show(
-                f"{remote}/docs-data:data/openapi_json/{component.rest_api}-api.json"
+                f"FETCH_HEAD:data/openapi_json/{component.rest_api}-api.json"
             )
         # fix the logo url for restapi page, which is defined in the openapi spec file
         api_json = api_json.replace(