꿀잠

프로젝트에 알림 기능이 요구 사항이 생겨 기능 구현을 하고 있었다.
Spring WebSocket Config 코드 작성과 프론트단에서 서버에 웹소켓 연결을 요청하는 코드를 완성한 후 테스트를 하였다.

클라이언트에서 소켓 연결 로그, 서버에서의 CONNECT 로그 모두 잘 찍혔다. 그러나 클라이언트에서 연결이 후 subscribe 를 설정하는 callback 함수 실행이 되지 않았다. 서버쪽에서도 API 로그가 전혀 찍히지 않았다.

엔드 포인트에 오타는 없는지, 문법이 잘못되지는 않았는지 한참을 찾았으나 원인을 찾지 못하다 원인을 찾게 되었다. 예상치 못한 부분이었기에 한참을 걸려 찾게 되었다. 

원인은 새로 작성한 코드 부분이 아니라 기존에 존재하던 스프링 설정에 있었다. 프로젝트의 구조 및 성능을 위해 Spring Bean을 Lazy Init 하도록 설정이 되어있는 부분이 있었고 해당 부분이 원인이었다. 

WebSocket 연결을 위해 WebSocket Config 에 웹소켓을 통해 subscribe 및 publish 를 위한 엔드포인트의 prefix를 설정하는 부분 및 여러가지 설정을 하는 부분이 있다. 엔드포인트를 설정하는 부분이 스프링이 실행될 때 Bean이 생성되며 설정되어야 하지만 Lazy Init 을 할 경우 해당 Bean이 웹소켓 엔드포인트 설정이 되어야하는 시점이 지난 이후 생성되는 것이었다. 

결국 lazy init 하는 부분에서 Websocket 관련 Bean 은 lazy 하지 않게 변경한 이후 정상적으로 테스트가 성공적으로 되는 것을 확인하였다.

요약: WebSocket 관련 Bean은 LazyInit 하면 안된다.

https://docs.aws.amazon.com/ko_kr/serverless-application-model/latest/developerguide/install-docker.html

# 패키지 ㅈ최신화
sudo yum update -y

# 도커 설치 시작
sudo yum install -y docker

# Docker 서비스 시작
sudo service docker start

# ec2-user가 docker 명령어 실행할 수 있도록 그룹에 추가
# 추가 이후 로그아웃 이후 로그인 해야 docker 명령어 사용가능
sudo usermod -a -G docker ec2-user

# 확인
docker ps 

@Test 어노테이션의 패키지를 확인해주자

import org.junit.jupiter.api.Test; // jupiter package, JUnit 5

@SpringBootTest

import org.junit.Test; // JUnit 4

@SpringBootTest
@RunWith(SpringRunner.class)

org.junit.jupiter.api.Test 패키지는 JUnit 5 를 사용하며 해당 어노테이션을 쓰지 않아도 동작하지만
org.junit.Test 패키지는 JUnit 4 를 사용하며 @RunWith(SpringRunner.class) 가 필수이다.

사이드 프로젝트 중 @Test 어노테이션 만으로도 동작하는 것을 확인하고 새로운 테스트 클래스를 만든 후에
스프링 빈이 주입되지 않아 당황하였다.
스프링 버젼 자체를 최신으로 해서 RunWith 어노테이션이 필요하지 않아진줄 알았지만
Test 어노테이션의 패키지가 영향을 준다는 사실을 확인했다.

커서 이동

• ctrl + a : 커서 맨 앞으로 이동 (Ahead)
• ctrl + e : 커서 맨 뒤로 이동 (End)
• ctrl + f : 커서 한 글자 다음으로 이동 (Foward)
• ctrl + b: 커서 한 글자 이전으로 이동 (Backword)
• alt + f : 커서 단어 하나 다음으로 이동 (Foward)
• alt + b : 커서 단어 하나 이전으로 이동 (Backword)
• ctrl + l : 화면 지우고 커서 화면 최상단 이동(cLear)

텍스트 편집

• ctrl + d : 커서 위치 글자 지우기 (Delete)
• ctrl + t : 커서 앞 글자와 위치 바꾸기 (Transmute)
• alt + t : 커서 위치 앞 단어 위치 바꾸기 (Transmute)
• alt + l : 커서 위치 있는 글자부터 그 단어 끝까지 소문자로 변경 (Lower)
• alt + u : 커서 위치 있는 글자부터 그 단어 끝까지 대문자로 변경 (Upper)

잘라내기 / 붙이기

• ctrl + k : 커서 줄 끝까지 잘라내기
• ctrl + u : 커서 그 줄 처음까지 잘라내기
• alt + d : 커서 단어 끝 부분까지 잘라내기
• alt + backspace : 커서 단어 앞 부분까지 잘라내기
• ctrl + y : 잘라낸 명령어 붙이기

docker-compose

# 전체 컨테이너 정지
docker-compose down

# 전체 컨테이너 실행
docker-compose up -d

# 특정 컨테이너 재실행 
docker-compose restart ${service-name}

docker hub

