Menginstal dan mengonfigurasi kemampuan Azure

Artikel ini memperlihatkan kepada Anda cara menginstal Azure Skills, mengautentikasi ke akun Azure Anda, dan memverifikasi penginstalan. Setelah penyiapan, Anda dapat mengelola sumber daya Azure dari antarmuka obrolan Anda.

Prasyarat

Pastikan Anda memiliki:

• Node.js Dukungan Jangka Panjang (LTS): Unduh dari nodejs.org atau gunakan manajer versi seperti nvm.
• akun Azure: Buat akun gratis jika Anda tidak memilikinya.
• Asisten AI: GitHub Copilot CLI, Claude Code, atau platform lain yang kompatibel.
• Azure CLI (disarankan untuk pengembangan lokal): Menyederhanakan autentikasi. Instal Azure CLI. Variabel lingkungan atau identitas terkelola dapat digunakan sebagai alternatif dalam alur CI/CD.

Nota

Azure Skills menggunakan autentikasi yang sama dengan Azure MCP Server. Jika Anda sudah mengautentikasi untuk Azure McP Server, Azure Skills menggunakan kredensial tersebut.

Mengautentikasi ke Azure

Azure Skills memerlukan kredensial untuk mengakses sumber daya Azure Anda. Pilih metode yang sesuai dengan kasus penggunaan Anda.

Azure CLI (disarankan)

Metode ini adalah yang paling mudah untuk pengembangan dan pengujian lokal.

1. Instal Azure CLI:

   • Kunjungi panduan penginstalan Azure CLI.
   • Atau gunakan manajer paket: brew install azure-cli (macOS), apt-get install azure-cli (Linux).

2. Masuk ke Azure:

   az login
   

   Jendela browser terbuka. Masuk dengan menggunakan kredensial akun Azure Anda.

3. Verifikasi autentikasi:

   az account show
   

   Anda melihat detail langganan Anda di terminal. Azure Skills mendeteksi autentikasi ini.

Variabel lingkungan

Gunakan variabel lingkungan untuk skrip atau alur di mana Azure CLI tidak tersedia. Buat perwakilan layanan terlebih dahulu.

Bash atau Zsh:

export AZURE_TENANT_ID="your-tenant-id"
export AZURE_CLIENT_ID="your-client-id"
export AZURE_CLIENT_SECRET="your-client-secret"

PowerShell:

$env:AZURE_TENANT_ID = "your-tenant-id"
$env:AZURE_CLIENT_ID = "your-client-id"
$env:AZURE_CLIENT_SECRET = "your-client-secret"

Prompt Perintah Windows:

set AZURE_TENANT_ID=your-tenant-id
set AZURE_CLIENT_ID=your-client-id
set AZURE_CLIENT_SECRET=your-client-secret

Azure Skills mendeteksi variabel lingkungan ini secara otomatis.

Identitas yang dikelola

Jika Anda menjalankan Azure Skills pada sumber daya Azure (komputer virtual, Aplikasi Kontainer, atau Azure Functions), identitas terkelola menangani autentikasi tanpa penyiapan manual.

Untuk informasi selengkapnya, lihat identitas terkelola Azure.

Menginstal keterampilan Azure

Pilih metode penginstalan untuk asisten AI Anda.

GitHub Copilot CLI

Tambahkan marketplace (hanya untuk pertama kali):

/plugin marketplace add microsoft/azure-skills

Instal plugin:

/plugin install azure@azure-skills

Perbarui plugin:

/plugin update azure@azure-skills

Visual Studio Code

Instal ekstensi Azure MCP dari Marketplace Visual Studio:

👉 Azure Ekstensi MCP

Ekstensi MCP Azure menginstal ekstensi pendamping yang membawa keterampilan Azure ke dalam Visual Studio Code. Bersama-sama mereka mengonfigurasi Azure MCP Server dan lapisan keterampilan penuh.

Nota

Ekstensi keterampilan mengharuskan Git CLI diinstal pada komputer Anda.

Kode Claude

Tambahkan marketplace (hanya untuk pertama kali):

/plugin marketplace add microsoft/azure-skills

Instal plugin:

/plugin install azure@azure-skills

Pembaruan:

/plugin marketplace update azure-skills

Kursor

Pasang plugin Azure dari Marketplace Kursor atau langsung dari pengaturan Cursor.

1. Pergi ke Pengaturan>Plugin.

2. Cari Azure.

3. Pilih plugin Azure untuk menginstalnya.

   

Plugin secara otomatis mengonfigurasi Azure MCP Server, Foundry MCP, dan lapisan keterampilan penuh.

Sebelum menginstal Azure Skills di IntelliJ IDEA, pastikan Anda memiliki:

• Node.js 18+ diinstal pada sistem Anda dengan npx tersedia di PATH Anda.
• Git diinstal dan dapat diakses dari baris perintah.

Anda dapat memverifikasi prasyarat ini dengan menjalankan:

npx --version
git --version

Langkah 1: Instal plugin GitHub Copilot

1. Buka IntelliJ IDEA.
2. BukaPengaturan> (di Windows/Linux) atauPreferensi> (di macOS).
3. Navigasikan ke Plugin di bilah sisi kiri.
4. Cari GitHub Copilot di tab Marketplace.
5. Instal plugin GitHub Copilot (memerlukan versi 1.5.64-242 atau lebih tinggi).
6. Mulai ulang IntelliJ IDEA saat diminta.

Langkah 2: Mengaktifkan keterampilan untuk GitHub Copilot

1. Buka pengaturan atau preferensi IntelliJ IDEA lagi.

2. Navigasi ke Alat>GitHub Copilot>Chat.

3. Pilih kotak centang Aktifkan Keterampilan .

