HCP Packer 아티팩트 버킷 생성 및 관리

HCP Packer 아티팩트 버킷 생성 및 관리

이 주제는 HCP Packer 레지스트리에서 아티팩트 버킷(bucket)을 만들고 관리하는 방법을 설명해요. 버킷은 Packer로 빌드된 각 아티팩트에 대한 정보를 저장하는 저장소예요. HCP Packer에서 메타데이터를 저장하는 구성 요소에 대한 추가 정보는 메타데이터 저장 개요를 참고해 주세요.

출처: 문서

본문

소개

버킷은 여러 프로바이더의 머신 이미지나 컨테이너에 대한 아티팩트 메타데이터를 포함할 수 있어요. 예를 들어, Amazon Web Services(AWS)용 골든 이미지가 여러 리전에 존재할 수 있고, 동일한 소프트웨어를 포함하는 Azure 이미지가 있을 수도 있어요. 이러한 이미지를 같은 Packer 템플릿에 정의하면 레지스트리는 그 메타데이터를 같은 버킷에 저장해요.

버킷 만들기

HCP Packer는 packer build 명령으로 템플릿을 처음 빌드할 때 버킷을 자동으로 만들어요.

기존 Packer 템플릿에서 새 버킷을 만들려면 Packer 템플릿 구성의 hcp_packer_registry.bucket_name 필드에 새 값을 지정해요. 다음에 템플릿을 빌드하면 HCP Packer가 템플릿과 연결된 새 버킷을 만들어요. 자세한 내용은 아티팩트 메타데이터를 HCP Packer로 전송하기를 참고해 주세요.

Packer 템플릿을 빌드할 때 HCP_PACKER_BUCKET_NAME 환경 변수를 설정할 수도 있어요. 이 환경 변수는 템플릿에 구성된 버킷을 재정의해요. 변수에 지정된 값이 이미 존재하지 않으면 HCP Packer는 새 버킷을 만들어요.

JSON으로 작성된 Packer 템플릿을 빌드하는 경우에는 환경 변수가 필요하다는 점에 유의해 주세요. JSON 템플릿은 hcp_packer_registry 구성 블록을 지원하지 않기 때문이에요. 자세한 내용은 JSON 및 HCL2 기능 참조를 참고해 주세요.

버킷 보기

HCP Packer UI에서 버킷과 관련된 정보를 볼 수 있어요.

  1. 사이드바에서 Packer를 클릭해요. HCP Packer 페이지가 나타나고 프로젝트의 모든 버킷이 나열돼요.
  2. 버킷 ID를 클릭해요. 버킷의 개요 페이지가 나타나요. 이 페이지는 버킷 설명, 최신 버전의 아티팩트 ID, 사용자 정의 라벨을 보여 줘요.
  3. 사이드바에서 Versions를 클릭해 각 버전에 대한 세부 정보를 확인해요.
  4. Channels를 클릭해 연결된 채널에 대한 세부 정보를 확인해요. 자세한 내용은 채널 생성 및 관리를 참고해 주세요.

버킷 편집하기

버킷에 포함된 메타데이터를 편집하려면 Packer 템플릿 구성의 hcp_packer_registry 템플릿 블록에 지정된 값을 수정해요. 다음 빌드에서 HCP Packer는 레지스트리의 이전 값을 덮어써요.

버킷의 메타데이터만 수정할 수 있으며, 버킷에 포함된 기존 버전은 불변이라 수정할 수 없다는 점에 유의해 주세요. 기존 버전은 템플릿 파일을 업데이트한 후에도 자체 메타데이터를 유지해요.

버킷의 이름을 변경하면 레지스트리는 템플릿에 대해 새 이름의 새 버킷을 만들고 모든 향후 아티팩트 메타데이터를 새 버킷에 저장하지만, 이전 버킷은 삭제하지 않아요.

버킷의 사용자 권한 업데이트하기

Terraform HashiCorp Cloud Platform(HCP) Provider를 통해 policy 리소스 또는 binding 리소스를 사용해 선택한 주체에 역할을 할당하면서, 버킷 수준에서 사용자의 권한을 업데이트할 수 있어요.

사용자, 서비스 주체, 그룹이 HCP Packer 레지스트리의 나머지 부분에 대한 프로젝트 수준 viewer 권한을 수정하지 않고도 버킷에 기여하도록 허용할 수 있어요. HCP Packer의 사용자 권한에 대한 자세한 내용은 HCP Packer 권한 참조를 참고해 주세요.

참고: 버킷 수준에서 contributor 접근 권한을 가지지만 레지스트리 수준에서는 viewer 권한인 서비스 주체가 HCP Packer로 메타데이터를 전송하려면 Packer v1.11.1 이상이 필요해요.

버킷 삭제하기

HCP Packer UI에서 버킷을 영구적으로 삭제할 수 있어요:

  1. HCP Packer 홈페이지로 이동해 삭제하려는 버킷의 줄임표 메뉴를 열어요.
  2. 안내가 표시되면 Delete bucket을 클릭해요.

버킷과 모든 데이터가 HCP Packer 레지스트리에서 영구적으로 제거돼요.

더 알아보기