Azure Developer CLI-sablon megismerése és testreszabása

Ebben a rövid útmutatóban megismerhet és testre szabhat egy Azure Developer CLI-sablont. A hello-azd sablon egyszerű kiindulópontot biztosít az alkalmazások Azure-ban való létrehozásához és üzembe helyezéséhez az Azure Developer CLI (azd) használatával. Ez a rövid útmutató kiterjeszti a rövid útmutató – Azd-sablon üzembe helyezése című cikkben bemutatott fogalmakat.

Előfeltételek

Ahhoz, hogy ezt a gyorsútmutatót böngészőn keresztül befejezze, a következőkre lesz szüksége:

Hozzáférés a GitHub-kódterekhez

Alternatív módszerként ezt a gyors indítást helyi eszközökkel is befejezheti:

A helyi gépen telepített Azure Developer CLI
Visual Studio Code vagy a választott szerkesztő
A Docker desktop telepítve van a helyi gépen

Az Azure Developer CLI-sablonstruktúra megismerése

azd A sablonok standard kódtárak, amelyek további eszközöket is tartalmaznak. Minden azd sablon hasonló fájlstruktúrával rendelkezik a konvenciók alapján azd :

infra mappa – Az összes Bicep- vagy Terraform-infrastruktúrát tartalmazza a azd-sablon kódfájljaként. azd végrehajtja ezeket a fájlokat az alkalmazás által igényelt Azure-erőforrások létrehozásához.
src mappa – Az alkalmazás forráskódját tartalmazza. azd csomagolja és telepíti a kódot az azure.yaml-ben található konfigurációk alapján.
azure.yaml fájl – Konfigurációs fájl, amely leképozza a projekt forráskódmappáit az infra üzembe helyezési mappában meghatározott Azure-erőforrásokra. Meghatározhat például egy API-szolgáltatást és egy webes előtér-szolgáltatást külön mappákban, és leképezheti őket különböző Azure-erőforrásokra az üzembe helyezéshez.
.azure mappa – Alapvető Azure-konfigurációkat tartalmaz, például az erőforrások üzembe helyezésének helyét.

A legtöbb azd sablon például a következő mappastruktúrának felel meg:

Képernyőkép az Azure Developer CLI-sablonstruktúráról.

A sablonstruktúra további részleteiért tekintse meg az Azure Developer CLI-sablonok áttekintésiazd cikkét.

A mintasablon beállítása

hello-azd Egy mintasablon, amely az Azure-ban egyetlen paranccsal üzembe helyezhető alapvető funkciók azd bemutatására szolgál. A sablon egy barátságos felhasználói felületet biztosít, amely információkat azd tartalmaz, valamint egy kis bemutatóeszközt, amellyel támogatási jegyeket tölthet fel és tekinthet meg.

A sablon a következő funkciókat támogatja:

Csomagol és üzembe helyez egy tárolóalapú alkalmazást az Azure Container Apps szolgáltatásba.
Létrehozza az alkalmazáshoz szükséges Azure-erőforrásokat, például egy Azure Cosmos DB-adatbázist
A CI/CD-folyamat automatikusan konfigurálható a azd pipeline config parancs használatával

A sablon beállításához kövesse az alábbi lépéseket:

Kódterek
Visual Studio Code

Nyissa meg a hello-azd sablontárházat a GitHubon.
Válassza a Kód gombot, majd a Kódterek lehetőséget.
Hozzon létre egy új Codespace-t egy teljesen konfigurált fejlesztési környezet elindításához a böngészőben. Előfordulhat, hogy várnia kell egy kis időt a környezet inicializálására.
A Codespaces-környezet betöltése után inicializálja a sablont azd a azd init következő paranccsal:
```
azd init -t hello-azd
```
Amikor a rendszer kéri, adjon meg egy nevet a azd környezetnek, például helloazd.

A helyi gép üres könyvtárában klónozza és inicializálja az adattárat a azd init következő paranccsal:
```
azd init -t hello-azd
```
Amikor a rendszer kéri, adjon meg egy nevet a azd környezetnek, például helloazd.
Nyissa meg a projektmappát a Visual Studio Code-ban:
```
code .
```

A sablon vizsgálata

Ha a sablon meg van nyitva a választott eszközben, tallózhat a mappastruktúrában, és megtudhatja, hogyan azd működnek a sablonok:

Bontsa ki a src mappát az alkalmazás forráskódjának megtekintéséhez.
- A hello-azd sablon tartalmaz egy tárolóalapú .NET-alkalmazást, amely egyszerű felhasználói felületet biztosít a mintajegyadatok megismeréséhez azd és kezeléséhez. azd más nyelveket is támogat, például a JavaScriptet és a Pythont.
- Futtatáskor azd upaz alkalmazás tárolólemezképként van csomagolva, és üzembe lesz helyezve az Azure Container Appsben.

Bontsa ki a infra mappát az infrastruktúra kódfájlokként való feltárásához.

