GitHub 구성

DevOps Insights 2026년 8월 31일에 서비스 종료되어 중단될 예정입니다. Continuous Delivery 은 2027년 2월 12일에 au-syd, ca-mon, ca-tor, us-east 지역에서 중단될 예정입니다. 또한 해당 날짜를 기점으로 Code Risk Analyzer는 모든 지역에서 서비스가 중단될 예정입니다. 특정 지역에서 해당 기능을 실제로 사용하지 않는 경우, 해당 지역의 기능은 예정보다 일찍 중단될 수 있으며 새로운 인스턴스 등록이 더 이상 허용되지 않을 수 있습니다. 자세히 알아보기

GitHub는 Git 저장소의 웹 기반 호스팅 서비스입니다. 쉽게 협업할 수 있도록 저장소의 로컬 및 원격 사본을 모두 보유할 수 있습니다.

GitHub Enterprise는 Git 저장소를 위한 온프레미스 웹 기반 호스팅 서비스입니다.

GitHub Issues는 작업과 플랜을 모두 한 위치에 보관하는 추적 도구입니다. 개발 저장소에 통합되므로 중요한 태스크에 집중할 수 있습니다.

GitHub.com의 새 저장소 또는 기존 저장소에서 소스 코드를 관리하거나 회사의 GitHub Enterprise 인스턴스에서 소스 코드를 관리할 수 있도록 GitHub를 도구 체인의 도구 통합으로 구성할 수 있습니다. 위키, 문제 추적 및 가져오기 요청을 통해 소셜 코딩에 참여하십시오.

도구 체인을 작성할 때 이 도구 통합을 구성하는 경우 다음 단계를 따르십시오.

  1. GitHub 저장소에 소스 코드를 저장 중인 경우 구성 가능한 통합 섹션에서 GitHub를 클릭하십시오. IBM Cloud 공개에서 이 도구 통합을 구성하는 경우, GitHub 에 액세스할 수 있도록 IBM Cloud 권한을 부여해야 합니다 OAuth 또는 개인 액세스 토큰을 선택해야 합니다.

    • OAuth 를 선택한 경우 인증을 클릭하여 GitHub 웹사이트로 이동합니다. 활성 GitHub 세션이 없으면 로그인을 요구하는 프롬프트가 표시됩니다. 애플리케이션에 권한 부여를 클릭하여 IBM Cloud에서 사용자의 GitHub 계정에 액세스할 수 있도록 허용하십시오. 활성 GitHub 세션이 있지만 최근에 비밀번호를 입력하지 않은 경우, 확인을 위해 GitHub 비밀번호를 입력하도록 프롬프트가 표시될 수 있습니다.

    • 개인 액세스 토큰을 선택하는 경우 GitHub 를 사용하여 저장소를 복제하고 사용자 대신 다른 조치를 수행할 수 있는 권한을 부여하는 데 사용할 개인 액세스 토큰을 입력해야 합니다. 개인 액세스 토큰이 없는 경우 GitHub 웹 사이트의 문서를 따라 토큰을 작성할 수 있습니다. 개인 액세스 토큰에 repo, delete_repo, read:user 및 workflow 권한이 있는지 확인하십시오.

  2. 자신의 GitHub Enterprise 서버에서 리포지토리를 사용하고 있는 경우, ‘구성 가능한 통합’ 섹션에서 ‘사용자 지정 서버’를 클릭하세요.

    a. 사용자 지정 GitHub 서버의 제목을 입력하고, 서버의 URL 루트를 지정하며, 개인 액세스 토큰을 입력하세요.

    b. 개인 액세스 토큰이 없는 경우 GitHub 웹 사이트의 문서를 따라 토큰을 작성할 수 있습니다.

    c. GitHub 서버가 에어 갭이 있거나 공용 인터넷에서 액세스할 수 없는 경우, 자체 Delivery Pipeline 프라이빗 워커를 연결하고 통합하여 내부 또는 온프레미스 리소스에 액세스할 수 있는 Kubernetes 인프라에서 실행할 수 있습니다. Delivery Pipeline 개인 작업자에 대한 자세한 내용은 Delivery Pipeline 개인 작업자 로 작업하기를 참조하세요.

  3. GitHub 저장소의 기본 대상 저장소 위치를 검토하십시오. 해당 저장소는 샘플 저장소에서 복제됩니다. 필요한 경우 대상 저장소의 이름을 변경하십시오.

