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-url | Alpacon 워크스페이스 URL | 예 | |
service-token | Alpacon 서비스 토큰 키(alpst-) | 예 | |
target | 대상 서버 이름 | 예 | |
script | 실행할 셸 명령 또는 스크립트 | 예 | |
username | 명령어를 실행할 애플리케이션의 서버 계정 | 아니오 | |
groupname | 그룹 변경(서비스 토큰에서는 무시되며, 명령은 서비스 계정의 전용 그룹으로 실행) | 아니오 | |
env | 환경 변수 (줄당 하나, KEY=VALUE 또는 KEY 형식) | 아니오 |
사용법
기본 명령 실행
- 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애플리케이션 계정으로 실행
- 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/환경 변수 전달
- 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 myappenv 입력은 두 가지 형식을 지원합니다:
KEY=VALUE: 지정된 값으로 변수를 설정KEY: 러너 환경의 변수를 전달
참고
alpacon-setup-action을 먼저 실행해야 합니다- 작업 디렉터리를 바꾼 뒤 실행할 명령어는
cd /opt/myapp && git pull처럼 한 줄에 작성하세요 - 빈 줄과 주석 줄(
#으로 시작)은 건너뜁니다 - 서비스 토큰에서는
groupname이 무시되며, 명령은 서비스 계정의 전용 그룹으로 실행됩니다 - 시스템 서비스 재시작 예제에는 sudo 설정과 명령어 규칙이 필요합니다