시작하기

Alpacon CLI는 터미널 환경에서 Alpacon 서비스를 관리할 수 있는 명령줄 기반 도구입니다. 본 가이드는 CLI 설치, 서버 등록, websh 접속까지의 절차를 순차적으로 다룹니다.

1. 사전 준비사항

다음 조건을 충족했는지 먼저 확인하세요:

  • Alpacon Server가 실행 중일 것
  • Alpacon Server에 Alpamon Agent가 설치되어 작동 중일 것

2. 설치

Alpacon CLI는 운영체제별로 다양한 방법으로 설치할 수 있습니다. 아래에서 사용하는 환경에 맞는 탭을 선택하여 설치를 진행하세요.

Ubuntu / Debian

curl -s https://packagecloud.io/install/repositories/alpacax/alpacon/script.deb.sh?any=true | sudo bash
sudo apt-get install alpacon

CentOS / RHEL

curl -s https://packagecloud.io/install/repositories/alpacax/alpacon/script.rpm.sh?any=true | sudo bash
sudo yum install alpacon

GitHub Releases

VERSION=<최신버전>
wget https://github.com/alpacax/alpacon-cli/releases/download/${VERSION}/alpacon-${VERSION}-linux-amd64.tar.gz
tar -xvf alpacon-${VERSION}-linux-amd64.tar.gz
chmod +x alpacon
sudo mv alpacon /usr/local/bin

💡 각 설치 방법에 대한 최신 정보는 공식 GitHub 저장소를 참고하세요.

3. 로그인 및 로그아웃

Alpacon CLI의 모든 기능을 사용하려면 먼저 Alpacon API에 인증해야 합니다.

로그인

alpacon login [워크스페이스_URL]  # 접속하고자 하는 워크스페이스의 URL (예: alpacax.dev.alpacon.io)
Signing in to https://alpacax.dev.alpacon.io

==================== AUTHENTICATION REQUIRED ====================

Please authenticate by visiting the following URL:
https://auth.dev.alpacon.io/activate?user_code=BBHT-GNKB  # 해당 링크를 브라우저로 접속하여 사용자 인증

===============================================================

로그아웃

alpacon logout

config.json

로그인에 성공하면 다음 경로에 설정 파일이 자동으로 생성됩니다:

~/.alpacon/config.json

이 파일에는 다음 정보가 포함됩니다:

  • 워크스페이스 URL
  • API 토큰
  • 토큰 만료 시각 (약 1주일 유효)

해당 파일은 Alpacon CLI가 명령어를 실행할 때 필수적으로 사용되며, 토큰이 만료되면 다시 로그인해야 합니다.

alpacon logout 명령을 실행하면 이 config.json 파일은 삭제되며, 이후 명령어 실행을 위해 다시 로그인이 필요합니다.

재로그인 시 기본 동작

재로그인 시 config.json에 저장된 기존 워크스페이스 URL이 자동으로 재사용됩니다.
다른 워크스페이스로 로그인하려면 명령어에 새로운 URL을 명시하세요.

4. 서버 목록 조회

워크스페이스에 등록된 서버 목록을 확인하려면 다음 명령어를 실행하세요.

alpacon server ls / list / all

5. Websh 접속

서버의 Websh 터미널에 접속하려면 다음 명령어를 사용하세요.

CONNECTED 상태가 true인 서버만 접속할 수 있습니다.

기본 접속

alpacon websh [SERVER NAME]

root 권한으로 접속

root권한으로도 접속할 수 있습니다.

alpacon websh -r [SERVER NAME]

접속 종료

exit

더 알아보기

이제 Alpacon CLI의 기본 사용법을 익히셨습니다.
다양한 명령어를 통해 Alpacon 서비스를 더욱 강력하게 활용해보세요.

자세한 명령어는 CLI 전체 명령어 문서에서 확인하실 수 있습니다.