파이프라인 매개변수

담당자

이 매개변수는 특별 판매 가져오기 요청에 사용됩니다. 이 값은 변경 요청의 피할당자를 보유합니다. 변경 관리 시스템에서 변경 요청에 지정될 기능 ID 또는 이메일이어야 합니다.

backout-plan

이 매개변수는 특별 판매 가져오기 요청에 사용됩니다. 실패가 있는 경우 변경이 롤백되는 방법을 계획하십시오. 기본적으로 비어 있습니다.

분기(branch)

CI 파이프라인의 선택적 매개변수입니다. 이는 앱 저장소에서 코드를 가져오는 분기를 판별합니다. 기본값은 master 입니다.

변경 요청 지속 기간

CD 파이프라인의 선택적 매개변수입니다. 이 값은 유지보수 지속 기간을 변경합니다. 기본값은 30 min입니다.

change-request-id

CD 파이프라인의 선택적 매개변수입니다. 파이프라인은 변경 요청 ID를 제공하여 새 변경 요청의 작성을 건너뛰고 제공된 변경 요청을 사용합니다. 이 매개변수가 notAvailable 로 설정되거나 비워두면, 지속적 배포 파이프라인에 의해 변경 요청이 자동으로 생성됩니다. 기본값은 notAvailable입니다.

클러스터

이 매개변수는 Docker 배치에 사용되는 CD 파이프라인에서 클러스터의 이름을 보유합니다. 이 매개변수는 예제 앱에서 필수입니다.

cluster-name

이 매개변수는 Docker 배치에 사용되는 CI 파이프라인의 클러스터 이름을 보유합니다. 이 매개변수는 필수입니다.

cluster-region

이는 CD 파이프라인의 매개변수입니다. 클러스터를 호스팅하는 IBM Cloud 지역입니다. 이는 예제 앱의 필수 매개변수입니다.

compliance-baseimage

이 매개변수는 준수 기반 이미지의 버전을 보유합니다. 최신 이미지가 아닌 다른 것을 사용하려면 이 매개변수를 사용하십시오.

예: icr.io/continuous-delivery/toolchains/devsecops/baseimage:some-other-tag

사용자 정의 면제 레이블

CI및 CC 파이프라인의 선택적 매개변수입니다. 사용자 정의 레이블을 사용하여 영구적으로 면제된 인시던트 문제를 표시한 경우 이 매개변수는 사용자 정의 레이블의 값을 보유해야 합니다.

고객 영향

이 매개변수는 특별 판매 가져오기 요청에 사용됩니다. 고객에 대한 변경 요청의 영향을 기록합니다. 기본적으로 매개변수는 파이프로 구분된 문자열 'Critical | High | Moderate | Low | No_Impact' 입니다. 기본 문자열을 편집하여 옵션 중 하나를 선택하십시오.

배포 구성

배포 구성은 JSON 문자열로 제공되는 이 속성을 통해 지정됩니다. 다음은 배포 구성의 예시입니다:

"deployment-config": [
  {
    "region": "region-1",
    "servicenow-crn-mask": "crn:region-1:kubernetes::::::",
    "inventory-ignore-file": "filepath/relative/to/the/inventory-repo",
    "evidence-checks-config-path": "filepath/relative/to/the/pipeline-config-repo",
    "deployment-prefix": "prefix1",
    "trace_id": "guid1"
  },
  {
    ...
  }
]

다음 유효성 검사 규칙이 이 속성에 적용되며, 그 중 하나라도 실패할 경우 적절한 오류 메시지와 함께 파이프라인이 종료됩니다:

• 배열은 비어 있어서는 안 됩니다.
• 모든 trace_id 값은 고유해야 합니다.
• 각 요소는 와 trace_id 를 region 모두 포함해야 합니다.
• 해당 deployment-config 속성은 반드시 제공되어야 합니다. cd-change-request-listener
• 모든 요소가 를 포함하거나 deployment-prefix, 아니면 아무것도 포함하지 않는다.
• 존재하는 deployment-prefix 경우, 그 값은 모든 요소에서 고유 해야 합니다
• 가 존재하지 deployment-prefix 않는다면, 의 값은 **모든 **region 요소에서 고유해야 한다

다음 필드들은 개체별로 지정되지 않은 경우, 글로벌 환경 변수가 대체값으로 사용됩니다:

• servicenow-crn-mask → $(get_env servicenow-crn-mask)
• inventory-ignore-file → $(get_env inventory-ignore-file)
• evidence-checks-config-path → $(get_env evidence-checks-config-path)

deployment-prefix 글로벌 폴백이 없으며 사용 시 명시적으로 정의해야 합니다.

배치 영향

이 매개변수는 특별 판매 가져오기 요청에 사용됩니다. 배치에 대한 변경 요청의 영향을 기록합니다. 기본적으로 매개변수는 파이프로 구분된 문자열 'Small | Large' 입니다. 기본 문자열을 편집하여 옵션 중 하나를 선택하십시오.

설명

