These branches can be

.gitattributes

@@ -0,0 +1,16 @@
+# Set the default behavior, in case people don't have core.autocrlf set.
+* text=auto
+
+# Explicitly declare text files you want to always be normalized and converted
+# to native line endings on checkout.
+*.c text
+*.h text
+
+# Denote all files that are truly binary and should not be modified.
+*.gif   binary
+*.ico   binary
+*.jpg   binary
+*.png   binary
+
+# Declare files that will always have CRLF line endings on checkout.
+*.sln text eol=crlf

.github/pull_request_template.md

@@ -0,0 +1,49 @@
+<!--
+    Thanks for contributing to the Azure CLI samples repo! For contributors, make sure that you
+    fill in the PR checklist in this template, and:
+
+    * Internal contributors: Follow the style guides and PR submission process docs:
+        - CLI style guide: https://review.docs.microsoft.com/help/contribute/conventions-azure-cli?branch=master
+        - Best practices: https://review.docs.microsoft.com/help/contribute/conventions-azure-scripts?branch=master
+        - PR submission process: https://review.docs.microsoft.com/help/contribute/contribute-scripts-pr-process?branch=master
+
+    * External contributors: Make sure that you test _all_ of your scripts that you modified. You can't read the contribution
+        guides yet, but reviewer feedback will be detailed and clear about any required changes.
+-->
+
+## Description
+
+<!-- Include a brief description of your changes. -->
+
+## Checklist
+
+<!--
+    Filling in this checklist is mandatory! If you don't, your pull request
+    will be rejected without further review. Checklists must be completed
+    within 7 days of PR submission.
+
+    To check a box in markdown, make sure that it is formatted as [X] (no whitespace).
+    Not formatting checkboxes correctly may break automated tools and delay PR processing.
+-->
+
+- [ ] Scripts in this pull request are written for the `bash` shell.
+- [ ] This pull request was tested on __at least one of__ the following platforms:
+  - [ ] Linux
+  - [ ] Azure Cloud Shell
+  - [ ] macOS
+  - [ ] Windows Subsystem for Linux
+- [ ] The most recent test date and test method are recorded in the script file.
+- [ ] Scripts do not contain passwords or other secret tokens that are not randomized.
+- [ ] No deprecated commands or arguments are used. ([Release notes](https://docs.microsoft.com/cli/azure/release-notes-azure-cli))
+- [ ] All Azure resource identifiers which must be universally unique are guaranteed to be so.
+- [ ] Resource names use a random function to ensure scripts can be run multiple times in quick succession without error.
+- [ ] All scripts can be run in their entirely without user input.
+
+### Testing information
+
+CLI version:
+```
+az --version
+```
+
+Extensions required:

.github/workflows/test-deploy.yml

@@ -0,0 +1,61 @@
+name: Test & Deploy
+
+on:
+  pull_request:
+    branches: [ master ]
+    paths:
+      - '**.sh'
+
+  # Allows you to run this workflow manually from the Actions tab
+  workflow_dispatch:
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v3
+
+      - uses: azure/login@v1
+        with:
+          creds: ${{ secrets.AZURE_CREDENTIALS }}
+          environment: 'AzureCloud'
+
+      - name: Run any shell scripts in this commit
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          az config set extension.use_dynamic_install=yes_without_prompt
+
+          echo "===================================="
+          echo "Files in PR ${{ github.head_ref }}:"
+          gh pr view ${{ github.head_ref }} --json files -q '.files[].path'
+
+          # For each file in this commit          
+          for file in $( gh pr view ${{ github.head_ref }} --json files -q '.files[].path' )
+          do
+            # If file exists and is shell script
+            if [ -e "$file" ]
+            then
+              if [[ "$file" == *.sh ]]
+              then
+                # Generate a resource group name so that it can be deleted when finished
+                let "randomIdentifier=$RANDOM*$RANDOM"
+                resourceGroup="test-deploy-rg-$randomIdentifier"
+
+                echo "===================================="
+                echo "Running $file ..."
+                pushd $(dirname "${file}")
+                chmod +X $(basename "${file}")
+                RESOURCE_GROUP=$resourceGroup /bin/bash $(basename "${file}")
+                popd
+                echo "===================================="
+
+                # Clean up the resource group
+                if [ $(az group exists --name $resourceGroup) = true ]; then
+                  echo "Deleting resource group $resourceGroup..."
+                  az group delete -n $resourceGroup -y --no-wait
+                fi
+              fi
+            fi
+          done

README.md

@@ -1,3 +1,33 @@
-# Contributing
+---
+page_type: sample
+description: "A collection of Azure CLI code samples used in Microsoft's official Azure CLI Documentation."
+languages:
+- azurecli
+products:
+- azure
+---
 
-This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/). For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.
+# Sample code used in Microsoft's official Azure CLI documentation
+
+All code in this repository is non-production samples used in Microsoft's official Azure CLI
+documentation on [docs.microsoft.com](https://docs.microsoft.com/), and is designed to be used
+by our customers for learning and experimentation purposes.
+
+## Contributing
+
+We welcome public contributions into this repository via pull requests. Please note that before we
+can accept your pull request you must sign our
+[Contribution License Agreement](https://cla.microsoft.com/). This is a one-time requirement.
+
+## License
+
+The MIT License applies to the code contained in this repo. For more information, see
+[LICENSE](LICENSE).
+
+## Microsoft Open Source Code of Conduct
+
+This repository has adopted the
+[Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/). For more
+information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or
+contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or
+comments.

app-service/README.md

@@ -0,0 +1,66 @@
+---
+page_type: sample
+languages:
+- azurecli
+products:
+- azure
+- azure-cli
+- azure-app-service
+name: Azure App Service sample scripts
+url-fragment:
+description: These scripts demonstrate how to work with Azure App Service using the Azure CLI
+---
+# Azure App Service
+
+## Azure CLI sample scripts
+
+The scripts in this directory demonstrate working with [Azure App Service][aas-home] using the [Azure CLI reference commands][azure-cli].
+
+| Script | Description |
+| ------ | ----------- |
+|**Backup and restore app**||
+|[backup-restore.sh][aas-1]|  Creates an App Service app and creates a one-time backup for it, creates a backup schedule for it, and then restores an App Service app from a backup. |
+|**Configure app**||
+|[configure-custom-domain-webapp-only.sh][aas-2]| Creates an App Service app and maps a custom domain name to it.|
+|[configure-ssl-certificate-webapp-only.sh][aas-3]| Creates an App Service app and binds the TLS/SSL certificate of a custom domain name to it.|
+|[configure-ssl-certificate.sh][aas-4]| | Creates an App Service app
+|**Connect app to resources**||
+|[connect-to-documentdb.sh][aas-5]| Creates an App Service app and an Azure Cosmos DB, then adds the Azure Cosmos DB connection details to the app settings. |
+|[connect-to-redis.sh][aas-6]| Creates an App Service app and an Azure Cache for Redis, then adds the redis connection details to the app settings.|
+|[connect-to-sql.sh][aas-7]| Creates an App Service app and a database in Azure SQL Database, then adds the database connection string to the app settings. |
+|[connect-to-storage.sh][aas-8]| Creates an App Service app and a storage account, then adds the storage connection string to the app settings. |
+|**Create app**||
+|[deploy-deployment-slot.sh][aas-9]| Creates an App Service app with a deployment slot for staging code changes.|
+|[deploy-ftp.sh][aas-10]| Creates an App Service app and deploys a file to it using FTP.|
+|[deploy-github.sh][aas-11]| Creates an App Service app and deploys code from a public GitHub repository. |
+|[deploy-linux-docker-webapp-only.sh][aas-12]| Creates an App Service app on Linux and loads a Docker image from Docker Hub.|
+|[deploy-vsts-continuous-webapp-only.sh][aas-13]| Creates an App Service app with continuous publishing from a GitHub repository you own. |
+|[integrate-with-app-gateway.sh][aas-14]| Creates an App Service app and configures code push into a local Git repository.|
+|**Monitor app**||
+|[monitor-with-logs.sh][aas-15]| Creates an App Service app, enables logging for it, and downloads the logs to your local machine.|
+|**Scale app**||
+|[scale-geographic.sh][aas-16]| Creates two App Service apps in two different geographical regions and makes them available through a single endpoint using Azure Traffic Manager.|
+|[scale-manual.sh][aas-17]| Creates an App Service app and scales it across 2 instances.|
+
+<!-- SCRIPTS -->
+[aas-1]: ./backup-one-time-schedule-restore/backup-restore.sh
+[aas-2]: ./configure-custom-domain/configure-custom-domain-webapp-only.sh
+[aas-3]: ./configure-ssl-certificate/configure-ssl-certificate-webapp-only.sh
+[aas-4]: ./configure-ssl-certificate/configure-ssl-certificate.sh
+[aas-5]: ./connect-to-documentdb/connect-to-documentdb.sh
+[aas-6]: ./connect-to-redis/connect-to-redis.sh
+[aas-7]: ./connect-to-sql/connect-to-sql.sh
+[aas-8]: ./connect-to-storage/connect-to-storage.sh
+[aas-9]: ./deploy-deployment-slot/deploy-deployment-slot.sh
+[aas-10]: ./deploy-ftp/deploy-ftp.sh
+[aas-11]: ./deploy-github/deploy-github.sh
+[aas-12]: ./deploy-linux-docker/deploy-linux-docker-webapp-only.sh
+[aas-13]: ./deploy-vsts-continuous/deploy-vsts-continuous-webapp-only.sh
+[aas-14]: ./integrate-with-app-gateway/integrate-with-app-gateway.sh
+[aas-15]: ./monitor-with-logs/monitor-with-logs.sh
+[aas-16]: ./scale-geographic/scale-geographic.sh
+[aas-17]: ./scale-manual/scale-manual.sh
+
+<!-- EXTERNAL -->
+[aas-home]: https://azure.microsoft.com/services/container-registry/
+[azure-cli]: https://learn.microsoft.com/cli/azure/reference-index

app-service/backup-one-time-schedule-restore/backup-restore.sh

@@ -0,0 +1,87 @@
+#!/bin/bash
+# Passed validation in Cloud Shell on 4/25/2022 - other than the restore step
+
+# <FullScript>
+# Backup and restore a web app from a backup
+#
+# This sample script creates a web app in App Service with its related resources.
+# It then creates a one-time backup for it, and also a scheduled backup for it.
+# Finally, it restores the web app from backup.
+#
+# set -e # exit if error
+# Variable block
+let "randomIdentifier=$RANDOM*$RANDOM"
+location="East US"
+resourceGroup="msdocs-app-service-rg-$randomIdentifier"
+tag="backup-restore.sh"
+appServicePlan="msdocs-app-service-plan-$randomIdentifier"
+webapp="msdocs-web-app-$randomIdentifier"
+storage="webappstorage$randomIdentifier"
+container="appbackup$randomIdentifier"
+backup="backup$randomIdentifier"
+expirydate=$(date -I -d "$(date) + 1 month")
+
+# Create a resource group.
+echo "Creating $resourceGroup in "$location"..."
+az group create --name $resourceGroup --location "$location" --tag $tag
+
+# Create a Storage Account
+echo "Creating $storage"
+az storage account create --name $storage --resource-group $resourceGroup --location "$location" \
+--sku Standard_LRS
+
+# Create a storage container
+echo "Creating $container on $storage..."
+key=$(az storage account keys list --account-name $storage --resource-group $resourceGroup -o json --query [0].value | tr -d '"')
+
+az storage container create --name $container --account-key $key --account-name $storage
+
+# Generate a SAS token for the storage container, valid for one month.
+# NOTE: You can use the same SAS token to make backups in App Service until --expiry
+sastoken=$(az storage container generate-sas --account-name $storage --name $container --account-key $key \
+--expiry $expirydate --permissions rwdl --output tsv)
+
+# Construct the SAS URL for the container
+sasurl=https://$storage.blob.core.windows.net/$container?$sastoken
+
+# Create an App Service plan in Standard tier. Standard tier allows one backup per day.
+echo "Creating $appServicePlan"
+az appservice plan create --name $appServicePlan --resource-group $resourceGroup --location "$location" \
+--sku S1
+
+# Create a web app
+echo "Creating $webapp"
+az webapp create --name $webapp --plan $appServicePlan --resource-group $resourceGroup
+
+# Create a one-time backup
+echo "Creating $backup"
+az webapp config backup create --resource-group $resourceGroup --webapp-name $webapp \
+--backup-name $backup --container-url $sasurl
+
+# List statuses of all backups that are complete or currently executing.
+az webapp config backup list --resource-group $resourceGroup --webapp-name $webapp
+
+# Schedule a backup every day and retain for 10 days
+az webapp config backup update --resource-group $resourceGroup --webapp-name $webapp \
+--container-url $sasurl --frequency 1d --retain-one true --retention 10
+
+# Show the current scheduled backup configuration
+az webapp config backup show --resource-group $resourceGroup --webapp-name $webapp
+
+# List statuses of all backups that are complete or currently executing
+az webapp config backup list --resource-group $resourceGroup --webapp-name $webapp
+
+# (OPTIONAL) Change the backup schedule to every 2 days
+az webapp config backup update --resource-group $resourceGroup --webapp-name $webapp \
+--container-url $sasurl --frequency 2d --retain-one true --retention 10
+
+# Restore the app by overwriting it with the backup data
+
+az webapp config backup restore --resource-group $resourceGroup --webapp-name $webapp \
+--backup-name $backup --container-url $sasurl --overwrite
+
+# fails - https://github.com/Azure/azure-cli/issues/19492
+# </FullScript>
+
+# echo "Deleting all resources"
+# az group delete --name $resourceGroup -y