다음을 통해 공유

빠른 시작: Java Spring Boot 앱의 컨테이너 이미지를 빌드하고 Azure Container Registry에 푸시

이 빠른 시작을 사용하여 Java Spring Boot 앱의 컨테이너 이미지를 빌드하고 Maven 및 Jib를 사용하여 Azure Container Registry에 푸시할 수 있습니다. Maven 및 Jib는 개발자 도구를 사용하여 Azure 컨테이너 레지스트리와 상호 작용하는 한 가지 방법입니다.

필수 조건

Docker에서 Spring Boot 애플리케이션 만들기 및 빌드

다음 단계에서는 컨테이너화된 Java Spring Boot 웹 애플리케이션을 빌드하고 로컬로 테스트하는 과정을 안내합니다.

  1. 명령 프롬프트에서 다음 명령을 사용하여 Spring Boot on Docker 시작 샘플 프로젝트를 복제합니다.

    git clone https://github.com/spring-guides/gs-spring-boot-docker.git

  2. 디렉터리를 전체 프로젝트로 변경합니다.

    cd gs-spring-boot-docker/complete

  3. Maven을 사용하여 샘플 앱을 빌드하고 실행합니다.

    mvn package spring-boot:run

  4. http://localhost:8080으로 이동하거나 curl 명령을 사용하여 웹앱을 테스트합니다.

    curl http://localhost:8080

Hello Docker World 메시지가 표시됩니다.

Azure CLI를 사용하여 Azure Container Registry 만들기

이제, 다음 단계에 따라 Azure 리소스 그룹과 ACR을 만듭니다.

  1. 다음 명령을 사용하여 Azure 계정에 로그인합니다.

    az login

  2. 사용할 Azure 구독을 선택합니다.

    az account set -s <subscription ID>

  3. 이 자습서에서 사용되는 Azure 리소스에 대한 리소스 그룹을 만듭니다. 다음 명령에서 자리 표시자를 고유한 리소스 이름 및 위치(예: eastus)로 바꿔야 합니다.

    az group create \
    --name=<your resource group name> \
    --location=<location>

  4. 다음 명령을 사용하여 리소스 그룹에 프라이빗 Azure Container Registry를 만듭니다. 자리 표시자를 실제 값으로 바꿔야 합니다. 이 자습서는 이후 단계에서 샘플 앱을 이 레지스트리에 Docker 이미지로 푸시합니다.

    az acr create \
    --resource-group <your resource group name> \
    --location <location> \
    --name <your registry name> \
    --sku Basic

Jib을 통해 컨테이너 레지스트리에 앱 푸시

마지막으로 프로젝트 구성을 업데이트하고 명령 프롬프트를 사용하여 이미지를 빌드하고 배포합니다.

참고 항목

방금 만든 Azure 컨테이너 레지스트리에 로그인하려면 Docker 데몬을 실행해야 합니다. 머신에 Docker를 설치하기 위한 공식 Docker 설명서가 여기에 있습니다.

  1. 다음 명령을 사용하여 Azure CLI에서 Azure Container Registry에 로그인합니다. 자리 표시자를 고유의 레지스트리 이름으로 바꿔야 합니다.

    az config set defaults.acr=<your registry name>
az acr login

    az config 명령은 az acr 명령에 사용할 기본 레지스트리 이름을 설정합니다.

  2. Spring Boot 애플리케이션에 대해 완료된 프로젝트 디렉터리로 이동하고(예: "C:\SpringBoot\gs-spring-boot-docker\complete"또는"/users/robert/SpringBoot/gs-spring-boot-docker/complete") 텍스트 편집기를 사용하여 pom.xml 파일을 엽니다.

  3. pom.xml 파일의 <properties> 컬렉션을 다음 XML로 업데이트합니다. 자리 표시자를 레지스트리 이름으로 바꾸고 2.2.0 값 또는 jib-maven-plugin의 최신 버전으로 <jib-maven-plugin.version> 속성을 추가합니다.

    <properties>
   <docker.image.prefix><your registry name>.azurecr.io</docker.image.prefix>
   <java.version>1.8</java.version>
   <jib-maven-plugin.version>2.2.0</jib-maven-plugin.version>
</properties>

  4. 다음 예제와 같이 <plugin> 요소에 jib-maven-plugin에 대한 항목이 포함되도록 pom.xml 파일에서 <plugins> 컬렉션을 업데이트합니다. MCR(Microsoft Container Registry): mcr.microsoft.com/openjdk/jdk:11-ubuntu의 기본 이미지를 사용하고 있으며, 여기에는 공식적으로 지원되는 Azure용 JDK가 포함됩니다. 공식적으로 지원되는 JDK가 포함된 기타 MCR 기본 이미지는 OpenJDK의 Microsoft 빌드 설치를 참조하세요.

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

  5. Spring Boot 애플리케이션에 대한 전체 프로젝트 디렉터리로 이동하고, 다음 명령을 실행하여 이미지를 빌드하고 레지스트리로 푸시합니다.

    az acr login && mvn compile jib:build

참고 항목

보안상의 이유로 az acr login으로 만든 자격 증명은 1시간 동안만 유효 합니다. 401 권한 없음 오류가 발생하면 az acr login -n <your registry name> 명령을 다시 실행하여 다시 인증하면 됩니다.

컨테이너 이미지 확인

축하합니다! 이제 Azure 지원 JDK에서 컨테이너화된 Java 앱 빌드가 ACR로 푸시되었습니다. 이제 이미지를 Azure App Service에 배포하거나 명령(자리 표시자 대체)을 사용하여 로컬로 끌어와서 이미지를 테스트할 수 있습니다.

docker pull <your registry name>.azurecr.io/gs-spring-boot-docker

다음 단계

공식적인 Microsoft 지원 Java 기본 이미지의 다른 버전은 다음을 참조하세요.

Spring과 Azure에 대한 자세한 사항은 Azure의 Spring 설명서 센터를 참조합니다.

Azure의 Spring

추가 리소스

자세한 내용은 다음 리소스를 참조하세요.