Skip to content

Commit 5dd9645

Browse files
committed
Reformat explore initial state section, but don't give up on the prose
just yet Signed-off-by: Laura Lorenz <[email protected]>
1 parent 6bf1164 commit 5dd9645

File tree

1 file changed

+35
-40
lines changed

1 file changed

+35
-40
lines changed

content/en/docs/tutorials/cluster-management/install-use-dra.md

Lines changed: 35 additions & 40 deletions
Original file line numberDiff line numberDiff line change
@@ -93,14 +93,7 @@ To enable the DRA feature, you must enable the following feature gates and API g
9393
With no driver installed or Pod claims yet to satisfy, you can observe the
9494
initial state of a cluster with DRA enabled.
9595

96-
### Check the DeviceClasses in your cluster
97-
98-
The {{< glossary_tooltip text="DeviceClass" term_id="deviceclass" >}} resources
99-
represent a centralized list of the device classes known to the cluster, each
100-
managed by a uniquely named DRA driver. If you set up a new test cluster for
101-
this tutorial, there should be no DeviceClasses.
102-
103-
1. Check the DeviceClasses:
96+
1. Get a list of {{< glossary_tooltip text="DeviceClasses" term_id="deviceclass" >}}:
10497

10598
```shell
10699
kubectl get deviceclasses
@@ -110,28 +103,11 @@ this tutorial, there should be no DeviceClasses.
110103
No resources found
111104
```
112105

113-
### Check the ResourceSlices in your cluster
114-
115-
A {{< glossary_tooltip text="ResourceSlice" term_id="resourceslice" >}} is a
116-
partial list of the {{< glossary_tooltip text="infrastructure resources"
117-
term_id="infrastructure-resource" >}} that are potentially available to use from
118-
Nodes. The collection of all ResourcesSlices in the cluster make up the entire
119-
set of devices available for dynamic assignment. Some infrastructure resource
120-
types (such as CPU and memory) are handled through other mechanisms (like [CPU
121-
limits and requests](docs/tasks/configure-pod-container/assign-cpu-resource/)),
122-
so they won't appear in the ResourceSlices. Storage (as in files and block
123-
devices) has its own management mechanism too; see
124-
[Storage](/docs/concepts/storage/volumes) elsewhere in the documentation.
125-
126-
ResourceSlices can represent existing allocated infrastructure, but they can
127-
also represent an offer to provide infrastructure. For example, a specialized
128-
driver can offer a neural networking accelerator ResourceSlice, even though none
129-
of the nodes in the cluster have that kind of accelerator currently attached.
130-
131-
If you set up a new blank cluster for this tutorial, it's normal to find that there
132-
are no ResourceSlices advertised.
106+
These resources represent a centralized list of the device classes known to
107+
the cluster, each managed by a uniquely named DRA driver. If you set up a new
108+
test cluster for this tutorial, there should be no DeviceClasses.
133109

134-
1. Check the ResourceSlices:
110+
2. Get a list of {{< glossary_tooltip text="ResourceSlices" term_id="resourceslice" >}}:
135111

136112
```shell
137113
kubectl get resourceslices
@@ -141,16 +117,28 @@ are no ResourceSlices advertised.
141117
No resources found
142118
```
143119

144-
### View existing ResourceClaims and ResourceClaimTemplates
120+
ResourceSlices represent a partial list of {{< glossary_tooltip
121+
text="infrastructure resources" term_id="infrastructure-resource" >}} that are
122+
potentially available to use from Nodes. The collection of all ResourcesSlices
123+
in the cluster make up the entire set of devices available for dynamic
124+
assignment. Some infrastructure resource types (such as CPU and memory) are
125+
handled through other mechanisms (like [CPU limits and
126+
requests](docs/tasks/configure-pod-container/assign-cpu-resource/)), so they
127+
won't appear in the ResourceSlices. Storage (as in files and block devices) has
128+
its own management mechanism too; see [Storage](/docs/concepts/storage/volumes)
129+
elsewhere in the documentation.
145130

146-
{{< glossary_tooltip text="ResourceClaims" term_id="resourceclaim" >}} and {{<
147-
glossary_tooltip text="ResourceClaimTemplates" term_id="resourceclaimtemplate"
148-
>}} are user-defined objects that encapsulate the requests or requirements of
149-
Pods for different types of specialized devices. These are further described
150-
later, but you can see for now that there are no such objects stored yet as you,
151-
the user, have not created any.
131+
ResourceSlices can represent existing allocated infrastructure, but they can
132+
also represent an offer to provide infrastructure. For example, a specialized
133+
driver can offer a neural networking accelerator ResourceSlice, even though none
134+
of the nodes in the cluster have that kind of accelerator currently attached.
135+
136+
If you set up a new blank cluster for this tutorial, it's normal to find that there
137+
are no ResourceSlices advertised.
152138

153-
1. Check the ResourceClaims and ResourceClaimTemplates:
139+
1. View {{< glossary_tooltip text="ResourceClaims" term_id="resourceclaim" >}} and {{<
140+
glossary_tooltip text="ResourceClaimTemplates" term_id="resourceclaimtemplate"
141+
>}}
154142
155143
```shell
156144
kubectl get resourceclaims -A
@@ -162,9 +150,16 @@ the user, have not created any.
162150
No resources found
163151
```
164152

165-
At this point, you have confirmed that DRA is enabled and configured properly in
166-
the cluster, and that no DRA drivers have advertised any resources to the DRA
167-
APIs yet.
153+
{{< glossary_tooltip text="ResourceClaims" term_id="resourceclaim" >}} and {{<
154+
glossary_tooltip text="ResourceClaimTemplates" term_id="resourceclaimtemplate"
155+
>}} are user-defined objects that encapsulate the requests or requirements of
156+
Pods for different types of specialized devices. These are further described
157+
later, but you can see for now that there are no such objects stored yet as you,
158+
the user, have not created any.
159+
160+
At this point, you have confirmed that DRA is enabled and configured properly in
161+
the cluster, and that no DRA drivers have advertised any resources to the DRA
162+
APIs yet.
168163

169164
## Install an example DRA driver {#install-example-driver}
170165

0 commit comments

Comments
 (0)