✅ 서브모듈 완전히 초기화하고 다시 셋팅

1. 서브모듈을 Git에서 먼저 제거

   git submodule deinit -f .
   

2. 서브모듈 디렉토리를 제거

   rm -rf .git/modules/<서브모듈_이름>
   rm -rf <서브모듈_디렉토리>
   

3. .gitmodules 파일 삭제

   rm .gitmodules
   

4. 인덱스에서 서브모듈 흔적 제거

   git rm --cached <서브모듈_디렉토리>
   

5. 커밋

   git commit -m "Remove submodule completely"
   

6. 새로운 서브모듈 추가 (필요한 경우)

   git submodule add <repo-url> <path>
   git commit -m "Add submodule"
   

🧠 정리하자면:

• 단순히 .gitmodules 파일만 지우면 안 되고,
• Git 내부의 서브모듈 정보 (.git/modules, 인덱스 등)도 같이 정리해줘야 해요.

k8s란?

**Kubernetes (k8s)**는 컨테이너화된 애플리케이션을 자동으로 배포, 확장, 관리해주는 오픈소스 컨테이너 오케스트레이션 플랫폼입니다. 구글에서 개발한 기술을 기반으로 CNCF(Cloud Native Computing Foundation)에 기부되었고, 현재는 클라우드 환경에서 가장 널리 사용되는 컨테이너 관리 시스템이에요.

핵심 개념 정리

• 컨테이너(Container): 애플리케이션과 그 실행 환경을 패키징한 단위 (주로 Docker 사용)
• Pod: Kubernetes의 가장 작은 배포 단위. 하나 이상의 컨테이너를 포함할 수 있어요.
• Node: 컨테이너가 실제로 실행되는 물리/가상 머신
• Cluster: 여러 노드로 구성된 Kubernetes의 전체 인프라
• Deployment: 애플리케이션의 원하는 상태(예: 몇 개의 복제본 유지 등)를 정의하고 관리
• Service: Pod에 접근할 수 있는 안정적인 네트워크 주소를 제공 (LoadBalancer, ClusterIP, NodePort 등)
• Ingress: 외부 트래픽을 내부 서비스로 라우팅해주는 HTTP(S) 레벨 라우터
• ConfigMap / Secret: 애플리케이션 설정 값이나 민감한 정보를 외부에서 주입

Kubernetes의 장점

• 자동화된 배포 및 롤백: 애플리케이션을 손쉽게 배포/업데이트하고, 문제 발생 시 자동으로 이전 버전으로 롤백 가능
• 자동 스케일링: 트래픽에 따라 Pod 수를 자동 조절 가능
• 자가 치유(Self-healing): 장애 난 컨테이너는 자동으로 다시 생성
• 서비스 디스커버리 및 로드 밸런싱: Pod 간 통신을 쉽게 할 수 있게 도와줌

간단한 동작 흐름

1. 사용자는 애플리케이션을 컨테이너(Docker)로 패키징
2. 이를 Kubernetes 클러스터에 배포
3. Kubernetes가 이를 적절한 Node에 스케줄링하고 실행
4. 서비스나 Ingress를 통해 외부 접근 가능

helm 이란?

Helm은 Kubernetes의 패키지 관리자입니다. 쉽게 말해서, Kubernetes에서 애플리케이션을 더 쉽고, 재사용 가능하게 배포할 수 있도록 도와주는 도구입니다. 마치 apt(Ubuntu), brew(macOS), npm(Node.js) 같은 느낌.

PreFlightCorsConfig example

@Configuration
public class PreFlightCorsConfig {

    private final CorsProperties corsProperties;

    public PreFlightCorsConfig(CorsProperties corsProperties) {
        this.corsProperties = corsProperties;
    }

    private static final String ALLOWED_HEADERS = "x-requested-with,authorization, refresh-token,Access-Control-Allow-Origin,Content-Type, credential,X-AUTH-TOKEN,X-CSRF-TOKEN";

    private static final String ALLOWED_METHODS = "GET, PUT, POST, PATCH, DELETE, OPTIONS";

    private static final String ALLOWED_CREDENTIALS = "true";

    // 중요 해당 헤더가 없다면 axios를 통한 프론트에서 확인이 불가능함
    private static final String EXPOSE_HEADERS = "*,Authorization,Refresh-token,authorization,refresh-token";

    private static final String MAX_AGE = "3600";

    @Bean
    public WebFilter corsFilter() {
        return (ServerWebExchange ctx, WebFilterChain chain) -> {
            ServerHttpRequest request = ctx.getRequest();
            String requestOrigin = request.getHeaders().getOrigin();

            if (CorsUtils.isPreFlightRequest(request)) {
                ServerHttpResponse response = ctx.getResponse();
                HttpHeaders headers = response.getHeaders();

                if (requestOrigin != null && corsProperties.getAllowedOrigins().contains(requestOrigin)) {
                    headers.add("Access-Control-Allow-Origin", requestOrigin);
                }

                headers.add("Access-Control-Allow-Methods", ALLOWED_METHODS);
                headers.add("Access-Control-Max-Age", MAX_AGE);
                headers.add("Access-Control-Allow-Headers", ALLOWED_HEADERS);
                headers.add("Access-Control-Allow-Credentials", ALLOWED_CREDENTIALS);
                headers.add("Access-Control-Expose-Headers", EXPOSE_HEADERS);

                // 프론트에서 해당 헤더를 확인할수잇게 허가해줌
                headers.add("Access-Control-Expose-Headers", EXPOSE_HEADERS);
                if (request.getMethod() == HttpMethod.OPTIONS) {
                    response.setStatusCode(HttpStatus.OK);
                    return Mono.empty();
                }
            }

            return chain.filter(ctx);
        };
    }
}

