서버 등록하기

Alpacon에 서버를 등록하여 브라우저에서 관리할 수 있습니다.

사용자 서버란?

사용자 서버는 개별 사용자 또는 사용자 그룹이 운영 중인 서버를 의미합니다. Alpacon은 다음 두 가지 유형의 서버를 모두 지원합니다:

• 클라우드 기반 서버 (예: AWS, GCP, Azure)
• 온프레미스 서버 (사용자가 직접 관리하는 서버)

클라우드 서버와 온프레미스 서버를 혼합 운영하는 하이브리드 환경에서도, Alpacon의 일관된 UI/UX를 통해 동일한 방식으로 모든 서버를 관리할 수 있습니다.

주요 이점:

• 모든 서버 유형에 대한 통합 관리 인터페이스
• 서버 위치와 무관한 일관된 경험
• 클라우드와 온프레미스 구분 불필요
• 중앙 집중식 제어 및 모니터링

등록 절차

서버 등록은 3단계로 진행됩니다:

1. 등록 방식 선택—등록 방법 선택
2. 정보 입력—서버 세부 정보 입력 (방식별 상이)
3. 설치 가이드—생성된 설치 스크립트 또는 명령어 실행

등록 방식

스크립트로 등록

대상 서버에서 생성된 설치 스크립트를 직접 실행하여 서버를 등록합니다.

1단계: 등록 방식 선택

1. 좌측 사이드바에서 Servers 클릭
2. 우측 상단의 서버 등록 버튼 클릭
3. 스크립트로 등록 선택

2단계: 서버 정보 입력

• 서버 이름 (필수)—소문자, 숫자, 하이픈, 언더스코어만 가능 (최대 20자)
• 플랫폼 (필수)—서버 OS 선택 (Debian 기반 또는 Red Hat 기반)
• 접근 제어—이 서버에 접근할 그룹 지정:
  • 모든 그룹—모든 워크스페이스 멤버 (Alpacon users 그룹)
  • 관리자만—워크스페이스 관리자만
  • 특정 그룹—하나 이상의 그룹 선택

3단계: 에이전트 설치

설치 스크립트가 자동으로 생성되어 화면에 표시됩니다.

1. 생성된 설치 스크립트 복사
2. 대상 서버의 터미널에 접속
3. 스크립트를 붙여넣고 실행
4. 설치 완료 대기 (약 1-2분 소요)
5. 서버 목록으로 돌아가 상태가 Connected로 표시되는지 확인

설치 스크립트 예시:

curl -sSL https://install.alpacon.io/agent | sudo bash -s -- --token YOUR_TOKEN

토큰으로 등록

사전 발급된 서버 등록 토큰과 CLI 명령어를 사용하여 서버를 등록합니다. 여러 서버의 등록을 자동화하는 데 적합한 방식입니다.

1단계: 등록 방식 선택

1. 좌측 사이드바에서 Servers 클릭
2. 우측 상단의 서버 등록 버튼 클릭
3. 토큰으로 등록 선택

2단계: 서버 정보 입력

• 플랫폼 (필수)—서버 OS 선택
• 서버 이름—소문자, 숫자, 하이픈, 언더스코어만 가능 (최대 20자), 생성될 서버의 이름 접두어로 사용됩니다. 지정하지 않으면 서버의 호스트 이름이 사용됩니다.
• 등록 토큰—드롭다운에서 기존 토큰 선택 또는 새 토큰 만들기를 클릭하여 즉석에서 생성

3단계: 에이전트 설치

토큰 기반 CLI 설치 명령어가 생성되어 화면에 표시됩니다.

1. 생성된 명령어 복사
2. 대상 서버에서 실행
3. 설치 완료 대기
4. 서버 목록에서 상태가 Connected로 표시되는지 확인

AWS Cloud-Init (곧 제공 예정)

AWS Cloud-Init user data를 사용하여 EC2 인스턴스 프로비저닝 시 서버를 자동으로 등록합니다.

Terraform (곧 제공 예정)

Terraform provider를 사용하여 Infrastructure as Code 워크플로우의 일부로 서버 프로비저닝과 등록을 동시에 수행합니다.

Ansible (곧 제공 예정)

Ansible playbook을 사용하여 서버 등록을 자동화합니다.

지원 플랫폼

Debian 기반:

• Ubuntu
• Debian

Red Hat 기반:

• RHEL (Red Hat Enterprise Linux)
• CentOS
• Amazon Linux
• Rocky Linux
• Fedora
• Oracle Linux

필수 요구사항

서버 요구사항:

• Linux 기반 운영체제
• 인터넷 연결
• sudo 권한 (설치 시)

네트워크:

• 아웃바운드 HTTPS 연결 가능 (포트 443)
• Alpacon API 서버 접근 가능

문제 해결

연결 상태가 “Disconnected”로 표시되는 경우:

1. 에이전트 상태 확인:

sudo systemctl status alpamon

2. 에이전트 재시작:

sudo systemctl restart alpamon

3. 로그 확인:

sudo journalctl -u alpamon -n 50

설치 실패 시:

• sudo 권한 확인
• 인터넷 연결 확인
• 지원 플랫폼인지 확인

보안 고려사항

에이전트 통신:

• 모든 통신은 TLS 암호화
• 서버에서 Alpacon으로의 아웃바운드 연결만 필요
• 인바운드 포트 오픈 불필요

인증:

• 각 서버는 고유한 토큰으로 인증
• 토큰은 설치 시에만 사용되며 서버에 안전하게 저장

다음 단계

서버 등록 후:

• 서버 접속하기
• 서버 접근 제어하기
• 서버 모니터링