AKS로 쿠버네티스 시작하기 : 간단한 spring boot 앱 배포하기

broccoli 23.06.02

4,376 11 0

facebook twitter kakao link

11 0

facebook twitter kakao link

'AKS로 쿠버네티스 시작하기 : argocd툴에 ingress 통해 접속' 에 이어서

지난 블로그에서 argocd로 도메인명으로 쉽게 접속할 수 있게 되었습니다.

CI/CD 환경이 어느 정도 구성이 되었으니 현재까지 구성한 클러스터을 기반으로 간단한 앱을 배포해 보도록 하겠습니다.

지난 블로그 링크 : AKS로 쿠버네티스 시작하기 : argocd툴에 ingress 통해 접속

Spring Boot 애플리케이션 소스 준비

pom.xml, spring boot 소스, index.html 로 구성을 합니다.

pom.xml

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>3.1.0</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>
    <groupId>com.example</groupId>
    <artifactId>hellospring</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>hellospring</name>
    <description>hellospring</description>    <properties>
        <java.version>17</java.version>
    </properties>
    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
    </dependencies>
    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>
</project>

HellospringApplication.java

package com.example.hellospring;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
public class HellospringApplication {

    public static void main(String[] args) {
        SpringApplication.run(HellospringApplication.class, args);
    }

}

index.html

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>hello</title>
</head>
<body>
    <h1>hello, springboot working on k8s!!!</h1>
</body>
</html>

서비스 동작 확인

아래와 같이 8080 포트에서 서비스를 제공하는 것을 확인할 수 있습니다.

간단한 애플리케이션이 준비가 되었습니다. 로컬 환경에서 잘 동작하는 것이 확인이 되었습니다.

이번에는 CI/CD 자동화 이전에 Dockerfile을 활용하여 컨테이너 이미지를 만드는 과정을 포함해서 전체 세부 절차를 확인할 수 있는 내용으로 진행해 보겠습니다.

단계별 절차를 이해하면 자동화 시에도 자신의 환경에 맞게 최적화 구성을 할 수 있겠습니다.

로컬 환경에서 jar 기동 확인

Spring boot 의 특성상 내장형 톰캣 구조로 로컬 환경에서 아래의 java명령어로 jar로 생성된 애플리케이션을 동작시키는 것도 가능합니다.

로컬에서 잘 작동하는 지 먼저 확인하고 컨테이너 이미지를 작성하는 것을 권장합니다.

# 애플리케이션 빌드를 수행하면 target디렉토리에 jar 파일이 생성됩니다. 
# 해당 디렉토리에서 아래의 명령어를 수행하면 jar로 생성한 애플리케이션을 동작시킬 수 있습니다. 

$ java -jar *.jar

Dockerfile 만들기

애플리케이션 빌드환경과 일치하는 openjdk를 base로 해서 애플리케이션 패키징을 통해 생성한 jar파일을 app.jar로 복사한 다음 8080포트로 기동시키는 Dockerfile입니다.

- EXPOSE 8080 : 기동하는 컨테이너는 8080포트를 통해서 서비스 제공을 합니다.

- ENTRYPOINT를 통해서 컨테이너가 기동하면 java -jar app.jar 가 동작할 수 있도록 구성을 할 수 있습니다.

FROM openjdk:17-alpine3.14
WORKDIR /ARG JAR_FILE=*.jar
COPY ./target/${JAR_FILE} app.jar
EXPOSE 8080
ENTRYPOINT ["java", "-jar","/app.jar"]

애플리케이션 이미지 만들고 태깅하기

Dockerfile을 만든 애플리케이션 프로젝트 루트에서 podman build 명령어로 타겟 클러스터 플랫폼(리눅스) 맞게 acrapp.azurecr.io/hellospring:latest로 이미지를 만들고 태깅하여 생성합니다.

$ podman  build --platform linux/amd64  --tag acrapp.azurecr.io/hellospring:latest . 

