자습서: VNet에서 Azure Database for MySQL - 유연한 서버를 사용하여 AKS 클러스터에 Spring Boot 애플리케이션 배포

적용 대상: Azure Database for MySQL - 유연한 서버

이 자습서에서는 Azure Virtual Network 내에서 서로 안전하게 통신하면서 백 엔드에서 Azure Database for MySQL 유연한 서버를 사용하여 AKS(Azure Kubernetes Service) 클러스터에 Spring Boot 애플리케이션을 배포하는 방법을 알아봅니다.

참고 항목

이 자습서에서는 Kubernetes 개념, Java Spring Boot 및 MySQL에 대한 기본 지식이 있다고 가정합니다. Spring Boot 애플리케이션의 경우 Azure Spring Apps를 사용하는 것이 좋습니다. 그러나 여전히 Azure Kubernetes Services를 대상으로 사용할 수 있습니다. 자세한 내용은 Java 워크로드 대상 지침을 참조하세요.

필수 조건

• Azure 구독 Azure 구독이 아직 없는 경우 시작하기 전에 Azure 체험 계정을 만듭니다. 현재 Azure 무료 계정을 사용하면 Azure Database for MySQL - 유연한 서버를 12개월 동안 무료로 사용해 볼 수 있습니다. 자세한 내용은 Azure Database for MySQL - 유연한 서버를 무료로 사용해 보기를 참조하세요.
• Azure CLI(명령줄 인터페이스)
• 지원되는 Java Development Kit 버전 8(Azure Cloud Shell에 포함됨)입니다.
• Apache Maven 빌드 도구.
• Git 클라이언트
• Docker 클라이언트

Azure Database for MySQL 유연한 서버 만들기

리소스 그룹 만들기

Azure 리소스 그룹은 Azure 리소스가 배포되고 관리되는 논리 그룹입니다. eastus 위치에서 az group create 명령을 사용하여 mysqlaksdemo 리소스 그룹을 만들어 보겠습니다.

1. 명령 프롬프트를 엽니다.
2. Azure 계정에 로그인합니다.

   az login
   

3. Azure 구독을 선택합니다.

   az account set -s <your-subscription-ID>
   

4. 리소스 그룹을 만듭니다.

   az group create --name rg-mysqlaksdemo --location eastus
   

Azure Database for MySQL 유연한 서버 인스턴스 만들기

이제 가상 네트워크에서 Azure Database for MySQL 유연한 서버 인스턴스를 만듭니다(프라이빗 액세스 연결 방법).

1. 이 자습서의 모든 리소스에 대해 Azure Virtual Network vnet-mysqlaksdemo를 만들고 Azure Database for MySQL 유연한 서버 인스턴스에 대해 서브넷 subnet-mysql을 만듭니다.

   az network vnet create \
   --resource-group rg-mysqlaksdemo \
   --name vnet-mysqlaksdemo \
   --address-prefixes 155.55.0.0/16 \
   --subnet-name subnet-mysql \
   --subnet-prefix 155.55.1.0/24 
   

2. az mysqlflex-server create 명령을 사용하여 위에서 만들어진 서브넷에 Azure Database for MySQL 유연한 서버 인스턴스 mysql-mysqlaksdemo를 만듭니다. 관리자 사용자 이름 및 암호에 대한 값을 바꿉니다.

   az mysql flexible-server create \
   --name mysql-mysqlaksdemo \
   --resource-group rg-mysqlaksdemo \
   --location eastus \
   --admin-user <your-admin-username> \
   --admin-password <your-admin-password> \
   --vnet vnet-mysqlaksdemo \
   --subnet subnet-mysql
   

   이제 Burstable B1MS 컴퓨팅, 32GB 스토리지, 7일 백업 보존 기간 및 제공된 서브넷 subnet-mysql을 사용하여 eastus 지역에 Azure Database for MySQL 유연한 서버 인스턴스를 만들었습니다. 이 서브넷은 다른 리소스를 배포하지 않아야 하고, Microsoft.DBforMySQL/flexibleServers에 위임됩니다.

