NGINX Unit 에서 첫 번째 "Hello World" 작성

MSA 트레이닝 센터

NGINX Unit Hello World!

이 트레이닝 영상에서는 NGINX Unit 구성 API를 사용하여 첫 번째 “Hello World” 프로그램을 작성하는 방법을 알아보세요.

NGINX Unit은 범용 웹 앱 서버로 엔터프라이즈급 배포에서 애완 동물의 홈페이지에 이르기까지 복잡성에 관계없이 모든 웹 아키텍처의 빌딩 블록으로 사용됩니다. 레거시 및 모놀리식 애플리케이션을 현대화하는 것과 마찬가지로 최신 마이크로서비스 환경을 단순화하는 데에도 적합합니다.

NGINX Unit의 모든 기능, 설치 방법, 구성 API 탐색, 첫 번째 “Hello World” 작성, 웹 서버 구성, Unit 언어 모듈 소개 등을 다루는 전체 과정을 개발했습니다.

NGINX Unit 구성 API를 사용하여 첫 번째 "Hello World" 프로그램 작성

NGINX Unit은 동적 애플리케이션 서버로, 다중 언어 지원, RESTful 구성 API, 그리고 고성능의 유연성을 제공합니다. 이를 통해 다양한 애플리케이션을 효율적으로 배포하고 관리할 수 있습니다.

이 가이드에서는 NGINX Unit의 구성 API를 사용하여 간단한 “Hello World” 애플리케이션을 작성하고 실행하는 방법을 단계별로 자세히 설명하겠습니다. Python을 활용한 예제를 중심으로 진행하며, NGINX Unit 설정과 테스트 과정까지 포함되어 있습니다.

환경 준비

필수 구성 요소

첫 번째로, NGINX Unit 환경을 구축하기 위해 필요한 필수 구성 요소들을 확인해야 합니다. 이 가이드에서는 Python으로 작성된 애플리케이션을 실행하기 때문에, Python 런타임과 NGINX Unit의 Python 지원 모듈이 필요합니다.

NGINX Unit 설치: 최신 버전의 NGINX Unit이 시스템에 설치되어 있어야 합니다. NGINX Unit 공식 설치 가이드를 참조하여 설치를 완료하세요.
Python 3 런타임: Python 3.7 이상이 설치되어 있어야 하며, 이 가이드에서는 Flask 프레임워크를 사용하므로 필요한 패키지를 설치해야 합니다.
HTTP 클라이언트 도구: 테스트를 위해 curl이나 Postman과 같은 HTTP 클라이언트 도구를 준비하세요.

Python 애플리케이션 작성

먼저, 간단한 Python 애플리케이션을 작성하여 “Hello World” 메시지를 반환하는 기본적인 동작을 구현합니다.

애플리케이션 파일 생성

원하는 디렉토리에서 hello.py라는 파일을 생성한 뒤, 다음 코드를 작성합니다. 이 코드는 Flask 프레임워크를 기반으로 작성되었으며, HTTP GET 요청에 응답하여 “Hello, World!” 메시지를 반환합니다.

				
					from flask import Flask

app = Flask(__name__)

@app.route('/')
def hello():
    return "Hello, World!", 200

Flask 설치

Flask는 Python에서 간단한 웹 애플리케이션을 빠르게 개발할 수 있도록 지원하는 프레임워크입니다. 이를 설치하려면 다음 명령을 실행하세요

				
					pip install flask

이 명령은 Flask 라이브러리를 설치하며, 이후 애플리케이션에서 사용할 수 있도록 환경을 설정합니다.

NGINX Unit 구성

NGINX Unit은 RESTful API를 통해 애플리케이션을 동적으로 구성할 수 있는 강력한 기능을 제공합니다. Python 애플리케이션을 실행하려면 NGINX Unit에 애플리케이션과 라우트 설정을 JSON 형식으로 전달해야 합니다.

애플리케이션 구성

애플리케이션을 NGINX Unit에 등록하려면, curl 명령어를 사용하여 Unit의 구성 API를 호출합니다. 아래 명령은 Python 애플리케이션을 등록하는 방법을 보여줍니다.

				
					curl -X PUT --unix-socket /var/run/control.unit.sock \
-d '{
    "type": "python",
    "path": "'$(pwd)'",
    "module": "hello"
}' http://localhost/config/applications/hello