CorsProperties

@Component
@Getter
@Setter
@ConfigurationProperties(prefix = "app.cors")
public class CorsProperties {

    private List<String> allowedOrigins = new ArrayList<>();
}

설정

• dev, prod profile 별로 다르게 설정하는 게 일반적

# application-dev.yml
cors:
  allowed-origins:
    - "http://localhost:3000"
    - "http://127.0.0.1:3000"

# application-prod.yml
cors:
  allowed-origins:
    - "https://example.com"
    - "https://another-domain.com"

spspring-cloud-starter-gateway 사용시

Spring Cloud Gateway를 사용하고 있다면 PreFlightCorsConfig 같은 별도의 Java Config 없이도 application.yml에 설정만으로 CORS 처리가 가능합니다.**

Spring을 포함한 Java 기반 애플리케이션에서 **VO(Value Object)**와 **DTO(Data Transfer Object)**는 개념적으로 비슷해 보일 수 있지만, 그 목적과 사용하는 맥락에서 차이가 있습니다. 아래에 각각을 설명하고 차이를 정리할게요.

1. VO (Value Object)

• 의미: 값 자체를 표현하는 객체. 값의 동등성을 비교할 때, 객체의 참조가 아니라 값이 같은지로 판단합니다.
• 특징:
  • **불변(Immutable)**하게 설계하는 것이 일반적입니다.
  • equals(), hashCode()를 재정의해서 값이 같으면 동일한 객체로 간주합니다.
  • 주로 도메인 모델에서 사용되며, 특정 개념(예: 주소, 돈, 이름 등)을 캡슐화합니다.

public class Address {
    private final String city;
    private final String street;

    public Address(String city, String street) {
        this.city = city;
        this.street = street;
    }

    // equals, hashCode 반드시 재정의
}

2. DTO (Data Transfer Object)

• 의미: 계층 간 데이터 전달을 위해 사용하는 객체 (예: Controller → Service → Repository)
• 특징:
  • 불변일 필요 없음, Getter/Setter 있음
  • 단순히 데이터를 옮기는 목적 (로직이 없어야 함)
  • 보통 입력(Request), **출력(Response)**용으로 많이 쓰임

public class UserResponseDto {
    private String name;
    private String email;

    // 기본 생성자, getter/setter
}

정리: VO vs DTO

사용 예시

간단한 Spring 기반 애플리케이션 구조에서 VO와 DTO의 차이를 실제 예제 코드입니다. 예시는 “사용자(User) 정보 처리”를 중심으로 구성합니다.

JPA쿼리를 로그로 출력하기 위한 yml 설정

Spring Boot에서 JPA 쿼리를 로그로 출력하고 싶다면 application.yml 파일에 다음과 같은 설정을 추가하면 됩니다:

spring:
  jpa:
    show-sql: true # SQL 쿼리를 콘솔에 출력
    properties:
      hibernate:
        format_sql: true # SQL 쿼리를 보기 좋게 포맷
  logging:
    level:
      org.hibernate.SQL: debug         # 실행되는 SQL 로그
      org.hibernate.type.descriptor.sql.BasicBinder: trace # 바인딩되는 파라미터 값 로그

설명:

• show-sql: Hibernate가 실행하는 SQL을 표준 출력으로 보여줌 (간단한 로그).
• format_sql: SQL 쿼리를 읽기 쉽게 줄바꿈 및 들여쓰기.
• logging.level.org.hibernate.SQL: 더 상세한 SQL 로그 (로깅 프레임워크 통해 출력).
• logging.level.org.hibernate.type.descriptor.sql.BasicBinder: SQL에 바인딩되는 파라미터까지 출력하고 싶을 때 사용.

💡 파라미터 로그는 민감 정보가 노출될 수 있으니 운영 환경에서는 주의해서 사용하세요.

Spring Cloud Gateway에서 globalcors 설정

• 특정 URI 패턴에 대해서만 CORS를 허용하고 싶다면, 설정한 cors-configurations 키의 패턴을 세분화하면 됩니다.
• 현재는 ‘/**‘로 모든 경로에 대해 허용하고 있으므로, 이를 제한하려면 예를 들어 /api/public/** 처럼 특정 경로로 좁혀주면 됩니다.

Spring Cloud Gateway에서 globalcors 설정을 사용할 때 특정 URI 패턴에 대해서만 CORS를 허용하고 싶다면, 설정한 cors-configurations 키의 패턴을 세분화하면 됩니다. 현재는 '/\*\*'로 모든 경로에 대해 허용하고 있으므로, 이를 제한하려면 예를 들어 /api/public/** 처럼 특정 경로로 좁혀주면 됩니다.