이 매개변수는 특별 판매 가져오기 요청에 사용됩니다. 이 매개변수에는 변경 요청 설명과 함께 추가되는 변경에 대한 설명이 포함되어 있습니다. 기본적으로 비어 있습니다.

탐지-비밀-기준선-파일명

이 매개변수는 detect-secrets에서 사용되는 기준선 파일의 사용자 정의 파일 이름을 지정합니다. 기본적으로 detect-secrets는 저장소 루트 디렉토리에서 이름이 .secrets.baseline 인 파일을 찾습니다. 그러나 기준선 파일의 이름을 다르게 지정하는 경우 이 매개변수를 사용하여 해당 파일 이름을 제공할 수 있습니다.

탐지-비밀-제외 목록

이 매개변수는 기존 기준선 파일 없이 실행이 완료될 때 기본 제외 목록을 대체하는 환경 특성입니다. 이 매개변수는 무시할 파일을 식별하므로 해당 파일에 링크된 문제가 작성되지 않습니다.

탐지-비밀-이미지

이 매개변수를 사용하여 사용할 다른 발견 시크릿 이미지 (예: 사용자 정의 이미지 또는 특정 버전의 공식 발견 시크릿 이미지) 를 지정할 수 있습니다.

탐지-비밀-버버즈

이 매개변수를 1로 설정하면 스캔 중인 현재 파일의 이름을 로그합니다.

dind-이미지

이 매개변수는 사용자 정의 dind 이미지를 설정하는 데 사용됩니다. 사용자 정의 dind 이미지 태그를 사용하려면 이 매개변수를 설정하십시오.

impact

이 매개변수는 특별 판매 가져오기 요청에 사용됩니다. 이 변경 구현이 미치는 영향에 대한 추가 참고사항입니다. 기본적으로 비어 있습니다.

pipeline-debug

이 매개변수가 1로 설정되면 파이프라인이 디버그 모드에서 실행되고 로그에 자세한 정보가 표시됩니다. 기본적으로 0으로 설정되어 있습니다.

파이프라인 표시 이름

pipeline-display-name 사용자 지정 속성을 사용하면 파이프라인 실행의 표시 이름을 사용자 지정할 수 있습니다. 이 기능은 파이프라인 실행에 대한 가시성과 추적성을 향상시킵니다.

예제

pipeline-display-name 을 prod-deployment-v2.1.0 으로 설정합니다:

• 파이프라인 실행 이름: prod-deployment-v2.1.0
• 작업 이름: prod-deployment-v2.1.0 앞에 시스템 식별자 및 작업별 접미사가 붙습니다

우선순위

이 매개변수는 특별 판매 가져오기 요청에 사용됩니다. 변경 요청의 우선순위. 기본적으로 'Critical | High | Moderate | Low | Plan' 입니다. 이 값 중 하나로 변경할 수 있습니다.

목적

이 매개변수는 특별 판매 가져오기 요청에 사용됩니다. 변경이 필요한 이유. 기본적으로 비어 있습니다.

서명 키

이 매개변수는 CI 파이프라인에 대한 것입니다. 이는 .pfx 파일 데이터를 사용하여 이미지를 서명하기 위한 base64-encoded 개인 키를 보유하는 시크릿 유형 매개변수입니다.

slack-notifications

Slack 통합을 켜거나 끄도록 전환하십시오. 이는 기본적으로 꺼져 있으므로 값은 0 입니다. 이를 켜려면 1 로 설정하고, 끄려면 0 로 설정하십시오.

sonarqube

이 매개변수는 정적 스캔 단계를 사용하는 모든 파이프라인에 사용됩니다. 통합 유형 매개변수입니다. 사용자 고유의 sonarqube 통합을 사용하는 경우 해당 통합을 값으로 선택하십시오. 기본적으로 이 매개변수는 비어 있습니다.

소나퀘이브 네임스페이스

이 매개변수는 정적 스캔 단계를 사용하는 모든 파이프라인에 사용됩니다. 이는 파이프라인에서 작성된 SonarQube 인스턴스와 함께 사용하도록 구성된 Kubernetes 네임스페이스입니다. 이를 사용하려는 네임스페이스로 변경할 수 있습니다.

sonarqube-scan-명령

이 매개변수는 정적 스캔 단계를 사용하는 파이프라인을 위한 것입니다. sonarqube-scan-command 는 sonarqube 스캔을 시작하기 위한 명령을 지정합니다. 이 매개변수가 설정되지 않은 경우 기본값은 docker run --platform="linux/amd64" --network host -v "$SONAR_DIR":/usr/sonar_scan -v "$WORKSPACE/$path":/usr/src "$sonarqube_scanner_image" sonar-scanner -Dsonar.working.directory=/usr/sonar_scan -Dsonar.projectKey="$SONAR_PROJECT_KEY" -Dsonar.token="$SONAR_TOKEN" -Dsonar.host.url="$SONAR_HOST_URL" 입니다. 기본 매개변수는 Docker sonar-scanner 이미지를 사용하여 스캔을 수행합니다.

