0 / 0
영어 버전 문서로 돌아가기
오케스트레이션 파이프라인에 대한 글로벌 오브젝트 구성
마지막 업데이트 날짜: 2024년 9월 23일
오케스트레이션 파이프라인에 대한 글로벌 오브젝트 구성

글로벌 오브젝트를 사용하여 런타임 시 파이프라인을 구성하기 위한 구성 가능한 상수를 작성하십시오. 파이프라인에서 매개변수 또는 사용자 변수를 사용하여 값을 하드코딩하지 않고 런타임 시 값을 지정하십시오. 파이프라인 매개변수와 달리 사용자 변수는 플로우 중에 동적으로 설정할 수 있습니다.

작성에 대해 알아보십시오.

파이프라인 매개변수

파이프라인 매개변수를 사용하여 파이프라인 런타임 시 값을 지정하십시오. 예를 들어, 사용자가 파이프라인 출력을 위한 배치 영역을 입력하도록 하려면 매개변수를 사용하여 파이프라인이 실행될 때 사용할 영역 이름을 묻는 프롬프트를 표시하십시오. 작업을 실행할 때마다 매개변수의 값을 지정하면 올바른 자원을 사용하는 데 도움이 됩니다.

파이프라인 매개변수 정보:

  • 노드 값으로 지정하거나 파이프라인 작업에 지정할 수 있습니다.
  • 모든 노드에 지정할 수 있으며 상태 표시기가 사용자에게 경고합니다.
  • 여러 노드에 사용할 수 있습니다.

파이프라인 매개변수 정의

  1. 도구 모음의 노드 구성 패널에서 파이프라인 매개변수를 작성하십시오.
  2. 이름 및 선택적 설명을 입력하십시오. 이름은 소문자, 숫자 및 밑줄이 있는 소문자 이어야 합니다. 예를 들어, lower_snake_case_with_numbers_123 은 올바른 이름입니다. 이름은 문자로 시작해야 합니다. 이름이 이를 준수하지 않으면 파이프라인을 실행하려고 할 때 404오류가 발생합니다.
  3. 매개변수 유형을 지정하십시오. 매개변수 유형에 따라 세부사항을 제공하거나 기본값을 지정해야 할 수 있습니다.
  4. 파이프라인 매개변수를 저장하려면 목록에 추가를 클릭하십시오.
참고:


-개별 매개변수를 정의하거나 매개변수 세트를 작성할 수 있습니다. 개별적으로 정의하는 매개변수를 세트에 추가할 수도 있습니다.
-파이프라인에서 지원되지 않는 결과를 생성할 수 있는 방식으로 파이프라인 매개변수를 사용할 수 있습니다. 일반 자산이 있는 매개변수를 해당 값으로 지정하는 경우 자산 복사 노드에서 지원하지 않는 매개변수 값으로 자산을 선택할 수 있습니다.

매개변수 유형

매개변수 유형은 다음으로 분류됩니다.

  • 기본: 파이프라인에 대한 입력을 구조화하기 위한 데이터 유형 또는 중복 공간 또는 자산 작성을 처리하기 위한 옵션을 포함합니다.
  • 자원: 프로젝트, 카탈로그, 공간 또는 자산을 선택합니다.
  • 인스턴스: 기계 학습 인스턴스 또는 Cloud Object Storage 인스턴스를 선택합니다.
  • 기타: 작성 모드 또는 오류 정책과 같은 세부사항을 지정하는 경우.

파이프라인 유형 사용 예제

경로유형의 매개변수를 작성하려면 다음을 수행하십시오.

  1. MASTER_PARAMETER_SET라는 매개변수 세트를 작성하십시오.
  2. file_path 라는 매개변수를 작성하고 유형을 경로로 설정하십시오.
  3. file_path 의 값을 mnts/workspace/masterdir로 설정하십시오. 값을 설정할 수 있는 여러 가지 방법이 있습니다.
    • 자원 선택: UI를 사용하여 범위에서 파일을 찾아보십시오.
    • 값 입력: 파일의 상대 경로에 대한 올바른 텍스트입니다 (예: /mnts/sender.txt).
  4. 파일 대기 노드를 캔버스로 끌고 파일 위치 값을 MASTER_PARAMETER_SET.file_path로 설정하십시오.
  5. 파일 대기Bash 스크립트 실행 노드와 연결하여 후자 노드가 전자 노드 이후에 실행되도록 하십시오.
  6. 선택사항: 매개변수 변수를 테스트하십시오.
    1. MASTER_PARAMETER_SET 매개변수 세트에 환경 변수 매개변수를 추가하십시오 (예: FILE_PATH).
    2. 다음 명령을 Bash 스크립트 실행스크립트 코드 에 붙여넣으십시오.
      echo File: $FILE_PATH
      cat $FILE_PATH
      
  7. 파이프라인을 실행하십시오. mnts/workspace/masterdir 경로는 성공적으로 전달되었는지 확인하기 위해 두 노드의 실행 로그 모두에 있습니다.