STEP 1/6: FROM openjdk:17-alpine3.14
STEP 2/6: WORKDIR /
--> 241ccc727841
STEP 3/6: ARG JAR_FILE=*.jar
--> efe8fbff9872
STEP 4/6: COPY ./target/${JAR_FILE} app.jar
--> 5b38963da7df
STEP 5/6: EXPOSE 8080
--> 72ca8d7eaf0c
STEP 6/6: ENTRYPOINT ["java", "-jar","/app.jar"]
COMMIT acrapp.azurecr.io/hellospring:latest
--> ec212b7dca25
Successfully tagged acrapp.azurecr.io/hellospring:latest
ec212b7dca25e83f1b0e01a5bbd483888e0355abfbd98c67327103e30f57f0b8

ACR로 업로드하기

위에서 생성한 이미지(태깅포함)를 podman push 명령어로 ACR에 업로드 가능합니다.

$ podman push acrapp.azurecr.io/hellospring:latest

Service/Deployment yaml 파일 작성하기

ACR에 올려진 이미지를 이제 k8s클러스터에 배포할 차례입니다.

k8s에서는 해당 이미지를 사용하여 컨테이너를 구동시켜 서비스를 제공할 수 있게 하기 위해 service오브젝트와 deployment오브젝트를 yaml파일로 작성해야 합니다.

apiVersion: v1
kind: Service
metadata:
  name: svc-hellospring
  namespace: hellospring
spec:
  type: LoadBalancer
  ports:
    - name: http
      port: 8080
      targetPort: 8080
  selector:
    app: app-hellospring
---
apiVersion: apps/v1
kind: Deployment
metadata:
  name: deploy-hellospring
  namespace: hellospring
spec:
  replicas: 2
  selector:
    matchLabels:
      app: app-hellospring
  template:
    metadata:
      labels:
        app: app-hellospring
    spec:
      nodeSelector:
        "kubernetes.io/os": linux
      containers:
        - name: container-hellospring
          image: acrapp.azurecr.io/hellospring:latest
     
          resources:
            requests:
              cpu: 100m
              memory: 256Mi
            limits:
              cpu: 250m
              memory: 512Mi
          env:
            - name: TZ
              value: Asia/Seoul
          ports:
            - containerPort: 8080

작성한 Service/Deployment 을 k8s에 배포하기

k9s 툴을 띄워두고 kubectl apply -f <yaml 파일명> 명령어를 통해 배포하면 pod상태를 바로 확인할 수 있습니다.

혹시라도 pod 동작에 에러가 발생하면 k9s의 기능을 이용해서 디버깅도 가능합니다.

- 소문자 'l '키 : logs

- 'd' 키 : describe

- 참고로 위의 오른쪽 패널의 k apply 명령은 kubectl apply 를 의미합니다.(kubectl을 'k'로 alias 해서 사용)

배포한 서비스 확인

kubectl get svc -n 으로 서비스를 확인할 수 있습니다. (-n은 namespace를 의미)

여기서는 external IP가 20.196.228.89 입니다.

k get svc -n hellospring
NAME              TYPE           CLUSTER-IP    EXTERNAL-IP     PORT(S)          AGE
svc-hellospring   LoadBalancer   10.0.57.154   20.196.228.89   8080:30720/TCP   10m

해당 external IP로 접속해 보면 서비스 동작을 확인할 수 있습니다.

정리

소스작성 → 컴파일 → jar생성 → java -jar로 확인 → Dockerfile작성 → 컨테이너 이미지 생성과 태깅 → ACR에 업로드 → Service/Deployment yaml 작성 → k8s에 배포 순으로 전체 과정을 간단한 앱을 통해 진행해 보았습니다.

해당 절차를 응용하면 컨테이너 동작과 관련한 문제 발생에 단계적으로 확인하여 대응할 수 있습니다.

다음은

k8s 구성 최적화 측면과 k8s를 활용한 유용한 usecase 사례를 진행해 보도록 하겠습니다.

#Kubernetes #Spring #Docker #Azure

등록

DEVOTEE를 활성화 시키면
지금 작성한 댓글에 AI가 댓글을 달아줍니다.

익명

broccoli 님의 최신 블로그

LLM과 Reveal.js로 슬라이드를 쉽게 만들고 공유하기

