Skip to content

Commit 60ee178

Browse files
committedMay 12, 2021
table format and adding images
1 parent a69b4b6 commit 60ee178

File tree

4 files changed

+2246
-5
lines changed

4 files changed

+2246
-5
lines changed
 

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

Lines changed: 10 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -66,7 +66,9 @@ myenv.environment_variables = {
6666
}
6767
```
6868

69-
[comment] : <> (Adding requirements.txt diagram here)
69+
The following diagram is a visual representation of the dynamic installation process:
70+
71+
:::image type="content" source="./media/how-to-prebuilt-docker-images-inference-python-extensibility/dynamic-install-python-extend.svg" alt-text="Diagram of dynamic installation process":::
7072

7173
## Pre-installed python packages
7274

@@ -128,6 +130,10 @@ To extend your prebuilt docker container image through pre-installed python pack
128130
}
129131
```
130132
133+
The following diagram is a visual representation of the pre-installed packages process:
134+
135+
:::image type="content" source="./media/how-to-prebuilt-docker-images-inference-python-extensibility/pre-install-python-extend.svg" alt-text="Diagram of the process using preinstalled packages":::
136+
131137
### Common problems
132138
133139
The mounting solution will only work when your `myenv` site packages directory contains all of your dependencies. If your local environment is using dependencies installed in a different location, they won't be available in the image.
@@ -185,9 +191,9 @@ Instead of using `Model.package()` to add other dependencies, we encourage you t
185191
186192
Here's a detailed comparison.
187193

188-
| Compared item | Requirements.txt (dynamic installation) | Package Mount |
189-
|--------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------|--|
190-
| 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. |
194+
| Compared item | Requirements.txt (dynamic installation) | Package Mount |
195+
| ----- | ----- | ------ |
196+
| 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. |
191197
| Package Installation | No extra installation (assuming pip already installed) | Virtual environment or conda environment installation. |
192198
| 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. |
193199
| Debugging | 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. |

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

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,7 @@ Learn how to troubleshoot problems you may see when using prebuilt docker images
2222

2323
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**.
2424

25-
So you'll need to run the container locally using one of the commands shown below and replace `<MCR-path>` with an image path in this [table of curated images]().
25+
So you'll need to run the container locally using one of the commands shown below and replace `<MCR-path>` with an image path in this [table of prebuilt images](concept-prebuilt-docker-images-inference.md#list-of-prebuilt-Docker-images-for-inference).
2626

2727
### Mounting extensibility solution
2828

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

Lines changed: 1168 additions & 0 deletions
Loading

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

Lines changed: 1067 additions & 0 deletions
Loading

0 commit comments

Comments
 (0)
Please sign in to comment.