HCP Packer 채널 생성 및 관리

이 주제는 HCP Packer에서 채널을 만들고 관리하는 방법을 설명해요. 채널은 아티팩트 크리에이터가 기본 아티팩트를 할당할 수 있는 사람이 읽을 수 있는 이름이에요. 아티팩트 소비자는 아티팩트 버전을 하드코딩하는 대신 Packer 템플릿이나 Terraform 구성에서 채널을 사용할 수 있어, 애플리케이션에서 자동으로 올바른 버전을 사용할 수 있어요.

직접 해보기: 시작하려면 채널로 아티팩트 제어하기 튜토리얼을 완료해 주세요.

출처: 문서

본문

개요

HCP Packer UI 또는 HCP Packer API로 채널을 만들고, 업데이트하고, 삭제할 수 있어요. 다음 개요는 채널을 사용하는 예상 워크플로우를 설명해요:

아티팩트 버전을 빌드하고 메타데이터를 HCP Packer로 전송해요. HCP Packer로 메타데이터 전송 참조
HCP Packer UI에서 하나 이상의 채널을 만들고 아티팩트를 적절한 채널에 할당해요.
아티팩트 소비자는 Packer 템플릿이나 Terraform 구성에서 채널 이름을 사용해요. 다운스트림 아티팩트를 빌드할 때 Packer 또는 Terraform이 아티팩트의 적절한 버전을 자동으로 가져와요. 자세한 내용은 아티팩트 메타데이터 참조를 참고해 주세요.
새 버전을 릴리스할 때 채널과 연결된 아티팩트를 업데이트해요. 결과적으로 소비자는 코드를 업데이트하지 않고도 레지스트리에서 올바른 버전을 자동으로 참조하게 돼요.

채널을 업데이트해도 다운스트림 소비자에게 자동으로 알리거나 다운스트림 Packer 빌드 또는 Terraform run을 트리거하지 않아요. 소비자는 해당 채널에서 아티팩트 메타데이터를 요청하는 파이프라인을 다음에 실행할 때 채널의 최신 버전을 자동으로 사용해요.

Latest 채널

모든 버킷에는 기본적으로 latest 채널이 있어요. 이 채널은 HCP Packer가 관리하며 버킷에서 사용 가능한 가장 최신의 폐기되지 않은 버전으로 자동 업데이트돼요. latest 채널은 기본적으로 제한되어 있어요. 이 제한을 제거하도록 선택할 수 있어요. 제한된 채널에 대한 자세한 내용은 보안 채널 접근을 참고해 주세요.

Packer 템플릿과 Terraform 구성에서 latest 채널을 사용할 수 있어요. 채널이 기본적으로 제한되어 있으므로 사용하려면 Contributor 또는 Admin 접근 권한이 필요해요.

버킷의 latest 채널에 할당된 버전을 변경하거나 채널을 삭제할 수는 없어요.

채널 만들기

버전이 완전하고 레지스트리가 버전 번호를 할당한 경우에만 채널에 버전을 할당할 수 있어요.

HCP 포털에서 Services 사이드바의 Packer를 클릭해요.
Artifact ID 열에서 버킷을 클릭해요.
사이드바에서 Channels를 클릭해요.
+ New Channel을 클릭하고 이름을 지정해요. 고유한 문자열을 입력해야 해요. latest는 HCP Packer가 자동으로 만드는 예약된 채널 이름이라는 점에 유의해 주세요. 자세한 내용은 Latest 채널을 참고해 주세요.
Assign to a version: 드롭다운 메뉴에서 버전을 선택해요. 소비자가 Packer 템플릿이나 Terraform 구성에서 채널 이름을 참조할 때 이 버전이 다운스트림 아티팩트를 빌드하는 데 자동으로 사용돼요. 버전을 비워두어 향후 버전의 자리 표시자를 만들 수도 있어요.
Channel access 필드에서 다음 옵션 중 하나를 활성화해요:
- Unrestricted: 채널이 조직의 모든 구성원에게 보여요.
- Restricted: 리소스를 생성, 편집, 삭제할 권한이 있는 조직의 사용자에게 채널이 보여요.
Create channel을 클릭해요.

자세한 내용은 보안 채널 접근을 참고해 주세요.

채널 세부 정보 보기

HCP Packer UI는 채널에 할당된 아티팩트 버전에 대한 정보를 보여 줘요.

HCP 포털에서 Services 사이드바의 Packer를 클릭해요.
Artifact ID 열에서 버킷을 클릭해 Overview 화면을 열어요.
사이드바에서 Channels를 클릭해 Channels 화면을 열어요.
채널을 클릭해 Overview 화면을 열어요. 개요에는 다음 정보가 표시돼요:
- 할당된 버전.
- 할당 기록. HCP는 기록을 최대 1년 동안 저장해요. 항목 수는 구독 등급에 따라 달라져요. 사용 가능한 등급은 Packer 가격 페이지를 참고해 주세요. HCP Packer 레지스트리 등급을 업그레이드하려면 레지스트리 등급 보기 및 변경을 참고해 주세요.
- 계보 상태. 개요 페이지는 아티팩트가 구식일 때 알려 줘요. 자세한 내용은 계보 보기를 참고해 주세요.

채널 편집 및 삭제

채널을 삭제하면 HCP Packer는 해당 할당 기록도 영구적으로 삭제해요. 채널을 변경할 때 소비자에게 알릴 것을 권장해요. HCP Packer는 소비자에게 변경 사항을 알리지 않아요.

버킷으로 이동해 사이드바에서 Channels를 클릭해요. 이 버킷의 모든 기존 채널 목록이 있는 Channels 화면이 나타나요.
편집하거나 삭제하려는 채널의 줄임표 메뉴를 열어요.
다음 작업을 수행할 수 있어요:
- Edit assigned version: 다른 버전을 선택하고 Update Channel을 클릭해요.
- Edit channel access: 다른 채널 접근 유형을 선택하고 Confirm을 클릭해요.
- Delete Channel: 이 채널을 삭제할 것이라면 Delete를 클릭해요.

삭제된 채널 복원하기

삭제된 채널을 복원하려면, 같은 채널 이름과 할당된 버전으로 새 채널을 추가해 주세요.

보안 채널 접근

조직 또는 프로젝트에서 contributor 또는 admin 역할이 있는 사용자에게만 채널 접근을 제한할 수 있어요. 자세한 내용은 사용자를 참고해 주세요.

제한된 채널을 사용하면 다운스트림 소비자에게 unrestricted 채널로 제공하기 전에 아티팩트를 검증하고 테스트할 수 있어요.

제한된 채널은 viewer 역할이 할당된 사용자에게 보이지 않아요. 기본적으로 latest 채널은 제한된 채널로 생성돼요.

다음 단계

HCP Packer 채널 개요 화면의 HCL 생성기를 사용해 Packer 또는 Terraform 구성 언어용 데이터 소스 스니펫을 만들 수 있어요. Packer로 자식을 빌드하거나 Terraform으로 아티팩트를 배포하기 위해 메타데이터를 가져올 때는 데이터 소스를 사용할 것을 권장해요. 방법은 아티팩트 메타데이터 참조를 참고해 주세요.

HCP Packer 채널 생성 및 관리