커넥터 저장소 개요

Artifact Registry 커넥터 저장소는 업스트림 소스의 프록시 역할을 합니다. 저장소에 대한 모든 요청은 업스트림 소스로 프록시 처리되며 Artifact Registry에는 아티팩트가 캐시되지 않습니다. 이 구성을 사용하면 업스트림 소스를 완전히 감사할 수 있으며 서드 파티 정책으로 인해 아티팩트 캐싱이 방지되는 경우를 지원합니다.

이 문서에서는 커넥터 저장소의 작동 방식을 설명하고 여러 사용 사례를 제공합니다. 커넥터 저장소를 만드는 방법에 대한 안내는 커넥터 저장소 만들기를 참조하세요.

지원되는 커넥터 형식

Artifact Registry는 Docker 형식 커넥터 저장소만 지원합니다.

업스트림 인증

Artifact Registry 커넥터 저장소에는 업스트림 소스에 대한 기본 인증이 필요합니다. 커넥터 저장소 업스트림 소스에 인증하는 방법에 대한 자세한 내용은 커넥터 저장소 업스트림에 대한 인증 구성을 참조하세요.

존재하지 않거나 지정한 버전이 없는 업스트림 소스에서 아티팩트를 요청하면 요청이 실패합니다.

사용 사례 및 혜택

완전한 업스트림 감사 가능성
커넥터 저장소는 Artifact Registry에 패키지를 캐시하지 않으므로 모든 저장소 요청은 업스트림 소스에 직접 이루어집니다. 이 프로세스는 저장소 구성에 업스트림 소스의 완전한 감사 가능성이 필요하거나 아티팩트 캐싱을 방지하는 서드 파티 정책을 준수해야 하는 경우에 유용합니다.
더 안전한 종속 항목 확인

가상 저장소와 함께 커넥터 저장소를 사용하여 공개 종속 항목과 관련된 위험을 완화합니다. 일부 도구는 클라이언트에 비공개 저장소와 공개 저장소가 혼합되어 구성된 경우 검색 순서를 제어하는 방법을 제공하지 않습니다. 이러한 유형의 구성은 공격자가 악성 코드가 포함된 패키지의 새 버전을 공개 저장소에 업로드하여 클라이언트가 악성 버전을 선택하도록 속이는 종속 항목 혼동 공격에 취약합니다.

클라이언트가 직접 여러 저장소를 검색하도록 클라이언트를 구성하는 대신 가상 저장소가 커넥터 저장소보다 비공개 저장소를 우선으로 지정하도록 구성하면 됩니다.

Artifact Registry가 VPC 서비스 제어 서비스 경계에 있는 경우 Artifact Registry는 기본적으로 경계 외부의 업스트림 소스에 대한 액세스를 거부합니다. 특정 위치의 커넥터 저장소가 경계 외부의 구성된 외부 소스에 액세스하도록 허용할 수 있습니다. 안내는 VPC 서비스 제어 구성을 참조하세요.

다른 종속 항목 관리 권장사항에 대해 알아보려면 종속 항목 관리를 참조하세요.

패키지 색인 및 메타데이터 업데이트

패키지 색인 및 메타데이터와 같이 변경 가능한 파일은 기본 기간을 초과하는 경우 업스트림 소스에서 업데이트됩니다. 다음 표에는 특정 파일 형식의 기본값이 나와 있습니다.

형식 파일 형식 기본 업데이트 기간
Docker 태그 캐시 나열/가져오기 1시간

Artifact Registry 커넥터 저장소 업스트림

Docker Hub를 커넥터 저장소 소스로 사용하거나 커스텀 저장소 URL을 입력할 수 있습니다. 다음 표에는 몇 가지 일반적인 업스트림 Docker URI의 일부 목록이 나와 있습니다.

형식 업스트림 URI 레지스트리 이름
Docker https://MY_ARTIFACTORY_INSTANCE.jfrog.io/OPTIONAL_REPO JFrog Artifactory
Docker https://ghcr.io GitHub Container Registry
Docker https://registry-1.docker.io Docker Hub
Docker https://public.ecr.aws AWS ECR 공개 갤러리
Docker https://registry.k8s.io Kubernetes Container Registry
Docker https://MY_NEXUS_IP Nexus

제한사항

Artifact Registry 할당량 및 제한사항 외에도 커넥터 저장소에는 다음과 같은 제한사항이 있습니다.

  • 업스트림 소스는 인터넷에 액세스할 수 있어야 합니다. 커넥터 저장소는 공개 IP 주소가 없는 온프레미스 또는 Virtual Private Cloud (VPC) 네트워크 업스트림 소스를 지원하지 않습니다.

기타 저장소 모드

다른 저장소 모드는 다음과 같습니다.

  • 표준: 기본 저장소 모드입니다. 비공개 패키지와 같은 아티팩트를 표준 저장소에 직접 업로드하거나 게시합니다. 개별 표준 저장소에서 직접 다운로드할 수도 있지만 가상 저장소를 사용해서 저장소 그룹에 액세스하면 도구 구성이 간소화됩니다.
  • 원격: 업스트림 소스에서 처음 다운로드한 후 Artifact Registry에 패키지를 캐시하여 업스트림 소스의 프록시 역할을 하는 저장소입니다. 다음에 동일한 패키지 버전을 요청하면 Artifact Registry에서 캐시된 사본을 제공합니다.
  • 가상: 커넥터 및 표준 저장소를 포함하여 여러 업스트림 저장소에 대한 단일 액세스 포인트 역할을 하는 저장소입니다.

다음 단계