Git 리포지토리에서 Azure API 센터로 API 자산 동기화

이 문서에서는 Git 리포지토리를 Azure API Center와 통합하여 skills, agents 및 MCP servers와 같은 API 자산을 API 인벤토리에 자동으로 동기화하는 방법을 설명합니다. Git 리포지토리를 연결하면 각 자산을 수동으로 등록하거나 업데이트하지 않고도 API 센터 인벤토리를 최신 상태로 유지할 수 있습니다.

Git 리포지토리를 통합하는 경우:

• API 센터는 리포지토리를 자산의 원본으로 나타내는 환경을 만듭니다.
• API 센터는 정기적으로 리포지토리의 자산 정보를 API 센터 인벤토리로 동기화합니다.

사전 요구 사항

• API 센터입니다. 아직 API 센터가 없는 경우 API 센터 만들기에 대한 빠른 시작을 참조하세요.

• 동기화하려는 자산이 포함된 Git 리포지토리입니다.

• 공용이 아닌 리포지토리의 경우 리포지토리에 액세스하기 위한 PAT(개인용 액세스 토큰)입니다. PAT에는 리포지토리 콘텐츠를 읽을 수 있는 적절한 권한이 있어야 합니다. GitHub에 대한 PAT를 만들려면 세분화된 개인용 액세스 토큰 만들기를 참조하세요.

• 액세스에 사용할 경우 PAT를 저장할 Azure 키 자격 증명 보관소입니다. 키 자격 증명 모음을 만들어야 하는 경우 Quickstart: Azure Portal 사용하여 키 자격 증명 모음 만들기를 참조하세요. 키 자격 증명 모음에서 비밀을 추가하거나 관리하려면 적어도 Key Vault 비밀 책임자 역할 또는 동등한 권한이 필요합니다.

• Azure CLI를 사용할 때:

  • Bash 환경을 Azure Cloud Shell에서 사용합니다. 자세한 내용은 Azure Cloud Shell을 시작하는 방법을 참조하세요.

    

  • CLI 참조 명령을 로컬에서 실행하려면 Azure CLI를 설치하십시오. Windows 또는 macOS에서 실행 중인 경우 Docker 컨테이너에서 Azure CLI를 실행하는 것이 좋습니다. 자세한 내용은 Docker 컨테이너에서 Azure CLI를 실행하는 방법을 참조하세요.

    • 로컬 설치를 사용하는 경우 az login 명령을 사용하여 Azure CLI에 로그인합니다. 인증 프로세스를 완료하려면 터미널에 표시되는 단계를 수행합니다. 다른 로그인 옵션은 Azure CLI를 사용하여 Azure에 인증을 참조하세요.

    • 메시지가 표시되면 처음 사용할 때 Azure CLI 확장을 설치합니다. 확장에 대한 자세한 내용은 Azure CLI로 확장 사용 및 관리를 참조하세요.

    • az version을 실행하여 설치된 버전과 관련 종속 라이브러리를 확인합니다. 최신 버전으로 업그레이드하려면 az upgrade를 실행합니다.

  메모

  PowerShell 또는 bash 셸에서 이 문서의 Azure CLI 명령 예제를 실행할 수 있습니다. 변수 구문이 다르기 때문에 필요한 경우 두 셸에 대해 별도의 명령 예가 제공됩니다.

Azure Key Vault에 PAT 저장

Git 리포지토리가 프라이빗인 경우 리포지토리에 대한 액세스 권한을 부여하는 PAT를 Azure Key Vault에 수동으로 업로드하고 안전하게 저장합니다. Git 리포지토리를 API 센터와 통합하는 경우 이 비밀을 사용하도록 통합을 구성합니다.

자세한 내용은 빠른 시작: Azure Portal을 사용하여 Azure Key Vault에서 비밀 설정 및 검색을 참조하세요.

PAT를 구성할 필요가 없는 경우 Git 리포지토리 통합을 계속 진행합니다.

