Az Azure Developer CLI inicializálási munkafolyamatainak megismerése

Az Azure Developer CLI (azd) számos parancsot biztosít az alkalmazások azure-beli fejlesztésének, kiépítésének és üzembe helyezésének gördülékenyebbé tételéhez. A azd init parancs segítségével új vagy meglévő projekteket állíthat be a munkához azdszükséges fájlok és konfigurációk létrehozásával. Ez a cikk bemutatja a különböző inicializálási munkafolyamatokat, és azt, hogyan választhatja ki a fejlesztési forgatókönyvhöz legjobb lehetőséget.

Inicializálási munkafolyamatok

A azd init parancs számos munkafolyamatot támogat, hogy előkészítse az alkalmazást a következőkkel azdvaló együttműködésre:

Jelenlegi könyvtár vizsgálata: Elemez egy meglévő alkalmazáskódbázist a megfelelő azd konfigurációs fájlok és erőforrások létrehozásához.
Válasszon egy sablont: Klónozza és inicializál egy sablont egy azdsablongyűjteményből.
Minimális projekt létrehozása: Alapszintű fájl inicializálása azure.yaml kiindulási pontként saját azd sablon létrehozásához az alapoktól.

Válassza ki a projektnek leginkább megfelelő megközelítést. Ezeket a folyamatokat részletesebben a Sablonok létrehozása áttekintésében és a kapcsolódó cikkekben ismertetjük. A következő szakaszok az egyes folyamatok fogalmi áttekintését biztosítják.

Az aktuális könyvtár vizsgálata

Ezt a munkafolyamatot akkor használja, ha már rendelkezik alkalmazáskódbázissal azd, és szeretné előkészíteni az Azure-ba való üzembe helyezéshez.

Navigáljon a projekt gyökérkönyvtárához.
Futtassa a azd init következő parancsot:
```
azd init
```

Válassza az Aktuális könyvtár vizsgálata lehetőséget. azd akarat:

Vizsgálja meg a könyvtárat, és állapítsa meg az alkalmazás által használt nyelvet vagy keretrendszert.
Válasszon ki egy megfelelő üzemeltetési platformot, például az Azure Container Appst.
Szükség esetén kérje meg a felderített szolgáltatások hozzáadását vagy eltávolítását.

? How do you want to initialize your app? Scan current directory

  (✓) Done: Scanning app code in current directory

Detected services:

  .NET
  Detected in: src

azd will generate the files necessary to host your app on Azure using Azure Container Apps.

? Select an option  [Use arrows to move, type to filter]
> Confirm and continue initializing my app
  Remove a detected service
  Add an undetected service

Válassza a Megerősítés elemet, és folytassa az alkalmazás inicializálását a munkafolyamat befejezéséhez. azd a következőket hozza létre az alkalmazáskönyvtárban:
- Egy azure.yaml fájl, amely meghatározza az alkalmazásszolgáltatásokat, és kiosztja őket az üzemeltetési erőforrásokhoz.
- Egy .azure olyan mappa, amely a konfigurációs beállításokat, például a környezet nevét tárolja.
- Az .gitignore alkalmazás nyelvéhez és üzemeltetési platformjához konfigurált fájl.
Ha szeretné, futtassa azd up az Azure Container Apps-erőforrások létrehozásához és az alkalmazás üzembe helyezéséhez.

Az alkalmazás mostantól sablonként azd van felépítve, és további Azure-erőforrásokkal és szolgáltatásokkal fejleszthető és bővíthető.

Sablon kiválasztása

Ez a munkafolyamat lehetővé teszi egy előre összeállított azd sablon használatát, amely általában az alkalmazáskódot és a szükséges Azure-infrastruktúra-definíciókat is tartalmazza.

Futtassa a azd init következő parancsot:
```
azd init
```
Megjegyzés:

Futtathatja a azd init elemet a --template paraméterrel, hogy közvetlenül inicializáljon egy sablont név alapján, és kihagyhassa a munkafolyamat-kijelölést.

Válassza a Sablon kiválasztása lehetőséget. azd megjeleníti a konfigurált sablonforrásokból elérhető sablonok listáját.

? How do you want to initialize your app? Select a template
? Select a project template:  [Use arrows to move, type to filter]
> Deploy Phoenix to Azure
  (Arize-ai/phoenix-on-azure)

  API Center Reference Sample
  (Azure-Samples/APICenter-Reference)

  Event Driven Java Application with Azure Service Bus on Azure Spring Apps
  (Azure-Samples/ASA-Samples-Event-Driven-Application)

  Static React Web App with Java API and PostgreSQL
  (Azure-Samples/ASA-Samples-Web-Application)