3. Spring Boot 애플리케이션과 함께 사용할 새 Azure Database for MySQL 유연한 서버 데이터베이스 demo를 구성합니다.

   az mysql flexible-server db create \
   --resource-group rg-mysqlaksdemo \
   --server-name mysql-mysqlaksdemo \
   --database-name demo
   

Azure Container Registry 만들기

리소스 그룹에서 프라이빗 Azure Container Registry를 만듭니다. 이 자습서는 이후 단계에서 샘플 앱을 이 레지스트리에 Docker 이미지로 푸시합니다. mysqlaksdemoregistry를 레지스트리의 고유한 이름으로 바꿉니다.

az acr create --resource-group rg-mysqlaksdemo \
--location eastus \
--name mysqlaksdemoregistry \
--sku Basic

애플리케이션 코딩

이 섹션에서는 데모 애플리케이션을 코딩합니다. 더 빠르게 진행하려면 https://github.com/Azure-Samples/tutorial-springboot-mysql-aks에서 사용 가능한 코딩된 애플리케이션을 다운로드하고 다음 섹션(이미지를 빌드하고 ACR로 푸시)으로 건너뛰면 됩니다.

1. Spring Initializr를 사용하여 애플리케이션을 생성합니다.

   curl https://start.spring.io/starter.tgz \
   -d dependencies=web,data-jdbc,mysql \
   -d baseDir=springboot-mysql-aks \
   -d bootVersion=2.5.6.RELEASE \
   -d artifactId=springboot-mysql-aks \
   -d description="Spring Boot on AKS connecting to Azure DB for MySQL" \
   -d javaVersion=1.8 | tar -xzvf -
   

   기본 Spring Boot 애플리케이션은 springboot-mysql-aks 폴더 내에 생성됩니다.

   다음 단계에서는 VSCode 또는 IDE와 같은 원하는 텍스트 편집기를 사용합니다.

2. Azure Database for MySQL 유연한 서버를 사용하도록 Spring Boot 구성

   src/main/resources/application.properties 파일을 열고 아래 코드 조각을 추가합니다. 이 코드는 Kubernetes 매니페스트 파일에서 데이터베이스 호스트, 데이터베이스 이름, 사용자 이름 및 암호를 읽습니다.

   logging.level.org.springframework.jdbc.core=DEBUG
   spring.datasource.url=jdbc:mysql://${DATABASE_HOST}:3306/${DATABASE_NAME}?serverTimezone=UTC
   spring.datasource.username=${DATABASE_USERNAME}
   spring.datasource.password=${DATABASE_PASSWORD}
   spring.datasource.initialization-mode=always
   

   Warning

   spring.datasource.initialization-mode=always 구성 속성은 서버가 시작될 때마다 Spring Boot에서 나중에 만들 schema.sql 파일을 사용하여 데이터베이스 스키마를 자동으로 생성함을 의미합니다. 이는 테스트에 유용하지만, 다시 시작할 때마다 데이터가 삭제되므로 프로덕션에서 사용하면 안 됩니다!

   참고 항목

   ?serverTimezone=UTC를 spring.datasource.url 구성 속성에 추가하여 데이터베이스에 연결할 때 UTC(협정 세계시) 날짜 형식을 사용하도록 JDBC 드라이버에 지시합니다. 그렇지 않으면 Java 서버에서 데이터베이스와 동일한 날짜 형식을 사용하지 않으므로 오류가 발생합니다.

3. 데이터베이스 스키마를 만듭니다.

   Spring Boot는 데이터베이스 스키마를 만들기 위해 src/main/resources/schema.sql를 자동으로 실행합니다. 다음 내용이 포함된 해당 파일을 만듭니다.

   DROP TABLE IF EXISTS todo;
   CREATE TABLE todo (id SERIAL PRIMARY KEY, description VARCHAR(255), details VARCHAR(4096), done BOOLEAN);
   

