Cloud Manager에서 외부 저장소 추가 - 제한된 베타

마지막 업데이트: 2025년 3월 4일

작성 대상:

  • 관리자
  • 개발자

Cloud Manager에 외부 저장소를 추가하는 방법을 알아보십시오. Cloud Manager는 GitHub, GitLab 및 Bitbucket 저장소와의 통합을 지원합니다.

NOTE
이 기능은 조기 채택 프로그램을 통해서만 사용할 수 있습니다. 자세한 내용을 알고 얼리 어답터로 등록하려면 GitLab 및 Bitbucket에 대한 지원을 통해 지금 자신의 Git을 가져오세요를 참조하세요.

외부 저장소 구성

Cloud Manager에서 외부 저장소를 구성하는 작업은 세 단계로 구성됩니다.

  1. 선택한 프로그램에 외부 저장소를 추가합니다.
  2. 외부 저장소에 액세스 토큰을 입력합니다.
  3. 개인 GitHub 저장소의 소유권을 확인합니다.

외부 저장소 추가

  1. my.cloudmanager.adobe.com에서 Cloud Manager에 로그인한 다음 적절한 조직을 선택합니다.

  2. 내 프로그램 콘솔에서 외부 리포지토리를 연결할 프로그램을 선택합니다.

  3. 사이드 메뉴의 서비스 ​에서 폴더 개요 아이콘 저장소 ​를 클릭합니다.

    저장소 페이지

  4. 저장소 페이지의 오른쪽 상단 근처에서 저장소 추가 ​를 클릭합니다.

  5. 저장소 추가 대화 상자에서 비공개 저장소 ​를 선택하여 외부 Git 저장소를 프로그램에 연결합니다.

    자체 저장소 추가

  6. 각 필드에 저장소에 대한 다음 세부 정보를 입력합니다.

    필드설명
    저장소 이름필수. 새로운 저장소의 표현적인 이름.
    저장소 URL필수. 저장소의 URL.

    GitHub 호스팅 리포지토리를 사용하는 경우 경로는 .git에서 끝나야 합니다.
    예: https://github.com/org-name/repo-name.git (URL 경로는 설명 목적으로만 사용됨)

    외부 저장소를 사용하는 경우 다음 URL 경로 형식을 사용해야 합니다.
    https://git-vendor-name.com/org-name/repo-name.git
    또는
    https://self-hosted-domain/org-name/repo-name.git
    그리고 Git 공급업체와 일치해야 합니다.
    저장소 유형 선택

    필수. 사용 중인 저장소 유형을 선택합니다.

    • GitHub(GitHub Enterprise Server 및 자체 호스팅 버전의 GitHub)
    • GitLab(gitlab.com 및 자체 호스팅 버전의 GitLab 모두)
    • Bitbucket(bitbucket.org 및 Bitbucket 서버와 자체 호스팅 버전의 Bitbucket)

    위의 저장소 URL 경로에 GitLab이나 Bitbucket과 같은 Git 공급업체 이름이 포함되어 있는 경우 저장소 유형이 미리 선택됩니다.

    설명선택 사항. 저장소에 대한 자세한 설명.

  7. 저장 ​을 선택하여 저장소를 추가합니다.

  8. 비공개 저장소 소유권 유효성 검사 대화 상자에서 액세스 토큰을 입력하여 외부 저장소에 액세스할 수 있도록 소유권 유효성을 검사합니다.

    저장소에 대한 기존 액세스 토큰 선택
    Bitbucket 저장소에 대한 기존 액세스 토큰을 선택하는 중입니다.

    토큰 유형설명
    기존 액세스 토큰 사용조직에 대한 저장소 액세스 토큰을 이미 입력했고 여러 저장소에 대한 액세스 권한이 있는 경우 기존 토큰을 선택할 수 있습니다. 토큰 이름 드롭다운 목록을 사용하여 저장소에 적용할 토큰을 선택합니다. 그렇지 않은 경우 새로운 액세스 토큰을 추가합니다.
    새로운 액세스 토큰 추가저장소 유형: GitHub
    • 토큰 이름 텍스트 필드에 생성하려는 액세스 토큰의 이름을 입력합니다.
    • GitHub 설명서의 지침에 따라 개인 액세스 토큰을 만듭니다.
    · 필요한 권한은 GitHub용 새 PAT 만들기를 참조하십시오.
    • 액세스 토큰 필드에 방금 만든 토큰을 붙여넣습니다.
    저장소 유형: GitLab
    • 토큰 이름 텍스트 필드에 생성하려는 액세스 토큰의 이름을 입력합니다.
    • GitLab 설명서의 지침에 따라 개인 액세스 토큰을 만듭니다.
    · 필요한 권한은 GitLab용 새 PAT 만들기를 참조하십시오.
    • 액세스 토큰 필드에 방금 만든 토큰을 붙여넣습니다.
    저장소 유형: Bitbucket
    • 토큰 이름 텍스트 필드에 생성하려는 액세스 토큰의 이름을 입력합니다.
    • Bitbucket 설명서를 사용하여 저장소 액세스 토큰을 만듭니다.
    · 필요한 사용 권한에 대해서는 Bitbucket용 새 PAT 만들기를 참조하십시오.
    NOTE
    새로운 액세스 토큰 추가 기능은 현재 얼리 어답터 단계에 있습니다. 추가 기능이 계획 중입니다. 따라서 액세스 토큰에 필요한 권한이 변경될 수 있습니다. 또한 토큰을 관리하기 위한 사용자 인터페이스가 업데이트될 수 있으며, 토큰 만료일과 같은 기능이 포함될 수 있습니다. 또한 저장소에 연결된 토큰이 유효한지 자동으로 확인하는 검사도 제공됩니다.

  9. 유효성 검사 ​를 클릭합니다.

