Skip to content

Commit 081e299

Browse files
committed
Merge changes from pv-domain-simplify-doc-update-withsample-new branch.
1 parent 9fae507 commit 081e299

File tree

9 files changed

+0
-343
lines changed

9 files changed

+0
-343
lines changed

documentation/site/content/managing-domains/domain-on-pv/domain-creation-images.md

Lines changed: 0 additions & 52 deletions
Original file line numberDiff line numberDiff line change
@@ -3,30 +3,13 @@ title = "Domain creation images"
33
date = 2019-02-23T16:45:16-05:00
44
weight = 25
55
pre = "<b> </b>"
6-
<<<<<<< HEAD
7-
description = "Domain creation images are used to supply the WDT artifacts for Domain on PV."
8-
=======
96
description = "Domain creation images supply the WDT model for Domain on PV."
10-
>>>>>>> origin/pv-domain-simplify-doc-update-withsample-new
117
+++
128

139
{{< table_of_contents >}}
1410

1511
### Introduction
1612

17-
<<<<<<< HEAD
18-
Domain creation images are used for supplying model files, variable files,
19-
application archive files, and WebLogic Deploy Tooling (WDT) installation files when deploying a domain using
20-
a Domain on PV model. You will distribute model files, application archives, and the
21-
WebLogic Deploy Tooling executable using these images. Operator will use the WDT tool and artifacts to
22-
manage the domain.
23-
24-
**Note:** These images are _only_ used for creating the domain, and will not be used to update the domain.
25-
26-
### Configuration
27-
28-
You can configure one or more WDT artifacts images in a domain resource.
29-
=======
3013
Domain creation images are used for supplying WebLogic Deploy Tooling (WDT) model files, WDT variables files,
3114
WDT application archive files (collectively known as WDT model files), and WDT installation files when deploying a domain using
3215
a Domain on PV model. You distribute WDT model files and the
@@ -38,20 +21,14 @@ manage the domain.
3821
### Configuration
3922

4023
You can configure one or more domain creation images in a domain resource.
41-
>>>>>>> origin/pv-domain-simplify-doc-update-withsample-new
4224

4325
Optionally, you can set the `imagePullPolicy`,
4426
which defaults to `Always` if the `image` ends in `:latest` and `IfNotPresent`,
4527
otherwise.
4628
If image pull secrets are required for pulling the images, then the secrets must be referenced using `domain.spec.imagePullSecrets`.
4729