4. Java Spring Boot 애플리케이션을 코딩합니다.

   JDBC를 사용하여 MySQL 서버에서 데이터를 저장하고 검색하는 Java 코드를 추가합니다. DemoApplication 클래스 옆에 새 Todo Java 클래스를 만들고 다음 코드를 추가합니다.

   package com.example.springbootmysqlaks;
   
   import org.springframework.data.annotation.Id;
   
   public class Todo {
   
       public Todo() {
       }
   
       public Todo(String description, String details, boolean done) {
           this.description = description;
           this.details = details;
           this.done = done;
       }
   
       @Id
       private Long id;
   
       private String description;
   
       private String details;
   
       private boolean done;
   
       public Long getId() {
           return id;
       }
   
       public void setId(Long id) {
           this.id = id;
       }
   
       public String getDescription() {
           return description;
       }
   
       public void setDescription(String description) {
           this.description = description;
       }
   
       public String getDetails() {
           return details;
       }
   
       public void setDetails(String details) {
           this.details = details;
       }
   
       public boolean isDone() {
           return done;
       }
   
       public void setDone(boolean done) {
           this.done = done;
       }
   }
   

   이 클래스는 이전에 만든 todo 테이블에 매핑된 도메인 모델입니다.

   해당 클래스를 관리하려면 리포지토리가 필요합니다. 동일한 패키지에 새 TodoRepository 인터페이스를 정의합니다.

   package com.example.springbootmysqlaks;
   
   import org.springframework.data.repository.CrudRepository;
   
   public interface TodoRepository extends CrudRepository<Todo, Long> {
   }
   

   이 리포지토리는 Spring Data JDBC에서 관리하는 리포지토리입니다.

   데이터를 저장하고 검색할 수 있는 컨트롤러를 만들어 애플리케이션을 완성합니다. 동일한 패키지에 TodoController 클래스를 구현하고 다음 코드를 추가합니다.

   package com.example.springbootmysqlaks;
   
   import org.springframework.http.HttpStatus;
   import org.springframework.web.bind.annotation.*;
   
   @RestController
   @RequestMapping("/")
   public class TodoController {
   
       private final TodoRepository todoRepository;
   
       public TodoController(TodoRepository todoRepository) {
           this.todoRepository = todoRepository;
       }
   
       @PostMapping("/")
       @ResponseStatus(HttpStatus.CREATED)
       public Todo createTodo(@RequestBody Todo todo) {
           return todoRepository.save(todo);
       }
   
       @GetMapping("/")
       public Iterable<Todo> getTodos() {
           return todoRepository.findAll();
       }
   }
   

5. 기본 디렉터리 springboot-mysql-aks에 새 Dockerfile을 만들고 이 코드 조각을 복사합니다.

   FROM openjdk:8-jdk-alpine
   RUN addgroup -S spring && adduser -S spring -G spring
   USER spring:spring
   ARG DEPENDENCY=target/dependency
   COPY ${DEPENDENCY}/BOOT-INF/lib /app/lib
   COPY ${DEPENDENCY}/META-INF /app/META-INF
   COPY ${DEPENDENCY}/BOOT-INF/classes /app
   ENTRYPOINT ["java","-cp","app:app/lib/*","com.example.springbootmysqlaks.DemoApplication"]
   

6. pom.xml 파일로 이동하고 pom.xml 파일의 <properties> 컬렉션을 Azure Container Registry의 레지스트리 이름과 최신 버전의 jib-maven-plugin으로 업데이트합니다. 참고: ACR 이름에 대문자가 포함된 경우 소문자로 변환해야 합니다.

   <properties>
    	<docker.image.prefix>mysqlaksdemoregistry.azurecr.io</docker.image.prefix>
    	<jib-maven-plugin.version>3.1.4</jib-maven-plugin.version>
    	<java.version>1.8</java.version>
    </properties>
   