유효성 검사 후에는 외부 저장소를 사용하여 파이프라인에 연결할 준비가 됩니다.

검증된 외부 저장소를 파이프라인에 연결

  1. 파이프라인 추가 또는 편집:

    파이프라인의 소스 코드 저장소 및 Git 분기
    선택된 저장소 및 Git 분기가 있는 비프로덕션 파이프라인 대화 상자 추가

  2. 파이프라인을 추가하거나 편집할 때 새 파이프라인 또는 기존 파이프라인의 소스 코드 위치를 지정하려면 저장소 드롭다운 목록에서 사용할 외부 저장소를 선택합니다.

  3. Git 분기 드롭다운 목록에서 파이프라인의 소스로 사용할 분기를 선택합니다.

  4. 저장 ​을 클릭합니다.

TIP
Cloud Manager의 저장소 관리에 대한 자세한 내용은 Cloud Manager 저장소를 참조하십시오.

외부 저장소에 대한 웹후크 구성

Cloud Manager을 사용하면 추가한 외부 Git 저장소에 대한 웹후크를 구성할 수 있습니다. 외부 저장소 추가를 참조하십시오. 이러한 웹후크를 사용하면 Cloud Manager이 Git 공급업체 솔루션 내의 다양한 작업과 관련된 이벤트를 수신할 수 있습니다.

예를 들어 웹 후크를 사용하면 Cloud Manager에서 다음과 같은 이벤트를 기반으로 작업을 트리거할 수 있습니다.

  • 끌어오기 요청(PR) 만들기 - PR 유효성 검사 기능을 시작합니다.
  • 푸시 이벤트 - "Git Commit 시" 트리거가 켜지면(활성화됨) 파이프라인을 시작합니다.
  • 향후 댓글 기반 작업 - PR에서 신속한 개발 환경(RDE)으로 직접 배포하는 것과 같은 워크플로우를 허용합니다.

Cloud Manager은 GitHub 앱을 통해 직접 통합되므로 GitHub.com에서 호스팅되는 저장소에 대해 Webhook 구성이 필요하지 않습니다.
GitHub Enterprise Server, GitLab 및 Bitbucket과 같이 액세스 토큰과 함께 온보딩되는 다른 모든 외부 저장소의 경우 Webhook 구성을 사용할 수 있으며 수동으로 설정해야 합니다.

