Edburns msft em 4986 apply reza feedback

Author: jshum2479

documentation/site/content/samples/azure-kubernetes-service/domain-on-pv.md

@@ -88,24 +88,9 @@ export ACR_ACCOUNT_NAME="${NAME_PREFIX}acr${TIMESTAMP}"
 
 ```
 
-#### Clone WKO repository
-
-If you have not already done so, clone the [WebLogic Kubernetes Operator repository](https://github.com/oracle/weblogic-kubernetes-operator) to your machine. You will use several scripts in this repository to create a WebLogic domain. This sample was tested with v4.1.1, but should work later releases.
-
-```shell
-$ cd $BASE_DIR
-$ git clone https://github.com/oracle/weblogic-kubernetes-operator.git
-
-```
-
-#### Create Resource Group
-
-```shell
-$ cd $BASE_DIR/weblogic-kubernetes-operator
-$ az extension add --name resource-graph
-$ az group create --name $AKS_PERS_RESOURCE_GROUP --location $AKS_PERS_LOCATION
-```
+{{< readfile file="/samples/azure-kubernetes-service/includes/download-samples-zip.txt" >}}
 
+{{< readfile file="/samples/azure-kubernetes-service/includes/create-resource-group.txt" >}}
 
 {{< readfile file="/samples/azure-kubernetes-service/includes/create-aks-cluster-body-02.txt" >}}
 
@@ -175,6 +160,7 @@ Kubernetes Operators use [Helm](https://helm.sh/) to manage Kubernetes applicati
 
 ```shell
 $ helm repo add weblogic-operator https://oracle.github.io/weblogic-kubernetes-operator/charts --force-update
+$ helm repo update
 $ helm install weblogic-operator weblogic-operator/weblogic-operator
 ```
 
@@ -214,10 +200,10 @@ Now that you have created the AKS cluster, installed the operator, and verified
 
 ##### Create secrets
 
-You will use the `kubernetes/samples/scripts/create-weblogic-domain-credentials/create-weblogic-credentials.sh` script to create the domain WebLogic administrator credentials as a Kubernetes secret. Please run:
+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:
 
 ```
-cd $BASE_DIR/weblogic-kubernetes-operator/kubernetes/samples/scripts/create-weblogic-domain-credentials
+cd $BASE_DIR/sample-scripts/create-weblogic-domain-credentials
 ```
 ```shell
 $ ./create-weblogic-credentials.sh -u ${WEBLOGIC_USERNAME} -p ${WEBLOGIC_PASSWORD} -d domain1
@@ -232,7 +218,7 @@ The secret domain1-weblogic-credentials has been successfully created in the def
 You will use the `kubernetes/samples/scripts/create-kubernetes-secrets/create-docker-credentials-secret.sh` script to create the Docker credentials as a Kubernetes secret. Please run:
 
 ``` shell
-$ cd $BASE_DIR/weblogic-kubernetes-operator/kubernetes/samples/scripts/create-kubernetes-secrets
+$ cd $BASE_DIR/sample-scripts/create-kubernetes-secrets
 $ ./create-docker-credentials-secret.sh -s ${SECRET_NAME_DOCKER} -e ${ORACLE_SSO_EMAIL} -p ${ORACLE_SSO_PASSWORD} -u ${ORACLE_SSO_EMAIL}
 ```
 ```
@@ -270,7 +256,7 @@ Now, you deploy a `sample-domain1` domain resource and an associated `sample-dom
 - Run the following command to generate resource files.
 
     ```shell
-    cd $BASE_DIR/weblogic-kubernetes-operator/kubernetes/samples/scripts/create-weblogic-domain-on-azure-kubernetes-service  
+    cd $BASE_DIR/sample-scripts/create-weblogic-domain-on-azure-kubernetes-service  
 
     bash create-domain-on-aks-generate-yaml.sh
     ```
@@ -406,9 +392,11 @@ Now that you have WLS running in AKS, you can test the cluster by deploying the
 
 First, package the application with the following command:
 
-```bash
-cd $BASE_DIR/weblogic-kubernetes-operator/integration-tests/src/test/resources/bash-scripts
-bash build-war-app.sh -s ../apps/testwebapp/ -d /tmp/testwebapp
+```shell
+$ curl -m 120 -fL https://github.com/oracle/weblogic-kubernetes-operator/archive/refs/tags/v4.1.7.zip -o ${BASE_DIR}/v4.1.7.zip
+$ unzip v4.1.7.zip "weblogic-kubernetes-operator-4.1.7/integration-tests/src/test/resources/bash-scripts/build-war-app.sh" "weblogic-kubernetes-operator-4.1.7/integration-tests/src/test/resources/apps/testwebapp/*"
+$ cd $BASE_DIR/weblogic-kubernetes-operator-4.1.7/integration-tests/src/test/resources/bash-scripts
+$ bash build-war-app.sh -s ../apps/testwebapp/ -d /tmp/testwebapp
 ```
 
 Successful output will look similar to the following:

documentation/site/content/samples/azure-kubernetes-service/includes/create-aks-cluster-body-01.txt

@@ -13,6 +13,7 @@ You will need an Oracle account. The following steps will direct you to accept t
      in _Securing a Production Environment for Oracle WebLogic Server_.
   - Ensure that Docker is running.  Find and then pull the WebLogic 12.2.1.4 installation image:
      ```shell
