HCP CLI 설치하기

HCP CLI 설치하기

HCP Cloud Platform을 명령줄에서 다루고 싶다면 HCP CLI(hcp)를 설치하면 되는데요, hcp CLI는 미리 컴파일된 바이너리 또는 여러 운영체제용 패키지로 제공돼요. 이 글에서는 각 환경별 설치 방법과 설치 확인, 그리고 탭 자동 완성(tab autocomplete) 설정 방법을 설명해 드릴게요.

출처: 문서

본문

hcp CLI는 미리 컴파일된 바이너리 형태 또는 여러 운영체제용 패키지로 제공돼요.

macOS에서 Homebrew로 설치하기

Homebrew는 Mac OS X용 무료 오픈소스 패키지 관리 시스템이에요. 공식 hcp CLI formula를 터미널에서 설치해요.

  1. HashiCorp tap(모든 HashiCorp Homebrew 패키지의 저장소)을 설치해요.
$ brew tap hashicorp/tap
  1. hashicorp/tap/hcp로 hcp를 설치해요.
$ brew install hashicorp/tap/hcp

참고

이렇게 하면 서명된 바이너리가 설치되며, 새 공식 릴리스가 나올 때마다 자동으로 업데이트돼요.

  1. 최신 버전으로 업그레이드하려면 brew upgrade를 실행해요.
$ brew upgrade hashicorp/tap/hcp

Linux 패키지로 설치하기

HashiCorp는 다음 Linux 배포판용 패키지를 공식적으로 관리하고 서명해요.

Ubuntu/Debian

  1. 필요한 패키지를 설치해요.
$ sudo apt-get update && \
  sudo apt-get install wget gpg coreutils
  1. HashiCorp GPG key를 추가해요.
$ wget -O- https://apt.releases.hashicorp.com/gpg | sudo gpg --dearmor -o /usr/share/keyrings/hashicorp-archive-keyring.gpg
  1. 공식 HashiCorp Linux 저장소를 추가해요.
$ echo "deb [signed-by=/usr/share/keyrings/hashicorp-archive-keyring.gpg] https://apt.releases.hashicorp.com $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/hashicorp.list
  1. 업데이트하고 설치해요.
$ sudo apt-get update && sudo apt-get install hcp

CentOS/RHEL

  1. 저장소를 관리할 yum-config-manager를 설치해요.
$ sudo yum install -y yum-utils
  1. 공식 HashiCorp Linux 저장소를 추가해요.
$ sudo yum-config-manager --add-repo https://rpm.releases.hashicorp.com/RHEL/hashicorp.repo
  1. 업데이트하고 설치해요.
$ sudo yum -y update && sudo yum -y install hcp

Fedora

  1. 저장소를 관리할 dnf config-manager를 설치해요.
$ sudo dnf install -y dnf-plugins-core
  1. 공식 HashiCorp Linux 저장소를 추가해요.
$ sudo dnf config-manager --add-repo https://rpm.releases.hashicorp.com/fedora/hashicorp.repo
  1. 업데이트하고 설치해요.
$ sudo dnf -y update && sudo dnf -y install hcp

Amazon Linux

  1. 저장소를 관리할 yum-config-manager를 설치해요.
$ sudo yum install -y yum-utils
  1. 공식 HashiCorp Linux 저장소를 추가해요.
$ sudo yum-config-manager --add-repo https://rpm.releases.hashicorp.com/AmazonLinux/hashicorp.repo
  1. 업데이트하고 설치해요.
$ sudo yum -y update && sudo yum -y install hcp

수동 설치

미리 컴파일된 바이너리를 다운로드해 로컬 머신에서 실행할 수 있어요. 제공되는 SHA-256 합계로 바이너리를 검증할 수도 있어요. hcp를 다운로드한 뒤 패키지의 압축을 풀어요. 다른 가이드를 계속 진행하기 전에 hcp 바이너리가 PATH에서 사용 가능한지 확인해 주세요.

설치 확인하기

hcp 명령으로 HCP CLI가 올바르게 설치되었는지 확인해요. 이 명령은 사용할 수 있는 명령과 플래그 목록을 반환해요.

$ hcp
USAGE
  hcp <command> [Optional Flags]

DESCRIPTION
  The HCP Command Line Interface is a unified tool to manage your HCP services.

COMMAND GROUPS
  auth:           Authenticate to HCP.
  iam:            Identity and access management.
  organizations:  Interact with an existing organization.
  profile:        View and edit HCP CLI properties.
  projects:       Create and manage projects.
  waypoint:       Manage Waypoint.

COMMANDS
  version:  Display the HCP CLI version.

GLOBAL FLAGS
  --debug
    Enable debug output.

  --format=FORMAT
    Sets the output format.

  --profile=NAME
    The profile to use. If omitted, the currently selected profile will be used.

  --project=ID
    The HCP Project ID to use. If omitted the current project set in the
    configuration is used.

  --quiet
    Minimizes output.

탭 자동 완성 설치하기

참고

Linux 패키지 중 하나로 CLI를 설치했다면 자동 완성이 자동으로 설치됐을 거예요.

HCP CLI용 자동 완성(autocompletion)을 설치해요.

$ hcp -autocomplete-install

자동 완성이 적용되려면 새 터미널 세션을 만들거나 터미널 구성을 소스(source)해야 해요.

HCP CLI용 자동 완성을 제거하려면 -autocomplete-uninstall을 사용해요.

$ hcp -autocomplete-uninstall

더 알아보기 (Learn more)

  • HCP CLI 시작하기 — 설치 후 로그인과 기본 사용 방법을 살펴볼 수 있어요.
  • hcp 명령어 — HCP CLI가 제공하는 명령 그룹과 전역 플래그를 확인할 수 있어요.
  • hcp profile init — 조직과 프로젝트를 설정하는 방법을 살펴볼 수 있어요.