Azure Functions는 Azure Container Apps에서 컨테이너화된 함수 앱을 개발, 배포 및 관리하기 위한 통합 지원을 제공합니다. 이를 통해 AKS(Azure Kubernetes Service)와 같은 컨테이너 환경에서 Azure Functions를 독립적으로 실행하는 것에 비해 통합 Azure 관리 포털을 사용하여 Azure Functions를 더 쉽게 실행하고 관리할 수 있습니다. 또한 Azure Container Apps에서 제공하는 기능을 활용하면 Azure Functions에 대한 KEDA, Dapr, Envoy, 크기 조정, 모니터링, 보안 및 액세스 제어와 같은 기능을 쉽게 활용할 수 있습니다.

[참조]

Azure Functions의 Azure 컨테이너 앱 호스팅

Azure Container Apps에서 첫 번째 컨테이너화된 함수 만들기

환경 변수 설정

다음은 Azure Container Apps 리소스 생성과 관련된 환경 변수입니다. 여기에서는 생성할 리소스의 다양한 이름과 설치 위치는 물론 컨테이너 이미지 이름과 태그를 지정합니다.

# Azure Container Apps resource names
export LOCATION=eastus
export RESOURCE_GROUP_NAME=yoshio-rg
export CONTAINER_REGISTRY_NAME=cajava2411
export CONTAINER_ENVIRONMENT=YoshioContainerEnvironment
export STORAGE_NAME=yoshiojavastorage
export AZURE_FUNCTION_NAME=yoshiojavafunc

# Container image name and tag
export C_IMAGE_NAME=tyoshio2002/java-function-on-aca
export C_IMAGE_TAG=1.0

Java Azure 함수 프로젝트 생성 및 테스트

1. Java Maven 프로젝트용 Azure Functions 생성

먼저 Azure Functions for Java용 Maven 프로젝트를 만듭니다. 이 Maven 프로젝트는 Java 21을 사용하여 Azure Functions를 생성하도록 설계되었습니다. mvn archetype:generate 명령을 사용하여 프로젝트를 생성하고 필요에 따라 매개 변수를 수정합니다.

mvn archetype:generate \
-DinteractiveMode=false \
-DarchetypeGroupId=com.microsoft.azure \
-DarchetypeArtifactId=azure-functions-archetype \
-DgroupId=com.yoshio3 \
-Dpackage=com.yoshio3 \
-DartifactId=yoshiojavafunc \
-DappName=Java-Azure-Functions \
-DappRegion=$LOCATION \
-DjavaVersion=21 \
-Dversion=1.0-SNAPSHOT \
-Ddocker

위 명령을 실행하면 디렉터리 구조가 자동으로 생성되고 Function.java에는 HTTP 트리거가 있는 Azure 함수에 대한 샘플 코드가 포함됩니다. Docker 컨테이너 환경에서 Azure Functions를 실행하기 위한 구성이 포함된 Dockerfile도 생성됩니다.

├── Dockerfile
├── host.json
├── local.settings.json
├── pom.xml
└── src
    ├── main
    │   └── java
    │       └── com
    │           └── yoshio3
    │               └── Function.java
    └── test
        └── java
            └── com
                └── yoshio3
                    ├── FunctionTest.java
                    └── HttpResponseMessageMock.java

2. 로컬에서 Azure 함수 실행

Maven 프로젝트를 빌드하고 Azure Functions를 로컬에서 실행합니다. 다음 명령을 실행하여 HTTP 트리거로 Azure Functions를 시작합니다.

mvn clean package
mvn azure-functions:run

Azure Functions가 실행되면 다른 터미널을 열고 다음 명령을 실행하여 HTTP 트리거에 요청을 보냅니다. "Hello, World"라는 응답을 받아야 합니다.

curl "http://localhost:7071/api/HttpExample?name=World"
# Output: 
Hello, World

Azure Functions 컨테이너 이미지 생성 및 테스트

1. Docker 이미지 빌드 및 테스트

