Helyi Azure kiépítése

.NET .NET Aspire lenyűgöző alkalmazásgazdamodelljével leegyszerűsíti a helyi natív felhőbeli alkalmazásfejlesztést. Ez a modell lehetővé teszi az alkalmazás helyi futtatását ugyanazokkal a konfigurációkkal és szolgáltatásokkal, mint a Azure. Ebből a cikkből megtudhatja, hogyan építhet ki Azure erőforrásokat a helyi fejlesztési környezetből az .NET.NET Aspire alkalmazásgazdakeresztül.

Követelmények

Ez a cikk feltételezi, hogy rendelkezik Azure fiókkal és előfizetéssel. Ha nem rendelkezik Azure fiókkal, létrehozhat egy ingyenes fiókot Azure Ingyenes fiók. Ahhoz, hogy a kiépítési funkciók megfelelően működjenek, hitelesítve kell lennie Azure. Győződjön meg arról, hogy telepítve van a Azure Developer CLI. Emellett meg kell adnia néhány konfigurációs értéket is, hogy a kiépítési logika erőforrásokat hozzon létre az Ön nevében.

Alkalmazásgazdagép telepítési API-k

Az alkalmazásgazda api-k készletét biztosítja Azure erőforrások kifejezéséhez. Ezek az API-k kiterjesztési módszerekként érhetők el a .NET AspireAzure könyvtárakban, és kibővítik a IDistributedApplicationBuilder felületet. Amikor Azure erőforrásokat ad hozzá az alkalmazás gazdagépéhez, implicit módon hozzáadják a megfelelő kiépítési funkciót. Más szóval nem kell közvetlenül meghívnia a kiépítési API-kat.

Az alkalmazásgazda indításakor a rendszer a következő kiépítési logikát hajtja végre:

1. A Azure konfigurációs szakasz érvényesítve van.
2. Érvénytelen állapot esetén az irányítópult és az alkalmazás gazdagépének kimenete tippeket ad a hiányzó adatokra. További információ: Hiányzó konfigurációs értékmutatók.
3. Amikor érvényes Azure erőforrások feltételesen kerülnek kiépítésre:
   1. Ha egy adott erőforrás Azure telepítése nem létezik, akkor létrehozzák és konfigurálják mint egy telepítést.
   2. Az említett üzembe helyezés konfigurációja ellenőrzőösszeggel van megjelölve, amely csak az erőforrások szükség szerinti kiépítését támogatja.

Meglévő Azure erőforrások használata

Az alkalmazásgazda automatikusan kezeli Azure erőforrások kiépítését. Az alkalmazásgazda első futtatásakor az alkalmazásgazda által megadott erőforrásokat helyezi üzembe. A későbbi futtatások nem biztosítják újra az erőforrásokat, hacsak az alkalmazásgazda konfigurációja nem változik.

Ha már kiépített Azure erőforrásokat az alkalmazás gazdagépén kívül, és használni szeretné őket, a kapcsolati sztringet megadhatja a AddConnectionString API-val, ahogyan az alábbi Azure Key Vault példában látható:

// Service registration
var secrets = builder.ExecutionContext.IsPublishMode
    ? builder.AddAzureKeyVault("secrets")
    : builder.AddConnectionString("secrets");

// Service consumption
builder.AddProject<Projects.ExampleProject>()
       .WithReference(secrets)

Az előző kódrészlet bemutatja, hogyan adhat hozzá egy Azure Key Vault-t az alkalmazás gazdagépéhez. A AddAzureKeyVault API-t használják a Azure Key Vault alkalmazásgazdagéphez való hozzáadásához. A AddConnectionString API a kapcsolati sztring megadására szolgál az alkalmazásgazda számára.

Azt is megteheti, hogy néhány Azure erőforrás esetében emulátorként futtatja őket a RunAsEmulator API-val. Ez az API Azure Cosmos DB és Azure Storage- integrációkhoz érhető el. Ha például emulátorként szeretné futtatni AzureAzure Cosmos DB, a következő kódrészletet használhatja:

var cosmos = builder.AddAzureCosmosDB("cosmos")
                    .RunAsEmulator();

A RunAsEmulator API konfigurál egy Azure Cosmos DB erőforrást, amelyet a NoSQL API-val Azure Cosmos DB emulátor használatával kell emulálni.

.NET Aspire Azure integrációk üzemeltetése

Ha Azure-erőforrásokat használ az alkalmazáshosztjában, akkor egy vagy több .NET AspireAzure üzemeltetési integrációthasznál. Ezek a tárkönyvtárak bővítési metódusokat biztosítanak a IDistributedApplicationBuilder interfész számára, hogy Azure erőforrásokat adjanak hozzá az alkalmazás tárhelyéhez.

