유물 등록부

Important

이 기능은 베타 버전으로 제공됩니다. 사용하려면 작업 공간 관리자가 Previews 페이지에서 Databricks Artifact Registry를 켜야 합니다. Azure Databricks 미리 보기 관리를 참조하세요. Databricks는 Artifact Registry가 일반 출시되면 가격을 발표할 예정입니다.

Artifact Registry는 컨테이너 이미지를 Unity 카탈로그에 관리 자산으로 저장합니다. 이미지는 Unity 카탈로그 메타스토어와 동일한 영역에 저장됩니다. 표준 Docker 명령어로 이미지를 푸시하고, Unity 카탈로그 권한으로 접근 권한을 제어하며, 지원되는 Azure Databricks 워크로드에 이미지를 제공하는 데 사용할 수 있습니다.

주요 개념

• 산출물: Unity Catalog에 저장된 이름이 지정된 컨테이너 이미지로, catalog.schema.artifact 형식의 3단계 이름으로 식별됩니다.
• 태그: 포맷 catalog.schema.artifact:tag을 사용하는 아티팩트 버전을 가리키는 가변 별칭입니다. 태그를 다시 푸시하면 해당 태그가 가리키는 버전이 변경될 수 있습니다. 반복 가능한 배포를 위해서는 변경 가능한 태그 latest 를 피하고, 워크로드가 다이제스트 참조를 허용할 때 다이제스트를 참조하세요.
• 이미지 다이제스트: 특정 버전의 산출물을 위한 불변 및 콘텐츠 주소 지정 식별자입니다.
• 이미지 가속: Azure Databricks가 해당 이미지를 Artifact Registry에 푸시한 후 자동으로 적용하는 최적화입니다. 이 과정은 지원되는 워크로드에 대해 풀 지연을 줄이도록 설계된 형식으로 이미지를 변환합니다. 아티팩트 버전의 이미지 가속 상태를 확인하려면 ' 이미지 가속 상태 확인'을 참조하세요.

유물 등록부의 작동 원리

출판사와 사용자는 다음과 같은 라이프사이클을 통해 Artifact Registry 내 컨테이너 이미지를 다룹니다:

1. 빌드 및 푸시: 퍼블리셔는 이미지를 빌드하고, 3단계 Unity 카탈로그 이름 catalog.schema.artifact:tag으로 태그를 붙인 후 작업 공간 레지스트리로 푸시합니다. 아티팩트 이름 요구사항과 이미지 푸시를 참조하세요.
2. 거버넌스: 아티팩트 레지스트리는 이미지를 지정된 Unity 카탈로그 카탈로그와 스키마 아래에 저장합니다. Unity 카탈로그는 누가 이미지를 게시하고, 발견하며, 읽을 수 있는지 권한을 부여합니다. 권한 부여 항목을 참조하세요.
3. 발견하기: 사용자는 사용 가능한 이미지와 버전을 확인하고 이미지 가속 상태를 확인하기 위해 소프트웨어 아티팩트 API를 호출합니다. 이미지 및 버전 확인을 참조하세요.
4. 용도: 사용자는 사용자 지정 컨테이너 이미지를 실행하는 작업과 같은 지원 Azure Databricks 워크로드를 생성할 때 이미지를 참조합니다. 지원되는 Azure Databricks 워크로드에서 이미지 사용을(를) 참조하세요.

제한 사항

다음과 같은 제한 사항이 적용됩니다.

가용성

• 작업 공간과 Unity 카탈로그 메타스토어가 같은 지역에 있어야 합니다. 지역이 다르면 해당 작업 공간에서 아티팩트 레지스트리를 사용할 수 없습니다.

• 유물 등록부는 다음 지역에서 이용 가능합니다:

  • australiaeast
  • brazilsouth
  • canadacentral
  • centralindia
  • centralus
  • eastasia
  • eastus
  • eastus2
  • francecentral
  • germanywestcentral
  • japaneast
  • koreacentral
  • northcentralus
  • northeurope
  • southcentralus
  • southeastasia
  • swedencentral
  • switzerlandnorth
  • uaenorth
  • uksouth
  • ukwest
  • westcentralus
  • westeurope
  • westus
  • westus2
  • westus3

지원 용도

• Artifact Registry에서는 지원되는 Azure Databricks 워크로드에서만 이미지를 사용할 수 있습니다. 지원되는 Azure Databricks 워크로드에서 이미지 사용을(를) 참조하세요.
• Docker나 다른 레지스트리 클라이언트를 사용해 이미지를 직접 가져오거나 이미지 블롭을 다운로드할 수 없습니다.

인증

• Docker 인증에 사용되는 워크workspace OAuth 접근 토큰은 1시간 후에 만료됩니다. 더 오래 걸리는 푸시는 만료 후에 업로드된 레이어에 대한 승인 실패를 초래할 수 있습니다. Docker 자격 증명 도우미가 새 토큰을 요청하도록 푸시를 다시 시도하세요.

이미지 가속

• 30GB를 초과하는 이미지는 이미지 가속을 위해 변환할 수 없습니다.
• 이미지 가속은 변환 실패 상태를 드러내지 않습니다. 이미지 가속 상태 확인을 참조하세요.

발견과 관리

• 카탈로그 탐색기는 이미지 인터페이스를 제공하지 않습니다.
• 레지스트리 엔드포인트는 Open Container Initiative(OCI) 태그 리스트 요청이나 삭제 요청을 지원하지 않습니다.
• 소프트웨어 아티팩트 API는 10개 이상의 태그가 동일한 다이제스트를 가리키는 버전에 대해 최대 10개의 태그만 반환합니다.

유물 이름

• 유물 이름에는 문자 및 서식에 제한이 있습니다. 유물 이름 요구사항을 참조하세요.

추가 리소스

• 인증 설정, 접근 권한 부여, 이미지 푸시, 버전 확인은 ' Artifact Registry로 시작하기'를 참조하세요.
• 일반적인 베타 접근, 인증, 푸시, 발견, 이미지 가속 문제를 해결하려면 '아티팩트 레지스트리 문제 해결'을 참조하세요.