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: documentation/4.1/content/samples/domains/domain-home-on-pv/build-domain-creation-image.md
+20-20Lines changed: 20 additions & 20 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -13,20 +13,20 @@ description: "Create WebLogic images using the WebLogic Image Tool and WebLogic
13
13
14
14
The image build process uses the WebLogic Image Tool to create a Domain on PV `domain creation image`. This image contains:
15
15
- A WebLogic Deploy Tooling installation (expected in an image's `/auxiliary/weblogic-deploy` directory by default).
16
-
- WDT model YAML, WDT variables, and WDT archive ZIP files (expected in directory `/auxiliary/models` by default).
16
+
- WDT model YAML file (model), WDT variable (property), and WDT archive ZIP (archive) files (expected in directory `/auxiliary/models` by default).
17
17
18
18
### Build the domain creation image
19
19
20
20
Use the steps in the following sections to build the domain creation image.
21
21
22
-
#### Understand your first WDT archive ZIP file
22
+
#### Understand your first archive
23
23
24
-
The sample includes a predefined WDT archive directory in `/tmp/sample/wdt-artifacts/archives/archive-v1` that you will use to create an WDT archive ZIP file for the image.
24
+
The sample includes a predefined archive directory in `/tmp/sample/wdt-artifacts/archives/archive-v1` that you will use to create an archive ZIP file for the image.
25
25
26
-
The WDT archive ZIP top directory, named `wlsdeploy`, contains a directory named `applications`, which includes an 'exploded' sample JSP web application in the directory, `myapp-v1`. Three useful aspects to remember about WDT archive ZIP files are:
27
-
- A domain creation image can contain multiple WDT archive ZIP files.
28
-
- WDT archive ZIP files can contain multiple applications, libraries, and other components.
29
-
- WDT archive ZIP files have a [well defined directory structure](https://oracle.github.io/weblogic-deploy-tooling/concepts/archive/), which always has `wlsdeploy` as the top directory.
26
+
The archive top directory, named `wlsdeploy`, contains a directory named `applications`, which includes an 'exploded' sample JSP web application in the directory, `myapp-v1`. Three useful aspects to remember about WDT archives are:
27
+
- A domain creation image can contain multiple WDT archives.
28
+
- WDT archives can contain multiple applications, libraries, and other components.
29
+
- WDT archives have a [well defined directory structure](https://oracle.github.io/weblogic-deploy-tooling/concepts/archive/), which always has `wlsdeploy` as the top directory.
30
30
31
31
{{%expand "If you are interested in the web application source, click here to see the JSP code." %}}
32
32
@@ -126,11 +126,11 @@ The WDT archive ZIP top directory, named `wlsdeploy`, contains a directory named
126
126
127
127
The application displays important details about the WebLogic Server instance that it's running on: namely its domain name, cluster name, and server name, as well as the names of any data sources that are targeted to the server. Also, you can see that application output reports that it's at version `v1`; you will update this to `v2` in a later use case that demonstrates upgrading the application.
128
128
129
-
#### Stage a WDT archive ZIP file
129
+
#### Stage a ZIP file of the archive
130
130
131
131
When you create the image, you will use the files in the staging directory, `/tmp/sample/wdt-artifacts/wdt-model-files/WLS-v1`. In preparation, you need it to contain a WDT application archive (a ZIP) file.
132
132
133
-
Run the following commands to create your WDT application archive ZIP file and put it in the expected directory:
133
+
Run the following commands to create your application archive ZIP file and put it in the expected directory:
134
134
135
135
```
136
136
# Delete existing archive.zip in case we have an old leftover version
@@ -139,21 +139,21 @@ Run the following commands to create your WDT application archive ZIP file and p
# Move to the directory which contains the source files for our WDT application archive
142
+
# Move to the directory which contains the source files for our archive
143
143
```
144
144
```shell
145
145
$ cd /tmp/sample/wdt-artifacts/archives/archive-v1
146
146
```
147
147
148
-
Using the [WDT archive helper tool](https://oracle.github.io/weblogic-deploy-tooling/userguide/tools/archive_helper/), create the WDT archive in the location that we will use later when we run the WebLogic Image Tool.
148
+
Using the [WDT archive helper tool](https://oracle.github.io/weblogic-deploy-tooling/userguide/tools/archive_helper/), create the archive in the location that we will use later when we run the WebLogic Image Tool.
In this step, you explore the staged WDT model YAML file and WDT variables file in the `/tmp/sample/wdt-artifacts/wdt-model-files/WLS-v1` directory. The WDT model YAML file in this directory references the web application in your WDT archive ZIP file, configures a WebLogic Administration Server, and configures a WebLogic cluster. It consists of two files only, `model.10.properties`, a WDT variable file with a single property, and, `model.10.yaml`, a WDT model YAML file with your WebLogic configuration `model.10.yaml`.
156
+
In this step, you explore the staged WDT model YAML file and properties in the `/tmp/sample/wdt-artifacts/wdt-model-files/WLS-v1` directory. The model in this directory references the web application in your archive, configures a WebLogic Administration Server, and configures a WebLogic cluster. It consists of two files only, `model.10.properties`, a file with a single property, and, `model.10.yaml`, a model YAML file with your WebLogic configuration `model.10.yaml`.
157
157
158
158
```
159
159
CLUSTER_SIZE=5
@@ -270,7 +270,7 @@ resources:
270
270
{{% /expand %}}
271
271
272
272
273
-
The WDT model YAML files:
273
+
The model files:
274
274
275
275
- Define a WebLogic domain with:
276
276
- Cluster `cluster-1`
@@ -279,15 +279,15 @@ The WDT model YAML files:
279
279
- A Work Manager `SampleWM` configured with minimum threads constraint `SampleMinThreads` and maximum threads constraint `SampleMaxThreads`
280
280
281
281
- Use macros to inject external values:
282
-
- The WDT variables file `CLUSTER_SIZE` property is referenced in the WDT model YAML file `DynamicClusterSize` and `MaxDynamicClusterSize` fields using a PROP macro.
283
-
- The WDT model YAML file domain name is injected using a custom environment variable named `CUSTOM_DOMAIN_NAME` using an ENV macro.
282
+
- The property file `CLUSTER_SIZE` property is referenced in the model YAML file `DynamicClusterSize` and `MaxDynamicClusterSize` fields using a PROP macro.
283
+
- The model file domain name is injected using a custom environment variable named `CUSTOM_DOMAIN_NAME` using an ENV macro.
284
284
- You set this environment variable later in this sample using an `env` field in its Domain.
285
285
- _This conveniently provides a simple way to deploy multiple differently named domains using the same domain creation image._
286
-
- The WDT model YAML file administrator user name and password are set using a `weblogic-credentials` secret macro reference to the WebLogic credential secret.
286
+
- The model file administrator user name and password are set using a `weblogic-credentials` secret macro reference to the WebLogic credential secret.
287
287
- This secret is in turn referenced using the `webLogicCredentialsSecret` field in the Domain.
288
288
- The `weblogic-credentials` is a reserved name that always dereferences to the owning Domain actual WebLogic credentials secret name.
289
289
290
-
An image can contain multiple WDT variables files, WDT archive ZIP files, and WDT model YAML files but in this sample you use just one of each. For a complete description of WDT model YAML file naming conventions, file loading order, and macro syntax, see [Model files]({{< relref "/managing-domains/working-with-wdt-models/model-files.md" >}}) in the user documentation.
290
+
An image can contain multiple properties files, archive ZIP files, and model YAML files but in this sample you use just one of each. For a complete description of WDT model file naming conventions, file loading order, and macro syntax, see [Model files]({{< relref "/managing-domains/working-with-wdt-models/model-files.md" >}}) in the user documentation.
291
291
292
292
#### Create the image with WIT
293
293
@@ -322,7 +322,7 @@ This command runs the WebLogic Image Tool to create the image and does the follo
322
322
- Copies the WDT ZIP file that's referenced in the WIT cache into the image.
323
323
- Note that you cached WDT in WIT using the keyword `latest` when you set up the cache during the sample prerequisites steps.
324
324
- This lets WIT implicitly assume it's the desired WDT version and removes the need to pass a `-wdtVersion` flag.
325
-
- Copies the specified WDT model YAML, WDT variables, and WDT application archive ZIP files to image location `/auxiliary/models`.
325
+
- Copies the specified WDT model, properties, and application archives to image location `/auxiliary/models`.
326
326
327
327
When the command succeeds, it should end with output like the following:
328
328
```
@@ -332,7 +332,7 @@ When the command succeeds, it should end with output like the following:
332
332
Also, if you run the `docker images` command, then you will see an image named `wdt-domain-image:WLS-v1`.
333
333
334
334
After the image is created, it should have the WDT executables in
335
-
`/auxiliary/weblogic-deploy`, and WDT model YAML, WDT variables, and WDT archive ZIP
335
+
`/auxiliary/weblogic-deploy`, and WDT model, property, and archive
336
336
files in `/auxiliary/models`. You can run `ls` in the Docker
0 commit comments