파이프라인 매개변수를 사용하여 노드 구성

파이프라인 매개변수를 사용하여 노드를 구성할 때는 기존 파이프라인 매개변수를 선택하거나 노드 구성의 일부로 새 매개변수를 작성할 수 있습니다.

예를 들어,

  1. creationmode라는 파이프라인 매개변수를 작성하여 매개변수 목록에 저장하십시오.
  2. 배치 공간 작성 노드를 구성하고 클릭하여 구성 패널을 여십시오.
  3. 파이프라인 매개변수작성 모드 옵션의 입력으로 선택하십시오.
  4. creationmode 파이프라인 매개변수를 선택하고 구성을 저장하십시오.

파이프라인을 실행하면 영역이 작성될 때 플로우 매개변수가 지정됩니다.

매개변수 세트

매개변수 세트는 파이프라인에서 사용할 관련 매개변수의 그룹입니다. 예를 들어, 테스트 환경에서 사용할 하나의 매개변수 세트와 프로덕션 환경에서 사용할 다른 매개변수 세트를 작성할 수 있습니다.

매개변수 세트는 프로젝트 자산으로 작성할 수 있습니다. 그러면 프로젝트에서 작성된 매개변수 세트를 해당 프로젝트의 파이프라인에서 사용할 수 있습니다.

프로젝트 자산으로 매개변수 세트 작성

파이프라인에서 사용할 재사용 가능한 프로젝트 자산으로 매개변수 세트를 작성할 수 있습니다.

  1. 기존 프로젝트를 열거나 프로젝트를 작성하십시오.
  2. 딸깍 하는 소리 새 자산 > 재사용 가능한 매개변수 세트 정의 .
  3. 세트의 이름을 지정하고 다음을 포함하여 세트의 각 매개변수에 대한 세부사항을 지정하십시오.
    • 매개변수의 이름
    • 데이터 유형
    • 프롬프트
    • 기본값
  4. 선택적으로 매개변수 세트의 매개변수에 대한 값 세트를 작성하십시오. 값 세트는 다른 컨텍스트에 대해 다른 값일 수 있습니다. 예를 들어, 테스트 환경에 대한 값으로 테스트 값 세트를 작성하고 프로덕션 값에 대한 프로덕션 세트를 작성할 수 있습니다.
  5. 모든 매개변수를 작성한 후에 매개변수 세트를 저장한다. 해당 프로젝트에서 작성된 파이프라인에서 사용할 수 있게 됩니다.

파이프라인에서 사용할 매개변수 세트 추가

프로젝트에서 매개변수 세트를 추가하려면 다음을 수행하십시오.

  1. 글로벌 오브젝트 아이콘을 클릭하고 매개변수 세트 탭으로 전환하십시오.
  2. 파이프라인에서 사용할 프로젝트의 매개변수 세트를 추가하려면 매개변수 세트 추가 를 클릭하십시오.
  3. 목록에서 매개변수 세트를 추가하거나 제거할 수 있습니다. 파이프라인에서 사용하기 위해 지정하는 매개변수 세트는 파이프라인에서 입력으로 매개변수를 지정할 때 사용 가능하게 됩니다.

파이프라인의 매개변수 목록에서 매개변수 세트 작성

파이프라인의 매개변수 목록에서 매개변수 세트를 작성할 수 있습니다.

  1. 글로벌 오브젝트 아이콘을 클릭하고 파이프라인 매개변수를 여십시오.
  2. 세트에서 원하는 매개변수를 선택한 후 매개변수 세트로 저장 아이콘을 클릭하십시오.
  3. 세트의 이름 및 선택적 설명을 입력하십시오.
  4. 파이프라인에서 사용할 매개변수 세트를 추가하려면 저장하십시오.

파이프라인에서 매개변수 세트 사용

매개변수 세트를 사용하려면 다음을 수행하십시오.

  1. 노드 특성 시트의 입력 유형으로 파이프라인 매개변수 지정 을 선택하십시오.
  2. 지정할 매개변수를 선택하십시오. 목록은 해당 입력에 대해 사용 가능한 모든 유형의 매개변수를 표시합니다. 사용 가능한 매개변수는 개별 매개변수 및 세트의 일부로 정의된 매개변수일 수 있습니다. 매개변수 세트 이름이 매개변수 이름 앞에 옵니다. 예를 들어, Parameter_set_name.Parameter_name입니다.
  3. 파이프라인을 실행하고 해당 값에 대해 설정된 값을 선택하거나 (사용 가능한 경우) 매개변수에 대한 값을 지정하거나 기본값을 승인하십시오.