API 센터에 대한 관리 ID 구성

API 센터는 관리 ID를 사용하여 Azure Key Vault에 인증하고 Git 리포지토리에 액세스하는 데 필요한 PAT를 검색합니다. 다음 절차에서는 API 센터에 대한 관리 ID를 수동으로 구성하고 Key Vault에 액세스하는 데 필요한 권한을 할당하는 방법을 설명합니다.

관리 ID를 구성하지 않으면 API 센터에서 Git 리포지토리를 통합할 때 자동으로 구성할 수 있습니다.

이 시나리오의 경우 API 센터는 관리 ID를 사용하여 Azure 리소스에 액세스합니다. 필요에 따라 시스템 할당 또는 하나 이상의 사용자 할당 관리 ID를 사용하도록 설정합니다.

다음 예제에서는 Azure Portal 또는 Azure CLI를 사용하여 시스템 할당 관리 ID를 사용하도록 설정하는 방법을 보여 줍니다. 높은 수준에서 구성 단계는 사용자 할당 관리 ID와 유사합니다.

az apic update --name <api-center-name> --resource-group <resource-group-name> --identity '{"type": "SystemAssigned"}'

관리 ID에 Key Vault 비밀 사용자 역할 할당

자산 가져오기를 허용하려면 API 센터의 관리 ID에 Azure Key Vault의 Key Vault 비밀 사용자 역할을 할당합니다. 포털 또는 Azure CLI를 사용할 수 있습니다.

Git 리포지토리 통합

Git 리포지토리를 통합하려면 다음을 수행합니다.

1. Azure Portal에서 API 센터로 이동합니다.

2. 사이드바 메뉴에서 플랫폼통합> 선택합니다.

3. + 새 통합을 선택하고 Git 리포지토리에서 선택합니다.

4. Git 리포지토리 통합에서 다음 정보를 입력합니다.

   Field	설명
   Git 리포지토리 원본 구성
   리포지토리 URL	자산 파일이 포함된 Git 리포지토리의 URL을 입력합니다. 필요에 따라 분기 및 하위 폴더(예: https://github.com/<org>/<repo>/tree/main/skills)를 지정합니다.
   Git 공급자	공급자(예: GitHub)를 선택합니다.
   자산 유형 구성	API Center는 파일 패턴을 사용하여 기본 **/skill.md 자산 형식을 구성합니다. 동기화할 하나 이상의 자산 유형을 추가하려면 + 자산 유형 추가를 선택합니다.
   PAT(개인용 액세스 토큰)	PAT가 Azure Key Vault에 저장된 경우 [선택 ]을 클릭하여 Key Vault 비밀을 찾습니다. 직접 관리형 ID를 구성하여 키 자격 증명 비밀에 액세스하지 않은 경우, 선택적으로 관리형 ID 자동 구성 및 권한 할당을 선택하세요.
   통합 세부 정보	생성된 링크 식별자를 수락하거나 통합 링크에 대한 사용자 지정 ID를 제공합니다.
   환경 세부 정보
   환경 제목	리포지토리 환경의 이름(예: Git 리포지토리)을 입력합니다.
   신원 확인	환경 리소스 이름(예: git-repository)을 입력합니다.
   환경 유형	환경 유형(예: 프로덕션)을 선택합니다.
   설명	필요에 따라 환경에 대한 설명을 추가합니다.
   자산 세부 정보
   수명 주기	리포지토리에서 동기화된 자산의 수명 주기 단계(예: 디자인)를 선택합니다.

   

5. 선택하고생성합니다.

포털은 API 센터에 환경을 추가합니다. 포털은 리포지토리의 자산을 인벤토리자산 페이지의 API 센터 인벤토리 > 에 추가합니다. 목록의 링크 아이콘을 사용하여 연결된 자산을 식별할 수 있습니다.

관련 콘텐츠

• API 인벤토리에서 기술 등록 및 검색
• Azure API Center의 주요 개념