GitHub에서 컨텍스트 및 식 탐색

Completed

컨텍스트는 워크플로 실행, 변수, 실행기 환경, 작업 및 단계에 대한 정보에 액세스하는 방법입니다. 각 컨텍스트는 문자열 또는 다른 개체일 수 있는 속성을 포함하는 개체입니다.

식 구문을 사용하여 컨텍스트에 액세스할 수 있습니다. 식은 리터럴 값, 컨텍스트에 대한 참조 또는 함수의 조합일 수 있습니다. 연산자를 사용하여 리터럴, 컨텍스트 참조, 함수를 결합할 수 있습니다.

컨텍스트

워크플로와 작업을 만들 때는 코드가 공격자의 신뢰할 수 없는 입력을 실행할 수 있는지 항상 고려해야 합니다. 특정 컨텍스트는 공격자가 자신의 악성 콘텐츠를 삽입할 수 있으므로 신뢰할 수 없는 입력으로 취급해야 합니다. 자세한 내용은 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> \}\}$ 같은 식에 올바른 구문을 사용해야 합니다.

운영자에 대한 자세한 내용은 운영자를 방문 하세요.