Vytvoření aplikace funkcí v místním kontejneru Linuxu
V tomto článku se dozvíte, jak pomocí nástrojů Azure Functions Core vytvořit první funkci v kontejneru Linuxu na místním počítači, ověřit funkci místně a pak publikovat kontejnerizovanou funkci do registru kontejneru. Z registru kontejneru můžete snadno nasadit kontejnerizované funkce do Azure.
Úplný příklad nasazení kontejnerizovaných funkcí do Azure, který zahrnuje kroky v tomto článku, najdete v jednom z následujících článků:
- Vytvoření první kontejnerizované služby Azure Functions v Azure Container Apps
- Vytvoření první kontejnerizované služby Azure Functions
- Vytvoření první kontejnerizované služby Azure Functions ve službě Azure Arc (Preview)
Aplikaci funkcí můžete také vytvořit na webu Azure Portal pomocí existující kontejnerizované aplikace funkcí z registru kontejneru. Další informace najdete v tématu Vytváření pomocí kontejnerů na webu Azure Portal.
Zvolte vývojový jazyk
Nejprve pomocí nástrojů Azure Functions vytvoříte kód projektu jako aplikaci funkcí v kontejneru Dockeru pomocí základní image linuxové verze specifické pro jazyk. Ujistěte se, že jste v horní části článku vybrali jazyk podle svého výběru.
Core Tools automaticky vygeneruje soubor Dockerfile pro váš projekt, který používá nejaktuálnější verzi správné základní image pro váš jazyk funkcí. Kontejner byste měli pravidelně aktualizovat z nejnovější základní image a znovu nasadit z aktualizované verze kontejneru. Další informace najdete v tématu Vytváření kontejnerizovaných aplikací funkcí.
Požadavky
Než začnete, musíte mít splněné následující požadavky:
Nainstalujte Azure Functions Core Tools verze 4.0.5198 nebo novější.
- Nainstalujte nástroje Azure Functions Core Tools verze 4.x.
- Nainstalujte verzi Node.js podporovanou službou Azure Functions.
- Nainstalujte verzi Pythonu podporovanou službou Azure Functions.
Nainstalujte verzi sady Java Developer Kit , která je podporována službou Azure Functions.
Nainstalujte Apache Maven verze 3.0 nebo novější.
- Azure CLI verze 2.4 nebo novější.
Pokud ještě nemáte předplatné Azure, vytvořte si bezplatný účet Azure před tím, než začnete.
Pokud chcete publikovat image kontejnerizované aplikace funkcí, kterou vytvoříte do registru kontejneru, potřebujete ID Dockeru a Docker spuštěný na místním počítači. Pokud nemáte ID Dockeru, můžete vytvořit účet Dockeru.
K vytvoření instance registru musíte také dokončit oddíl Vytvořit registr kontejneru v rychlém startu Služby Container Registry. Poznamenejte si plně kvalifikovaný název přihlašovacího serveru.
Vytvoření a aktivace virtuálního prostředí
V vhodné složce spusťte následující příkazy pro vytvoření a aktivaci virtuálního prostředí s názvem .venv
. Nezapomeňte použít některou z verzí Pythonu podporovaných službou Azure Functions.
python -m venv .venv
source .venv/bin/activate
Pokud Python nenainstaloval balíček venv do distribuce Linuxu, spusťte následující příkaz:
sudo apt-get install python3-venv
V tomto aktivovaném virtuálním prostředí spustíte všechny následující příkazy.
Vytvoření a otestování projektu místních funkcí
V terminálu nebo příkazovém řádku spusťte následující příkaz pro vybraný jazyk a vytvořte projekt aplikace funkcí v aktuální složce:
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
V prázdné složce spusťte následující příkaz, který vygeneruje projekt Functions z archetypu Maven:
mvn archetype:generate -DarchetypeGroupId=com.microsoft.azure -DarchetypeArtifactId=azure-functions-archetype -DjavaVersion=8 -Ddocker
Parametr -DjavaVersion
říká modulu runtime Functions, kterou verzi Javy použít. Pokud chcete funkce spouštět ve verzi Java 11, použijte -DjavaVersion=11
. Pokud nezadáte -DjavaVersion
, Maven jako výchozí nastaví Javu 8. Další informace najdete v tématu Verze Javy.
Důležité
Aby JAVA_HOME
bylo možné dokončit tento článek, musí být proměnná prostředí nastavená na umístění instalace správné verze sady JDK.
Maven vás požádá o hodnoty potřebné k dokončení generování projektu při nasazení. Postupujte podle pokynů a zadejte následující informace:
Instrukce | Hodnota | Popis |
---|---|---|
groupId | com.fabrikam |
Hodnota, která jednoznačně identifikuje váš projekt ve všech projektech podle pravidel pojmenování balíčků pro Javu. |
artifactId | fabrikam-functions |
Hodnota, která je názvem souboru JAR bez čísla verze. |
version | 1.0-SNAPSHOT |
Vyberte výchozí hodnotu. |
balíček | com.fabrikam.functions |
Hodnota, která je balíčkem Java pro vygenerovaný kód funkce. Použijte výchozí hodnotu. |
Potvrďte zadáním Y
nebo stisknutím klávesy Enter.
Maven vytvoří soubory projektu v nové složce s názvem artifactId, což je fabrikam-functions
v tomto příkladu .
Tato --docker
možnost vygeneruje soubor Dockerfile pro projekt, který definuje vhodný kontejner pro použití se službou Azure Functions a vybraným modulem runtime.
Přejděte do složky projektu:
cd fabrikam-functions
Pomocí následujícího příkazu přidejte do projektu funkci, kde --name
argument je jedinečný název funkce a --template
argument určuje aktivační událost funkce. func new
vytvoří v projektu soubor kódu jazyka C#.
func new --name HttpExample --template "HTTP trigger"
Pomocí následujícího příkazu přidejte do projektu funkci, kde --name
argument je jedinečný název funkce a --template
argument určuje aktivační událost funkce. func new
vytvoří podsložku odpovídající názvu funkce, která obsahuje konfigurační soubor s názvem function.json.
func new --name HttpExample --template "HTTP trigger"
Pokud chcete funkci otestovat místně, spusťte místního hostitele modulu runtime Azure Functions v kořenové složce projektu.
func start
func start
npm install
npm start
mvn clean package
mvn azure-functions:run
Jakmile se koncový HttpExample
bod zapíše do výstupu, přejděte na tento koncový bod. Ve výstupu odpovědi by se měla zobrazit uvítací zpráva.
Jakmile se koncový HttpExample
bod zapíše do výstupu, přejděte na http://localhost:7071/api/HttpExample?name=Functions
. Prohlížeč musí zobrazit zprávu "hello", která se ozvěna zpět Functions
, hodnota zadaná parametru name
dotazu.
Stisknutím kláves Ctrl+C (Command+C v macOS) zastavte hostitele.
Sestavení image kontejneru a místní ověření
(Volitelné) Prozkoumejte soubor Dockerfile v kořenové složce projektu. Soubor Dockerfile popisuje požadované prostředí pro spuštění aplikace funkcí v Linuxu. Úplný seznam podporovaných základních imagí pro Azure Functions najdete na stránce základní image Azure Functions.
V kořenové složce projektu spusťte příkaz docker buildu , zadejte název jako azurefunctionsimage
a označte jako v1.0.0
. Položku <DOCKER_ID>
nahraďte ID vašeho účtu Docker Hubu. Tento příkaz sestaví image Dockeru pro kontejner.
docker build --tag <DOCKER_ID>/azurefunctionsimage:v1.0.0 .
Po dokončení příkazu můžete nový kontejner spustit místně.
Pokud chcete ověřit sestavení, spusťte image v místním kontejneru pomocí příkazu docker run , nahraďte <DOCKER_ID>
znovu ID účtu Docker Hubu a přidejte argument porty takto -p 8080:80
:
docker run -p 8080:80 -it <DOCKER_ID>/azurefunctionsimage:v1.0.0
Po spuštění obrázku v místním kontejneru přejděte na http://localhost:8080/api/HttpExample
, který musí zobrazit stejnou zprávu s pozdravem jako předtím. Vzhledem k tomu, že funkce aktivovaná protokolem HTTP, kterou jste vytvořili, používá anonymní autorizaci, můžete volat funkci spuštěnou v kontejneru, aniž byste museli získat přístupový klíč. Další informace najdete v tématu Autorizační klíče.
Po spuštění image v místním kontejneru přejděte na http://localhost:8080/api/HttpExample?name=Functions
příkaz , který musí zobrazit stejnou zprávu "hello" jako předtím. Vzhledem k tomu, že funkce aktivovaná protokolem HTTP, kterou jste vytvořili, používá anonymní autorizaci, můžete volat funkci spuštěnou v kontejneru, aniž byste museli získat přístupový klíč. Další informace najdete v tématu Autorizační klíče.
Po ověření aplikace funkcí v kontejneru ukončete spuštění stisknutím kláves Ctrl+C (Command+C v macOS).
Publikování image kontejneru do registru
Pokud chcete image kontejneru zpřístupnit pro nasazení do hostitelského prostředí, musíte ji odeslat do registru kontejneru.
Azure Container Registry je služba privátního registru pro vytváření, ukládání a správu imagí kontejnerů a souvisejících artefaktů. Pro publikování kontejnerů do služeb Azure byste měli použít službu privátního registru.
Pomocí tohoto příkazu se přihlaste k instanci registru pomocí aktuálních přihlašovacích údajů Azure:
az acr login --name <REGISTRY_NAME>
V předchozím příkazu nahraďte
<REGISTRY_NAME>
názvem vaší instance Container Registry.Pomocí tohoto příkazu označte image plně kvalifikovaným názvem přihlašovacího serveru registru:
docker tag <DOCKER_ID>/azurefunctionsimage:v1.0.0 <LOGIN_SERVER>/azurefunctionsimage:v1.0.0
Nahraďte
<LOGIN_SERVER>
plně kvalifikovaný název přihlašovacího serveru registru a<DOCKER_ID>
id Dockeru.Pomocí tohoto příkazu odešlete kontejner do instance registru:
docker push <LOGIN_SERVER>/azurefunctionsimage:v1.0.0