작업 문제 해결

Tier: Free, Premium, Ultimate Offering: GitLab.com, Self-Managed, GitLab Dedicated

작업을 수행하는 동안 다음과 같은 문제가 발생할 수 있습니다.

changes: 사용 시 작업 또는 파이프라인이 예상치 않게 실행될 수 있음

rules: changes 또는 only: changes를 사용할 때 예상치 않게 작업 또는 파이프라인이 실행될 수 있습니다. 이는 병합 요청 파이프라인과 연관이 없는 브랜치 또는 태그의 파이프라인이 이전 SHA를 사용하여 차이를 계산하기 때문입니다. 이 계산은 git diff HEAD~와 동등하며 예상치 못한 동작을 일으킬 수 있습니다.

또한 changes 규칙은 예약된 파이프라인에서 항상 true로 평가됩니다. 따라서 changes를 사용하는 예약된 파이프라인에는 항상 작업이 추가될 수 있습니다.

CI/CD 변수의 파일 경로

CI/CD 변수에서 파일 경로를 사용할 때 주의해야 합니다. 변수 정의에서는 trailing slash가 올바른 것으로 보일 수 있지만 script:, changes: 또는 다른 키워드에서 확장될 때 올바르지 않을 수 있습니다. 예를 들어: 

docker_build:
  variables:
    DOCKERFILES_DIR: 'path/to/files/'  # 이 변수에는 trailing '/' 문자가 있어서는 안 됩니다
  script: echo "도커 작업"
  rules:
    - changes:
        - $DOCKERFILES_DIR/*

DOCKERFILES_DIR 변수가 changes: 섹션에서 확장되면 전체 경로는 path/to/files//*가 됩니다. 두 개의 슬래시는 사용된 키워드나 실행 중인 러너의 셸 및 OS에 따라 예상치 못한 동작을 일으킬 수 있습니다.

프로젝트에서 코드를 다운로드할 수 없습니다. 오류 메시지

GitLab 관리자가 비공개 프로젝트에서 보호된 수동 작업을 실행할 때 파이프라인이 실패하는 경우가 있습니다.

CI/CD 작업은 일반적으로 작업을 시작할 때 프로젝트를 복제하고, 이는 작업을 실행하는 사용자의 권한을 사용합니다. 관리자를 포함한 모든 사용자는 해당 프로젝트의 직접 멤버여야만 프로젝트의 소스를 복제할 수 있습니다. 이 문제가 존재합니다.

보호된 수동 작업을 실행하려면 다음을 수행하세요:

  • 관리자를 비공개 프로젝트의 직접 멤버로 추가합니다(어떤 역할이든 상관없음).
  • 프로젝트의 직접 멤버로 변장할 수 있는 사용자로 변장합니다.

CI/CD 작업이 다시 실행될 때 새 구성을 사용하지 않음

파이프라인의 구성은 파이프라인이 생성될 때만 가져옵니다. 작업을 다시 실행하는 경우에는 매번 동일한 구성을 사용합니다. 따라서 include](../yaml/index.md#include)로 추가된 별도 파일을 포함하여 구성 파일을 업데이트하면 새 구성을 사용하려면 새로운 파이프라인을 시작해야 합니다.

Job may allow multiple pipelines to run for a single action 경고

when 절과 함께 rules를 사용할 때 if 절 없이 사용하면 여러 개의 파이프라인이 실행될 수 있습니다. 보통 이는 연관된 열린 병합 요청이있는 브랜치에 커밋을 푸시할 때 발생합니다.

중복 파이프라인을 방지하려면 workflow: rules를 사용하거나 실행될 수 있는 파이프라인을 제어하기 위해 규칙을 재작성하세요.

변수 표현식의 This GitLab CI configuration is invalid 오류

CI/CD 변수 표현식을 사용할 때 This GitLab CI configuration is invalid 오류가 발생할 수 있습니다. 이러한 구문 오류는 따옴표 문자 사용이 잘못된 경우에 발생할 수 있습니다.

변수 표현식에서는 문자열에는 따옴표를 사용하고, 변수에는 따옴표를 사용하지 않아야 합니다. 예를 들어: 

variables:
  ENVIRONMENT: production

job:
  script: echo
  rules:
    - if: $ENVIRONMENT == "production"
    - if: $CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH

이 예에서 양쪽 if: 절은 모두 올바른데, production 문자열이 따옴표로 묶이고 CI/CD 변수는 따옴표로 묶이지 않았기 때문입니다.

반대로 다음과 같은 if: 절은 모두 잘못된 것입니다: 

variables:
  ENVIRONMENT: production

job:
  script: echo
  rules:       # 이러한 규칙은 모두 YAML 구문 오류를 일으킵니다:
    - if: ${ENVIRONMENT} == "production"
    - if: "$ENVIRONMENT" == "production"
    - if: $ENVIRONMENT == production
    - if: "production" == "production"

이 예에서:

  • ${ENVIRONMENT}는 if:에서 CI/CD 변수의 유효한 형식이 아니기 때문에 잘못되었습니다.
  • "$ENVIRONMENT" == "production"는 변수가 따옴표로 묶여 있기 때문에 잘못되었습니다.
  • $ENVIRONMENT == production은 문자열이 따옴표로 묶여 있지 않기 때문에 잘못되었습니다.
  • "production" == "production"은 비교할 CI/CD 변수가 없기 때문에 잘못되었습니다.