Git deposundaki API varlıklarını Azure API Center'a eşitleme

Bu makalede, skills, agents ve MCP sunucuları gibi API varlıklarını API envanterinize otomatik olarak eşitlemek için git deposunu Azure API Center ile tümleştirme işlemi açıklanır. Git deposunu bağlayarak, her varlığı el ile kaydetmeden veya güncelleştirmeden API merkezi envanterinizi güncel tutabilirsiniz.

Git deposunu tümleştirdiğinizde:

  • API merkeziniz, depoyu varlık kaynağı olarak temsil eden bir ortam oluşturur.
  • API Center, depodaki varlık bilgilerini düzenli olarak API center envanterinize eşitler.

Prerequisites

  • Bir API merkezi. Henüz bir API merkeziniz yoksa API merkezi oluşturma hızlı başlangıcına bakın.

  • Eşitlemek istediğiniz varlıkları içeren bir Git deposu.

  • Genel olmayan depolar için, depoya erişmek için kişisel erişim belirteci (PAT). PAT,depo içeriğini okumak için uygun izinlere sahip olmalıdır. GitHub için PAT oluşturmak için bkz. Ayrıntılı kişisel erişim belirteci oluşturma.

  • Erişim için kullanılıyorsa PAT'yi depolamak için bir Azure anahtar kasası. Anahtar kasası oluşturmanız gerekiyorsa bkz. Quickstart: Azure portalını kullanarak anahtar kasası oluşturma. Anahtar kasasına gizli eklemek veya yönetmek için en azından Key Vault Gizli Yetkilisi rolüne veya eşdeğer izinlere sahip olmanız gerekir.

  • Azure CLI için:

    Note

    PowerShell'de veya bash kabuğunda bu makalede Azure CLI komut örneklerini çalıştırabilirsiniz. Farklı değişken söz dizimi nedeniyle gerektiğinde, iki kabuk için ayrı komut örnekleri sağlanır.

PAT'i Azure Key Vault'ta depolama

Git deponuz özelse, depoya erişim izni veren bir PAT'yi el ile karşıya yükleyin ve güvenli bir şekilde Azure Key Vault'a depolayın. Git deposunu API merkezinizle tümleştirdiğinizde, tümleştirmeyi bu gizli diziyi kullanacak şekilde yapılandırın.

Daha fazla bilgi için bkz . Hızlı Başlangıç: Azure portalını kullanarak Azure Key Vault'tan gizli dizi ayarlama ve alma.

PAT yapılandırmanız gerekmiyorsa Git deposunu tümleştirme bölümüne geçin.

API merkeziniz için yönetilen kimlik yapılandırma

API merkeziniz, Azure Key Vault'ta kimlik doğrulaması yapmak ve Git deposuna erişmek için gereken PAT'yi almak için yönetilen kimlik kullanır. Aşağıdaki yordamlar, API merkeziniz için yönetilen kimliği el ile yapılandırmayı ve Key Vault'a erişmek için gerekli izinleri atamayı açıklar.

Yönetilen kimliği yapılandırmazsanız, Git deposunu tümleştirdiğinizde API Center bunu sizin için otomatik olarak yapılandırabilir.

Bu senaryoda, API merkeziniz Azure kaynaklarına erişmek için yönetilen kimlik kullanır. Gereksinimlerinize bağlı olarak, sistem tarafından atanan veya kullanıcı tarafından atanan bir veya daha fazla yönetilen kimliği etkinleştirin.

Aşağıdaki örneklerde, Azure portalını veya Azure CLI'yı kullanarak sistem tarafından atanan yönetilen kimliğin nasıl etkinleştirileceği gösterilmektedir. Yüksek düzeyde yapılandırma adımları, kullanıcı tarafından atanan yönetilen kimlik için benzerdir.

  1. Portalda API merkezinize gidin.
  2. Kenar çubuğu menüsünde, Güvenlik'in altında Yönetilen kimlikler'i seçin.
  3. Sistem tarafından atanan'ı seçin ve durumu Açık şeklinde ayarlayın.
  4. Kaydetseçeneğini seçin.

