HCP Waypoint에서 HCP Terraform 연동 구성하기
HCP Waypoint에서 HCP Terraform 연동 구성하기
이 페이지는 HCP Waypoint와 HCP Terraform 조직이 상호작용하도록 구성하는 방법을 설명해요. 플랫폼 엔지니어가 자주 수행하는 작업이에요.
출처: 문서
본문
개요
HCP Waypoint 템플릿과 애드온 정의는 모두 HCP Terraform no-code 모듈을 활용해 애플리케이션과 그 기반 인프라를 배포해요. 따라서 HCP Waypoint가 HCP Terraform에 연결할 수 있도록 HCP Terraform 조직 이름과 팀 토큰을 제공해야 해요.
애플리케이션 개발자가 템플릿을 사용하거나 애드온을 설치하면, HCP Waypoint는 HCP Terraform API를 호출해 새 워크스페이스를 만들고 HCP Terraform run을 트리거해요. 애플리케이션 개발자가 애플리케이션을 파괴하거나 애드온을 제거하면, HCP Waypoint는 destroy run을 트리거하고 HCP Terraform에서 워크스페이스를 삭제해요.
HCP Waypoint 템플릿이나 애드온을 만들거나 사용하려면 먼저 HCP Terraform으로 HCP Waypoint를 구성해야 해요.
사전 요구사항
- HCP Waypoint가 활성화된 HCP 계정. 계정 생성 방법은 HCP 계정 문서를 참고해 주세요.
- Standard 에디션의 HCP Terraform 조직. HCP Terraform은 HCP Terraform no-code 모듈과 프라이빗 모듈 레지스트리를 사용하려면 Standard 에디션이어야 해요.
HCP Terraform에서 팀 토큰 만들기
참고: HashiCorp Cloud Platform(HCP) 유럽 조직에서는 HCP 그룹을 통해 사용자 접근을 관리해요. HCP Terraform은 HCP에서 그룹과 역할을 상속받아요. HCP 유럽 조직에 있다면 이 단계에서 팀 토큰 대신 그룹과 그룹 API 토큰을 만들어요. 자세한 내용은 유럽에서 HCP Terraform 사용하기를 참고해 주세요.
배포하려는 HCP Terraform 프로젝트에만 접근할 수 있는, HCP Waypoint 전용의 전용 HCP Terraform 팀과 팀 토큰을 만들어요. 팀 토큰 생성에 대한 정보는 Terraform 문서의 팀 API 토큰을 참고해 주세요.
토큰에는 다음 프로젝트 팀 권한이 있어야 해요:
- 프로젝트 읽기
- 워크스페이스 생성
- 워크스페이스 삭제
- run 적용
- 변수 읽기 및 쓰기
- 상태에 대한 출력 전용 접근
필요한 권한에 대한 자세한 내용은 HCP Terraform 토큰 권한을 참고해 주세요.
HCP Waypoint 구성하기
- HCP 포털에 로그인하고 Services 메뉴에서 Waypoint를 클릭해요.
- HCP Terraform에서 팀 토큰 만들기에서 만든 HCP Terraform 팀 토큰을 입력해요.
- HCP Terraform 조직의 이름을 선택해요.
- Save를 클릭해요.
다음 단계
HCP Terraform으로 구성한 후 HCP Waypoint로 무엇을 할 수 있는지 자세히 알아보려면 다음 주제를 참고해 주세요: