azd uzantılarını kullanarak Azure MCP Sunucusu ile GitHub Copilot bulut aracısı bağlama

GitHub Copilot bulut aracısına yönetilen kimlikle güvenli ve kapsamlı Azure erişim vermek için Azure Geliştirici CLI (azd) uzantısını (azure.coding-agent) kullanın. Uzantı yönetilen kimliği oluşturur, federasyon kimlik bilgilerini yapılandırılır ve deponuzda GitHub Actions iş akışını ayarlar.

Uzantıların 'a nasıl özellik eklediğini öğrenmek için bkz. Uzantılara azdgenel bakış.

Önkoşullar

• Azure Geliştirici CLI'sini (azd) yükleyin. Yükleme yönergelerine bakın.
• Kaynak grupları ve yönetilen kimlikler oluşturmanıza olanak tanıyan Azure aboneliği.
• Copilot bulut aracısı için etkinleştirdiğiniz GitHub deposunun yerel kopyası.
• Depo izinleri:
  • GitHub ortamını güncelleştirin copilot .
  • Copilot bulut aracısı ayarlarını yapılandırın.
  • Değişiklikleri .github/workflows klasörüne aktarın.
• Depo için en az bir tane yapılandırılmış Git remote (federasyon kimlik bilgileri için gereklidir).

Copilot bulut aracısı uzantısını yükleme veya yükseltme

1. İlk kez yükleme

   azd extension install azure.coding-agent
   

   En son sürüme yükseltme

   azd extension upgrade azure.coding-agent
   

2. Yüklendiğini doğrulayın:

   azd extension list --installed
   

   Listede azure.coding-agent görmeniz gerekir.

Copilot bulut aracısı uzantısını kullanma

Copilot bulut aracısı uzantısı, Copilot bulut aracısı için yönetilen kimlik aracılığıyla Azure erişimi yapılandırmayı otomatikleştirir. Ayrıca kurulumu tamamlamak için birkaç el ile adım gerçekleştirmeniz gerekir.

Azure erişimini etkinleştirme

1. Yerel depo dizininizin kök dizininde aşağıdaki komutu çalıştırın:

   azd coding-agent config
   

2. Uzantı iş akışını tamamlamak için ekrandaki istemleri izleyin.

   Yapılandırma sırasında uzantı:

   • Bir kaynak grubu oluşturur (veya yeniden kullanılır).
   • Azure yönetilen kimliği oluşturur.
   • Okuyucu rolünü kaynak grubu kapsamındaki bu kimliğe atar.
   • GitHub deposunu yönetilen kimliğe bağlayan federasyon kimlik bilgileri oluşturur.
   • İş copilot-setup-steps.yml akışını ve ilgili varlıkları ekler (veya güncelleştirir).
   • GitHub ortam ayarlarını copilot ortamı için tamamlamanız konusunda size yol gösterir.

Kurulumu doğrulama (isteğe bağlı)

1. Oluşturulan (veya güncelleştirilmiş) kaynak grubundaki yönetilen kimliği listeleyin:

   az identity list --resource-group <resource-group-name>
   

2. GitHub'da Ayarlar>Ortamları>copilot ortamını açın ve yönetilen kimliğe başvuran federasyon kimlik bilgisi girişini onaylayın (kimlik bilgisi veren, GitHub'ı yansıtmalıdır).

Copilot bulut aracısı için Azure MCP Sunucusu yapılandırma

1. Uzantı, azd coding-agent konumundaki origin/azd-enable-copilot-coding-agent-with-azureyeni GitHub iş akışı dosyasıyla bir dal için çekme isteği oluşturur. Dalınızda main Azure MCP Server bağlantısını kullanmak istiyorsanız, bu çekme isteğini onaylayıp birleştirin.

   Hem çekme isteği açıklaması hem de konsoldaki uzantı çıktı günlükleri, Copilot bulut aracısı için Azure MCP Sunucusu’nu yapılandırmada kullanabileceğiniz bir JSON yapılandırma kod parçacığı içerir:

   {
       "mcpServers": {
           "Azure": {
               "type": "local",
               "command": "npx",
               "args": [
                   "-y",
                   "@azure/mcp@latest",
                   "server",
                   "start"
               ],
               "tools": [
                   "*"
               ]
           }
       }
   }
   

2. Azure MCP Sunucusunu yapılandırmak için deponuzun Ayarlar sayfasına gidin.

3. Sol gezinti bölmesinden Copilot>Cloud aracısını seçin.

4. Pull request'ten JSON parçacığını MCP yapılandırma kutusuna yapıştırın ve MCP yapılandırmasını kaydet seçeneğini seçin.

   

