Azure スキルの使い方を始める

このクイック スタートでは、Azure Skills を使用して、アプリケーションを準備し、検証し、Azureにデプロイします。

前提条件

  • Azure Skills がインストールされている (Azure Skills のインストールと構成)
  • 認証されたAzure CLI (az login正常に完了しました)
  • GitHub Copilot CLI または Claude Code を使用する準備が整いました
  • サンプル アプリケーション (または Node.js アプリを作成する)

シナリオ

Node.js アプリケーションがある。 次の方法でAzureにデプロイする必要があります。

  • Web アプリケーションホスティング (Azure App Service)
  • アプリケーション データのストレージ アカウント
  • Application Insights による監視

アプリケーションを準備する

AI アシスタントで、プロジェクト ディレクトリに移動し、次の質問をします。

Prepare my application for Azure deployment

azure-prepareスキル:

  1. コードベースを分析する
  2. テクノロジ スタック (Node.js、npm など) を識別します
  3. デプロイ戦略を使用して .azure/plan.md を作成します
  4. コードとしてインフラストラクチャを生成する
  5. 承認を待ちます

生成されたプランを確認する

.azure/plan.mdを開き、次の内容を確認します。

  • プロジェクト情報 — アプリケーション名と展開モード
  • 要件 - 分類とスケール (小、中、大)
  • コンポーネント - 検出されたテクノロジ
  • デプロイ戦略— アプリケーションのデプロイに使用されるテクノロジ (Azure Developer CLI、Bicep、Terraform、またはAzure CLI)。
  • Architecture - 選択したAzureサービス
  • 実装計画 - ステップ バイ ステップ のタスク

プランコンテンツの例:

# Azure Deployment Plan

## Project Information
- Application: my-app
- Mode: NEW

## Requirements
- Classification: Web Application
- Scale: Small
- Environment: Production

## Components
- Runtime: Node.js 18+
- Package Manager: NPM
- Application Type: Express web server

## Recipe
- Type: AZD (Azure Developer CLI)

## Azure Services
- Azure App Service (web app hosting)
- Azure Storage Account (data)
- Application Insights (monitoring)

## Status: Awaiting Approval

プランを承認する

プランが正しければ、AI アシスタントに次のように伝えます。

Approve this plan and proceed to validation

スキルはプランの状態を Approved に更新し、次の手順に進みます。

ヒント

スキルでプロジェクトの種類が認識されない場合は、認識可能なプロジェクト ファイル (package.json、 requirements.txt、 .csprojなど) を含むプロジェクト ルート ディレクトリにいることを確認します。

デプロイ計画を検証する

AI アシスタントは、 azure-validate スキルを実行して次のことを確認します。

  • Azure CLI のアクセス権限と許可
  • 適用可能な場合は、Bicep または Terraform テンプレートの構文
  • Azure のサブスクリプションとリージョンの可用性
  • サービスの割り当て制限
  • アカウントに必要なアクセス許可

検証が完了し、プラン内のすべてのチェックの証明が記録されます。 プランの状態が Validatedに更新されます。

検証結果を確認する

.azure/plan.mdセクションのを確認します。次の内容が表示されます。

  • 実行されたコマンド
  • タイムスタンプ (日時記録)
  • 結果 (成功または失敗)

例：

## Validation Proof
- Command: azd provision --preview
- Timestamp: 2026-03-16T14:22:00Z
- Result: ✓ All validation checks passed

検証に失敗した場合は、エラーを確認し、AI アシスタントに問題の修正を依頼します。

Fix the validation errors and try again

ヒント

検証に失敗した場合は、Azure アカウントに必要なアクセス許可があり、プランで指定されたリソースが選択したリージョンで使用できるかどうかを確認します。

Azureにデプロイする

計画が検証されたら、AI アシスタントに次のことを伝えます。

Deploy my application to Azure

azure-deploy スキル:

  1. プランの状態を確認しました Validated
  2. Azure リソース (ストレージ、アプリ サービス、監視) をプロビジョニングします
  3. アプリケーション コードをデプロイします
  4. アプリケーション設定を構成する
  5. アプリケーション エンドポイントを提供します

通常、デプロイには 3 ~ 5 分かかります。

デプロイされたアプリケーションを表示する

デプロイが成功すると、AI アシスタントは次の機能を提供します。

  • アプリケーション URL (App Service 用)
  • ストレージ アカウント名とアクセス キー
  • Application Insights インストルメンテーション キー

例：

Deployment complete! 

Your app is live at: https://my-app-abcd1234.azurewebsites.net

Resources deployed:
- App Service: my-app-prod
- Storage Account: mystorageabcd1234
- Application Insights: my-app-insights

Monitor your app: https://portal.azure.com/...

アプリが実行されていることを確認するには、ブラウザーでアプリケーションの URL にアクセスします。

ヒント

デプロイに失敗した場合は、エラー出力でアクセス許可またはクォータの問題を確認します。 az account showを実行して、正しいサブスクリプションに対して認証されていることを確認します。

デプロイメントを検証する

アプリケーションをテストします。

  1. URL にアクセスする - ブラウザーでアプリケーションの URL を開きます。
  2. 監視の確認 - Application Insights でログを表示します。
  3. テスト機能 - アプリの主な機能を使用します。

AI アシスタントに状態の監視を依頼します。

Show me the application logs and performance metrics

AI アシスタントは Application Insights に対してクエリを実行し、最近のアクティビティ、エラー、パフォーマンス データを表示します。

更新と再デプロイ

コードを変更する場合は、簡単に再デプロイします。

  1. エディターでコードを更新します。

  2. AI アシスタントに問い合わせてください。

    Update the deployment with my latest changes

  3. スキルはazure-prepareを実行して変更を確認し、その後にazure-deployを使用してリソースを更新します。

更新されたリソースは、既存のインフラストラクチャを再利用します。 変更されたコンポーネントのみが再デプロイされます。

リソースをクリーンアップする

アプリケーションが不要になったら、課金されないようにリソースAzure削除します。

Delete all Azure resources for this application

AI アシスタント:

  1. 削除するリソースを一覧表示します (確認用)
  2. リソース グループとすべてのコンテンツを削除します。
  3. クリーンアップの完了を確認します

例：

Resources to delete:
- Resource Group: my-app-rg
- All contained resources

Are you sure? (yes/no)

削除を確認するには、「 yes 」と入力します。

Troubleshooting

認証エラーでデプロイが失敗する

Problem: AI アシスタントはAzureに対して認証できません。

ソリューション：az loginを使用して再認証し、もう一度やり直してください。

プランの検証が失敗する

Problem: Azure Skills は検証エラーを報告します。

ソリューション： AI アシスタントに、問題の確認と修正を依頼します。

Why did validation fail? Fix the errors.

デプロイ後にアプリケーションにアクセスできない

問題： 指定された URL は、エラーまたはタイムアウトを返します。

Solution:

  1. URL が正しいことを確認します。

  2. DNS 伝達まで 1 ~ 2 分待ちます。

  3. Application Insights ログでエラーを確認します。

    Show me recent errors in Application Insights

次のステップ

  • Last updated on