wip

Author: markxnelson

kubernetes/samples/scripts/create-weblogic-domain/manually-create-domain/README.md

@@ -0,0 +1,31 @@
+# Manually creating the domain
+
+In some circumstances you may wish to manually create your domain custom resource.  If you have created your own
+Docker image containing your domain and the specific patches that you require, then this approach will probably
+be most suitable for your needs.
+
+To create the domain custom resource, just make a copy of the sample [domain.yaml](./domain.yaml) provided in
+this sample, and then edit it as per the instructions below.  When it is ready, you can create the domain in your
+Kubernetes cluster using the command:
+
+```
+kubectl apply -f domain.yaml
+```
+
+You can verify the domain custom resource was created using this command:
+
+```
+kubectl -n YOUR_NAMESPACE get domains
+```
+
+You can view details of the domain using this command:
+
+```
+kubectl -n YOUR_NAMESPACE describe domain YOUR_DOMAIN
+```
+
+In both of these commands, replace `YOUR_NAMESPACE` with the namespace that you created the domain in, and
+replace `YOUR_DOMAIN` with the `domainUID` you chose.
+
+## Details of the domain custom resource YAML file
+

kubernetes/samples/scripts/create-weblogic-domain/manually-create-domain/domain.yaml

@@ -0,0 +1,80 @@
+# Copyright 2017, 2019, Oracle Corporation and/or its affiliates. All rights reserved.
+
+# Licensed under the Universal Permissive License v 1.0 as shown at http://oss.oracle.com/licenses/upl.
+#
+# This is an example of how to define a Domain resource.
+#
+apiVersion: "weblogic.oracle/v2"
+kind: Domain
+metadata:
+  name: domain1
+  namespace: weblogic
+  labels:
+    weblogic.resourceVersion: domain-v2
+    weblogic.domainUID: domain1
+spec:
+  # The WebLogic Domain Home
+  domainHome: /u01/oracle/user_projects/domains/domain1
+  # If the domain home is in the image
+  domainHomeInImage: true
+  # The Docker image name
+  image: "my-domain1-image:1.0"
+  # imagePullPolicy defaults to "Always" if image version is :latest
+  imagePullPolicy: "IfNotPresent"
+  # Identify which Secret contains the credentials for pulling an image
+  #imagePullSecrets:
+  #- name:
+  # Identify which Secret contains the WebLogic Admin credentials (note that there is an example of
+  # how to create that Secret at the end of this file)
+  webLogicCredentialsSecret:
+    name: domain1-weblogic-credentials
+  # Whether to include the server out file into the pod's stdout, default is true
+  includeServerOutInPodLog: true
+  # Whether to enable log home
+  # logHomeEnabled: false
+  # The in-pod name of the directory to store the domain, node manager, server logs, and server .out
+  # files in.
+  # If not specified or empty, domain log file, server logs, server out, and node manager log files
+  # will be stored in the default logHome location of /shared/logs/<domainUID>/.
+  # logHome: /shared/logs/domain1
+  # serverStartPolicy legal values are "NEVER", "IF_NEEDED", or "ADMIN_ONLY"
+  # This determines which WebLogic Servers the Operator will start up when it discovers this Domain
+  # - "NEVER" will not start any server in the domain
+  # - "ADMIN_ONLY" will start up only the administration server (no managed servers will be started)
+  # - "IF_NEEDED" will start all non-clustered servers, including the administration server and clustered servers up to the replica count
+  serverStartPolicy: "IF_NEEDED"
+  serverPod:
+    # an (optional) list of environment variable to be set on the servers
+    env:
+    - name: JAVA_OPTIONS
+      value: "-Dweblogic.StdoutDebugEnabled=false"
+    - name: USER_MEM_ARGS
+      value: "-Xms64m -Xmx256m "
+    # volumes:
+    # - name: weblogic-domain-storage-volume
+    #   persistentVolumeClaim:
+    #     claimName: domain1-weblogic-sample-pvc
+    # volumeMounts:
+    # - mountPath: /shared
+    #   name: weblogic-domain-storage-volume
+  # adminServer is used to configure the desired behavior for starting the administration server.
+  adminServer:
+    # serverStartState legal values are "RUNNING" or "ADMIN"
+    # "RUNNING" means the listed server will be started up to "RUNNING" mode
+    # "ADMIN" means the listed server will be start up to "ADMIN" mode
+    serverStartState: "RUNNING"
+    adminService:
+      channels:
+    # The Admin Server's NodePort
+       - channelName: default
+         nodePort: 30701
+    # Uncomment to export the T3Channel as a service
+       - channelName: T3Channel
+  # clusters is used to configure the desired behavior for starting member servers of a cluster.
+  # If you use this entry, then the rules will be applied to ALL servers that are members of the named clusters.
+  clusters:
+  - clusterName: cluster-1
+    serverStartState: "RUNNING"
+    replicas: 2
+  # The number of managed servers to start for unlisted clusters
+  # replicas: 1

site/domains.md

@@ -100,7 +100,13 @@ Please consult My Oracle Support Doc ID 2349228.1 for up-to-date information abo
 
 ### Creating and managing WebLogic domains
 
-In this version of the operator, a WebLogic domain can be located either in a persistent volume (PV) or in a Docker image. For examples of each, see the [WebLogic operator samples](../kubernetes/samples/README.md).
+In this version of the operator, a WebLogic domain can be located either in a persistent volume (PV) or in a Docker image.
+For examples of each, see the [WebLogic operator samples](../kubernetes/samples/README.md).
+
+If you wish to create your own Docker images, for example to choose a specific set of patches, or to create a domain
+with a specific configuration and/or applications deployed, then you can create the domain custom resource
+manually to deploy your domain.  This process is documented in [this
+sample](../kubernetes/samples/scripts/create-weblogic-domain/manually-create-domain/README.md).
 
 ### Modifying domain configurations