Infragraph를 GitHub에 연결하기

Infragraph를 GitHub에 연결하기

GitHub 연결은 GitHub의 데이터를 리소스 그래프로 가져와요.

출처: 문서

본문

개요

Infragraph는 조직에 설치된 GitHub App을 사용해 GitHub 리소스를 인증하고 읽어요. GitHub 연결을 설정하려면 다음 단계를 완료해야 해요.

  • GitHub App 만들기
  • GitHub App 설치하기
  • 연결 구성하기

GitHub App 만들기

Infragraph 전용 GitHub App을 만들 것을 권장해요. GitHub App을 만들려면 다음 단계를 완료하세요.

  • GitHub에서 Settings > Developer settings > GitHub Apps로 이동하세요.
  • New GitHub App을 클릭하세요.
  • 고유한 GitHub App 이름을 입력하세요.
  • Homepage URL 텍스트 상자에 유효한 URL을 입력하세요.
  • Webhook 아래에서 워크플로에 웹훅이 필요하지 않으면 Active 옵션을 끄세요.
  • 다음 저장소 권한을 구성하세요.권한접근 수준Administration읽기 전용Contents읽기 전용Metadata읽기 전용
  • Create GitHub App을 클릭하세요.

GitHub App을 만든 후 GitHub App 설정 페이지에서 App ID를 복사하세요. Infragraph 연결을 만들 때 이 값이 필요해요.

프라이빗 키 생성

Infragraph는 GitHub App을 대신해 GitHub에 대한 요청을 인증하기 위해 프라이빗 키를 사용해요. 프라이빗 키를 생성하고 다운로드하려면 다음 단계를 완료하세요.

  • GitHub App 설정 페이지를 여세요.
  • Private keys 아래에서 Generate a private key를 클릭하세요.

이 단계로 .pem 프라이빗 키 파일이 다운로드돼요. 연결을 만들 때 이 프라이빗 키가 필요해요.

GitHub App 설치

다음으로 조직에 GitHub App을 설치하려면 다음 단계를 완료하세요.

  • GitHub App 설정 페이지를 여세요.
  • 왼쪽 탐색 패널에서 Install App을 클릭하세요.
  • Infragraph를 연결하려는 계정이나 조직 옆의 Install을 클릭하세요.
  • 저장소 접근 옵션 중 하나를 선택하세요. All repositories를 선택하면 현재와 미래의 모든 저장소에 Infragraph 접근을 부여하고, Only select repositories를 선택하면 특정 저장소로 접근을 제한할 수 있어요.
  • Install을 클릭하세요.

설치 개요 페이지에서 Installation ID를 복사하세요. 연결을 만들 때 이 ID가 필요해요.

연결 만들기

GitHub 연결을 만들려면 다음 단계를 완료하세요.

  • 오른쪽 상단의 Resource graph Overview에서 Create Connection을 클릭하세요.
  • 데이터 소스 목록에서 GitHub를 선택하세요.
  • Select GitHub를 클릭하세요.
  • GitHub App ID를 입력하세요.
  • Upload .pem file을 클릭하고 만든 프라이빗 키 파일을 업로드하세요.
  • GitHub 조직 ID를 입력하세요.
  • Installation ID를 입력하세요.
  • Create connection을 클릭하세요.

GitHub 데이터 동기화

커넥터의 현재 동기화 상태를 확인하려면 다음 단계를 완료하세요.

  • HCP 조직의 왼쪽 탐색 패널에서 Connections를 클릭하세요.
  • 연결 동기화 상태를 확인하세요.

Infragraph는 다음 상태 중 하나를 보고해요.

  • Awaiting initial sync는 연결이 만들어졌지만 Infragraph가 첫 데이터 동기화를 시작하지 않았음을 의미해요.
  • Successful은 최신 동기화에 오류가 없고 Infragraph가 데이터를 동기화했음을 의미해요.
  • Partial failure는 최신 동기화에서 오류가 하나 이상 발생했음을 의미해요.

새 동기화를 수동으로 시작하려면 Actions 열의 … 메뉴에서 Sync connection을 선택하세요.

GitHub 데이터 보기

리소스 그래프에 연결된 GitHub 데이터를 찾으려면 다음 작업 중 하나를 완료하세요.

  • Inventory 페이지로 이동하세요. 개별 리소스 유형을 클릭해 그래프 탐색기에서 확인하세요.
  • GitHub 리소스가 포함된 저장된 쿼리로 리소스를 쿼리하세요.
  • 쿼리 편집기에서 GitHub 리소스를 사용해 쿼리를 처음부터 빌드하세요.

더 알아보기 (Learn more)

  • AWS 연결 — AWS 데이터를 리소스 그래프에 연결하는 방법을 알아봐요.
  • Azure 연결 — Azure 데이터를 리소스 그래프에 연결하는 방법을 알아봐요.
  • 데이터 소스 연결하기 — 연결 관리와 동기화 동작을 살펴봐요.