Skip to content

Commit 5e1419a

Browse files
Merge pull request #225614 from edebar01/patch-3
add explanation for 404s from wrong use of @latest
2 parents 00f05ca + 2de532a commit 5e1419a

File tree

1 file changed

+30
-12
lines changed

1 file changed

+30
-12
lines changed

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

Lines changed: 30 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1104,7 +1104,7 @@ channels:
11041104
**Resources**
11051105
* See [conda package pinning](https://aka.ms/azureml/environment/how-to-pin-conda-packages)
11061106

1107-
## *Deprecated environment property issues*
1107+
## *Miscellaneous environment issues*
11081108
### R section is deprecated
11091109
<!--issueDescription-->
11101110
**Potential causes:**
@@ -1130,25 +1130,25 @@ env.r = None
11301130

11311131
See the [samples repository](https://aka.ms/azureml/environment/train-r-models-cli-v2) to get started training R models using the Azure CLI v2
11321132

1133-
## **Image build problems**
1134-
1135-
## *Miscellaneous issues*
1136-
### Build log unavailable
1133+
### No definition exists for environment
11371134
<!--issueDescription-->
11381135
**Potential causes:**
1139-
* AzureML isn't authorized to store your build logs in your storage account
1140-
* A transient error occurred while saving your build logs
1141-
* Your image build didn't occur due to a system error before the build had a chance to start
1136+
* You specified an environment that doesn't exist or hasn't been registered
1137+
* There was a misspelling or syntactical error in the way you specified your environment name or environment version
11421138

11431139
**Affected areas (symptoms):**
1144-
* A successful build, but no available logs.
1145-
* Failure in building environments from UI, SDK, and CLI.
1146-
* Failure in running jobs because it will implicitly build the environment in the first step.
1140+
* Failure in registering your environment
11471141
<!--/issueDescription-->
11481142

11491143
**Troubleshooting steps**
11501144

1151-
A rebuild may fix the issue if it's transient
1145+
Ensure that you are specifying your environment name correctly, along with the correct version
1146+
* `path-to-resource:version-number`
1147+
1148+
The 'latest' version of your environment is specified in a slightly different way
1149+
* `path-to-resource@latest`
1150+
1151+
## **Image build problems**
11521152

11531153
## *ACR issues*
11541154
### ACR unreachable
@@ -1741,3 +1741,21 @@ If you aren't using a virtual network, or if you've configured it correctly, tes
17411741
* Log in to your ACR using `docker login <myregistry.azurecr.io> -u "username" -p "password"`
17421742
* For an image "helloworld", test pushing to your ACR by running `docker push helloworld`
17431743
* See [Quickstart: Build and run a container image using Azure Container Registry Tasks](../container-registry/container-registry-quickstart-task-cli.md)
1744+
1745+
## *Miscellaneous build issues*
1746+
### Build log unavailable
1747+
<!--issueDescription-->
1748+
**Potential causes:**
1749+
* AzureML isn't authorized to store your build logs in your storage account
1750+
* A transient error occurred while saving your build logs
1751+
* A system error occurred before an image build was triggered
1752+
1753+
**Affected areas (symptoms):**
1754+
* A successful build, but no available logs.
1755+
* Failure in building environments from UI, SDK, and CLI.
1756+
* Failure in running jobs because it will implicitly build the environment in the first step.
1757+
<!--/issueDescription-->
1758+
1759+
**Troubleshooting steps**
1760+
1761+
A rebuild may fix the issue if it's transient

0 commit comments

Comments
 (0)