Maven Java 프로젝트의 경우, 이 매개변수를 mvn -Dmaven.repo.local="${WORKSPACE}/.m2" -Dsonar.token="$SONAR_TOKEN" -Dsonar.host.url="$SONAR_HOST_URL" -Dsonar.projectKey="$SONAR_PROJECT_KEY" -Dsonar.projectName="$SONAR_PROJECT_KEY" -Dsonar.working.directory="$SONAR_DIR" org.sonarsource.scanner.maven:sonar-maven-plugin:sonar 로 설정하여 sonar 스캔에 Maven 계산 클래스 경로를 사용하십시오.

source-environment

앱이 승격되는 소스 환경으로, 승격의 소스 인벤토리 분기입니다. 기본값은 master입니다. 이 매개변수의 값을 겹쳐쓰려면 페이로드에 source-environment 특성을 추가하여 웹훅 트리거를 사용하십시오.

static-scan-retry-count

이 매개변수는 파이프라인에서 실행하려는 정적 스캔에 사용됩니다. 이러한 스캔은 API 호출을 사용하며, 이는 작업하는 데 짧은 시간이 걸릴 수 있습니다. 따라서 필요한 경우 이러한 호출을 재시도하십시오. 이 매개변수를 사용하여 재시도 횟수를 변경할 수 있습니다. 기본적으로 이 매개변수는 30으로 설정되어 있습니다.

static-scan-retry-sleep

이 매개변수는 파이프라인에서 실행하려는 정적 스캔에 사용됩니다. 이러한 스캔은 API 호출을 사용하며, 이는 작업하는 데 짧은 시간이 걸릴 수 있습니다. 따라서 필요한 경우 이러한 호출을 재시도하십시오. 이 매개변수를 사용하여 대기할 시간 (초) 을 변경할 수 있습니다. 기본적으로 이 매개변수는 10으로 설정되어 있습니다.

요약-재시도 - 시도

성공했는지 확인하기 위해 재시도 메소드를 사용하여 증거 요약을 업로드하십시오. 이 매개변수를 사용하여 재시도 횟수를 변경할 수 있습니다. 기본적으로 이 매개변수는 5로 설정되어 있습니다.

요약-최대-재시도 - 시간

성공했는지 확인하기 위해 재시도 메소드를 사용하여 증거 요약을 업로드하십시오. 이 매개변수를 사용하여 대기할 시간 (초) 을 변경할 수 있습니다. 기본적으로 이 매개변수는 32로 설정되어 있습니다.

target-environment

앱이 배치되는 대상 환경으로, 승격의 대상 인벤토리 분기입니다. 기본값은 prod입니다. 이 매개변수의 값을 겹쳐쓰려면 페이로드에 target-environment 특성을 추가하여 웹훅 트리거를 사용하십시오.

대상 환경 목적

이 매개변수는 CD 파이프라인을 위한 것입니다. target-environment-purpose 는 대상 환경의 컨텍스트 및 사용 방법을 판별합니다. 유효한 값은 pre_prod 및 production 입니다. production 관련 변경사항이 아닌 모든 사항을 pre_prod 로 표시하십시오.

대상 환경 세부사항

이 매개변수는 CD 파이프라인을 위한 것입니다. 대상 환경을 설명합니다.

sysdig-스캔 ???.

이 매개변수는 icr.io 이미지에서 sysdig inline scanner 를 사용하여 Sysdig 스캔을 실행하기 위해 스캔 아티팩트 단계를 사용하는 파이프라인에 대한 것입니다.

재고 무시 파일

이 매개변수는 인벤토리 무시 파일의 사용자 지정 파일 이름을 지정합니다. 기본적으로 파이프라인은 인벤토리 저장소의 루트 디렉터리에 있는 ‘ .inventoryignore ’라는 파일을 찾습니다. 이 파일에는 인벤토리 작업에서 제외할 파일 및 폴더 목록이 포함되어 있습니다.

이 매개변수는 지점별 무시 파일, 여러 배포 구성, 리전별 제외 항목 등 다양한 사용 사례를 지원합니다. 무시 파일 형식, 사용 사례 및 모범 사례에 대한 자세한 내용은 ‘인벤토리에서 파일 및 디렉터리 제외 방법’을 참조하십시오.

숙소를 잠그는 방법

환경 속성을 잠그려면 환경 속성의 속성 편집을 클릭한 다음 잠긴 속성을 활성화합니다.

잠금의 효과

환경 속성에서 프로퍼티를 잠근 후에는 트리거 레벨을 변경할 수 없습니다. 따라서 프로퍼티가 잠기면 트리거 레벨에서 해당 프로퍼티를 업데이트할 수 없습니다.

트리거 레벨에 잠긴 프로퍼티를 넣으려고 하면 오류가 발생합니다.

트리거 레벨에서 변수를 변경하려는 경우 해당 변수에 대한 잠금을 비활성화할 수 있습니다.