Skip to content

Commit 3dfe545

Browse files
authored
Merge pull request #1288 from tkatila/readme-zsh-updates
Update README kubectl applies for zsh support
2 parents b170147 + 26b8b9b commit 3dfe545

File tree

8 files changed

+30
-30
lines changed

8 files changed

+30
-30
lines changed

cmd/dlb_plugin/README.md

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -37,8 +37,8 @@ List eventdev devices:
3737
$ ./usertools/dpdk-devbind.py -s | grep -A10 ^Eventdev
3838
Eventdev devices using kernel driver
3939
====================================
40-
0000:6d:00.0 'Device 2710' drv=dlb2 unused=
41-
0000:72:00.0 'Device 2710' drv=dlb2 unused=
40+
0000:6d:00.0 'Device 2710' drv=dlb2 unused=
41+
0000:72:00.0 'Device 2710' drv=dlb2 unused=
4242
...
4343
```
4444

@@ -59,12 +59,12 @@ Check that new eventdev devices appear:
5959
$ ./usertools/dpdk-devbind.py -s | grep -A14 ^Eventdev
6060
Eventdev devices using kernel driver
6161
====================================
62-
0000:6d:00.0 'Device 2710' drv=dlb2 unused=
63-
0000:6d:00.1 'Device 2711' drv=dlb2 unused=
64-
0000:6d:00.2 'Device 2711' drv=dlb2 unused=
65-
0000:6d:00.3 'Device 2711' drv=dlb2 unused=
66-
0000:6d:00.4 'Device 2711' drv=dlb2 unused=
67-
0000:72:00.0 'Device 2710' drv=dlb2 unused=
62+
0000:6d:00.0 'Device 2710' drv=dlb2 unused=
63+
0000:6d:00.1 'Device 2711' drv=dlb2 unused=
64+
0000:6d:00.2 'Device 2711' drv=dlb2 unused=
65+
0000:6d:00.3 'Device 2711' drv=dlb2 unused=
66+
0000:6d:00.4 'Device 2711' drv=dlb2 unused=
67+
0000:72:00.0 'Device 2710' drv=dlb2 unused=
6868
...
6969
```
7070

@@ -142,7 +142,7 @@ release version numbers in the format `x.y.z`, corresponding to the branches and
142142
repository. Thus the easiest way to deploy the plugin in your cluster is to run this command
143143

144144
```bash
145-
$ kubectl apply -k https://github.com/intel/intel-device-plugins-for-kubernetes/deployments/dlb_plugin?ref=<RELEASE_VERSION>
145+
$ kubectl apply -k 'https://github.com/intel/intel-device-plugins-for-kubernetes/deployments/dlb_plugin?ref=<RELEASE_VERSION>'
146146
daemonset.apps/intel-dlb-plugin created
147147
```
148148

cmd/dsa_plugin/README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -31,7 +31,7 @@ release version numbers in the format `x.y.z`, corresponding to the branches and
3131
repository. Thus the easiest way to deploy the plugin in your cluster is to run this command
3232

3333
```bash
34-
$ kubectl apply -k https://github.com/intel/intel-device-plugins-for-kubernetes/deployments/dsa_plugin?ref=<RELEASE_VERSION>
34+
$ kubectl apply -k 'https://github.com/intel/intel-device-plugins-for-kubernetes/deployments/dsa_plugin?ref=<RELEASE_VERSION>'
3535
daemonset.apps/intel-dsa-plugin created
3636
```
3737

cmd/fpga_plugin/README.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -151,7 +151,7 @@ The following images are available on the Docker hub:
151151