도구 체인이 있고 여기에 이 도구 통합을 추가하는 경우 다음 단계를 따르십시오.

  1. 콘솔에서 IBM Cloud 메뉴 아이콘( 햄버거 아이콘 ) > 플랫폼 자동화 > 툴체인스를 클릭합니다. 도구 체인 페이지에서 도구 체인을 클릭하여 해당 개요 페이지를 여십시오.

  2. 도구 추가를 클릭하십시오.

  3. 도구 통합 섹션에서 GitHub를 클릭하십시오.

  4. 사용할 GitHub 서버를 클릭하십시오.

  5. GitHub 또는 GitHub Enterprise 저장소가 있으며 이를 사용하려면 저장소 유형에 대해 기존을 클릭하고 URL을 입력하십시오.

  6. 새 GitHub 또는 GitHub Enterprise 저장소를 사용하려는 경우, 해당 저장소의 이름을 입력하고 복제하거나 분기시킬 저장소의 URL을 입력하며 저장소 유형을 선택하십시오.

    a. 빈 저장소를 작성하려면 새로 작성을 클릭하십시오.

    b. GitHub 또는 GitHub Enterprise 저장소의 사본을 작성하려면 복제를 클릭하십시오.

    c. 가져오기 요청을 통해 변경사항을 제공할 수 있도록 GitHub 또는 GitHub Enterprise 저장소를 분기하려면 분기를 클릭하십시오.

  7. 업그레이드된 계정이 있는 GitHub.com 사용자이거나 GitHub Enterprise 서버를 선택하고 서버에서 새 개인용 저장소를 작성하려는 경우 이 저장소를 개인용으로 설정 선택란을 선택하십시오.

  8. 문제 추적을 위해 GitHub의 Issues를 사용하려는 경우 GitHub Issues 사용 선택란을 선택하십시오.

  9. 커미트에 대한 태그 및 주석을 작성하여 코드 변경사항 배치를 추적하고 커미트에서 참조되는 문제에 대한 레이블 및 주석을 추적하려는 경우, 코드 변경사항 배치 추적 선택란을 선택하십시오.

  10. 통합 작성을 클릭하십시오.

  11. 도구 체인의 개요 페이지에 있는 저장소 카드에서, 작업할 GitHub 또는 GitHub Enterprise 저장소를 클릭하십시오. 선택한 저장소에 따라 저장소의 컨텐츠를 볼 수 있는 GitHub 웹 사이트 또는 회사의 GitHub Enterprise 저장소가 열립니다.

  12. GitHub Issues를 사용한 경우에는 GitHub Issues를 클릭하여 이를 여십시오. 도구 체인에 여러 개의 GitHub 또는 GitHub Enterprise 저장소가 포함되어 있어도 전체 도구 체인에 대해 GitHub Issues의 이 인스턴스를 사용할 수 있습니다.

    링크 중인 저장소에 대해 관리자 권한이 없으면 웹훅을 사용할 수 없으므로 통합이 제한됩니다. 웹훅은 커미트가 저장소에 푸시될 때 파이프라인을 자동으로 실행하는 데 필요합니다. 웹훅이 없으면 파이프라인을 수동으로 시작해야 합니다.

API를 사용하여 GitHub 구성하기

도구 GitHub 통합은 도구 통합을 생성, 읽기 및 업데이트할 때 Toolchain HTTP API 및 SDK와 함께 사용할 수 있는 다음 구성 매개변수를 지원합니다.

githubconsolidated 값을 사용하여 요청 본문에서 tool_type_id 특성을 지정해야 합니다.