Copilot bulut aracısı uzantısını test edin

1. GitHub'daki deponuza gidin.

2. Sağ üst gezinti çubuğunda Aracıları aç panelleri simgesini seçin.

3. Açılır panelde, azd komutunda kullandığınız depoyu ve dalı seçin. Oluşturulan çekme talebi main ile birleştirildiyse, main öğesini seçin.

4. Copilot bulut aracısına yapılandırdığınız Azure MCP Sunucusunu kullanmasını özel olarak belirten bir istem girin, örneğin:

   Use the Azure MCP Server to list the resource groups in my subscription.
   Do not traverse or analyze the repository at all. Use only the Azure MCP Server.
   

   İstemi çalıştırmak ve Copilot bulut aracısına yeni bir görev oluşturup çalıştırmasını bildirmek için Enter tuşuna basın.

   Uyarı

   Ayrıca, açılır panelde main dışındaki bir dalı seçerek Copilot bulut aracısı görevlerini bu dalda çalıştırabilirsiniz.

5. Görev ayrıntıları sayfasına gitmek için panelin en altında görünen görevi seçin.

   

6. Copilot bulut aracısını görmek için çıkışı tarayın:

   • Azure MCP Sunucusunu başlatın:

     

   • Azure kaynaklarınız hakkında bilgi toplamak için çeşitli araçları arayın:

     

   • Kaynak grubunu son çıktıda görüntüleyin:

     

Yönetilen kimlik üzerindeki izinleri yapılandırma

Uzantı, azd coding-agent Azure MCP Sunucusunun kaynaklarınıza erişmek için kullandığı bir Azure yönetilen kimliği oluşturur. Bu kurulum, Azure MCP Sunucusu'nun özelliklerini ve izinlerini denetlemek için yönetilen kimliğe farklı roller atamanızı sağlar.

Varsayılan olarak uzantı, kaynak grubu kapsamına Reader yalnızca rolü atar. Ek roller atayın veya aracının daha fazla özelliğe ihtiyacı varsa kapsamı genişletin. Bkz. yerleşik roller.

Örneğin, Contributor rolünü kaynak grubu kapsamında atamak için:

az role assignment create --assignee <principal-id-or-client-id> --role Contributor --scope /subscriptions/<subscription-id>/resourceGroups/<resource-group-name>

Sorun giderme

Aşağıdaki bölümlerde karşılaşabileceğiniz yaygın sorunlar vurgulanmıştır.

Yapılandırılmış git uzaktan kumandası yok

Federasyon kimlik bilgilerinin oluşturulabilmesi için uzak bir bağlantı ekleyin.

git remote add origin <https://github.com/<your-org>/<your-repo>.git>
git fetch origin

Depo için yönetici haklarına sahip olmalıdır

Copilot bulut aracısı için bir GitHub deposu yapılandırmak için yönetici hakları gerekir. Bu haklar olmadan, yönetilen kimlik kimlik bilgilerini kullanmak için Copilot ortamını güncelleştiremez veya depo için MCP yapılandırmasını güncelleştiremezsiniz.

Bu hatayı görürseniz yetkilerinizi artırmanız gerekir.

(!) An error occurred, see the readme for troubleshooting and prerequisites:
    https://github.com/Azure/azure-dev/blob/main/cli/azd/extensions/azure.coding-agent/README.md
Error: failed to create GitHub environment copilot in repository owner/repository: exit code: 1, stdout: {"message":"Must have admin rights to Repository.","documentation_url":"https://docs.github.com/rest/deployments/environments#create-or-update-an-environment","status":"403"}, stderr: gh: Must have admin rights to Repository. (HTTP 403)

Yenileme belirtecinin süresi doldu

Yeniden oturum açın:

azd auth login

--tenant-id <tenant-id> veya --use-device-code gibi bayrakları gerektiğinde ekleyin.

Tanılama çıkışını geliştirme

Hata ayıklama modunu kullan:

azd coding-agent config --debug

Tüm iç komutlar ve bunların çıktısı konsola yazdırılır.

Sonraki Adımlar

• Gerektiğinde yalnızca rol atamalarını kullanarak kimlik izinlerini genişletin
• İş akışını genişleterek ek otomasyonu tümleştirme .github/workflows/
• Diğer uzantı özelliklerini keşfedin: Uzantılara genel bakış
• Azure RBAC kavramlarını gözden geçirme

Contributing

Azure Geliştirici CLI kaynaklarına katkıda bulunmak için katkıda bulunma kılavuzuna bakın. Pull isteği için Contributor License Agreement imzalanması gerekebilir.

Kullanım kuralları

Bu proje , Microsoft Açık Kaynak Kullanım Kuralları'nı izler.