Geliştirme ortamınızı hazırlama

Microsoft Foundry kullanarak derleme yapmak için geliştirme ortamınızı hazırlayın. Desteklenen bir programlama diline, kimlik doğrulaması, Git ve Foundry geliştirici araçları için Azure CLI ihtiyacınız vardır.

İpucu

Foundry DevPack, geliştirici araçlarını tek bir komutla yüklemenin önerilen yoludur. Ayrıca her aracı ayrı olarak da yükleyebilirsiniz.

Önemli

Bu makalede genel önkoşullar, genel araçlar ve Visual Studio Code kurulumu yer alır. Senaryoya özgü SDK paketlerini veya kimlik doğrulama kodunu kapsamaz. Ortamınız hazır olduğunda hızlı başlangıca geçin.

Önkoşullar

  • Etkin aboneliği olan bir Azure hesabı. Hesabınız yoksa ücretsiz deneme aboneliği içeren bir free Azure hesabı oluşturun.

  • Visual Studio Code indirin, yükleyin ve yapılandırın veya seçtiğiniz IDE'yi kullanın.

  • Foundry kaynaklarını oluşturmak ve yönetmek için şu Azure RBAC rollerinden birini kullanın:

    • Foundry projelerini yönetmek için Foundry Proje Yöneticisi.

    Önemli

    Foundry RBAC rolleri yakın zamanda yeniden adlandırıldı. Foundry User, Foundry Owner, Foundry Hesabı Sahibi ve Foundry Project Manager daha önce Azure Yapay Zeka Kullanıcısı, Azure Yapay Zeka Sahibi, Azure Yapay Zeka Hesabı Sahibi ve Azure Yapay Zeka Project Yöneticisi olarak adlandırıldı. Yeniden adlandırma kullanıma sunulmaya devam ederken bazı yerlerde önceki adları görmeye devam edebilirsiniz. Rol kimlikleri ve temel izinler yeniden adlandırma ile değiştirilmez.

    • Bazı senaryolar için gereken abonelik düzeyi izinlerinin ve rol atamalarının sahibi.

  • Mevcut bir projeyi kaynak oluşturmadan kullanmak için, projede en az Foundry Kullanıcısı gerekir.

Her rol hakkında ayrıntılı bilgi için bkz. Microsoft Foundry için rol tabanlı erişim denetimi.

Foundry DevPack'i yükleme

Foundry DevPack düzenleyiciniz, terminaliniz ve kodlama aracınız için Foundry geliştirici araçlarını yükler. İşletim sisteminiz için komutunu çalıştırın.

Windows

winget install Microsoft.FoundryDevPack

macOS

brew install --cask microsoft/foundry/devpack && foundry-devpack install

Linux

curl -fsSL https://aka.ms/foundry-devpack-install.sh | bash

DevPack şu araçları yükler:

Aracı Ne yapabilirsiniz?
Visual Studio Code için Microsoft Döküm Araç Seti Visual Studio Code’dan derleyin, test edin, değerlendirin ve dağıtın.
azd ve azd ai Terminal üzerinden iskelet oluşturun, dağıtın, değerlendirin ve otomatikleştirin.
Foundry Canvas (önizleme) Rehberli bir Copilot kanvasıyla barındırılan aracıları tasarlayıp dağıtın.
Microsoft Dökümhane Becerisi Dökümhane iş akışları için kodlama aracılarına yeniden kullanılabilir yönergeler verin.

Programlama dilinizi ayarlamak, Azure CLI ile oturum açmak ve Git'i yüklemek için aşağıdaki bölümlerle devam edin.

Programlama diliyle çalışma

Uygulamanızın gerektirdiği dili kullanın. Çalışma zamanını veya Visual Studio Code uzantısını yüklemeniz gerekiyorsa ilgili bölümü genişletin.

Piton

Python 3.10 veya üzerini yükleyin. Python 3.9 desteklenen en düşük sürümdür. Paketleri genel olarak yüklemek yerine projeniz için bir sanal ortam oluşturun.

Windows

py -3 -m venv .venv
.\.venv\Scripts\Activate.ps1

macOS ve Linux

python3 -m venv .venv
source .venv/bin/activate

Düzenleyici desteği için Visual Studio Code için Python uzantısını yükleyin.

Java

JDK 17 veya üzerini yükleyin. Microsoft Build OpenJDK ücretsiz bir Uzun Süreli Destek dağıtımıdır. Düzenleyici desteği için Java için Visual Studio Code Uzantı Paketi'ni yükleyin.

JavaScript/TypeScript

Node.js’yi yükleyin. Sürüm 20 veya üzeri önerilir.

C#

.NET SDK'sının en son Long-Term Destek sürümünü yükleyin. Düzenleyici desteği için Visual Studio Code için C# Dev Kit'i yükleyin.

Azure CLI yükleme ve oturum açma

Azure CLI yükler ve kodunuzun Foundry aracılığıyla Azure hizmetleri çağırmak için kullanıcı kimlik bilgilerinizi kullanabilmesi için yerel geliştirme ortamınızdan oturum açarsınız.

Çoğu durumda, aşağıdaki komutu kullanarak terminalinizden Azure CLI yükleyebilirsiniz:

winget install -e --id Microsoft.AzureCLI

> bu komutlar belirli bir işletim sisteminiz veya kurulumunuz için çalışmıyorsa Azure CLI

Azure CLI yükledikten sonra az login komutunu kullanarak oturum açın ve tarayıcıyı kullanarak oturum açın:

az login

Alternatif olarak, tarayıcı üzerinden bir cihaz koduyla el ile oturum açabilirsiniz.

az login --use-device-code

Oturum açtıktan sonra betikleri çalıştırmak için bu terminali açık tutun.

Git'i yükleme

Foundry SDK örneklerini kopyalamak için Git'e ihtiyacınız vardır. Git yüklü değilse Git web sitesinden indirip yükleyin.

Geliştirici araçlarını tek tek yükleme

Foundry DevPack kullanmıyorsanız her geliştirici aracını ayrı olarak yükleyin:

  1. Azure Geliştirici CLI'sını yükleyin.
  2. azd için tüm Foundry uzantılarını yükleyin: 
    azd ext install microsoft.foundry
    Bunun yerine tek tek uzantıları yüklemek için bkz. Azure Developer CLI Foundry uzantılarını yükleme.
  3. Düzenleyici ve kodlama aracısı araçlarını yükleyin:

Birçok yapay zeka çözümü şablonu ile azddağıtımı destekler.

Sorun giderme

Sorunu Çözünürlük
Yüklemeden sonra komut bulunamadı PATH değişikliklerinin etkili olması için terminalinizi kapatıp yeniden açın veya Visual Studio Code yeniden başlatın.
az login tarayıcı hatasıyla başarısız oluyor Bir cihaz koduyla kimlik doğrulaması yapmak için komutunu çalıştırın az login --use-device-code .
Python bulunamadı macOS veya Linux yerine python kullanın python3 ya da Python 3.9 veya üzerini yükleyin.
Python paketi yüklemesi sırasında izin reddedildi macOS veya Linux'ta kullanmayın sudo pip install. Bunun yerine bir sanal ortam kullanın.

İlgili içerik

  • Last updated on