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/site/content/samples/azure-kubernetes-service/domain-on-pv.md
+35-52Lines changed: 35 additions & 52 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -7,30 +7,13 @@ description: "Sample for creating a WebLogic domain home on an existing PV or PV
7
7
8
8
This sample demonstrates how to use the [WebLogic Kubernetes Operator](https://oracle.github.io/weblogic-kubernetes-operator) (hereafter "the operator") to set up a WebLogic Server (WLS) cluster on the Azure Kubernetes Service (AKS) using the domain on PV approach. After going through the steps, your WLS domain runs on an AKS cluster and you can manage your WLS domain by accessing the WebLogic Server Administration Console.
9
9
10
-
#### Contents
11
-
12
-
-[Prerequisites](#prerequisites)
13
-
-[Create Resource Group](#create-resource-group)
14
-
-[Create an AKS cluster](#create-the-aks-cluster)
15
-
-[Create and configure storage](#create-storage)
16
-
-[Create an Azure Storage account and NFS share](#create-an-azure-storage-account-and-nfs-share)
17
-
-[Create SC and PVC](#create-sc-and-pvc)
18
-
-[Create a domain creation image](#create-a-domain-creation-image)
{{% notice info %}} The following sections of the sample instructions will guide you, step-by-step, through the process of setting up a WebLogic cluster on AKS - remaining as close as possible to a native Kubernetes experience. This lets you understand and customize each step. If you wish to have a more automated experience that abstracts some lower level details, you can skip to the [Automation](#automation) section.
**NOTE**: If you run into VM size failure, see [Troubleshooting - Virtual Machine size is not supported]({{< relref "/samples/azure-kubernetes-service/troubleshooting#virtual-machine-size-is-not-supported" >}}).
This sample requires [Domain creation images]({{< relref "/managing-domains/domain-on-pv/domain-creation-images" >}}). For more information, see [Domain on Persistent Volume]({{< relref "/managing-domains/domain-on-pv/overview" >}}).
-[Understanding your first archive](#understanding-your-first-archive)
84
-
-[Staging a ZIP file of the archive](#staging-a-zip-file-of-the-archive)
85
-
-[Staging model files](#staging-model-files)
86
-
-[Creating the image with WIT](#creating-the-image-with-wit)
87
-
-[Pushing the image to Azure Container Registry](#pushing-the-image-to-azure-container-registry)
88
-
89
-
##### Image creation prerequisites
76
+
#### Image creation prerequisites
90
77
91
78
- The `JAVA_HOME` environment variable must be set and must reference a valid JDK 8 or 11 installation.
92
79
- Copy the sample to a new directory; for example, use the directory `/tmp/dpv-sample`. In the directory name, `dpv` is short for "domain on pv". Domain on PV is one of three domain home source types supported by the operator. To learn more, see [Choose a domain home source type]({{< relref "/managing-domains/choosing-a-model/_index.md" >}}).
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/domain-on-pv/model-files" >}}) in the user documentation.
@@ -154,7 +141,7 @@ The `imagetool.sh` is not supported on macOS with Apple Silicon. See [Troublesho
154
141
You may run into a `Dockerfile` parsing error if your Docker buildkit is enabled, see [Troubleshooting - WebLogic Image Tool failure]({{< relref "/samples/azure-kubernetes-service/troubleshooting#weblogic-image-tool-failure" >}}).
155
142
{{% /notice %}}
156
143
157
-
#####Pushing the image to Azure Container Registry
144
+
#### Pushing the image to Azure Container Registry
If you see an error that seems related to you not being an **Owner on this subscription**, please refer to the troubleshooting section [Cannot attach ACR due to not being Owner of subscription]({{< relref "/samples/azure-kubernetes-service/troubleshooting#cannot-attach-acr-due-to-not-being-owner-of-subscription" >}}).
171
158
172
-
####Install WebLogic Kubernetes Operator into the AKS cluster
159
+
### Install WebLogic Kubernetes Operator into the AKS cluster
173
160
174
161
The WebLogic Kubernetes Operator is an adapter to integrate WebLogic Server and Kubernetes, allowing Kubernetes to serve as a container infrastructure hosting WLS instances. The operator runs as a Kubernetes Pod and stands ready to perform actions related to running WLS on Kubernetes.
Now that you have created the AKS cluster, installed the operator, and verified that the operator is ready to go, you can ask the operator to create a WLS domain.
217
200
218
-
#####Create secrets
201
+
#### Create secrets
219
202
220
203
You will use the `$BASE_DIR/sample-scripts/create-weblogic-domain-credentials/create-weblogic-credentials.sh` script to create the domain WebLogic administrator credentials as a Kubernetes secret. Please run the following commands:
**NOTE**: If the `NAME` column in your output is missing any of the values shown above, please review your execution of the preceding steps in this sample to ensure that you correctly followed all of them.
269
252
270
-
#####Enable Weblogic Operator
253
+
#### Enable Weblogic Operator
271
254
272
255
Run the following command to enable the operator to monitor the namespace.
Now, you deploy a `sample-domain1` domain resource and an associated `sample-domain1-cluster-1` cluster resource using a single YAML resource file which defines both resources. The domain resource and cluster resource tells the operator how to deploy a WebLogic domain. They do not replace the traditional WebLogic configuration files, but instead cooperate with those files to describe the Kubernetes artifacts of the corresponding domain.
280
263
281
264
- Run the following commands to generate resource files.
@@ -391,7 +374,7 @@ The domain resource references the cluster resource, a WebLogic Server installat
391
374
392
375
To access the sample application on WLS, skip to the section [Access sample application](#access-sample-application). The next section includes a script that automates all of the preceding steps.
393
376
394
-
####Automation
377
+
### Automation
395
378
396
379
If you want to automate the above steps of creating the AKS cluster and WLS domain, you can use the script `${BASE_DIR}/sample-scripts/create-weblogic-domain-on-azure-kubernetes-service/create-domain-on-aks.sh`.
397
380
@@ -418,7 +401,7 @@ To interact with the cluster using `kubectl`, use `az aks get-credentials` as sh
418
401
{{% notice info %}} You now have created an AKS cluster with Azure Files NFS share to contain the WLS domain configuration files. Using those artifacts, you have used the operator to create a WLS domain.
419
402
{{% /notice %}}
420
403
421
-
####Access sample application
404
+
### Access sample application
422
405
423
406
Access the Administration Console using the admin load balancer IP address.
424
407
@@ -463,7 +446,7 @@ Found 0 local data sources:
463
446
</pre></body></html>
464
447
```
465
448
466
-
####Validate NFS volume
449
+
### Validate NFS volume
467
450
468
451
There are several approaches to validate the NFS volume:
Copy file name to clipboardExpand all lines: documentation/site/content/samples/azure-kubernetes-service/includes/create-aks-cluster-body-01.txt
-2Lines changed: 0 additions & 2 deletions
Original file line number
Diff line number
Diff line change
@@ -1,5 +1,3 @@
1
-
##### Oracle Container Registry
2
-
3
1
The following steps will direct you to accept the license agreement for WebLogic Server. Make note of your Oracle Account password and email. This sample pertains to 12.2.1.4, but other versions may work as well.
4
2
5
3
- In a web browser, navigate to https://container-registry.oracle.com and log in using the Oracle Single Sign-On authentication service. If you do not already have SSO credentials, at the top of the page, click the **Sign In** link to create them.
Copy file name to clipboardExpand all lines: documentation/site/content/samples/azure-kubernetes-service/includes/create-aks-cluster-body-02.txt
-3Lines changed: 0 additions & 3 deletions
Original file line number
Diff line number
Diff line change
@@ -1,6 +1,3 @@
1
-
2
-
#### Create the AKS cluster
3
-
4
1
This sample doesn't enable application routing. If you want to enable application routing, follow [Managed nginx Ingress with the application routing add-on in AKS](https://learn.microsoft.com/azure/aks/app-routing?tabs=default%2Cdeploy-app-default).
5
2
6
3
Run the following command to create the AKS cluster.
Copy file name to clipboardExpand all lines: documentation/site/content/samples/azure-kubernetes-service/includes/create-aks-cluster-storage.txt
+3-5Lines changed: 3 additions & 5 deletions
Original file line number
Diff line number
Diff line change
@@ -1,12 +1,10 @@
1
-
#### Create storage
2
-
3
1
Our usage pattern for the operator involves creating Kubernetes "persistent volumes" to allow the WebLogic Server to persist its configuration and data separately from the Kubernetes Pods that run WebLogic Server workloads.
4
2
5
3
You will create an external data volume to access and persist data. There are several options for data sharing as described in [Storage options for applications in Azure Kubernetes Service (AKS)](https://docs.microsoft.com/azure/aks/concepts-storage).
6
4
7
5
You will dynamically create and use a persistent volume with Azure Files NFS share. For details about this full featured cloud storage solution, see the [Azure Files Documentation](https://docs.microsoft.com/azure/aks/azure-files-dynamic-pv).
8
6
9
-
##### Create an Azure Storage account and NFS share
7
+
#### Create an Azure Storage account and NFS share
10
8
11
9
1. Create an Azure Storage Account.
12
10
@@ -185,9 +183,9 @@ You will dynamically create and use a persistent volume with Azure Files NFS sha
185
183
]
186
184
```
187
185
188
-
##### Create SC and PVC
186
+
#### Create SC and PVC
189
187
190
-
##### Generated configuration files
188
+
#### Generated configuration files
191
189
Use the following command to generate configuration files.
Copy file name to clipboardExpand all lines: documentation/site/content/samples/azure-kubernetes-service/includes/download-samples-zip.txt
-2Lines changed: 0 additions & 2 deletions
Original file line number
Diff line number
Diff line change
@@ -1,5 +1,3 @@
1
-
##### Download the WebLogic Kubernetes Operator sample.
2
-
3
1
Download the WebLogic Kubernetes Operator sample ZIP file. We will use several scripts in this zip file to create a WebLogic domain. This sample was tested with v4.2.8, but should work with the latest release.
Copy file name to clipboardExpand all lines: documentation/site/content/samples/azure-kubernetes-service/includes/prerequisites-01.txt
-2Lines changed: 0 additions & 2 deletions
Original file line number
Diff line number
Diff line change
@@ -1,5 +1,3 @@
1
-
#### Prerequisites
2
-
3
1
This sample assumes the following prerequisite environment.
4
2
5
3
* If you don't have an [Azure subscription](https://learn.microsoft.com/en-us/azure/guides/developer/azure-developer-guide#understanding-accounts-subscriptions-and-billing), create a [free account](https://azure.microsoft.com/free/?ref=microsoft.com&utm_source=microsoft.com&utm_medium=docs&utm_campaign=visualstudio) before you begin.
Copy file name to clipboardExpand all lines: documentation/site/content/samples/azure-kubernetes-service/includes/prerequisites-02.txt
-2Lines changed: 0 additions & 2 deletions
Original file line number
Diff line number
Diff line change
@@ -1,5 +1,3 @@
1
-
#### Prerequisites
2
-
3
1
This sample assumes the following prerequisite environment.
4
2
5
3
* If you don't have an [Azure subscription](https://learn.microsoft.com/en-us/azure/guides/developer/azure-developer-guide#understanding-accounts-subscriptions-and-billing), create a [free account](https://azure.microsoft.com/free/?ref=microsoft.com&utm_source=microsoft.com&utm_medium=docs&utm_campaign=visualstudio) before you begin.
0 commit comments