• 사용 가능한 기능 플래그
• 파이프라인 구성에서 기능 플래그 활성화
• 러너 환경 변수에서 기능 플래그 활성화
• 러너 구성에서 기능 플래그 활성화

markdown # GitLab Runner 기능 플래그

경고: 기본으로 비활성화된 기능을 활성화하는 경우 데이터 손상, 안정성 저하, 성능 저하 및 보안 문제가 발생할 수 있습니다. 기능 플래그를 활성화하기 전에 관련된 위험을 인식해야 합니다. 자세한 내용은 개발 중인 기능을 활성화할 때 발생할 수 있는 위험 사항을 참조하십시오.

기능 플래그는 특정 기능을 활성화 또는 비활성화할 수 있는 토글입니다. 이러한 플래그는 일반적으로 다음과 같이 사용됩니다:

• 모든 사용자에게 사용할 준비가 아니지만 자발적인 테스트를 위해 제공되는 베타 기능.

  베타 기능은 때로는 미완성이거나 추가 테스트가 필요할 수 있습니다. 베타 기능을 사용하고자 하는 사용자는 리스크를 받아들일 수 있고, 기능 플래그를 통해 명시적으로 해당 기능을 활성화할 수 있습니다. 해당 기능이 필요하지 않거나 시스템에서 해당 리스크를 받아들일 준비가 되지 않은 다른 사용자는 해당 기능이 기본적으로 비활성화되어 가능한 버그 및 회귀에 영향을 받지 않습니다.

• 곧 제거될 기능으로 인한 기능이 부족하거나 기능이 제거되는 변경 사항.

  제품이 진화함에 따라 기능이 종종 변경되거나 완전히 제거됩니다. 알려진 버그는 종종 수정되지만, 경우에 따라 사용자가 이미 영향을 받은 버그에 대한 해결책을 이미 찾은 경우가 있습니다. 표준화된 버그 수정을 강제로 채택하면 해당 사용자의 사용자 지정 구성에서 다른 문제가 발생할 수 있습니다.

  이러한 경우에 기능 플래그는 이전 동작에서 새로운 동작으로 필요에 따라 전환하는 데 사용됩니다. 이를 통해 사용자가 제품의 새 버전을 채택하면서 이전 동작에서 새로운 동작으로의 원활하고 영구적인 전환을 계획할 시간을 제공합니다.

기능 플래그는 환경 변수를 사용하여 토글됩니다. 다음과 같은 방법으로 활성화 또는 비활성화할 수 있습니다:

• 기능 플래그를 활성화하려면 해당 환경 변수를 "true" 또는 1로 설정합니다.
• 기능 플래그를 비활성화하려면 해당 환경 변수를 "false" 또는 0으로 설정합니다.

사용 가능한 기능 플래그

파이프라인 구성에서 기능 플래그 활성화

CI 변수를 사용하여 기능 플래그를 활성화할 수 있습니다:

• 파이프라인 전체 작업에 대해 (전역적으로):

  variables:
    FEATURE_FLAG_NAME: 1
  

• 단일 작업에 대해:

  job:
    stage: test
    variables:
      FEATURE_FLAG_NAME: 1
    script:
    - echo "안녕하세요"
  

러너 환경 변수에서 기능 플래그 활성화

모든 작업을 실행하는 러너에서 특정 기능을 활성화하려면 해당 기능 플래그를 러너 구성의 environment 변수로 지정하세요:

[[runners]]
  name = "ruby-2.7-docker"
  url = "https://CI/"
  token = "TOKEN"
  limit = 0
  executor = "docker"
  builds_dir = ""
  shell = ""
  environment = ["FEATURE_FLAG_NAME=1"]

러너 구성에서 기능 플래그 활성화

• 도입된 버전: GitLab Runner 13.11.

[runners.feature_flags] 아래에 지정하여 기능 플래그를 활성화할 수 있습니다. 이 설정을 통해 기능 플래그 값을 덮어쓰지 못하도록 방지할 수 있습니다.

이 설정을 구성하지 않으면 특정 기능 플래그는 작업이 실행되는 방식과는 무관하기 때문에 사용할 수 없을 수도 있습니다.

[[runners]]
  name = "ruby-2.7-docker"
  url = "https://CI/"
  token = "TOKEN"
  executor = "docker"
  [runners.feature_flags]
    FF_USE_DIRECT_DOWNLOAD = true