자습서: Linux 및 Azure Cosmos DB에서 Azure App Service를 사용하여 Java Spring Boot Java 웹앱 빌드
참고 항목
Spring 애플리케이션의 경우 Azure Spring Apps를 사용하는 것이 좋습니다. 그러나 Azure App Service를 대상으로 계속 사용할 수 있습니다. 자세한 내용은 Java 워크로드 대상 지침을 참조하세요.
이 자습서에서는 Azure에서 Java 웹앱을 빌드하고, 구성하고, 배포하고, 크기를 조정하는 프로세스를 단계별로 설명합니다. 작업이 완료되면 Linux의 Azure App Service에서 실행되는 Azure Cosmos DB에 Spring Boot 애플리케이션 저장 데이터가 생성됩니다.
이 자습서에서는 다음을 하는 방법을 알아볼 수 있습니다.
- Azure Cosmos DB 데이터베이스를 만듭니다.
- 데이터베이스에 샘플 앱 연결 및 로컬로 테스트
- Azure에 샘플 앱 배포
- App Service에서 진단 로그 스트림
- 추가 인스턴스를 추가하여 샘플 앱 확장
Azure를 구독하고 있지 않다면 시작하기 전에 Azure 체험 계정을 만듭니다.
필수 조건
샘플 TODO 앱 복제 및 리포지토리 준비
이 자습서에서는 Spring 데이터 Azure Cosmos DB에서 지원되는 Spring REST API를 호출하는 웹 UI에서 샘플 할 일 목록 앱을 사용합니다. 앱의 코드는 GitHub에서 사용할 수 있습니다. Spring 및 Azure Cosmos DB를 사용하여 Java 앱을 작성하는 방법에 대한 자세한 내용은 Azure Cosmos DB for NoSQL을 사용한 Spring Boot Starter 자습서 및 Azure Cosmos DB용 Spring 데이터 빠른 시작을 참조하세요.
터미널에서 다음 명령을 실행하여 샘플 리포지토리를 복제하고 샘플 앱 환경을 설정합니다.
git clone --recurse-submodules https://github.com/Azure-Samples/e2e-java-experience-in-app-service-linux-part-2.git
cd e2e-java-experience-in-app-service-linux-part-2
yes | cp -rf .prep/* .
Azure Cosmos DB 만들기
구독에서 Azure Cosmos DB 데이터베이스를 만들려면 다음 단계를 수행합니다. 할 일 목록 앱을 실행하는 경우 이 데이터베이스에 연결되고 데이터를 저장하여 애플리케이션을 실행하는 위치에 상관없이 애플리케이션 상태를 유지합니다.
Azure CLI에 로그인하고 둘 이상의 로그인 자격 증명에 연결된 경우 필요에 따라 구독을 설정합니다.
az login az account set -s <your-subscription-id>Azure 리소스 그룹을 만들고 리소스 그룹 이름을 입력합니다.
az group create -n <your-azure-group-name> \ -l <your-resource-group-region>GlobalDocumentDB종류로 Azure Cosmos DB를 만듭니다. Azure Cosmos DB 인스턴스의 이름은 소문자만 사용해야 합니다. 명령의 응답에서documentEndpoint필드를 입력합니다.az cosmosdb create --kind GlobalDocumentDB \ -g <your-azure-group-name> \ -n <your-azure-COSMOS-DB-name-in-lower-case-letters>Azure Cosmos DB 키를 가져와서 앱에 연결합니다. 다음 단계에서 필요하므로
primaryMasterKey,documentEndpoint를 가까운 위치에 유지합니다.az cosmosdb keys list -g <your-azure-group-name> -n <your-azure-COSMOSDB-name>
TODO 앱 속성 구성
컴퓨터에서 터미널을 엽니다. 복제된 리포지토리에서 샘플 스크립트 파일을 복사하여 방금 만든 Azure Cosmos DB 데이터베이스에 대해 사용자 지정할 수 있습니다.
cd initial/spring-todo-app
cp set-env-variables-template.sh .scripts/set-env-variables.sh
즐겨찾는 편집기에서 .scripts/set-env-variables.sh를 편집하고 Azure Cosmos DB 연결 정보를 입력합니다. App Service Linux 구성의 경우 이전과 동일한 지역(your-resource-group-region) 및 Azure Cosmos DB 데이터베이스를 만들 때 사용된 리소스 그룹(your-azure-group-name)을 사용합니다. Azure 배포에서 웹앱 이름이 중복될 수 없으므로 고유한 WEBAPP_NAME을 선택합니다.
export COSMOSDB_URI=<put-your-COSMOS-DB-documentEndpoint-URI-here>
export COSMOSDB_KEY=<put-your-COSMOS-DB-primaryMasterKey-here>
export COSMOSDB_DBNAME=<put-your-COSMOS-DB-name-here>
# App Service Linux Configuration
export RESOURCEGROUP_NAME=<put-your-resource-group-name-here>
export WEBAPP_NAME=<put-your-Webapp-name-here>
export REGION=<put-your-REGION-here>
그런 다음, 스크립트를 실행합니다.
source .scripts/set-env-variables.sh
이러한 환경 변수는 할 일 목록 앱의 application.properties에서 사용됩니다. 속성 파일의 필드는 Spring 데이터에 대한 기본 리포지토리 구성을 설정합니다.
azure.cosmosdb.uri=${COSMOSDB_URI}
azure.cosmosdb.key=${COSMOSDB_KEY}
azure.cosmosdb.database=${COSMOSDB_DBNAME}
@Repository
public interface TodoItemRepository extends DocumentDbRepository<TodoItem, String> {
}
그런 다음, 샘플 앱은 com.microsoft.azure.spring.data.cosmosdb.core.mapping.Document에서 가져온 @Document 주석을 사용하여 Azure Cosmos DB에서 저장되고 관리될 엔터티 형식을 설정합니다.
@Document
public class TodoItem {
private String id;
private String description;
private String owner;
private boolean finished;
샘플 앱 실행
Maven을 사용하여 샘플을 실행합니다.
mvn package spring-boot:run
출력은 다음과 비슷합니다.
bash-3.2$ mvn package spring-boot:run
[INFO] Scanning for projects...
[INFO]
[INFO] ------------------------------------------------------------------------
[INFO] Building spring-todo-app 2.0-SNAPSHOT
[INFO] ------------------------------------------------------------------------
[INFO]
[INFO] SimpleUrlHandlerMapping - Mapped URL path [/webjars/**] onto handler of type [class org.springframework.web.servlet.resource.ResourceHttpRequestHandler]
[INFO] SimpleUrlHandlerMapping - Mapped URL path [/**] onto handler of type [class org.springframework.web.servlet.resource.ResourceHttpRequestHandler]
[INFO] WelcomePageHandlerMapping - Adding welcome page: class path resource [static/index.html]
2018-10-28 15:04:32.101 INFO 7673 --- [ main] c.m.azure.documentdb.DocumentClient : Initializing DocumentClient with serviceEndpoint [https://sample-cosmos-db-westus.documents.azure.com:443/], ConnectionPolicy [ConnectionPolicy [requestTimeout=60, mediaRequestTimeout=300, connectionMode=Gateway, mediaReadMode=Buffered, maxPoolSize=800, idleConnectionTimeout=60, userAgentSuffix=;spring-data/2.0.6;098063be661ab767976bd5a2ec350e978faba99348207e8627375e8033277cb2, retryOptions=com.microsoft.azure.documentdb.RetryOptions@6b9fb84d, enableEndpointDiscovery=true, preferredLocations=null]], ConsistencyLevel [null]
[INFO] AnnotationMBeanExporter - Registering beans for JMX exposure on startup
[INFO] TomcatWebServer - Tomcat started on port(s): 8080 (http) with context path ''
[INFO] TodoApplication - Started TodoApplication in 45.573 seconds (JVM running for 76.534)
앱이 시작되면 http://localhost:8080/ 링크를 사용하여 로컬로 Spring TODO 앱에 액세스할 수 있습니다.
“Started TodoApplication” 메시지 대신 예외가 표시되는 경우 이전 단계에서 bash 스크립트가 환경 변수를 제대로 내보냈는지, 생성한 Azure Cosmos DB 데이터베이스에 대한 값이 올바른지 확인합니다.
Azure 배포 구성
initial/spring-boot-todo 디렉터리에서 pom.xml 파일을 열고 다음 Azure Web App Plugin for Maven 구성을 추가합니다.
<plugins>
<!--*************************************************-->
<!-- Deploy to Java SE in App Service Linux -->
<!--*************************************************-->
<plugin>
<groupId>com.microsoft.azure</groupId>
<artifactId>azure-webapp-maven-plugin</artifactId>
<version>2.5.0</version>
<configuration>
<schemaVersion>v2</schemaVersion>
<!-- Web App information -->
<resourceGroup>${RESOURCEGROUP_NAME}</resourceGroup>
<appName>${WEBAPP_NAME}</appName>
<region>${REGION}</region>
<pricingTier>P1v2</pricingTier>
<!-- Java Runtime Stack for Web App on Linux-->
<runtime>
<os>linux</os>
<javaVersion>Java 8</javaVersion>
<webContainer>Java SE</webContainer>
</runtime>
<deployment>
<resources>
<resource>
<directory>${project.basedir}/target</directory>
<includes>
<include>*.jar</include>
</includes>
</resource>
</resources>
</deployment>
<appSettings>
<property>
<name>COSMOSDB_URI</name>
<value>${COSMOSDB_URI}</value>
</property>
<property>
<name>COSMOSDB_KEY</name>
<value>${COSMOSDB_KEY}</value>
</property>
<property>
<name>COSMOSDB_DBNAME</name>
<value>${COSMOSDB_DBNAME}</value>
</property>
<property>
<name>JAVA_OPTS</name>
<value>-Dserver.port=80</value>
</property>
</appSettings>
</configuration>
</plugin>
...
</plugins>
Linux의 App Service에 배포
mvn azure-webapp:deploy Maven 목표를 사용하여 Linux의 Azure App Service에 할 일 앱을 배포합니다.
# Deploy
bash-3.2$ mvn azure-webapp:deploy
[INFO] Scanning for projects...
[INFO]
[INFO] ------------------------------------------------------------------------
[INFO] Building spring-todo-app 2.0-SNAPSHOT
[INFO] ------------------------------------------------------------------------
[INFO]
[INFO] --- azure-webapp-maven-plugin:2.5.0:deploy (default-cli) @ spring-todo-app ---
Auth Type: AZURE_CLI
Default subscription: xxxxxxxxx
Username: xxxxxxxxx
[INFO] Subscription: xxxxxxxxx
[INFO] Creating App Service Plan 'ServicePlanb6ba8178-5bbb-49e7'...
[INFO] Successfully created App Service Plan.
[INFO] Creating web App spring-todo-app...
[INFO] Successfully created Web App spring-todo-app.
[INFO] Trying to deploy artifact to spring-todo-app...
[INFO] Successfully deployed the artifact to https://spring-todo-app.azurewebsites.net
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 02:19 min
[INFO] Finished at: 2019-11-06T15:32:03-07:00
[INFO] Final Memory: 50M/574M
[INFO] ------------------------------------------------------------------------
출력에는 배포된 애플리케이션의 URL이 포함됩니다(이 예제에서는 https://spring-todo-app.azurewebsites.net). 웹 브라우저에 이 URL을 복사하거나 터미널 창에서 다음 명령을 실행하여 앱을 로드할 수 있습니다.
explorer https://spring-todo-app.azurewebsites.net
주소 표시줄에는 원격 URL에서 실행 중인 앱이 표시됩니다.
진단 로그 스트림
App Service의 애플리케이션 코드 내부에서 생성된 콘솔 로그에 액세스하려면 Cloud Shell에서 다음 명령을 실행하여 진단 로깅을 켭니다.
az webapp log config --resource-group <resource-group-name> --name <app-name> --docker-container-logging filesystem --level Verbose
--level에 대한 가능한 값은 Error, Warning, Info 및 Verbose입니다. 각 후속 수준에는 이전 수준이 포함됩니다. 예를 들어 Error에는 오류 메시지만 포함하고 Verbose에는 모든 메시지를 포함합니다.
진단 로깅이 설정되면 다음 명령을 실행하여 로그 스트림을 확인합니다.
az webapp log tail --resource-group <resource-group-name> --name <app-name>
콘솔 로그가 즉시 표시되지 않으면 30초 후에 다시 확인합니다.
참고 항목
https://<app-name>.scm.azurewebsites.net/api/logs/docker의 브라우저에서 로그 파일을 검사할 수도 있습니다.
언제든지 로그 스트리밍을 중지하려면 Ctrl+C를 입력합니다.
할 일 앱 확장
다른 작업자를 추가하여 애플리케이션을 확장합니다.
az appservice plan update --number-of-workers 2 \
--name ${WEBAPP_PLAN_NAME} \
--resource-group <your-azure-group-name>
리소스 정리
다른 자습서에서 이러한 리소스가 필요하지 않으면(다음 단계 참조) Cloud Shell에서 다음 명령을 실행하여 삭제할 수 있습니다.
az group delete --name <your-azure-group-name> --yes
다음 단계
Java 개발자용 AzureSpring Boot, Azure Cosmos DB용 Spring Data, Azure Cosmos DB 및 App Service Linux
개발자 가이드에서 App Service on Linux의 Java 앱을 실행하는 방법에 대해 자세히 알아봅니다.
사용자 지정 도메인 및 인증서를 사용하여 앱을 보호하는 방법을 알아봅니다.