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: tutorials/create-hello-world-mta/create-hello-world-mta.md
+19-26Lines changed: 19 additions & 26 deletions
Original file line number
Diff line number
Diff line change
@@ -1,34 +1,34 @@
1
1
---
2
-
title: Create a Hello World Multitarget Application
3
-
description: This tutorial will help you create a module that describes a Java application, a resource that describes your database binding and additional metadata required for the deployment.
<!-- description --> This tutorial will help you create a module that describes a Java application, a resource that describes your database binding and additional metadata required for the deployment.
11
+
10
12
## Prerequisites
11
13
- You have created a Java application `.war file.`
12
14
- You have an SAP BTP database configured in your subaccount and valid credentials.
13
15
14
-
## Details
15
-
### You will learn
16
+
## You will learn
16
17
- How to create a module that describes a Java application
17
18
- How to create a resource that describes your database binding
18
19
- How to create additional metadata required for the deployment
19
20
20
21
21
22
---
22
23
23
-
[ACCORDION-BEGIN [Step 1: ](Modeling the MTA deployment descriptor)]
24
+
### Modeling the MTA deployment descriptor
25
+
24
26
25
27
You define the entities that have to be deployed, namely modules and resources related to other modules, in the MTA deployment descriptor. This is a YAML file that defines the contract between you as a deployable artifact provider and the SAP BTP as a deployer tool. Initially, you have to describe the metadata required for the deployment.
26
28
27
29
1. Create an empty text file and name it `mtad.yaml.`
28
30
2. Using a text editor, enter the following data in the file:
29
-
>
30
-
> #### Note
31
-
>
31
+
32
32
>Strictly adhere to the correct indentations when working with YAML files, and do not use the tabulator character.
33
33
34
34
``` YAML
@@ -86,14 +86,12 @@ You define the entities that have to be deployed, namely modules and resources r
86
86
87
87
The information about your database ID and credentials are, however, subaccount-specific. To keep the `mtad.yaml` target platform independent, you have to create an MTA extension descriptor. This file is used in addition to your primary descriptor file, and contains data that is account-specific.
88
88
89
-
> #### Note
90
-
>
91
-
>Security-sensitive data, for example database credentials, should be always deployed using an MTA extension descriptor, so that this data is encrypted.
89
+
>Security-sensitive data, for example database credentials, should be always deployed using an MTA extension descriptor, so that this data is encrypted.
90
+
91
+
92
92
93
-
[VALIDATE_1]
94
-
[ACCORDION-END]
93
+
### Create the MTA extension descriptor
95
94
96
-
[ACCORDION-BEGIN [Step 2: ](Create the MTA extension descriptor)]
97
95
98
96
1. Create an empty text file and name it `dev.mtaext.`
99
97
@@ -128,11 +126,11 @@ The example above instructs the SAP BTP to:
128
126
129
127
The MTA archive contains all entities that have to be deployed. It also contains a manifest file, which links the modules and resources described into the MTA deployment descriptor file using their location in the archive. Using this data, the SAP BTP deploys the Multitarget Application archive as a solution.
130
128
131
-
[VALIDATE_2]
132
-
[ACCORDION-END]
133
129
134
130
135
-
[ACCORDION-BEGIN [Step 3: ](Packaging your Multitarget Application)]
131
+
132
+
### Packaging your Multitarget Application
133
+
136
134
137
135
1. Create an empty text file and name it `MANIFEST.MF`. Explicitly use upper-case letters.
138
136
@@ -153,20 +151,17 @@ The example above instructs the SAP BTP to:
153
151
>
154
152
>Make sure that the `MANIFEST.MF` is compliant to the JAR file specification.
155
153
156
-
[DONE]
157
-
[ACCORDION-END]
158
154
159
-
[ACCORDION-BEGIN [Step 4: ](Create your Multitarget Application archive)]
155
+
### Create your Multitarget Application archive
156
+
160
157
161
158
MTA archives are compliant to the JAR file specification. This allows you to use commonly available tools for creating, modifying, and signing such archives. For the sake of the tutorial, we assume that you have a root directory named ***/*** where you place all the parts of the Multitarget Application before creating the archive.
162
159
163
160
1. Create a folder called `META-INF` in the root directory.
164
161
2. Place the `mtad.yaml` and the `MANIFEST.MF` files inside the `META-INF` directory.
165
162
3. Place the `example.war` archive inside the root directory.
166
-
>
167
-
> #### Note
168
-
>
169
-
>The MTA extension descriptor file is deployed separately from the MTA archive.
163
+
164
+
>The MTA extension descriptor file is deployed separately from the MTA archive.
170
165
171
166
The root directory should now be structured as follows:
172
167
@@ -181,8 +176,6 @@ MTA archives are compliant to the JAR file specification. This allows you to use
181
176
182
177
After you have created your Multitarget Application archive, you are ready to deploy it into the SAP BTP as a solution. To deploy the archive, proceed as described in [Deploy a Standard Solution](https://help.sap.com/docs/BTP/ea72206b834e4ace9cd834feed6c0e09/fea07defe09f44c09e03269705550335.html).
0 commit comments