Skip to content

Commit

Permalink
Merge pull request #1030 from hirenp/hirenp/nfd_readme_typo_fix
Browse files Browse the repository at this point in the history
docs: fix internal cross-page references by injecting .md
  • Loading branch information
k8s-ci-robot authored Jan 17, 2023
2 parents 2068fcd + bfbc47f commit 2bbdbf1
Show file tree
Hide file tree
Showing 16 changed files with 60 additions and 60 deletions.
4 changes: 2 additions & 2 deletions docs/deployment/helm.md
Original file line number Diff line number Diff line change
Expand Up @@ -49,7 +49,7 @@ helm install node-feature-discovery ./node-feature-discovery/ --namespace $NFD_N
See the [configuration](#configuration) section below for instructions how to
alter the deployment parameters.

In order to deploy the [minimal](image-variants#minimal) image you need to
In order to deploy the [minimal](image-variants.md#minimal) image you need to
override the image tag:

```bash
Expand Down Expand Up @@ -101,7 +101,7 @@ We have introduced the following Chart parameters.
| `fullnameOverride` | string | | Override a default fully qualified app name |
| `tls.enable` | bool | false | Specifies whether to use TLS for communications between components |
| `tls.certManager` | bool | false | If enabled, requires [cert-manager](https://cert-manager.io/docs/) to be installed and will automatically create the required TLS certificates |
| `enableNodeFeatureApi` | bool | false | Enable the [NodeFeature](../usage/custom-resources#nodefeature) CRD API for communicating node features. This will automatically disable the gRPC communication.
| `enableNodeFeatureApi` | bool | false | Enable the [NodeFeature](../usage/custom-resources.md#nodefeature) CRD API for communicating node features. This will automatically disable the gRPC communication.

### Master pod parameters

Expand Down
6 changes: 3 additions & 3 deletions docs/deployment/kustomize.md
Original file line number Diff line number Diff line change
Expand Up @@ -38,7 +38,7 @@ and [Topologyupdater](#topologyupdater) below.

Alternatively you can clone the repository and customize the deployment by
creating your own overlays. For example, to deploy the
[minimal](image-variants#minimal) image. See [kustomize][kustomize] for more
[minimal](image-variants.md#minimal) image. See [kustomize][kustomize] for more
information about managing deployment configurations.

## Overlays
Expand All @@ -59,7 +59,7 @@ scenarios under
see [Topology Updater](#topologyupdater) below
- [`prune`](https://github.com/kubernetes-sigs/node-feature-discovery/blob/{{site.release}}/deployment/overlays/prune):
clean up the cluster after uninstallation, see
[Removing feature labels](uninstallation#removing-feature-labels)
[Removing feature labels](uninstallation.md#removing-feature-labels)
- [`samples/cert-manager`](https://github.com/kubernetes-sigs/node-feature-discovery/blob/{{site.release}}/deployment/overlays/samples/cert-manager):
an example for supplementing the default deployment with cert-manager for TLS
authentication, see
Expand All @@ -68,7 +68,7 @@ scenarios under
- [`samples/custom-rules`](https://github.com/kubernetes-sigs/node-feature-discovery/blob/{{site.release}}/deployment/overlays/samples/custom-rules):
an example for spicing up the default deployment with a separately managed
configmap of custom labeling rules, see
[Custom feature source](../usage/features#custom) for more information about
[Custom feature source](../usage/features.md#custom) for more information about
custom node labels

### Master-worker pod
Expand Down
2 changes: 1 addition & 1 deletion docs/deployment/operator.md
Original file line number Diff line number Diff line change
Expand Up @@ -59,7 +59,7 @@ is recommended to be done via
EOF
```
In order to deploy the [minimal](image-variants#minimal) image you need to use
In order to deploy the [minimal](image-variants.md#minimal) image you need to use
```yaml
image: {{ site.container_image }}-minimal
Expand Down
4 changes: 2 additions & 2 deletions docs/deployment/tls.md
Original file line number Diff line number Diff line change
Expand Up @@ -65,8 +65,8 @@ To make use of the helm chart, override `values.yaml` to enable both the
deployment will wait until certificates are manually created, as demonstrated
below.

See the sample installation commands in the Helm [Deployment](helm#deployment)
and [Configuration](helm#configuration) sections above for how to either override
See the sample installation commands in the Helm [Deployment](helm.md#deployment)
and [Configuration](helm.md#configuration) sections above for how to either override
individual values, or provide a yaml file with which to override default
values.

Expand Down
6 changes: 3 additions & 3 deletions docs/deployment/uninstallation.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,9 +16,9 @@ sort: 6
---

Follow the uninstallation instructions of the deployment method used
([kustomize](kustomize#uninstallation),
[helm](helm#uninstalling-the-chart) or
[operator](operator#uninstallation)).
([kustomize](kustomize.md#uninstallation),
[helm](helm.md#uninstalling-the-chart) or
[operator](operator.md#uninstallation)).

## Removing feature labels

Expand Down
12 changes: 6 additions & 6 deletions docs/get-started/introduction.md
Original file line number Diff line number Diff line change
Expand Up @@ -43,14 +43,14 @@ NFD-Topology-Updater is a daemon responsible for examining allocated
resources on a worker node to account for resources available to be allocated
to new pod on a per-zone basis (where a zone can be a NUMA node). It then
creates or updates a
[NodeResourceTopology](../usage/custom-resources#noderesourcetopology) custom
[NodeResourceTopology](../usage/custom-resources.md#noderesourcetopology) custom
resource object specific to this node. One instance of nfd-topology-updater is
supposed to be running on each node of the cluster.

## NFD-Topology-Garbage-Collector

NFD-Topology-Garbage-Collector is a daemon responsible for cleaning obsolete
[NodeResourceTopology](../usage/custom-resources#noderesourcetopology) objects,
[NodeResourceTopology](../usage/custom-resources.md#noderesourcetopology) objects,
obsolete means that there is no corresponding worker node.

One instance of nfd-topology-gc is supposed to be running in the cluster.
Expand Down Expand Up @@ -104,7 +104,7 @@ NFD also annotates nodes it is running on:
| [<instance>.]nfd.node.kubernetes.io/feature-labels | Comma-separated list of node labels managed by NFD. NFD uses this internally so must not be edited by users.
| [<instance>.]nfd.node.kubernetes.io/extended-resources | Comma-separated list of node extended resources managed by NFD. NFD uses this internally so must not be edited by users.

NOTE: the [`-instance`](../reference/master-commandline-reference#instance)
NOTE: the [`-instance`](../reference/master-commandline-reference.md#instance)
command line flag affects the annotation names

Unapplicable annotations are not created, i.e. for example master.version is
Expand All @@ -114,13 +114,13 @@ only created on nodes running nfd-master.

NFD takes use of some Kubernetes Custom Resources.

[NodeFeature](../usage/custom-resources#nodefeature)s (EXPERIMENTAL)
[NodeFeature](../usage/custom-resources.md#nodefeature)s (EXPERIMENTAL)
can be used for representing node features and requesting node labels to be
generated.

NFD-Master uses [NodeFeatureRule](../usage/custom-resources#nodefeaturerule)s
NFD-Master uses [NodeFeatureRule](../usage/custom-resources.md#nodefeaturerule)s
for custom labeling of nodes.

NFD-Topology-Updater creates
[NodeResourceTopology](../usage/custom-resources#noderesourcetopology) objects
[NodeResourceTopology](../usage/custom-resources.md#noderesourcetopology) objects
that describe the hardware topology of node resources.
6 changes: 3 additions & 3 deletions docs/reference/master-commandline-reference.md
Original file line number Diff line number Diff line change
Expand Up @@ -140,7 +140,7 @@ nfd-master -verify-node-name -ca-file=/opt/nfd/ca.crt \
### -enable-nodefeature-api

The `-enable-nodefeature-api` flag enables the
[NodeFeature](../usage/custom-resources#nodefeature) CRD API for receiving
[NodeFeature](../usage/custom-resources.md#nodefeature) CRD API for receiving
feature requests. This will also automatically disable the gRPC interface.

Default: false
Expand Down Expand Up @@ -181,8 +181,8 @@ nfd-master -no-publish

The `-crd-controller` flag specifies whether the NFD CRD API controller is
enabled or not. The controller is responsible for processing
[NodeFeature](../usage/custom-resources#nodefeature) and
[NodeFeatureRule](../usage/custom-resources#nodefeaturerule) objects.
[NodeFeature](../usage/custom-resources.md#nodefeature) and
[NodeFeatureRule](../usage/custom-resources.md#nodefeaturerule) objects.

Default: *true*

Expand Down
6 changes: 3 additions & 3 deletions docs/reference/worker-commandline-reference.md
Original file line number Diff line number Diff line change
Expand Up @@ -126,7 +126,7 @@ nfd-worker -key-file=/opt/nfd/worker.key -cert-file=/opt/nfd/worker.crt -ca-file

The `-kubeconfig` flag specifies the kubeconfig to use for connecting to the
Kubernetes API server. It is only needed for manipulating
[NodeFeature](../usage/custom-resources#nodefeature) objects, and thus the flag
[NodeFeature](../usage/custom-resources.md#nodefeature) objects, and thus the flag
only takes effect when
[`-enable-nodefeature-api`](#-enable-nodefeature-api)) is specified. An empty
value (which is also the default) implies in-cluster kubeconfig.
Expand Down Expand Up @@ -198,7 +198,7 @@ nfd-worker -label-sources=kernel,system,local
### -enable-nodefeature-api

The `-enable-nodefeature-api` flag enables the experimental
[NodeFeature](../usage/custom-resources#nodefeature) CRD API
[NodeFeature](../usage/custom-resources.md#nodefeature) CRD API
for communicating with nfd-master. This will also automatically disable the
gRPC communication to nfd-master. When enabled, nfd-worker will create per-node
NodeFeature objects the contain all discovered node features and the set of
Expand All @@ -221,7 +221,7 @@ to nfd-master and no NodeFeature objects are created or updated in the API
server.

Note: This flag takes precedence over the
[`core.noPublish`](worker-configuration-reference#corenopublish)
[`core.noPublish`](worker-configuration-reference.md#corenopublish)
configuration file option.

Default: *false*
Expand Down
8 changes: 4 additions & 4 deletions docs/reference/worker-configuration-reference.md
Original file line number Diff line number Diff line change
Expand Up @@ -133,11 +133,11 @@ core:
Setting `core.noPublish` to `true` disables all communication with the
nfd-master and the Kubernetes API server. It is effectively a "dry-run" option.
NFD-Worker runs feature detection normally, but no labeling requests are sent
to nfd-master and no [NodeFeature](../usage/custom-resources#nodefeature)
to nfd-master and no [NodeFeature](../usage/custom-resources.md#nodefeature)
objects are created or updated in the API server.

Note: Overridden by the
[`-no-publish`](worker-commandline-reference#-no-publish) command line flag (if
[`-no-publish`](worker-commandline-reference.md#-no-publish) command line flag (if
specified).

Default: `false`
Expand Down Expand Up @@ -334,7 +334,7 @@ sources:
Configuration option to disable/enable hooks execution. Enabled by default.
Hooks are DEPRECATED since v0.12.0 release and support will be removed in a
future release. Use
[feature files](../usage//customization-guide#feature-files) instead.
[feature files](../usage//customization-guide.md#feature-files) instead.

Related tracking issues:

Expand Down Expand Up @@ -429,7 +429,7 @@ With the example config above NFD would publish labels like:

List of rules to process in the custom feature source to create user-specific
labels. Refer to the documentation of the
[custom feature source](../usage/customization-guide#custom-feature-source) for
[custom feature source](../usage/customization-guide.md#custom-feature-source) for
details of the available rules and their configuration.

Default: *empty*
Expand Down
4 changes: 2 additions & 2 deletions docs/usage/custom-resources.md
Original file line number Diff line number Diff line change
Expand Up @@ -26,7 +26,7 @@ disabled by default. If enabled, nfd-master watches for NodeFeature objects,
labels nodes as specified and uses the listed features as input when evaluating
[NodeFeatureRule](#nodefeaturerule)s. NodeFeature objects can be used for
implementing 3rd party extensions (see
[customization guide](customization-guide#nodefeature-custom-resource) for more
[customization guide](customization-guide.md#nodefeature-custom-resource) for more
details).

```yaml
Expand Down Expand Up @@ -85,7 +85,7 @@ spec:
```
See the
[Customization guide](customization-guide#node-feature-rule-custom-resource)
[Customization guide](customization-guide.md#node-feature-rule-custom-resource)
for full documentation of the NodeFeatureRule resource and its usage.
## NodeResourceTopology
Expand Down
8 changes: 4 additions & 4 deletions docs/usage/customization-guide.md
Original file line number Diff line number Diff line change
Expand Up @@ -284,7 +284,7 @@ sources:
directory. It is the user's responsibility to review the hooks for e.g.
possible security implications.

**NOTE:** The [minimal](../deployment/image-variants#minimal) image
**NOTE:** The [minimal](../deployment/image-variants.md#minimal) image
variant only supports running statically linked binaries.

### Feature files
Expand Down Expand Up @@ -334,7 +334,7 @@ label creation, similar to the
that the rules are specified in the worker configuration instead of a
Kubernetes API object.

See [worker configuration](nfd-worker#worker-configuration)
See [worker configuration](nfd-worker.md#worker-configuration)
for instructions how to set-up and manage the worker configuration.

### An example custom feature source configuration
Expand Down Expand Up @@ -419,7 +419,7 @@ The namespace part (i.e. prefix) of the labels is controlled by nfd:
sub-namespaces (e.g. `vendor.profile.node.kubernetes.io` and
`sub.ns.profile.node.kubernetes.io`) by default
- Additional namespaces may be enabled with the
[`-extra-label-ns`](../reference/master-commandline-reference#-extra-label-ns)
[`-extra-label-ns`](../reference/master-commandline-reference.md#-extra-label-ns)
command line flag of nfd-master

## Label rule format
Expand Down Expand Up @@ -608,7 +608,7 @@ The following features are available for matching:
| | | **`turbo`** | bool | 'true' if turbo frequencies are enabled, otherwise 'false'
| | | **`scaling`** | string | Active scaling_governor, possible values are 'powersave' or 'performance'.
| **`cpu.rdt`** | flag | | | Intel RDT capabilities supported by the system
| | | **`<rdt-flag>`** | | RDT capability is supported, see [RDT flags](features#intel-rdt-flags) for details
| | | **`<rdt-flag>`** | | RDT capability is supported, see [RDT flags](features.md#intel-rdt-flags) for details
| **`cpu.security`** | attribute | | | Features related to security and trusted execution environments
| | | **`sgx.enabled`** | bool | `true` if Intel SGX (Software Guard Extensions) has been enabled, otherwise does not exist
| | | **`se.enabled`** | bool | `true` if IBM Secure Execution for Linux is available and has been enabled, otherwise does not exist
Expand Down
26 changes: 13 additions & 13 deletions docs/usage/features.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,9 +21,9 @@ Features are advertised as labels in the Kubernetes Node object.

Label creation in nfd-worker is performed by a set of separate modules called
label sources. The
[`core.labelSources`](../reference/worker-configuration-reference#corelabelsources)
[`core.labelSources`](../reference/worker-configuration-reference.md#corelabelsources)
configuration option (or
[`-label-sources`](../reference/worker-commandline-reference#-label-sources)
[`-label-sources`](../reference/worker-commandline-reference.md#-label-sources)
flag) of nfd-worker controls which sources to enable for label generation.

All built-in labels use the `feature.node.kubernetes.io` label namespace and
Expand All @@ -37,9 +37,9 @@ feature.node.kubernetes.io/<feature> = <value>
given node. If features are not discovered on a consecutive run, the corresponding
label will be removed. This includes any restrictions placed on the consecutive run,
such as restricting discovered features with the
[`-label-whitelist`](../reference/master-commandline-reference#-label-whitelist)
[`-label-whitelist`](../reference/master-commandline-reference.md#-label-whitelist)
flag of nfd-master or
[`core.labelWhiteList`](../reference/worker-configuration-reference#corelabelwhitelist)
[`core.labelWhiteList`](../reference/worker-configuration-reference.md#corelabelwhitelist)
option of nfd-worker.

### CPU
Expand All @@ -64,8 +64,8 @@ option of nfd-worker.
| **`cpu-model.id`** | int | CPU model number.

The CPU label source is configurable, see
[worker configuration](nfd-worker#worker-configuration) and
[`sources.cpu`](../reference/worker-configuration-reference#sourcescpu)
[worker configuration](nfd-worker.md#worker-configuration) and
[`sources.cpu`](../reference/worker-configuration-reference.md#sourcescpu)
configuration options for details.

#### X86 CPUID flags (partial list)
Expand Down Expand Up @@ -111,7 +111,7 @@ configuration options for details.
By default, the following CPUID flags have been blacklisted: BMI1, BMI2, CLMUL,
CMOV, CX16, ERMS, F16C, HTT, LZCNT, MMX, MMXEXT, NX, POPCNT, RDRAND, RDSEED,
RDTSCP, SGX, SSE, SSE2, SSE3, SSE4, SSE42 and SSSE3. See
[`sources.cpu`](../reference/worker-configuration-reference#sourcescpu)
[`sources.cpu`](../reference/worker-configuration-reference.md#sourcescpu)
configuration options to change the behavior.

See the full list in [github.com/klauspost/cpuid][klauspost-cpuid].
Expand Down Expand Up @@ -170,8 +170,8 @@ See the full list in [github.com/klauspost/cpuid][klauspost-cpuid].
| **`kernel-version.revision`** | string | Third component of the kernel version (e.g. '6')

The kernel label source is configurable, see
[worker configuration](nfd-worker#worker-configuration) and
[`sources.kernel`](../reference/worker-configuration-reference#sourceskernel)
[worker configuration](nfd-worker.md#worker-configuration) and
[`sources.kernel`](../reference/worker-configuration-reference.md#sourceskernel)
configuration options for details.

### Memory
Expand All @@ -198,8 +198,8 @@ configuration options for details.

`<device label>` is format is configurable and set to `<class>_<vendor>` by
default. For more more details about configuration of the pci labels, see
[`sources.pci`](../reference/worker-configuration-reference#sourcespci) options
and [worker configuration](nfd-worker#worker-configuration)
[`sources.pci`](../reference/worker-configuration-reference.md#sourcespci) options
and [worker configuration](nfd-worker.md#worker-configuration)
instructions.

### USB
Expand All @@ -211,8 +211,8 @@ instructions.
`<device label>` is format is configurable and set to
`<class>_<vendor>_<device>` by default. For more more details about
configuration of the usb labels, see
[`sources.usb`](../reference/worker-configuration-reference#sourcesusb) options
and [worker configuration](nfd-worker#worker-configuration)
[`sources.usb`](../reference/worker-configuration-reference.md#sourcesusb) options
and [worker configuration](nfd-worker.md#worker-configuration)
instructions.

### Storage
Expand Down
Loading

0 comments on commit 2bbdbf1

Please sign in to comment.