Merge pull request #284747 from majguo/not-recommend-azure-cloud-shell

prmerger-automator[bot] · web-flow · commit c720fe5fbd93 · 2024-08-16T22:36:22.000Z
Update guides by not recommending to use Azure Cloud Shell
diff --git a/articles/azure-functions/functions-create-first-quarkus.md b/articles/azure-functions/functions-create-first-quarkus.md
@@ -305,7 +305,7 @@ Now that you've opened your Azure function in the portal, here are more features
 
 ## Clean up resources
 
-If you don't need these resources, you can delete them by running the following command in Azure Cloud Shell or on your local terminal:
+If you don't need these resources, you can delete them by running the following command:
 
 ```azurecli
 az group delete --name <yourResourceGroupName> --yes
diff --git a/articles/openshift/howto-deploy-java-jboss-enterprise-application-platform-app.md b/articles/openshift/howto-deploy-java-jboss-enterprise-application-platform-app.md
@@ -25,14 +25,9 @@ If you're interested in providing feedback or working closely on your migration
 
 - A local developer command line with a UNIX-like command environment - for example, Ubuntu, macOS, or Windows Subsystem for Linux - and Azure CLI installed. To learn how to install the Azure CLI, see [How to install the Azure CLI](/cli/azure/install-azure-cli).
 
-  > [!NOTE]
-  > You can also execute this guidance from the [Azure Cloud Shell](../cloud-shell/get-started/classic.md). This approach has all the prerequisite tools pre-installed.
-  >
-  > :::image type="icon" source="~/reusable-content/ce-skilling/azure/media/cloud-shell/launch-cloud-shell-button.png" alt-text="Button to launch the Azure Cloud Shell." border="false" link="https://shell.azure.com":::
+- The `mysql` CLI. For example, you can install the CLI by using the following commands on Ubuntu or Debian-based systems:
 
-- The `mysql` CLI. You can install the CLI by using the following commands:
-
-  ```azurecli-interactive
+  ```bash
   sudo apt update
   sudo apt install mysql-server
   ```
@@ -146,7 +141,7 @@ The sample is a Java application backed by a MySQL database, and is deployed to
 
 Open a shell and set the following environment variables. Replace the substitutions as appropriate.
 
-```azurecli-interactive
+```bash
 RG_NAME=<resource-group-name>
 SERVER_NAME=<database-server-name>
 DB_DATABASE_NAME=testdb
@@ -179,7 +174,7 @@ Next, use the following steps to create an Azure Database for MySQL - Flexible S
 
 1. Use the following command to create an Azure Database for MySQL - Flexible Server:
 
-   ```azurecli-interactive
+   ```azurecli
    az mysql flexible-server create \
        --resource-group ${RG_NAME} \
        --name ${SERVER_NAME} \
@@ -210,7 +205,7 @@ Next, use the following steps to create an Azure Database for MySQL - Flexible S
 
 1. Use the following commands to get the host of the created MySQL server:
 
