Azure Developer CLI の azure.yaml スキーマ

azd テンプレート は、概念実証アプリケーション コード、エディター/IDE 構成、Bicep または Terraform で記述されたインフラストラクチャ コードを含むブループリント リポジトリです。 これらのテンプレートは、特定のアプリケーション要件に合わせて変更および調整された後、Azure Developer CLI (azd) を使用して Azure でアプリケーションを取得するために使用されます。 azure.yaml スキーマは、これらのテンプレートに含まれる Azure リソースのアプリと種類を定義し、説明します。

見本

azd テンプレートに必要な azure.yaml の一般的な例を次に示します。

name: yourApp
metadata:
  template: yourApp@0.0.1-beta
services:
  web:
    project: ./src/web # path to your web project
    dist: build # relative path to service deployment artifacts
    language: js # one of the supported languages
    host: appservice # one of the supported Azure services

ToDo NodeJs Mongo テンプレートの azure.yaml と比較します。

name: todo-nodejs-mongo
metadata:
  template: todo-nodejs-mongo@0.0.1-beta
services:
  web:
    project: ./src/web
    dist: build
    language: js
    host: appservice
  api:
    project: ./src/api
    language: js
    host: appservice

プロパティの説明

プロパティの metadata

プロパティの infra

IaC プロバイダーとしての Terraform のサンプル

name: yourApp-terraform
metadata:
  template: yourApp-terraform@0.0.1-beta
services:
  web:
    project: ./src/web
    dist: build
    language: js
    host: appservice
  api:
    project: ./src/api
      language: js
      host: appservice
infra:
  provider: terraform

プロパティの services

Docker オプションのサンプル

次の例では、コンテナー アプリの Docker オプションを宣言します。

name: yourApp-aca
metadata:
    template: yourApp-aca@0.0.1-beta
services:
  api:
    project: ./src/api
    language: js
    host: containerapp
    docker:
      path: ./Dockerfile
      context: ../
  web:
    project: ./src/web
    language: js
    host: containerapp
    docker:
      remoteBuild: true

AKS deployment プロパティ

AKS service プロパティ

AKS ingress プロパティ

サービス レベル フックを含む AKS サンプル

metadata:
  template: todo-nodejs-mongo-aks@0.0.1-beta
services:
  web:
    project: ./src/web
    dist: build
    language: js
    host: aks
    hooks:
      postdeploy:
        shell: sh
        run: azd env set REACT_APP_WEB_BASE_URL ${SERVICE_WEB_ENDPOINT_URL}
  api:
    project: ./src/api
    language: js
    host: aks
    k8s:
      ingress:
        relativePath: api
    hooks:
      postdeploy:
        shell: sh
        run: azd env set REACT_APP_API_BASE_URL ${SERVICE_API_ENDPOINT_URL}

プロパティの pipeline

CI/CD パイプラインとしての Azure Pipelines (AzDo) のサンプル

name: yourApp
services:  
  web:    
    project: src/web
    dist: build
    language: js
    host: appservice
pipeline: 
  provider: azdo

プロパティの workflows

プロパティの up

プロパティの steps

サンプル ワークフロー

次の azure.yaml ファイルでは、azd up の既定の動作が変更され、ワークフローを使用して azd provision ステップの後に azd package ステップが移動されます。 この例は、ビルドまたはパッケージ化プロセス中にリソースの URL を知る必要があるシナリオで使用できます。

name: todo-nodejs-mongo
metadata:
  template: todo-nodejs-mongo@0.0.1-beta
workflows:
  up: 
    steps:
      - azd: provision
      - azd: deploy --all

ヘルプを要求する

バグの報告、ヘルプの要求、または Azure Developer CLI の新機能の提案方法については、のトラブルシューティングとサポートの に関するページを参照してください。

次の手順

• Azure Developer CLI の詳細を確認する
• azd init と azd up の概要