자동으로 생성된 Dockerfile을 사용하여 Azure Functions 컨테이너 이미지를 빌드합니다. 다음 명령을 실행하여 이미지를 빌드합니다.

docker build -t $C_IMAGE_NAME:$C_IMAGE_TAG -f ./Dockerfile .

빌드가 완료되면 다음 명령어를 실행하여 이미지가 생성되었는지 확인하세요.

docker images | grep $C_IMAGE_NAME
# Output: 
tyoshio2002/java-function-on-aca    1.0    bcf471e6f774   9 hours ago     1.46GB

이미지가 생성되면 다음 명령을 실행하여 Azure Functions 컨테이너 이미지를 로컬에서 테스트합니다. Azure Functions 컨테이너는 내부적으로 HTTP 포트 80을 사용하므로 로컬 액세스를 위해 포트 8080에 매핑합니다. 컨테이너가 시작된 후 컬 명령을 실행하여 Azure Functions HTTP 트리거에 요청을 보냅니다. 모든 것이 올바르게 작동하면 "Hello, World"라는 메시지가 표시됩니다.

docker run -p 8080:80 -it $C_IMAGE_NAME:$C_IMAGE_TAG
curl "http://localhost:8080/api/HttpExample?name=World"
# Output: 
Hello, World

컨테이너 이미지를 Azure Container Registry로 푸시

1. 애저 CLI에 로그인

먼저 Azure CLI를 사용하여 Azure에 로그인합니다. 다음 명령을 실행하여 로그인하세요.

az login

2. 리소스 그룹 생성

Azure에서 리소스 그룹을 만듭니다. 이 리소스 그룹은 Azure Container Registry 및 Azure Container Apps와 관련된 리소스를 그룹화하는 데 사용됩니다.

az group create --name $RESOURCE_GROUP_NAME --location $LOCATION

3. Azure Container Registry 생성 및 로그인

Azure Container Registry를 만들고 로그인합니다. Azure Container Registry는 컨테이너 이미지를 푸시하기 위한 프라이빗 컨테이너 레지스트리입니다.

az acr create --resource-group $RESOURCE_GROUP_NAME --name $CONTAINER_REGISTRY_NAME --sku Basic
az acr login --name $CONTAINER_REGISTRY_NAME

4. Azure Container Registry 서버 이름 검색

생성된 Azure Container Registry의 서버 이름을 검색합니다. 서버 이름은 $CONTAINER_REGISTRY_NAME.azurecr.io.
형식입니다.

CONTAINER_REGISTRY_SERVER=$(az acr show --name $CONTAINER_REGISTRY_NAME --query loginServer --output tsv)

5. 이미지를 Azure Container Registry에 푸시

로컬로 생성된 컨테이너 이미지를 Azure Container Registry에 푸시하려면 tag 명령을 사용하여 이미지에 태그를 지정합니다. 태그를 지정한 후 push 명령을 사용하여 이미지를 푸시합니다.

docker tag $C_IMAGE_NAME:$C_IMAGE_TAG $CONTAINER_REGISTRY_SERVER/$C_IMAGE_NAME:$C_IMAGE_TAG
docker push $CONTAINER_REGISTRY_SERVER/$C_IMAGE_NAME:$C_IMAGE_TAG

Azure 컨테이너 앱 생성 및 Java Azure 함수 배포

1. Azure CLI에 확장 및 리소스 공급자 등록

Azure CLI에서 Azure Container Apps를 만들고 관리하려면 필요한 확장 및 리소스 공급자를 등록하세요.

az upgrade
az extension add --name containerapp --upgrade -y
az provider register --namespace Microsoft.Web
az provider register --namespace Microsoft.App
az provider register --namespace Microsoft.OperationalInsights

2. Azure 컨테이너 앱 환경 생성

Azure Container Apps용 환경을 만듭니다. 이 명령은 Azure Container Apps를 호스팅하는 데 필요한 구성을 설정합니다.

az containerapp env create --name $CONTAINER_ENVIRONMENT --enable-workload-profiles --resource-group $RESOURCE_GROUP_NAME --location $LOCATION

