아티팩트 스트리밍 문제 해결
이 문서의 문제 해결 단계는 ACR(Azure Container Registry)에서 아티팩트 스트리밍을 사용할 때 발생할 수 있는 일반적인 문제를 해결하는 데 도움이 될 수 있습니다. 이러한 단계와 권장 사항은 아티팩트 스트리밍과 관련된 문제를 진단 및 해결하는 데 도움이 될 뿐만 아니라 디버깅 목적으로 기본 프로세스 및 로그에 대한 인사이트를 제공할 수 있습니다.
증상
- 알 수 없는 오류로 인해 변환 작업이 실패했습니다.
- 실패한 AKS Pod 배포 문제 해결
- Pod 조건은 "UpgradeIfStreamableDisabled"를 나타냅니다.
- 스트리밍 아티팩트에 태그 대신 다이제스트 사용
원인
- 인증, 네트워크 대기 시간, 이미지 검색, 스트리밍 작업 또는 기타 문제와 관련된 문제입니다.
- 이미지 끌어오기 또는 스트리밍, 스트리밍 아티팩트 구성, 이미지 원본 및 리소스 제약 조건과 관련된 문제입니다.
- ACR 구성 또는 권한 관련 문제.
변환 작업이 실패했습니다.
| 오류 코드 | 오류 메시지 | 문제 해결 정보 |
|---|---|---|
| UNKNOWN_ERROR | 알 수 없는 오류로 인해 변환 작업이 실패했습니다. | 내부 오류로 인해 발생했습니다. 여기서는 다시 시도가 도움이 됩니다. 다시 시도에 실패하면 지원에 문의하세요. |
| RESOURCE_NOT_FOUND | 대상 리소스를 찾을 수 없어 변환 작업에 실패했습니다. | 레지스트리에서 대상 이미지를 찾을 수 없는 경우 이미지 다이제스트에서 오타를 확인합니다. 이미지가 삭제되거나 대상 지역에서 누락된 경우(예를 들어, 복제 일관성이 즉각적이지 않음) |
| UNSUPPORTED_PLATFORM | 현재 이미지 플랫폼에서는 변환이 지원되지 않습니다. | 처음에는 linux/amd64 이미지만 지원됩니다. |
| NO_SUPPORTED_PLATFORM_FOUND | 현재 인덱스의 어떤 이미지 플랫폼에서도 변환이 지원되지 않습니다. | 처음에는 linux/amd64 이미지만 지원됩니다. 이 플랫폼의 이미지가 대상 인덱스에 없습니다. |
| UNSUPPORTED_MEDIATYPE | MediaType 이미지에 대해서는 변환이 지원되지 않습니다. | 변환은 미디어 형식이 application/vnd.oci.image.manifest.v1+json, application/vnd.oci.image.index.v1+json, application/vnd.docker.distribution.manifest.v2+json or application/vnd.docker.distribution.manifest.list.v2+json인 이미지만 대상으로 지정할 수 있습니다. |
| UNSUPPORTED_ARTIFACT_TYPE | ArtifactType 이미지에는 변환이 지원되지 않습니다. | 스트리밍 Artifacts(Artifacts 형식: application/vnd.azure.artifact.streaming.v1)는 다시 변환할 수 없습니다. |
| IMAGE_NOT_RUNNABLE | 실행할 수 없는 이미지에는 변환이 지원되지 않습니다. | 처음에는 linux/amd64 실행 가능 이미지만 지원됩니다. |
실패한 AKS Pod 배포 문제 해결
다음 예와 같이 이미지 끌어오기와 관련된 오류로 인해 AKS Pod 배포가 실패하는 경우
Failed to pull image "mystreamingtest.azurecr.io/jupyter/all-spark-notebook:latest":
rpc error: code = Unknown desc = failed to pull and unpack image
"mystreamingtest.azurecr.io/latestobd/jupyter/all-spark-notebook:latest":
failed to resolve reference "mystreamingtest.azurecr.io/jupyter/all-spark-notebook:latest":
unexpected status from HEAD request to http://localhost:8578/v2/jupyter/all-spark-notebook/manifests/latest?ns=mystreamingtest.azurecr.io:503 Service Unavailable
이 문제를 해결하려면 다음 지침을 확인해야 합니다.
- AKS에 컨테이너 레지스트리
mystreamingtest.azurecr.io에 액세스할 수 있는 권한이 있는지 확인합니다. - 컨테이너 레지스트리
mystreamingtest.azurecr.io에 액세스할 수 있고 AKS에 올바르게 연결되었는지 확인합니다.
"UpgradeIfStreamableDisabled" Pod 조건 확인:
AKS Pod 조건에 "UpgradeIfStreamableDisabled"가 표시되면 이미지가 Azure Container Registry에서 가져온 것인지 확인합니다.
스트리밍 아티팩트에 태그 대신 다이제스트 사용
태그 대신 다이제스트를 사용하여 스트리밍 아티팩트를 배포하는 경우(예: mystreamingtest.azurecr.io/jupyter/all-spark-notebook@sha256:4ef83ea6b0f7763c230e696709d8d8c398e21f65542db36e82961908bcf58d18) AKS Pod 이벤트 및 조건 메시지에는 스트리밍 관련 정보가 포함되지 않습니다. 그러나 기본 컨테이너 엔진으로 빠른 컨테이너 시작이 표시됩니다. 이 엔진은 실제 이미지 콘텐츠가 스트리밍 가능하다고 검색하면 이미지를 AKS로 스트리밍합니다.