Skip to content

Commit dc5967c

Browse files
Merge pull request #208261 from Blackmist/v1-v2
moving v1 articles to v1 folder
2 parents be86aef + 87c468f commit dc5967c

File tree

7 files changed

+34
-19
lines changed

7 files changed

+34
-19
lines changed

articles/machine-learning/.openpublishing.redirection.machine-learning.json

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,20 @@
11
{
22
"redirections": [
3+
{
4+
"source_path_from_root": "/articles/machine-learning/how-to-troubleshoot-prebuilt-docker-image-inference.md",
5+
"redirect_url": "/azure/machine-learning/v1/how-to-troubleshoot-prebuilt-docker-image-inference",
6+
"redirect_document_id": true
7+
},
8+
{
9+
"source_path_from_root": "/articles/machine-learning/how-to-extend-prebuilt-docker-image-inference.md",
10+
"redirect_url": "/azure/machine-learning/v1/how-to-extend-prebuilt-docker-image-inference",
11+
"redirect_document_id": true
12+
},
13+
{
14+
"source_path_from_root": "/articles/machine-learning/how-to-prebuilt-docker-images-inference-python-extensibility.md",
15+
"redirect_url": "/azure/machine-learning/v1/how-to-prebuilt-docker-images-inference-python-extensibility",
16+
"redirect_document_id": true
17+
},
318
{
419
"source_path_from_root": "/articles/machine-learning/concept-optimize-data-processing.md",
520
"redirect_url": "/azure/machine-learning/concept-data",

articles/machine-learning/how-to-extend-prebuilt-docker-image-inference.md renamed to articles/machine-learning/v1/how-to-extend-prebuilt-docker-image-inference.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ ms.custom: deploy, docker, prebuilt
1515

1616
# Extend a prebuilt Docker image
1717

18-
In some cases, the [prebuilt Docker images for model inference](concept-prebuilt-docker-images-inference.md) and [extensibility](./how-to-prebuilt-docker-images-inference-python-extensibility.md) solutions for Azure Machine Learning may not meet your inference service needs.
18+
In some cases, the [prebuilt Docker images for model inference](../concept-prebuilt-docker-images-inference.md) and [extensibility](./how-to-prebuilt-docker-images-inference-python-extensibility.md) solutions for Azure Machine Learning may not meet your inference service needs.
1919

2020
In this case, you can use a Dockerfile to create a new image, using one of the prebuilt images as the starting point. By extending from an existing prebuilt Docker image, you can use the Azure Machine Learning network stack and libraries without creating an image from scratch.
2121

@@ -26,7 +26,7 @@ Using a Dockerfile allows for full customization of the image before deployment.
2626
The main tradeoff for this approach is that an extra image build will take place during deployment, which slows down the deployment process. If you can use the [Python package extensibility](./how-to-prebuilt-docker-images-inference-python-extensibility.md) method, deployment will be faster.
2727
## Prerequisites
2828

29-
* An Azure Machine Learning workspace. For a tutorial on creating a workspace, see [Get started with Azure Machine Learning](quickstart-create-resources.md).
29+
* An Azure Machine Learning workspace. For a tutorial on creating a workspace, see [Get started with Azure Machine Learning](../quickstart-create-resources.md).
3030
* Familiarity with authoring a [Dockerfile](https://docs.docker.com/engine/reference/builder/).
3131
* Either a local working installation of [Docker](https://www.docker.com/), including the `docker` CLI, **OR** an Azure Container Registry (ACR) associated with your Azure Machine Learning workspace.
3232

@@ -53,7 +53,7 @@ docker build -f <above dockerfile> -t <image_name>:<tag> .
5353
> [!TIP]
5454
> More details about `docker build` can be found here in the [Docker documentation](https://docs.docker.com/engine/reference/commandline/build/).
5555
56-
If the `docker build` command isn't available locally, use the Azure Container Registry ACR for your Azure Machine Learning Workspace to build the Docker image in the cloud. For more information, see [Tutorial: Build and deploy container images with Azure Container Registry](../container-registry/container-registry-tutorial-quick-task.md).
56+
If the `docker build` command isn't available locally, use the Azure Container Registry ACR for your Azure Machine Learning Workspace to build the Docker image in the cloud. For more information, see [Tutorial: Build and deploy container images with Azure Container Registry](/azure/container-registry/container-registry-tutorial-quick-task).
5757

5858
> [!IMPORTANT]
5959
> Microsoft recommends that you first validate that your Dockerfile works locally before trying to create a custom base image via Azure Container Registry.
@@ -144,8 +144,8 @@ ENV AZUREML_MODEL_DIR=/var/azureml-app/azureml-models
144144

145145
To use a Dockerfile with the Azure Machine Learning Python SDK, see the following documents:
146146

147-
* [Use your own local Dockerfile](how-to-use-environments.md#use-your-own-dockerfile)
148-
* [Use a pre-built Docker image and create a custom base image](how-to-use-environments.md#use-a-prebuilt-docker-image)
147+
* [Use your own local Dockerfile](../how-to-use-environments.md#use-your-own-dockerfile)
148+
* [Use a pre-built Docker image and create a custom base image](../how-to-use-environments.md#use-a-prebuilt-docker-image)
149149

150150
To learn more about deploying a model, see [How to deploy a model](how-to-deploy-and-where.md).
151151

articles/machine-learning/how-to-prebuilt-docker-images-inference-python-extensibility.md renamed to articles/machine-learning/v1/how-to-prebuilt-docker-images-inference-python-extensibility.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -15,9 +15,9 @@ ms.custom: deploy, docker, prebuilt, sdkv1, event-tier1-build-2022
1515

1616
# Python package extensibility for prebuilt Docker images (preview)
1717

18-
[!INCLUDE [sdk v1](../../includes/machine-learning-sdk-v1.md)]
18+
[!INCLUDE [sdk v1](../../../includes/machine-learning-sdk-v1.md)]
1919

20-
The [prebuilt Docker images for model inference](concept-prebuilt-docker-images-inference.md) contain packages for popular machine learning frameworks. There are two methods that can be used to add Python packages __without rebuilding the Docker image__:
20+
The [prebuilt Docker images for model inference](../concept-prebuilt-docker-images-inference.md) contain packages for popular machine learning frameworks. There are two methods that can be used to add Python packages __without rebuilding the Docker image__:
2121

2222
* [Dynamic installation](#dynamic): This approach uses a [requirements](https://pip.pypa.io/en/stable/cli/pip_install/#requirements-file-format) file to automatically restore Python packages when the Docker container boots.
2323

@@ -32,8 +32,8 @@ The [prebuilt Docker images for model inference](concept-prebuilt-docker-images-
3232
3333
## Prerequisites
3434

35-
* An Azure Machine Learning workspace. For a tutorial on creating a workspace, see [Get started with Azure Machine Learning](quickstart-create-resources.md).
36-
* Familiarity with using Azure Machine Learning [environments](how-to-use-environments.md).
35+
* An Azure Machine Learning workspace. For a tutorial on creating a workspace, see [Get started with Azure Machine Learning](../quickstart-create-resources.md).
36+
* Familiarity with using Azure Machine Learning [environments](../how-to-use-environments.md).
3737
* Familiarity with [Where and how to deploy models](how-to-deploy-and-where.md) with Azure Machine Learning.
3838

3939
<a id="dynamic"></a>
@@ -46,7 +46,7 @@ To extend your prebuilt docker container image through a requirements.txt, follo
4646

4747
1. Create a `requirements.txt` file alongside your `score.py` script.
4848
2. Add **all** of your required packages to the `requirements.txt` file.
49-
3. Set the `AZUREML_EXTRA_REQUIREMENTS_TXT` environment variable in your Azure Machine Learning [environment](how-to-use-environments.md) to the location of `requirements.txt` file.
49+
3. Set the `AZUREML_EXTRA_REQUIREMENTS_TXT` environment variable in your Azure Machine Learning [environment](../how-to-use-environments.md) to the location of `requirements.txt` file.
5050

5151
Once deployed, the packages will automatically be restored for your score script.
5252

@@ -152,7 +152,7 @@ Here are some things that may cause this problem:
152152
| Solution | Create a `requirements.txt` that installs the specified packages when the container starts. | Create a local Python environment with all of the dependencies. Mount this directory into container at runtime. |
153153
| Package Installation | No extra installation (assuming pip already installed) | Virtual environment or conda environment installation. |
154154
| Virtual environment Setup | No extra setup of virtual environment required, as users can pull the current local user environment with pip freeze as needed to create the `requirements.txt`. | Need to set up a clean virtual environment, may take extra steps depending on the current user local environment. |
155-
| [Debugging](how-to-inference-server-http.md) | Easy to set up and debug server, since dependencies are clearly listed. | Unclean virtual environment could cause problems when debugging of server. For example, it may not be clear if errors come from the environment or user code. |
155+
| [Debugging](../how-to-inference-server-http.md) | Easy to set up and debug server, since dependencies are clearly listed. | Unclean virtual environment could cause problems when debugging of server. For example, it may not be clear if errors come from the environment or user code. |
156156
| Consistency during scaling out | Not consistent as dependent on external PyPi packages and users pinning their dependencies. These external downloads could be flaky. | Relies solely on user environment, so no consistency issues. |
157157

158158
* Why are my `requirements.txt` and mounted dependencies directory not found in the container?
@@ -166,7 +166,7 @@ Here are some things that may cause this problem:
166166

167167
## Best Practices
168168

169-
* Refer to the [Load registered model](./v1/how-to-deploy-advanced-entry-script.md#load-registered-models) docs. When you register a model directory, don't include your scoring script, your mounted dependencies directory, or `requirements.txt` within that directory.
169+
* Refer to the [Load registered model](how-to-deploy-advanced-entry-script.md#load-registered-models) docs. When you register a model directory, don't include your scoring script, your mounted dependencies directory, or `requirements.txt` within that directory.
170170

171171

172172
* For more information on how to load a registered or local model, see [Where and how to deploy](how-to-deploy-and-where.md?tabs=azcli#define-a-dummy-entry-script).
@@ -180,6 +180,6 @@ For example, if both the requirements.txt and score script is in **my_folder**,
180180

181181
## Next steps
182182

183-
To learn more about deploying a model, see [How to deploy a model](./v1/how-to-deploy-and-where.md).
183+
To learn more about deploying a model, see [How to deploy a model](how-to-deploy-and-where.md).
184184

185185
To learn how to troubleshoot prebuilt docker image deployments, see [how to troubleshoot prebuilt Docker image deployments](how-to-troubleshoot-prebuilt-docker-image-inference.md).

articles/machine-learning/how-to-troubleshoot-prebuilt-docker-image-inference.md renamed to articles/machine-learning/v1/how-to-troubleshoot-prebuilt-docker-image-inference.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,7 @@ Learn how to troubleshoot problems you may see when using prebuilt docker images
2424
If model deployment fails, you won't see logs in [Azure Machine Learning studio](https://ml.azure.com/) and `service.get_logs()` will return None.
2525
If there is a problem in the init() function of score.py, `service.get_logs()` will return logs for the same.
2626

27-
So you'll need to run the container locally using one of the commands shown below and replace `<MCR-path>` with an image path. For a list of the images and paths, see [Prebuilt Docker images for inference](concept-prebuilt-docker-images-inference.md).
27+
So you'll need to run the container locally using one of the commands shown below and replace `<MCR-path>` with an image path. For a list of the images and paths, see [Prebuilt Docker images for inference](../concept-prebuilt-docker-images-inference.md).
2828

2929
### Mounting extensibility solution
3030

@@ -44,11 +44,11 @@ docker run -it -v $(pwd):/var/azureml-app -e AZUREML_EXTRA_REQUIREMENTS_TXT="req
4444

4545
## Enable local debugging
4646

47-
The local inference server allows you to quickly debug your entry script (`score.py`). In case the underlying score script has a bug, the server will fail to initialize or serve the model. Instead, it will throw an exception & the location where the issues occurred. [Learn more about Azure Machine Learning inference HTTP Server](how-to-inference-server-http.md)
47+
The local inference server allows you to quickly debug your entry script (`score.py`). In case the underlying score script has a bug, the server will fail to initialize or serve the model. Instead, it will throw an exception & the location where the issues occurred. [Learn more about Azure Machine Learning inference HTTP Server](../how-to-inference-server-http.md)
4848

4949
## For common model deployment issues
5050

51-
For problems when deploying a model from Azure Machine Learning to Azure Container Instances (ACI) or Azure Kubernetes Service (AKS), see [Troubleshoot model deployment](./v1/how-to-troubleshoot-deployment.md).
51+
For problems when deploying a model from Azure Machine Learning to Azure Container Instances (ACI) or Azure Kubernetes Service (AKS), see [Troubleshoot model deployment](how-to-troubleshoot-deployment.md).
5252

5353
## init() or run() failing to write a file
5454

articles/machine-learning/media/how-to-prebuilt-docker-images-inference-python-extensibility/dynamic-install-python-extend.svg renamed to articles/machine-learning/v1/media/how-to-prebuilt-docker-images-inference-python-extensibility/dynamic-install-python-extend.svg

File renamed without changes.

articles/machine-learning/media/how-to-prebuilt-docker-images-inference-python-extensibility/pre-install-python-extend.svg renamed to articles/machine-learning/v1/media/how-to-prebuilt-docker-images-inference-python-extensibility/pre-install-python-extend.svg

File renamed without changes.

articles/machine-learning/v1/toc.yml

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -233,11 +233,11 @@
233233
- name: Prebuilt Docker images
234234
items:
235235
- name: Python extensibility
236-
href: ../how-to-prebuilt-docker-images-inference-python-extensibility.md
236+
href: how-to-prebuilt-docker-images-inference-python-extensibility.md
237237
- name: Dockerfile extensibility
238-
href: ../how-to-extend-prebuilt-docker-image-inference.md
238+
href: how-to-extend-prebuilt-docker-image-inference.md
239239
- name: Troubleshoot prebuilt docker images
240-
href: ../how-to-troubleshoot-prebuilt-docker-image-inference.md
240+
href: how-to-troubleshoot-prebuilt-docker-image-inference.md
241241
- name: Monitor web services
242242
items:
243243
- name: Collect & evaluate model data

0 commit comments

Comments
 (0)