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

geliştirme ortamınızı Microsoft Foundry SDK'sını kullanacak şekilde ayarlayın. Ayrıca kodunuzun kullanıcı kimlik bilgilerinize erişebilmesi için kimlik doğrulaması için Azure CLI gerekir.

Bu makalede, dil çalışma zamanlarını, Azure CLI, Azure Developer CLI, Foundry VS Code uzantısını ve Git'i yüklersiniz.

Önemli

Bu makale yalnızca dil çalışma zamanları, genel araçlar, VS Code ve uzantı kurulumu gibi genel önkoşulları kapsar.
SDK yüklemesi veya kimlik doğrulaması gibi senaryoya özgü adımları kapsamaz.
Ortamınız hazır olduğunda, bu yönergeler için 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 veya seçtiğiniz IDE'yi indirin, yükleyin ve yapılandırın. Daha fazla bilgi için bkz. İndir Visual Studio Code.

  • Foundry kaynaklarını oluşturmak ve yönetmek için aşağıdaki Azure RBAC rollerinden biri

    • Azure AI Project Yöneticisi (Dökümhane projelerini yönetmek için)
    • Sahip (abonelik düzeyindeki izinler için). Foundry'deki diğer senaryolar için gereken ek rol atamaları için Owner rolü gereklidir. Foundry'deki tüm senaryolar için engellenmenizin kaldırılmasını sağlamak üzere gerekli olan rol ataması 'Sahip'tir.

  • Projeyi kullanmak ama yeni kaynaklar oluşturmamak için en azından şunlara ihtiyacınız vardır:

    • Kullandığınız projelerde Azure AI Kullanıcısı (geliştirme için en düşük ayrıcalıklı rol)

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

Programlama dilinizi yükleme

Visual Studio Code'da projeniz için yeni bir klasör oluşturun. Bu klasörde bir terminal penceresi açın.

İlk olarak yeni bir Python ortamı oluşturun. Paketleri genel Python yüklemenize yüklemeyin. Python paketleri yüklerken her zaman bir sanal veya conda ortamı kullanın. Aksi takdirde, Python genel yüklemenizi bozabilirsiniz.

Gerekirse Python yükleyin

Python 3.10 veya üzerini kullanın, ancak en az Python 3.9 gereklidir. Python'in uygun bir sürümü yüklü değilse, işletim sisteminize Python yüklemenin en kolay yolu için VS Code Python Öğreticisi yönergeleri izleyin.

Sanal ortam oluşturma

Zaten Python 3.10 veya üzeri yüklüyse, aşağıdaki komutları kullanarak bir sanal ortam oluşturun:

py -3 -m venv .venv
.venv\scripts\activate

Python ortamını etkinleştirdiğinizde, komut satırından python veya pip çalıştırmak, uygulamanızın .venv klasöründeki Python yorumlayıcısını kullanır.

Not

Python sanal ortamından çıkmak için deactivate komutunu kullanın. Daha sonra gerektiğinde yeniden etkinleştirebilirsiniz.

Visual Studio Code için Python uzantısını yükleme

Visual Studio Code için Python uzantısı IntelliSense, hata ayıklama, biçimlendirme, lint, kod gezintisi, yeniden düzenleme, değişken gezgini, test gezgini ve ortam yönetimi ile Python destekler.

Visual Studio Code için Python Uzantısını yükleyin.

Yüklemek:

  • Java Geliştirme Seti (JDK) 17 veya üzeri

Java için Visual Studio Code Uzantı Paketi'ni yükleme

Java için Uzantı Paketi, Visual Studio Code'da Java uygulamaları yazmanıza, test edip hatalarını ayıklamanıza yardımcı olabilecek popüler uzantılardan oluşan bir koleksiyondur.

Java için Visual Studio Code Uzantı Paketi'ni yükleyin.

Node.js yükleyin (sürüm 20 veya üzeri önerilir).

