Merge pull request #202526 from MikeRayMSFT/release-arc-data

Stage preview testing content.

Author: laurabren

articles/azure-arc/data/includes/azure-arc-data-preview-release.md

@@ -0,0 +1,38 @@
+---
+author: MikeRayMSFT
+ms.service: azure-arc
+ms.topic: include
+ms.date: 06/28/2022
+ms.author: mikeray
+---
+
+The current preview released on June 28, 2022.
+
+This preview is a test release.
+
+|Component|Value|
+|-----------|-----------|
+|Container images registry/repository |`mcr.microsoft.com/arcdata/preview`|
+|Container images tag |`v1.9.0_2022_07_12`|
+|CRD names and version|`datacontrollers.arcdata.microsoft.com`: v1beta1, v1 through v6<br/>`exporttasks.tasks.arcdata.microsoft.com`: v1beta1, v1, v2<br/>`kafkas.arcdata.microsoft.com`: v1beta1<br/>`monitors.arcdata.microsoft.com`: v1beta1, v1, v2<br/>`sqlmanagedinstances.sql.arcdata.microsoft.com`: v1beta1, v1 through v6<br/>`postgresqls.arcdata.microsoft.com`: v1beta1, v1beta2<br/>`sqlmanagedinstancerestoretasks.tasks.sql.arcdata.microsoft.com`: v1beta1, v1<br/>`failovergroups.sql.arcdata.microsoft.com`: v1beta1, v1beta2, v1<br/>`activedirectoryconnectors.arcdata.microsoft.com`: v1beta1, v1beta2<br/>|
+|Azure Resource Manager (ARM) API version|2022-03-01-preview (No change)|
+|`arcdata` Azure CLI extension version|1.4.3 ([Download](https://aka.ms/az-cli-arcdata-ext))|
+|Arc enabled Kubernetes helm chart extension version|1.2.19831003|
+|Arc Data extension for Azure Data Studio|1.3.1 ([Download](https://aka.ms/ads-arcdata-ext))|
+
+New for this release:
+
+- Miscellaneous
+  - Extended the disk metrics reported in monitoring dashboards to include more queue length stats and more counters for IOPS. All disks are in scope for data collection that start with `vd` or `sd` now.
+
+- Arc-enabled SQL Managed Instance
+  - Added buffer cache hit ratio to collectd and surface it in monitoring dashboards.
+  - Improvements to the formatting of the legends on some dashboards.
+  - Added process level CPU  and memory metrics to the monitoring dashboards for the SQL managed instance process.
+  - syncSecondaryToCommit property is now available to be viewed and edited in Azure portal and Azure Data Studio.
+  - Added ability to set the DNS name for the readableSecondaries service in Azure CLI and Azure portal.
+
+- Data controller
+  - Permissions required to deploy the Arc data controller have been reduced to a least-privilege level.
+  - When deployed via the Azure CLI, the Arc data controller is now installed via a K8s job that uses a helm chart to do the installation. There's no change to the user experience.
+

articles/azure-arc/data/preview-testing.md

@@ -0,0 +1,137 @@
+---
+title: Azure Arc-enabled data services - Pre-release testing
+description: Experience pre-release versions of Azure Arc-enabled data services
+author: twright-msft
+ms.author: twright
+ms.reviewer: mikeray
+services: azure-arc
+ms.service: azure-arc
+ms.subservice: azure-arc-data
+ms.date: 06/28/2022
+ms.topic: conceptual
+ms.custom: references_regions, devx-track-azurecli, event-tier1-build-2022
+#Customer intent: As a data professional, I want to validate upcoming releases.
+---
+
+# Pre-release testing
+
+To provide an opportunity for customers and partners to provide pre-release feedback, pre-release versions of Azure Arc-enabled data services are made available on a predictable schedule. This article describes how to install pre-release versions of Azure Arc-enabled data services and provide feedback to Microsoft.
+
+## Pre-release testing schedule
+
+Each month, Azure Arc-enabled data services is released on the second Tuesday of the month, commonly known as "Patch Tuesday".  The pre-release versions are made available on a predictable schedule in alignment with that release date.
+
+- 14 days before the release date, the *test* pre-release version is made available.
+- 7 days before the release date, the *preview* pre-release version is made available.
+
+The main difference between the test and preview pre-release versions is usually just quality and stability, but in some exceptional cases there may be new features introduced in between the test and preview releases.
+
+Normally, pre-release version binaries are available around 10:00 AM Pacific Time. Documentation follows later in the day.
+
+## Artifacts for a pre-release version
+
+Pre-release versions simultaneously release with artifacts, which are designed to work together:
+
+- Container images hosted on the Microsoft Container Registry (MCR)
+  - `mcr.microsoft.com/arcdata/preview` is the repository that hosts the **preview** pre-release builds
+  - `mcr.microsoft.com/arcdata/test` is the repository that hosts the **test** pre-release builds
+  
+    > [!NOTE]
+    > `mcr.microsoft.com/arcdata/` will continue to be the repository that hosts the final release builds.
+    >Pre-release images will be tagged in a format similar to release images, but with the addition of a git commit ID appended to the end:
+    > - Release version tag example: v1.0.0_2021-06-30
+    > - Pre-release version tag example: v1.8.0_2022-06-07_5ba6b837
+
+  - Azure CLI extension hosted on Azure Blob Storage
+  - Azure Data Studio extension hosted on Azure Blob Storage
+
+In addition to the above installable artifacts, the following are updated in Azure as needed:
+
+- New version of ARM API (occasionally)
+- New Azure portal accessible via a special URL query string parameter (see below for details)
+- New Arc-enabled Kubernetes extension version for Arc-enabled data services (applies to direct connectivity mode only)
+- Documentation updates on this page describing the location and details of the above artifacts and the new features available and any pre-release "read me" documentation
+
+## Installing pre-release versions
+
+### Install prerequisite tools
+
+To install a pre-release version, follow these pre-requisite instructions:
+
+If you use the Azure CLI extension:
+
+- Uninstall the Azure CLI extension (`az extension remove -n arcdata`).
+- Download the latest pre-release Azure CLI extension `.whl` file from [https://aka.ms/az-cli-arcdata-ext](https://aka.ms/az-cli-arcdata-ext).
+- Install the latest pre-release Azure CLI extension (`az extension add -s <location of downloaded .whl file>`).
+
+If you use the Azure Data Studio extension to install:
+
+- Uninstall the Azure Data Studio extension. Select the Extensions panel and select on the **Azure Arc** extension, select **Uninstall**.
+- Download the latest pre-release Azure Data Studio extension .vsix file from [https://aka.ms/ads-arcdata-ext](https://aka.ms/ads-arcdata-ext).
+- Install the extension by choosing File -> Install Extension from VSIX package and then browsing to the download location of the .vsix file.
+
+### Install using Azure CLI
+
+> [!NOTE]
+> Deploying pre-release builds using direct connectivity mode from Azure CLI is not supported.
+
+#### Indirect connectivity mode
+
+If you install using the Azure CLI, follow the instructions to [create a custom configuration profile](create-custom-configuration-template.md). Once created, edit this custom configuration profile file enter the `docker` property values as required based on the information provided in the version history table on this page.
+
+For example:
+
+```json
+
+        "docker": {
+            "registry": "mcr.microsoft.com",
+            "repository": "arcdata/test",
+            "imageTag": "v1.8.0_2022-06-07_5ba6b837",
+            "imagePullPolicy": "Always"
+        },
+```
+
+Once the file is edited, use the command `az arcdata dc create` as explained in [create a custom configuration profile](create-custom-configuration-template.md).
+
+### Install using Azure Data Studio
+
+> [!NOTE]
+> Deploying pre-release builds using direct connectivity mode from Azure Data Studio is not supported.
+
+#### Indirect connectivity mode
+
+If you use Azure Data Studio to install, complete the data controller deployment wizard as normal except click on **Script to notebook** at the end instead of **Deploy**. In the generated notebook, edit the `Set variables` cell to *add* the following lines:
+
+```python
+# choose between arcdata/test or arcdata/preview as appropriate
+os.environ["AZDATA_DOCKER_REPOSITORY"] = "arcdata/test"
+os.environ["AZDATA_DOCKER_TAG"] = "v1.8.0_2022-06-07_5ba6b837"
+```
+
+Run the notebook by clicking **Run All**.
+
+### Install using Azure portal
+
+Follow the instructions to [Arc-enabled the Kubernetes cluster](create-data-controller-direct-prerequisites.md) as normal.
+
+Open the Azure portal by using this special URL: [https://portal.azure.com/?Microsoft_Azure_HybridData_Platform=BugBash](https://portal.azure.com/?Microsoft_Azure_HybridData_Platform=BugBash).
+
+Follow the instructions to [Create the Azure Arc data controller from Azure portal - Direct connectivity mode](create-data-controller-direct-azure-portal.md) except that when choosing a deployment profile, select **Custom template** in the **Kubernetes configuration template** drop-down.  Set the repository to either `arcdata/test` or `arcdata/preview` as appropriate and enter the desired tag in the **Image tag** field.  Fill out the rest of the custom cluster configuration template fields as normal.
+
+Complete the rest of the wizard as normal.
+
+When you deploy with this method, the most recent pre-release version will always be used.
+
+## Pre-release version history
+
+### Current preview
+
+[!INCLUDE [azure-arc-data-preview-release](includes/azure-arc-data-preview-release.md)]
+
+## Provide feedback
+
+At this time, pre-release testing is supported for certain customers and partners that have established agreements with Microsoft. Participants have points of contact on the product engineering team. Email your points of contact with any issues that are found during pre-release testing.
+
+## Next steps
+
+[Release notes - Azure Arc-enabled data services](release-notes.md)

articles/azure-arc/data/toc.yml

@@ -138,7 +138,7 @@ items:
           items:
             - name: Configure
               href: configure-managed-instance.md
-            - name: Monitoring, log analytics, billing information, (portal)
+            - name: Monitor, log analytics, & billing information - portal
               href: monitoring-log-analytics-azure-portal-managed-instance.md
             - name: Reserved capacity
               href: reserved-capacity-overview.md
@@ -236,7 +236,7 @@ items:
       items:
         - name: Manage
           items:
-            - name: Backup & restore
+            - name: Back up & restore
               href: backup-restore-postgresql-hyperscale.md
             - name: Change PostgreSQL port
               href: change-postgresql-port.md
@@ -280,3 +280,5 @@ items:
   items:
     - name: Azure Arc jumpstart
       href: https://azurearcjumpstart.io
+    - name: Pre-release testing
+      href: preview-testing.md