Ez a sablon Bicep-fájlokat (.bicep) használ az Azure-erőforrások létrehozásához, de használhatja a Terraformot is (.tf).

A main.bicep fájl úgy hozza létre az Azure-erőforrásokat, hogy hivatkozik a infra mappában található többi Bicep-modulra, például egy Azure Storage-fiókra:

// Omitted...

// Create a storage account
module storage './core/storage/storage-account.bicep' = {
    name: 'storage'
    scope: rg
    params: {
    name: !empty(storageAccountName) ? storageAccountName : '${abbrs.storageStorageAccounts}${resourceToken}'
    location: location
    tags: tags
    containers: [
        {
        name: 'attachments'
        }
    ]
    }
}

// Omitted...

A sablon gyökerénél nyissa meg a fájlt az azure.yaml alapvető sablonkonfigurációk megtekintéséhez:
- A sablon egy úgynevezett acaszolgáltatást határoz meg.
- A aca szolgáltatáskonfiguráció arra utasítja azd , hogy csomagolja és helyezze üzembe a forráskódot a src mappában a korábban megismert Bicep-modulok által kiépített Azure Container Appban.
- A docker konfigurációk arra utasítják azd az alkalmazást tárolóként való csomagolásra és üzembe helyezésre.
```
metadata:
  template: hello-azd-dotnet  # Specifies the template being used
name: azd-starter  # Name of the project
services:
  aca:  # Define the Azure Container App service
    project: ./src  # Path to the source code
    language: csharp  # Programming language
    host: containerapp  # Hosting service
    docker:
      path: ./Dockerfile  # Location of the Dockerfile
```

A sablon frissítése

Módosíthatja a sablont, hogy befolyásolja az üzembe helyezett alkalmazást és erőforrásokat. Ebben a példában két kisebb módosítást hajt végre az alkalmazásban, és vizsgálja meg az üzembe helyezett eredményeket:

Az alkalmazásfejléc üdvözlőszövegének frissítése saját üzenetre
Frissítse a létrehozott tárfiókot, hogy egy helyett két blobtárolót hoz létre

A módosítások elvégzéséhez hajtsa végre a következő lépéseket:

Nyissa meg az src > Components > Pages összetevőt a Home.razor mappában.
Cserélje le a lap tetején található Hello, Azure Developer CLI! fejlécszöveget egy másik üzenetre, például Hello, testreszabott sablon! szövegre, és mentse a módosításokat.
```
<MudText Typo="Typo.h2" GutterBottom="true">Hello, customized template!</MudText>
```
Nyissa meg a fájlt a inframain.bicep mappában.

Keresse meg a Bicep-kód blokkját a 75. sor körül, amely létrehoz egy tárfiókot és egy blobtárolót:

// Create a storage account
module storage './core/storage/storage-account.bicep' = {
  name: 'storage'
  scope: rg
  params: {
    name: !empty(storageAccountName) ? storageAccountName : '${abbrs.storageStorageAccounts}${resourceToken}'
    location: location
    tags: tags
    containers: [
      {
        name: 'attachments'
      }
    ]
  }
}

Cserélje le a kódot a következő kódrészletre:

// Create a storage account
module storage './core/storage/storage-account.bicep' = {
  name: 'storage'
  scope: rg
  params: {
    name: !empty(storageAccountName) ? storageAccountName : '${abbrs.storageStorageAccounts}${resourceToken}'
    location: location
    tags: tags
    containers: [
      {
        name: 'attachments'
      },
      {
        name: 'archive'
      }
    ]
  }
}

A sablon futtatása

A módosítások elvégzése után használja a parancsot az azd up alkalmazáserőforrások kiépítésére és üzembe helyezésére:

Nyisson meg egy terminált a projektkönyvtárban.
A sablon kiépítéséhez és üzembe helyezéséhez futtassa a azd up következő parancsot:
```
azd up
```
Ez a parancs a következő lesz:
- Az alkalmazás becsomagolása üzembe helyezéshez
- A szükséges Azure-erőforrások kiépítése
- Az alkalmazás üzembe helyezése a frissített módosításokkal
- Az üzembe helyezett alkalmazás URL-címének nyomtatása
A frissített alkalmazás élő megtekintéséhez nyissa meg a konzol kimeneti naplóiban azd kinyomtatott URL-címet a böngészőben.
A létrehozott két blobtároló megtekintéséhez lépjen a létrehozott tárfiókra az Azure Portalon.

Következtetés

Ebben a rövid útmutatóban megismerkedett a sablon szerkezetével, testre szabta annak hello-azd alkalmazását és infrastruktúráját, és üzembe helyezte azt az Azure-ban az Azure Developer CLI használatával. Ha speciálisabb forgatókönyveket keres, ismerkedjen meg más sablonokkal, vagy ismerkedjen meg részletesebben a dokumentációval azd .

Következő lépések

Visszajelzés

Hasznosnak találta ezt az oldalt?

Last updated on 2025-04-21