Error : 413 Request Entity Too Large

위와 같이 Nginx를 사용중에 클라이언트의 브라우저에서 파일 업로드를 수행할 경우 파일 용량 제한 에러가 발생한다.

Solution

Nginx 업로드 사이즈 변경

1) nginx.conf 파일에 아래 코드를 추가한다.

 # Set client upload size - 50Mbyte
 client_max_body_size 50M;

2) 변경 후에 Nginx를 재시작해야 한다.

sudo service nginx restart

Error : FileSizeLimitExceededException

nested exception is org.springframework.web.multipart.MaxUploadSizeExceededException: Maximum upload size exceeded; 
nested exception is java.lang.IllegalStateException: org.apache.tomcat.util.http.fileupload.impl.FileSizeLimitExceededException: The field image exceeds its maximum permitted size of 1048576 bytes.
org.apache.tomcat.util.http.fileupload.impl.FileSizeLimitExceededException

error log 내용대로 업로드할 수 있는 최대 용량을 넘긴 파일을 업로드 하려고 할 때 발생하는 에러다. 따로 설정하지 않았다면 default값이 1048576 bytes 로 약 1MB이다.

Solution

• Spring Boot 2.x application.properties 파일에 아래 코드를 추가한다.

  spring.servlet.multipart.maxFileSize=50MB
  spring.servlet.multipart.maxRequestSize=50MB

• Spring Boot 1.4.x & 1.5.x application.properties 파일에 아래 코드를 추가한다.

  spring.http.multipart.maxFileSize=50MB
  spring.http.multipart.maxRequestSize=50MB

• Spring Boot 1.3.x or 그 이전 버전 application.properties 파일에 아래 코드를 추가한다.

  multipart.maxFileSize=50MB
  multipart.maxRequestSize=50MB

Nginx 실행

service nginx start
sudo service nginx start
sudo systemctl start nginx

Nginx 상태보기

service nginx status
sudo service nginx status
ps -ef | grep nginx

Nginx 재실행

service nginx restart
sudo service nginx restart
sudo systemctl restart nginx

Nginx 중단

service nginx stop
sudo service nginx stop
sudo systemctl stop nginx

파일, 디렉토리를 삭제한다. rm은 remove의 약자이다.

rm 명령어

사용 방법

rm [option] [삭제할 파일 경로/이름]

option

• -r : 디렉토리와 그 하부 파일까지 삭제
• -i : 삭제 여부를 확인(y, n)
• -f : 삭제 여부를 묻지 않고 바로 삭제
• -rf : 삭제 여부를 묻지 않고 하부 파일이 있는 디렉토리까지 삭제

사용 예시

sample 파일을 삭제한다.

rm sample

sample 파일 삭제 시 다시한번 물어본다.

rm -i sample

sample 파일을 강제로 삭제한다.

rm -f sample

sampleDir 디렉토리를 삭제한다.

rm -r sampleDir

sampleDir 디렉토리 안에 모든 파일을 삭제한다.

rm -rf sampleDir

Linux 파일/디렉토리 이동/복사

파일, 디렉토리를 이동/복사 한다.

cp 명령어 [파일 복사]

• 원본 폴더를 통째로(즉 하위폴더 및 파일들을 포함하여) 목적지폴더로 복사할 수 있다.
• 상황에 따라 하위로 복사되거나, 폴더명이 바뀌며 복사된다.
• 목적지폴더가 원본폴더의 상위폴더가 될 것인지, 아니면 원본폴더의 다른이름이 될 것인지는 상황에 따라 다르다.
• 맨 뒤에 '/'를 붙여도 되고 붙이지 않아도 된다.

사용 방법

cp -r [원본폴더] [목적지폴더]

mv 명령어 [파일 이동]

• 폴더 전체를 다른 폴더로 이동한다.
• 복사와 마찬가지로 상위폴더가 될 것인지, 다른 이름이 될 것인지는 상황에 따라 다르다.

사용 방법

mv -r [원본폴더] [목적지폴더]