GitHub 도구 통합 매개변수
매개변수 사용량 유형 Terraform 인수 설명
aPI_ROOT_URL 선택적, 갱신 가능 문자열 aPI_ROOT_URL API URL 루트의 GitHub 서버에 대한.
api_token 선택적, 갱신 가능 비밀번호 api_token 개인 액세스 토큰(PAT). 이 매개변수는 auth_type 가 pat 로 설정된 경우에만 필수이며, 그렇지 않으면 무시됩니다.
auth_type 선택적, 갱신 가능 문자열 auth_type Git 제공자에 액세스하는 데 사용할 인증 방법을 설정하십시오.
자동 초기화 선택적, 불변, Default: false 부울 자동 초기화 Readme 파일을 사용하여 이 저장소를 초기화하려면 이 값을 true 로 설정하십시오. 이 매개변수는 저장소를 작성하는 경우에만 사용됩니다.
연결 설정 해제 선택 사항, 업데이트 가능, Default: false 부울 연결 설정 해제 이 값을 true로 설정하면 공용 인터넷에서 서버를 주소 지정할 수 없습니다. IBM Cloud 은 사용자가 제공하는 연결 세부사항을 유효성 검증할 수 없습니다. git 서버에 대한 API 액세스가 필요한 특정 기능은 사용 안함으로 설정됩니다. 딜리버리 파이프라인은 git 서버에 대한 네트워크 액세스 권한이 있는 개인용 작업자만 사용하여 작동합니다.
기본 분기 선택적, 갱신 가능 문자열 기본 분기 Git 저장소의 기본 분기입니다.
enable_traceability 선택 사항, 업데이트 가능, Default: false 부울 enable_traceability 이 값을 true 로 설정하면 커밋, 풀 리퀘스트 및 참조된 이슈에 태그, 레이블 및 코멘트를 생성하여 코드 변경 사항의 배포 현황을 추적할 수 있습니다.
Git_ID 선택적, 불변 문자열 Git_ID github.com의 경우 이 값을 github 로 설정하거나 사용자 정의 GitHub Enterprise 서버의 GUID로 설정하십시오.
has_issues 선택 사항, 업데이트 가능, Default: true 부울 툴체인_문제_활성화됨 GitHub 저장소에서 문제를 사용으로 설정하고 도구 체인에 문제 도구 카드를 추가하려면 이 값을 true 로 설정하십시오. 도구 체인에서 도구 통합 카드를 제거하려면 값을 false 로 설정하십시오. 이 설정은 GitHub 저장소 자체에서 문제가 사용으로 설정되는지 여부에 영향을 주지 않습니다.
통합 소유자 선택적, 갱신 가능 문자열 통합 소유자 Git 조작이 수행되는 사용자를 선택하십시오.
owner_id 선택적, 불변 문자열 owner_id 저장소를 소유하는 GitHub 사용자 또는 조직입니다. 이 매개변수는 저장소를 작성하거나 저장소를 복제 또는 분기할 때 필요합니다. 이 값은 기존 저장소에 링크할 때 계산됩니다.
개인용 저장소 선택적, 불변, Default: false 부울 개인용 저장소 저장소를 작성하거나 복제하거나 포크할 때 저장소를 개인용으로 설정하려면 이 값을 true 로 설정하십시오. 이 매개변수는 기존 저장소에 링크할 때 사용되지 않습니다.
저장소 ID 선택적, 불변 문자열 저장소 ID GitHub 저장소의 ID입니다.
repo_name 선택적, 불변 문자열 repo_name 작성할 GitHub 저장소의 이름입니다. 이 매개변수는 저장소를 작성하거나 저장소를 복제 또는 분기할 때 필요합니다. 이 값은 기존 저장소에 링크할 때 계산됩니다.
repo_url 선택적, 불변 문자열 repo_url 이 도구 통합에 대한 URLGitHub 리포지토리의 이 매개변수는 기존 저장소에 링크할 때 필요합니다. 이 값은 저장소를 작성하거나 저장소를 복제 또는 분기할 때 계산됩니다.
루트 URL 선택적, 갱신 가능 문자열 루트 URL 서버의 URL 루트. 예: https://github.example.com
소스 저장소 URL 선택적, 불변 문자열 소스 저장소 URL 포크하거나 복제하려는 저장소의 URL 이 매개변수는 저장소를 분기 실행하거나 복제할 때 필요합니다. 저장소를 작성하거나 기존 저장소에 링크하는 경우에는 사용되지 않습니다.
제목 선택적, 갱신 가능 문자열 제목 서버의 제목입니다. 예: My GitHub Enterprise Server
토큰 URL 선택적, 갱신 가능 문자열 토큰 URL 서버와의 GitHub 인증에 사용되는 토큰 URL.
유형 필수, 불변 문자열 유형 새 도구 통합을 초기화하기 위해 수행할 조작입니다. new 를 사용하여 Git 저장소를 작성하거나, clone 기존 저장소를 새 Git 저장소에 복제하거나, fork 기존 Git 저장소를 분기하거나, link 를 사용하여 기존 Git 저장소에 링크하십시오.