7. 아래와 같이 <plugin> 요소에 jib-maven-plugin에 대한 항목이 포함되도록 pom.xml 파일에서 <plugins> 컬렉션을 업데이트합니다. MCR(Microsoft Container Registry): mcr.microsoft.com/java/jdk:8-zulu-alpine의 기본 이미지를 사용하고 있으며, 여기에는 공식적으로 지원되는 Azure용 JDK가 포함됩니다. 공식적으로 지원되는 JDK가 포함된 다른 MCR 기본 이미지를 보려면 docker 허브를 참조하세요.

   <plugin>
       <artifactId>jib-maven-plugin</artifactId>
       <groupId>com.google.cloud.tools</groupId>
       <version>${jib-maven-plugin.version}</version>
       <configuration>
           <from>
               <image>mcr.microsoft.com/java/jdk:8-zulu-alpine</image>
           </from>
           <to>
               <image>${docker.image.prefix}/${project.artifactId}</image>
           </to>
       </configuration>
   </plugin>
   

이미지를 빌드하고 ACR에 푸시

명령 프롬프트에서 springboot-mysql-aks 폴더로 이동하고 다음 명령을 실행하여 먼저 Azure Container Registry의 기본 이름을 설정하고(그렇지 않으면 az acr login에 이름을 지정해야 함), 이미지를 빌드한 다음, 이미지를 레지스트리에 푸시합니다.

이 단계를 실행하는 동안 Docker 디먼이 실행 중인지 확인합니다.

az config set defaults.acr=mysqlaksdemoregistry
az acr login && mvn compile jib:build

AKS의 Kubernetes 클러스터 만들기

이제 가상 네트워크 vnet-mysqlaksdemo에 AKS 클러스터를 만듭니다.

이 자습서에서는 AKS에서 Azure CNI 네트워킹을 사용합니다. 대신 kubenet 네트워킹을 구성하려면 AKS에서 kubenet 네트워킹 사용을 참조하세요.

1. 사용할 AKS 클러스터에 대한 서브넷 subnet-aks를 만듭니다.

   az network vnet subnet create \
   --resource-group rg-mysqlaksdemo \
   --vnet-name vnet-mysqlaksdemo \
   --name subnet-aks \
   --address-prefixes 155.55.2.0/24
   

2. 서브넷 리소스 ID를 가져옵니다.

   SUBNET_ID=$(az network vnet subnet show --resource-group rg-mysqlaksdemo --vnet-name vnet-mysqlaksdemo --name subnet-aks --query id -o tsv)
   

3. ACR(Azure Container Registry) mysqlaksdemoregistry가 연결된 가상 네트워크에 AKS 클러스터를 만듭니다.

       az aks create \
       --resource-group rg-mysqlaksdemo \
       --name aks-mysqlaksdemo \
       --network-plugin azure \
       --service-cidr 10.0.0.0/16 \
       --dns-service-ip 10.0.0.10 \
       --docker-bridge-address 172.17.0.1/16 \
       --vnet-subnet-id $SUBNET_ID \
       --attach-acr mysqlaksdemoregistry \
       --dns-name-prefix aks-mysqlaksdemo \
       --generate-ssh-keys
   

   또한 다음 IP 주소 범위도 클러스터를 만드는 과정 중에 정의됩니다.

   • --service-cidr을 사용하여 AKS 클러스터의 내부 서비스에 IP 주소를 할당합니다. 다음 요구 사항을 충족하는 모든 프라이빗 주소 범위를 사용할 수 있습니다.

     • 클러스터의 가상 네트워크 IP 주소 범위에 속하지 않아야 합니다.
     • 클러스터 가상 네트워크가 피어링된 다른 가상 네트워크와 겹치지 않아야 합니다.
     • 온-프레미스 IP와 겹치지 않아야 합니다.
     • 169.254.0.0/16, 172.30.0.0/16, 172.31.0.0/16 또는 192.0.2.0/24 범위 내에 있지 않아야 합니다.

   • --dns-service-ip 주소는 클러스터의 DNS 서비스의 IP 주소입니다. 이 주소는 Kubernetes 서비스 주소 범위 내에 있어야 합니다. 주소 범위의 첫 번째 IP 주소를 사용하지 마세요. 서브넷 범위의 첫 번째 주소는 kubernetes.default.svc.cluster.local 주소에 사용됩니다.

   • --docker-bridge-address는 모든 Docker 설치에 있는 기본 docker0 브리지 네트워크 주소를 나타내는 Docker 브리지 네트워크 주소입니다. 클러스터의 서비스 CIDR과 Pod CIDR 등 네트워크의 나머지 CIDR과 충돌하지 않는 주소 공간을 선택합니다.

