Skip to content

Commit a26806e

Browse files
committed
edits
1 parent 79f5580 commit a26806e

6 files changed

+126
-99
lines changed

articles/batch/TOC.yml

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -103,17 +103,17 @@
103103
href: high-availability-disaster-recovery.md
104104
- name: Task runtime environment variables
105105
href: batch-compute-node-environment-variables.md
106-
- name: Retirements
106+
- name: Batch feature retirements
107107
items:
108-
- name: Batch Certificates Migration Guide
108+
- name: Certificates for access management
109109
href: batch-certificate-migration-guide.md
110-
- name: Batch pools without public IP addresses classic Retirement Migration Guide
110+
- name: Pools without public IP addresses (classic)
111111
href: batch-pools-without-public-IP-addresses-classic-retirement-migration-guide.md
112-
- name: Batch TLS 1.0_1 Migration Guide
112+
- name: TLS 1.0 and TLS 1.1
113113
href: batch-tls-101-migration-guide.md
114-
- name: Job Pool Lifetime Statistics Migration Guide
114+
- name: Job pool lifetime statistics
115115
href: job-pool-lifetime-statistics-migration-guide.md
116-
- name: Low Priority VMs Retirement Migration Guide
116+
- name: Low-priority VMs
117117
href: low-priority-VMs-retirement-migration-guide.md
118118
- name: How-to guides
119119
items:

articles/batch/batch-certificate-migration-guide.md

Lines changed: 19 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -1,50 +1,48 @@
11
---
2-
title: Migrate certificates from Azure Batch to Azure Key Vault
3-
description: Learn how to migrate access management from Azure Batch certificates to Azure Key Vault to prepare for end of support for certificates in Batch.
2+
title: Migrate Azure Batch access management to Azure Key Vault
3+
description: Learn how to migrate access management from Azure Batch to Azure Key Vault to prepare for end of support for certificates in Batch.
44
author: harperche
55
ms.author: harpercheng
66
ms.service: batch
77
ms.topic: how-to
88
ms.date: 08/15/2022
99
---
10-
# Migrate access management from Azure Batch certificates to Azure Key Vault
1110

12-
Learn how to migrate access management in Azure Batch from using certificates to using a key in Azure Key Vault.
11+
# Migrate Azure Batch access management to Azure Key Vault (feature retirement)
1312

14-
> [!NOTE]
15-
> On February 29, 2024, the certificate feature in Azure Batch access management will be retired.
16-
17-
Often, you need to store secure data in an application. Your data must be securely managed so that only administrators or authorized users can access it.
13+
On *February 29, 2024*, the certificates feature for Azure Batch access management will be retired. Learn how to migrate access management from using certificates in Azure Batch to using Azure Key Vault.
1814

1915
## Batch secure access options
2016

21-
Azure Batch offers two ways to secure access management. You can use a certificate that you create and manage in Azure Batch, or you can use Azure Key Vault to store access keys. Using a key vault is an Azure standard way to deliver more controlled secure access management.
17+
Often, you need to store secure data in an application. Your data must be securely managed so that only administrators or authorized users can access it.
18+
19+
Azure Batch offers two ways to secure access management. You can use a certificate that you create and manage in Azure Batch or you can use Azure Key Vault to store an access key. Using a key vault is an Azure standard way to deliver more controlled secure access management.
2220

2321
Currently, you can use a certificate at the account level in Azure Batch. You must generate the certificate and upload it manually to Batch by using the Azure portal. To access the certificate, the certificate must be associated with and installed for only the current user. A certificate typically is valid for one year, and it must be updated each year.
2422

25-
## Certificate retirement in Batch
23+
## Certificates in Batch retirement
2624

27-
To move toward a simpler, standardized way to secure access to your Batch resources, on *February 29, 2024*, we'll retire the certificate feature in Azure Batch. We recommend that you instead use Azure Key Vault as a standard and more modern method to secure your resources in Batch.
25+
To move toward a simpler, standardized way to secure access to your Batch resources, on *February 29, 2024*, we'll retire the certificates feature in Azure Batch. We recommend that you instead use Azure Key Vault as a standard and more modern method to secure your resources in Batch.
2826

2927
In Key Vault, you get these benefits:
3028