• SSL은 네트워크에서 메시지 전송 시 보안을 위해 개봘된 표준 프로토콜이다. 즉, HTTP만을 위한 프로토콜이 아닌 응용계층의 여러 프로토콜의 보안을 위해 발명된 프로토콜이다. TCP를 보호하는 프로트콜이다.

• 클라이언트 또는 서버에서 메시지를 만들어 상대에게 전달할 때, 응용계층에서 만들어진 메시지가 전송계층으로 가기전 SSL을 통해 데이터가 암호화된다. 그 후 전송계층을 통해 네트워크로 데이터가 상대에게 전달이 된다.

• SSL 장점

  1. 기밀성(암호화)
  2. 데이터 무결성
  3. 서버인증

SSL 인증서 발급 및 설치

1) ssh 접속 후 letsencrypt 설치

sudo apt update
sudo apt-get install  letsencrypt -y

위의 명령어를 순서대로 입력하여 letsencrypt를 설치한다.

Let’s Encrypt SSL 인증서 발급은 매우 다양한 방법으로 이루어 진다. 이 중에는 Nginx나 아파치와 같은 웨서버가 전적으로 인증서를 제어토록 하는 방법이 있다. 이 경우 인증서 관리는 웹서버가 세팅과 관리를 알아서 한다. 이 방법을 사용하려면 웹서버에 맞는 Certbot을 추가 설치해야 한다. 우선 우분투에서 Nginx용 Certbot 설치는 아래 명령을 사용한다.

sudo apt update 
sudo apt upgrade -y 
sudo apt install certbot python3-certbot-nginx

2) 설정파일에 도메인주소 등록

sudo vi /etc/nginx/sites-available/default

위 명령어를 입력하여 아래 사진과 같이 servername : {domain} 의 형식으로 수정한다.

3) 인증서 발급

sudo certbot --nginx -d {domain}

처음에는 Cert bot을 이용하여 인증서를 발급받으려고 위의 명령어를 입력했지만 오류가 발생했다. 결국 아래 코드를 입력하여 Standalone 방식으로 인증서를 발급받았다.

sudo letsencrypt certonly --standalone -d {domain}

이렇게 나왔다면 인증서 발급이 완료된 것이다.

4) 설정파일에 인증서 추가

sudo vi /etc/nginx/sites-available/default

위 명령어로 설정파일 편집기에 들어가서 아래 사진과 같이 인증서를 추가하면 된다. 여기까지 완료 되었다면 이제 https로 접속이 가능해진 것이다.

5) redirect 설정하기

아래 사진처럼 nginx 설정파일을 수정하여 http 로 접속을 했을 경우 https로 redirect 해주도록 한다.

6) ssl인증서 적용 성공

참고자료

• https://happist.com/573990/%EC%B5%9C%EC%8B%A0-lets-encrypt-ssl-%EC%9D%B8%EC%A6%9D%EC%84%9C-%EB%B0%9C%EA%B8%89-%EB%B0%A9%EB%B2%95-3%EA%B0%80%EC%A7%80-%EC%A0%95%EB%A6%AC

• https://lelana.tistory.com/102
• https://velog.io/@pinot/Ubuntu-Nginx-%ED%99%98%EA%B2%BD%EC%97%90%EC%84%9C-CertBot%EC%9D%84-%EC%82%AC%EC%9A%A9%ED%95%98%EC%97%AC-https-%EC%82%AC%EC%9A%A9%ED%95%98%EA%B8%B0

• Nginx는 경량 웹 서버이다. 클라이언트로부터 요청을 받았을 때 요청에 맞는 정적 파일을 응답해주는 Http Web Server로 활용되기도 하고, Reverse Proxy Server로 활용하여 WAS 서버의 부하를 줄일 수 있는 로드 밸런서로 활용되기도 한다.

EC2에 Nginx 설치 및 Spring Boot 프로젝트 연동

1) EC2 인스턴스 접속 후 nginx 설치

sudo yum install nginx

yum을 통해 nginx를 설치하려는 순간 yum이 설치되어 있지 않아서 오류가 발생했다.

