This is the documentation repository for software under the NVIDIA Cloud Native Technologies umbrella. The tools allow users to build and run GPU accelerated containers with popular container runtimes such as Docker and orchestration platforms such as Kubernetes.
The product documentation portal can be found at: https://docs.nvidia.com/datacenter/cloud-native/index.html
This step is optional if your only goal is to build the documentation.
As an alternative to building the container, you can run docker pull registry.gitlab.com/nvidia/cloud-native/cnt-docs:0.4.0
.
Refer to https://gitlab.com/nvidia/cloud-native/cnt-docs/container_registry to find the most recent tag.
If you change the Dockerfile
, update CONTAINER_RELEASE_IMAGE
in the gitlab-ci.yml
file to the new tag and build the container.
Use the Dockerfile
in the repository (under the docker
directory) to generate the custom doc build container.
-
Build the container:
docker build --pull \ --tag cnt-doc-builder \ --file docker/Dockerfile .
-
Run the container from the previous step:
docker run -it --rm \ -v $(pwd):/work -w /work \ cnt-doc-builder \ bash
-
Build the docs:
./repo docs
Alternatively, you can build just one docset, such as
gpu-operator
orcontainer-toolkit
:./repo docs -p gpu-operator -p openshift
You can determine the docsets by viewing the
[repo_docs.projects.<docset-name>]
tables in therepo.toml
file. For the GPU Operator, always build it with the OCP docset as well, as shown in the preceding command.
The resulting HTML pages are located in the _build/docs/.../latest/
directory of your repository clone.
More information about the repo docs
command is available from
http://omniverse-docs.s3-website-us-east-1.amazonaws.com/repo_docs/0.20.3/index.html.
Additionally, the Gitlab CI for this project builds the documentation on every merge into the default branch (master
).
The documentation from the current default branch (master
) is available at https://nvidia.gitlab.io/cloud-native/cnt-docs/review/latest/.
Documentation in the default branch is under development and unstable.
Periodically, run a linkcheck build:
./repo docs -p <docset-name> -b linkcheck
To view the targets for :ref:
and :doc:
role links, run the following command:
python3 -m sphinx.ext.intersphinx _build/docs/gpu-operator/latest/objects.inv
In all likelihood, you will use grep
to filter the results.
Example Output
supported container runtimes Supported Container Runtimes : platform-support.html#supported-container-runtimes
install-gpu-operator Install NVIDIA GPU Operator : install-gpu-operator.html
If the third column includes a #
, then use :ref:
.
Otherwise, use :doc:
.
In the preceding output, the markup would be as follows:
:ref:`supported container runtimes`
:doc:`install-gpu-operator`
Always update the openshift docset when there is a new gpu-operator docset version.
-
Update the version in
repo.toml
:diff --git a/repo.toml b/repo.toml index e7cd8db..e091d62 100644 --- a/repo.toml +++ b/repo.toml @@ -51,7 +51,7 @@ sphinx_conf_py_extra = """ docs_root = "${root}/container-toolkit" project = "container-toolkit" name = "NVIDIA Container Toolkit" -version = "1.13.1" +version = "NEW_VERSION" copyright_start = 2020
-
Update the version in
<component-name>/versions.json
:diff --git a/container-toolkit/versions.json b/container-toolkit/versions.json index 334338a..b15af73 100644 --- a/container-toolkit/versions.json +++ b/container-toolkit/versions.json @@ -1,7 +1,10 @@ { - "latest": "1.13.1", + "latest": "NEW_VERSION", "versions": [ + { + "version": "NEW_VERSION" + }, { "version": "1.13.1" },
These values control the menu at the bottom of the table of contents and whether pages show a warning banner when readers view an older release. The warning banner directs readers to the latest version.
We can prune the list to the six most-recent releases. The documentation for the older releases is not removed, readers are just less likely to browse the older releases.
Changes to the default branch are not published on docs.nvidia.com.
Only tags or specially-named branches are published to docs.nvidia.com.
-
Create a tag or specially-named branch from your commit with the following naming pattern:
<component-name>-v<version>
.Example
gpu-operator-v23.3.1
The first three fields of the semantic version are used. For a "do over," push a tag like
gpu-operator-v23.3.1.1
.Always tag the openshift docset and driver-containers docset for each new gpu-operator docset release.
-
Push the tag or specially-named branch to the repository.
CI builds the documentation for the Git ref---currently for all software components.
However, only the documentation for the component-name
and specified version is updated on the web.
By default, the documentation for the "latest" URL is updated.
Example
https://docs.nvidia.com/datacenter/cloud-native/gpu-operator/latest/
If the commit message includes /not-latest
, then only the documentation in the versioned URL is updated:
https://docs.nvidia.com/datacenter/cloud-native/gpu-operator/23.3.1/index.html
This documentation repository is licensed under Apache 2.0.
Contributions are welcome. Refer to the CONTRIBUTING.md document for more information on guidelines to follow before contributions can be accepted.