단계 정보

단계는 프로젝트의 컴포넌트입니다. 프로젝트가 작업으로 실행될 때 각 단계는 순서대로 실행됩니다. 단계에는 하나 이상의 명령이 포함되어 있으며 동작에 영향을 주는 단계 특성이 있습니다.

단계 패널 정보

세부사항 탭

단계 특성은 단계 실행 방법, 단계 출력 처리 방법 및 단계 완료 시 수행할 작업을 지정합니다. 또한 단계는 다른 프로젝트나 라이브러리를 실행할 수 있습니다.

단계 특성을 보려면 프로젝트 내에서 단계를 선택하십시오. 세부사항 탭은 기본적으로 표시됩니다. 단계 특성을 표시합니다.

단계 특성이 명시적으로 설정되지 않은 경우, 해당 값은 프로젝트에서 상속됩니다. 단계에 대한 단계 특성 세트는 상속된 값을 대체합니다.

단계 패널에 있는 세부사항 탭의 화면 이미지
단계 특성은 다음을 포함합니다.
이름
단계의 이름입니다. 시스템 및 로그의 단계에 대한 레이블로 사용됩니다.
활성
단계가 실행되는지 여부를 지정합니다. 단계는 기본적으로 사용 가능합니다. 단계의 실행을 방지하려면 사용 불가능을 선택하십시오. 작업에서 실행되는 사용 불가능한 단계를 사용할 수 없습니다.
디렉토리
단계 명령이 실행되는 위치를 설정합니다. 시스템은 모든 작업에 대한 고유 디렉토리를 자동으로 작성합니다. 디렉토리 필드는 작업 중에 프로젝트가 생성한 디렉토리의 명령을 실행하는 편리한 방법을 제공합니다(Build Forge는 디렉토리 필드에 언급된 디렉토리를 생성하지 않음).
경로
디렉토리가 절대 경로인지 상대 경로인지를 지정합니다.
  • 상대: 단계 명령은 서버, 프로젝트, 작업 및 단계 디렉토리를 함께 추가하여 찾은 경로에서 실행됩니다.
  • 절대: 단계 명령이 서버 및 단계 디렉토리를 함께 추가하여 찾은 경로에서 실행됩니다. 이 옵션을 사용하여 프로젝트 디렉토리 구조에 없는 디렉토리에 액세스할 수 있습니다. 예제: 서버에 영구적으로 설치된 애플리케이션을 실행하는 데 사용될 수 있습니다.
단계 유형
단계의 실행 방법을 판별합니다. 이 특성은 명령의 컨텐츠 및 인라인에 지정된 프로젝트(있는 경우)에 영향을 줍니다.
  • 일반: 단계가 한 번 실행됩니다.
  • 조건부: 조건 특성의 표현식이 true로 평가되면 단계가 한 번 실행됩니다. 조건부 선택 시 조건, Else 인라인 및 Else 명령 특성이 표시됩니다. 조건 특성이 false로 평가되면 명령 및 인라인이 실행되지 않습니다. 대신 Else 명령 및 Else 인라인이(지정되어 있는 경우) 실행됩니다.
  • While 루프: 단계가 여러 번 실행될 수 있습니다. 조건 특성의 표현식이 false로 되거나 최대 반복 수에 도달할 때까지 실행됩니다. While 루프 선택 시 조건 및 최대 반복 수 특성이 표시됩니다.

    While 루프의 각 반복에서 선택기가 평가되어 반복에 사용할 서버를 판별합니다.

인라인
현재 프로젝트와 함께 인라인으로 실행할 프로젝트나 라이브러리를 지정합니다. 프로젝트 또는 라이브러리의 단계가 현재 프로젝트의 환경 및 대부분의 특성을 사용하여 실행됩니다. 그러나 시스템은 인라인 프로젝트의 선택기를 인라인 단계에 대한 기본 선택기로 사용합니다. 현재 단계 뒤에 지정된 프로젝트의 단계를 복사하는 것과 같은 동작입니다.
액세스
액세스 그룹을 선택하여 단계를 사용하도록 허용된 사용자를 정의하십시오. 이 특성을 사용하여 프로젝트의 특정 단계로 액세스를 제한할 수 있습니다. 단계에 대한 액세스 그룹의 구성원이 아닌 사용자가 단계를 포함하는 프로젝트를 실행하는 경우 해당 단계는 건너뜁니다.

