Blog/배포/
beginner's guide
beginner's guide
 
 
본 페이지는 아래 항목들을 간략하게 설명한다.
  • nginx 실행/중지 방법
  • static content를 serving하기 위한 설정
  • proxy server(reverse)로 nginx를 사용하기 위한 설정
  • FastCGI app과의 연결
nginx의 프로세스는 master process와 여러 개의 worker processes로 구성된다.
 
master process : config를 통해 nginx를 제어하며 worker processes를 관리한다.
worker process : 요청을 처리하는 프로세스로 config에서 사용할 worker process의 개수를 조절할 수 있다.
 
nginx와 nginx를 구성하는 모듈은 nginx.conf 파일 설정에 의해 동작되며 이 파일은 /usr/local/nginx/conf , /etc/nginx 또는 /usr/local/etc/nginx 에 위치한다.
 
 

1.. Starting, Stopping, Reloading Configuration

 
nginx를 실행하기 위해 실행파일을 run한다.
 
nginx가 실행되면, 아래의 문법으로 nginx를 컨트롤할 수 있다.
nginx -s signal
signal
  • stop
  • quit
  • reload
  • reopen
 
ex) 아래 명령어 실행 시, nginx process를 중지한다. (만약 현재 들어온 요청을 worekr process가 처리 중이라면 이를 처리할 떄까지 기다린다.)
nginx -s quit

// nginx를 시작한 유저가 해당 명령어를 실행해야한다.
 
ex 2) config를 수정할 경우, reload해줘야 반영이 되는데 이 떄 다음 명령어를 실행한다.
nginx -s reload
 
위 명렁어 실행 시, master process는 config를 reload하라는 signal을 전달받게 되고 new config를 validate하고
valid할 경우 새로운 worker 프로세스를 실행하고 이전의 worker process에게 shut down 메세지를 보낸다.
unvalid할 경우에는 변경된 내용을 기존 값으로 되돌리고 기존 설정 그대로 동작하게 된다.
 
reload 또는 quit signal을 받게 될 경우, worker processes는 새롭게 들어오는 요청은 끊어버리고 처리 중이던 요청은 마저 처리한 후 rpcoess를 종료한다.
unix의 경우 kill 유틸리티를 통해 signal을 전달할 수 있다.
kill -s QUIT 1628 

// 1628 : (master process ID)
 
px 유틸리티를 통해 현재 실행 중인 nginx processes를 확인할 수 있다.
ps -ax | grep nginx
 
[DOCS] : controlling nginx
 
 
 

2. Configuration File's Structure

 
nginx에 내장된 모듈들은 configuration 파일을 통해 사용할 수 있다.
config file는 simple directive와 block directive로 작성된다.
 
simple directive : name과 parameters로 이루어진다.
block directive : simple directive와 동일한 구조에서 curly braces를 통해 추가적인 내용을 작성할 수 있다.(이를 context라 한다. ex) events, http, server, location )
global context를 main context라 한다.
 
 

3. Serving Static Content

 
웹 서버가 serving하는 파일은 서로 다른 local directories에 위치하게 되는데, 이를 nginx 서버에서 알맞게 처리하기 위해
config file의 http block 에 있는 server block에 두 개의 location blocks를 작성해야한다.
 
 
ex) /data/www 와 /data/images 폴더에 파일이 위치할 경우
 
// configuration file

// 기본적으로 http 블락 안에 server 블락이 구성된다.
http {
	server {
	}
}
 
만약 서로 다른 서버명 또는 동일 서버의 서로 다른 포트에서 여러 서버를 운영하는 경우라면 여러 개의 server blocks를 작성하면 된다.
 
server 블락에 작성된 서버는 요청이 들어올 경우
헤더에 명시된 URI를 location directive의 parameter와 일치하는지 테스트한다.
http {
	server {
		location / {
			root /data/www;
		}
		location /images/ {
			root /data;
		}
	}
}
ex) http://localhost/images/example.png 요청이 들어올 경우
nginx는 /data/images/example.png 파일을 response한다.
 
root는 로컬 root 위치이며, root/location이 request의 URI 앞에 붙게 된다. ex) request : /images/top.gif => response : /data/images/top.gif
 
만약 여러 location이 매칭된다면 가장 긴 prefix를 택하게 된다. ex) 들어오는 URI가 ~/images/img.png라면 / 와도 일치하지만 더 긴 /images/ location과 매칭된다.
config 파일을 변경했다면 nginx를 reload해본다.
nginx -s reload
 
에러는 /usr/local/nginx/logs에 위치하는 access.log, error.log 파일을 통해 확인할 수 있다.
 
 

4. Setting Up a Simple Proxy Server

 
Proxy server?
nginx를 통해 proxy server( reverse )를 set up할 수 있다.
 
location 블락에 root가 없을 경우 server 블락의 root가 적용된다.
server {
	listen 8080;
	root /data/up1;
	
	location / {
	}
}

// index파일을 root 디렉토리에 위치시킨다. ( local/data/up1/index.html )
 
 
아래와 같이 proxy_pass directive와 location을 추가한다.
server {
	listen 8080;
	root /data/up1;
	
	location / {
		proxy_pass http://localhost:8080;
	}
	
	location ~ \.(gif|jpg|png)$ { // ~는 root를 위미하며 정규식으로 일치하는 파일을 매핑한다.
		root /data/images;
	}
}
 
서버는 아래의 순서로 요청을 프록싱한다.
  • location directive 매칭 ( longest prefix 우선) ⇒ / 와 /data/images가 일치하므로 /data/images로매칭
  • 정규식 필터링 ⇒ .gif, .jpg, .png로 끝나는 요청만 필터링하고 필터링된 요청은 /data/images 디렉토리로 매핑시킨다.
  • 매핑되는 모든 요청을 proxied server로 넘겨준다.
 
nginx에서는 http 통신 프록싱 외에도 여러 프로토콜에 대한 프록싱을 지원한다.
 

5. fastCGI Proxying

 
나중에 다시 보기
https://www.digitalocean.com/community/tutorials/understanding-and-implementing-fastcgi-proxying-in-nginx