nginx image server
1.0.0
Nginx, FastCGI 스크립트를 이용하여 이미지 업로드, 다운로드, 삭제 기능을 할 수 있도록 구현한 웹 서버
docker-compose 명령어를 통해 미디어 서비스 컨테이너를 실행한다. 8888 포트를 통해 미디어 서버 프로세스에 접근할 수 있다.
최초 구동 시, 이미지를 빌드한 후 컨테이너를 실행할 수 있도록 docker-compose up에 --build 옵션을 추가한 명령어를 입력한다.
$ cd common
$ cd MediaService
$ docker-compose up --build # 최초 실행 시 --build 옵션 추가기존에 빌드한 이미지가 있는 경우, docker-compose up을 통해 실행한다.
$ cd common
$ cd MediaService
$ docker-compose up미디어 서비스 포트를 변경하고 싶은 경우, .env 파일의 MEDIA_PORT 포트 값을 변경한다.
이미지 단건 업로드를 요청한다.
Request
Content-Type: multipart/form-data
Response
정상 처리
{
"code": 200,
"message": "File(s) successfully uploaded.",
"data": {
"file_name": "bts_jk.gif",
"file_id": "b7436194d5034bb69767688807393e48"
}
}에러
이미지가 전송되지 않았을 때
Body가 비어 있는 경우: Nginx 400 Bad Request
<html>
<head>
<title>404 Not Found</title>
</head>
<body>
<center>
<h1>404 Not Found</h1>
</center>
<hr>
<center>nginx/1.20.2</center>
</body>
</html>Body가 있으나, File type이 아닌 경우
{
"code": 400,
"message": "No file received."
}업로드하려는 이미지 파일의 크기가 너무 큰 경우: nginx 413 request too large 에러
<html>
<head>
<title>413 Request Entity Too Large</title>
</head>
<body>
<center>
<h1>413 Request Entity Too Large</h1>
</center>
<hr>
<center>nginx/1.20.2</center>
</body>
</html>여러 건의 이미지가 업로드된 경우
{
"code": 400,
"message": "Multiple file upload not allowed."
}업로드된 이미지가 허용되지 않는 확장자인 경우
{
"code": 400,
"message": "File extension of file webp_jk.webp not allowed."
}이미지 다중 업로드를 요청한다.
Request
Content-Type: multipart/form-data
Response
정상 처리
{
"code": 200,
"message": "File(s) successfully uploaded.",
"data": [
{
"file_name": "jpeg_jk3.jpg",
"file_id": "b3b2bc5b075f434692f71657afbae2c9"
},
{
"file_name": "png_jk.png",
"file_id": "20995dfcf94a49e7b6d34ccce744609c"
},
{
"file_name": "png_bts.png",
"file_id": "9d15ce7799dd499181bbc8cace4761b7"
},
{
"file_name": "jpg_cat.jpg",
"file_id": "5fd0f71238ed4086b9bb58859ac3b271"
}
]
}에러
이미지가 전송되지 않았을 때: POST images/upload와 동일
1건의 이미지가 업로드된 경우
{
"code": 400,
"message": "Single file upload not allowed."
}업로드된 이미지들 중 한 건의 이미지라도 허용되지 않는 확장자인 경우
{
"code": 400,
"message": "File extension of file webp_jk.webp not allowed."
}업로드하려는 이미지 파일의 크기가 너무 큰 경우: nginx 413 request too large 에러
<html>
<head>
<title>413 Request Entity Too Large</title>
</head>
<body>
<center>
<h1>413 Request Entity Too Large</h1>
</center>
<hr>
<center>nginx/1.20.2</center>
</body>
</html>이미지 파일을 요청한다.
에러
찾고자 하는 이미지 파일이 없을 경우
<html>
<head>
<title>404 Not Found</title>
</head>
<body>
<center>
<h1>404 Not Found</h1>
</center>
<hr>
<center>nginx/1.20.2</center>
</body>
</html>이미지 파일 삭제를 요청한다.
정상 처리
{
"code": 200,
"message": "File 20995dfcf94a49e7b6d34ccce744609c successfully deleted."
}에러
삭제하고자 하는 이미지 파일이 없을 경우
{
"code": 400,
"message": "File 20995dfcf94a49e7b6d34ccce744609c does not exists."
}