주: ` param_sets 형식을 사용하여 표현식 빌더에서 매개변수 세트를 사용할 수 있습니다.`. 매개변수 집합 값에 환경 변수가 포함된 경우 표현식 작성기에서 다음 구문을 사용해야 합니다.`param_sets.MyParamSet["$ICU_DATA" ]`.

프로젝트 기본 매개변수 세트 사용

프로젝트에는 PROJDEF라는 이름의 매개변수 집합이 있을 수 있습니다. 이 매개변수 집합에는 DataStage 흐름 또는 파이프라인 흐름에서 참조할 수 있는 전역 속성 집합이 포함되어 있습니다. 파라미터 세트이므로 기존 파라미터 세트 UI를 사용하여 이러한 변수를 관리할 수 있습니다.

프로젝트 정의에 주의하세요:

  • 파이프라인 매개변수의 PROJDEF 값으로 PROJDEF 매개변수 세트 값을 참조할 수 있습니다.
  • PROJDEF 값은 암호화된 매개변수를 제외한 모든 유형의 매개변수에 대해 지원됩니다.
  • PROJDEF 매개변수 세트의 매개변수는 PROJDEF 값이 있는 파이프라인 매개변수와 동일한 이름을 사용해야 합니다.

프로젝트에서 PROJDEF를 사용하려면:

  1. 파라미터 세트 PROJDEF를 생성합니다.
  2. PROJDEF 매개변수 집합에 매개변수를 추가합니다(예: SOME_DATE).
  3. 도구 모음에서 글로벌 객체를 클릭합니다.
  4. 프로젝트 정의 매개변수 추가를 클릭합니다.
  5. 목록에서 매개변수를 선택합니다.
주의: 매개변수를 삭제하는 경우 작업 디자인에서 매개변수에 대한 참조를 제거해야 합니다. 참조를 제거하지 않으면 작업이 실패할 수 있습니다.

작업에서 매개변수 세트 편집

작업을 정의할 때 매개변수 세트를 사용하는 경우, 해당 세트의 값으로 변수를 채우도록 값 세트를 선택할 수 있습니다. 값을 변경하고 저장한 후 작업을 편집하고 변경사항을 저장하면 매개변수 세트 값이 기본값으로 재설정됩니다.

사용자 변수

플로우가 실행될 때 값을 지정하기 위한 사용자 변수를 작성하십시오. 파이프라인 매개변수와 달리, 사용자 변수는 처리 중 수정될 수 있습니다.

사용자 변수 정의

파이프라인에서 사용할 사용자 변수를 작성할 수 있습니다. 매개변수와 같은 사용자 변수는 글로벌 레벨에서 정의되며 노드에 특정하지 않습니다. 사용자 변수의 초기값은 정의할 때 설정해야 하며 노드 출력의 결과로 동적으로 설정할 수 없습니다. 사용자 변수를 정의할 때 사용자 변수 설정 노드를 사용하여 노드 출력으로 업데이트할 수 있습니다.

사용자 변수를 작성하려면 다음을 수행하십시오.

  1. 변수 업데이트 노드 구성 패널 또는 도구 모음에서 변수를 작성하십시오.
  2. 이름 및 선택적 설명을 입력하십시오. 이름은 소문자, 숫자 및 밑줄이 있는 소문자 이어야 합니다. 예를 들어, lower_snake_case_with_numbers_123은 유효한 이름입니다. 이름은 문자로 시작해야 합니다. 이름이 이를 준수하지 않으면 파이프라인을 실행하려고 할 때 404오류가 발생합니다.
  3. 변수 유형 및 입력 유형 선택을 포함하여 변수의 정의를 완료하십시오.
  4. 목록에 변수를 추가하려면 추가를 클릭하십시오. 이제 사용 가능하여 노드에서 사용할 수 있습니다.

표준 시간대 설정

구성 맵에서 표준 시간대를 설정할 수 있습니다.

  1. kubectl edit -n <namespace> configmap watson-pipelines-config 명령을 실행하여 컨피그맵을 엽니다. 여기서 namespace는 Cloud Pak for Data 인스턴스 네임스페이스입니다.
  2. 다음 코드 예제를 사용하여 시간대 값을 설정하세요:
    apiVersion: v1
    kind: ConfigMap
    metadata:
       name: watson-pipelines-config
       namespace: zen
    data:
       default_container_env: |
          - name: TZ
            value: America/New_York
    
  3. 파이프라인 CR에서 시간대 값을 설정합니다:
    oc patch wspipelines wspipelines-cr -p '{"spec":{"timezone":"America/New_York"}}' --type=merge
    
  4. 조정이 완료될 때까지 기다립니다:
    oc get wspipelines wspipelines-cr
    

상위 주제: 파이프라인 작성