GitHub에서 컨텍스트 및 식 탐색
컨텍스트는 워크플로 실행, 변수, 실행기 환경, 작업 및 단계에 대한 정보에 액세스하는 방법입니다. 각 컨텍스트는 문자열 또는 다른 개체일 수 있는 속성을 포함하는 개체입니다.
식 구문을 사용하여 컨텍스트에 액세스할 수 있습니다. 식은 리터럴 값, 컨텍스트에 대한 참조 또는 함수의 조합일 수 있습니다. 연산자를 사용하여 리터럴, 컨텍스트 참조, 함수를 결합할 수 있습니다.
컨텍스트
워크플로와 작업을 만들 때는 코드가 공격자의 신뢰할 수 없는 입력을 실행할 수 있는지 항상 고려해야 합니다. 특정 컨텍스트는 공격자가 자신의 악성 콘텐츠를 삽입할 수 있으므로 신뢰할 수 없는 입력으로 취급해야 합니다. 자세한 내용은 GitHub Actions에 대한 보안 강화를 참조하세요."
다음 표에는 GitHub에서 사용할 수 있는 컨텍스트의 예가 포함되어 있으며 전체 목록은 아닙니다.
| 컨텍스트 이름 | 유형 | 설명 |
|---|---|---|
github |
object |
워크플로 실행에 대한 정보입니다. |
env |
object |
워크플로, 작업 또는 단계에 설정된 변수를 포함합니다. |
vars |
object |
리포지토리, 조직 또는 환경 수준에서 설정된 변수를 포함합니다. |
job |
object |
현재 실행 중인 작업에 대한 정보입니다. |
팁 (조언)
컨텍스트의 전체 목록을 보려면 컨텍스트 정보로 방문하세요.
컨텍스트를 사용할 시기 결정
GitHub Actions에는 기본 변수 및 컨텍스트라는 두 개의 변수 컬렉션 이 포함됩니다. 이러한 변수는 워크플로의 여러 지점에서 사용하기 위한 것입니다.
- 기본 환경 변수: 이러한 환경 변수는 작업을 실행하는 실행기에서만 존재합니다.
- 컨텍스트: 기본 변수 를 사용할 수 없는 경우를 포함하여 워크플로의 모든 지점에서 대부분의 컨텍스트를 사용할 수 있습니다.
다음 예에서 if 문은 현재 브랜치 이름을 결정하기 위해 github.ref 컨텍스트를 확인합니다. if 확인이 처리되고 결과가 true일 경우에만 작업이 실행기로 전송됩니다. 작업이 실행기로 전송되면 단계가 실행되고 실행기 $GITHUB_REF 에서 변수를 참조합니다.
name: CI
on: push
jobs:
prod-check:
if: ${{ github.ref == 'refs/heads/main' }}
runs-on: ubuntu-latest
steps:
- run: echo "Deploying to production server on branch $GITHUB_REF"
GitHub Actions에서 사용할 수 있는 컨텍스트
다음 표에는 사용 가능한 최상위 컨텍스트, 간단한 설명 및 개체의 속성에 대한 자세한 정보 링크가 포함되어 있습니다.
| 최상위 컨텍스트 | 설명 | 속성 및 예제 |
|---|---|---|
github |
워크플로의 모든 작업 또는 단계 중에 사용할 수 있는 최상위 컨텍스트입니다. | 컨텍스트의 속성입니다 github . |
env |
워크플로, 작업 또는 단계에 설정된 변수를 포함합니다. 실행기 프로세스에서 상속받는 변수는 포함되어 있지 않습니다. | 컨텍스트의 속성입니다 env . |
vars |
조직, 리포지토리 및 환경 수준에서 설정된 사용자 지정 구성 변수를 포함합니다. | 사용 예제 vars 입니다. |
job |
현재 실행 중인 작업에 대한 정보를 포함합니다. | 컨텍스트의 속성입니다 job . |
jobs |
재사용 가능한 워크플로에서만 사용할 수 있으며 재사용 가능한 워크플로에 대한 출력을 설정하는 데만 사용할 수 있습니다. | 컨텍스트의 속성입니다 jobs . |
steps |
현재 작업에서 id가 지정된 완료된 단계에 관한 정보를 포함합니다. |
컨텍스트의 속성입니다 steps . |
runner |
현재 작업을 실행하는 러너에 대한 정보를 포함합니다. | 컨텍스트의 속성입니다 runner . |
secrets |
워크플로 실행에 사용할 수 있는 비밀의 이름과 값을 포함합니다. | 컨텍스트의 속성입니다 secrets . |
strategy |
현재 작업에 대한 행렬 실행 전략에 대한 정보를 포함합니다. | 컨텍스트의 속성입니다 strategy . |
matrix |
현재 작업에 적용되는 워크플로 파일에 정의된 행렬 속성을 포함합니다. | 컨텍스트의 속성입니다 matrix . |
needs |
현재 작업의 직접 종속성으로 정의된 모든 작업의 출력을 포함합니다. | 컨텍스트의 속성입니다 matrix . |
inputs |
작업, 재사용 가능한 워크플로 또는 수동으로 트리거된 워크플로에 전달되는 입력 속성을 포함합니다. | 컨텍스트의 속성입니다 inputs . |
표현식
식을 사용하여 워크플로 파일에서 환경 변수를 프로그래밍 방식으로 설정하고 컨텍스트에 액세스할 수 있습니다. 식은 리터럴 값, 컨텍스트에 대한 참조 또는 함수의 조합일 수 있습니다. 연산자를 사용하여 리터럴, 컨텍스트 참조, 함수를 결합할 수 있습니다.
워크플로 파일에서는 주로 조건부 if 키워드를 사용한 식을 통해 단계를 실행할지 결정합니다. 조건부인 if 경우 true단계가 실행됩니다.
특정 구문을 ${{ <expression> }}사용하여 문자열로 처리하지 않고 식을 평가하도록 GitHub에 지시해야 합니다. 이 규칙의 예외는 절에서 if 식을 사용하는 경우입니다. 여기서는 일반적으로 식을 ${{와 }} 생략할 수 있습니다.
다음 코드 샘플에서는 환경 변수 설정을 보여 줍니다.
env:
MY_ENV_VAR: ${{ <expression> }}
리터럴
식의 일부로 boolean, null, number 또는 string 데이터 형식을 사용할 수 있습니다. 조건문에서 거짓 같은 값(false, 0, -0, "", '', null)은 false으로 강제 변환되고, 진실 같은 값(true 및 기타 거짓이 아닌 값)은 true으로 강제 변환됩니다. 다음은 리터럴을 구현하는 예제를 보여 줍니다.
env:
myNull: ${{ null }}
myBoolean: ${{ false }}
myIntegerNumber: ${{ 711 }}
myFloatNumber: ${{ -9.2 }}
myHexNumber: ${{ 0xff }}
myExponentialNumber: ${{ -2.99e-2 }}
myString: Mona the Octocat
myStringInBraces: ${{ 'It''s open source!' }}
연산자
연산자는 식을 평가하는 데 중요한 역할을 합니다. 식은 리터럴 값, 컨텍스트에 대한 참조 또는 함수로 구성됩니다. 연산자를 사용하면 이러한 요소를 결합하여 더 복잡한 식을 만들 수 있습니다. 다음은 몇 가지 주요 연산자입니다.
논리 연산자:
&&(및): 전체 식이 true로 평가되려면 둘 다 true여야 하는 두 조건을 결합합니다.||(또는): 두 조건을 결합하고 두 조건 중 하나가 true이면 식이 true로 평가됩니다.!(not): 조건을 부정하고 진리 값을 뒤집습니다.
동등 연산자:
==(같음): 두 값을 같음으로 비교합니다.!=(같지 않음): 두 값이 같지 않은지 확인합니다.
비교 연산자:
<(보다 작음)>(보다 크다)<=(보다 작거나 같음)>=(보다 크거나 같음)
이러한 연산자를 사용하면 조건에 따라 특정 단계를 실행할 시기를 결정하여 동적 워크플로를 만들 수 있습니다. 적절한 평가를 위해 $\{\{ <expression> \}\}$ 같은 식에 올바른 구문을 사용해야 합니다.
운영자에 대한 자세한 내용은 운영자를 방문 하세요.