HCP Waypoint 템플릿 생성 및 관리

이 페이지는 HCP Waypoint 템플릿을 생성하고 삭제하는 방법을 설명해요. 플랫폼 엔지니어가 자주 수행하는 작업이에요. 추가 정보는 템플릿 문서를 참고해 주세요.

출처: 문서

본문

개요

다음 단계는 템플릿을 만드는 절차를 설명해요:

만들려는 각 템플릿에 대해, HCP Terraform에서 공통 인프라 패턴을 지정하는 no-code 모듈을 정의해요.
HCP Waypoint UI를 사용해 템플릿을 만들어요.

템플릿을 만든 후에는 애플리케이션 개발자가 템플릿을 사용해 애플리케이션을 배포하기 시작할 수 있어요.

사전 요구사항

HCP Waypoint가 활성화된 HCP 계정. 계정 생성 방법은 HCP 계정 문서를 참고해 주세요.
Standard 에디션의 HCP Terraform 조직. HCP Terraform은 HCP Terraform no-code 모듈과 프라이빗 모듈 레지스트리를 사용하려면 Standard 에디션이어야 해요.

no-code 모듈 만들기

HCP Terraform no-code 모듈에서 공통 인프라 패턴을 정의해요. no-code 모듈을 만드는 방법은 no-code 모듈 설계를 참고해 주세요.

공개 레지스트리의 모듈을 프라이빗 레지스트리로 가져올 수도 있어요. 자세한 내용은 공개 모듈을 프라이빗 레지스트리에 추가하기를 참고해 주세요. 모듈을 가져온 후에는 레지스트리에서 모듈에 대한 no-code 프로비저닝을 활성화해야 해요.

HCP Waypoint 애플리케이션의 이름을 참조하려면 no-code 모듈에 waypoint_application 변수를 선언해요. 애플리케이션 개발자가 템플릿을 사용할 때 HCP Waypoint가 애플리케이션 이름을 정의해요. Terraform에서 변수를 정의하는 방법은 입력 변수를 참고해 주세요.

no-code 모듈이 클라우드 프로바이더에 인증하고 상호작용할 수 있도록 HCP Terraform 조직 내에 전역 변수 집합(global variable sets)을 만들어야 할 수도 있어요.

변수를 사용해 no-code 모듈의 인프라 리소스에 라벨을 붙여 HCP Waypoint 애플리케이션과 연결할 수 있어요.

템플릿 만들기

no-code 모듈을 만든 후 HCP Waypoint UI에서 다음 단계를 완료해 주세요:

HCP 포털에 로그인하고 Services 메뉴에서 Waypoint를 클릭해요.
사이드바에서 Templates를 클릭한 다음 Create a Template을 클릭해요.
Template name 필드에 템플릿의 고유 식별자를 지정해요. 이름은 최대 24자까지 가능해요.
Summary 필드에 템플릿에 대한 짧은 설명을 추가해요. 이 필드는 최대 110자까지 가능해요. 사용자가 템플릿에서 새 애플리케이션을 만들 때 HCP Waypoint가 이 설명을 보여 줘요.
Terraform no-code module 드롭다운 메뉴에서 템플릿의 소스로 사용할 no-code 모듈을 선택해요. 조직의 프라이빗 레지스트리에 게시된 no-code 모듈이 메뉴에 표시돼요.
HCP Terraform 프로젝트를 선택해요.
입력 변수의 값을 입력해요. 선택 사항이지만, 각 변수에 대해 Enable this value to be defined when the application is created 옵션을 활성화하면 애드온이 설치될 때 값을 선택할 수 있어요.
Next를 클릭해요.
Description 필드에 템플릿에 대한 전체 설명을 추가해요. 이 필드는 최대 500자까지 가능해요. HCP Waypoint는 템플릿 상세 화면에서 이 설명을 보여 줘요.
Developer instructions 필드에 애플리케이션 개발자가 템플릿을 사용하는 방법에 대한 지침을 지정해요. HCP Waypoint는 개발자 지침에서 참조할 수 있도록 다음 변수를 노출해요. 이 필드는 마크다운을 지원해요.
- {{ .ApplicationName }}: 개발자 지침에 개발자의 애플리케이션 이름을 채워 넣어요.
- {{ .TfcOrgName }}: 개발자 지침에 HCP Terraform 조직의 이름을 채워 넣어요.
Labels 필드에 템플릿과 연결할 임의의 메타데이터를 라벨로 지정해요.
선택 사항이지만, HCP Terraform이 Terraform 작업을 수행하는 데 사용하는 실행 모드를 선택할 수 있어요. 기본적으로 HCP Waypoint는 HCP Terraform 조직의 기본 실행 모드를 상속해요. 다음 옵션 중 하나를 활성화해 기본값을 재정의할 수 있어요:
- Remote: HCP Terraform의 인프라에서 Terraform 작업을 실행해요.
- Agent: 자체 관리형 에이전트 풀을 사용해요. 에이전트 풀을 만들고 관리하는 방법은 에이전트 풀 관리를 참고해 주세요.
Publish를 클릭해요.

템플릿 편집하기

템플릿을 수정해도 템플릿이 만든 기존 애플리케이션이나 기반 리소스에는 영향을 주지 않아요. 변경 사항은 새 애플리케이션에만 적용돼요.

템플릿을 편집하려면 다음 단계를 완료해 주세요:

HCP 포털에 로그인하고 Services 메뉴에서 Waypoint를 클릭해요.
사이드바에서 Templates를 클릭한 다음 수정하려는 템플릿을 클릭해요.
Manage 버튼을 클릭하고 Edit template을 선택해요.
원하는 필드를 업데이트해요.
Save를 클릭해요.

템플릿 삭제하기

템플릿을 삭제해도 템플릿에서 만든 애플리케이션은 제거되지 않아요. 애플리케이션을 제거하려면 HCP Waypoint에서 애플리케이션을 삭제하거나, HCP Waypoint 애플리케이션과 연결된 Terraform 리소스와 HCP Terraform 워크스페이스를 삭제해야 해요. 자세한 방법은 파괴 및 삭제를 참고해 주세요.

템플릿을 삭제하려면 다음 단계를 완료해 주세요:

HCP 포털에 로그인하고 Services 메뉴에서 Waypoint를 클릭해요.
사이드바에서 Templates를 클릭한 다음 삭제하려는 템플릿을 클릭해요.
Manage 버튼을 클릭하고 Delete template을 선택해요.
모달에서 "DELETE"를 입력하고 Delete를 클릭해요.

다음 단계

템플릿을 만든 후 HCP Waypoint로 무엇을 할 수 있는지 자세히 알아보려면 다음 주제를 참고해 주세요:

HCP Waypoint 템플릿 생성 및 관리