Konfiguráció

Ha Azure erőforrásokat használ a helyi fejlesztési környezetben, meg kell adnia a szükséges konfigurációs értékeket. A konfigurációs értékek a Azure szakaszban vannak megadva:

• SubscriptionId: Az Azure előfizetés azonosítója.
• AllowResourceGroupCreation: Logikai érték, amely azt jelzi, hogy létre kell-e hozni egy új erőforráscsoportot.
• ResourceGroup: A használni kívánt erőforráscsoport neve.
• Location: A használni kívánt Azure régió.

Tekintse meg a appsettings.json konfiguráció alábbi példáját:

{
  "Azure": {
    "SubscriptionId": "<Your subscription id>",
    "AllowResourceGroupCreation": true,
    "ResourceGroup": "<Valid resource group name>",
    "Location": "<Valid Azure location>"
  }
}

Miután konfigurálta a szükséges értékeket, megkezdheti Azure erőforrások kiépítését a helyi fejlesztési környezetben.

Azure hitelesítőadat-tároló kiépítése

Az .NET Aspire alkalmazás gazdagép hitelesítőadat-tárolót használ Azure erőforrás-hitelesítéshez és engedélyezéshez. Az előfizetéstől függően előfordulhat, hogy a megfelelő hitelesítőadat-tárolóra van szükség a több-bérlős kiépítési forgatókönyvekhez.

A 📦Aspire.Hosting.Azure NuGet-csomag telepítve, és ha az alkalmazásgazda Azure erőforrásokra támaszkodik, akkor az alapértelmezett Azure hitelesítőadat-tároló a DefaultAzureCredential-en alapul. Ennek a viselkedésnek a módosításához beállíthatja a hitelesítőadat-tároló értékét a appsettings.json fájlban az alábbi példában látható módon:

{
  "Azure": {
    "CredentialSource": "AzureCli"
  }
}

Mint minden konfigurációalapú beállítás, ezeket is konfigurálhatja alternatív szolgáltatókkal, például felhasználói titkos kódokat vagy környezeti változókat. A Azure:CredentialSource érték a következő értékek egyikére állítható be:

• AzureCli: Delegáltak a AzureCliCredential.
• \AzurePowerShell: A delegáltak a \AzurePowerShellCredential-hez lettek kijelölve.
• VisualStudio: Delegáltak a VisualStudioCredential.
• VisualStudioCode: Delegáltak a VisualStudioCodeCredential.
• AzureDeveloperCli: Delegáltak a(z) AzureDeveloperCliCredential-be.
• InteractiveBrowser: Delegáltak a(z) InteractiveBrowserCredential-hez.

Eszköztámogatás

A Visual Studio-ban a Csatlakoztatott szolgáltatások használatával konfigurálhatja az alapértelmezett Azure kiépítési beállításokat. Válassza ki az alkalmazásgazdaprojektet, kattintson a jobb gombbal a Csatlakoztatott szolgáltatások csomópontra, és válassza Azure Erőforrás-létesítési beállítások:

Ekkor megnyílik egy párbeszédpanel, ahol konfigurálhatja a Azure kiépítési beállításokat, ahogyan az alábbi képernyőképen látható:

Hiányzó konfigurációs értékmutatók

Ha a Azure konfigurációs szakasz hiányzik, hiányzó értékekkel rendelkezik, vagy érvénytelen, az .NET.NET Aspire irányítópult hasznos tippeket nyújt. Gondoljunk egy olyan alkalmazásgazdára, amely nélkülözi az SubscriptionId konfigurációs értéket, de mégis próbál használni egy Azure Key Vault erőforrást. Az Erőforrások lap az Állapot -et jelzi, mint Hiányzó előfizetés-konfiguráció.

Emellett a konzolnaplók is megjelenítik ezeket az információkat, vegye figyelembe a következő képernyőképet:

Ismert korlátozások

A Azure erőforrások ilyen módon történő kiépítése után manuálisan kell eltávolítania az erőforrásokat a Azure portálon, mivel .NET Aspire nem biztosít beépített mechanizmust Azure erőforrások törléséhez. Ennek legegyszerűbb módja a konfigurált erőforráscsoport törlése. Ezt a Azure portálon vagy a Azure parancssori felület használatával teheti meg:

az group delete --name <ResourceGroupName>

Cserélje le <ResourceGroupName> a törölni kívánt erőforráscsoport nevére. További információkért lásd: az group delete.