프로젝트 기본값을 선택하면 단계가 프로젝트의 액세스 특성을 상속하게 됩니다.

최대 반복 수
단계 유형이 While 루프인 경우에만 표시됩니다. 루프에서 실행할 수 있는 단계의 최대 반복 수를 지정합니다. 시스템에 부과된 기본값은 100입니다. 단계 로그에서 성공적으로 완료된(패스된) 단계가 표시됩니다. 최대치에 도달한 경우 단계 실패를 사용하여 최대 반복 수에 도달하면 단계가 실패하도록 작성하십시오.

작업이 실행 중인 경우, 읽기 전용 변수 BF_ITERATION은 성공적으로 입력된 반복 수를 포함합니다. 작업이 중지되고 다시 시작되는 경우 BF_ITERATION의 반복에서 다시 시작됩니다.

최대치에 도달한 경우 단계 실패
예인 경우, 최대 반복 수에 도달하면 While 루프 단계가 실패합니다. 아니오인 경우, 단계가 패스됩니다.
Else 인라인
단계 유형이 조건부인 경우에만 표시됩니다. 지정된 조건이 false인 경우 인라인으로 실행할 프로젝트를 지정합니다. 기본값은 아니오입니다.
명령

하나 이상의 명령입니다. 명령은 운영 체제 명령, 점 명령 또는 둘의 조합일 수 있습니다. 단계가 실행하는 방법의 내용을 참조하십시오.

조건
조건부 또는 While 루프의 단계 유형을 선택한 경우에만 표시됩니다.
  • 조건부: 조건이 true로 평가되면 명령이 실행됩니다.
  • While 루프: 조건이 true로 평가되는 한 명령을 여러 번 실행할 수 있습니다. 최대 반복 수를 사용하여 한계를 설정할 수 있습니다.

조건은 선택된 서버 자원에서 실행할 함수 또는 명령일 수 있습니다.

  • 함수가 사용되는 경우에는 조건 필드의 처음에 사용되어야 합니다. Build Forge 엔진에서 평가합니다. 서버 자원에 보내지지 않습니다. 함수 및 함수 사용 방법에 관한 지시사항의 목록은 조건 함수를 참조하십시오.
  • 명령은 선택된 서버에서 실행됩니다. 여기서 사용된 모든 명령은 에이전트의 쉘 환경에서 유효해야 합니다. 실행에서 리턴 코드는 조건의 패스 또는 실패 여부를 판별합니다.

프로젝트에 사용 가능한 Build Forge 변수는 조건 표현식에 사용할 수 있습니다. 변수를 표현할 수 있는 방법과 변수를 평가하는 방법에 대한 자세한 정보는 단계에서 변수 해석을 참조하십시오.

Else 명령
조건부 단계 유형을 선택한 경우에만 표시됩니다. 조건이 false로 평가되는 경우에 실행할 명령을 지정합니다.
환경

명령을 실행하기 전에 적용할 환경을 지정합니다. 이 환경의 값은 서버 환경, 프로젝트 환경 및 단계 변수로부터 상속된 모든 값을 대체합니다.

선택기
이 단계의 서버를 선택하기 위해 사용할 선택기를 지정합니다. 기본값을 그대로 둔 경우 프로젝트의 선택기에 의해 판별된 서버에서 단계가 실행됩니다.
브로드캐스트
이 상자가 선택된 경우, 현재 선택기(지정된 경우에는 단계 선택기이고, 그렇지 않으면 프로젝트 선택기임)와 일치하는 모든 서버에서 단계를 실행합니다. 실행 시, 시스템은 브로드캐스트 단계를 일련의 단계로 바꾸고(각 서버에 대해 하나씩), 브로드캐스트 단계의 스레드 특성에 따라 이를 직렬 또는 병렬로 실행합니다.

다시 시작 시 브로드캐스트 단계 동작: 브로드캐스트 단계가 다시 시작되면 브로드캐스트되지 않습니다. 해당 설정은 단계를 새로 시작하는 경우에만 적용됩니다. 다시 시작하면 엔진이 단계에 대해 단일 서버를 랜덤으로 선택합니다.

