Snabbstart: Skapa och distribuera från lokal källkod till Azure Container Apps
Den här artikeln visar hur du skapar och distribuerar en mikrotjänst till Azure Container Apps från lokal källkod med det programmeringsspråk du väljer. I den här snabbstarten skapar du en webb-API-tjänst för serverdelen som returnerar en statisk samling musikalbum.
Följande skärmbild visar utdata från den album-API-tjänst som du distribuerar.
Förutsättningar
För att slutföra det här projektet behöver du följande:
| Krav | Instruktioner |
|---|---|
| Azure-konto | Om du inte har något skapar du ett konto kostnadsfritt. Du behöver behörigheten Deltagare eller Ägare för Azure-prenumerationen för att kunna fortsätta. Mer information finns i Tilldela Azure-roller med hjälp av Azure Portal. |
| Git | Installera Git. |
| Azure CLI | Installera Azure CLI. |
Ställ in
Om du vill logga in på Azure från CLI kör du följande kommando och följer anvisningarna för att slutföra autentiseringsprocessen.
az login
Kör uppgraderingskommandot för att säkerställa att du kör den senaste versionen av CLI.
az upgrade
Installera eller uppdatera sedan Azure Container Apps-tillägget för CLI.
az extension add --name containerapp --upgrade --allow-preview true
Nu när det aktuella tillägget har installerats registrerar du Microsoft.App namnrymderna och Microsoft.OperationalInsights .
az provider register --namespace Microsoft.App
az provider register --namespace Microsoft.OperationalInsights
Skapa miljövariabler
Nu när CLI-installationen är klar kan du definiera de miljövariabler som används i hela den här artikeln.
Definiera följande variabler i bash-gränssnittet.
export RESOURCE_GROUP="album-containerapps"
export LOCATION="canadacentral"
export ENVIRONMENT="env-album-containerapps"
export API_NAME="album-api"
Hämta exempelkoden
Kör följande kommando för att klona exempelprogrammet på önskat språk och ändra till projektkällmappen.
git clone https://github.com/azure-samples/containerapps-albumapi-csharp.git
cd containerapps-albumapi-csharp/src
Skapa och distribuera containerappen
Kör först följande kommando för att skapa den resursgrupp som ska innehålla de resurser som du skapar i den här snabbstarten.
az group create --name $RESOURCE_GROUP --location $LOCATION
Skapa och distribuera din första containerapp med containerapp up kommandot . Det här kommandot kommer att:
- Skapa resursgruppen
- Skapa ett Azure Container Registry
- Skapa containeravbildningen och skicka den till registret
- Skapa Container Apps-miljön med en Log Analytics-arbetsyta
- Skapa och distribuera containerappen med den skapade containeravbildningen
Kommandot up använder Dockerfile i projektmappen för att skapa containeravbildningen. Instruktionen EXPOSE i Dockerfile definierar målporten, som är den port som används för att skicka inkommande trafik till containern.
I följande kodexempel . anger containerapp up (punkt) att den ska köras i den aktuella katalogen i projektet som också innehåller Dockerfile.
az containerapp up \
--name $API_NAME \
--resource-group $RESOURCE_GROUP \
--location $LOCATION \
--environment $ENVIRONMENT \
--source .
Kommentar
Om kommandot returnerar ett fel med meddelandet "AADSTS50158: Extern säkerhetsutmaning inte uppfylld" kör du az login --scope https://graph.microsoft.com//.default för att logga in med de behörigheter som krävs och kör az containerapp up sedan kommandot igen.
Verifiera distributionen
Leta upp containerappens URL i kommandots az containerapp up utdata. Gå till URL:en i webbläsaren. Lägg till /albums i slutet av URL:en för att se svaret från API:et.
Gränser
Den maximala storleken för uppladdning av källkod är 200 MB. Om uppladdningen överskrider gränsen returneras fel 413.
Rensa resurser
Om du inte ska fortsätta med självstudien Distribuera en klientdel kan du ta bort de Azure-resurser som skapades under den här snabbstarten med följande kommando.
Varning
Följande kommando tar bort den angivna resursgruppen och alla resurser som ingår i den. Om gruppen innehåller resurser utanför omfånget för den här snabbstarten tas de också bort.
az group delete --name $RESOURCE_GROUP
Dricks
Har du problem? Meddela oss på GitHub genom att öppna ett problem i Azure Container Apps-lagringsplatsen.
Nästa steg
När du har slutfört den här snabbstarten kan du fortsätta till Självstudie: Kommunikation mellan mikrotjänster i Azure Container Apps för att lära dig hur du distribuerar ett klientdelsprogram som anropar API:et.