Java 및 IntelliJ를 사용 하 여 첫 번째 Azure function 만들기Create your first Azure function with Java and IntelliJ

이 문서에서는 다음을 안내합니다.This article shows you:

  • IntelliJ IDEA 및 Apache Maven을 사용하여 서버리스 함수 프로젝트를 만드는 방법How to create a serverless function project with IntelliJ IDEA and Apache Maven
  • 개발자 컴퓨터의 IDE(통합 개발 환경)에서 함수를 테스트 및 디버깅하는 단계Steps for testing and debugging the function in the integrated development environment (IDE) on your own computer
  • Azure Functions에 함수 프로젝트를 배포하기 위한 지침Instructions for deploying the function project to Azure Functions

Azure 구독이 아직 없는 경우 시작하기 전에 체험 계정을 만듭니다.If you don't have an Azure subscription, create a free account before you begin.

개발 환경 설정Set up your development environment

Java 및 IntelliJ를 사용하여 함수를 개발하려면 다음 소프트웨어를 설치합니다.To develop a function with Java and IntelliJ, install the following software:

중요

이 문서의 단계를 완료하려면 JAVA_HOME 환경 변수를 JDK 설치 위치로 설정해야 합니다.The JAVA_HOME environment variable must be set to the install location of the JDK to complete the steps in this article.

Azure Functions Core Tools 버전 2를 설치하는 것이 좋습니다.We recommend that you install Azure Functions Core Tools, version 2. 이 버전은 Azure Functions의 작성, 실행 및 디버깅을 위한 로컬 개발 환경을 제공합니다.It provides a local development environment for writing, running, and debugging Azure Functions.

Functions 프로젝트 만들기Create a Functions project

  1. IntelliJ IDEA에서 새 프로젝트 만들기를 선택합니다.In IntelliJ IDEA, select Create New Project.
  2. 새 프로젝트 창의 왼쪽 창에서 Maven을 선택합니다.In the New Project window, select Maven from the left pane.
  3. archetype에서 만들기 확인란을 선택한 다음, azure-functions-archetype으로 Archetype 추가를 선택합니다.Select the Create from archetype check box, and then select Add Archetype for the azure-functions-archetype.
  4. Archetype 추가 창에서 다음과 같이 필드를 완성합니다.In the Add Archetype window, complete the fields as follows:
  5. 확인을 선택하고 다음을 선택합니다.Select OK, and then select Next.
  6. 현재 프로젝트에 대한 세부 정보를 입력하고 완료를 선택합니다.Enter your details for current project, and select Finish.

Maven은 이름이 ArtifactId 값인 새 폴더에 프로젝트 파일을 만듭니다.Maven creates the project files in a new folder with the same name as the ArtifactId value. 프로젝트에서 생성된 코드는 HTTP 트리거 요청의 본문을 에코하는 간단한 HTTP 트리거 함수입니다.The project's generated code is a simple HTTP-triggered function that echoes the body of the triggering HTTP request.

IDE에서 로컬로 함수 실행Run functions locally in the IDE

참고

로컬로 함수를 실행하고 디버그하려면 Azure Functions Core Tools 버전 2를 설치해야 합니다.To run and debug functions locally, make sure you've installed Azure Functions Core Tools, version 2.

  1. 변경 내용을 수동으로 가져오거나 자동 가져오기를 사용합니다.Import changes manually or enable auto import.

  2. Maven 프로젝트 도구 모음을 엽니다.Open the Maven Projects toolbar.

  3. 수명 주기를 확장하고 패키지를 엽니다.Expand Lifecycle, and then open package. 새로 만든 대상 디렉터리에 솔루션이 빌드 및 패키징됩니다.The solution is built and packaged in a newly created target directory.

  4. 플러그 인 > azure-functions를 확장하고 azure-functions:run을 열어 Azure Functions 로컬 런타임을 시작합니다.Expand Plugins > azure-functions and open azure-functions:run to start the Azure Functions local runtime.
    Azure Functions에 대한 Maven 도구 모음Maven toolbar for Azure Functions

  5. 함수 테스트를 완료했으면 실행 대화 상자를 닫습니다.Close the run dialog box when you're done testing your function. 한 번에 하나의 함수 호스트만 활성화되고 로컬로 실행될 수 있습니다.Only one function host can be active and running locally at a time.

IntelliJ에서 함수 디버그Debug the function in IntelliJ

  1. 디버그 모드로 함수 호스트를 시작하려면 함수를 실행할 때 인수로 -DenableDebug를 추가합니다.To start the function host in debug mode, add -DenableDebug as the argument when you run your function. maven 목표에서 구성을 변경하거나 터미널 창에서 다음 명령을 실행할 수 있습니다.You can either change the configuration in maven goals or run the following command in a terminal window:

    mvn azure-functions:run -DenableDebug
    

    이 명령을 사용하면 함수 호스트가 5005에서 디버그 포트를 엽니다.This command causes the function host to open a debug port at 5005.

  2. 실행 메뉴에서 구성 편집을 선택합니다.On the Run menu, select Edit Configurations.

  3. (+) 를 선택하여 원격을 추가합니다.Select (+) to add a Remote.

  4. 이름설정 필드를 완료한 다음, 확인을 선택하여 구성을 저장합니다.Complete the Name and Settings fields, and then select OK to save the configuration.

  5. 설정이 끝나면 디버그 < 원격 구성 이름 > 를 선택하거나 키보드에서 Shift+F9를 눌러 디버깅을 시작합니다.After setup, select Debug < Remote Configuration Name > or press Shift+F9 on your keyboard to start debugging.

    IntelliJ에서 함수 디버깅

  6. 디버깅이 끝나면 디버거 및 실행 중인 프로세스를 중지합니다.When you're finished, stop the debugger and the running process. 한 번에 하나의 함수 호스트만 활성화되고 로컬로 실행될 수 있습니다.Only one function host can be active and running locally at a time.

Azure에 함수 배포Deploy the function to Azure

  1. 함수를 Azure에 배포 하려면 먼저 Azure CLI를 사용 하 여 로그인해야 합니다.Before you can deploy your function to Azure, you must sign in by using the Azure CLI.

    az login
    
  2. azure-functions:deploy Maven 대상을 사용하여 새 함수에 코드를 배포합니다.Deploy your code into a new function by using the azure-functions:deploy Maven target. Maven 프로젝트 창에서 azure-functions:deploy 옵션을 선택할 수도 있습니다.You can also select the azure-functions:deploy option in the Maven Projects window.

    mvn azure-functions:deploy
    
  3. 함수가 성공적으로 배포된 후 Azure CLI 출력에서 함수 URL을 찾습니다.Find the URL for your function in the Azure CLI output after the function has been successfully deployed.

    [INFO] Successfully deployed Function App with package.
    [INFO] Deleting deployment package from Azure Storage...
    [INFO] Successfully deleted deployment package fabrikam-function-20170920120101928.20170920143621915.zip
    [INFO] Successfully deployed Function App at https://fabrikam-function-20170920120101928.azurewebsites.net
    [INFO] ------------------------------------------------------------------------
    

다음 단계Next steps

  • Java 함수 개발에 대한 자세한 내용은 Java 함수 개발자 가이드를 참조합니다.Review the Java Functions developer guide for more information on developing Java functions.
  • azure-functions:add Maven 대상을 사용하여 다른 트리거가 있는 함수를 프로젝트에 추가합니다.Add additional functions with different triggers to your project by using the azure-functions:add Maven target.