3. Azure Functions용 ​​스토리지 계정 만들기

Azure Functions에는 함수 앱 인스턴스를 만들 때 스토리지 계정이 필요합니다. 따라서 Azure Functions에 대한 범용 스토리지 계정을 만듭니다.

az storage account create --name $STORAGE_NAME --location $LOCATION --resource-group $RESOURCE_GROUP_NAME --sku Standard_LRS

4. Azure 컨테이너 앱에서 Java Azure 함수 인스턴스 생성

Azure Container Apps에서 Java Azure 함수의 인스턴스를 만듭니다. 다음 명령을 실행하여 인스턴스를 생성합니다. Azure 함수는 Java 21을 사용하여 생성되므로 --runtime java.
를 지정합니다.

az functionapp create --name $AZURE_FUNCTION_NAME \
--resource-group $RESOURCE_GROUP_NAME \
--environment $CONTAINER_ENVIRONMENT \
--storage-account $STORAGE_NAME \
--workload-profile-name "Consumption" \
--max-replicas 15 \
--min-replicas 1 \
--functions-version 4 \
--runtime java \
--image $CONTAINER_REGISTRY_SERVER/$C_IMAGE_NAME:$C_IMAGE_TAG \
--assign-identity

5. Azure Container Registry에 액세스하기 위해 Azure 함수에 역할 할당

마지막으로 Azure Container Registry에 대한 Azure Functions의 보안 액세스를 구성합니다. Azure Functions에 대한 시스템 관리 ID를 활성화하고 액세스를 위해 ACRPull 역할을 할당합니다.

FUNCTION_APP_ID=$(az functionapp identity assign --name $AZURE_FUNCTION_NAME --resource-group $RESOURCE_GROUP_NAME --query principalId --output tsv)
ACR_ID=$(az acr show --name $CONTAINER_REGISTRY_NAME --query id --output tsv)
az role assignment create --assignee $FUNCTION_APP_ID --role AcrPull --scope $ACR_ID

6. Azure 함수의 URL을 검색합니다.

마지막으로 배포된 Azure 함수의 HTTP 트리거 함수 URL을 검색합니다. az functionapp function show 명령을 사용하여 Azure Functions 함수의 세부 정보를 가져옵니다.

az functionapp function show --resource-group $RESOURCE_GROUP_NAME --name $AZURE_FUNCTION_NAME --function-name HttpExample --query invokeUrlTemplate
# Output: "https://yoshiojavafunc.niceocean-********.eastus.azurecontainerapps.io/api/httpexample"

그런 다음 컬 명령을 사용하여 검색된 URL에 요청을 보내 Azure Functions가 올바르게 작동하는지 확인할 수 있습니다.

curl "https://yoshiojavafunc.niceocean-********.eastus.azurecontainerapps.io/api/httpexample?name=World"
# Expected Output: 
Hello, World

모든 것이 올바르게 설정되면 "Hello, World"라는 응답을 수신하여 Azure 함수가 예상대로 작동하는지 확인해야 합니다.

요약

이 가이드에서는 다음 방법을 배웠습니다.

1. Azure 리소스에 대한 환경 변수를 설정합니다.
2. Maven을 사용하여 Java Azure 함수 프로젝트를 만듭니다.
3. 테스트를 위해 로컬에서 Azure Function을 실행합니다.
4. Azure 함수용 Docker 이미지를 빌드합니다.
5. Docker 이미지를 Azure Container Registry에 푸시합니다.
6. Azure Container Apps 환경을 만들고 Java Azure 함수를 배포하세요.
7. Azure Container Registry에 안전하게 액세스하는 데 필요한 역할을 할당합니다.
8. 배포된 Azure 함수의 URL을 검색하고 테스트합니다.

다음 단계를 수행하면 컨테이너화의 이점과 Azure의 통합 관리 기능을 활용하여 Azure 컨테이너 앱에 Java Azure 함수를 성공적으로 배포할 수 있습니다. 추가 질문이 있거나 특정 단계에 대한 도움이 필요하면 언제든지 문의하세요!