---
title: "Alpacon Exec Action"
description: "Alpacon Exec Action으로 원격 서버에서 셸 명령을 실행하세요. GitHub Actions 워크플로에서 여러 줄로 작성한 스크립트와 환경 변수를 액션에 전달하는 방법을 알아봅니다. 배포 예제를 보고 대상 서버를 고른 뒤 명령을 실행할 서버 계정을 지정하세요."
---

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

# Alpacon Exec Action

Alpacon Exec Action은 스크립트의 각 줄을 [`alpacon exec`](/reference/cli/exec/) 명령으로 원격 서버에서 실행합니다. 명령을 실행할 서버 계정을 지정하고 환경 변수를 전달할 수 있습니다.

  `uses: alpacax/alpacon-websh-action@v1`을 `uses: alpacax/alpacon-exec-action@v2`로 바꾸고, `api-token` 입력값의 이름을 `service-token`으로 바꾸세요. GitHub는 액션 리포지토리 이름이 바뀌어도 `uses:` 참조를 새 이름으로 연결하지 않습니다. 이전 이름을 쓰는 워크플로는 `repository not found` 오류로 실패합니다.

## 입력값

| 이름 | 설명 | 필수 | 기본값 |
|------|------|------|--------|
| `workspace-url` | Alpacon 워크스페이스 URL | 예 | |
| `service-token` | Alpacon 서비스 토큰 키(`alpst-`) | 예 | |
| `target` | 대상 서버 이름 | 예 | |
| `script` | 실행할 셸 명령 또는 스크립트 | 예 | |
| `username` | 명령어를 실행할 애플리케이션의 서버 계정 | 아니오 | |
| `groupname` | 그룹 변경(서비스 토큰에서는 무시되며, 명령은 서비스 계정의 전용 그룹으로 실행) | 아니오 | |
| `env` | 환경 변수 (줄당 하나, `KEY=VALUE` 또는 `KEY` 형식) | 아니오 | |

## 사용법

### 기본 명령 실행

```yaml
- name: Deploy application
  uses: alpacax/alpacon-exec-action@v2
  with:
    workspace-url: ${{ secrets.ALPACON_WORKSPACE_URL }}
    service-token: ${{ secrets.ALPACON_SERVICE_TOKEN }}
    target: 'prod-server'
    username: 'ci-deploy'
    script: |
      cd /opt/myapp && git pull && npm install && pm2 restart app
```

### 애플리케이션 계정으로 실행

```yaml
- name: Copy files as the application account
  uses: alpacax/alpacon-exec-action@v2
  with:
    workspace-url: ${{ secrets.ALPACON_WORKSPACE_URL }}
    service-token: ${{ secrets.ALPACON_SERVICE_TOKEN }}
    target: 'web-server'
    username: 'ci-deploy'
    script: cp -r /tmp/build/. /home/ci-deploy/app/public/
```

### 환경 변수 전달

```yaml
- name: Run with environment variables
  uses: alpacax/alpacon-exec-action@v2
  with:
    workspace-url: ${{ secrets.ALPACON_WORKSPACE_URL }}
    service-token: ${{ secrets.ALPACON_SERVICE_TOKEN }}
    target: 'prod-server'
    username: 'ci-deploy'
    env: |
      APP_ENV=production
      DB_HOST=localhost
      LOG_LEVEL=info
    script: |
      echo "Deploying to $APP_ENV"
      sudo systemctl restart myapp
```

`env` 입력은 두 가지 형식을 지원합니다:
- `KEY=VALUE`: 지정된 값으로 변수를 설정
- `KEY`: 러너 환경의 변수를 전달

## 참고

- [`alpacon-setup-action`](/reference/actions/setup/)을 먼저 실행해야 합니다
- 작업 디렉터리를 바꾼 뒤 실행할 명령어는 `cd /opt/myapp && git pull`처럼 한 줄에 작성하세요
- 빈 줄과 주석 줄(`#`으로 시작)은 건너뜁니다
- 서비스 토큰에서는 `groupname`이 무시되며, 명령은 서비스 계정의 전용 그룹으로 실행됩니다
- 시스템 서비스 재시작 예제에는 [sudo 설정과 명령어 규칙](/integrate/github-actions/#sudo로-서비스-재시작)이 필요합니다

## 함께 보기

- [Actions 레퍼런스 개요](/reference/actions/)
- [alpacon-setup-action](/reference/actions/setup/)
- [alpacon-cp-action](/reference/actions/cp/)
- [alpacon-common-action](/reference/actions/common/)

## 리소스

- [GitHub Marketplace](https://github.com/marketplace/actions/alpacon-exec-action)
- [소스 코드](https://github.com/alpacax/alpacon-exec-action)

Source: https://docs.alpacax.com/ko/reference/actions/exec/