3129
- Reduced manual maintenance and streamlined maintenance overall
3230
- Reduced access to and readability of the key that's generated
3331
- Advanced security
3432

35-
After the certificate feature in Azure Batch is retired on February 29, 2024, a certificate in Batch might not work as expected. After that date, you won't be able to create a pool by using a certificate. Pools that continue to use certificates after the feature is retired might increase in size and cost.
33+
After the certificates feature in Azure Batch is retired on February 29, 2024, a certificate in Batch might not work as expected. After that date, you won't be able to create a pool by using a certificate. Pools that continue to use certificates after the feature is retired might increase in size and cost.
3634

3735
## Use Key Vault to secure your Batch resources
3836

3937
Azure Key Vault is an Azure service you can use to store and manage secrets, certificates, tokens, keys, and other configuration values that give authenticated users access to secure applications and services. Key Vault is based on the idea that security is improved and standardized when you remove hard-coded secrets and keys from application code that's deployed.
4038

41-
Key Vault provides security at the transport layer by ensuring that any data flow from the key vault to the client application is encrypted. Azure key vault stores the secrets and keys with such strong encryption that even Microsoft can't read Key Vault-protected keys and secrets.
39+
Key Vault provides security at the transport layer by ensuring that any data flow from the key vault to the client application is encrypted. Azure Key Vault stores secrets and keys with such strong encryption that even Microsoft can't read key vault-protected keys and secrets.
4240

4341
Azure Key Vault gives you a secure way to store essential access information and to set fine-grained access control. You can manage all secrets from one dashboard. Choose to store a key in either software-protected or hardware-protected hardware security modules (HSMs). You also can set Key Vault to auto-renew certificates
4442

4543
## Create a key vault
4644

47-
To create a key vault to manage access for Batch resource, you can use one of the following options:
45+
To create a key vault to manage access for Batch resources, use one of the following options:
4846

4947
- Azure portal
5048
- PowerShell
@@ -66,13 +64,13 @@ To create a key vault:
6664

6765
1. Select **Review**, and then select **Create** to create the key vault account.
6866

69-
1. Go to the key vault you created. The key vault name and the URI you use to access the vault are shown.
67+
1. Go to the key vault you created. The key vault name and the URI you use to access the vault are shown under deployment details.
7068

71-
For more information, see [Quickstart: Create a key vault using the Azure portal](/azure/key-vault/general/quick-create-portal).
69+
For more information, see [Quickstart: Create a key vault by using the Azure portal](../key-vault/general/quick-create-portal.md).
7270

73-
### Create a key vault by using Azure PowerShell
71+
### Create a key vault by using PowerShell
7472

75-
1. In Azure PowerShell, sign in to your account by using the following command:
73+
1. Use the PowerShell option in Azure Cloud Shell to sign in to your account;
7674

7775
```powershell
7876
Login-AzAccount
@@ -90,7 +88,7 @@ For more information, see [Quickstart: Create a key vault using the Azure portal
9088
New-AzKeyVault -Name <KeyVaultName> -ResourceGroupName <ResourceGroupName> -Location <Location>
9189
```
9290

93-
For more information, see [Quickstart: Create a key vault using PowerShell](/azure/key-vault/general/quick-create-powershell).
91+
For more information, see [Quickstart: Create a key vault by using PowerShell](../key-vault/general/quick-create-powershell.md).
9492

9593
### Create a key vault by using the Azure CLI
9694