48-
<<<<<<< HEAD
49-
Also, optionally, you can configure the [source locations](#source-locations) of the WebLogic Deploy Tooling model
50-
and installation files in the image using the `sourceModelHome` and `sourceWDTInstallHome` fields, described in the following
51-
=======
5230
Also, optionally, you can configure the [source locations](#source-locations) of the WDT model
5331
and installation files in the image using the `sourceModelHome` and `sourceWDTInstallHome` fields, as described in this
54-
>>>>>>> origin/pv-domain-simplify-doc-update-withsample-new
5532
[section](#source-locations).
5633

5734
- For details about each field, see the [References](#references).
@@ -60,11 +37,7 @@ and installation files in the image using the `sourceModelHome` and `sourceWDTIn
6037

6138
### References
6239

63-
<<<<<<< HEAD
64-
- Run the ` kubectl explain domain.spec.configuration.initializeDomainOnPV.domain.domainCreationImages` command or
65-
=======
6640
- Run the ` kubectl explain domain.spec.configuration.initializeDomainOnPV.domain.domainCreationImages` command, or
67-
>>>>>>> origin/pv-domain-simplify-doc-update-withsample-new
6841

6942
- See the `initializeDomainOnPV.domain.domainCreationImages` section
7043
in the domain resource
@@ -73,23 +46,13 @@ and installation files in the image using the `sourceModelHome` and `sourceWDTIn
7346

7447
#### Source locations
7548

76-
<<<<<<< HEAD
77-
Use the optional attributes `sourceModelHome` and
78-
`sourceWdtInstallHome` to specify non-default locations of
79-
WebLogic Deploy Tooling model and installation files in your image(s).
80-
Allowed values for `sourceModelHome` and `sourceWdtInstallHome`:
81-
- Unset - Defaults to `/auxiliary/models` and `/auxiliary/weblogic-deploy`, respectively.
82-
- Set to a path - Must point to an existing location containing WDT model and installation files, respectively.
83-
- `None` - Indicates that the image has no WDT models or installation files, respectively.
84-
=======
8549
Use the optional attributes, `sourceModelHome` and
8650
`sourceWdtInstallHome`, to specify non-default locations for the
8751
WDT model and installation files in your domain creation image(s).
8852
Allowed values for `sourceModelHome` and `sourceWdtInstallHome`:
8953
- Unset - Defaults to `/auxiliary/models` and `/auxiliary/weblogic-deploy`, respectively.
9054
- Set to a path - Must point to an existing location containing WDT model and WDT installation files, respectively.
9155
- `None` - Indicates that the image has no WDT model files and installation files, respectively.
92-
>>>>>>> origin/pv-domain-simplify-doc-update-withsample-new
9356

9457
If you set the `sourceModelHome` or `sourceWDTInstallHome` to `None` or,
9558
the source attributes are left unset and there are no files at the default locations,
@@ -105,15 +68,8 @@ For example source locations, see [Configuration example 2](#example-2-source-lo
10568

10669
#### Multiple images
10770

108-
<<<<<<< HEAD
109-
If specifying multiple images with model files in their respective `sourceModelHome`
110-
directories, then model files are merged.
111-
The operator will merge the model files from multiple images in the same order in which images appear under `model.auxiliaryImages` or `domain.domainCreationImages`.
112-
Files from later images in the merge overwrite same-named files from earlier images.
113-
=======
11471
If specifying multiple images with WDT model files in their respective `sourceModelHome`
11572
directories, then WDT model files are merged. Files from later images take precedence over files from earlier images.
116-
>>>>>>> origin/pv-domain-simplify-doc-update-withsample-new
11773

11874
When specifying multiple images, ensure that only one of the images supplies a WDT installation location using
11975
`sourceWDTInstallHome`.
@@ -144,11 +100,7 @@ spec:
144100

145101
#### Example 2: Source locations
146102

147-
<<<<<<< HEAD
148-
This example is same as Example 1 except that it specifies the source locations for the WebLogic Deploy Tooling model and installation files.
149-
=======
150103
This example is the same as Example 1, except that it specifies the source locations for the WDT model and installation files.
151-
>>>>>>> origin/pv-domain-simplify-doc-update-withsample-new
152104

153105
```
154106
spec:
@@ -165,11 +117,7 @@ spec:
165117

166118
This example is the same as Example 1, except it configures multiple images and sets the `sourceWDTInstallHome`
167119
for the second image to `None`.
168-
<<<<<<< HEAD
169-
In this case, the source location of the WebLogic Deploy Tooling installation from the second image `wdt-model-image2:v1` will be ignored.
170-
=======
171120
In this case, the source location of the WDT installation from the second image `wdt-model-image2:v1` will be ignored.
172-
>>>>>>> origin/pv-domain-simplify-doc-update-withsample-new
173121

174122
```
175123
spec:

documentation/site/content/managing-domains/domain-on-pv/overview.md

Lines changed: 0 additions & 37 deletions
Original file line numberDiff line numberDiff line change
@@ -10,35 +10,21 @@ description = "Learn how to create a domain on a persistent volume."
1010

1111
### Overview
1212

13-
<<<<<<< HEAD
14-
Domain on persistent volume (Domain on PV) is one of the operator's [domain home source type]({{< relref "/managing-domains/choosing-a-model/_index.md" >}}) choices.
15-
Domain on PV requires that the domain home exists on a persistent volume. The domain home can be created either manually
16-
=======
1713
Domain on persistent volume (Domain on PV) is an operator [domain home source type]({{< relref "/managing-domains/choosing-a-model/_index.md" >}}),
1814
which requires that the domain home exists on a persistent volume. The domain home can be created either manually
19-
>>>>>>> origin/pv-domain-simplify-doc-update-withsample-new
2015
or automatically by specifying the section, `domain.spec.configuration.initializeDomainOnPV`, in the domain resource YAML file.
2116
The initial domain topology and resources are described using [WebLogic Deploy Tooling (WDT) models](#weblogic-deploy-tooling-models).
2217

2318
**NOTE**: The `initializeDomainOnPV` section provides a **one time only** domain home initialization.
2419
The operator creates the domain when the domain resource is first deployed. After the domain is created,
2520
this section is ignored. Subsequent domain life cycle updates must be controlled by
26-
<<<<<<< HEAD
27-
the WebLogic Server Administration Console, WebLogic Scripting Tool (WLST), or other mechanisms. See the [High level use case](#high-level-use-case).
28-
=======
2921
the WebLogic Server Administration Console, the WebLogic Remote Console, WebLogic Scripting Tool (WLST), or other mechanisms. See the [High level use case](#high-level-use-case).
30-
>>>>>>> origin/pv-domain-simplify-doc-update-withsample-new
3122

3223
The `initializeDomainOnPv` section:
3324

3425
- Creates the PersistentVolume (PV) and/or PersistenVolumeClaim (PVC), if needed.
35-
<<<<<<< HEAD
36-
- Creates the JRF schema, if needed.
37-
- Creates the WebLogic domain home, based on the provided WDT models on the persistent volume.
38-
=======
3926
- Creates the RCU schema, if needed.
4027
- Creates the WebLogic domain home on the persistent volume based on the provided WDT models.
41-
>>>>>>> origin/pv-domain-simplify-doc-update-withsample-new
4228

4329
### High level use case
4430

@@ -47,24 +33,15 @@ The typical Domain on PV use case is for an application life cycle that requires
4733
For example, you might use frameworks like Meta Data Service (MDS), Oracle Application Development Framework (ADF), or Oracle Service Bus (OSB).
4834
These frameworks require a running domain and the lifecycle operations are persisted to the file system. Typically,
4935
after the initial domain is created, you use tools like Fusion Middleware Control, product-specific WLST functions,
50-
<<<<<<< HEAD
51-
the WebLogic Server Administration Console, the Service Bus Console, or JDeveloper for lifecycle operations. The changes are managed by
52-
=======
5336
the WebLogic Server Administration Console, the WebLogic Remote Console, the Service Bus Console, or JDeveloper for lifecycle operations. The changes are managed by
54-
>>>>>>> origin/pv-domain-simplify-doc-update-withsample-new
5537
these tools; the data and operations _cannot_ be described using WDT models.
5638

5739
### WebLogic Deploy Tooling models
5840

5941
WDT models are a convenient and simple alternative to WLST
6042
configuration scripts and templates.
61-
<<<<<<< HEAD
62-
They compactly define a WebLogic domain using YAML files and support including
63-
application archives in a ZIP file. For more information about the model format
64-
=======
6543
They compactly define a WebLogic domain using model files, variable properties files, and application archive files.
6644
For more information about the model format
67-
>>>>>>> origin/pv-domain-simplify-doc-update-withsample-new
6845
and its integration,
6946
see [Usage]({{< relref "/managing-domains/domain-on-pv/usage.md" >}})
7047
and [Working with WDT Model files]({{< relref "/managing-domains/working-with-wdt-models/model-files.md" >}}).
@@ -76,32 +53,18 @@ The WDT model format is fully described in the open source,
7653
When you deploy a Domain on PV domain resource YAML file:
7754

7855
- The operator will run a Kubernetes Job, called an introspector job, that:
79-
<<<<<<< HEAD
80-
- Merges your WDT artifacts.
81-
- Runs WDT tooling to generate a domain home.
82-
83-
- After the introspector job completes:
84-
- The operator creates a ConfigMap named `DOMAIN_UID-weblogic-domain-introspect-cm`
85-
(possibly with some additional maps distinguished by serial names).
86-
=======
8756
- Merges your WDT model files.
8857
- Runs the WDT Create Domain Tool to create a domain home.
8958

9059
- After the introspector job completes:
9160
- The operator creates one or more ConfigMaps following the pattern `DOMAIN_UID-weblogic-domain-introspect-cm***`.
92-
>>>>>>> origin/pv-domain-simplify-doc-update-withsample-new
9361
- The operator subsequently boots your domain's WebLogic Server pods.
9462

9563
### Runtime updates
9664

9765
You control runtime updates to the WebLogic domain configuration using tools, such as Fusion Middleware Control, product-specific WLST functions,
98-
<<<<<<< HEAD
99-
the WebLogic Server Administration Console, the Service Bus Console, or JDeveloper. After the initial domain is created, subsequent updates to the
100-
source of the WDT artifacts or any referenced macros _will be ignored_.
101-
=======
10266
the WebLogic Server Administration Console, the WebLogic Remote Console, the Service Bus Console, or JDeveloper. After the initial domain is created, subsequent updates to the
10367
source of the WDT model files or any referenced macros _will be ignored_.
104-
>>>>>>> origin/pv-domain-simplify-doc-update-withsample-new
10568

10669
Some changes may require triggering an introspector job. For example:
10770

0 commit comments

Comments
 (0)