.NET geliştirme için gerekli araçların yüklü olduğundan emin olun.

.NET SDK'sını yükleme

.NET uygulamaları oluşturmak, oluşturmak ve çalıştırmak için .NET SDK'sına (Yazılım Geliştirme Seti) ihtiyacınız vardır. Projeniz için gerekliyse en son LTS (Uzun Vadeli Destek) sürümünü veya sonraki bir sürümü yüklemenizi öneririz.

  1. resmi .NET indirme sayfasından .NET SDK'sını indirin. İşletim sisteminiz (Windows, Linux veya macOS) için uygun yükleyiciyi seçin.

  2. İşletim sisteminiz için yükleme yönergelerini izleyin.

  3. Bir terminal veya komut istemi açıp çalıştırarak yüklemeyi doğrulayın:

    dotnet --version

    Yanıt yüklü SDK sürümü olmalıdır.

Visual Studio Code için C# Dev Kit'i yükleme

VS Code'daki en iyi C# geliştirme deneyimi için resmi C# Dev Kit uzantısını yükleyin:

  1. Visual Studio Code açın.
  2. Uzantılar görünümüne gidin (Ctrl+Shift+X veya Cmd+Shift+X).
  3. C# Dev Kit'i arayın.
  4. Microsoft tarafından yayımlanan uzantıyı yükleyin. Bu, henüz sahip değilseniz temel C# uzantısını da yükler.

Yeni bir .NET Project oluşturma

Visual Studio Code ile tümleşik terminali (Terminal > Yeni Terminal) kullanarak yeni bir .NET projesi oluşturabilirsiniz.

Örneğin, yeni bir konsol uygulaması oluşturmak için:

# Navigate to the directory where you want to create your project
# cd path/to/your/projects

# Create a new console application in a subfolder named MyConsoleApp
dotnet new console -o MyConsoleApp

# Navigate into the newly created project folder
cd MyConsoleApp

Artık C# projenizde çalışmaya başlamak için bu MyConsoleApp klasörü VS Code'da (Dosya > Klasör Aç...) açabilirsiniz. C# Dev Kit uzantısıyla VS Code projeyi otomatik olarak algılar ve IntelliSense, hata ayıklama ve derleme görevleri gibi özellikleri etkinleştirir.

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.

Azure Geliştirici CLI'sını yükleme

Azure Geliştirici CLI'sı (azd), Azure uygulama kaynaklarını ayarlamanıza ve dağıtmanıza yardımcı olan açık kaynak bir araçtır. İster terminal, IDE ister CI/CD işlem hatları kullanın, geliştirmenin temel aşamaları için basit komutlar sağlar. Platformunuz için Azure Geliştirici CLI'sini yükleyin.

Yapay zeka çözümü şablonlarının çoğu, kullanan azdbir dağıtım seçeneği içerir.

Foundry VS Code uzantısını yükleme

Visual Studio Code için Foundry uzantısı modelleri dağıtmanıza, yapay zeka uygulamaları oluşturmanıza ve doğrudan VS Code arabiriminden Aracılarla çalışmanıza olanak tanır. Foundry VS Code uzantısını yükleyin.

Git'i yükleme

Foundry SDK örneklerini kopyalamak için Git gereklidir. Git yüklü değilse , platformunuzun yönergelerini izleyin ve işletim sisteminizi seçin.

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 VS Code'ı yeniden başlatın.
az login tarayıcı hatasıyla başarısız oluyor Bunun yerine bir cihaz kodu akışı kullanarak kimlik doğrulaması yapmak için komutunu çalıştırın az login --use-device-code .
Python bulunamadı macOS/Linux'te python yerine python3 kullanın veya desteklenen bir sürüm (3.9 veya üzeri) yükleyin.
Yükleme sırasında izin reddedildi macOS/Linux'ta kullanmaktan kaçının sudo pip install. Bunun yerine bir sanal ortam kullanın.

İlgili içerik

  • Last updated on