documentation for --target (#318)

* [skip-ci] documentation for --target

* [skip-ci] code font for target table values

Author: ddsharpe

documentation/1.9/content/userguide/tools/create-image.md

@@ -41,6 +41,7 @@ Usage: imagetool create [OPTIONS]
 | `--resourceTemplates` | One or more files containing placeholders that need to be resolved by the Image Tool. See [Resource Template Files](#resource-template-files). |   |
 | `--strictPatchOrdering` |  Instruct OPatch to apply patches one at a time (uses `apply` instead of `napply`). |   |
 | `--tag` | (Required) Tag for the final build image. Example: `store/oracle/weblogic:12.2.1.3.0`  |   |
+| `--target` | Select the target environment in which the created image will be used. Supported values: `Default` (Docker/Kubernetes), `OpenShift` | `Default`  |
 | `--type` | Installer type. Supported values: `WLS`, `WLSDEV`, `WLSSLIM`, `FMW`, `IDM`, `OSB`, `OUD_WLS`, `SOA_OSB`, `SOA_OSB_B2B`, `MFT`, `WCP`, `OAM`, `OIG`, `OUD`, `OID`, `SOA`, `WCC`, `WCS`, `WCP`  | `WLS`  |
 | `--user` | Oracle support email ID.  |   |
 | `--version` | Installer version. | `12.2.1.3.0`  |
@@ -109,6 +110,18 @@ installation or domain creation steps, use the `final-build-commands` section so
 final stage of the image build.  Or, if the file needs to change the Oracle Home prior to domain creation, use
 the `after-fmw-install` or `before-wdt-command` sections.
 
+#### `--target`
+
+By default, the generated WLS domain in your image will use the best practices defined by Oracle WebLogic Server.  
+The `target` option allows you to toggle the defaults so that the generated domain is easier to use in the target
+environment.  For example, the `--target OpenShift` option will change the file permissions in the domain directory
+so that the group permissions match the user permissions.
+
+| Target | Default File Permissions | Default File Ownership |
+| --- | --- | --- |
+| `Default` | `rwxr-x---` | `oracle:oracle` |
+| `OpenShift` | `rwxrwx---` | `oracle:root` |
+
 #### Resource Template Files
 
 If provided, the file or files provided with `--resourceTemplates` will be overwritten. For known tokens,

documentation/1.9/content/userguide/tools/rebase-image.md

@@ -43,6 +43,7 @@ Usage: imagetool rebase [OPTIONS]
 | `--sourceImage` | (Required) Source Image containing the WebLogic domain. |   |
 | `--strictPatchOrdering` |  Instruct OPatch to apply patches one at a time (uses `apply` instead of `napply`). |   |
 | `--tag` | (Required) Tag for the final build image. Example: `store/oracle/weblogic:12.2.1.3.0`  |   |
+| `--target` | Select the target environment in which the created image will be used. Supported values: `Default` (Docker/Kubernetes), `OpenShift` | `Default`  |
 | `--targetImage` | Docker image to extend for the domain's new image. |   |
 | `--type` | Installer type. Supported values: `WLS`, `WLSDEV`, `WLSSLIM`, `FMW`, `IDM`, `OSB`, `OUD_WLS`, `SOA_OSB`, `SOA_OSB_B2B`, `MFT`, `WCP`, `OAM`, `OIG`, `OUD`, `OID`, `SOA`, `WCC`, `WCS`, `WCP`  | `WLS`  |
 | `--user` | Your Oracle support email ID.  |   |
@@ -94,6 +95,18 @@ installation or domain creation steps, use the `final-build-commands` section so
 final stage of the image build.  Or, if the file needs to change the Oracle Home prior to domain creation, use
 the `after-fmw-install` or `before-wdt-command` sections.
 
+#### `--target`
+
+By default, the generated WLS domain in your image will use the best practices defined by Oracle WebLogic Server.  
+The `target` option allows you to toggle the defaults so that the generated domain is easier to use in the target
+environment.  For example, the `--target OpenShift` option will change the file permissions in the domain directory
+so that the group permissions match the user permissions.
+
+| Target | Default File Permissions | Default File Ownership |
+| --- | --- | --- |
+| `Default` | `rwxr-x---` | `oracle:oracle` |
+| `OpenShift` | `rwxrwx---` | `oracle:root` |
+
 #### Use an argument file
 
 You can save all arguments passed for the Image Tool in a file, then use the file as a parameter.

documentation/1.9/content/userguide/tools/update-image.md

@@ -49,6 +49,7 @@ Update WebLogic Docker image with selected patches
 | `--resourceTemplates` | One or more files containing placeholders that need to be resolved by the Image Tool. See [Resource Template Files](#resource-template-files). |   |
 | `--strictPatchOrdering` |  Instruct OPatch to apply patches one at a time (uses `apply` instead of `napply`). |   |
 | `--tag` | (Required) Tag for the final build image. Example: `store/oracle/weblogic:12.2.1.3.0`  |   |
+| `--target` | Select the target environment in which the created image will be used. Supported values: `Default` (Docker/Kubernetes), `OpenShift` | `Default`  |
 | `--user` | Oracle support email ID.  |   |
 | `--wdtArchive` | Path to the WDT archive file used by the WDT model.  |   |
 | `--wdtDomainHome` | Path to the `-domain_home` for WDT.  | `/u01/domains/base_domain`  |
@@ -117,6 +118,18 @@ The `latestPSU` option will continue to be supported for the CREATE option, but
 UPDATE option.  Because of the number of patches and their size, using `latestPSU` as an update to an existing image can
 increase the size of the image significantly, and is not recommended.
 
+#### `--target`
+
+By default, the generated WLS domain in your image will use the best practices defined by Oracle WebLogic Server.  
+The `target` option allows you to toggle the defaults so that the generated domain is easier to use in the target
+environment.  For example, the `--target OpenShift` option will change the file permissions in the domain directory
+so that the group permissions match the user permissions.
+
+| Target | Default File Permissions | Default File Ownership |
+| --- | --- | --- |
+| `Default` | `rwxr-x---` | `oracle:oracle` |
+| `OpenShift` | `rwxrwx---` | `oracle:root` |
+
 #### Resource Template Files
 
 If provided, the file or files provided with `--resourceTemplates` will be overwritten. For known tokens,