Yönetilen kimliğe Key Vault Sırları Kullanıcı rolünü atayın.

Varlıkların içe aktarılmasına izin vermek için, API merkezinizin yönetilen kimliğine Azure anahtar kasanızdaki Key Vault Sırları Kullanıcısı rolünü verin. Portalı veya Azure CLI'yi kullanabilirsiniz.

  1. Portalda anahtar kasanıza gidin.
  2. Kenar çubuğu menüsünde Erişim denetimi (IAM) öğesini seçin.
  3. + Rol ataması ekle'yi seçin.
  4. Rol ataması ekle sayfasında, değerleri aşağıdaki gibi ayarlayın:
    1. Role sekmesinde Key Vault Gizli Kullanıcıları'nı seçin.
    2. Üyeler sekmesinde, Erişimi Ata - Yönetilen kimliği seçin>+ Üyeleri Seç.
    3. Yönetilen kimlikleri seçin sayfasında, önceki bölümde eklediğiniz API merkezinizin sistem tarafından atanan yönetilen kimliğini seçin. Seç'e tıklayın.
    4. Gözden geçir + ata'yı seçin.

Git deposunu tümleştirme

Git deposunu tümleştirmek için:

  1. Azure portalında API merkezinize gidin.

  2. Kenar çubuğu menüsünde Platform>Tümleştirmeleri'ni seçin.

  3. + Yeni tümleştirme'yi seçin ve Git deposundan seçin.

  4. Git deponuzu tümleştirin bölümünde aşağıdaki bilgileri girin:

    Alan Description
    Git deposu kaynağını yapılandırma
    Depo URL'si Varlık dosyalarını içeren Git deposunun URL'sini girin. İsteğe bağlı olarak, dal ve alt klasörü (örneğin, https://github.com/<org>/<repo>/tree/main/skills) belirtin.
    Git sağlayıcısı Sağlayıcıyı seçin (örneğin, GitHub).
    Varlık türü yapılandırması API Center, dosya deseni ile varsayılan **/skill.md varlık türünü yapılandırır.

    Eşitlenecek bir veya daha fazla varlık türü eklemek için + Varlık türü ekle'yi seçin.
    Kişisel erişim belirteci (PAT) Azure Key Vault'ta depolanan bir PAT'niz varsa, Key Vault sırrına göz atmak için Seç'i tıklayın.

    İsteğe bağlı olarak, anahtar kasası sırrına erişmek için yönetilen kimliği manuel yapılandırmadıysanız, yönetilen kimliği otomatik olarak yapılandır ve izinleri ata'yı seçin.
    Tümleştirme ayrıntıları Oluşturulan bağlantı tanımlayıcısını kabul edin veya tümleştirme bağlantısı için özel bir kimlik sağlayın.
    Ortam ayrıntıları
    Ortam başlığı Depo ortamı için kolay bir ad girin (örneğin, Git deposu).
    Kimlik Bir ortam kaynağı adı girin (örneğin, git-deposu).
    Ortam türü Ortam türünü seçin (örneğin, Üretim).
    Açıklama İsteğe bağlı olarak ortam için bir açıklama ekleyin.
    Varlık ayrıntıları
    Yaşam Döngüsü Depodan eşitlenen varlıklar için yaşam döngüsü aşamasını seçin (örneğin, Tasarım).

    Git deposunu portaldaki bir API merkezinde tümleştirme işleminin ekran görüntüsü.

  5. Oluştur'i seçin.

Portal, ortamı API merkezinize ekler. Portal, depodaki varlıkları Stok>Varlıkları sayfasındaki API merkezi envanterine ekler. Bağlantılı varlıkları listedeki bağlantı simgesiyle tanımlayabilirsiniz.

Portaldaki API merkezindeki bağlı varlıkların ekran görüntüsü.

İlgili içerik

  • Last updated on