Skip to content

Commit 6d0ccaa

Browse files
authored
Merge pull request #95646 from Blackmist/dockernote
Adding prereqs and adding links to Docker documentation
2 parents 929f258 + 5484a87 commit 6d0ccaa

File tree

1 file changed

+12
-5
lines changed

1 file changed

+12
-5
lines changed

articles/machine-learning/service/how-to-troubleshoot-deployment.md

Lines changed: 12 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -37,6 +37,16 @@ When deploying a model in Azure Machine Learning, the system performs a number o
3737

3838
Learn more about this process in the [Model Management](concept-model-management-and-deployment.md) introduction.
3939

40+
## Prerequisites
41+
42+
* An **Azure subscription**. If you do not have one, try the [free or paid version of Azure Machine Learning](https://aka.ms/AMLFree).
43+
* The [Azure Machine Learning SDK](https://docs.microsoft.com/python/api/overview/azure/ml/install?view=azure-ml-py).
44+
* The [Azure CLI](https://docs.microsoft.com/cli/azure/install-azure-cli?view=azure-cli-latest).
45+
* The [CLI extension for Azure Machine Learning](reference-azure-machine-learning-cli.md).
46+
* To debug locally, you must have a working Docker installation on your local system.
47+
48+
To verify your Docker installation, use the command `docker run hello-world` from a terminal or command prompt. For information on installing Docker, or troubleshooting Docker errors, see the [Docker Documentation](https://docs.docker.com/).
49+
4050
## Before you begin
4151

4252
If you run into any issue, the first thing to do is to break down the deployment task (previous described) into individual steps to isolate the problem.
@@ -151,9 +161,6 @@ To avoid this problem, we recommend one of the following approaches:
151161

152162
If you encounter problems deploying a model to ACI or AKS, try deploying it as a local . Using a local makes it easier to troubleshoot problems. The Docker image containing the model is downloaded and started on your local system.
153163

154-
> [!IMPORTANT]
155-
> Local deployments require a working Docker installation on your local system. Docker must be running before you deploy a local . For information on installing and using Docker, see [https://www.docker.com/](https://www.docker.com/).
156-
157164
> [!WARNING]
158165
> Local deployments are not supported for production scenarios.
159166
@@ -320,8 +327,8 @@ In some cases, you may need to interactively debug the Python code contained in
320327

321328
> [!IMPORTANT]
322329
> This method of debugging does not work when using `Model.deploy()` and `LocalWebservice.deploy_configuration` to deploy a model locally. Instead, you must create an image using the [ContainerImage](https://docs.microsoft.com/python/api/azureml-core/azureml.core.image.containerimage?view=azure-ml-py) class.
323-
>
324-
> Local deployments require a working Docker installation on your local system. Docker must be running before you deploy a local . For information on installing and using Docker, see [https://www.docker.com/](https://www.docker.com/).
330+
331+
Local deployments require a working Docker installation on your local system. For more information on using Docker, see the [Docker Documentation](https://docs.docker.com/).
325332

326333
### Configure development environment
327334

0 commit comments

Comments
 (0)