Upstash의 핵심 목표 중 하나는 모든 개발자가 다양한 도구를 활용해 손쉽게 Upstash 리소스를 생성하고 관리할 수 있도록 지원하는 것입니다. 지금까지 Developer API와 Terraform Provider를 순차적으로 공개해 왔으며, 이번에는 마침내 Upstash CLI가 그 뒤를 잇습니다.
@upstash/cli 소개
Upstash는 커맨드라인 도구를 통해 개발자 누구나 단 한 줄의 명령어로 자신만의 Upstash 리소스를 생성할 수 있게 되었다는 소식을 발표하게 되어 기쁩니다.
Upstash CLI는 GitHub, npm, 그리고 사전 빌드된 바이너리 파일을 통해 이용할 수 있습니다.
시작하기
Upstash CLI를 사용하려면 개발자 API 키가 필요합니다. 새로운 API 키는 Upstash 콘솔에서 간단히 생성할 수 있습니다.
npm을 통해 전역으로 설치하려면 아래 명령어를 실행하세요.
npm install -g @upstash/cli
또는 GitHub의 릴리스 페이지에서 사전 빌드된 바이너리를 다운로드할 수도 있습니다.
설치를 마친 후에는 로그인 명령어를 실행하세요. 이메일과 API 키 입력을 요청받게 됩니다.
upstash auth login
이것으로 끝입니다! 이제 로그인이 완료되었으며, 커맨드라인에서 언제든지 Upstash 리소스를 관리할 수 있습니다.
명령어의 용도가 확실하지 않다면 --help 플래그를 사용해 보세요. 사용 가능한 모든 명령어와 옵션에 대한 설명을 확인할 수 있습니다.
upstash redis --help
모든 파라미터는 CLI를 통해 직접 지정할 수 있지만, 필수 파라미터가 누락된 경우 CLI가 친절하게 값을 물어봅니다.
리소스 생성하기
Redis 데이터베이스 생성
upstash redis create --name=cli-powered-db --region=eu-central-1
Redis 데이터베이스를 만들 때는 데이터베이스 이름과 리전(region)만 지정하면 됩니다. TLS, 멀티존(multizone) 등 선택적인 옵션 플래그도 함께 제공할 수 있습니다.
Kafka 클러스터 생성
upstash kafka create --name=$name --region=$region
Redis와 마찬가지로 Kafka 리소스 역시 이름과 리전이라는 두 가지 파라미터만 필요합니다. 클러스터 생성 후에는 다음과 같이 토픽을 추가할 수 있습니다.
upstash kafka topic create --name=mytopic --cluster-id=$id
기타 주요 명령어
Upstash CLI는 Upstash 리소스에 대한 CRUD(생성·조회·수정·삭제) 작업을 수행할 수 있는 다양한 명령어를 제공합니다.
-
Team: 팀과 팀 멤버를 관리할 수 있습니다.
upstash team -
Redis: Redis 데이터베이스를 생성, 수정, 삭제할 수 있습니다.
upstash redis -
Kafka: Kafka 클러스터와 토픽을 생성, 수정, 삭제할 수 있습니다.
upstash kafka cluster upstash kafka topic
마치며
사용 중 궁금한 점이 있다면 GitHub 또는 아래 채널을 통해 언제든지 문의해 주세요.