Skip to content

Commit 26ea314

Browse files
authored
Merge pull request #232709 from sdgilley/sdg-preview-ga
remove (preview)s for compute instance
2 parents 67a77b6 + 123c0eb commit 26ea314

9 files changed

+25
-53
lines changed

articles/machine-learning/concept-compute-instance.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -42,9 +42,9 @@ A compute instance is a fully managed cloud-based workstation optimized for your
4242

4343
* Secure your compute instance with **[No public IP](./how-to-secure-training-vnet.md)**.
4444
* The compute instance is also a secure training compute target similar to [compute clusters](how-to-create-attach-compute-cluster.md), but it's single node.
45-
* You can [create a compute instance](how-to-create-manage-compute-instance.md?tabs=python#create) yourself, or an administrator can **[create a compute instance on your behalf](how-to-create-manage-compute-instance.md?tabs=python#create-on-behalf-of-preview)**.
45+
* You can [create a compute instance](how-to-create-manage-compute-instance.md?tabs=python#create) yourself, or an administrator can **[create a compute instance on your behalf](how-to-create-manage-compute-instance.md?tabs=python#create-on-behalf-of)**.
4646
* You can also **[use a setup script](how-to-customize-compute-instance.md)** for an automated way to customize and configure the compute instance as per your needs.
47-
* To save on costs, **[create a schedule](how-to-create-manage-compute-instance.md#schedule-automatic-start-and-stop)** to automatically start and stop the compute instance, or [enable idle shutdown](how-to-create-manage-compute-instance.md#enable-idle-shutdown-preview)
47+
* To save on costs, **[create a schedule](how-to-create-manage-compute-instance.md#schedule-automatic-start-and-stop)** to automatically start and stop the compute instance, or [enable idle shutdown](how-to-create-manage-compute-instance.md#enable-idle-shutdown)
4848

4949

5050
## Tools and environments
@@ -72,14 +72,14 @@ Following tools and environments are already installed on the compute instance:
7272
|----|:----:|
7373
|R kernel||
7474

75-
You can [Add RStudio or Posit Workbench (formerly RStudio Workbench)](how-to-create-manage-compute-instance.md#add-custom-applications-such-as-rstudio-or-posit-workbench-preview) when you create the instance.
75+
You can [Add RStudio or Posit Workbench (formerly RStudio Workbench)](how-to-create-manage-compute-instance.md#add-custom-applications-such-as-rstudio-or-posit-workbench) when you create the instance.
7676

7777
|**PYTHON** tools & environments|Details|
7878
|----|----|
7979
|Anaconda Python||
8080
|Jupyter and extensions||
8181
|Jupyterlab and extensions||
82-
[Azure Machine Learning SDK for Python](https://aka.ms/sdk-v2-install)</br>from PyPI|Includes most of the azureml extra packages. To see the full list, [open a terminal window on your compute instance](how-to-access-terminal.md) and run <br/> `conda list -n azureml_py36 azureml*` |
82+
[Azure Machine Learning SDK for Python](https://aka.ms/sdk-v2-install)</br>from PyPI|Includes azure-ai-ml and many common azure extra packages. To see the full list, [open a terminal window on your compute instance](how-to-access-terminal.md) and run <br/> `conda list -n azureml_py310_sdkv2 ^azure` |
8383
|Other PyPI packages|`jupytext`</br>`tensorboard`</br>`nbconvert`</br>`notebook`</br>`Pillow`|
8484
|Conda packages|`cython`</br>`numpy`</br>`ipykernel`</br>`scikit-learn`</br>`matplotlib`</br>`tqdm`</br>`joblib`</br>`nodejs`|
8585
|Deep learning packages|`PyTorch`</br>`TensorFlow`</br>`Keras`</br>`Horovod`</br>`MLFlow`</br>`pandas-ml`</br>`scrapbook`|
@@ -108,9 +108,9 @@ Follow the steps in the [Quickstart: Create workspace resources you need to get
108108

109109
For more options, see [create a new compute instance](how-to-create-manage-compute-instance.md?tabs=azure-studio#create).
110110

111-
As an administrator, you can **[create a compute instance for others in the workspace (preview)](how-to-create-manage-compute-instance.md#create-on-behalf-of-preview)**.
111+
As an administrator, you can **[create a compute instance for others in the workspace](how-to-create-manage-compute-instance.md#create-on-behalf-of)**.
112112

113-
You can also **[use a setup script (preview)](how-to-customize-compute-instance.md)** for an automated way to customize and configure the compute instance.
113+
You can also **[use a setup script](how-to-customize-compute-instance.md)** for an automated way to customize and configure the compute instance.
114114

115115
Other ways to create a compute instance:
116116
* Directly from the integrated notebooks experience.
@@ -131,13 +131,13 @@ A compute instance:
131131

132132
* Has a job queue.
133133
* Runs jobs securely in a virtual network environment, without requiring enterprises to open up SSH port. The job executes in a containerized environment and packages your model dependencies in a Docker container.
134-
* Can run multiple small jobs in parallel (preview). One job per core can run in parallel while the rest of the jobs are queued.
134+
* Can run multiple small jobs in parallel. One job per core can run in parallel while the rest of the jobs are queued.
135135
* Supports single-node multi-GPU [distributed training](how-to-train-distributed-gpu.md) jobs
136136

137137
You can use compute instance as a local inferencing deployment target for test/debug scenarios.
138138

139139
> [!TIP]
140-
> The compute instance has 120GB OS disk. If you run out of disk space and get into an unusable state, please clear at least 5 GB disk space on OS disk (mounted on /) through the compute instance terminal by removing files/folders and then do `sudo reboot`. Temporary disk will be freed after restart; you do not need to clear space on temp disk manually. To access the terminal go to compute list page or compute instance details page and click on **Terminal** link. You can check available disk space by running `df -h` on the terminal. Clear at least 5 GB space before doing `sudo reboot`. Please do not stop or restart the compute instance through the Studio until 5 GB disk space has been cleared. Auto shutdowns, including scheduled start or stop as well as idle shutdowns(preview), will not work if the CI disk is full.
140+
> The compute instance has 120GB OS disk. If you run out of disk space and get into an unusable state, please clear at least 5 GB disk space on OS disk (mounted on /) through the compute instance terminal by removing files/folders and then do `sudo reboot`. Temporary disk will be freed after restart; you do not need to clear space on temp disk manually. To access the terminal go to compute list page or compute instance details page and click on **Terminal** link. You can check available disk space by running `df -h` on the terminal. Clear at least 5 GB space before doing `sudo reboot`. Please do not stop or restart the compute instance through the Studio until 5 GB disk space has been cleared. Auto shutdowns, including scheduled start or stop as well as idle shutdowns, will not work if the CI disk is full.
141141
142142
## Next steps
143143

articles/machine-learning/concept-compute-target.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -67,7 +67,7 @@ When created, these compute resources are automatically part of your workspace,
6767
> [!NOTE]
6868
> To avoid charges when the compute is idle:
6969
> * For compute *cluster* make sure the minimum number of nodes is set to 0.
70-
> * For a compute *instance*, [enable idle shutdown](how-to-create-manage-compute-instance.md#enable-idle-shutdown-preview).
70+
> * For a compute *instance*, [enable idle shutdown](how-to-create-manage-compute-instance.md#enable-idle-shutdown).
7171
7272
### Supported VM series and sizes
7373

articles/machine-learning/concept-plan-manage-cost.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -61,7 +61,7 @@ When you create resources for an Azure Machine Learning workspace, resources for
6161
* [Application Insights](https://azure.microsoft.com/pricing/details/monitor?WT.mc_id=costmanagementcontent_docsacmhorizontal_-inproduct-learn)
6262

6363
When you create a [compute instance](concept-compute-instance.md), the VM stays on so it is available for your work.
64-
* [Enable idle shutdown (preview)](how-to-create-manage-compute-instance.md#enable-idle-shutdown-preview) to save on cost when the VM has been idle for a specified time period.
64+
* [Enable idle shutdown (preview)](how-to-create-manage-compute-instance.md#enable-idle-shutdown) to save on cost when the VM has been idle for a specified time period.
6565
* Or [set up a schedule](how-to-create-manage-compute-instance.md#schedule-automatic-start-and-stop) to automatically start and stop the compute instance (preview) to save cost when you aren't planning to use it.
6666

6767

articles/machine-learning/how-to-access-terminal.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -43,7 +43,7 @@ To access the terminal:
4343

4444
In addition to the steps above, you can also access the terminal from:
4545

46-
* RStudio or Posit Workbench (formerly RStudio Workbench) (See [Add custom applications such as RStudio or Posit Workbench)](how-to-create-manage-compute-instance.md?tabs=python#add-custom-applications-such-as-rstudio-or-posit-workbench-preview)): Select the **Terminal** tab on top left.
46+
* RStudio or Posit Workbench (formerly RStudio Workbench) (See [Add custom applications such as RStudio or Posit Workbench)](how-to-create-manage-compute-instance.md?tabs=python#add-custom-applications-such-as-rstudio-or-posit-workbench)): Select the **Terminal** tab on top left.
4747
* Jupyter Lab: Select the **Terminal** tile under the **Other** heading in the Launcher tab.
4848
* Jupyter: Select **New>Terminal** on top right in the Files tab.
4949
* SSH to the machine, if you enabled SSH access when the compute instance was created.
@@ -69,7 +69,7 @@ To integrate Git with your Azure Machine Learning workspace, see [Git integrati
6969

7070
Or you can install packages directly in Jupyter Notebook, RStudio, or Posit Workbench (formerly RStudio Workbench):
7171

72-
* RStudio or Posit Workbench(see [Add custom applications such as RStudio or Posit Workbench](how-to-create-manage-compute-instance.md#add-custom-applications-such-as-rstudio-or-posit-workbench-preview)): Use the **Packages** tab on the bottom right, or the **Console** tab on the top left.
72+
* RStudio or Posit Workbench(see [Add custom applications such as RStudio or Posit Workbench](how-to-create-manage-compute-instance.md#add-custom-applications-such-as-rstudio-or-posit-workbench)): Use the **Packages** tab on the bottom right, or the **Console** tab on the top left.
7373
* Python: Add install code and execute in a Jupyter Notebook cell.
7474

7575
> [!NOTE]

articles/machine-learning/how-to-configure-environment.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -149,7 +149,7 @@ Create one anytime from within your Azure Machine Learning workspace. Provide ju
149149
To learn more about compute instances, including how to install packages, see [Create and manage an Azure Machine Learning compute instance](how-to-create-manage-compute-instance.md).
150150

151151
> [!TIP]
152-
> To prevent incurring charges for an unused compute instance, [enable idle shutdown](how-to-create-manage-compute-instance.md#enable-idle-shutdown-preview).
152+
> To prevent incurring charges for an unused compute instance, [enable idle shutdown](how-to-create-manage-compute-instance.md#enable-idle-shutdown).
153153

154154
In addition to a Jupyter Notebook server and JupyterLab, you can use compute instances in the [integrated notebook feature inside of Azure Machine Learning studio](how-to-run-jupyter-notebooks.md).
155155

articles/machine-learning/how-to-create-manage-compute-instance.md

Lines changed: 10 additions & 38 deletions
Original file line numberDiff line numberDiff line change
@@ -25,17 +25,12 @@ Learn how to create and manage a [compute instance](concept-compute-instance.md)
2525

2626
Use a compute instance as your fully configured and managed development environment in the cloud. For development and testing, you can also use the instance as a [training compute target](concept-compute-target.md#training-compute-targets). A compute instance can run multiple jobs in parallel and has a job queue. As a development environment, a compute instance can't be shared with other users in your workspace.
2727

28-
> [!IMPORTANT]
29-
> Items marked (preview) in this article are currently in public preview.
30-
> The preview version is provided without a service level agreement, and it's not recommended for production workloads. Certain features might not be supported or might have constrained capabilities.
31-
> For more information, see [Supplemental Terms of Use for Microsoft Azure Previews](https://azure.microsoft.com/support/legal/preview-supplemental-terms/).
32-
3328
In this article, you learn how to:
3429

3530
* [Create](#create) a compute instance
3631
* [Manage](#manage) (start, stop, restart, delete) a compute instance
3732
* [Create a schedule](#schedule-automatic-start-and-stop) to automatically start and stop the compute instance
38-
* [Enable idle shutdown](#enable-idle-shutdown-preview)
33+
* [Enable idle shutdown](#enable-idle-shutdown)
3934

4035
You can also [use a setup script](how-to-customize-compute-instance.md) to create the compute instance with your own custom environment.
4136

@@ -114,12 +109,12 @@ Where the file *create-instance.yml* is:
114109
1. Select **Create** unless you want to configure advanced settings for the compute instance.
115110
1. <a name="advanced-settings"></a> Select **Next: Advanced Settings** if you want to:
116111

117-
* Enable idle shutdown (preview). Configure a compute instance to automatically shut down if it's inactive. For more information, see [enable idle shutdown](#enable-idle-shutdown-preview).
112+
* Enable idle shutdown. Configure a compute instance to automatically shut down if it's inactive. For more information, see [enable idle shutdown](#enable-idle-shutdown).
118113
* Add schedule. Schedule times for the compute instance to automatically start and/or shut down. See [schedule details](#schedule-automatic-start-and-stop) below.
119114
* Enable SSH access. Follow the [detailed SSH access instructions](#enable-ssh-access) below.
120115
* Enable virtual network. Specify the **Resource group**, **Virtual network**, and **Subnet** to create the compute instance inside an Azure Virtual Network (vnet). You can also select __No public IP__ to prevent the creation of a public IP address, which requires a private link workspace. You must also satisfy these [network requirements](./how-to-secure-training-vnet.md) for virtual network setup.
121-
* Assign the computer to another user. For more about assigning to other users, see [Create on behalf of](#create-on-behalf-of-preview)
122-
* Provision with a setup script (preview) - for more information about how to create and use a setup script, see [Customize the compute instance with a script](how-to-customize-compute-instance.md).
116+
* Assign the computer to another user. For more about assigning to other users, see [Create on behalf of](#create-on-behalf-of)
117+
* Provision with a setup script - for more information about how to create and use a setup script, see [Customize the compute instance with a script](how-to-customize-compute-instance.md).
123118

124119
You can also create a compute instance with an [Azure Resource Manager template](https://github.com/Azure/azure-quickstart-templates/tree/master/quickstarts/microsoft.machinelearningservices/machine-learning-compute-create-computeinstance).
125120

@@ -136,12 +131,7 @@ SSH access is disabled by default. SSH access can't be changed after creation.
136131

137132
---
138133

139-
## Create on behalf of (preview)
140-
141-
> [!IMPORTANT]
142-
> Items marked (preview) below are currently in public preview.
143-
> The preview version is provided without a service level agreement, and it's not recommended for production workloads. Certain features might not be supported or might have constrained capabilities.
144-
> For more information, see [Supplemental Terms of Use for Microsoft Azure Previews](https://azure.microsoft.com/support/legal/preview-supplemental-terms/).
134+
## Create on behalf of
145135

146136
As an administrator, you can create a compute instance on behalf of a data scientist and assign the instance to them with:
147137

@@ -166,12 +156,7 @@ The data scientist can start, stop, and restart the compute instance. They can u
166156
* Posit Workbench (formerly RStudio Workbench)
167157
* Integrated notebooks
168158

169-
## Enable idle shutdown (preview)
170-
171-
> [!IMPORTANT]
172-
> Items marked (preview) below are currently in public preview.
173-
> The preview version is provided without a service level agreement, and it's not recommended for production workloads. Certain features might not be supported or might have constrained capabilities.
174-
> For more information, see [Supplemental Terms of Use for Microsoft Azure Previews](https://azure.microsoft.com/support/legal/preview-supplemental-terms/).
159+
## Enable idle shutdown
175160

176161
To avoid getting charged for a compute instance that is switched on but inactive, you can configure when to shut down your compute instance due to inactivity.
177162

@@ -186,15 +171,7 @@ Activity on custom applications installed on the compute instance isn't consider
186171

187172
Also, if a compute instance has already been idle for a certain amount of time, if idle shutdown settings are updated to an amount of time shorter than the current idle duration, the idle time clock will be reset to 0. For example, if the compute instance has already been idle for 20 minutes, and the shutdown settings are updated to 15 minutes, the idle time clock will be reset to 0.
188173

189-
Use **Manage preview features** to access this feature.
190-
191-
1. In the workspace toolbar, select the **Manage preview features** image.
192-
1. Scroll down until you see **Configure auto-shutdown for idle compute instances**.
193-
1. Toggle the switch to enable the feature.
194-
195-
:::image type="content" source="media/how-to-create-manage-compute-instance/enable-preview.png" alt-text="Screenshot: Enable auto-shutdown.":::
196-
197-
Once enabled, the setting can be configured during compute instance creation or for existing compute instances via the following interfaces:
174+
The setting can be configured during compute instance creation or for existing compute instances via the following interfaces:
198175

199176
# [Python SDK](#tab/python)
200177

@@ -328,7 +305,7 @@ You can also create your own custom Azure policy. For example, if the below poli
328305

329306
Define multiple schedules for auto-shutdown and auto-start. For instance, create a schedule to start at 9 AM and stop at 6 PM from Monday-Thursday, and a second schedule to start at 9 AM and stop at 4 PM for Friday. You can create a total of four schedules per compute instance.
330307

331-
Schedules can also be defined for [create on behalf of](#create-on-behalf-of-preview) compute instances. You can create a schedule that creates the compute instance in a stopped state. Stopped compute instances are useful when you create a compute instance on behalf of another user.
308+
Schedules can also be defined for [create on behalf of](#create-on-behalf-of) compute instances. You can create a schedule that creates the compute instance in a stopped state. Stopped compute instances are useful when you create a compute instance on behalf of another user.
332309

333310
Prior to a scheduled shutdown, users will see a notification alerting them that the Compute Instance is about to shut down. At that point, the user can choose to dismiss the upcoming shutdown event, if for example they are in the middle of using their Compute Instance.
334311

@@ -582,12 +559,7 @@ az login --identity --username $DEFAULT_IDENTITY_CLIENT_ID
582559
> [!NOTE]
583560
> You cannot use ```azcopy``` when trying to use managed identity. ```azcopy login --identity``` will not work.
584561

585-
## Add custom applications such as RStudio or Posit Workbench (preview)
586-
587-
> [!IMPORTANT]
588-
> Items marked (preview) below are currently in public preview.
589-
> The preview version is provided without a service level agreement, and it's not recommended for production workloads. Certain features might not be supported or might have constrained capabilities.
590-
> For more information, see [Supplemental Terms of Use for Microsoft Azure Previews](https://azure.microsoft.com/support/legal/preview-supplemental-terms/).
562+
## Add custom applications such as RStudio or Posit Workbench
591563

592564
You can set up other applications, such as RStudio, or Posit Workbench (formerly RStudio Workbench), when creating a compute instance. Follow these steps in studio to set up a custom application on your compute instance
593565

@@ -753,7 +725,7 @@ For each compute instance in a workspace that you created (or that was created f
753725
* SSH into compute instance. SSH access is disabled by default but can be enabled at compute instance creation time. SSH access is through public/private key mechanism. The tab will give you details for SSH connection such as IP address, username, and port number. In a virtual network deployment, disabling SSH prevents SSH access from public internet, you can still SSH from within virtual network using private IP address of compute instance node and port 22.
754726
* Select the compute name to:
755727
* View details about a specific compute instance such as IP address, and region.
756-
* Create or modify the schedule for starting and stopping the compute instance (preview). Scroll down to the bottom of the page to edit the schedule.
728+
* Create or modify the schedule for starting and stopping the compute instance. Scroll down to the bottom of the page to edit the schedule.
757729

758730
---
759731

0 commit comments

Comments
 (0)