Skapa en funktionsapp i en lokal Linux-container
Den här artikeln visar hur du använder Azure Functions Core-verktyg för att skapa din första funktion i en Linux-container på den lokala datorn, verifiera funktionen lokalt och sedan publicera den containerbaserade funktionen till ett containerregister. Från ett containerregister kan du enkelt distribuera dina containerbaserade funktioner till Azure.
Ett fullständigt exempel på hur du distribuerar containerbaserade funktioner till Azure, som innehåller stegen i den här artikeln, finns i någon av följande artiklar:
- Skapa dina första containerbaserade Azure Functions i Azure Container Apps
- Skapa dina första containerbaserade Azure Functions
- Skapa dina första containerbaserade Azure Functions på Azure Arc (förhandsversion)
Du kan också skapa en funktionsapp i Azure-portalen med hjälp av en befintlig containerbaserad funktionsapp från ett containerregister. Mer information finns i Skapa Azure-portalen med containrar.
Välj programmeringsspråk
Först använder du Azure Functions-verktyg för att skapa din projektkod som en funktionsapp i en Docker-container med hjälp av en språkspecifik Linux-basavbildning. Se till att välja valfritt språk överst i artikeln.
Core Tools genererar automatiskt en Dockerfile för projektet som använder den senaste versionen av rätt basavbildning för funktionsspråket. Du bör regelbundet uppdatera containern från den senaste basavbildningen och distribuera om från den uppdaterade versionen av containern. Mer information finns i Skapa containerbaserade funktionsappar.
Förutsättningar
Innan du börjar måste du ha följande krav på plats:
Installera Azure Functions Core Tools version 4.0.5198 eller en senare version.
- Installera Azure Functions Core Tools version 4.x.
- Installera en version av Node.js som stöds av Azure Functions.
- Installera en version av Python som stöds av Azure Functions.
Installera en version av Java Developer Kit som stöds av Azure Functions.
Installera Apache Maven version 3.0 eller senare.
- Azure CLI version 2.4 eller senare.
Om du inte har en Azure-prenumeration skapar du ett kostnadsfritt Azure-konto innan du börjar.
Om du vill publicera den containerbaserade funktionsappavbildningen som du skapar i ett containerregister behöver du ett Docker-ID och Docker som körs på den lokala datorn. Om du inte har något Docker-ID kan du skapa ett Docker-konto.
Du måste också slutföra avsnittet Skapa ett containerregister i snabbstarten containerregister för att skapa en registerinstans. Anteckna namnet på din fullständigt kvalificerade inloggningsserver.
Skapa och aktivera en virtuell miljö
I en lämplig mapp kör du följande kommandon för att skapa och aktivera en virtuell miljö med namnet .venv. Se till att använda någon av De Python-versioner som stöds av Azure Functions.
python -m venv .venv
source .venv/bin/activate
Om Python inte installerade venv-paketet på Linux-distributionen kör du följande kommando:
sudo apt-get install python3-venv
Du kör alla efterföljande kommandon i den här aktiverade virtuella miljön.
Skapa och testa projektet med lokala funktioner
I en terminal eller kommandotolk kör du följande kommando för det valda språket för att skapa ett funktionsappsprojekt i den aktuella mappen:
func init --worker-runtime dotnet-isolated --docker
func init --worker-runtime node --language javascript --docker
func init --worker-runtime powershell --docker
func init --worker-runtime python --docker
func init --worker-runtime node --language typescript --docker
I en tom mapp kör du följande kommando för att generera Functions-projektet från en Maven-arketyp:
mvn archetype:generate -DarchetypeGroupId=com.microsoft.azure -DarchetypeArtifactId=azure-functions-archetype -DjavaVersion=8 -Ddocker
Parametern -DjavaVersion talar om för Functions-körningen vilken version av Java som ska användas. Använd -DjavaVersion=11 om du vill att funktionerna ska köras på Java 11. När du inte anger -DjavaVersionanger Maven som standard Java 8. Mer information finns i Java-versioner.
Viktigt!
Miljövariabeln JAVA_HOME måste anges till installationsplatsen för rätt version av JDK för att slutföra den här artikeln.
Maven ber dig om de värden som behövs för att slutföra genereringen av projektet vid distributionen. Följ anvisningarna och ange följande information:
| Prompt | Värde | beskrivning |
|---|---|---|
| groupId | com.fabrikam |
Ett värde som unikt identifierar projektet i alla projekt, enligt namngivningsreglerna för paket för Java. |
| artifactId | fabrikam-functions |
Ett värde som är namnet på jar-filen, utan ett versionsnummer. |
| version | 1.0-SNAPSHOT |
Välj standardvärdet. |
| paket | com.fabrikam.functions |
Ett värde som är Java-paketet för den genererade funktionskoden. Använd standardvärdet. |
Skriv Y eller tryck på Retur för att bekräfta.
Maven skapar projektfilerna i en ny mapp med namnet artifactId, som i det här exemplet är fabrikam-functions.
Alternativet --docker genererar en Dockerfile för projektet, som definierar en lämplig container för användning med Azure Functions och den valda körningen.
Navigera till projektmappen:
cd fabrikam-functions
Använd följande kommando för att lägga till en funktion i projektet, där --name argumentet är det unika namnet på din funktion och --template argumentet anger funktionens utlösare. func new skapar en C#-kodfil i projektet.
func new --name HttpExample --template "HTTP trigger"
Använd följande kommando för att lägga till en funktion i projektet, där --name argumentet är det unika namnet på din funktion och --template argumentet anger funktionens utlösare. func new skapar en undermapp som matchar funktionsnamnet som innehåller en konfigurationsfil med namnet function.json.
func new --name HttpExample --template "HTTP trigger"
Om du vill testa funktionen lokalt startar du den lokala Azure Functions-körningsvärden i roten i projektmappen.
func start
func start
npm install
npm start
mvn clean package
mvn azure-functions:run
När slutpunkten har skrivits till utdata går du HttpExample till slutpunkten. Du bör se ett välkomstmeddelande i svarsutdata.
När du ser slutpunkten HttpExample som skrivits till utdata går du till http://localhost:7071/api/HttpExample?name=Functions. Webbläsaren måste visa ett "hello"-meddelande som ekar tillbaka Functions, värdet som anges till name frågeparametern.
Tryck på Ctrl+C (Kommando+C på macOS) för att stoppa värden.
Skapa containeravbildningen och verifiera lokalt
(Valfritt) Granska Dockerfile i roten för projektmappen. Dockerfile beskriver den miljö som krävs för att köra funktionsappen i Linux. Den fullständiga listan över basavbildningar som stöds för Azure Functions finns på basavbildningssidan för Azure Functions.
Kör kommandot docker build i rotprojektmappen, ange ett namn som azurefunctionsimageoch tagga som v1.0.0. Ersätt <DOCKER_ID> med ditt konto-ID för Docker Hub. Det här kommandot skapar Docker-avbildningen för containern.
docker build --tag <DOCKER_ID>/azurefunctionsimage:v1.0.0 .
När kommandot har slutförts kan du köra den nya containern lokalt.
Kontrollera bygget genom att köra avbildningen i en lokal container med kommandot docker run , ersätta <DOCKER_ID> igen med ditt Docker Hub-konto-ID och lägga till portargumentet som -p 8080:80:
docker run -p 8080:80 -it <DOCKER_ID>/azurefunctionsimage:v1.0.0
När avbildningen startar i den lokala containern bläddrar du till http://localhost:8080/api/HttpExample, som måste visa samma hälsningsmeddelande som tidigare. Eftersom den HTTP-utlösta funktion som du skapade använder anonym auktorisering kan du anropa funktionen som körs i containern utan att behöva hämta en åtkomstnyckel. Mer information finns i auktoriseringsnycklar.
När avbildningen startar i den lokala containern bläddrar du till http://localhost:8080/api/HttpExample?name=Functions, som måste visa samma "hello"-meddelande som tidigare. Eftersom den HTTP-utlösta funktion som du skapade använder anonym auktorisering kan du anropa funktionen som körs i containern utan att behöva hämta en åtkomstnyckel. Mer information finns i auktoriseringsnycklar.
När du har verifierat funktionsappen i containern trycker du på Ctrl+C (Kommando+C på macOS) för att stoppa körningen.
Publicera containeravbildningen till ett register
Om du vill göra containeravbildningen tillgänglig för distribution till en värdmiljö måste du skicka den till ett containerregister.
Azure Container Registry är en privat registertjänst för att skapa, lagra och hantera containeravbildningar och relaterade artefakter. Du bör använda en privat registertjänst för att publicera dina containrar till Azure-tjänster.
Använd det här kommandot för att logga in på registerinstansen med dina aktuella Azure-autentiseringsuppgifter:
az acr login --name <REGISTRY_NAME>I föregående kommando ersätter du
<REGISTRY_NAME>med namnet på containerregisterinstansen.Använd det här kommandot för att tagga avbildningen med det fullständigt kvalificerade namnet på registerinloggningsservern:
docker tag <DOCKER_ID>/azurefunctionsimage:v1.0.0 <LOGIN_SERVER>/azurefunctionsimage:v1.0.0Ersätt
<LOGIN_SERVER>med det fullständigt kvalificerade namnet på registerinloggningsservern och<DOCKER_ID>med ditt Docker-ID.Använd det här kommandot för att skicka containern till registerinstansen:
docker push <LOGIN_SERVER>/azurefunctionsimage:v1.0.0