-   ```azurecli-interactive
+   ```azurecli
    DB_HOST=$(az mysql flexible-server show \
        --resource-group ${RG_NAME} \
        --name ${SERVER_NAME} \
@@ -223,7 +218,7 @@ Next, use the following steps to create an Azure Database for MySQL - Flexible S
 
 1. Use the following command to create a temporary firewall rule to allow connection to the MySQL server from the public internet:
 
-   ```azurecli-interactive
+   ```azurecli
    az mysql flexible-server firewall-rule create \
        --resource-group ${RG_NAME} \
        --name ${SERVER_NAME} \
@@ -234,7 +229,7 @@ Next, use the following steps to create an Azure Database for MySQL - Flexible S
 
 1. Use the following command to create a new database user with permissions to read and write the specific database. This command is useful to send SQL directly to the database.
 
-   ```azurecli-interactive
+   ```bash
    mysql --host ${DB_HOST} --user ${ADMIN_USERNAME} --password=${ADMIN_PASSWORD} << EOF
    CREATE USER '${DB_USERNAME}'@'%' IDENTIFIED BY '${DB_PASSWORD}';
    GRANT ALL PRIVILEGES ON ${DB_DATABASE_NAME} . * TO '${DB_USERNAME}'@'%';
@@ -244,7 +239,7 @@ Next, use the following steps to create an Azure Database for MySQL - Flexible S
 
 1. Use the following command to delete the temporary firewall rule:
 
-   ```azurecli-interactive
+   ```azurecli
    az mysql flexible-server firewall-rule delete \
        --resource-group ${RG_NAME} \
        --name ${SERVER_NAME}  \
@@ -295,7 +290,7 @@ Next, use the following steps to connect to the OpenShift cluster using the Open
 
 1. In the shell, use the following commands to download the latest OpenShift 4 CLI for GNU/Linux. If running on an OS other than GNU/Linux, download the appropriate binary for that OS.
 
-   ```azurecli-interactive
+   ```bash
    cd ~
    wget https://mirror.openshift.com/pub/openshift-v4/clients/ocp/latest/openshift-client-linux.tar.gz
 
@@ -306,7 +301,7 @@ Next, use the following steps to connect to the OpenShift cluster using the Open
 
 1. Paste the value from the **cmdToLoginWithKubeadmin** field into the shell, and execute it. You should see the `login successful` message and the project you're using. The following content is an example of the command to connect to the OpenShift cluster using the OpenShift CLI.
 
-   ```azurecli-interactive
+   ```azurecli
    oc login \
        $(az aro show \
            --resource-group ${RG_NAME} \
@@ -345,7 +340,7 @@ Use the following steps to deploy the app to the cluster. The app is hosted in t
 
 1. In the shell, run the following commands. The commands create a project, apply a permission to enable S2I to work, image the pull secret, and link the secret to the relative service accounts in the project to enable the image pull. Disregard the Git warning about "'detached HEAD' state".
 
-   ```azurecli-interactive
+   ```bash
    git clone https://github.com/Azure/rhel-jboss-templates.git
    cd rhel-jboss-templates
    git checkout 20230615
@@ -363,7 +358,7 @@ Use the following steps to deploy the app to the cluster. The app is hosted in t
 
    Because the next section uses HEREDOC format, it's best to include and execute it in its own code excerpt.
 
-   ```azurecli-interactive
+   ```bash
    cat <<EOF | oc apply -f -
    apiVersion: v1
    kind: Secret
@@ -380,14 +375,14 @@ Use the following steps to deploy the app to the cluster. The app is hosted in t
 
    You must see `secret/eaparo-sample-pull-secret created` to indicate successful creation of the secret. If you don't see this output, troubleshoot and resolve the problem before proceeding. Finally, link the secret to the default service account for downloading container images so the cluster can run them.
 
-   ```azurecli-interactive
+   ```bash
    oc secrets link default ${CON_REG_SECRET_NAME} --for=pull
    oc secrets link builder ${CON_REG_SECRET_NAME} --for=pull
    ```
 
 1. Use the following commands to pull the image stream `jboss-eap74-openjdk11-openshift`. Then, start the source to image process and wait until it completes.
 
-   ```azurecli-interactive
+   ```bash
    oc apply -f https://raw.githubusercontent.com/jboss-container-images/jboss-eap-openshift-templates/eap74/eap74-openjdk11-image-stream.json
    oc new-build --name=${APPLICATION_NAME} --binary --image-stream=jboss-eap74-openjdk11-openshift:7.4.0 -e CUSTOM_INSTALL_DIRECTORIES=extensions
    oc start-build ${APPLICATION_NAME} --from-dir=rhel-jboss-templates/eap-coffee-app --follow
@@ -410,13 +405,13 @@ Next, use the following steps to create a secret:
 
 1. Use the following command to create a secret for holding the password of the database:
 
-   ```azurecli-interactive
+   ```bash
    oc create secret generic db-secret --from-literal=password=${DB_PASSWORD}
    ```
 
 1. Use the following commands to deploy and run three replicas of the containerized app in the cluster:
 
-   ```azurecli-interactive
+   ```bash
    cat <<EOF | oc apply -f -
    apiVersion: wildfly.org/v1alpha1
    kind: WildFlyServer
@@ -466,7 +461,7 @@ Next, use the following steps to create a secret:
 
 1. Run the following command to return the URL of the application. You can use this URL to access the deployed sample app. Copy the output to the clipboard.
 
-   ```azurecli-interactive
+   ```bash
    echo http://$(oc get route ${APPLICATION_NAME}-route -o=jsonpath='{.spec.host}')/javaee-cafe
    ```
 
diff --git a/articles/openshift/howto-deploy-java-jboss-enterprise-application-platform-with-auto-redeploy.md b/articles/openshift/howto-deploy-java-jboss-enterprise-application-platform-with-auto-redeploy.md
@@ -36,7 +36,6 @@ This article uses the Azure Marketplace offer for JBoss EAP to accelerate your j
 
 Use the following steps to create a service principal:
 
-1. Open the Azure portal and navigate to the Azure Cloud Shell.
 1. Create a service principal by using the following command:
 
    ```azurecli
@@ -138,7 +137,7 @@ If you navigated away from the **Deployment is in progress** page, use the follo
 
    :::image type="content" source="media/howto-deploy-java-jboss-enterprise-application-platform-app/deployment-outputs.png" alt-text="Screenshot of the Azure portal that shows JBoss EAP on Azure Red Hat OpenShift deployment outputs." lightbox="media/howto-deploy-java-jboss-enterprise-application-platform-app/deployment-outputs.png":::
 
-1. Open the Azure Cloud Shell, paste the value from the **cmdToGetKubeadminCredentials** field, and execute it. You see the admin account and credential for signing in to the OpenShift cluster console portal. The following example shows an admin account:
+1. Open your local terminal, paste the value from the **cmdToGetKubeadminCredentials** field, and execute it. You see the admin account and credential for signing in to the OpenShift cluster console portal. The following example shows an admin account:
 
    ```azurecli
    az aro list-credentials -g eaparo033123rg -n aro-cluster
diff --git a/articles/openshift/howto-deploy-java-liberty-app.md b/articles/openshift/howto-deploy-java-liberty-app.md
@@ -27,19 +27,14 @@ If you're interested in providing feedback or working closely on your migration
 - An Azure subscription. [!INCLUDE [quickstarts-free-trial-note](~/reusable-content/ce-skilling/azure/includes/quickstarts-free-trial-note.md)]
 - A local machine with a Unix-like operating system installed (for example, Ubuntu, macOS, or Windows Subsystem for Linux).
 - The [Azure CLI](/cli/azure/install-azure-cli). If you're running on Windows or macOS, consider running Azure CLI in a Docker container. For more information, see [How to run the Azure CLI in a Docker container](/cli/azure/run-azure-cli-docker).
-- Sign in to the Azure CLI by using the [az login](/cli/azure/reference-index#az-login) command. To finish the authentication process, follow the steps displayed in your terminal. For other sign-in options, see [Sign in with the Azure CLI](/cli/azure/authenticate-azure-cli).
-- When you're prompted, install the Azure CLI extension on first use. For more information about extensions, see [Use extensions with the Azure CLI](/cli/azure/azure-cli-extensions-overview).
-- Run [az version](/cli/azure/reference-index?#az-version) to find the version and dependent libraries that are installed. To upgrade to the latest version, run [az upgrade](/cli/azure/reference-index?#az-upgrade). This article requires at least version 2.31.0 of Azure CLI.
+  - Sign in to the Azure CLI by using the [az login](/cli/azure/reference-index#az-login) command. To finish the authentication process, follow the steps displayed in your terminal. For other sign-in options, see [Sign into Azure with Azure CLI](/cli/azure/authenticate-azure-cli#sign-into-azure-with-azure-cli).
+  - When you're prompted, install the Azure CLI extension on first use. For more information about extensions, see [Use and manage extensions with the Azure CLI](/cli/azure/azure-cli-extensions-overview).
+  - Run [az version](/cli/azure/reference-index?#az-version) to find the version and dependent libraries that are installed. To upgrade to the latest version, run [az upgrade](/cli/azure/reference-index?#az-upgrade). This article requires at least version 2.31.0 of Azure CLI.
 - A Java Standard Edition (SE) implementation, version 17 or later (for example, [Eclipse Open J9](https://www.eclipse.org/openj9/)).
 - [Maven](https://maven.apache.org/download.cgi) version 3.5.0 or higher.
 - [Docker](https://docs.docker.com/get-docker/) for your OS.
 - The Azure identity you use to sign in has either the [Contributor](/azure/role-based-access-control/built-in-roles#contributor) role and the [User Access Administrator](/azure/role-based-access-control/built-in-roles#user-access-administrator) role or the [Owner](/azure/role-based-access-control/built-in-roles#owner) role in the current subscription. For an overview of Azure roles, see [What is Azure role-based access control (Azure RBAC)?](/azure/role-based-access-control/overview)
 
-> [!NOTE]
-> You can also execute this guidance from the [Azure Cloud Shell](/azure/cloud-shell/quickstart). This approach has all the prerequisite tools pre-installed, with the exception of Docker.
->
-> :::image type="icon" source="~/reusable-content/ce-skilling/azure/media/cloud-shell/launch-cloud-shell-button.png" alt-text="Button to launch the Azure Cloud Shell." border="false" link="https://shell.azure.com":::
-
 ## Get a Red Hat pull secret
 
 The Azure Marketplace offer you're going to use in this article requires a Red Hat pull secret. This section shows you how to get a Red Hat pull secret for Azure Red Hat OpenShift. To learn about what a Red Hat pull secret is and why you need it, see the [Get a Red Hat pull secret](create-cluster.md#get-a-red-hat-pull-secret-optional) section of [Create an Azure Red Hat OpenShift 4 cluster](create-cluster.md). To get the pull secret for use, follow the steps in this section.
