Alpacon Exec Action

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

참고

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

입력값

이름설명필수기본값
workspace-urlAlpacon 워크스페이스 URL예
service-tokenAlpacon 서비스 토큰 키(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을 먼저 실행해야 합니다
  • 작업 디렉터리를 바꾼 뒤 실행할 명령어는 cd /opt/myapp && git pull처럼 한 줄에 작성하세요
  • 빈 줄과 주석 줄(#으로 시작)은 건너뜁니다
  • 서비스 토큰에서는 groupname이 무시되며, 명령은 서비스 계정의 전용 그룹으로 실행됩니다
  • 시스템 서비스 재시작 예제에는 sudo 설정과 명령어 규칙이 필요합니다

함께 보기

리소스

최종 수정: