Skip to content

Commit 84a79e5

Browse files
authored
Update how-to-troubleshoot-environments.md
1 parent 2368d1b commit 84a79e5

File tree

1 file changed

+63
-0
lines changed

1 file changed

+63
-0
lines changed

articles/machine-learning/how-to-troubleshoot-environments.md

Lines changed: 63 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1197,6 +1197,22 @@ az ml workspace update --name myworkspace --resource-group myresourcegroup --ima
11971197
* [Enable Azure Container Registry (ACR)](https://aka.ms/azureml/environment/acr-private-endpoint)
11981198
* [How To Use Environments](https://aka.ms/azureml/environment/how-to-use-environments)
11991199

1200+
### Unexpected Dockerfile Format
1201+
<!--issueDescription-->
1202+
This issue can happen when the Dockerfile is formatted incorrectly.
1203+
1204+
**Potential causes:**
1205+
* Your Dockerfile contains invalid syntax
1206+
* Your Dockerfile contains characters that aren't compatible with UTF-8
1207+
1208+
**Affected areas (symptoms):**
1209+
* Failure in building environments from UI, SDK, and CLI.
1210+
* Failure in running jobs because it will implicitly build the environment in the first step.
1211+
<!--/issueDescription-->
1212+
1213+
**Troubleshooting steps**
1214+
* Ensure Dockerfile is formatted correctly and is encoded in UTF-8
1215+
12001216
## *Docker pull issues*
12011217
### Failed to pull Docker image
12021218
<!--issueDescription-->
@@ -1731,6 +1747,7 @@ This issue can happen when you haven't specified any targets and no makefile is
17311747
**Affected areas (symptoms):**
17321748
* Failure in building environments from UI, SDK, and CLI.
17331749
* Failure in running jobs because Azure Machine Learning implicitly builds the environment in the first step.
1750+
<!--/issueDescription-->
17341751
17351752
**Troubleshooting steps**
17361753
* Ensure that you've spelled the makefile correctly
@@ -1742,8 +1759,31 @@ This issue can happen when you haven't specified any targets and no makefile is
17421759
17431760
**Resources**
17441761
* [GNU Make](https://www.gnu.org/software/make/manual/make.html)
1762+
1763+
## *Copy issues*
1764+
### File not found
1765+
<!--issueDescription-->
1766+
This issue can happen when Docker fails to find and copy a file.
1767+
1768+
**Potential causes:**
1769+
* Source file not found in Docker build context
1770+
* Source file excluded by `.dockerignore`
1771+
1772+
**Affected areas (symptoms):**
1773+
* Failure in building environments from UI, SDK, and CLI.
1774+
* Failure in running jobs because it will implicitly build the environment in the first step.
17451775
<!--/issueDescription-->
17461776
1777+
**Troubleshooting steps**
1778+
* Ensure that the source file exists in the Docker build context
1779+
* Ensure that the source and destination paths exist and are spelled correctly
1780+
* Ensure that the source file is not listed in the `.dockerignore` of the current and parent directories
1781+
* Remove any trailing comments from the same line as the `COPY` command
1782+
1783+
**Resources**
1784+
* [Docker COPY](https://docs.docker.com/engine/reference/builder/#copy)
1785+
* [Docker Build Context](https://docs.docker.com/engine/context/working-with-contexts/)
1786+
17471787
## *Docker push issues*
17481788
### Failed to store Docker image
17491789
<!--issueDescription-->
@@ -1772,6 +1812,29 @@ If you aren't using a virtual network, or if you've configured it correctly, tes
17721812
* For an image "helloworld", test pushing to your ACR by running `docker push helloworld`
17731813
* See [Quickstart: Build and run a container image using Azure Container Registry Tasks](../container-registry/container-registry-quickstart-task-cli.md)
17741814
1815+
## *Unknown Docker command*
1816+
### Unknown Docker instruction
1817+
<!--issueDescription-->
1818+
This issue can happen when Docker does not recognize an instruction in the Dockerfile.
1819+
1820+
**Potential causes:**
1821+
* Unknown Docker instruction being used in Dockerfile
1822+
* Your Dockerfile contains invalid syntax
1823+
1824+
**Affected areas (symptoms):**
1825+
* Failure in building environments from UI, SDK, and CLI.
1826+
* Failure in running jobs because it will implicitly build the environment in the first step.
1827+
<!--/issueDescription-->
1828+
1829+
**Troubleshooting steps**
1830+
* Ensure that the Docker command is valid and spelled correctly
1831+
* Ensure there is a space between the Docker command and arguments
1832+
* Ensure there is no unnecessary whitespace in the Dockerfile
1833+
* Ensure Dockerfile is formatted correctly and is encoded in UTF-8
1834+
1835+
**Resources**
1836+
[Dockerfile reference](https://docs.docker.com/engine/reference/builder/)
1837+
17751838
## *Miscellaneous build issues*
17761839
### Build log unavailable
17771840
<!--issueDescription-->

0 commit comments

Comments
 (0)