# 도커 허브에 로그인
docker login

# 도커 허브에 로그아웃
docker logout

# docker hub 에 올리기(push)
docker push ${repository}

docker

# 실행중인 도커 컨테이너 정보
docker ps 

# 이미지 목록보기
docker images

# 실행중인 도커 컨테이너 멈추기 ${name}은 ps 에서 확인가능
docker stop ${name}

# 현재 경로 도커 이미지 빌드(완료시 image id 획득)
docker build .
    # 이미지는 name:tag 로 식별자 부여
    # -t ${name}:${tag}

# 이미지 REPOSITORY(name), TAG 재설정
docker tag ${old-name}:${old-tag} ${name}:${tag}

# 컨테이너 생성 및 시작
docker run -p ${local-port}:${container-port} ${image-id}
    # -d : detached mode
    # -it 
        # -i : interactive(컨테이너 내부로 입력 가능하게 함)
        # -t : tty (터미널 생성)
    # -rm : 컨테이너 종료시 자동 제거
    # --name ${custom-continaer-name}: 원하는 컨테이너 이름 식별자 부여

# 컨테이너 백그라운드 시작
docker start ${container-id}
    # -a : attached mode

# 특정 컨테이너 내부 명령어 실행
docker exec ${container-name} ${command}

# 컨테이너 제거
docker rm ${...container-name}

# 이미지 제거 (컨테이너에서 사용되지 않는 것만 삭제 가능)
docker rmi ${...image-id}

# 사용되지 않는 이미지 전부 제거
docker image prune

# 로그 보기
docker logs
    # -f : follow mode

이전글 - 개발을 위해 Local, Dev Server WAS 환경 분리하기 1 - Intellij 환경 변수 이용하기 :: 꿀잠 (tistory.com)

WAS 환경을 분리하기 위해 axios 의 base url 을 분리하였고, 문제는 해결되어진 것으로 보았다. 그러나 그 이후 더 큰 문제가 발생하였다. 개발 WAS 에서 Session ID 가 요청마다 새로 생기는 문제였다. 우리의 로그인 방식이 세션 방식이었기에 이 문제는 크게 작용하였다.

로컬 WAS 환경에선 문제 없었으나 개발 WAS 에선 로그인 이후에 바로 다음 요청시 세션이 초기화 되어 로그인 인증을 할 수 없는 것이었다.

이것은 CSRF 방지를 위한 브라우저의 보안 정책 때문이었다. 세션 ID를 담은 쿠키를 보내려면 적절한 SameSite 정책이 포함되어야 하는 것이었다. Dev WAS 와 Local WEB으로 분리된 프로젝트 환경이기에 기본적으로 같은 사이트(SameSite)가 아닌 상황이었고, 서버는 SameSite 가 아닌 WEB 프로젝트의 쿠키를 폐기하고 새로 생성하였던 것이다.

아래와 같이 Spring Boot 의 CookieSerializer Bean을 새로 등록하는 방식으로 SameSite 정책을 None으로 변경해주었다.

@Bean
public CookieSerializer cookieSerializer() throws MalformedURLException {
    DefaultCookieSerializer serializer = new DefaultCookieSerializer();
    serializer.setSameSite("None");
    serializer.setUseSecureCookie(true); // None 일 경우 필수
    return serializer;
}

위와 같이 None 설정을 하여 진행하였지만 이후에 추가적인 문제가 생겼다. 바로 Secure 옵션을 반드시 주어야 한다는 점이다. 프로젝트에 HTTPS를 적용하여야 했다. Local 환경에 SSL 인증서를 설치하는 방법도 있지만 개발 환경에서 serve 명령어를 변경하여 간단히 해결하는 방법도 있다. package.json 에서 npm run serve 명령어를 아래와 같이 옵션을 주는 형태로 해결하였다.

 "serve": "vue-cli-service serve --https true",
 "serve-local": "vue-cli-service serve",

Dev Server WAS 환경을 바라 볼 때는 npm run serve 명령어를 사용하고, Local WAS 를 바라볼 때는 npm run serve-local를 사용하면 된다. Local 에서는 SameSite 인 상황이기에 쿠키의 새로운 생성을 걱정하지 않아도 되었기 때문이다.

분리 방법을 요약 하자면 아래와 같다.

1. 환경 변수를 이용한 axios base url 분리
2. Local Web -> Server Was 환경에서 Session 이 초기화 되면 안되는 환경일 경우 SameSite None, SecureCookie 설정
3. Local Web Https 적용(로컬 SSL 인증서 설치 또는 실행 명령어로 해결)

이로써 로컬 및 서버 WAS 인지에 따른 개발환경 분리를 완료할 수 있었다.

추가내용

CookieSerializer Bean 을 새로 등록하는 방법 외에도 방법이 있어 변경하여 적용후 남긴다.

개발 환경에서만 필요한 옵션이었기에 개발서버 기준application.properties 로 분리하였다.

server.servlet.session.cookie.same-site=none
server.servlet.session.cookie.secure=true