+     $ docker login container-registry.oracle.com -u ${ORACLE_SSO_EMAIL} -p ${ORACLE_SSO_PASSWORD}
      $ docker pull container-registry.oracle.com/middleware/weblogic:12.2.1.4
      ```
 

documentation/site/content/samples/azure-kubernetes-service/includes/create-aks-cluster-body-02.txt

@@ -1,12 +1,11 @@
 
 #### Create the AKS cluster
 
-This sample requires that you disable the AKS addon `http_application_routing` by default.  If you want to enable  `http_application_routing`, then follow [HTTP application routing](https://docs.microsoft.com/azure/aks/http-application-routing).
+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).
 
 Run the following commands to create the AKS cluster instance.
 
 ```shell
-
 $ az aks create \
    --resource-group $AKS_PERS_RESOURCE_GROUP \
    --name $AKS_CLUSTER_NAME \
@@ -36,6 +35,11 @@ After your Kubernetes cluster is up and running, run the following commands to m
 
 ```shell
 $ kubectl get nodes -o wide
+```
+
+Successful output will look like the following.
+
+```shell
 NAME                                STATUS   ROLES   AGE    VERSION   INTERNAL-IP   EXTERNAL-IP   OS-IMAGE             KERNEL-VERSION      CONTAINER-RUNTIME
 aks-nodepool1-15679926-vmss000000   Ready    agent   118s   v1.25.6   10.224.0.4    <none>        Ubuntu 22.04.2 LTS   5.15.0-1041-azure   containerd://1.7.1+azure-1
 aks-nodepool1-15679926-vmss000001   Ready    agent   2m8s   v1.25.6   10.224.0.5    <none>        Ubuntu 22.04.2 LTS   5.15.0-1041-azure   containerd://1.7.1+azure-1

documentation/site/content/samples/azure-kubernetes-service/includes/create-resource-group.txt

@@ -0,0 +1,7 @@
+
+#### Create Resource Group
+
+```shell
+$ az extension add --name resource-graph
+$ az group create --name $AKS_PERS_RESOURCE_GROUP --location $AKS_PERS_LOCATION
+```

documentation/site/content/samples/azure-kubernetes-service/includes/download-samples-zip.txt

@@ -0,0 +1,11 @@
+##### Download the WebLogic Kubernetes Operator sample.
+
+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.1.7, but should work with the latest release.
+
+```shell
+$ cd $BASE_DIR
+$ mkdir sample-scripts
+$ curl -m 120 -fL https://github.com/oracle/weblogic-kubernetes-operator/releases/download/v4.1.7/sample-scripts.zip \
+      -o ${BASE_DIR}/sample-scripts/sample-scripts.zip
+$ unzip ${BASE_DIR}/sample-scripts/sample-scripts.zip -d ${BASE_DIR}/sample-scripts
+```

documentation/site/content/samples/azure-kubernetes-service/includes/prerequisites-02.txt

@@ -5,7 +5,7 @@ This sample assumes the following prerequisite environment.
 * 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.
   * It's recommended that the Azure identity you use to sign in and complete this article has either the [Owner](https://learn.microsoft.com/en-us/azure/role-based-access-control/built-in-roles#owner) role in the current subscription or the [Contributor](https://learn.microsoft.com/en-us/azure/role-based-access-control/built-in-roles#contributor) and [User Access Administrator](https://learn.microsoft.com/en-us/azure/role-based-access-control/built-in-roles#user-access-administrator) roles in the current subscription. 
   * If your identity has very limited role assignments, ensure you have [Contributor](https://learn.microsoft.com/en-us/azure/role-based-access-control/built-in-roles#contributor) role and [User Access Administrator](https://learn.microsoft.com/en-us/azure/role-based-access-control/built-in-roles#user-access-administrator) role in the resource group that runs the AKS cluster. This requires asking a privileged user to assign the roles before creating resources in the resource group.
-* Operating System: GNU/Linux, macOS or [WSL2 for Windows 10](https://docs.microsoft.com/windows/wsl/install-win10).
+* Operating System: GNU/Linux, macOS (Intel only, Apple Silicon not supported) [WSL2 for Windows 10](https://docs.microsoft.com/windows/wsl/install-win10). 
 * [Git](https://git-scm.com/downloads); use `git --version` to test if `git` works.  This document was tested with version 2.25.1.
 * [Azure CLI](https://docs.microsoft.com/cli/azure); use `az --version` to test if `az` works.  This document was tested with version 2.48.1.
 * [Docker for Desktop](https://www.docker.com/products/docker-desktop).  This document was tested with `Docker version 20.10.7`