사용 방법 IBM App Connect GitHub

GitHub 는 소프트웨어 개발 및 버전 관리를 위한 인터넷 Git 리포지토리 호스팅 서비스입니다. Git, 액세스 제어, 버그 추적, 소프트웨어 기능 요청, 작업 관리, 지속적 통합 및 모든 프로젝트에 대한 위키의 분산된 수정 버전 제어 및 소스 코드 관리(SCM) 기능을 제공합니다.

가용성:
  • App Connect 커넥터
  • IBM App Connect in containers (지속적 배포 릴리스)의 디자이너 인스턴스에 있는 로컬 커넥터컨테이너 내 로컬 커넥터 (지속적 배포 릴리스) 12.0.7.0-r1 이상
  • IBM App Connect in containers (지원 주기 2)의 디자이너 인스턴스에 있는 로컬 커넥터컨테이너 내 로컬 커넥터 ( Cycle-2 장기 지원 릴리스)

다음에 연결 GitHub

App Connect Designer의 ‘Connect > Applications and APIs’ 페이지(이전의 ‘Catalog’ 페이지) 또는 플로우 편집기에 표시되는 연결 필드를 입력하세요. 필요한 경우 관리자와 협력하여 GitHub 관리자와 협력하여 이 값을 얻으세요.

연결하려면 App Connect 계정에 연결하려면 GitHub 계정에 연결하려면 원하는 애플리케이션 유형을 선택하세요:
  • GitHub Enterprise 서버
  • GitHub 클라우드
그런 다음 다음 표에서 원하는 인증 유형을 선택합니다:
애플리케이션 유형 권한 부여 유형( App Connect in containers ) 권한 부여 유형( App Connect ) 연결 필드
GitHub 클라우드 App Connect 에 사용할 자격 증명 제공(BASIC) App Connect 에 사용할 자격 증명 제공(BASIC) 개인 액세스 토큰
GitHub 클라우드 App Connect 에 사용할 자격 증명 제공(BASIC OAUTH) App Connect 에 사용할 자격 증명 제공(BASIC OAUTH) 액세스 토큰
GitHub 클라우드   애플리케이션 웹사이트를 사용하여 로그인합니다(OAUTH 2.0 인증 코드)  
GitHub Enterprise 서버 App Connect 에 사용할 자격 증명 제공(BASIC) App Connect 에 사용할 자격 증명 제공(BASIC) 엔드포인트 URL 및 개인 액세스 토큰
GitHub Enterprise 서버 App Connect 에 사용할 자격 증명 제공(BASIC OAUTH) App Connect 에 사용할 자격 증명 제공(BASIC OAUTH) 엔드포인트 URL 및 액세스 토큰
연결 필드에 대한 설명입니다:
연결 필드 설명
엔드포인트 URL URLGitHub 인스턴스를 https:// <호스트 이름> 형식으로 지정합니다.
팁: 자세한 내용은 페이지에서 GitHub 문서 계정 GitHub 시작하기 확인하세요.
개인 액세스 토큰 API에 액세스하기 위한 개인 액세스 토큰 GitHub API에 액세스하기 위한 개인 액세스 토큰입니다. 계정 설정 페이지에서 개인 액세스 토큰을 생성합니다 GitHub 계정 설정 페이지에서 개인 액세스 토큰을 생성합니다.
팁: 개인 액세스 토큰 생성에 대한 자세한 내용은 GitHub 문서 페이지의 ‘개인 액세스 토큰 만들기’를 참조하세요.
액세스 토큰 애플리케이션 클라이언트 ID, 테넌트 ID, 클라이언트 비밀, 범위, 부여 유형, 사용자 이름 및 비밀번호에서 생성된 액세스 토큰입니다.
팁: 액세스 토큰 생성에 대한 자세한 내용은 페이지의 GitHub 문서 항목을 앱 OAuth 승인 참조하세요.

GitHub 에 대한 연결 값을 얻으려면 GitHub 에 대한 연결 값 가져오기를 참조하세요.

엔드포인트에 연결하려면 GitHub 엔드포인트에 처음으로 연결하려면 App Connect 디자이너 애플리케이션 및 API 페이지에서 GitHub 을 확장한 다음 연결을 클릭합니다. 자세한 내용은 계정 관리하기를 참조하세요.

팁:

에서 만든 계정을 사용하기 전에 App Connect 에서 생성된 계정을 사용하기 전에 계정을 식별하는 데 도움이 되는 의미 있는 이름으로 이름을 변경하세요. 애플리케이션 및 API 페이지에서 계정 이름을 변경하려면 계정을 선택하고 옵션 메뉴(⋮)를 연 다음 계정 이름 바꾸기를 클릭합니다.

일반 고려사항

