Skip to content

Commit db2bde9

Browse files
authored
Merge pull request #295384 from MicrosoftDocs/main
2/26/2025 PM Publish
2 parents 8d04fa9 + da5e09b commit db2bde9

File tree

69 files changed

+1024
-144
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

69 files changed

+1024
-144
lines changed

.openpublishing.publish.config.json

Lines changed: 0 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -242,12 +242,6 @@
242242
"branch": "main",
243243
"branch_mapping": {}
244244
},
245-
{
246-
"path_to_root": "azure-proactive-resiliency-library",
247-
"url": "https://github.com/Azure/Azure-Proactive-Resiliency-Library",
248-
"branch": "main",
249-
"branch_mapping": {}
250-
},
251245
{
252246
"path_to_root": "azure-sdk-for-go-samples",
253247
"url": "https://github.com/Azure-Samples/azure-sdk-for-go-samples",

articles/communication-services/concepts/analytics/logs/call-diagnostics-updates-log-schema.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -42,6 +42,8 @@ When using the Call Diagnostics Updates Log Schema, always refer to the highest
4242

4343
### More about log versions and data latency
4444

45+
The call diagnostics updates log schema may require approximately 60 minutes following the end of a call to propogate data, most logs may be available within 40 minutes.
46+
4547
After a call ends, an initial version (version 1) of the log is sent to the CallSummaryUpdates and CallDiagnosticUpdates tables. Initial versions may contain `null` values, if more information becomes available updated versions of the logs are created with more complete information. For example, client data can be delayed because of network connectivity issues between the client computer and our servers, or something as simple as a user closing the lid on their laptop post-call before their client data was sent and re-opening it hours (or days) later.
4648

4749

articles/communication-services/concepts/analytics/logs/call-summary-updates-log-schema.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -43,6 +43,8 @@ When using the call summary updates log schema, always refer to the highest `Cal
4343

4444
### More about log versions and data latency
4545

46+
The call summary updates log schema may require approximately 60 minutes following the end of a call to propogate data, most logs may be available within 40 minutes.
47+
4648
After a call ends, an initial version (version 1) of the log is sent to the CallSummaryUpdates and CallDiagnosticUpdates tables. Initial versions may contain `null` values, if more information becomes available updated versions of the logs are created with more complete information. For example, client data can be delayed because of network connectivity issues between the client computer and our servers, or something as simple as a user closing the lid on their laptop post-call before their client data was sent and re-opening it hours (or days) later.
4749

4850

@@ -355,4 +357,4 @@ If you have multiple Azure Communications Services resource IDs, you must enable
355357
- Learn about the [insights dashboard to monitor Voice Calling and Video Calling logs](/azure/communication-services/concepts/analytics/insights/voice-and-video-insights).
356358

357359
- Learn how to use call logs to diagnose call quality and reliability
358-
issues with Call Diagnostics, see: [Call Diagnostics](../../voice-video-calling/call-diagnostics.md)
360+
issues with Call Diagnostics, see: [Call Diagnostics](../../voice-video-calling/call-diagnostics.md)

articles/devtest-labs/TOC.yml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -149,6 +149,8 @@
149149
href: devtest-lab-add-claimable-vm.md
150150
- name: Configure secrets
151151
href: devtest-lab-store-secrets-in-key-vault.md
152+
- name: Configure lab level secrets
153+
href: devtest-lab-configure-lab-level-secrets.md
152154
- name: Attach and detach data disks
153155
href: devtest-lab-attach-detach-data-disk.md
154156
- name: Define start order for lab VMs

articles/devtest-labs/devtest-lab-add-vm.md

Lines changed: 13 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -34,9 +34,20 @@ You need at least [user](devtest-lab-add-devtest-user.md#devtest-labs-user) acce
3434
- **Use a saved secret**: Select this checkbox to use a secret from Azure Key Vault instead of a password to access the VM. If you select this option, under **Secret**, select the secret to use from the dropdown list. For more information, see [Store secrets in a key vault](devtest-lab-store-secrets-in-key-vault.md).
3535
- **Password**: If you don't choose to use a secret, enter a VM password between 8 and 123 characters long.
3636
- **Save as default password**: Select this checkbox to save the password in the Key Vault associated with the lab.
37-
- **Virtual machine size**: Keep the default value for the base, or select **Change Size** to select different sizes.
38-
- **Hibernation**: Select **Enabled** to enable hibernation for this virtual machine. If you enable Hibernation, you also must select **Public IP** in the Advanced settings as Private and Shared IP are currently not supported if Hibernation is enabled.
37+
- **Virtual machine size**: Keep the default value for the base, or select **Change Size** to select different sizes. Here is how the default VM Size is selected:
38+
- If the **Configuration and policies** -> **Allowed virtual machine sizes** list has **All sizes** selected, then:
39+
- If the **Image Base** selected during VM creation has x64 architecture, then the default size selected is **D4s_v5**.
40+
- If the **Image Base** selected during VM creation has ARM64 architecture, then the default size selected is **D4pls_v5**.
41+
- If the **Configuration and policies** -> **Allowed virtual machine sizes** list only has limited **Selected sizes**, then:
42+
- If the **Image Base** selected during VM creation has x64 architecture and D4s_v5 VM size is selected in the **Allowed virtual machine sizes** list, then the default size selected is **D4s_v5**.
43+
- If the **Image Base** selected during VM creation has ARM64 architecture and D4pls_v5 VM size is selected in the **Allowed virtual machine sizes** list, then the default size selected is **D4pls_v5**.
44+
- If the **Image Base** selected during VM creation has x64 architecture but D4s_v5 VM size is not selected in the **Allowed virtual machine sizes** list, or if the **Image Base** selected during VM creation has ARM64 architecture but D4pls_v5 VM size is not selected in the **Allowed virtual machine sizes** list, then:
45+
- if a 4 core non-premium CPU size is available, then the first available 4 core non-premium CPU size is selected by default
46+
- if no 4 core non-premium CPU size is available, then the first available 4 core CPU size is selected by default
47+
- if no 4 core CPU size is available, then the first available CPU size is selected by default
48+
- **Allow hibernation**: Select this option to enable hibernation for the virtual machine. If you enable Hibernation, you also must select **Public IP** in the Advanced settings as Private and Shared IP are currently not supported if Hibernation is enabled.
3949
- **OS disk type**: Keep the default value for the base, or select a different option from the dropdown list.
50+
- **Security type**: Select **Trusted Launch** to enable it for Gen2 VMs. On selecting Trusted Launch When the options Secure boot, vTPM, and Integrity Monitoring appear, select the appropriate options for your deployment. For more information, see [Trusted Launch-enabled security features](https://learn.microsoft.com/azure/virtual-machines/trusted-launch#secure-boot).
4051
- **Artifacts**: This field shows the number of artifacts already configured for this VM base. Optionally, select **Add or Remove Artifacts** to select and configure artifacts to add to the VM.
4152

4253
:::image type="content" source="./media/devtest-lab-add-vm/portal-lab-vm-basic-settings.png" alt-text="Virtual machine basic settings page.":::
Lines changed: 48 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,48 @@
1+
---
2+
title: Configure Lab Level Secrets in Azure DevTest Labs
3+
description: Learn how to configure lab level secrets in Azure DevTest Labs.
4+
ms.topic: how-to
5+
ms.author: anishtrakru
6+
author: RoseHJM
7+
ms.date: 02/06/2025
8+
ms.custom: UpdateFrequency2
9+
---
10+
11+
# Configure Lab Level Secrets in Azure DevTest Labs
12+
13+
The lab level secrets in Azure DevTest Labs help streamline the creation and management of virtual machines (VMs). They are effective at reducing overhead on the lab users and can be leveraged while creating VMs, creating formulas, and for use by certain artifacts.
14+
15+
> [!IMPORTANT]
16+
> **Lab Level Secrets** is currently in preview in Azure DevTest Labs. For more information about the preview status, see the [Supplemental Terms of Use for Microsoft Azure Previews](https://azure.microsoft.com/support/legal/preview-supplemental-terms/). The document defines legal terms that apply to Azure features that are in beta, in preview, or otherwise not yet released into general availability.
17+
18+
Security and simplicity remain a top priority for platform engineers and lab users in the ever-evolving landscape of cloud computing. Azure DevTest Labs has traditionally provided capabilities for lab users such as using their own secrets or passwords to access the VMs. This approach burdens the lab user with the responsibility to create and manage their own secrets and passwords. In scenarios in which all lab users use the same secret or password to access the VMs within a lab, the process of creating and managing the same secret or password by each user becomes redundant. That’s where lab level secrets fill the gap - it allows the lab users to use centralized lab secrets to access the VMs within the lab. If the common secret or password used across the lab needs to be updated at a later point in time, then that can be achieved seamlessly. Additionally, lab level secrets can also be used while creating formulas and by certain artifacts that require use of secrets, passwords or PATs for their execution.
19+
20+
This article explains how to configure Lab Level Secrets in Azure DevTest Labs.
21+
22+
## Configure a lab level secret
23+
24+
### Prerequisite
25+
26+
You need at least [owner](devtest-lab-add-devtest-user.md#owner) or [contributor](devtest-lab-add-devtest-user.md#contributor) access to a lab in DevTest Labs to configure a lab level secret.
27+
28+
### Configure a lab level secret within a lab
29+
30+
1. Sign in to the [Azure portal](https://portal.azure.com).
31+
1. Search for **DevTest Labs**.
32+
1. From the list of labs, select the lab you want.
33+
1. Select **Configuration and policies** -> **Lab secrets**.
34+
1. On the **Lab secrets** page, select **Add**.
35+
36+
:::image type="content" source="./media/devtest-lab-add-vm/portal-lab-add-vm.png" alt-text="Screenshot of lab overview page showing add button." lightbox="./media/devtest-lab-add-vm/portal-lab-add-vm.png":::
37+
38+
1. On the **Create a lab secret** pane, provide the following information:
39+
- **Name**: Enter a name for the secret.
40+
- **Value**: Enter the value of the secret. You see this name in the drop-down list when creating a VM, formula, or while adding certain artifacts that require a token or password.
41+
- **Scope**:
42+
- **Formulas & virtual machines**: Select this option if you want to use the secret to access VMs.
43+
If you select this option, another option to use this secret as default password will become visible. Select **Use this secret as default password** to use this secret as the default password
44+
- **Artifacts**: Select this option if you want the secret to be used by certain artifacts.
45+
46+
:::image type="content" source="./media/devtest-lab-gen2-vm/dev-test-lab-gen-2-images.png" alt-text="Screenshot of list of available base images." lightbox="./media/devtest-lab-gen2-vm/dev-test-lab-gen-2-images.png":::
47+
48+
- Select **Create** to create the secret.

articles/devtest-labs/devtest-lab-gen2-vm.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -45,8 +45,9 @@ You need at least [user](devtest-lab-add-devtest-user.md#devtest-labs-user) acce
4545
- **Password**: If you don't choose to use a secret, enter a VM password between 8 and 123 characters long.
4646
- **Save as default password**: Select this checkbox to save the password in the Key Vault associated with the lab.
4747
- **Virtual machine size**: Keep the default value for the base, or select **Change Size** to select different sizes.
48-
- **Hibernation**: Select **Enabled** to enable hibernation for this virtual machine, or select **Disabled** to disable hibernation for this virtual machine. If you enable Hibernation, you also must select **Public IP** in the Advanced settings as Private and Shared IP are currently not supported if Hibernation is enabled.
48+
- **Allow hibernation**: Select this option to enable hibernation for the virtual machine. If you enable Hibernation, you also must select **Public IP** in the Advanced settings as Private and Shared IP are currently not supported if Hibernation is enabled.
4949
- **OS disk type**: Keep the default value for the base, or select a different option from the dropdown list.
50+
- **Security type**: Select **Trusted Launch**. When the options Secure boot, vTPM, and Integrity Monitoring appear, select the appropriate options for your deployment. For more information, see [Trusted Launch-enabled security features](https://learn.microsoft.com/azure/virtual-machines/trusted-launch#secure-boot).
5051
- **Artifacts**: This field shows the number of artifacts already configured for this VM base. Optionally, select **Add or Remove Artifacts** to select and configure artifacts to add to the VM.
5152

5253
:::image type="content" source="./media/devtest-lab-add-vm/portal-lab-vm-basic-settings.png" alt-text="Screenshot of virtual machine basic settings page." lightbox="./media/devtest-lab-add-vm/portal-lab-vm-basic-settings.png":::

articles/devtest-labs/devtest-lab-hibernate-vm.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -55,8 +55,9 @@ You need at least [user](devtest-lab-add-devtest-user.md#devtest-labs-user) acce
5555
- **Password**: If you don't choose to use a secret, enter a VM password between 8 and 123 characters long.
5656
- **Save as default password**: Select this checkbox to save the password in the Key Vault associated with the lab.
5757
- **Virtual machine size**: Keep the default value for the base, or select **Change Size** to select different sizes.
58-
- **Hibernation**: Select **Enabled** to enable hibernation for this virtual machine. If you enable Hibernation, you also must select **Public IP** in the Advanced settings as Private and Shared IP are currently not supported if Hibernation is enabled.
58+
- **Allow hibernation**: Select this option to enable hibernation for this virtual machine. Once you select Hibernation, you also must select **Public IP** in the Advanced settings as Private and Shared IP are currently not supported if Hibernation is enabled.
5959
- **OS disk type**: Keep the default value for the base, or select a different option from the dropdown list.
60+
- **Security type**: Select **Trusted Launch** to enable it for Gen2 VMs. On selecting Trusted Launch When the options Secure boot, vTPM, and Integrity Monitoring appear, select the appropriate options for your deployment. For more information, see [Trusted Launch-enabled security features](https://learn.microsoft.com/azure/virtual-machines/trusted-launch#secure-boot).
6061
- **Artifacts**: This field shows the number of artifacts already configured for this VM base. Optionally, select **Add or Remove Artifacts** to select and configure artifacts to add to the VM.
6162

6263
:::image type="content" source="./media/devtest-lab-add-vm/portal-lab-vm-basic-settings.png" alt-text="Screenshot showing virtual machine basic settings page.":::

0 commit comments

Comments
 (0)