'nginx'에 해당되는 글 42건
- 2017/01/20 용비 1. Introduction to Microservices - 05 The Drawbacks of Microservices
- 2017/01/20 용비 1. Introduction to Microservices - 04 The Benefits of Microservices
- 2015/04/20 용비 04. Serving Static Content
- 2015/03/31 용비 03. Configuration File's Structure
- 2015/03/31 용비 02. Starting, Stopping, and Reloading Configuration
1. Introduction to Microservices - 05 The Drawbacks of Microservices
Nginx/01. MicroServiceArchitecture 2017/01/20 17:051. Introduction to Microservices - 04 The Benefits of Microservices
Nginx/01. MicroServiceArchitecture 2017/01/20 14:32웹 서버의 주요한 기능은 이미지나 HTML 파일과 같은 파일들을 제공하는 것이다. 여러분은 서로 다른 디렉토리(HTML 파일들이 있는 /data/www 디렉토리와 이미지를 포함하고 있는 /data/images 디렉토리)에 있는 파일들을 서로 다른 요청에 의해서 제공하는 예제를 구현할 수 있다. 그렇게 하기 위해서는 configuration 파일을 수정하여 http block내에 있는 server block에 2개의 location block을 설정하면 된다.
먼저, /data/www 디렉토리를 생성하고 임의의 텍스트를 가진 index.html 파일을 저장하자. 그리고 /data/images 디렉토리를 생성하고, 임의의 이미지 파일을 위치시킨다.
다음으로 nginx의 configuration file을 open하면 이미 기본적으로 server block의 여러 예제들이 포함되어 있다. (대부분 코멘트로 막혀 있다.) 이제 모두 코멘트로 막고, 새로운 server block을 추가해 보자.
http {
server {
}
}
일반적으로, configuration file은 요청을 받을 서로 다른 port와 server name으로 구분된 여러 server block을 가질 수 있다. Nginx에서 request를 처리할 server를 결정하고, server block내에 정의된 location 지시어(directive)의 파라미터와는 반대로 Request의 header에 특화된 URI를 테스트한다.
Server block내에 다음 location block을 추가한다.
location / {
root /data/www;
}
이 location block은 prefix "/"로 시작하는 request URI에 특화되어 있다. URI는 root directive에 특화된 path에 추가될 것이다. 따라서, 로컬 파일 시스템상의 요청된 파일은 /data/www에 있다. 만약 여러 개의 매칭되는 location block이 있다면, nginx는 가장 긴 prefix를 선택한다. 위에서 제공된 location block은 가장 짧은 prefix이다. 따라서, 모든 request에는 이 location block이 사용된다.
다음으로, 두번째 location block을 추가해 보자.
location /images/ {
root /data;
}
이것은 /images/로 시작하는 request와 매칭될 것이다. (location / 역시 매칭되기는 하지만, 더 짧은 prefix이다.)
결과적으로 server block의 configuration은 다음과 같다.
http {
server {
location / {
root /data/www;
}
location /images/ {
root /data;
}
}
}
이것은 이미 표준 포트 80으로 요청을 받는 동작하고 있는 server 설정이다. 따라서, localhost로 접속할 수 있다. /images/로 시작하는 URI 요청에 대한 응답에서 server는 /data/images 디렉토리에 있는 이미지 파일을 보낼 것이다. 예를 들어, http://localhost/images/example.png 를 요청하면 nginx는 /data/images/example.png 파일을 리턴할 것이다. 만약 그런 파일이 없다면, nginx는 404 error를 리턴할 것이다. /images/로 시작하지 않는 request URI에 대해서는 /data/www directory와 맵핑된다. 예를 들어, http://localhost/some/example.html 요청에 대해서 nginx는 /data/www/some/example.html 파일을 리턴할 것이다.
새로운 configuration을 적용하기 위해서는 아직 nginx가 시작되지 않았으면 nginx를 start하고, 이미 nginx를 시작했다면, master process에 reload signal을 보낸다. 실행 command는 다음과 같다.
nginx -s reload
기대한 대로 동작을 하지 않는 경우에는 access.log나 error.log에서 그 이유를 찾아볼 수 있다. 로그 파일들은 /usr/local/nginx/logs나 /var/log/nginx에서 찾아볼 수 있다.
Nginx는 설정 파일 내의 directive(지시어)들에 의해 제어되는 모듈들로 이루어져 있다. Directive는 simple directive(단순 지시어)와 block directive(블록 지시어)로 나누어져 있다. Simple directive는 space로 구분되는 name, parameter로 구성되어 있고, semicolon(;)으로 끝난다. Block directive는 simple directive와 동일한 구조를 갖지만, semicolon으로 끝나는 대신에 괄호로 묶인다. (중괄호 사용 : '{' 와 '}') Block directive는 괄호 안에 다른 directive들을 가질 수 있다. 이것을 context라고 부른다. (ex. Events, http, server, location)
설정 파일에서 Context 밖에 위치하는 directive들은 main context에 있는 directive로 간주한다. Events, http는 main context에 위치하고, http 안에 server가 있고, server 안에 location이 있다.
#표시 뒤에 오는 라인은 comment이다.
<Starting, Stopping, and Reloading Configuration>
Nginx는 실행파일을 실행하여 시작한다. Nginx가 실행된 이후에는 -s 파라미터를 가지고 다른 작업을 수행하도록 할 수 있다. 다음과 같은 문법을 갖는다.
nginx -s signal
Signal은 다음 값을 가질 수 있다.
Stop : fast shutdown
Quit : graceful shutdown
Reload : 설정 파일 reload
Reopen : 로그 파일 reopen
예를 들어 현재 처리 중인 request를 모두 처리하고 nginx를 종료하고자 한다면 다음 command를 실행하면 된다.
nginx -s quit
- 이 command는 nginx를 실행할 때와 동일한 user로 실행해야 한다.
설정 파일의 변경은 변경된 설정 파일을 reload command를 통해서 nginx에 전달해야 적용된다. 설정 파일을 reload하는 command는 다음과 같다.
nginx -s reload
Master Process가 설정 파일 reload signal을 받으면 새로운 설정 파일에 대한 syntax validation을 체크하고, 적용한다. 적용이 끝나면 master process는 새로운 worker process를 실행하고, 기존의 worker process에는 shutdown 요청을 보낸다. 과정 중간에 오류가 발생하면 master process는 변경 사항을 roll back하고 계속해서 old worker process로 작업을 수행한다. Old worker process는 shutdown 메시지를 받으면 새로운 connection을 받는 것을 중지하고 현재 처리 중인 request가 완료될 때까지 계속해서 서비스를 제공한다. 모든 처리 중인 request가 완료되었을 때, old worker process는 종료된다.
Signal은 kill utility와 같은 Unix tool의 도움을 받아서 nginx로 전달될 수도 있다. 이 경우 signal은 주어진 process ID를 통해서 직접적으로 nginx process에 전달된다. Process ID로는 nginx master process의 ID를 사용한다. 기본적으로 nginx.pid는 /usr/local/nginx/log 폴더나 /var/run 폴더에 저장된다. 예를 들어서, master process ID가 1628이라면, nginx의 graceful shutdown을 위한 Quit signal은 다음과 같이 보낼 수 있다.
kill -s QUIT 1628
모든 기동중인 nginx process에 대한 리스트를 얻으려면 다음과 같이 ps utility를 사용할 수 있다.
ps -ax | grep nginx
Nginx로 보내는 signal에 대한 더 자세한 정보는 Controlling nginx (http://nginx.org/en/docs/control.html) 를 통해서 얻을 수 있다.
댓글을 달아 주세요
댓글 RSS 주소 : http://www.yongbi.net/rss/comment/750