type: 실행할 애플리케이션의 유형을 정의합니다. 이 예제에서는 Python을 사용하므로 python으로 지정합니다.
path: 애플리케이션 파일(hello.py)이 저장된 디렉토리 경로를 지정합니다. 현재 디렉토리를 기준으로 $(pwd)를 사용했습니다.
module: Python 모듈 이름을 지정합니다. 여기서는 파일 이름에서 .py를 제외한 hello를 사용합니다.

라우트 설정

NGINX Unit이 특정 포트에서 들어오는 요청을 애플리케이션으로 전달할 수 있도록 라우트를 구성해야 합니다. 이를 위해 아래 명령을 실행합니다

				
					curl -X PUT --unix-socket /var/run/control.unit.sock \
-d '{
    "listeners": {
        "*:8080": {
            "pass": "applications/hello"
        }
    }
}' http://localhost/config

listeners: NGINX Unit이 요청을 수신할 포트를 지정합니다. 위 예제에서는 8080 포트를 사용했습니다.
pass: 요청을 전달할 애플리케이션을 지정합니다. 여기서는 applications/hello로 설정되었습니다.

애플리케이션 테스트

NGINX Unit에 애플리케이션과 라우트 구성이 완료되었으므로, 이제 애플리케이션이 제대로 동작하는지 테스트할 차례입니다. 이를 위해 HTTP 클라이언트 도구를 사용하여 설정한 포트로 요청을 전송합니다.

브라우저에서 테스트

브라우저에서 http://localhost:8080 URL에 접속하여 애플리케이션의 응답을 확인합니다. 브라우저 화면에 Hello, World! 메시지가 표시되면 성공적으로 동작하는 것입니다.

curl 로 테스트

명령어를 사용해 응답을 확인하려면 아래 명령 실행합니다.

				
					curl http://localhost:8080

성공적인 응답이 반환되면 아래와 같은 결과가 출력됩니다.

				
					Hello, World!

구성 확인 및 관리

애플리케이션 및 라우트 구성을 포함한 NGINX Unit의 전체 설정 상태를 확인하려면 다음 명령을 실행합니다.

				
					curl --unix-socket /var/run/control.unit.sock http://localhost/config/

이 명령은 현재 NGINX Unit에 설정된 모든 애플리케이션, 라우트, 리스너 정보를 JSON 형식으로 출력합니다. 이를 통해 설정이 올바르게 적용되었는지 확인할 수 있습니다.

문제 해결

Unit 서비스 상태 확인

NGINX Unit 서비스가 제대로 실행되고 있는지 확인하려면 다음 명령을 사용합니다.

				
					systemctl status unit

서비스가 활성 상태가 아닌 경우, 재시작을 시도하세요.

				
					systemctl restart unit

로그 분석

NGINX Unit 및 애플리케이션 관련 오류를 디버깅하려면 로그를 확인하는 것이 유용합니다. 시스템 로그를 확인하려면 아래 명령을 실행하세요.

				
					journalctl -u unit

확장 및 다음 단계

다른 언어로 확장

NGINX Unit은 Python뿐만 아니라 Node.js, PHP, Go, Java 등 다양한 언어를 지원합니다. 원하는 언어로 “Hello World” 애플리케이션을 작성하여 실행해 보세요.

HTTPS 설정

애플리케이션 보안을 강화하기 위해 SSL 인증서를 추가하여 HTTPS 트래픽을 처리하도록 설정할 수 있습니다.

로드 밸런싱 및 스케일링

NGINX Unit의 유연한 설정을 활용하여 애플리케이션 인스턴스를 확장하고, 로드 밸런싱을 통해 높은 트래픽도 효과적으로 처리할 수 있습니다.

NGINX Unit 구성 API 결론

이 가이드를 통해 NGINX Unit의 구성 API를 사용하여 간단한 “Hello World” 애플리케이션을 작성하고 실행하는 과정을 학습했습니다. Unit의 강력하고 유연한 기능을 활용하여 더 복잡한 애플리케이션으로 확장하고, 안정적인 애플리케이션 운영 환경을 구축해 보세요!

NGINX Unit 을 시작하려면 NGINX Unit 의 공식 Docs 를 확인하거나 NGINX STORE에 문의하여 사용 사례에 대해 상담 받아보세요.