표현식
Workflow에서 사용 가능한 Expression 문법 개요
Expression은 ${{ }} 형태로 사용되며, 런타임에 실제 값으로 치환됩니다. Secrets, 환경 변수, 빌트인 컨텍스트, Step 출력 등을 동적으로 참조할 수 있습니다.
기본 문법
# Expression은 ${{ }} 안에 작성합니다
env:
API_KEY: "${{ secrets.API_KEY }}"
BRANCH: "${{ collabops.ref_name }}"
VERSION: "${{ steps.version.outputs.app_version }}"사용 가능한 위치
| 위치 | 사용 가능 | 예시 |
|---|---|---|
env value | ✅ | API_KEY: "${{ secrets.KEY }}" |
env key | ❌ | ${{ secrets.NAME }}: value (불가) |
with value | ✅ | ref: ${{ collabops.ref_name }} |
if 조건 | ✅ | if: "collabops.ref == 'refs/heads/main'" |
run 내 문자열 | ✅ | run: echo ${{ collabops.sha }} |
Contexts 요약
| Context | Description | 상세 문서 |
|---|---|---|
secrets | 워크스페이스/저장소에 등록된 시크릿 값 | Contexts |
vars | 조직/저장소/환경 변수 | Contexts |
env | Workflow에서 정의한 환경 변수 | Contexts |
collabops | 빌트인 컨텍스트 (ref, sha, actor 등) | Contexts |
steps | Step 출력 참조 | Step Outputs |
inputs | 템플릿 입력 파라미터 (템플릿 내부에서만 사용) | Workspace Templates |