@@ -106,9 +104,9 @@ For more information, see [Quickstart: Create a key vault using PowerShell](/azu
106104
az keyvault create -name <KeyVaultName> -resource-group <ResourceGroupName> -location <Location>
107105
```
108106

109-
For more information, see [Quickstart: Create a key vault using the Azure CLI](/azure/key-vault/general/quick-create-cli).
107+
For more information, see [Quickstart: Create a key vault by using the Azure CLI](../key-vault/general/quick-create-cli.md).
110108

111-
## FAQ
109+
## FAQs
112110

113111
- Does Microsoft recommend using Azure Key Vault for access management in Batch?
114112

articles/batch/batch-pools-without-public-ip-addresses-classic-retirement-migration-guide.md

Lines changed: 29 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -1,62 +1,68 @@
11
---
2-
title: Batch Pools without public IP addresses classic retirement
3-
description: Describes the migration steps for the batch pool without public ip addresses and the end of support details.
2+
title: Opt in to migrate Azure Batch pools without public IP addresses (classic)
3+
description: Learn how to opt in to migrate Azure Batch pools without public IP addresses (classic) and plan for feature end of support.
44
author: harperche
55
ms.author: harpercheng
66
ms.service: batch
77
ms.topic: how-to
88
ms.date: 09/01/2022
99
---
1010

11-
# Batch Pools without public IP addresses classic retirement
11+
# Opt in to migrate Batch pools without public IP addresses (feature retirement)
1212

13-
By default, all the compute nodes in an Azure Batch virtual machine (VM) configuration pool are assigned a public IP address. This address is used by the Batch service to schedule tasks and for communication with compute nodes, including outbound access to the internet. To restrict access to these nodes and reduce the discoverability of these nodes from the internet, we released [Batch pools without public IP addresses (classic)](./batch-pool-no-public-ip-address.md).
13+
Azure Batch pools without public IP addresses (classic) will retire on *March 31, 2023*. Existing pools will migrate to simplified compute node communication pools without public IP addresses. You must opt in to migrate your Batch pools.
1414

15-
In late 2021, we launched a simplified compute node communication model for Azure Batch. The new communication model improves security and simplifies the user experience. Batch pools no longer require inbound Internet access and outbound access to Azure Storage, only outbound access to the Batch service. As a result, Batch pools without public IP addresses (classic) which is currently in public preview will be retired on *March 31 2023* and will be replaced with simplified compute node communication pools without public IPs.
15+
## About Batch pools without public IP addresses
1616

17-
## Retirement alternatives
17+
By default, all the compute nodes in an Azure Batch virtual machine (VM) configuration pool are assigned a public IP address. The Batch service uses the IP address to schedule tasks and for communication with compute nodes, including outbound access to the internet. To restrict access to these nodes and reduce the discoverability of these nodes from the internet, we released [Batch pools without public IP addresses (classic)](./batch-pool-no-public-ip-address.md).
1818

19-
[Simplified Compute Node Communication Pools without Public IPs](./simplified-node-communication-pool-no-public-ip.md) requires using simplified compute node communication. It provides customers with enhanced security for their workload environments on network isolation and data exfiltration to Azure Batch accounts. Its key benefits include:
19+
## End of support for pools without public IP addresses
2020

21-
- Allow creating simplified node communication pool without public IP addresses.
22-
- Support Batch private pool using a new private endpoint (sub-resource nodeManagement) for Azure Batch account.
23-
- Simplified private link DNS zone for Batch account private endpoints: changed from `privatelink.<region>.batch.azure.com` to `privatelink.batch.azure.com`.
21+
In late 2021, we launched a simplified compute node communication model for Azure Batch. The new communication model improves security and simplifies the user experience. Batch pools no longer require inbound internet access and outbound access to Azure Storage. Batch pools now need only outbound access to the Batch service. As a result, Batch pools without public IP addresses (classic), currently in public preview, will be retired on *March 31, 2023*. The feature will be replaced by simplified compute node communication pools without public IPs.
22+
23+
## Use simplified node communication for a pool with no public IP address
24+
25+
The alternative to using a Batch pool without a public IP address (classic) requires using [simplified node communication](./simplified-node-communication-pool-no-public-ip.md). The option gives you enhanced security for your workload environments on network isolation and data exfiltration to Azure Batch accounts. Its key benefits include:
26+
27+
- You can create simplified node communication pools without public IP addresses.
28+
- You can create a Batch private pool by using a new private endpoint (sub-resource nodeManagement) for an Azure Batch account.
29+
- A simplified private link DNS zone for Batch account private endpoints. The private link changed from `privatelink.<region>.batch.azure.com` to `privatelink.batch.azure.com`.
2430
- Mutable public network access for Batch accounts.
25-
- Firewall support for Batch account public endpoints: configure IP address network rules to restrict public network access with Batch accounts.
31+
- Firewall support for Batch account public endpoints. You can configure IP address network rules to restrict public network access with Batch accounts.
2632

27-
## Migration steps
33+
## Opt in and migrate your eligible pools
2834

29-
Batch pool without public IP addresses (classic) will retire on **31 March 2023** and will be updated to simplified compute node communication pools without public IPs. For existing pools that use the previous preview version of Batch pool without public IP addresses (classic), it's only possible to migrate pools created in a virtual network. To migrate the pool, follow the opt-in process for simplified compute node communication:
35+
Batch pools without public IP addresses (classic) will retire on *March 31, 2023*. For existing pools that use the earlier preview version of Batch pools without public IP addresses (classic), you can migrate only pools that you created in a virtual network. To migrate the pool, follow the opt-in process for simplified compute node communication:
3036

3137
1. Opt in to [use simplified compute node communication](./simplified-compute-node-communication.md#opt-your-batch-account-in-or-out-of-simplified-compute-node-communication).
3238

33-
![Support Request](../batch/media/certificates/opt-in.png)
39+
:::image type="content" source="media/certificates/opt-in.png" alt-text="Screenshot that shows creating a support request to opt in.":::
3440

3541
1. Create a private endpoint for Batch node management in the virtual network.
3642

37-
![Create Endpoint](../batch/media/certificates/private-endpoint.png)
43+
:::image type="content" source="media/certificates/private-endpoint.png" alt-text="Screenshot that shows how to create an endpoint.":::
3844

3945
1. Scale down the pool to zero nodes.
4046

41-
![Scale Down](../batch/media/certificates/scale-down-pool.png)
47+
:::image type="content" source="media/certificates/scale-down-pool.png" alt-text="Screenshot that shows how to scale down a pool.":::
4248

4349
1. Scale out the pool again. The pool is then automatically migrated to the new version of the preview.
4450

45-
![Scale Out](../batch/media/certificates/scale-out-pool.png)
51+
:::image type="content" source="media/certificates/scale-out-pool.png" alt-text="Screenshot that shows how to scale out a pool.":::
4652

47-
## FAQ
53+
## FAQs
4854

4955
- How can I migrate my Batch pool without public IP addresses (classic) to simplified compute node communication pools without public IPs?
5056

51-
You can only migrate your pool to simplified compute node communication pools if it was created in a virtual network. Otherwise, you’d need to create a new simplified compute node communication pool without public IPs.
57+
You can migrate your pool to simplified compute node communication pools only if you created the pool in a virtual network. Otherwise, create a new simplified compute node communication pool without public IP addresses.
5258

5359
- What differences will I see in billing?
5460

55-
Compared with Batch pools without public IP addresses (classic), the simplified compute node communication pools without public IPs support will reduce costs because it won’t need to create network resources the following: load balancer, network security groups, and private link service with the Batch pool deployments. However, there will be a [cost associated with private link](https://azure.microsoft.com/pricing/details/private-link/) or other outbound network connectivity used by pools, as controlled by the user, to allow communication with the Batch service without public IP addresses.
61+
Compared with Batch pools without public IP addresses (classic), the simplified compute node communication pools without public IPs support will reduce costs because it won’t need to create the following network resources: load balancer, network security groups, and private link service with the Batch pool deployments. However, there will be a [cost associated with private link](https://azure.microsoft.com/pricing/details/private-link/) or other outbound network connectivity used by pools, as controlled by the user, to allow communication with the Batch service without public IP addresses.
5662

57-
- Will there be any performance changes?
63+
- Will I see any changes in performance?
5864

59-
No known performance differences compared to Batch pools without public IP addresses (classic).
65+
No known performance differences exist for simplified compute node communication pools without public IPs compared to Batch pools without public IP addresses (classic).
6066

6167
- How can I connect to my pool nodes for troubleshooting?
6268

@@ -68,7 +74,7 @@ Batch pool without public IP addresses (classic) will retire on **31 March 2023*
6874

6975
- What if I don’t migrate to simplified compute node communication pools without public IPs?
7076

71-
After *March 31 2023*, we will stop supporting Batch pool without public IP addresses. The functionality of the existing pool in that configuration may break, such as scale out operations, or may be actively scaled down to zero at any point in time after that date.
77+
After *March 31, 2023*, we will stop supporting Batch pools without public IP addresses. The functionality of the existing pool in that configuration might break, including scale-out operations, or the pool might be actively scaled down to zero at any point in time after that date.
7278

7379
## Next steps
7480

0 commit comments

Comments
 (0)