App Connect 디자이너를 사용하기 전에 GitHub 를 사용하기 전에 다음 고려 사항을 참고하세요:

  • 커넥터에 연결하려면 repodelete_repo 같은 범위가 필요합니다 GitHub 커넥터에 연결하려면 이 스코프에 대한 자세한 내용은 페이지에서 GitHub 문서 앱용 OAuth 스코프 확인하세요.
  • 조직 개체를 제외하고 모든 종류의 작업을 수행하려면 드롭다운 목록에서 조직을 선택해야 합니다.
    다음 이슈 개체에서 이슈 만들기 작업을 사용하는 예에서 목록의 첫 번째 옵션은 인증된 사용자의 로그인 ID에 해당하고 나머지 목록은 사용자가 속한 조직 ID에 해당합니다:
    조직 ID가 포함된 드롭다운 목록 예시

    여기에서 목록에서 로그인 ID를 선택하면 개인 리포지토리를 선택하여 모든 만들기, 검색, 업데이트, 삭제 작업 또는 사용자 지정 이벤트 작업을 수행할 수 있습니다.

  • 일부 개체의 경우 (리뷰, 커밋 댓글, 댓글 검토, 댓글 ) ID 필터를 사용하여 단일 개체를 검색하는 경우 선택한 필수 드롭다운 목록 값은 무시됩니다.
    다음 예에서 검토 ID 필터에 값을 입력하면 드롭다운 목록에서 사용자가 선택한 풀 리퀘스트 값은 무시됩니다.
    풀 리퀘스트 필터 및 리뷰 ID 필터가 적용된 오브젝트의 예시

    또한 이 예제에서 검토 ID 이외의 다른 필터 값을 선택하거나 필터를 적용하지 않으면 선택한 풀 리퀘스트 값의 모든 리뷰가 표시됩니다.

  • (일반적인 고려 사항) App Connect 디자이너의 애플리케이션 및 API 페이지에서 사용 가능한 트리거 이벤트 및 작업 목록을 확인할 수 있습니다.

    일부 애플리케이션의 경우 이벤트 및 작업은 환경과 커넥터가 구성 가능한 이벤트 및 동적 작업 검색을 지원하는지 여부에 따라 달라집니다. 애플리케이션이 구성 가능한 이벤트를 지원하는 경우 이벤트 목록 아래에 구성 가능한 이벤트 더 보기 링크가 표시됩니다. 애플리케이션이 동작의 동적 검색을 지원하는 경우 동작 목록 아래에 자세히 보기 링크가 표시됩니다.

  • (일반적인 고려 사항) 애플리케이션에 여러 개의 계정을 사용하는 경우 해당 애플리케이션에 대한 작업을 선택할 때 표시되는 필드 집합은 계정마다 다를 수 있습니다. 흐름 편집기에서 일부 애플리케이션은 항상 작업에 대해 선별된 정적 필드 집합을 제공합니다. 다른 애플리케이션은 동적 검색을 사용하여 연결된 인스턴스에 구성된 필드 집합을 검색합니다. 예를 들어 애플리케이션의 두 인스턴스에 대해 두 개의 계정이 있는 경우 첫 번째 계정에서는 즉시 사용할 수 있는 설정을 사용할 수 있습니다. 그러나 두 번째 계정은 추가 사용자 지정 필드로 구성할 수 있습니다.

이벤트 및 작업

GitHub 이벤트

이러한 이벤트는 흐름에서 작업을 완료하기 시작하도록 흐름을 트리거하는 이 애플리케이션의 변경에 대한 것입니다.

구성 가능한 이벤트를 더 많이 표시합니다 : 기본적으로 표시되는 이벤트는 최적화된 연결을 사용하여 미리 구성되어 있습니다. 이 애플리케이션에서 새 개체 또는 업데이트된 개체를 폴링하여 흐름을 트리거할 수 있는 이벤트를 구성한 후에 더 많은 항목을 사용할 수 있습니다.

GitHub 작업

흐름이 이 애플리케이션에서 이러한 작업을 완료합니다.

오브젝트 조치 설명
분기 브랜치 병합 브랜치 병합하기
브랜치 검색 브랜치 검색
문제 피지정자 추가 이슈에 담당자 추가
문제 작성 이슈 만들기
양수인 제거 이슈에서 할당자를 제거합니다
이슈 검색 이슈 검색
문제 업데이트 이슈 업데이트
조직 조직 검색 조직 검색
조직 업데이트 조직 업데이트
가져오기 요청 풀 리퀘스트 만들기 풀 리퀘스트 생성
풀 리퀘스트 병합 풀 리퀘스트를 병합합니다
풀 리퀘스트 검색 풀 리퀘스트를 검색합니다
풀 리퀘스트 업데이트 풀 리퀘스트 업데이트
저장소 저장소 작성 리포지토리 만들기
저장소 삭제 리포지토리를 삭제합니다
리포지토리 검색 리포지토리를 검색합니다
리포지토리 업데이트 리포지토리 업데이트

App Connect 에 연결하면 더 많은 항목을 사용할 수 있습니다 GitHub.

다음을 사용하는 템플릿의 대시보드 타일 GitHub
깃허브를 사용하는 템플릿의 대시보드 타일
다음을 사용하는 템플릿의 대시보드 타일 GitHub

템플릿을 사용하여 다음에 대한 흐름을 빠르게 만들 수 있습니다 GitHub

템플릿을 사용하여 App Connect 템플릿을 사용하여 다음에 대한 작업을 수행하는 플로우를 빠르게 생성하는 방법에 대해 알아보세요 GitHub. 예를 들어 Discover를 연 다음 GitHub 을 검색합니다.

다음을 사용하는 템플릿의 대시보드 타일 GitHub
GitHub 흐름 상세 보기

를 사용하여 App Connect 와 통합되는 흐름을 구축하려면 GitHub.

Jira 에서 새로운 이슈가 생성될 때 GitHub 에서 저장소나 이슈를 생성하는 방법을 알아보려면 IBM® 커뮤니티의 블로그를 읽어보세요. 블로그 읽기를 클릭하여 블로그로 이동합니다.