Algolia CLI

인증 및 애플리케이션 관리

브라우저를 통해 Algolia 계정에 로그인하거나, 브라우저가 없는 환경에서는 –no-browser 옵션을 사용하여 인증할 수 있습니다. 인증 상태는 algolia auth status 명령으로 확인할 수 있으며, 애플리케이션 목록 조회, 선택, 생성을 통해 작업 대상 애플리케이션을 설정할 수 있습니다.

인덱스 및 레코드 관리

선택한 애플리케이션에 대해 인덱스 목록을 조회하고, 레코드를 가져오거나 검색할 수 있습니다. 예를 들어, algolia objects import MOVIES -F movies.ndjson 명령으로 NDJSON 형식의 레코드를 인덱스에 가져올 수 있고, algolia search MOVIES --query "toy story" 명령으로 특정 쿼리와 일치하는 레코드를 검색할 수 있습니다.

추가 명령 지원

algolia 명령만 입력하면 사용 가능한 모든 명령 목록을 확인할 수 있으며, 개별 명령에 --help 옵션을 추가하면 자세한 사용법과 옵션을 볼 수 있습니다. 예를 들어, algolia indices list 명령으로 현재 애플리케이션의 모든 인덱스를 목록화할 수 있습니다.

다운로드·설치 방법

Windows 환경에서는 Chocolatey 패키지 관리자를 통해 choco install algolia 명령으로 설치할 수 있습니다. 또는 GitHub releases 페이지에서 algolia_*_windows_*.zip 형식의 아카이브를 다운로드한 후 압축을 해제하여 사용할 수 있습니다. Node.js가 설치되어 있다면 npx @algolia/cli --help 명령으로 설치 없이 바로 실행해볼 수도 있으며, 전역 설치를 원한다면 npm install -g @algolia/cli 명령을 사용할 수 있습니다.

기본 사용법/명령어

설치 후 먼저 algolia auth login 명령을 실행하여 브라우저를 통해 Algolia 계정에 로그인해야 합니다. 브라우저가 없는 환경(SSH, 컨테이너 등)에서는 algolia auth login --no-browser 명령을 사용합니다. 로그인 후 algolia application list로 애플리케이션 목록을 확인하고, algolia application select로 사용할 애플리케이션을 선택하거나, algolia application create --name "My App" --region EU 명령으로 새 애플리케이션을 생성할 수 있습니다. 애플리케이션이 선택된 상태에서 algolia objects import 및 algolia search 명령으로 인덱스 작업을 수행할 수 있습니다.

이런 경우에 유용합니다

Algolia를 사용하는 개발 팀이 터미널이나 스크립트에서 인덱스 업데이트, 레코드 가져오기, 검색 테스트 등을 자동화하고자 할 때 유용합니다. 특히 CI/CD 파이프라인에서 배포 과정의 일부로 Algolia 인덱스를 프로그래밍 방식으로 관리해야 하는 경우에 적합합니다. 브라우저 없이도 인증이 가능하므로 서버 환경이나 컨테이너에서도 사용할 수 있습니다.

지원 환경·시스템 요구사항

Algolia CLI는 Windows, macOS, Linux 운영 체제에서 AMD64 및 ARM64 아키텍처를 지원합니다. Windows에서는 Chocolatey 또는 ZIP 아카이브를 통해 설치할 수 있으며, Node.js가 설치되어 있다면 npx를 통해 설치 없이도 실행할 수 있습니다. 소스 코드에서 직접 빌드하려면 Go 1.23 이상과 Go task가 필요합니다.

최신 버전·업데이트

현재 버전은 1.17.0이며, 최신 변경 사항 및 업데이트 내역은 GitHub 저장소의リリース 페이지에서 확인할 수 있습니다.