You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: released/SAP-Inside-Tracks/SITBLR_DEC_2024/README.md
+18-82Lines changed: 18 additions & 82 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,20 +2,7 @@
2
2
3
3
## Goal of this HandsOn 🎯
4
4
5
-
In this HandsOn you will learn how to use the [Terraform Provider for SAP BTP](https://registry.terraform.io/providers/SAP/cp/latest/docs) to provision and manage resources in SAP BTP.
6
-
7
-
## Scenario 📚
8
-
9
-
In this HandsOn we want to make you familiar with the Terraform Provider for SAP BTP. We will use the provider to provision and manage resources in SAP BTP. To achieve this we will walk through the following steps:
10
-
11
-
1.[Exercise 1 - Configure the Terraform Provider for SAP BTP](exercises/EXERCISE1/README.md)
12
-
1.[Exercise 2 - Setup of a subaccount](exercises/EXERCISE2/README.md)
13
-
1.[Exercise 3 - Assign entitlement,Subscription and its role assignments to a subaccount](exercises/EXERCISE3/README.md)
14
-
1.[Exercise 4 - Setup a Cloud Foundry environment and a space (optional)](exercises/EXERCISE4/README.md)
The level of the exercises is beginner. You don't need any prior knowledge about Terraform or the Terraform Provider for SAP BTP. We will guide you through the exercises step by step.
5
+
In this HandsOn you will learn how to use the [Terraform Provider for SAP BTP](https://registry.terraform.io/providers/SAP/cp/latest/docs) to provision and manage resources in SAP BTP. The level of the exercises is beginner. You don't need any prior knowledge about Terraform or the Terraform Provider for SAP BTP. We will guide you through the exercises step by step.
19
6
20
7
## Prerequisites 📝
21
8
@@ -25,16 +12,11 @@ Make sure that the following prerequisites are met:
25
12
- Make sure that your SAP Universal ID is configured correctly. You can find the instructions in [SAP Note 3085908](https://me.sap.com/notes/3085908).
26
13
- The Terraform provider does not support SSO or 2FA. Make sure that these options are not enforced for your account.
27
14
15
+
28
16
## Tools 🛠️
29
17
30
18
To execute the exercises you have the following options concerning the required tools installed:
31
19
32
-
- local installation
33
-
- usage of the provided dev container
34
-
- usage of GitHub Codespaces
35
-
36
-
You find details about the installation of the tools in the following sections
37
-
38
20
In general you must clone this GitHub repository. You must have the Git client installed on your machine. You can find the installation instructions [here](https://git-scm.com/downloads).
39
21
40
22
You can then clone the repository via the following command:
@@ -43,67 +25,14 @@ You can then clone the repository via the following command:
- An editor of your choice. We recommend [Visual Studio Code](https://code.visualstudio.com/Download) with the [Terraform extension](https://marketplace.visualstudio.com/items?itemName=HashiCorp.terraform).
54
35
55
-
### Dev Container
56
-
57
-
As an alternative to the local installation you can use the provided dev container that contains all required tools. This requires that you have [Docker](https://www.docker.com/products/docker-desktop) installed on your machine. In addition you need the dev container extension for Visual Studio Code. You can find detailed instructions about the setup [here](https://code.visualstudio.com/docs/devcontainers/containers#_getting-started).
58
-
59
-
To start a dev container Docker must be running on your machine.
60
-
61
-
To use the dev container you must open the folder that contains the cloned repository in Visual Studio Code. You will be asked if you want to reopen the folder in the dev container. Confirm this.
62
-
63
-
If this is not the case execute the following steps:
64
-
65
-
1. Open the command palette in Visual Studio Code:
66
-
67
-
- Windows / Linux: `Ctrl + Shift + P`
68
-
- Mac: `Cmd + Shift + P`
69
-
70
-
2. Enter `Dev Containers: Reopen in Container` and confirm with `Enter`.
71
-
72
-
3. You will then be asked to select a dev container. Select the `Terraform provider for SAP BTP - Default` container:
73
-
74
-

75
-
76
-
The dev container will automatically start and you are ready to go
77
-
78
-
### GitHub Codespaces
79
-
80
-
To use [Codespaces](https://docs.github.com/codespaces/overview) you must have a GitHub account. If you don't have one so far, please [sign-up on GitHub](https://github.com/signup) before going through the exercises.
81
-
82
-
You can then access the Codespace following these steps:
83
-
84
-
1. Open the [GitHub repository of the Terraform samples](https://github.com/SAP-samples/btp-terraform-samples).
85
-
86
-

87
-
88
-
2. Click on this button and create the code space:
89
-
90
-
[](https://github.com/codespaces/new?hide_repo_select=true&ref=main&repo=656281656&skip_quickstart=true&machine=basicLinux32gb&geo=EuropeWest&devcontainer_path=.devcontainer%2Fdevcontainer.json)
91
-
92
-
This will take a few minutes. Be patient 🙂
93
-
94
-

95
-
96
-
3. While the Codespace is created for you, you will see this screen
97
-
98
-

99
-
100
-
4. Once all is done, you are in your Codespace.
101
-
102
-

103
-
104
-
> [!IMPORTANT]
105
-
> GitHub codespaces are free for a certain amount of time per month. For the hands-on session the free time is more than enough. **Don't forget to delete your codespace again after the hands-on session!**
106
-
107
36
108
37
## Exporting environment variables
109
38
@@ -128,17 +57,24 @@ Validate that the values are set via:
128
57
- Windows: `$env:BTP_USERNAME` and `$env:BTP_PASSWORD`
129
58
- Linux/MacOS/GitHub Codeapses: `echo $BTP_USERNAME` and `echo $BTP_PASSWORD`
130
59
131
-
## Folder layout
132
60
133
-
You find all exercises of this tutorial in the folder `released/dsag/betriebstag2024/exercises`. Each exercise is contained in a dedicated folder containing:
61
+
## Summary
134
62
135
-
- A `README.md` file with the instructions for the exercise
136
-
- A folder `SOLUTION_EX<number>` which contains the solution for the exercise if needed including the file `terraform.tfvars-sample` contains the definition of the local variables. In case you get stuck you can check the content of this folder.
63
+
You've now prepared your development environment and have all information to finally start using Terraform provider for SAP BTP.
64
+
65
+
66
+
67
+
## Exercises 📚
68
+
69
+
In this HandsOn we want to make you familiar with the Terraform Provider for SAP BTP. We will use the provider to provision and manage resources in SAP BTP. To achieve this we will walk through the following steps:
70
+
71
+
1. [Exercise 1 - Configure the Terraform Provider for SAP BTP](exercises/EXERCISE1/README.md)
72
+
1. [Exercise 2 - Setup of a subaccount](exercises/EXERCISE2/README.md)
73
+
1. [Exercise 3 - Assign entitlement,Subscription and its role assignments to a subaccount](exercises/EXERCISE3/README.md)
74
+
1. [Exercise 4 - Setup a Cloud Foundry environment and a space (optional)](exercises/EXERCISE4/README.md)
Copy file name to clipboardExpand all lines: released/SAP-Inside-Tracks/SITBLR_DEC_2024/exercises/EXERCISE1/README.md
+3Lines changed: 3 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -58,6 +58,9 @@ the file `terraform.tfvars` and add the following content:
58
58
globalaccount = "<YOUR GLOBAL ACCOUNT SUBDOMAIN>"
59
59
```
60
60
61
+
The SAP BTP Global Account Subdomain can be found in the SAP BTP Cockpit as shown below
62
+
<imgwidth="600px"src="assets/trial-account.png"alt="SAP BTP Global Account Subdomain">
63
+
61
64
> [!NOTE]
62
65
> We are using here a naming convention of Terraform to define the variable values. The file `terraform.tfvars` is used to define the variable values. The file is not checked into the source code repository. This is important to keep sensitive information out of the source code repository. When you run Terraform, it will automatically load the variable values from this file.
0 commit comments