Bagikan melalui

Mempersiapkan lingkungan pengembangan Anda

Siapkan lingkungan pengembangan Anda untuk menggunakan Microsoft Foundry SDK. Anda juga memerlukan Azure CLI untuk autentikasi sehingga kode Anda dapat mengakses kredensial pengguna Anda.

Dalam artikel ini, Anda menginstal runtime bahasa pemrograman, Azure CLI, Azure Developer CLI, ekstensi Foundry VS Code, dan Git.

Penting

Artikel ini hanya membahas prasyarat umum , seperti runtime bahasa, alat global, dan Visual Studio Code dan penyiapan ekstensi.
Ini tidak mencakup langkah-langkah khusus skenario seperti penginstalan atau autentikasi SDK.
Saat lingkungan Anda siap, lanjutkan ke panduan cepat untuk instruksi lebih lanjut.

Prasyarat

  • Akun Azure dengan langganan aktif. Jika Anda tidak memilikinya, buat akun Azure free, yang menyertakan langganan uji coba gratis.

  • Unduh, instal, dan konfigurasikan Visual Studio Code, atau IDE pilihan Anda. Untuk informasi selengkapnya, lihat Unduh Visual Studio Code.

  • Untuk membuat dan mengelola sumber daya Foundry, diperlukan salah satu dari peran RBAC Azure berikut.

    • Azure Manajer Project AI (untuk mengelola proyek Foundry)
    • Pemilik (untuk izin tingkat langganan). Pemilik diperlukan untuk penugasan peran tambahan yang dibutuhkan untuk skenario-skenario lainnya di Foundry. Untuk memastikan Anda tidak diblokir untuk semua skenario di Foundry, menetapkan Peran Pemilik adalah yang diperlukan.

  • Untuk menggunakan project tetapi tidak membuat sumber daya baru, Anda memerlukan setidaknya:

    • Azure AI User pada proyek yang Anda gunakan (peran paling sedikit hak istimewa untuk pengembangan)

    Untuk detail tentang izin setiap peran, lihat kontrol akses berbasis Role untuk Microsoft Foundry.

Menginstal bahasa pemrograman Anda

Di Visual Studio Code, buat folder baru untuk proyek Anda. Buka jendela terminal di folder tersebut.

Pertama, buat lingkungan Python baru. Jangan menginstal paket ke dalam penginstalan Python global Anda. Selalu gunakan lingkungan virtual atau conda saat menginstal paket Python. Jika tidak, Anda dapat memutuskan penginstalan global Python Anda.

Jika diperlukan, instal Python

Gunakan Python 3.10 atau yang lebih baru, tetapi setidaknya diperlukan Python 3.9. Jika Anda tidak memiliki versi Python yang sesuai yang terinstal, ikuti instruksi dalam Tutorial Python Kode VS untuk cara paling mudah menginstal Python pada sistem operasi Anda.

Membuat lingkungan virtual

Jika Anda sudah menginstal Python 3.10 atau lebih tinggi, buat lingkungan virtual dengan menggunakan perintah berikut:

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

Saat Anda mengaktifkan lingkungan Python, menjalankan python atau pip dari baris perintah menggunakan penerjemah Python di folder .venv aplikasi Anda.

Nota

Gunakan perintah deactivate untuk keluar dari lingkungan virtual Python. Anda dapat mengaktifkannya kembali nanti saat diperlukan.

Instal ekstensi Python untuk Visual Studio Code

Ekstensi Python untuk Visual Studio Code mendukung Python dengan IntelliSense, penelusuran kesalahan, pemformatan, linting, navigasi kode, pemfaktoran ulang, penjelajah variabel, penjelajah pengujian, dan manajemen lingkungan.

Instal Ekstensi Python untuk Visual Studio Code.

Pasang:

  • Java Development Kit (JDK) 17 atau yang lebih baru

Instal Paket Ekstensi Visual Studio Code untuk Java

Paket Ekstensi untuk Java adalah kumpulan ekstensi populer yang dapat membantu Anda menulis, menguji, dan men-debug aplikasi Java di Visual Studio Code.

Instal Paket Ekstensi Visual Studio Code untuk Java.

Instal Node.js (versi 20 atau yang lebih baru disarankan).

Pastikan Anda memiliki alat yang diperlukan yang terinstal untuk pengembangan .NET.

Menginstal SDK .NET