제한시간(분)
현재 명령이 결과물을 생성하기까지 시스템이 대기하는 시간(분)을 지정합니다(기본값: 5분). 단계가 에이전트에 적절히 연결된 경우 값 0은 단계의 제한시간이 초과되지 않음을 의미합니다. 제한시간 값에 도달하면, 시스템은 단계를 실패로 처리합니다. 단계가 실패 시 계속으로 설정되어 있지 않으면, 프로젝트도 또한 실패합니다.
결과
결과 특성은 시스템이 단계가 성공했는지 또는 실패했는지 여부를 판단하는 방법을 판별합니다. 명령 쉘이 리턴하는 종료 코드를 기반으로 성공을 판별하려면 종료 코드 기본값을 사용하십시오. 명령 결과물을 검사하는 로그 필터를 선택할 수도 있습니다. 로그 필터를 선택하기 위해서는 먼저 로그 필터를 작성해야 합니다.
실패 시
단계가 실패하면 작업을 정지할지 계속할지 여부를 지정합니다. 기본적으로, 시스템이 작업을 정지합니다.
스레드
예인 경우, 이 단계를 기타 단계와 병렬로 실행합니다. 이 단계의 스레딩(단계를 다른 단계와 병렬로 실행)을 허용하려면 이 특성을 예로 설정하십시오. 스레딩을 방지하려면 특성을 아니오로 설정하십시오. 스레드 단계 블록을 분리하려면 이 특성을 결합으로 설정하십시오. 첫 번째 단계 세트를 완료해야 결합 단계 다음에 오는 다음 스레드 단계 세트를 시작할 수 있습니다.
패스 알림
단계가 패스하면 알림을 받을 액세스 그룹을 지정합니다.
패스 체인
현재 단계 패스 시 실행할 프로젝트를 지정합니다. ("경고" 상태를 갖는 단계는 패스로 계수되며 패스 체인을 실행합니다.)
패스 대기
이 상자가 선택된 경우, 시스템은 패스 체인 프로젝트가 완료될 때까지 현재 프로젝트를 일시중단합니다. 이 단계(또는 해당 프로젝트)가 취소되면 체인 형식으로 연결된 프로젝트도 취소됩니다. 검사되지 않는 경우 체인 형식으로 연결된 프로젝트가 비동기식으로 시작되며 현재 프로젝트가 다음 단계로 계속됩니다.
실패 알림
단계가 실패하면 알림을 받을 액세스 그룹을 지정합니다.
실패 체인
현재 단계 실패 시 실행할 프로젝트를 지정합니다. (실패 시 계속으로 설정된 단계는 실패로 계수되며, 단계에 지정된 모든 실패 체인을 실행합니다.)
실패 대기
이 상자가 선택된 경우, 시스템은 실패 체인 프로젝트가 완료될 때까지 현재 프로젝트를 일시중단합니다. 이 단계(또는 해당 프로젝트)가 취소되면 체인 형식으로 연결된 프로젝트도 취소됩니다.

노트 탭

노트 탭에는 단계에 대해 작성된 노트의 시간소인 목록이 포함됩니다. 노트는 수동으로 작성하며 편집 내용이 단계에 자동으로 기록되지 않습니다. 이 탭은 현재 노트 수(예: Notes (2))를 보여줍니다.

노트를 추가하려면 다음을 수행하십시오.
  1. 노트 탭을 클릭하십시오.
  2. 텍스트 필드에 새 노트를 작성하십시오.
  3. 제출을 클릭하십시오.
노트를 편집하려면 다음을 수행하십시오.
  1. 노트 탭을 클릭하십시오.
  2. 편집하려는 노트 옆에 있는 편집 아이콘(편집 아이콘)을 클릭하십시오. 노트를 편집하십시오.
  3. 제출을 클릭하십시오.
노트를 삭제하려면 다음을 수행하십시오.
  1. 노트 탭을 클릭하십시오.
  2. 휴지통 아이콘(휴지통 아이콘)을 클릭하십시오. 노트 삭제를 확인하는 프롬프트가 표시됩니다.
  3. 확인을 클릭하십시오.

피드백