본문으로 건너뛰기
버전: docs v25.02

CLI 참조

Updated 2025.08.26

이 문서는 ALO-LLM 명령줄 인터페이스(CLI)에 대한 참조를 제공합니다.

register / deploy / activate 단계의 Service API list 조회​

Register 되어있는 서비스 API List 확인 (alm register --list)​

  • 서비스를 등록한 후에는 alm register 명령어로 AI Conductor의 workspace에 등록된 서비스 목록을 확인할 수 있습 니다. 이 명령을 실행하면 현재까지 등록된 모든 서비스가 나열됩니다:
alm register --list
alm register -l

실행 결과로 서비스의 이름 목록이 출력됩니다. 새로 등록한 서비스도 이 목록에서 확인할 수 있습니다. 이를 통해 방금 등록한 서비스가 제대로 등록되었는지 검증할 수 있습니다. 실행 결과로 보여지는 서비스 API들은 계정 Login을 수행했을 때 설정한 workspace에 등록된 List입니다. workspace를 변경하기 위해서는 로그인 절차를 다시 수행하여야 합니다.

성공적으로 실행된 경우 아래와 같이 AI Conductor 특정 workspace에 등록되어있는 Service API 전체 List가 보여집니 다.

API Names
survey-genius-cloud-service
aipack
ALO-chatbot

Deploy 되어있는 서비스 API List 확인 (alm deploy --list)​

  • 서비스 운영 환경에 deploy되어있는 서비스 API를 확인하기 위한 명령어입니다.
alm deploy --list
alm deploy -l
  • Login시 설정한 AI Conductor Workspace에 등록된 서비스 API 중 Deploy된 List 전체를 보여줍니다.
Deployed API Names
survey-genius-cloud-service
alochat-0710
ald-ym-alochat-3

Activate 되어있는 서비스 API List 확인 (alm activate --list)​

  • 서비스 운영 환경에 activate되어있는 서비스 API를 확인하기 위한 명령어입니다.
alm activate --list
alm activate -l
  • Login시 설정한 AI Conductor Workspace에 등록된 서비스 API 중 Activate된 List 전체를 보여줍니다.
Activate API Names
chatbot-rag (vl)

register / deploy / activate 단계의 Service API 삭제​

더 이상 필요하지 않은 서비스나 배포 인스턴스는 CLI를 통해 삭제할 수 있습니다. 삭제 명령어는 세 가지가 있으며, 용도에 맞게 사용해야 합니다: 등록된 Service API를 삭제하고자 하는 경우 Activate -> Deploy -> Register 순으로 삭제 해야합니다.

Register 되어있는 서비스 API 삭제 (alm register --delete)​

등록된 서비스 자체를 레지스트리에서 삭제하는 명령어입니다. 이는 해당 서비스에 대한 메타데이터(이름, 설명 등)를 플랫폼에 서 지우는 동작으로, 완전히 서비스를 없앨 때 사용합니다.

등록한 서비스를 삭제하기 위해서는 아래 명령어가 필요합니다.

alm register --delete (Service API Name)
alm register -d (Service API Name)
  • 실행 결과로 삭제된 서비스 이름이 출력됩니다.
Registration Deleted!
Name: survey-genius-cloud-service
Versions: N/A

Deploy 되어있는 서비스 API 삭제 (alm deploy --delete)​

Deploy된 서비스를 삭제하기 위해서는 아래 명령어가 필요합니다.

alm deploy --delete (Service API Name)
alm deploy -d (Service API Name)
  • 실행 결과로 삭제된 서비스 이름이 출력됩니다.
Deploy Delete Success:
name: survey-genius-cloud-service

Activate 된 서비스 API Deactivate (alm deactivate)​

이 명령을 실행하면 해당 서비스의 클라우드 인스턴스가 중지되고 제거됩니다. 삭제 후에는 더 이상 해당 URL로 서비스에 접근 할 수 없게 됩니다. (배포 리소스가 해제되므로 과금이나 자원 점유도 중단됨)

더 이상 필요하지 않은 서비스나 배포 인스턴스를 CLI 명령어를 통해 삭제할 수 있습니다.

alm deactivate --name (Service API Name)
alm deactivate -n (Service API Name)

기타 CLI 명령어​

현재 workspace 정보 확인 (alm get --workspace_info)​

  • alm login 후 현재 default로 설정된 workspace의 정보를 알 수 있습니다.
alm get --workspace_info
alm get -w
  • 아래와 같이 세부 정보가 표시됩니다.
Workspace info: {'name': 'test-ws', 'display_name': 'test', 'mode': 'LLM', 'cloud': 'AWS', 's3_bucket_name':
's3-an2-llmops-dev-aia', 'ecr_base_path': '339713051385.dkr.ecr.ap-northeast-2.amazonaws.com/ecr-an2-llmops-
dev/test/ai-solutions/', 'edge_conductor_url': 'https://edge@lge.com', 'specs': [{'name': 'standard',
'display_name': 'STANDARD#2vCPU:8GB', 'label': 'test-ws-standard', 'instance': 'm5.large', 'instance_type':
'CPU', 'vcpu': 2, 'ram_gb': 8, 'gpu': 0, 'gpu_ram_gb': 0}]}

사용가능한 base image 목록 확인 (alm get --image_info)​

  • Service API 배포 시 사용 가능한 base image 목록을 확인할 수 있습니다.
alm get --image_info
alm get -i
  • 아래와 같이 사용 가능한 base image 목록이 출력됩니다.
Base image list
python-3.13
python-3.12-slim
python-3.13-bullseye
python-3.11
python-3.12-bullseye
python-3.12
erp-mcp
python-3.11-bullseye
python-3.13-slim
nginxdemos-hello
python-3.11-slim
python-3.12-slim-bullseye
python-3.11-slim-bullseye
python-3.13-slim-bullseye
echo-server

현재 AI Logic Deployer 버전 확인 (alm get --version)​

  • 현재 사용중인 AI Logic Deployer와 AI Conductor의 버전을 확인할 수 있습니다.
alm get --version
alm get -v
  • 아래와 같이 현재 사용중인 AI Logic Deployer의 버전이 표시됩니다.

0.10.1

workspace 변경 방법​

  • workspace를 변경은 재로그인을 통해 진행됩니다.
alm login
Please enter your AI Conductor ID: gildong.hong
Please enter your AI Conductor password: **********
  • 로그인 후 접근 가능한 workspace가 여러개인 경우, 사용자는 원하는 workspace를 입력하여 사용하게됩니다.
File /home/gildong.hong/.token/key.json has been removed for initialization.
access_token has been updated in /home/gildong.hong/.token/key.json
Login success
test2-ws has been updated in /home/gildong.hong/.token/key.json
test-ws has been updated in /home/gildong.hong/.token/key.json
test1-ws has been updated in /home/gildong.hong/.token/key.json
You can access these workspaces: ['test2-ws', 'test-ws', 'test1-ws']
Please input default workspace: test1-ws
default_ws has been updated in /home/gildong.hong/.token/key.json
Default workspace: test1-ws

위 예제는 test1-ws를 선택한 상황입니다.