설명서AEM as a Cloud Service사용 안내서

파이프라인 변수 구성 configuring-pipeline-variables

Last update: Wed Jun 05 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

작성 대상:

  • 관리자
  • 개발자

빌드 프로세스는 git 저장소에 배치하기에 부적절하거나 동일한 분기를 사용하는 파이프라인 실행 간에 달라져야 하는 특정 구성 변수에 따라 달라질 수 있습니다. Cloud Manager를 사용하면 이러한 데이터를 파이프라인 변수로 관리할 수 있습니다.

파이프라인 변수 pipeline-variables

Cloud Manager를 사용하여 여러 가지 방법으로 파이프라인 변수를 구성할 수 있습니다.

변수는 일반 텍스트로 저장되거나 사용하지 않을 때 암호화될 수 있습니다. 두 경우 모두 pom.xml 파일 또는 다른 빌드 스크립트 내에서 참조할 수 있는 환경 변수로 빌드 환경 내에서 변수를 사용할 수 있습니다.

파이프라인 변수 이름 지정 규칙 naming-conventions

변수 이름은 다음 규칙을 준수해야 합니다.

  • 변수에는 영숫자와 밑줄(_)만 포함될 수 있습니다.
  • 이름은 모두 대문자로 해야 합니다.
  • 파이프라인당 200개의 변수 제한이 있습니다.
  • 각 이름은 100자 이하여야 합니다.
  • 각 string 변수 값은 2048자 미만이어야 합니다.
  • 각 secretString 형식 변수 값은 500자 이하여야 합니다.

Cloud Manager UI를 통해 ui

Cloud Manager UI를 통해 파이프라인 변수를 구성하고 관리할 수 있습니다. 파이프라인 변수를 추가, 편집 및 삭제하려면 파이프라인을 편집할 수 있는 권한이 있어야 합니다.

파이프라인이 실행 중인 경우 변수 관리가 차단됩니다.

파이프라인 변수 추가 add-ui

  1. 날짜 파이프라인 관리, 파이프라인 변수를 생성하려는 파이프라인의 생략 부호를 탭하거나 클릭한 다음 을 선택합니다 변수 보기/편집 컨텍스트 메뉴 아래의 제품에서 사용할 수 있습니다.

    파이프라인 변수 보기/편집

  2. 다음 변수 구성 창이 열립니다. 표의 첫 행에 변수 세부 정보를 입력하고 을 탭하거나 클릭합니다 추가.

    • 구성 이름 는 변수의 고유 식별자로, 앞에 와야 합니다. 파이프라인 변수 이름 지정 규칙입니다.

    • 값 는 변수가 보유하는 값입니다.

    • 단계 적용됨 는 변수가 적용되는 파이프라인의 단계입니다. 필수입니다.

      • 빌드
      • 기능 테스트
      • UI 테스트

    • 유형 변수가 일반 텍스트인지 또는 비밀로 암호화되었는지 정의합니다.

    변수 추가

  3. 가 테이블에 추가됩니다. 필요에 따라 변수를 추가한 다음 탭하거나 클릭합니다 저장 을 클릭하여 파이프라인에 추가한 변수를 저장합니다.

파이프라인 변수 편집 edit-ui

  1. 날짜 파이프라인 관리, 파이프라인 변수를 생성하려는 파이프라인의 생략 부호를 탭하거나 클릭한 다음 을 선택합니다 변수 보기/편집 컨텍스트 메뉴 아래의 제품에서 사용할 수 있습니다.

    파이프라인 변수 보기/편집

  2. 다음 변수 구성 창이 열립니다. 편집하려는 변수의 줄임표 버튼을 탭하거나 클릭하여 선택합니다 편집.

    변수 편집

  3. 필요에 따라 변수 값을 업데이트한 다음 탭하거나 클릭합니다 적용 (행 끝에 있는 확인 표시) 버리기 (뒤로 화살표) 를 클릭하여 변경 내용을 되돌립니다.

    • 변수 값만 편집할 수 있습니다.

    변수 편집

  4. 탭 또는 클릭 저장 을 눌러 변수의 변경 사항을 파이프라인에 저장합니다.

변수를 삭제하려면 삭제 대신 편집 을 클릭하여 표시되는 파이프라인 변수의 줄임표 메뉴에서 변수 구성 창.

Cloud Manager CLI 사용 cli

이 CLI 명령은 변수를 설정합니다.

$ aio cloudmanager:set-pipeline-variables PIPELINEID --variable MY_CUSTOM_VARIABLE test

이 명령은 변수를 나열합니다.

$ aio cloudmanager:list-pipeline-variables PIPELINEID

Maven pom.xml 파일 내에서 사용할 경우, 일반적으로 다음과 유사한 구문을 사용하여 이러한 변수를 Maven 속성에 매핑하는 것이 유용합니다.

        <profile>
            <id>cmBuild</id>
            <activation>
                <property>
                    <name>env.CM_BUILD</name>
                </property>
            </activation>
            <properties>
                <my.custom.property>${env.MY_CUSTOM_VARIABLE}</my.custom.property>
            </properties>
        </profile>
recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab