Skip to content

Commit 953671d

Browse files
Application Lifecycle Management using CAP Operator
1 parent ed2ac6f commit 953671d

37 files changed

Lines changed: 811 additions & 0 deletions
Lines changed: 182 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,182 @@
1+
---
2+
title: Prepare for Deployment
3+
description: Learn how to set up the SAP BTP, Kyma runtime for deploying the application.
4+
parser: v2
5+
auto_validation: true
6+
time: 30
7+
tags: [ tutorial>beginner, software-product>sap-cap-operator--kubernetes-environment, topic>cloud-operations, software-product-function>sap-cloud-application-programming-model, programming-tool>node-js, software-product>sap-business-technology-platform, software-product>sap-btp--kyma-runtime]
8+
primary_tag: software-product>sap-cap-operator--kubernetes-environment
9+
author_name: Anirudh Prasad
10+
author_profile: https://github.com/anirudhprasad-sap
11+
---
12+
13+
## You will learn
14+
15+
- How to configure entitlements.
16+
- How to enable the SAP BTP Kyma runtime in your subaccount in SAP BTP.
17+
- How to create an SAP HANA Cloud service instance in the SAP BTP cockpit.
18+
- How to enable the CAP Operator community module in your Kyma cluster.
19+
20+
## Prerequisites
21+
22+
- You have an [enterprise global account](https://help.sap.com/docs/btp/sap-business-technology-platform/getting-global-account#loiod61c2819034b48e68145c45c36acba6e) in SAP BTP. To use services for free, you can sign up for an SAP BTPEA (SAP BTP Enterprise Agreement) or a Pay-As-You-Go for SAP BTP global account and use the free tier services only. See [Using Free Service Plans](https://help.sap.com/docs/btp/sap-business-technology-platform/using-free-service-plans?version=Cloud).
23+
- You have a platform user. See [User and Member Management](https://help.sap.com/docs/btp/sap-business-technology-platform/user-and-member-management).
24+
- You're an administrator of the global account in SAP BTP.
25+
- You have a subaccount in SAP BTP to deploy the services and applications.
26+
27+
> This tutorial follows the guidance provided in the [SAP BTP Developer's Guide](https://help.sap.com/docs/btp/btp-developers-guide/what-is-btp-developers-guide).
28+
29+
### Configure the entitlements
30+
31+
To deploy the Incident Management sample application, you need the following entitlements:
32+
33+
| Service | Plan | Quota required |
34+
| ------------- | :-----------: | ----: |
35+
| Kyma runtime | free (Environment) | 1 |
36+
| SAP HANA Cloud | hana-free | 1 |
37+
| SAP HANA Cloud | tools (Application) | 1 |
38+
| SAP HANA Schemas & HDI Containers | hdi-shared | 1 |
39+
| HTML5 Application Repository Service | app-host | 1 |
40+
| HTML5 Application Repository Service | app-runtime | 1 |
41+
| Destination Service | lite | 1 |
42+
| SaaS Provisioning Service | application | 1 |
43+
| Service Manager | container | 1 |
44+
| Authorization and Trust Management Service | broker | 1 |
45+
46+
> You can find more information about entitlements in [Configure Entitlements and Quotas](https://help.sap.com/docs/btp/sap-business-technology-platform/configure-entitlements-and-quotas-for-subaccounts).
47+
48+
### Enable SAP BTP, Kyma runtime
49+
50+
Let's enable your subaccount to use the SAP BTP, Kyma runtime.
51+
52+
1. Navigate to your subaccount and choose **Enable Kyma** under the **Kyma Environment** tab.
53+
54+
<!-- border; size:540px --> ![Enable Kyma](./img/enable-kyma.png)
55+
56+
2. In the **Enable Kyma** popup, change the values for **Instance Name** and **Cluster Name** as needed and choose **Create**.
57+
58+
<!-- border; size:540px --> ![Enable Kyma popup](./img/enable-kyma-popup.png)
59+
60+
> Make sure that the instance name is CLI-friendly. CLI-friendly names make it easier to manage your instances with the SAP BTP command-line interface as well.
61+
>
62+
> A CLI-friendly name is a short string (up to 32 characters) that contains only alphanumeric characters (A-Z, a-z, 0-9), periods, underscores, and hyphens. It can't contain white spaces.
63+
>
64+
> When enabling the runtime, you notice that the instance name is generated automatically for you. You can use that name or replace it with the name of your choice.
65+
66+
67+
### Subscribe to SAP HANA Cloud Administration Tools
68+
69+
1. Navigate to your subaccount and choose **Services** &rarr; **Service Marketplace** on the left.
70+
71+
2. Type **SAP HANA Cloud** in the search box and choose **Create**.
72+
73+
<!-- border; size:540px --> ![Create an SAP HANA Cloud tools instance](./img/create-hana-tools.png)
74+
75+
3. In the **New Instance or Subscription** popup, select **tools** from the dropdown in the **Plan** field and choose **Create**.
76+
77+
<!-- border; size:540px --> ![SAP HANA Cloud tools instance creation popup](./img/create-hana-tools-popup.png)
78+
79+
4. Choose **View Subscription** and wait until the status changes to **Subscribed**.
80+
81+
<!-- border; size:540px --> ![View subscription](./img/view-subscription.png)
82+
83+
<!-- border; size:540px --> ![Status subscribed](./img/hanatools-status-subscribed.png)
84+
85+
5. In your SAP BTP subaccount, choose **Security** &rarr; **Role Collections** in the left-hand pane.
86+
87+
6. Choose role collection **SAP HANA Cloud Administrator**.
88+
89+
7. Choose **Edit**.
90+
91+
<!-- border; size:540px --> ![Edit role](./img/hana-edit-role.png)
92+
93+
8. In the **Users** section, enter your user and select the icon to add the user.
94+
95+
<!-- border; size:540px --> ![Add user](./img/hana-add-user.png)
96+
97+
> Keep the `Default Identity Provider` setting unless you have a custom identity provider configured.
98+
99+
9. Choose **Save**.
100+
101+
You've assigned the **SAP HANA Cloud Administrator** role collection to your user.
102+
103+
> Log out and log back in to make sure your new role collection is considered.
104+
105+
### Create an SAP HANA Cloud service instance
106+
107+
SAP HANA Cloud is used as a persistence layer.
108+
109+
Follow these steps to create an SAP HANA Cloud service instance in the SAP BTP cockpit:
110+
111+
1. In your SAP BTP subaccount, navigate to **Services** &rarr; **Instances and Subscriptions** in the left-hand pane.
112+
113+
2. Choose **SAP HANA Cloud**. You're redirected to SAP HANA Cloud multi-environment administration tools. Sign in with your SAP BTP cockpit username/email if necessary.
114+
115+
<!-- border; size:540px --> ![SAP HANA Cloud Go to application](./img/hana-goto-app.png)
116+
117+
3. In SAP HANA Cloud Central, choose **Create Instance**.
118+
119+
<!-- border; size:540px --> ![SAP HANA Cloud create instance](./img/hana-create-instance.png)
120+
121+
4. Choose *Confiure manually* as **Instance Configuration** and *SAP HANA Database* as **Instance Type**. Then, choose **Next Step**.
122+
123+
<!-- border; size:540px --> ![Create SAP HANA DB Step 1](./img/create-hana-db1.png)
124+
125+
5. In the **Instance Name** field, enter *application-hana-instance*.
126+
127+
6. In the **Administrator Password** and **Confirm Administrator Password** fields, enter a password for DBADMIN. Choose **Next Step**.
128+
129+
<!-- border; size:540px --> ![Create SAP HANA DB Step 2](./img/create-hana-db2.png)
130+
131+
7. At **SAP HANA Database: Size and Availability**, choose **Next Step**.
132+
133+
8. In **SAP HANA Database: Connections**, select the **All IP addresses** radio button, and choose **Next Step**.
134+
135+
<!-- border; size:540px --> ![Create SAP HANA DB Step 3](./img/create-hana-db3.png)
136+
137+
9. At **SAP HANA Database: Advanced Settings**, choose **Next Step**.
138+
139+
10. At **Data Lake: General**, choose **Review and Create**.
140+
141+
11. Choose **Create Instance**.
142+
143+
The creation of the database instance can take some minutes to complete.
144+
145+
> Your SAP HANA Cloud service instance automatically stops overnight, according to the time zone of the region where the server is located. This means you need to restart your instance every day before you start working with it.
146+
147+
### Map your SAP HANA Cloud service instance to your Kyma cluster
148+
149+
1. Go to SAP HANA Cloud Central. If you've closed it, open it again by following these steps:
150+
151+
- In your SAP BTP subaccount, navigate to **Services** &rarr; **Instances and Subscriptions**.
152+
- Choose **SAP HANA Cloud**. You're redirected to SAP HANA Cloud multi-environment administration tools. Sign in with your SAP BTP cockpit username/email if necessary.
153+
154+
2. For the **application-hana-instance** instance, choose **Manage Configuration**.
155+
156+
<!-- border; size:540px --> ![Manage instance configuration](./img/hana-config.png)
157+
158+
3. Select the **Instance Mapping** tab and choose **Add Mapping**.
159+
160+
<!-- border; size:540px --> ![Add instance mapping](./img/hana-add-mapping.png)
161+
162+
4. Select **Kyma** from the dropdown under **Environment Type**.
163+
164+
5. Under **Environment Instance ID**, paste the GUID of your Kyma cluster. Here's how to find it:
165+
166+
- Open your Kyma dashboard.
167+
- Choose **Namespaces** on the left and choose **kyma-system**.
168+
- Navigate to **Configuration** &rarr; **Config Maps** and choose **sap-btp-operator-config**.
169+
- You can see the GUID of your Kyma cluster in the **CLUSTER_ID** section.
170+
171+
<!-- border; size:540px --> ![Add environment instance ID](./img/hana-kyma-cluster-id.png)
172+
173+
> If no namespace is provided, the instance is mapped to all namespaces in the cluster.
174+
175+
6. Choose **Review and Save**. In the popup, choose **Save Changes**.
176+
177+
<!-- border; size:540px --> ![Save changes](./img/hana-save-mapping.png)
178+
179+
You've mapped your SAP HANA Cloud service instance to your Kyma cluster.
180+
181+
> For more information, see [Map an SAP HANA Database to another Environment Context](https://help.sap.com/docs/HANA_CLOUD/9ae9104a46f74a6583ce5182e7fb20cb/1683421d02474567a54a81615e8e2c48.html) to add a new Cloud foundry or Kyma mapping.
182+
391 KB
Loading
542 KB
Loading
484 KB
Loading
63.4 KB
Loading
202 KB
Loading
60.4 KB
Loading
125 KB
Loading
329 KB
Loading
210 KB
Loading

0 commit comments

Comments
 (0)