AKS 클러스터에 애플리케이션 배포

1. Azure Portal에서 AKS 클러스터 리소스로 이동합니다.

2. 리소스 보기(네임스페이스, 워크로드, 서비스 및 수신, 스토리지 또는 구성)에서 추가 및 YAML을 사용하여 추가를 선택합니다.

   

3. 다음 YAML을 붙여넣습니다. Azure Database for MySQL 유연한 서버 관리 사용자 이름 및 암호 값을 바꿉니다.

   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: springboot-mysql-aks
   spec:
     replicas: 1
     selector:
       matchLabels:
         app: springboot-mysql-aks
     template:
       metadata:
         labels:
           app: springboot-mysql-aks
       spec:
         containers:
         - name: springboot-mysql-aks
           image: mysqlaksdemoregistry.azurecr.io/springboot-mysql-aks:latest
           env:
           - name: DATABASE_HOST
             value: "mysql-mysqlaksdemo.mysql.database.azure.com"
           - name: DATABASE_USERNAME
             value: "<your-admin-username>"
           - name: DATABASE_PASSWORD
             value: "<your-admin-password>"
           - name: DATABASE_NAME    
             value: "demo"     
   ---
   apiVersion: v1
   kind: Service
   metadata:
     name: springboot-mysql-aks
   spec:
     type: LoadBalancer
     ports:
     - port: 80
       targetPort: 8080
     selector:
       app: springboot-mysql-aks
   

4. YAML 편집기의 맨 아래에 있는 추가를 선택하여 애플리케이션을 배포합니다.

   

5. YAML 파일이 추가되면 리소스 뷰어에 Spring Boot 애플리케이션이 표시됩니다. 외부 서비스에 포함된 연결된 외부 IP 주소를 기록해 둡니다.

   

애플리케이션 테스트

애플리케이션을 테스트할 때 cURL을 사용할 수 있습니다.

먼저 다음 명령을 사용하여 데이터베이스에 새 "todo" 항목을 만듭니다.

curl --header "Content-Type: application/json" \
--request POST \
--data '{"description":"configuration","details":"congratulations, you have deployed your application correctly!","done": "true"}' \
http://<AKS-service-external-ip>

다음으로, 새 cURL 요청을 사용하거나 브라우저에 클러스터 외부 IP를 입력하여 데이터를 검색합니다.

curl http://<AKS-service-external-ip>

이 명령은 생성된 항목을 포함한 "todo" 항목 목록을 반환합니다.

[{"id":1,"description":"configuration","details":"congratulations, you have deployed your application correctly!","done":true}]

이러한 cURL 요청의 스크린샷은 다음과 같습니다.

브라우저를 통해 유사한 출력을 볼 수 있습니다.

축하합니다! Azure Database for MySQL 유연한 서버를 백 엔드에 사용하는 AKS(Azure Kubernetes Service) 클러스터에 Spring Boot 애플리케이션을 성공적으로 배포했습니다.

리소스 정리

Azure 요금을 방지하려면 불필요한 리소스를 정리해야 합니다. 클러스터가 더 이상 필요하지 않은 경우 az group delete 명령을 사용하여 리소스 그룹, 컨테이너 서비스 및 모든 관련 리소스를 제거합니다.

az group delete --name rg-mysqlaksdemo

참고 항목

클러스터를 삭제해도 AKS 클러스터에서 사용하는 Microsoft Entra 서비스 주체는 제거되지 않습니다. 서비스 주체를 제거하는 방법에 대한 단계는 AKS 서비스 주체 고려 사항 및 삭제를 참조하세요. 관리 ID를 사용하는 경우 ID는 플랫폼에 의해 관리되며 제거할 필요가 없습니다.

다음 단계

Azure Database for MySQL 유연한 서버를 사용하여 AKS에 WordPress 앱 배포

Azure Database for MySQL 유연한 서버를 사용하여 PHP(Laravel) 웹앱 빌드