Skip to content

Commit 38a78a0

Browse files
authored
Merge pull request #15644 from sethmanheim/hubfresh8-8
Freshness pass AS Hub
2 parents 2917ab1 + 3ae5e95 commit 38a78a0

17 files changed

+312
-367
lines changed

azure-stack/operator/aks-add-on.md

Lines changed: 16 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Install and offer the Azure Kubernetes Service on Azure Stack Hub
33
description: Learn how to install and offer the Azure Kubernetes Service on Azure Stack Hub.
44
author: sethmanheim
55
ms.topic: how-to
6-
ms.date: 04/24/2023
6+
ms.date: 08/08/2024
77
ms.author: sethm
88
ms.reviewer: waltero
99
ms.lastreviewed: 03/24/2022
@@ -20,11 +20,11 @@ Azure Kubernetes Service (AKS) enables your users to deploy Kubernetes clusters
2020
To install, you must have the VM extensions, the AKS base image, a plan and offer to your users, and enable multi-tenancy for your Azure Stack Hub. AKS clusters can only be created in the user environment.
2121

2222
> [!IMPORTANT]
23-
> Azure Kubernetes Service on Azure Stack Hub, currently in preview, is being discontinued and will not become GA. See [AKS Engine](../user/azure-stack-kubernetes-aks-engine-overview.md) for a Kubernetes solution on Azure Stack Hub.
23+
> Azure Kubernetes Service on Azure Stack Hub, currently in preview, is discontinued and won't be released to general availability (GA). See the [AKS Engine overview](../user/azure-stack-kubernetes-aks-engine-overview.md) for a Kubernetes solution on Azure Stack Hub.
2424
> See the [Supplemental Terms of Use for Microsoft Azure Previews](https://azure.microsoft.com/support/legal/preview-supplemental-terms/) for legal terms that apply to Azure features that are in beta, preview, or otherwise not yet released into general availability.
2525
2626
> [!NOTE]
27-
> Azure Kubernetes Service on Azure Stack Hub doesn't support the creation of a cluster in the administration environment. You can only create AKS clusters in the user environment.
27+
> Azure Kubernetes Service on Azure Stack Hub doesn't support the creation of a cluster in the administrator environment. You can only create AKS clusters in the user environment.
2828
2929
## Download required VM extensions
3030

@@ -36,11 +36,11 @@ You can find the VM extensions in the Azure Stack Hub Marketplace. You can downl
3636

3737
- Run command for Linux (latest version)
3838

39-
![Get the run command for Linux](media/aks-add-on/get-run-command-for-linux.png)
39+
![Screenshot of portal showing the run command for Linux.](media/aks-add-on/get-run-command-for-linux.png)
4040

4141
- Custom script for Linux (version 2.0.6)
4242

43-
![Get custom script for Linux](media/aks-add-on/get-custom-script-for-linux.png)
43+
![Screenshot of portal showing custom script for Linux.](media/aks-add-on/get-custom-script-for-linux.png)
4444

4545
### View the extensions with PowerShell
4646

@@ -56,50 +56,50 @@ For information about installing and using the AzureStack PowerShell module, see
5656

5757
## Download AKS base image
5858

59-
The AKS Service needs a special VM image referred to as the *AKS base image*. The AKS service doesn't work without the correct image version available in the local Azure Stack Hub Marketplace. The image is meant to be used by the AKS service, not to be used by tenants to create individual VMs. The image is not visible to tenants in the Marketplace. This is a task that needs to be done along with every Azure Stack Hub update. Every time there is a new update, there is a new AKS base image associated with the AKS service. Here are the steps:
59+
The AKS service needs a special VM image referred to as the *AKS base image*. The AKS service doesn't work without the correct image version available in the local Azure Stack Hub Marketplace. The image is meant to be used by the AKS service, not to be used by tenants to create individual VMs. The image is not visible to tenants in the Marketplace. This is a task that needs to be done along with every Azure Stack Hub update. Every time there is a new update, there's a new AKS base image associated with the AKS service. Here are the steps:
6060

6161
1. Using the administrator portal, go the **Marketplace management** blade and select **Add from Azure**.
6262
1. Type **AKS** in the search box. Locate and download both the Linux **AKS Base Ubuntu 18.04-LTS Image Distro, 2022 Q1** version **2022.01.21** and the **AKS Base Windows Image** version **17763.2300.220121**.
6363

6464
- Linux base image:
6565

66-
[![Add the AKS Base Image - Linux](media/aks-add-on/aks-base-image-linux.png)](media/aks-add-on/aks-base-image-linux.png#lightbox)
66+
[![Screenshot of portal showing adding the AKS Base Image - Linux.](media/aks-add-on/aks-base-image-linux.png)](media/aks-add-on/aks-base-image-linux.png#lightbox)
6767

6868
- Windows base image:
6969

70-
[![Add the AKS Base Image - Windows](media/aks-add-on/aks-base-image-windows.png)](media/aks-add-on/aks-base-image-windows.png#lightbox)
70+
[![Screenshot of portal showing adding the AKS Base Image - Windows.](media/aks-add-on/aks-base-image-windows.png)](media/aks-add-on/aks-base-image-windows.png#lightbox)
7171

72-
1. If your instance is disconnected, follow the instructions in the article [Download Marketplace items to Azure Stack Hub](azure-stack-download-azure-marketplace-item.md) to download the two specified items from the marketplace in Azure, and upload them to your Azure Stack Hub instance.
72+
1. If your instance is disconnected, follow the instructions in [Download Marketplace items to Azure Stack Hub](azure-stack-download-azure-marketplace-item.md) to download the two specified items from the marketplace in Azure, and upload them to your Azure Stack Hub instance.
7373

7474
## Create plans and offers
7575

7676
To allow tenant users to use the AKS service, the operator must make it available through a plan and an offer.
7777

7878
1. Create a plan with the `Microsoft.Container` service. There are no specific quotas for this service; it uses the quotas available for the Compute, Network, and Storage services:
7979

80-
![Create a plan](media/aks-add-on/aks-create-a-plan.png)
80+
![Screenshot of portal showing create a plan.](media/aks-add-on/aks-create-a-plan.png)
8181

8282
1. Again, use the Azure Stack Hub administration portal to create an offer that contains the plan created in the prior step:
8383

84-
![Create an offer](media/aks-add-on/aks-create-an-offer.png)
84+
![Screenshot of portal showing create an offer.](media/aks-add-on/aks-create-an-offer.png)
8585

8686
## Configure multi-tenancy
8787

8888
You must configure Azure Stack Hub to support sign-ins from users that reside in other Microsoft Entra directories, allowing them to use services in Azure Stack Hub.
8989

90-
For instructions, see [Configure multi-tenancy in Azure Stack Hub](enable-multitenancy.md?pivots=management-tool-powershell)
90+
For instructions, see [Configure multi-tenancy in Azure Stack Hub](enable-multitenancy.md?pivots=management-tool-powershell).
9191

9292
## Monitor and act on alerts
9393

94-
1. Using the administrative portal, you can access the **Azure Kubernetes Service** under the **Administration** group.
94+
1. Use the administrator portal to access **Azure Kubernetes Service** under the **Administration** group.
9595
1. Select the **Alerts** blade. Review the alerts:
9696

97-
![AKS - Admin](media/aks-add-on/aks-admin.png)
97+
![Screenshot of portal showing AKS - Admin.](media/aks-add-on/aks-admin.png)
9898

9999
1. Alerts appear in the **Alerts** blade, and you can take action on them if necessary:
100100

101-
![AKS - Alerts](media/aks-add-on/aks-alerts.png)
101+
![Screenshot of portal showing AKS - Alerts.](media/aks-add-on/aks-alerts.png)
102102

103103
## Next steps
104104

105-
[Learn more about AKS on Azure Stack Hub](../user/aks-overview.md)
105+
[More information about AKS on Azure Stack Hub](../user/aks-overview.md)

azure-stack/operator/app-service-back-up.md

Lines changed: 23 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -2,10 +2,9 @@
22
title: Back up App Service on Azure Stack Hub
33
description: Learn how to back up App Services on Azure Stack Hub.
44
author: sethmanheim
5-
65
ms.topic: article
7-
ms.date: 04/23/2019
8-
ms.author: anwestg
6+
ms.date: 08/08/2024
7+
ms.author: sethm
98
ms.reviewer: anwestg
109
ms.lastreviewed: 03/21/2019
1110

@@ -16,39 +15,40 @@ ms.lastreviewed: 03/21/2019
1615

1716
# Back up App Service on Azure Stack Hub
1817

19-
This document provides instructions on how to back up App Service on Azure Stack Hub.
18+
This article provides instructions on how to back up App Service on Azure Stack Hub.
2019

2120
> [!IMPORTANT]
22-
> App Service on Azure Stack Hub isn't backed up as part of [Azure Stack Hub infrastructure backup](azure-stack-backup-infrastructure-backup.md). As an Azure Stack Hub Operator, you must take steps to ensure App Service can be successfully recovered if necessary.
21+
> App Service on Azure Stack Hub isn't backed up as part of [Azure Stack Hub infrastructure backup](azure-stack-backup-infrastructure-backup.md). As an Azure Stack Hub operator, you must take steps to ensure App Service can be successfully recovered if necessary.
2322
2423
Azure App Service on Azure Stack Hub has four main components to consider when planning for disaster recovery:
25-
1. The resource provider infrastructure; server roles, worker tiers, and so on.
26-
2. The App Service secrets.
27-
3. The App Service SQL Server hosting and metering databases.
28-
4. The App Service user workload content stored in the App Service file share.
2924

30-
## Back up App Service secrets
31-
When recovering App Service from backup, you need to provide the App Service keys used by the initial deployment. This information should be saved as soon as App Service is successfully deployed and stored in a safe location. The resource provider infrastructure configuration is recreated from backup during recovery using App Service recovery PowerShell cmdlets.
25+
1. The resource provider infrastructure; server roles, worker tiers, and so on.
26+
1. The App Service secrets.
27+
1. The App Service SQL Server hosting and metering databases.
28+
1. The App Service user workload content stored in the App Service file share.
3229

33-
Use the administration portal to back up app service secrets by following these steps:
30+
## Back up App Service secrets
3431

35-
1. Sign in to the Azure Stack Hub administrator portal as the service admin.
32+
When you recover App Service from backup, you must provide the App Service keys used by the initial deployment. This information should be saved as soon as App Service is successfully deployed and stored in a safe location. The resource provider infrastructure configuration is recreated from backup during recovery using App Service recovery PowerShell cmdlets.
3633

37-
2. Browse to **App Service** -> **Secrets**.
34+
Use the administrator portal to back up App Service secrets by following these steps:
3835

39-
3. Select **Download Secrets**.
36+
1. Sign in to the Azure Stack Hub administrator portal as the service admin.
37+
1. Browse to **App Service** -> **Secrets**.
38+
1. Select **Download Secrets**.
4039

41-
![Download secrets in Azure Stack Hub administrator portal](./media/app-service-back-up/download-secrets.png)
40+
![Screenshot showing download secrets in Azure Stack Hub administrator portal.](./media/app-service-back-up/download-secrets.png)
4241

43-
4. When secrets are ready for downloading, click **Save** and store the App Service secrets (**SystemSecrets.JSON**) file in a safe location.
42+
1. When the secrets are ready for downloading, select **Save** and store the App Service secrets (**SystemSecrets.json**) file in a safe location.
4443

45-
![Save secrets in Azure Stack Hub administrator portal](./media/app-service-back-up/save-secrets.png)
44+
![Screenshot showing save secrets in Azure Stack Hub administrator portal.](./media/app-service-back-up/save-secrets.png)
4645

4746
> [!NOTE]
4847
> Repeat these steps every time the App Service secrets are rotated.
4948
5049
## Back up the App Service databases
51-
To restore App Service, you need the **Appservice_hosting** and **Appservice_metering** database backups. We recommend using SQL Server maintenance plans or Azure Backup Server to ensure these databases are backed up and saved securely on a regular basis. However, any method of ensuring regular SQL backups are created can be used.
50+
51+
To restore App Service, you need the **Appservice_hosting** and **Appservice_metering** database backups. We recommend using SQL Server maintenance plans or Azure Backup Server to ensure these databases are backed up and saved securely on a regular basis. However, you can use any method of ensuring regular SQL backups are created.
5252

5353
To manually back up these databases while logged into the SQL Server, use the following PowerShell commands:
5454

@@ -61,16 +61,17 @@ To manually back up these databases while logged into the SQL Server, use the fo
6161
```
6262

6363
> [!NOTE]
64-
> If you need to back up SQL AlwaysOn databases, follow [these instructions](/sql/database-engine/availability-groups/windows/configure-backup-on-availability-replicas-sql-server?view=sql-server-2017&preserve-view=true).
64+
> If you need to back up SQL AlwaysOn databases, [follow these instructions](/sql/database-engine/availability-groups/windows/configure-backup-on-availability-replicas-sql-server?view=sql-server-2017&preserve-view=true).
6565
6666
After all databases have been successfully backed up, copy the .bak files to a safe location along with the App Service secrets info.
6767

6868
## Back up the App Service file share
69+
6970
App Service stores tenant app info in the file share. This file share must be backed up on a regular basis along with the App Service databases so that as little data as possible is lost if a restore is required.
7071

7172
To back up the App Service file share content, use Azure Backup Server or another method to regularly copy the file share content to the location you've saved all previous recovery info.
7273

73-
For example, you can use these steps to use Robocopy from a Windows PowerShell (not PowerShell ISE) console session:
74+
For example, you can run these commands to use Robocopy from a Windows PowerShell (not PowerShell ISE) console session:
7475

7576
```powershell
7677
$source = "<file share location>"
@@ -81,4 +82,5 @@ net use $destination /delete
8182
```
8283

8384
## Next steps
85+
8486
[Restore App Service on Azure Stack Hub](app-service-recover.md)

azure-stack/operator/app-service-billing-faq.yml

Lines changed: 6 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -2,11 +2,10 @@
22
metadata:
33
title: Azure App Service on Azure Stack Hub billing overview and FAQ
44
description: Learn about billing for Azure App Service on Azure Stack Hub.
5-
author: apwestgarth
6-
manager: stefsch
5+
author: sethmanheim
76
ms.topic: faq
8-
ms.date: 05/05/2020
9-
ms.author: anwestg
7+
ms.date: 08/08/2024
8+
ms.author: sethm
109
ms.reviewer: anwestg
1110
ms.lastreviewed: 04/13/2020
1211

@@ -15,11 +14,11 @@ metadata:
1514
title: Azure App Service on Azure Stack Hub billing overview and FAQ
1615
summary: |
1716
18-
This article shows how cloud operators are billed for offering Azure App Service on Azure Stack Hub and how they can bill their tenants for using the service.
17+
This article describes how cloud operators are billed for offering Azure App Service on Azure Stack Hub and how they can bill their tenants for using the service.
1918
2019
## Billing overview
2120
22-
Azure Stack Hub cloud operators choose to deploy Azure App Service on Azure Stack Hub onto their Azure Stack Hub stamp to offer the tenant capabilities of Azure App Service and Azure Functions to their customers. The Azure App Service resource provider consists of multiple types of roles that can be divided between infrastructure and worker tiers.
21+
Azure Stack Hub cloud operators can choose to deploy Azure App Service on Azure Stack Hub onto their Azure Stack Hub stamp to offer the tenant capabilities of Azure App Service and Azure Functions to their customers. The Azure App Service resource provider consists of multiple types of roles that can be divided between infrastructure and worker tiers.
2322
2423
Infrastructure roles aren't billed because they're required for the core operation of the service. Infrastructure roles can be scaled out as required to support the demands of the cloud operator's tenants. The infrastructure roles are as follows:
2524
@@ -49,7 +48,7 @@ summary: |
4948
5049
Cloud operators can view the current number of available workers per worker tier by looking at the worker tiers in the Azure App Service configuration on Azure Stack Hub administration.
5150
52-
![App Service - Worker Tiers screen](./media/app-service-billing-faq/app-service-worker-tiers.png)
51+
![Screenshot showing App Service - Worker Tiers.](./media/app-service-billing-faq/app-service-worker-tiers.png)
5352
5453
## See customer usage by using the Azure Stack Hub usage service
5554

0 commit comments

Comments
 (0)