4. Pilih Terapkan dan OK.

   

Langkah 3: Instal Azure Skills

Opsi 1: Azure Toolkit untuk IntelliJ

1. Instal plugin Azure Toolkit untuk IntelliJ dari Marketplace JetBrains.

2. Mulai ulang IntelliJ IDEA untuk menyelesaikan penginstalan plugin.

3. Setelah menghidupkan ulang, pemberitahuan muncul menawarkan untuk menginstal Azure Skills. Pilih Instal untuk menambahkan keterampilan Azure ke lingkungan Anda.

   

4. Verifikasi penginstalan dengan membuka jendela obrolan GitHub Copilot dan mengetik /skill:azure. Perintah ini menampilkan semua keterampilan Azure yang tersedia.

   

Opsi 2: Penginstalan manual

1. Buka terminal atau jendela perintah.

2. Jalankan perintah berikut untuk menginstal Azure Skills secara global untuk GitHub Copilot:

   npx skills add https://github.com/microsoft/azure-skills/tree/main/.github/plugins/azure-skills/skills -a github-copilot -g -y
   

3. Tunggu hingga penginstalan selesai. Pesan konfirmasi muncul saat keterampilan Azure berhasil ditambahkan.

Untuk daftar lengkap host dan opsi penginstalan yang didukung, lihat repositori Azure Skills.

Verifikasi penginstalan

Setelah penginstalan, konfirmasikan Azure Skills siap digunakan.

1. Cantumkan plugin yang terinstal:

   /plugin list
   

   Keluaran mencakup azure@azure-skills dan keterampilan yang tersedia.

2. Uji dengan perintah cepat:

   /ask List my Azure subscriptions
   

   Asisten AI Anda meminta akun Azure Anda dan menampilkan langganan Anda.

Coba keterampilan Azure

Setelah Anda menginstal dan memverifikasi Azure Skills, coba perintah ini di jendela obrolan asisten AI Anda:

Siapkan rencana penyebaran untuk proyek Anda:

Analyze my project structure and prepare a deployment plan for deploying to Azure. What infrastructure do I need and how should I set it up?

Respons yang diharapkan: Asisten menganalisis basis kode Anda dan menghasilkan templat infrastruktur sebagai kode. Ini membuat rencana penyebaran di .azure/plan.md dan meminta persetujuan Anda.

Diagnose masalah kesehatan sumber daya Azure:

I'm getting errors from my Azure App Service. What's wrong and how do I fix it?

Respons yang diharapkan: Asisten memeriksa layanan aplikasi Anda, memeriksa log, dan meninjau penyebaran terbaru. Ini mengidentifikasi masalah dan menyediakan langkah-langkah remediasi.

Siapkan pemantauan dan pengamatan:

Configure monitoring and alerting for my application. Which Application Insights features should I enable? What metrics should I track?

Respons yang diharapkan: Asisten mengusulkan strategi pemantauan dan menghasilkan kode instrumentasi. Ini mengonfigurasi Pemberitahuan Azure untuk metrik penting yang disesuaikan dengan tumpukan aplikasi Anda.

Asisten AI yang didukung

Anda dapat menggunakan keterampilan Azure di seluruh platform ini:

• GitHub Copilot CLI: Integrasi penuh dengan alat GitHub Copilot
• Kode Claude: Melalui Protokol Konteks Model (MCP)
• Asisten AI lain yang kompatibel dengan MCP: Alat apa pun yang mendukung MCP

Untuk daftar lengkap alat yang mendukung integrasi Azure, lihat alat yang didukung Azure MCP Server.

Opsi konfigurasi

Telemetri

Secara default, Azure Skills mengumpulkan telemetri penggunaan untuk meningkatkan layanan.

Untuk menonaktifkan telemetri:

export AZURE_MCP_COLLECT_TELEMETRY=false

Troubleshooting

Kesalahan "Autentikasi gagal"

Problem: Asisten AI Anda tidak dapat mengautentikasi ke Azure.

Solusi:

• Azure CLI: Jalankan az login lagi dan pastikan Anda diautentikasi.
• Variabel lingkungan: Verifikasi AZURE_TENANT_ID, AZURE_CLIENT_ID, dan AZURE_CLIENT_SECRET diatur dengan benar.
• Managed identity: Konfirmasikan sumber daya Azure Anda memiliki identitas terkelola yang ditetapkan.

Kesalahan "Plugin tidak ditemukan"

Problem: Plugin Azure Skills tidak diinstal atau dikenali.

Solusi:

• Untuk mendaftarkan marketplace, jalankan /plugin marketplace add microsoft/azure-skills .
• Untuk menginstal plugin, jalankan /plugin install azure@azure-skills.
• Mulai ulang asisten AI Anda.
• Pastikan Node.js terinstal.

Kesalahan "Izin tidak mencukup"

Problem: Akun Azure Anda tidak memiliki izin yang diperlukan.

Solusi:

• Periksa penetapan peran kontrol akses berbasis peran (RBAC) Azure Anda.
• Minta lebih banyak peran dari administrator Azure Anda.
• Gunakan langganan lain di mana Anda memiliki izin yang lebih tinggi.

Kesalahan "Langganan tidak valid"

Problem: Azure Skills tidak dapat menemukan atau mengakses langganan yang Anda tentukan.

Solusi:

• Untuk melihat langganan yang tersedia, jalankan az account list.
• Verifikasi ID atau nama langganan sudah benar.
• Periksa apakah kredensial Anda memiliki akses ke langganan.

Konten terkait

• Mulai dengan Azure Skills
• Ringkasan Keterampilan Azure
• GitHub Copilot untuk Azure
• Buku Panduan Memulai Azure MCP Server