Skip to content

Commit 28c5aa5

Browse files
committed
fix typos and update images
1 parent 94b4bb2 commit 28c5aa5

File tree

6 files changed

+32
-87
lines changed

6 files changed

+32
-87
lines changed

released/SAP-Inside-Tracks/SITBLR_DEC_2024/README.md

Lines changed: 18 additions & 82 deletions
Original file line numberDiff line numberDiff line change
@@ -2,20 +2,7 @@
22

33
## Goal of this HandsOn 🎯
44

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)
15-
1. [Exercise 5 - Exercise 5 - Assignment of subaccount emergency administrators](exercises/EXERCISE5/README.md)
16-
1. [Exercise 6 - Cleanup](exercises/EXERCISE6/README.md)
17-
18-
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.
196

207
## Prerequisites 📝
218

@@ -25,16 +12,11 @@ Make sure that the following prerequisites are met:
2512
- 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).
2613
- The Terraform provider does not support SSO or 2FA. Make sure that these options are not enforced for your account.
2714

15+
2816
## Tools 🛠️
2917

3018
To execute the exercises you have the following options concerning the required tools installed:
3119

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-
3820
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).
3921

4022
You can then clone the repository via the following command:
@@ -43,67 +25,14 @@ You can then clone the repository via the following command:
4325
git clone https://github.com/SAP-samples/btp-terraform-samples.git
4426
```
4527

46-
you find the exercises in the folder `released/dsag/betriebstag2024/exercises`.
28+
you find the exercises in the folder `released/SAP-Inside-Tracks/SITBLR_DEC_2024/exercises`.
4729

48-
### Local Installation
4930

5031
You can install the required tools locally on your machine. The following tools are required:
5132

5233
- [Terraform CLI](https://developer.hashicorp.com/terraform/install?product_intent=terraform)
5334
- 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).
5435

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-
![Select dev container](assets/devcontainer-selection.png)
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-
![Screenshot of GitHub repository Terraform samples](assets/repo-terraform-samples.png)
87-
88-
2. Click on this button and create the code space:
89-
90-
[![Open in GitHub Codespaces](https://github.com/codespaces/badge.svg)](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-
![Screenshot of navigation to Codespace creation in the repository Terraform samples](assets/codespace-creation.png)
95-
96-
3. While the Codespace is created for you, you will see this screen
97-
98-
![Screenshot of setup screen for Codespace](assets/codespace-setup-process.png)
99-
100-
4. Once all is done, you are in your Codespace.
101-
102-
![Screenshot of GitHub Codespace view on the repository Terraform samples](assets/codespace-screen.png)
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-
10736

10837
## Exporting environment variables
10938

@@ -128,17 +57,24 @@ Validate that the values are set via:
12857
- Windows: `$env:BTP_USERNAME` and `$env:BTP_PASSWORD`
12958
- Linux/MacOS/GitHub Codeapses: `echo $BTP_USERNAME` and `echo $BTP_PASSWORD`
13059
131-
## Folder layout
13260
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
13462
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)
75+
1. [Exercise 5 - Exercise 5 - Assignment of subaccount emergency administrators](exercises/EXERCISE5/README.md)
76+
1. [Exercise 6 - Cleanup](exercises/EXERCISE6/README.md)
13777
138-
In addition the folder `solution` contains the final configuration setup if you have gone through all exercises.
13978
140-
## Summary
14179
142-
You've now prepared your development environment and have all information to finally start using Terraform provider for SAP BTP.
14380
144-
Continue to - [Exercise 1 - Configure the Terraform Provider for SAP BTP](exercises/EXERCISE1/README.md).

released/SAP-Inside-Tracks/SITBLR_DEC_2024/exercises/EXERCISE1/README.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -58,6 +58,9 @@ the file `terraform.tfvars` and add the following content:
5858
globalaccount = "<YOUR GLOBAL ACCOUNT SUBDOMAIN>"
5959
```
6060

61+
The SAP BTP Global Account Subdomain can be found in the SAP BTP Cockpit as shown below
62+
<img width="600px" src="assets/trial-account.png" alt="SAP BTP Global Account Subdomain">
63+
6164
> [!NOTE]
6265
> 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.
6366
311 KB
Loading

released/SAP-Inside-Tracks/SITBLR_DEC_2024/exercises/EXERCISE3/README.md

Lines changed: 11 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -23,6 +23,12 @@ variable "bas_developers" {
2323
type = list(string)
2424
description = "List of users to assign the Developer role."
2525
}
26+
variable "bas_service_name" {
27+
type = string
28+
description = "Service name for Business Application Studio."
29+
default = "sapappstudio"
30+
31+
}
2632
variable "bas_plan" {
2733
type = string
2834
description = "Plan name for Business Application Studio."
@@ -43,8 +49,8 @@ We want to add the following entitlements to the subaccount:
4349
Open the `terraform.tfvars` file and add the following code:
4450

4551
```terraform
52+
bas_service_name = "sapappstudiotrial"
4653
bas_plan = "trial"
47-
4854
4955
bas_developers = ["[email protected]", "[email protected]"]
5056
```
@@ -56,14 +62,14 @@ As we have the variable and the values for the `BAS` in place, we can now add th
5662
```terraform
5763
resource "btp_subaccount_entitlement" "bas" {
5864
subaccount_id = btp_subaccount.project.id
59-
service_name = "sapappstudio"
65+
service_name = var.bas_service_name
6066
plan_name = var.bas_plan
6167
amount = 1
6268
}
6369
6470
resource "btp_subaccount_subscription" "bas" {
6571
subaccount_id = btp_subaccount.project.id
66-
app_name = "sapappstudio"
72+
app_name = var.bas_service_name
6773
plan_name = var.bas_plan
6874
depends_on = [btp_subaccount_entitlement.bas]
6975
}
@@ -102,7 +108,7 @@ Now we can apply the changes to our subaccount. Run the following commands:
102108

103109
You should see the following output:
104110

105-
<img width="600px" src="assets/ex4_1.png" alt="terraform plan output for entitlements">
111+
<img width="600px" src="assets/ex3_1.png" alt="terraform plan output for entitlements">
106112

107113
2. Apply the Terraform configuration to add the entitlements:
108114

@@ -112,7 +118,7 @@ Now we can apply the changes to our subaccount. Run the following commands:
112118

113119
You will be prompted to confirm the creation of the entitlements. Type `yes` and press `Enter` to continue. You should see the following output:
114120

115-
<img width="600px" src="assets/ex4_2.png" alt="terraform apply output for entitlements">
121+
<img width="600px" src="assets/ex3_2.png" alt="terraform apply output for entitlements">
116122

117123
You can also check that everything is in place via the SAP BTP cockpit. You should see the assigned entitlements in the subaccount.
118124

398 KB
Loading
447 KB
Loading

0 commit comments

Comments
 (0)