---
title: "자동화 및 연동"
description: "Alpacon을 CI, 인증, 알림, AI 도구와 연결합니다. 자동화 주체와 접근 범위를 정한 뒤 여러 서버에 배포하고, 실행 결과와 오류를 확인하는 방법을 안내합니다. GitHub Actions와 다른 CI 환경에서 쓸 자격 증명을 준비하고 명령어 기록을 확인하세요."
---

> Full documentation index: https://docs.alpacax.com/llms.ko.txt

# 자동화 및 연동

<span id="배포-개요" />
<span id="alpacon과-통합하기" />

연동할 도구를 고르고 작업에 필요한 신원과 권한을 준비한 뒤 간단한 작업으로 확인하세요.

## 자동화 접근 준비

<span id="할-수-있는-일" />
<span id="api-기반-배포" />
<span id="토큰" />
<span id="보안-고려사항" />

CI/CD나 스크립트로 명령어를 실행하거나 파일을 전송할 때는 [Application을 만들고](/use/iam/applications/) [서비스 토큰을 발급](/use/iam/applications/service-tokens/)하세요. 작업에 필요한 접근 범위와 서버, 명령어, 파일 규칙만 부여합니다. 키는 CI/CD의 시크릿 저장소에 보관하세요. 환경별로 토큰을 분리하고 정기적으로 키를 교체하며, 작업을 중단할 때는 토큰을 비활성화하세요. 개인 API 토큰과 서버 등록 토큰을 포함한 차이는 [토큰 유형과 사용 기간](/reference/tokens/)에서 확인할 수 있습니다.

<span id="다중-서버-명령-실행" />
<span id="다중-서버-명령" />

여러 서버에서 명령어를 실행하려면 필요한 명령어 기능을 포함해 [작업 세션을 요청](/use/work-sessions/create/)하고 [`alpacon exec`](/reference/cli/exec/)를 사용하세요. 순차 배포, 설정 변경, 유지보수 스크립트, 상태 점검에 쓸 수 있습니다. 여러 서버를 대상으로 할 때는 [작업 세션 기능](/reference/work-session-features/)과 [서버 그룹](/use/servers/groups/)을 확인하세요.

먼저 스테이징 서버에서 명령어를 시험하세요. 실행 후에는 [명령어 기록](/use/audit/events/commands/)을 확인하고 배포 변경을 되돌릴 방법을 준비하세요.

## ID 공급자

  
    중앙 집중식 인증을 위해 조직의 ID 공급자와 통합하세요.
  

## 팀 알림과 승인

  
    Slack 앱을 연결해 알림 채널을 지정하고 멤버 계정을 연결하세요. 승인 요청도 Slack에서 검토할 수 있습니다.
  

## CI/CD 플랫폼

공식 통합은 GitHub Actions이며 네 가지 액션을 공개합니다. 다른 CI 도구는 범위를 제한한 서비스 토큰으로 CLI와 REST API를 호출해 Alpacon을 다루며, 아래 가이드에서 방법을 안내합니다.

  
    공식 Alpacon 액션으로 배포를 자동화하세요.
  
  
    CLI 컨테이너로 GitLab CI/CD에서 Alpacon을 실행하세요.
  
  
    CLI 컨테이너로 Jenkins 파이프라인에서 Alpacon을 실행하세요.
  

## 자동화 가이드

<span id="통합-가이드" />
<span id="일반적인-통합-패턴" />
<span id="배포-자동화" />
<span id="api-기반-자동화" />

  
    직접 만든 연동에서 범위를 제한해 명령어와 파일 전송을 실행하세요.
  
  
    애플리케이션 계정과 서비스 토큰으로 플레이북을 실행하세요.
  
  
    토큰, 계정, 접근 규칙, sudo 오류의 원인을 확인하세요.
  

## AI 에이전트

  
    Claude, Cursor, VS Code 등 AI 어시스턴트를 Alpacon MCP 서버로 연결해 범위가 제한되고 감사되는 접근을 제공하세요.
  

## 통합의 이점

- **CI/CD에 SSH 키 불필요**: 대신 범위가 제한된 서비스 토큰 사용
- **감사 기록**: 명령어 기록과 토큰 활동 확인
- **명령 ACL**: 자동화가 실행할 수 있는 것을 제한
- **반복 가능한 작업**: 범위가 제한된 토큰으로 스크립트와 CI 작업 실행

## 시작하기

1. 자동화를 위한 [서비스 토큰 발급](/use/iam/applications/service-tokens/)
2. 위에서 통합 플랫폼 선택
3. 플랫폼별 가이드 따르기
4. 먼저 간단한 명령으로 테스트

## 도움이 필요하신가요?

<span id="관련-문서" />

- [API 레퍼런스](/reference/api/) - 완전한 API 문서
- [CLI 레퍼런스](/reference/cli/) - 모든 CLI 명령
- [문제 해결](/use/troubleshooting/) - 일반적인 통합 문제

Source: https://docs.alpacax.com/ko/integrate/