빠른 시작: DevOps Center 함께 Salesforce CLI 사용

파이프라인 설정

파이프라인을 만들고, 스테이지를 추가 및 구성하고, 파이프라인을 활성화하고, 프로젝트를 첨부합니다.

1. 프로젝트를 나열하여 프로젝트 ID를 찾습니다.

   sf devops project list --target-org my-devops-org

   파이프라인에 첨부할 프로젝트의 ID를 복사합니다. 이 빠른 시작의 예에서는 0Hn000000000001를 사용합니다.

2. 비활성 파이프라인을 만들고 리포지토리에 연결합니다.

   sf devops pipeline create --target-org my-devops-org --name "Release Pipeline" --repo https://github.com/myorg/myrepo

   명령 출력에서 파이프라인 ID를 복사합니다. 이 빠른 시작의 예에서는 0XB000000000001를 사용합니다.

   단계를 구성하고 활성화할 때까지 파이프라인이 비활성 상태로 유지됩니다.

   파이프라인을 만드는 동안 저장소를 만들려면 --repo-type github|bitbucket가 있는 --create-repo을 사용합니다.

3. 파이프라인에 단계를 추가합니다. 새 파이프라인에는 기본 최종 단계가 포함됩니다. --next-stage-id로 기존 단계를 지정하여 기존 단계 앞에 각각의 새 단계를 추가합니다.

   예를 들어, 통합 단계를 추가합니다.

   sf devops pipeline stage add --target-org my-devops-org --pipeline-id 0XB000000000001 --name "Integration" --next-stage-id 0Xc000000000001

   명령 출력에서 단계 ID를 복사합니다. 나머지 예에서는 통합 단계의 0Xc000000000005을 사용합니다. UAT 등 각 추가 단계에 대해 명령을 반복합니다.

   

   팁 DevOps Center UI에서 파이프라인을 보고 후속 명령에 대한 단계 ID를 가져옵니다. 또는 sf devops pipeline get --pipeline-id 0XB000000000001를 실행합니다.
4. 각 단계를 구성합니다. 각 단계에는 분기 및 환경이 필요합니다. 최종 스테이지에 분기가 있어야만 앞에 있는 스테이지를 구성할 수 있으므로 스테이지를 오른쪽에서 왼쪽으로 구성합니다.

   통합 스테이지에 분기를 추가합니다. --create-vcs-branch 플래그가 없는 경우 저장소에서 분기를 만듭니다.

   sf devops stage branch add --target-org my-devops-org --pipeline-id 0XB000000000001 --stage-id 0Xc000000000005 --branch-name integration --create-vcs-branch

   Sandbox 환경을 단계에 추가합니다.

   sf devops stage environment add --target-org my-devops-org --pipeline-id 0XB000000000001 --stage-id 0Xc000000000005 --environment-name Integration_Org --org-type Sandbox

   환경에 인증할 수 있도록 브라우저 창이 열립니다. 프로덕션 조직에 --org-type Production 사용 헤드리스 환경에서는 --no-browser를 추가하고 명령에서 반환한 인증 지침을 따릅니다.

   모든 스테이지에 대해 분기 및 환경 명령을 반복합니다. 각 스테이지에 적합한 지점 이름, 환경 이름 및 조직 유형을 사용합니다.

5. 파이프라인을 활성화합니다.
   

   중요 변경 사항을 승격한 후에는 파이프라인 스테이지를 수정할 수 없습니다. 이 명령을 실행하기 전에 모든 단계가 올바르게 구성되어 있는지 확인하십시오.

   sf devops pipeline update --target-org my-devops-org --pipeline-id 0XB000000000001 --activate

6. DevOps Center 프로젝트를 파이프라인에 첨부합니다.

   sf devops pipeline project add --target-org my-devops-org --pipeline-id 0XB000000000001 --project-id 0Hn000000000001

   파이프라인이 준비되었습니다. DevOps Center UI에서 작업 항목을 만들거나 sf devops work-item create 명령을 실행합니다.

작업 항목 관리

작업 항목을 시작하고, 변경 사항을 커밋하고, 검토를 만들고, 승격 준비가 된 작업 항목을 표시하여 개발 주기를 완료합니다.

1. 작업 항목 상태를 진행 중으로 설정합니다. DevOps Center 작업 항목에 대한 기능 분기를 만듭니다.

   sf devops work-item update --target-org my-devops-org --work-item-name WI-000042 --status "In Progress"

2. 연결된 리포지토리에서 기능 분기를 가져와 로컬 프로젝트에서 확인합니다.

   git fetch origin
   git checkout WI-000042

3. 개발 조직에서 변경 사항을 검색합니다. 이 예에서는 별칭 my-sandbox이 있는 조직에서 Apex 클래스를 검색합니다.

   sf project retrieve start --target-org my-sandbox --metadata ApexClass:MyNewClass

4. 검색된 파일을 검토하고 스테이징을 지정하고 커밋한 후 기능 분기를 푸시합니다.

   git status
   git add force-app
   git commit -am "Implement new feature"
   git push origin WI-000042

   Salesforce DX 프로젝트에서 다른 패키지 디렉터리를 사용하는 경우 git add에 전달된 경로를 조정합니다.

5. 변경 요청(가져오기 요청)을 만들어 기능 분기를 대상 분기로 병합합니다.

   sf devops review create --target-org my-devops-org --work-item-name WI-000042

6. 팀에서 변경 요청을 승인하고 병합할 때까지 기다립니다.
7. 작업 항목 상태를 업데이트하여 승격 준비가 되었음을 나타냅니다.

   sf devops work-item update --target-org my-devops-org --work-item-name WI-000042 --status "Ready to Promote"

작업 항목 승격

작업 항목을 다음 파이프라인 스테이지로 승격합니다. DevOps Center 승격을 확인하고 대상 스테이지에 대해 구성된 테스트 도구 모음을 실행하고 테스트가 통과되면 변경 사항을 배포합니다.

1. 작업 항목 ID 및 대상 단계 ID를 사용하여 작업 항목을 승격합니다.

   sf devops promote --target-org my-devops-org --work-item-id 0Wx000000000042 --target-stage-id 0Xc000000000002

   명령 출력에는 요청 ID가 포함됩니다. 이를 사용하여 프로모션 상태를 확인합니다.

   Status: Completed
   Message: Work items successfully promoted to UAT.
   Request ID: a0B000000000001
   
   Promoted Work Items
   ───────────────────
   0Wx000000000042

2. 요청 ID를 사용하여 프로모션 상태를 확인합니다.

   sf devops request status --target-org my-devops-org --request-token a0B000000000001

공통 과업

일일 개발 워크플로 동안 다음 명령을 사용합니다.

1. 여러 작업 항목을 동일한 단계로 승격합니다. 각 작업 항목에 대해 한 번의 --work-item-id를 지정합니다.

   sf devops promote --target-org my-devops-org --work-item-id 0Wx000000000042 --work-item-id 0Wx000000000043 --target-stage-id 0Xc000000000002

2. 외부에서 병합된 변경 사항을 DevOps Center 동기화되지 않은 단계에 배포합니다.

   sf devops promotion complete --target-org my-devops-org --target-stage-id 0Xc000000000002

고급 사용 사례

기본 워크플로를 완료한 후 추가 제어가 필요한 프로모션에 다음 명령을 사용합니다.