Skip to content

Commit dd36b8b

Browse files
authored
Update btp-app-kyma-prepare-dev-environment.md
added a new step to verify the `cds` and `cds-dk` version before installing `kubectl`
1 parent 1969c4a commit dd36b8b

1 file changed

Lines changed: 39 additions & 60 deletions

File tree

tutorials/btp-app-kyma-prepare-dev-environment/btp-app-kyma-prepare-dev-environment.md

Lines changed: 39 additions & 60 deletions
Original file line numberDiff line numberDiff line change
@@ -32,86 +32,67 @@ primary_tag: software-product-function>sap-cloud-application-programming-model
3232

3333

3434
---
35+
[ACCORDION-BEGIN [Step 1: ](Verify your cds and cds-dk versions before installing kubectl)]
36+
> ### To earn your badge for the whole mission, you will need to mark all steps in a tutorial as done, including any optional ones that you may have skipped because they are not relevant for you.
3537
36-
[ACCORDION-BEGIN [Step 1: ](Install kubectl)]
37-
[OPTION BEGIN [macOS]]
38-
39-
1. Make sure your `package.json` is using `@sap/cds 6.0.1` or newer and you have `@sap/cds-dk 6.0.1` or newer globally installed:
38+
Make sure your `package.json` is using `@sap/cds 6.0.1` or newer and you have `@sap/cds-dk 6.0.1` or newer globally installed. To check it, do the following in your project directory:
4039

41-
To check it, do the following in your project directory:
42-
1. Run `npm install` to install your local package
43-
2. Run `cds version` to see the globally installed `@sap/cds-dk` and your locally installed `@sap/cds`
40+
1. Run `npm install` to install your local package.
41+
2. Run `cds version` to see the globally installed `@sap/cds-dk` and your locally installed `@sap/cds`.
42+
3. To upgrade, run `npm install @sap/cds@>=6` and `npm install -g @sap/cds-dk@>=6`.
43+
44+
[DONE]
45+
[ACCORDION-END]
46+
---
4447

45-
To upgrade, run:
46-
1. `npm install @sap/cds@>=6`
47-
2. `npm install -g @sap/cds-dk@>=6`
48+
[ACCORDION-BEGIN [Step 2: ](Install kubectl)]
49+
[OPTION BEGIN [macOS]]
50+
1. To install kubectl run:
4851

49-
2. To install kubectl run:
52+
```Shell/Bash
53+
brew install kubectl
54+
```
5055
51-
```Shell/Bash
52-
brew install kubectl
53-
```
56+
2. Check if the installation was successful:
5457
55-
3. Check if the installation was successful:
56-
4.
57-
```Shell/Bash
58-
kubectl version --client
59-
```
58+
```Shell/Bash
59+
kubectl version --client
60+
```
6061
6162
You should see a version number.
6263
6364
[OPTION END]
6465
[OPTION BEGIN [Windows]]
65-
66-
1. Make sure your `package.json` is using `@sap/cds 6.0.1` or newer and you have `@sap/cds-dk 6.0.1` or newer globally installed:
67-
68-
To check it, do the following in your project directory:
69-
1. Run `npm install` to install your local package
70-
2. Run `cds version` to see the globally installed `@sap/cds-dk` and your locally installed `@sap/cds`
71-
72-
To upgrade, run:
73-
1. `npm install @sap/cds@>=6`
74-
2. `npm install -g @sap/cds-dk@>=6`
7566
7667
You can install kubectl using chocolatey.
7768
78-
2. Run the following command:
69+
1. Run the following command:
7970
80-
```Shell/Bash
81-
choco install kubernetes-cli
82-
```
71+
```Shell/Bash
72+
choco install kubernetes-cli
73+
```
8374
84-
3. Check if the installation is successful:
85-
4.
86-
```Shell/Bash
87-
kubectl version --client
88-
```
75+
2. Check if the installation is successful:
76+
77+
```Shell/Bash
78+
kubectl version --client
79+
```
8980
9081
You should see something like `Client Version: version.Info{Major:"1", Minor:"19", GitVersion:"v1.19.3", GitCommit:"1e11e4a2108024935ecfcb2912226cedeafd99df", GitTreeState:"clean", BuildDate:"2020-10-14T12:50:19Z", GoVersion:"go1.15.2", Compiler:"gc", Platform:"windows/amd64"}`.
9182
9283
9384
[OPTION END]
9485
[OPTION BEGIN [Linux]]
9586
96-
1. Make sure your `package.json` is using `@sap/cds 6.0.1` or newer and you have `@sap/cds-dk 6.0.1` or newer globally installed:
97-
98-
To check it, do the following in your project directory:
99-
1. Run `npm install` to install your local package
100-
2. Run `cds version` to see the globally installed `@sap/cds-dk` and your locally installed `@sap/cds`
101-
102-
To upgrade, run:
103-
1. `npm install @sap/cds@>=6`
104-
2. `npm install -g @sap/cds-dk@>=6`
105-
106-
2. Follow the instructions for your preferred way of installing kubectl at [Install and Set Up kubectl on Linux](https://kubernetes.io/docs/tasks/tools/install-kubectl-linux/).
87+
Follow the instructions for your preferred way of installing kubectl at [Install and Set Up kubectl on Linux](https://kubernetes.io/docs/tasks/tools/install-kubectl-linux/).
10788
10889
[OPTION END]
10990
11091
11192
[DONE]
11293
[ACCORDION-END]
11394
---
114-
[ACCORDION-BEGIN [Step 2: ](Install kubelogin)]
95+
[ACCORDION-BEGIN [Step 3: ](Install kubelogin)]
11596
[OPTION BEGIN [macOS]]
11697
11798
```Shell/Bash
@@ -144,7 +125,7 @@ See [kubelogin](https://github.com/int128/kubelogin#setup) docs for more details
144125
[DONE]
145126
[ACCORDION-END]
146127
---
147-
[ACCORDION-BEGIN [Step 3: ](Login to your Kyma cluster)]
128+
[ACCORDION-BEGIN [Step 4: ](Login to your Kyma cluster)]
148129
1. Choose **KubeconfigURL** under the **Kyma Environment** tab in your subaccount.
149130

150131
!![Kubeconfig URL](kubeconfigURL.png)
@@ -178,7 +159,7 @@ See [kubelogin](https://github.com/int128/kubelogin#setup) docs for more details
178159
[DONE]
179160
[ACCORDION-END]
180161
---
181-
[ACCORDION-BEGIN [Step 4: ](Create a namespace for your app)]
162+
[ACCORDION-BEGIN [Step 5: ](Create a namespace for your app)]
182163
1. Run the following command to create a namespace `risk-management`:
183164

184165
```Shell/Bash
@@ -196,7 +177,7 @@ See [kubelogin](https://github.com/int128/kubelogin#setup) docs for more details
196177
[DONE]
197178
[ACCORDION-END]
198179
---
199-
[ACCORDION-BEGIN [Step 5: ](Create container registry secret)]
180+
[ACCORDION-BEGIN [Step 6: ](Create container registry secret)]
200181
The container registry secret is needed to access docker container images in your registry from your Kyma cluster.
201182
202183
Kubernetes has a special type of secret for container registries and its kubectl command line supports it with the required options:
@@ -237,7 +218,7 @@ kubectl create secret docker-registry container-registry \
237218
[DONE]
238219
[ACCORDION-END]
239220
---
240-
[ACCORDION-BEGIN [Step 6: ](Install helm)]
221+
[ACCORDION-BEGIN [Step 7: ](Install helm)]
241222
[OPTION BEGIN [macOS]]
242223
243224
There's a multitude of options to install helm. You can see the full list at [Installing Helm](https://helm.sh/docs/intro/install/). We have also listed some options:
@@ -275,7 +256,7 @@ You should see something like `version.BuildInfo{Version:"v3.8.0", GitCommit:"d1
275256
[DONE]
276257
[ACCORDION-END]
277258
---
278-
[ACCORDION-BEGIN [Step 7: ](Install Paketo (pack))]
259+
[ACCORDION-BEGIN [Step 8: ](Install Paketo (pack))]
279260
[OPTION BEGIN [macOS]]
280261

281262
Pack lets you build container images, which are collaboratively maintained making it easier to maintain and update.
@@ -329,16 +310,14 @@ Follow the instructions to install the [pack CLI](https://buildpacks.io/docs/too
329310
[DONE]
330311
[ACCORDION-END]
331312
---
332-
[ACCORDION-BEGIN [Step 8: ](Docker)]
333-
334-
> ### To earn your badge for the whole mission, you will need to mark all steps in a tutorial as done, including any optional ones that you may have skipped because they are not relevant for you.
313+
[ACCORDION-BEGIN [Step 9: ](Docker)]
335314

336315
Kyma runs on containers. Hence, for this tutorial, you'll need an application that enables you to build containerized applications and a docker-compatible command line interface. In the following we provide two examples - Docker Desktop and Rancher Desktop.
337316

338317
[DONE]
339318
[ACCORDION-END]
340319
---
341-
[ACCORDION-BEGIN [Step 9: ](Docker Desktop)]
320+
[ACCORDION-BEGIN [Step 10: ](Docker Desktop)]
342321
[OPTION BEGIN [macOS]]
343322

344323
To install Docker Desktop:
@@ -362,7 +341,7 @@ To install Docker Desktop:
362341
[DONE]
363342
[ACCORDION-END]
364343
---
365-
[ACCORDION-BEGIN [Step 10: ](Rancher Desktop)]
344+
[ACCORDION-BEGIN [Step 11: ](Rancher Desktop)]
366345
[OPTION BEGIN [macOS]]
367346

368347
To install Rancher Desktop:

0 commit comments

Comments
 (0)