그래서 아래의 링크를 참고하여 진행했지만 역시나 오류가 발생했다.

• https://investechnews.com/2021/06/21/sudo-yum-command-not-found/

• https://lhjin.tistory.com/entry/CentOS-yum-%EC%84%A4%EC%B9%98%EC%8B%9C-%EC%97%90%EB%9F%AC-%ED%95%B4%EA%B2%B0%EB%B2%95

결국 yum을 통한 방법은 포기했고 아래 명령어를 통해 nginx를 설치했다.

sudo apt-get install nginx

2) nginx 실행 및 확인

sudo service nginx start

위의 명령어를 사용하여 nginx를 실행하고

ps -ef | grep nginx

위의 명령어를 사용하여 실행이 잘 되었는지 확인을 한다. 그리고 외부에서 잘 노출되는지 확인을 위해 아래 주소로 접속해 보았다.

http://ec2-{ec2인스턴스 탄력적 ip주소(. 대신 - 사용)}.ap-northeast-2.compute.amazonaws.com/

여기까지 이상이 없다면 nginx 설치와 구동은 완료된 것이다.

3) springboot 프로젝트와 nginx 연결

먼저 nginx가 현재 실행중인 스프링부트 프로젝트를 바라볼 수 있도록(reverse proxy) 설정을 해야한다.

sudo vi /etc/nginx/nginx.conf

위의 명령어를 입력하여 server 아래의 location / 부분을 찾아 아래코드를 추가한다. 하지만 내 nginx.conf파일은 저런형태가 아니었고, 다른 방법을 찾아야 했고 마침내 아래 링크들을 참고하여 해결했다.

• https://www.cyberciti.biz/faq/Nginx-restart-ubuntu-linux-command/#div-comment-899171

• https://hue9010.github.io/aws/nginx%EB%A5%BC-%EC%A0%81%EC%9A%A9%ED%95%B4-%EB%B3%B4%EC%9E%90/

sudo vi /etc/nginx/sites-available/default

위 명령어를 통해 vi 편집기로 들어가서 아래 코드처럼 변경하면 된다.

#try_files $uri $uri/ =404;
proxy_pass http://localhost:8080;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header Host $http_host;

여기까지 완료 되었다면 설정한 내용을 적용하여 nginx를 재시작 하면된다.

sudo service nginx restart

4) 주의사항

• 만약 접속이 안된다면 AWS EC2 의 80번 포트에 대한 접근이 허용 되어있는지 확인할 것
• nginx 에서 was로의 연결이 안되는 상황에다 우분투 사용자라면 sudo vi /etc/nginx/sites-available/default 에서 location을 변경해라.

참고자료

• https://nginx.org/en/docs/beginners_guide.html
• https://velog.io/@wijihoon123/Nginx%EB%9E%80-%EB%AC%B4%EC%97%87%EC%9D%B8%EA%B0%80

1) terminal 에서 pemkey가 존재하는 directory경로로 이동

cd {pemkey가 존재하는 directory경로}

2) key파일에 대한 권한 설정 변경

chmod 400 {pemKeyName}.pem

chmod 뒤의 숫자 3개는 차례대로 나/그룹/전체 에 대한 권한을 의미한다. read(4), write(2), execute(1)의 조합으로 권한을 나타낸다. 예를 들어, 5 = 4 + 1로 read + write의 권한이 있음을 의미한다. 즉 chmod 400 의 의미는 4/0/0이므로 나에게만 읽기 권한을 부여하는 것이다.

3) ssh 접속

sudo ssh -i ‘{pemKeyName}.pem’ ubuntu@{EIP}

EIP : ec2 인스턴스의 탄력적 IP 주소 아래 사진과 같이 명령어를 입력하면 사용자 비밀번호를 입력하면 된다. 이때, 영어로 되있는지 확인 해야하고, 입력중인지 표시되지 않으므로 오타나지 않게 입력한다.

4) ec2 인스턴스 접속 완료

아래와 같은 화면이 뜨게 되면 ec2에 접속이 완료된 것이다.