Írjon be szöveget a találatok szűréséhez, és keresse meg a Hello AZD sablont. A sablon klónozásához és inicializálásához nyomja le az Enter billentyűt.
Szükség esetén futtassa azd up a sablonerőforrások kiépítését és üzembe helyezését az Azure-ban.

A további fejlesztés kiindulópontjaként az inicializált sablont is használhatja.

Minimális projekt létrehozása

Azoknak a haladó felhasználóknak, akik minimális beállítással szeretnének kezdeni, és mindent manuálisan szeretnének testre szabni, ez a beállítás csak az alapvető konfigurációt biztosítja.

Futtassa a azd init parancsot a --minimal jelölővel:
```
azd init --minimal
```
Amikor a rendszer kéri, adja meg a azd sablon nevét, és nyomja le az Enter billentyűt.
```
? How do you want to initialize your app? Create a minimal project
? What is the name of your project? (empty) hello-azd
? What is the name of your project? hello-azd

SUCCESS: Generated azure.yaml project file.
Run azd add to add new Azure components to your project.
```
A --minimal jelölő csak a következőket hozza létre:
- Egy alapvető azure.yaml fájl, amely csak a projekt nevét és a schemaVersiont tartalmazza.
- Egy .azure címtár a környezetkonfigurációhoz
- Az .gitignore Azure Developer CLI megfelelő bejegyzéseit tartalmazó fájl
Ez az egyszerűsített inicializálás ideális, ha:
- Az infrastruktúrát az alapoktól szeretné felépíteni
- Integrálni azd kell egy meglévő összetett projekttel
- Tervezze meg, hogy a azd add parancs használatával növekményesen hozza létre az architektúrát
- A projektstruktúra teljes körű vezérlésének előnyben részesítése
Az inicializálás után a következőt teheti:
- Infrastruktúrafájlok manuális létrehozása egy infra mappában
- Használja az azd addösszeállítási funkciót, hogy elkezdje hozzáadni az Azure-erőforrásokat az alkalmazásához.
- Testreszabhatja a azure.yaml fájlt a szolgáltatások és erőforrások definiálására.

Projekt- és Azure-erőforrások elnevezése

Új vagy meglévő projekt inicializálásakor a projekt neve be van állítva.azure.yaml A projektnév a kiépítési folyamat során létrehozott Azure-erőforrásnevek előtagjaként működik. Az érvényesítési szabályok betartásával győződjön meg arról, hogy a létrehozott Azure-erőforrásnevek is érvényesek lesznek.

A Bicep- vagy Terraform-sablonokban a projekt nevét gyakran használják az erőforrásnevek létrehozásához, a környezet nevével és más elemekkel kombinálva. Például:

var resourceToken = '${name}-${environmentName}'

Ahol name a projekt nevét jelöli, és environmentName a azd környezet nevét.

Projektnév-érvényesítési szabályok

azd init Projekt inicializálásakor vagy új projektnév fájlban azure.yaml való létrehozásakor a rendszer a következő érvényesítési szabályokat alkalmazza:

Szabály	Description
Engedélyezett karakterek	A projektnevek csak kisbetűket, számokat és kötőjeleket tartalmazhatnak.
Kezdő karakter	A projektneveknek betűvel kell kezdődniük.
Vége karakter	A projektnevek nem végződnek kötőjellel.
Hosszúság	A projektneveknek 2 és 63 karakter közötti hosszúságúnak kell lenniük.
Nincsenek egymást követő kötőjelek	A projektnevek nem tartalmazhatnak egymást követő kötőjeleket.

Ezek az érvényesítési szabályok biztosítják, hogy a projekt neve kompatibilis legyen az Azure-erőforrások elnevezési követelményeivel, és megakadályozza a szolgáltatások csomagolási hibáit az üzembe helyezés során.

Következő lépések

A projekt azd initinicializálása után a következőt teheti:

Módosítsa a létrehozott infrastruktúrafájlokat az Azure-erőforrások testreszabásához.
A szükséges erőforrások azure-beli létrehozásához használható azd provision .
Az alkalmazáskód üzembe helyezéséhez használja a azd deploy-t a kiépített erőforrásokon.
Ismerje meg az Azure Developer CLI up munkafolyamatát , amely egyetlen parancsban egyesíti a kiépítést és az üzembe helyezést.

Visszajelzés

Hasznosnak találta ezt az oldalt?

Last updated on 2025-08-14