Azure Developer CLI:s azure.yaml-schema

azd mallar är skisslagringsplatser som innehåller proof-of-concept-programkod, redigerar-/IDE-konfigurationer och infrastrukturkod som skrivits i Bicep eller Terraform. Dessa mallar är avsedda att ändras och anpassas för dina specifika programkrav och används sedan för att hämta ditt program i Azure med hjälp av Azure Developer CLI (azd). Schemat azure.yaml definierar och beskriver de appar och typer av Azure-resurser som ingår i dessa mallar.

Prov

Följande är ett allmänt exempel på ett azure.yaml som krävs för mallen azd .

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

Jämför med azure.yaml från vår ToDo NodeJs Mongo-mall:

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

Egenskapsbeskrivningar

metadata egenskaper

infra egenskaper

Exempel på Terraform som IaC-provider

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 egenskaper

Exempel på Docker-alternativ

I följande exempel deklarerar vi Docker-alternativ för en containerapp.

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 egenskaper

AKS-service egenskaper

AKS-ingress egenskaper

AKS-exempel med krokar på tjänstnivå

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 egenskaper

Azure Pipelines (AzDo) som ett CI/CD-pipelineexempel

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

workflows egenskaper

up egenskaper

steps egenskaper

Exempelarbetsflöde

Följande azure.yaml-fil ändrar standardbeteendet för azd up för att flytta azd package steg efter azd provision steg med hjälp av ett arbetsflöde. Det här exemplet kan användas i scenarier där du behöver känna till URL:erna för resurser under bygg- eller paketeringsprocessen.

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

Begär hjälp

Information om hur du skickar in en bugg, begär hjälp eller föreslår en ny funktion för Azure Developer CLI finns på sidan felsökning och support.

Nästa steg

• Läs mer om Azure Developer CLI
• Kom igång med azd init och azd up