외부 저장소에 대한 웹후크를 구성하려면:

  1. my.cloudmanager.adobe.com에서 Cloud Manager에 로그인한 다음 적절한 조직을 선택합니다.

  2. 내 프로그램 콘솔에서 외부 Git 저장소에 대한 웹후크를 구성할 프로그램을 선택합니다.

  3. 페이지의 왼쪽 상단에서 메뉴 표시 아이콘 을 클릭하여 왼쪽 사이드 메뉴를 표시합니다.

  4. 왼쪽 메뉴에서 프로그램 제목 아래의 폴더 개요 아이콘 저장소 ​을 클릭합니다.

  5. 저장소 페이지에서 유형 열을 사용하여 선택 항목을 안내하고 원하는 저장소를 찾은 다음 그 옆에 있는 줄임표 - 기타 아이콘 을 클릭합니다.

    선택한 저장소의 드롭다운 메뉴에서 Webhook 옵션 구성

  6. 드롭다운 메뉴에서 Webhook 구성 ​을 클릭합니다.

    Webhook 구성 대화 상자

  7. Webhook 구성 대화 상자에서 다음을 수행합니다.

    1. Webhook URL 필드 옆에 있는 복사 아이콘 을 클릭합니다.
      URL을 일반 텍스트 파일에 붙여넣습니다. 복사된 URL은 Git 공급업체의 Webhook 설정에 필요합니다.
    2. Webhook 암호 토큰/키 필드 옆에 있는 생성 ​을 클릭한 다음 복사 아이콘 을 클릭합니다.
      암호를 일반 텍스트 파일에 붙여넣습니다. 복사된 암호는 Git 공급업체의 Webhook 설정에 필요합니다.

  8. 닫기 ​를 클릭합니다.

  9. Git 공급업체 솔루션(GitHub Enterprise, GitLab 또는 Bitbucket)으로 이동합니다.

  10. 솔루션의 Webhook 설정 섹션을 찾습니다.

  11. 이전에 복사한 웹후크 URL을 URL 텍스트 필드에 붙여넣습니다.

    1. Webhook URL의 api_key 쿼리 매개 변수를 고유한 실제 API 키로 바꾸십시오.

      API 키를 생성하려면 Adobe Developer Console에서 통합 프로젝트를 만들어야 합니다. 자세한 내용은 API 통합 프로젝트 만들기를 참조하십시오.

  12. 이전에 복사한 웹후크 암호를 암호(또는 암호 키 또는 암호 토큰) 텍스트 필드에 붙여 넣으십시오.

  13. Cloud Manager에서 예상하는 적절한 이벤트를 전송하도록 웹후크를 구성합니다.

    Webhook 구성에 대한 모든 세부 정보와 각 공급업체에 필요한 이벤트는 다음 위치에서 확인할 수 있습니다.

웹후크를 사용한 풀 요청 유효성 검사

웹후크가 올바르게 구성되면 Cloud Manager은 저장소에 대한 파이프라인 실행 또는 PR 유효성 검사를 자동으로 트리거합니다.

다음과 같은 동작이 적용됩니다.

  • GitHub Enterprise Server

    검사가 생성되면 아래 스크린샷과 같이 표시됩니다. GitHub.com과(와) 중요한 차이점은 GitHub.com이(가) 확인 실행을 사용하는 반면 GitHub Enterprise Server(개인 액세스 토큰 사용)는 커밋 상태를 생성한다는 것입니다.

    GitHub Enterprise Server의 PR 유효성 검사 프로세스를 나타내는 커밋 상태

  • Bitbucket

    코드 품질 유효성 검사가 실행 중인 경우:

    코드 품질 유효성 검사를 실행하는 동안 상태

    PR 유효성 검사 진행 추적을 위해 커밋 상태를 사용합니다. 다음의 경우 스크린샷은 고객 문제로 인해 코드 품질 유효성 검사가 실패하면 어떻게 되는지 보여 줍니다. 자세한 오류 정보가 포함된 댓글이 추가되고 실패를 표시하는 커밋 검사가 만들어집니다(오른쪽에 표시).

    Bitbucket에 대한 끌어오기 요청 유효성 검사 상태

  • GitLab

    GitLab 상호 작용은 주석에만 의존합니다. 유효성 검사가 시작되면 댓글이 추가됩니다. 유효성 검사가 완료되면(성공 또는 실패) 초기 주석을 제거하고 유효성 검사 결과 또는 오류 세부 정보가 포함된 새 주석으로 대체합니다.

    코드 품질 유효성 검사가 실행 중인 경우:

    코드 품질 유효성 검사를 실행하는 경우

    냉간 품질 유효성 검사가 완료되면:

    냉기 품질 유효성 검사가 완료되면

    코드 품질 유효성 검사에 실패하고 오류가 발생하는 경우:

    오류와 함께 코드 품질 유효성 검사에 실패하는 경우

    고객 문제로 인해 코드 품질 유효성 검사가 실패하면:

    고객 문제로 인해 코드 품질 유효성 검사에 실패하는 경우

Webhook 문제 해결

  • Webhook URL에 유효한 API 키가 포함되어 있는지 확인합니다.
  • Git 공급업체 설정에 웹후크 이벤트가 올바르게 구성되어 있는지 확인합니다.
  • PR 유효성 검사 또는 파이프라인 트리거가 작동하지 않는 경우 Cloud Manager 및 Git 공급업체 모두에서 웹후크 비밀이 최신 상태인지 확인하십시오.

제한 사항

  • 외부 저장소는 구성 파이프라인에 연결할 수 없습니다.
  • 외부 저장소(GitHub에서 호스팅되지 않음) 및 "Git 변경 시" 트리거가 있는 파이프라인은 자동으로 시작되지 않습니다. 수동으로 시작할 수만 있습니다.

Experience Manager