152152
Depending on the FPGA mode, run either
153153
```bash
154-
$ kubectl apply -k https://github.com/intel/intel-device-plugins-for-kubernetes/deployments/fpga_plugin/overlays/af?ref=<RELEASE_VERSION>
154+
$ kubectl apply -k 'https://github.com/intel/intel-device-plugins-for-kubernetes/deployments/fpga_plugin/overlays/af?ref=<RELEASE_VERSION>'
155155
namespace/intelfpgaplugin-system created
156156
customresourcedefinition.apiextensions.k8s.io/acceleratorfunctions.fpga.intel.com created
157157
customresourcedefinition.apiextensions.k8s.io/fpgaregions.fpga.intel.com created
@@ -168,7 +168,7 @@ issuer.cert-manager.io/intelfpgaplugin-selfsigned-issuer created
168168
```
169169
or
170170
```bash
171-
$ kubectl apply -k https://github.com/intel/intel-device-plugins-for-kubernetes/deployments/fpga_plugin/overlays/region?ref=<RELEASE_VERSION>
171+
$ kubectl apply -k 'https://github.com/intel/intel-device-plugins-for-kubernetes/deployments/fpga_plugin/overlays/region?ref=<RELEASE_VERSION>'
172172
namespace/intelfpgaplugin-system created
173173
customresourcedefinition.apiextensions.k8s.io/acceleratorfunctions.fpga.intel.com created
174174
customresourcedefinition.apiextensions.k8s.io/fpgaregions.fpga.intel.com created

cmd/iaa_plugin/README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -31,7 +31,7 @@ release version numbers in the format `x.y.z`, corresponding to the branches and
3131
repository. Thus the easiest way to deploy the plugin in your cluster is to run this command
3232

3333
```bash
34-
$ kubectl apply -k https://github.com/intel/intel-device-plugins-for-kubernetes/deployments/iaa_plugin?ref=<RELEASE_VERSION>
34+
$ kubectl apply -k 'https://github.com/intel/intel-device-plugins-for-kubernetes/deployments/iaa_plugin?ref=<RELEASE_VERSION>'
3535
daemonset.apps/intel-iaa-plugin created
3636
```
3737

cmd/operator/README.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -20,11 +20,11 @@ Install NFD (if it's not already installed) and node labelling rules (requires N
2020

2121
```
2222
# either with default NFD installation
23-
$ kubectl apply -k https://github.com/intel/intel-device-plugins-for-kubernetes/deployments/nfd?ref=<RELEASE_VERSION>
23+
$ kubectl apply -k 'https://github.com/intel/intel-device-plugins-for-kubernetes/deployments/nfd?ref=<RELEASE_VERSION>'
2424
# or when setting up with SGX
25-
$ kubectl apply -k https://github.com/intel/intel-device-plugins-for-kubernetes/deployments/nfd/overlays/sgx?ref=<RELEASE_VERSION>
25+
$ kubectl apply -k 'https://github.com/intel/intel-device-plugins-for-kubernetes/deployments/nfd/overlays/sgx?ref=<RELEASE_VERSION>'
2626
# and finally, NodeFeatureRules
27-
$ kubectl apply -k https://github.com/intel/intel-device-plugins-for-kubernetes/deployments/nfd/overlays/node-feature-rules?ref=<RELEASE_VERSION>
27+
$ kubectl apply -k 'https://github.com/intel/intel-device-plugins-for-kubernetes/deployments/nfd/overlays/node-feature-rules?ref=<RELEASE_VERSION>'
2828
```
2929
Make sure both NFD master and worker pods are running:
3030

@@ -111,7 +111,7 @@ $ export no_proxy=$no_proxy,.svc,.svc.cluster.local
111111
Finally deploy the operator itself:
112112

113113
```
114-
$ kubectl apply -k https://github.com/intel/intel-device-plugins-for-kubernetes/deployments/operator/default?ref=<RELEASE_VERSION>
114+
$ kubectl apply -k 'https://github.com/intel/intel-device-plugins-for-kubernetes/deployments/operator/default?ref=<RELEASE_VERSION>'
115115
```
116116

117117
Now you can deploy the device plugins by creating corresponding custom resources.

cmd/qat_plugin/README.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -104,15 +104,15 @@ release version numbers in the format `x.y.z`, corresponding to the branches and
104104
repository. Thus the easiest way to deploy the plugin in your cluster is to run this command
105105

106106
```bash
107-
$ kubectl apply -k https://github.com/intel/intel-device-plugins-for-kubernetes/deployments/qat_plugin?ref=<RELEASE_VERSION>
107+
$ kubectl apply -k 'https://github.com/intel/intel-device-plugins-for-kubernetes/deployments/qat_plugin?ref=<RELEASE_VERSION>'
108108
```
109109

110110
Where `<RELEASE_VERSION>` needs to be substituted with the desired [release tag](https://github.com/intel/intel-device-plugins-for-kubernetes/tags) or `main` to get `devel` images.
111111

112112
An alternative kustomization for deploying the plugin is with the debug mode switched on:
113113

114114
```bash
115-
$ kubectl apply -k https://github.com/intel/intel-device-plugins-for-kubernetes/deployments/qat_plugin/overlays/debug?ref=<RELEASE_VERSION>
115+
$ kubectl apply -k 'https://github.com/intel/intel-device-plugins-for-kubernetes/deployments/qat_plugin/overlays/debug?ref=<RELEASE_VERSION>'
116116
```
117117

118118
> **Note**: It is also possible to run the QAT device plugin using a non-root user. To do this,
@@ -122,7 +122,7 @@ $ kubectl apply -k https://github.com/intel/intel-device-plugins-for-kubernetes/
122122
123123
#### Automatic Provisioning
124124

125-
There's a sample [qat initcontainer](https://github.com/intel/intel-device-plugins-for-kubernetes/blob/main/build/docker/intel-qat-initcontainer.Dockerfile). Regardless of device types, the script running inside the initcontainer enables QAT SR-IOV VFs.
125+
There's a sample [qat initcontainer](https://github.com/intel/intel-device-plugins-for-kubernetes/blob/main/build/docker/intel-qat-initcontainer.Dockerfile). Regardless of device types, the script running inside the initcontainer enables QAT SR-IOV VFs.
126126

127127
To deploy, run as follows:
128128

@@ -132,9 +132,9 @@ $ kubectl apply -k deployments/qat_plugin/overlays/qat_initcontainer/
132132

133133
In addition to the default configuration, you can add device-specific configurations via ConfigMap.
134134

135-
| Device | Possible Configuration | How To Customize | Options | Notes |
135+
| Device | Possible Configuration | How To Customize | Options | Notes |
136136
|:-------|:-----------------------|:-----------------|:--------|:------|
137-
| 4xxx, 401xx | [cfg_services](https://github.com/torvalds/linux/blob/42e66b1cc3a070671001f8a1e933a80818a192bf/Documentation/ABI/testing/sysfs-driver-qat) reports the configured services (crypto services or compression services) of the QAT device. | `ServicesEnabled=<value>` | compress:`dc`, crypto:`sym;asym` | Linux 6.0+ kernel is required. |
137+
| 4xxx, 401xx | [cfg_services](https://github.com/torvalds/linux/blob/42e66b1cc3a070671001f8a1e933a80818a192bf/Documentation/ABI/testing/sysfs-driver-qat) reports the configured services (crypto services or compression services) of the QAT device. | `ServicesEnabled=<value>` | compress:`dc`, crypto:`sym;asym` | Linux 6.0+ kernel is required. |
138138

139139
To create a provisioning config after customizing, run as follows:
140140

cmd/sgx_plugin/README.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -84,8 +84,8 @@ Where `<RELEASE_VERSION>` needs to be substituted with the desired [release tag]
8484
First, deploy `node-feature-discovery`:
8585

8686
```bash
87-
$ kubectl apply -k https://github.com/intel/intel-device-plugins-for-kubernetes/deployments/nfd/overlays/sgx?ref=<RELEASE_VERSION>
88-
$ kubectl apply -k https://github.com/intel/intel-device-plugins-for-kubernetes/deployments/nfd/overlays/node-feature-rules?ref=<RELEASE_VERSION>
87+
$ kubectl apply -k 'https://github.com/intel/intel-device-plugins-for-kubernetes/deployments/nfd/overlays/sgx?ref=<RELEASE_VERSION>'
88+
$ kubectl apply -k 'https://github.com/intel/intel-device-plugins-for-kubernetes/deployments/nfd/overlays/node-feature-rules?ref=<RELEASE_VERSION>'
8989
```
9090

9191
**Note:** The [default configuration](/deployments/nfd/overlays/node-feature-rules/node-feature-rules.yaml) assumes that the in-tree driver is used and enabled (`CONFIG_X86_SGX=y`). If
@@ -94,15 +94,15 @@ the SGX DCAP out-of-tree driver is used, the `kernel.config` match expression mu
9494
Next, deploy the Intel Device plugin operator:
9595

9696
```bash
97-
$ kubectl apply -k https://github.com/intel/intel-device-plugins-for-kubernetes/deployments/operator/default?ref=<RELEASE_VERSION>
97+
$ kubectl apply -k 'https://github.com/intel/intel-device-plugins-for-kubernetes/deployments/operator/default?ref=<RELEASE_VERSION>'
9898
```
9999

100100
**Note:** See the operator [deployment details](/cmd/operator/README.md) for its dependencies and for setting it up on systems behind proxies.
101101

102102
Finally, deploy the SGX device plugin with the operator
103103

104104
```bash
105-
$ kubectl apply -f https://raw.githubusercontent.com/intel/intel-device-plugins-for-kubernetes/<RELEASE_VERSION>/deployments/operator/samples/deviceplugin_v1_sgxdeviceplugin.yaml
105+
$ kubectl apply -f 'https://raw.githubusercontent.com/intel/intel-device-plugins-for-kubernetes/<RELEASE_VERSION>/deployments/operator/samples/deviceplugin_v1_sgxdeviceplugin.yaml'
106106
```
107107

108108
### Installation Using kubectl
@@ -193,7 +193,7 @@ for generating SGX quotes for workloads. It is deployed with `hostNetwork: true`
193193
to allow connections to localhost PCCS.
194194

195195
```bash
196-
$ kubectl apply -k https://github.com/intel/intel-device-plugins-for-kubernetes/deployments/sgx_aesmd?ref=<RELEASE_VERSION>
196+
$ kubectl apply -k 'https://github.com/intel/intel-device-plugins-for-kubernetes/deployments/sgx_aesmd?ref=<RELEASE_VERSION>'
197197
$ kubectl get pods
198198
NAME READY STATUS RESTARTS AGE
199199
intel-sgx-aesmd-mrnm8 1/1 Running 0 3h47m
@@ -211,15 +211,15 @@ $ kubectl get pods
211211
> extraMounts:
212212
> - hostPath: /var/run/aesmd
213213
> containerPath: /var/run/aesmd
214-
> propagation: Bidirectional
214+
> propagation: Bidirectional
215215
>```
216216
> And bootstrap kind with it \
217217
> `$ kind create cluster --config kind_config.yaml`
218218
219219
The sample application runs SGX DCAP Quote Generation sample:
220220
221221
```bash
222-
$ kubectl apply -k https://github.com/intel/intel-device-plugins-for-kubernetes/deployments/sgx_enclave_apps/overlays/sgx_ecdsa_aesmd_quote?ref=<RELEASE_VERSION>
222+
$ kubectl apply -k 'https://github.com/intel/intel-device-plugins-for-kubernetes/deployments/sgx_enclave_apps/overlays/sgx_ecdsa_aesmd_quote?ref=<RELEASE_VERSION>'
223223
$ kubectl get pods
224224
NAME READY STATUS RESTARTS AGE
225225
intel-sgx-aesmd-mrnm8 1/1 Running 0 3h55m

cmd/vpu_plugin/README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -51,7 +51,7 @@ release version numbers in the format `x.y.z`, corresponding to the branches and
5151
repository. Thus the easiest way to deploy the plugin in your cluster is to run this command
5252

5353
```bash
54-
$ kubectl apply -k https://github.com/intel/intel-device-plugins-for-kubernetes/deployments/vpu_plugin?ref=<RELEASE_VERSION>
54+
$ kubectl apply -k 'https://github.com/intel/intel-device-plugins-for-kubernetes/deployments/vpu_plugin?ref=<RELEASE_VERSION>'
5555
daemonset.apps/intel-vpu-plugin created
5656
```
5757

0 commit comments

Comments
 (0)