블로그를 운영하다 보면 작성한 글을 슬라이드와 같은 형식으로 효과적으로 공유해야 할 때가 있습니다. 이럴 때마다 슬라이드를 처음부터 새로 만드는 것은 상당한 시간과 노력이 필요한 작업입니다. 하지만, LLM과 Reveal.js를 활용하면 작성한 글을 효율적으로 슬라이드로 변환하고, GitHub Pages를 통해 쉽게 게시하여 함께 볼 수 있습니다. 이 글에서는 그 과정에 대한 아이디어를 나누어 보도록 하겠습니다. 블로그 글을 슬라이드로 변환해야 하는 이유 블로그 글은 상세한 설명과 깊이 있는 내용을 담기에 적합한 형식이지만, 발표나 강연에서는 핵심 내용을 시각적으로 전달할 수 있는 슬라이드가 더 효과적입니다. 블로그 글을 슬라이드로 변환하면 유용한 상황들이 있습니...
빠르게 실행해 볼 수 있는 AI 시대 - 프로젝트에 투입해야 하는 서버

들어가는 말 빠르게 실행해볼 수 있는 AI 시대의 글로 이번에는 하드웨어 분야 서버에 관한 내용으로 공유해 보도록 하겠습니다. AI 기술의 발전은 우리 사회의 많은 영역에 변화를 가져오고 있으며, 특히 엔지니어링 전문 분야에서의 역할과 접근 방식에도 깊은 영향을 미치고 있습니다. 과거에는 특정 분야의 깊이 있는 전문성이 중요했지만, 이제는 AI를 통해 새로운 지식을 빠르게 습득하고 다양한 문제에 유연하게 대처하는 능력이 점차 중요해지고 있다고 말할 수 있을 것입니다. 온프레미스 환경에 노출된 개발자가 하드웨어를 다루는 과정의 내용을 통해 AI시대 엔지니어의 역할에 대해 생각해 볼 수 있는 기회가 되었으면 합니다. 예상치 못한 온프레미스 도전 풍부한 클라우드 환경에...
진짜 AI 에이전트형 코딩 툴 ＇Claude-Code＇

Claude Code 왜 지금 핫한가? Claude Code란? Claude Code는 Anthropic에서 개발한 AI 기반 코딩 에이전트입니다. 단순한 코드 자동 완성 기능을 넘어 자율적(agentic) 코딩을 지원하는 강력한 도구입니다. 2025년 현재, Claude Code는 개발자가 복잡한 소프트웨어 프로젝트를 계획하고, 작성하며, 디버깅하고, 배포하는 전 과정을 자동화하거나 간소화할 수 있도록 설계되었습니다. 기존 AI 코딩 도구(예: Copilot, Cursor)는 코드 자동완성‧스니펫 제안에 초점이 있지만, Claude Code는 전체 코드베이스를 실제로 탐색, 분석, 수정, 커밋, 푸시까지 ‘엔지니어처럼’ 처리하는 AI 도구입니다. 예를 들어, 사...
KVM 기반 VM의 외부 접근성 향상을 위한 브리지 네트워크 구성

들어가는 말 올해 프로젝트는 온프레미스 환경에서의 도전 과제들이 많이 발생되고 있습니다. 그 중의 하나로 외부 네트워크를 통해서 호스트에 접속한 후에 호스트에 구성된 KVM 기반의 VM에 접속하는 불편을 해결하는 요구사항에 대한 과제입니다. 즉, 외부에서도 VM(가상머신)에 직접 접속할 수 있는 방법의 제시가 필요합니다. 브리지 네트워크 구성 방식의 특징 브리지 네트워크는 KVM 기반 VM에 외부에서 접근할 때 일반적으로 선호되는 방식입니다. 직접적인 IP 할당 : 브리지 네트워크를 사용하면 VM이 호스트와 동일한 네트워크에 존재하게 되어, VM에 IP를 직접 할당할 수 있습니다. 이는 NAT(Network Address Translation) 방식과 달리, VM...

목록으로

DEVOCEAN

로그인 선택

미리보기

커뮤니티

글 등록

임시저장함

데보션 블로그 게재 요청