Megjegyzés
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhat bejelentkezni vagy módosítani a címtárat.
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhatja módosítani a címtárat.
Miután létrehozott egy új Azure fejlesztői CLI-sablont (azd) vagy egy meglévőből indul ki, a követelmények változásával bővítheti és fejlesztheti az alkalmazást és az infrastruktúrát. Ez az oktatóanyag bemutatja, hogyan adhat hozzá új Azure szolgáltatást egy sablonhoz anélkül, hogy a sablon által már biztosított modulra támaszkodhat.
Kezdje a hello-azd-python vagy hello-azd sablonnal, hozzon létre egy Bicep modult, amely meghatároz egy Azure Translator erőforrást, hivatkozzon a modulra a sablon infrastruktúrájának belépési pontjáról, és tegye elérhetővé a kimeneteit azd környezeti értékekként. Az oktatóanyag az infrastruktúra bővítésére összpontosít, és nem módosítja az alkalmazáskódot.
Note
A következő módosításokat közvetlenül vagy egy AI-kódolási asszisztens segítségével végezheti el. A létrehozási módszertől függetlenül tekintse át az eredményként kapott fájlokat, és ellenőrizze a sablont az üzembe helyezés előtt.
Prerequisites
Az oktatóanyag elvégzéséhez a következőkre lesz szüksége:
- Azure fejlesztői parancssori felület telepítve van.
- Azure-előfizetés.
- Engedély Azure erőforrások létrehozására az előfizetésben.
- Egy üres könyvtár az inicializált sablon számára.
A sablon inicializálása
Nyisson meg egy terminált egy üres mappában. A .NET beállításhoz telepítse a .NET 10 SDK-t. Ezután válasszon ki egy nyelvet, és inicializálja annak sablonját abban a könyvtárban:
A sablon a következőket tartalmazza:
- Az Azure Container Appsben a(z)
acakörnyezetben a(z)azure.yamlszolgáltatásként üzembe helyezett Python- vagy C#-alkalmazás. - Az alkalmazáshoz rendelt, felhasználó által hozzárendelt felügyelt identitás.
- Egy Azure Storage-fiók blobtárolóval és -táblával.
- Azure Container Registry és Azure Container Apps környezet.
- A(z)
infra/corealatti újrahasználható Bicep-modulok.
A sablon inicializálás előtti kiválasztásával és áttekintésével kapcsolatos útmutatásért lásd: Start from a existing template.
Translator-modul létrehozása
Hozzon létre egy fájlt infra/translator.bicepmanuálisan vagy egy AI-kódolási asszisztens segítségével. Ez az új modul önálló, és nem függ a kezdő sablonból származó moduloktól:
@description('Name of the Azure Translator resource.')
param name string
@description('Azure region for the resource.')
param location string
@description('Tags to apply to the resource.')
param tags object = {}
@description('Pricing tier for Azure Translator.')
@allowed([
'F0'
'S1'
])
param sku string = 'F0'
resource translator 'Microsoft.CognitiveServices/accounts@2023-05-01' = {
name: name
location: location
kind: 'TextTranslation'
sku: {
name: sku
}
properties: {
customSubDomainName: name
disableLocalAuth: true
publicNetworkAccess: 'Enabled'
}
tags: tags
}
output name string = translator.name
output endpoint string = translator.properties.endpoint
A modul az erőforrástípust használja, és letiltja a TextTranslation helyi kulcs hitelesítését. A F0 szint hasznos a kiértékeléshez, de előfizetésenként csak egy ingyenes Translator-erőforrást engedélyez. Akkor használja S1 , ha az előfizetés már tartalmaz erőforrást F0 , vagy ha a projekthez fizetős szint szükséges.
Important
Ez a bevezető példa lehetővé teszi a nyilvános végpontot, hogy hálózati infrastruktúra hozzáadása nélkül kiépíthesse az erőforrást. Mielőtt éles környezetben használ ilyet, értékelje ki a privát végpontokat, a hálózati hozzáférés-vezérlést, a monitorozást és a szervezet biztonsági követelményeit.
Hivatkozás a modulra a következőből: main.bicep
Mindkét sablon meghatározza az erőforráscsoportot, valamint a infra/main.bicep fájlban a location, tags és resourceToken értékeit. Ezt a szerkesztést manuálisan is elvégezheti, vagy megkérheti egy AI-asszisztenst, hogy adja hozzá. Adja hozzá a következő modult az erőforráscsoport deklarációja után, és válassza ki a nyelvspecifikus erőforráscsoport-azonosítót:
module translator './translator.bicep' = {
name: 'translator'
scope: resourceGroup
params: {
name: 'translator-${resourceToken}'
location: location
tags: tags
}
}
A scope tulajdonság üzembe helyezi a modult a sablon által létrehozott erőforráscsoportban. A meglévő resourceToken érték megkülönbözteti a Translator-erőforrás nevét az egyes környezetekhez.
A Translator kimeneteinek exportálása
Adja hozzá az alábbi kimeneteket a(z) infra/main.bicep végéhez:
output AZURE_TRANSLATOR_NAME string = translator.outputs.name
output AZURE_TRANSLATOR_ENDPOINT string = translator.outputs.endpoint
Az üzembe helyezés után a azd rögzíti ezeket a nem titkos kimeneteket az aktív környezetben. Egy későbbi alkalmazáskód-módosítás ezeket az értékeket használhatja a Translator-erőforrás megkereséséhez.
Az infrastruktúra kiépítése és ellenőrzése
A sablon infrastruktúrájának kiépítése az alkalmazáskód üzembe helyezése nélkül:
azd provision
Futtassa a(z) azd env get-values parancsot, és ellenőrizze, hogy a kimenet tartalmazza a(z) AZURE_TRANSLATOR_NAME és AZURE_TRANSLATOR_ENDPOINT elemeket. A Azure portálon ellenőrizze, hogy az erőforráscsoport tartalmaz-e Azure Translator erőforrást.
Ezen a ponton a sablon kiépíti az AI szolgáltatást, de nem csatlakoztatja hozzá a mintaalkalmazást. Az integráció befejezéséhez konfigurálja a minimális jogosultsági hozzáférést az alkalmazás felügyelt identitásához, adja át a végpontot az alkalmazásnak, és vegyen fel egy Translator-ügyfelet az alkalmazás kódjába. További információt a Azure Translator dokumentációjában talál.
Erőforrások tisztítása
Ha már nincs szüksége az erőforrásokra, törölje őket a további költségek elkerülése érdekében:
azd down --purge
Kapcsolódó tartalom
- A sablonfejlesztés áttekintése
- Kezdés új sablonnal
- Kezdés meglévő sablonból
- Sablonfájlok felfedezése és szerkesztése
Segítség kérése
Ha további információt szeretne megtudni arról, hogyan nyújthat be hibát, kérhet segítséget vagy javasolhat új funkciót a Azure fejlesztői parancssori felületéhez, látogasson el a troubleshooting és támogatás oldalra.