Anda memerlukan SDK .NET (Software Development Kit) untuk membuat, membangun, dan menjalankan aplikasi .NET. Sebaiknya instal versi LTS (Dukungan Jangka Panjang) terbaru atau versi yang lebih baru jika diperlukan oleh project Anda.

  1. Unduh SDK .NET dari halaman unduhan .NET official. Pilih alat penginstal yang sesuai untuk sistem operasi Anda (Windows, Linux, atau macOS).

  2. Ikuti instruksi penginstalan untuk sistem operasi Anda.

  3. Pastikan penginstalan dengan membuka terminal atau prompt perintah dan menjalankan:

    dotnet --version

    Respons harus berupa versi SDK yang diinstal.

Pasang C# Dev Kit untuk Visual Studio Code

Untuk pengalaman pengembangan C# terbaik di VISUAL Code, instal ekstensi C# Dev Kit resmi:

  1. Buka Visual Studio Code.
  2. Buka tampilan Ekstensi (Ctrl+Shift+X atau Cmd+Shift+X).
  3. Cari C# Dev Kit.
  4. Instal ekstensi yang diterbitkan oleh Microsoft. Ini juga akan menginstal ekstensi C# dasar jika Anda belum memilikinya.

Membuat .NET Project baru

Anda dapat membuat proyek .NET baru menggunakan terminal yang terintegrasi ke dalam Visual Studio Code (Terminal > Terminal Baru).

Misalnya, untuk membuat aplikasi konsol baru:

# 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

Anda sekarang dapat membuka folder MyConsoleApp ini di Visual Studio Code (File > Buka Folder...) untuk mulai mengerjakan project C# Anda. VS Code, dengan ekstensi C# Dev Kit, akan secara otomatis mendeteksi project, mengaktifkan fitur seperti IntelliSense, penelusuran kesalahan, dan tugas build.

Instal Azure CLI dan masuk

Anda menginstal Azure CLI dan masuk dari lingkungan pengembangan lokal Anda sehingga kode Anda dapat menggunakan kredensial pengguna Anda untuk memanggil layanan Azure melalui Foundry.

Dalam kebanyakan kasus, Anda dapat menginstal Azure CLI dari terminal Anda menggunakan perintah berikut:

winget install -e --id Microsoft.AzureCLI

Anda dapat mengikuti instruksi Cara menginstal Azure CLI jika perintah ini tidak berfungsi untuk sistem operasi atau penyiapan tertentu Anda.

Setelah Anda menginstal Azure CLI, masuk menggunakan perintah az login dan masuk menggunakan browser:

az login

Atau, Anda dapat masuk secara manual melalui browser dengan kode perangkat.

az login --use-device-code

Biarkan terminal ini tetap terbuka untuk menjalankan skrip setelah masuk.

Menginstal CLI Pengembang Azure

Azure Developer CLI (azd) adalah alat sumber terbuka yang membantu Anda menyiapkan dan menyebarkan sumber daya aplikasi di Azure. Ini menyediakan perintah sederhana untuk tahap pengembangan utama, baik Anda menggunakan terminal, IDE, atau CI/CD pipelines. Instal CLI Pengembang Azure untuk platform Anda.

Banyak templat solusi AI menyertakan opsi penyebaran menggunakan azd.

Menginstal ekstensi Foundry VS Code

Ekstensi Foundry untuk Visual Studio Code memungkinkan Anda menyebarkan model, membangun aplikasi AI, dan bekerja dengan Agen langsung dari antarmuka Visual Studio Code. Instal ekstensi Foundry VS Code.

Pasang Git

Git diperlukan untuk mengkloning sampel Foundry SDK. Jika Anda belum menginstal Git, ikuti instruksi untuk platform Anda dan pilih sistem operasi Anda.

Troubleshooting

Masalah Resolusi
Perintah tidak ditemukan setelah penginstalan Tutup dan buka kembali terminal Anda, atau mulai ulang Visual Studio Code, sehingga perubahan PATH berlaku.
az login mengalami kesalahan pada browser Jalankan az login --use-device-code untuk mengautentikasi menggunakan alur kode perangkat sebagai gantinya.
Python tidak ditemukan Gunakan python3 alih-alih python di macOS/Linux, atau instal versi yang didukung (3.9 atau yang lebih baru).
Izin ditolak selama penginstalan Di macOS/Linux, hindari sudo pip install. Gunakan lingkungan virtual sebagai gantinya.

Konten terkait

  • Referensi dokumentasi SDK Java
  • Last updated on